EDI, B2B portal or API: which channel for which orders?
Your customers don't all order the same way. A big-box retailer may require electronic data interchange (EDI). A small business prefers a portal where it can see its own pricing. A customer with its own software wants to send orders automatically through an API.
These channels aren't competing with each other. The risk comes when each one applies its own pricing, its own SKUs and its own validation rules. The same order can then be accepted in one channel and rejected in another.
This article helps you choose the right channel for each type of customer and run them side by side on a single set of business rules.
Published · By Shopflow
- Category:
- Headless commerce and integrations
- Format:
- Article
- Goal:
- Evaluate
What each channel covers
GS1 Canada defines EDI as the computer-to-computer exchange of business documents between companies in a standard electronic format. In North America, X12 is the most widely used standard. It defines numbered transaction sets such as the Purchase Order (850), Purchase Order Acknowledgment (855), Ship Notice/Manifest (856) and Invoice (810).
A B2B portal is a web interface: buyers log in, browse their catalogue and pricing, and place orders. It suits customers who order themselves and have no procurement system to connect.
An API is a programmable interface. The customer's software, such as their ERP or procurement tool, sends orders and receives status updates with no one keying anything in. There's no universal format: every platform documents its own APIs.
In between, file upload, usually CSV, lets a customer send a long product list without an integration project.
Choose the channel based on the customer
The right channel depends on the customer's profile, volume and technical resources. The table below helps frame the conversation.
| Criterion | EDI | B2B portal | API |
|---|---|---|---|
| Typical customer | Large chain or distributor that requires it | Small business, independent store, branch | Customer with an ERP, or an integrator |
| Volume and frequency | Regular, high-volume orders | Variable, often recurring | Regular, automated |
| Customer's technical capacity | In-house EDI team or provider | Web browser | Developers for the integration |
| Setup | Implementation guide and testing per partner | Account, pricing and user access | Documentation, API keys and testing |
| Exception handling | Standard acknowledgments and messages | On-screen messages and support | Error codes the software must handle |
| Ongoing costs to plan for | EDI network or translation, depending on setup | User support | Version maintenance and technical support |
The channel is often dictated by the customer rather than chosen by the supplier. A retail chain may make EDI a condition for listing your products. Get their implementation guides before you commit to a timeline.
What an EDI project really involves
Every trading partner publishes its own requirements: standard version, mandatory segments, codes. GS1 Canada notes that Canadian industry guidelines based on X12 exist for sectors including grocery, foodservice, retail pharmacy and healthcare.
Mapping is often the bulk of the work: the partner's item codes, your internal SKUs, order units and coded ship-to locations. A mapping error produces a wrongly picked order, even when the EDI document is technically valid.
Plan testing with each partner and read their terms: some charge fees when a document is missing, late or non-compliant. Exchanges may also run through a provider that translates and routes documents; define its role and cost up front.
When a portal is enough, and how to extend it
For most customers without integration resources, the portal remains the simplest channel. It becomes more efficient with quick order by SKU, reorder, and account-specific pricing and availability.
File upload bridges the gap for customers who build orders in a spreadsheet. Provide a template, validate every line and show clear error messages: unknown SKU, quantity not in a valid multiple, product not authorized.
Open an API to customers who are set up for it
An API appeals to customers with procurement software, marketplaces and integrators. Define what's exposed: catalogue and pricing lookups, order creation, order status, shipments and invoices.
Security has to be designed per customer: separate authentication for each, access limited to their own pricing and orders, rate limits, a test environment and a documented versioning policy.
Finally, spell out responsibilities. Who supports the customer's developer? Who monitors errors? How is the customer notified when the API changes?
Monitor errors and acknowledgments
Every channel produces errors: unknown SKU, price that doesn't match the contract, invalid address. Assign someone to handle them and define the expected response: an EDI acknowledgment, an API error message or a portal notification.
Regularly reconcile orders received against orders accepted, channel by channel. That check catches a stuck order even when an alert was missed.
Your decision grid
You choose a channel customer by customer, but the rules behind it should be the same for everyone.
Your decision list
- Segment customers by profile, volume and technical capacity.
- List the customers that require EDI and get their implementation guides.
- Define the file upload template and its validations.
- Set the API's scope, security and support.
- Centralize pricing, credit, SKUs and statuses in one engine.
- Assign error handling and reconciliation by channel.
Where Shopflow fits
Shopflow's B2B Engine page lists sales rep ordering and EDI/CSV upload among its B2B channels, connected to a shared engine: customer-specific pricing, private catalogues, approvals and credit management. The Headless Commerce and API Documentation pages describe API access. The site doesn't detail support for your partners' specific EDI transaction sets or an EDI network service: ask which formats are accepted, how documents are translated and whether an EDI provider would be involved.
Related pages
- B2B EngineB2B channels and the shared engine as described by Shopflow.
- Headless CommerceThe API-based architecture that connects several storefronts to one engine.
- API DocumentationShopflow's API documentation.
- Connecting stores and warehousesThe guide to scoping data flows between your online store, stores and warehouses.