Welcome to Orderful’s Mosaic — the next generation of our developer platform.
This API makes it faster and easier for you to integrate EDI flows into your system, starting with the most critical retail process: Order to Cash.
Integration with Mosaic
Simple schema
- Easy to read: Logical, human-friendly field names.
- ERP-oriented: Organized around system-of-record concepts and data structures instead of EDI and x12 quirks.
- Shorter payloads: We leverage context from related transactions (e.g., PO → POA/ASN/Invoice) so you don’t have to repeat or persist fields that mean nothing to you but are required on the return documents
Integration simplicity
- No partner mapping: Build once against a comprehensive, trading-partner-agnostic schema; Orderful maps it to each partner according to that partner's trading guidelines and preferred structure.
- Real-time validation: Clear, actionable validation and error responses during testing accelerate integration.
- Modern developer experience: Clean endpoints, predictable behaviors, and documentation designed to get you from first request to production quickly.
What’s in this version?
The initial launch focuses on a streamlined set of transaction types that power the Order to Cash process:
- 850 – Purchase Order (PO): Sent by the buyer to place an order.
- 855 – Purchase Order Acknowledgment (POA): Sent by the supplier to confirm the order.
- 856 – Advance Ship Notice (ASN): Sent by the supplier when goods are shipped.
- 810 – Invoice: Sent by the supplier for payment after fulfillment.
Together, these transactions allow you to receive orders, confirm them, ship product, and get paid — all through Orderful.
What if I need other transaction types?
Not all transaction types are supported yet in the Mosaic API.
If you need to work with legacy transaction types (beyond Order to Cash), you can still use our legacy transaction endpoints alongside the new /transactions endpoint. We’ll continue expanding coverage over time until all major flows are supported.
Next steps
The Integration Overview will walk you through everything you need to:
- Set up authentication
- Receive and send Order to Cash transactions
- Validate and troubleshoot as you go
You’ll be up and running quickly — and ready to scale.