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
    Warehouse manager on the phone checking an order on his laptop, surrounded by pallet racking and parcels

    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.

    Illustrative comparison; assess each situation with the customer involved
    CriterionEDIB2B portalAPI
    Typical customerLarge chain or distributor that requires itSmall business, independent store, branchCustomer with an ERP, or an integrator
    Volume and frequencyRegular, high-volume ordersVariable, often recurringRegular, automated
    Customer's technical capacityIn-house EDI team or providerWeb browserDevelopers for the integration
    SetupImplementation guide and testing per partnerAccount, pricing and user accessDocumentation, API keys and testing
    Exception handlingStandard acknowledgments and messagesOn-screen messages and supportError codes the software must handle
    Ongoing costs to plan forEDI network or translation, depending on setupUser supportVersion maintenance and technical support
    Illustrative comparison; assess each situation with the customer involved

    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?

    Run every channel without duplicating rules

    The key principle: one engine applies pricing, availability, credit and approvals; channels are just entry points. Every channel that maintains its own rules becomes a source of discrepancies.

    • The same price list, whatever the channel.
    • The same credit checks and order limits.
    • A single product catalogue with centrally managed mappings.
    • Shared order numbering and history.
    • The same statuses sent back to the customer, whether by EDI, API or in the portal.

    Also decide how approvals apply. An EDI order from a chain has already been approved in their system, but your own internal checks, such as credit, still apply.

    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.

    Sources consulted

    Map your ordering channels with Shopflow

    Describe your customers, how they order and your systems to the team through the Contact page, selecting the "Sales & Pricing" subject.

    Talk to Shopflow about B2B order channels
    Back to resources