Guides

Sage 300 EDI integration guide: Web API, views and best practices

How small and midsize companies connect Sage 300 to EDI trading partners, from order entry to shipments and invoices.

2 min read · Updated October 19, 2026

The short answer

Sage 300 does not translate EDI itself. An integration layer converts partner documents and creates order entry (O/E) orders through Sage 300's business logic views, called through the SDK, or through the REST-based Web API in supported versions. O/E shipments and invoices then drive outbound ship notices and invoices. Optional fields hold partner references.

How EDI flows through Sage 300Sequence diagram for Sage 300. The trading partner sends a 850 purchase order to the integration layer, which translates and validates it and create the O/E order through business logic views called through the SDK, or the Web API in supported versions. In Sage 300, o/E shipments and invoices are created. O/E shipment and O/E invoice, and the integration layer sends the 856 ship notice and 810 invoice to the partner.How EDI flows through Sage 300The integration layer translates; Sage 300 keeps the business recordsTrading partnerIntegration layerSage 300850 purchase orderTranslate and validateCross-references turn partner codes into your items and locationsCreate the O/E orderThrough business logic views called throughthe SDK, or the Web API in supported versionsO/E shipments and invoices are createdO/E shipment and O/E invoice856 ship notice and 810 invoiceInterfaces and objects as described in this guide. Your version, licensing and partner requirements decide which ones apply.
How EDI flows through Sage 300Sequence diagram for Sage 300. The trading partner sends a 850 purchase order to the integration layer, which translates and validates it and create the O/E order through business logic views called through the SDK, or the Web API in supported versions. In Sage 300, o/E shipments and invoices are created. O/E shipment and O/E invoice, and the integration layer sends the 856 ship notice and 810 invoice to the partner.How EDI flows through Sage300The integration layer translates; Sage 300keeps the business recordsTradingpartnerIntegrationlayerSage 300850 purchase orderTranslate and validateCross-references turnpartner codes into youritems and locationsCreate the O/E orderThrough business logic viewscalled through the SDK, or theWeb API in supported versionsO/E shipments andinvoices are createdO/E shipment and O/Einvoice856 ship notice and 810invoiceInterfaces and objects as described in this guide.Your version, licensing and partner requirementsdecide which ones apply.

Read the diagram from top to bottom. Sage 300 does not exchange X12 itself in this design: the integration layer handles the partner connection and translation, and Sage 300 creates and posts the business records. Outbound documents are built from what Sage 300 actually recorded.

Expand diagram Download SVG

How EDI connects to Sage 300

Sage 300 serves small and midsize distributors and manufacturers, many of whom need EDI to sell to retailers and large distributors. An integration layer handles partner connectivity and translation and exchanges data with Sage 300.

Document mapping

EDI documentDirectionSage 300 object
850 purchase orderInboundO/E order
855 acknowledgmentOutboundO/E order status and lines
856 ship noticeOutboundO/E shipment
810 invoiceOutboundO/E invoice
846 inventoryOutboundItem quantities by location

Integration options

  • Business logic views: Sage 300’s views, called through the SDK, apply the same validation as the user interface.
  • Web API: a REST-based API in newer versions for reading and creating records. Availability depends on your version.
  • Import and export: file-based transfer for simple scenarios and initial loads.

Avoid writing directly to Sage 300 database tables; it bypasses business rules and can corrupt data.

Partner data

  • Customer item number cross-references, maintained in Sage 300 or in the integration layer.
  • Ship-to locations for retailer stores and distribution centers.
  • Optional fields for EDI identifiers and the partner’s original purchase order line numbers.

Shipping data

Retail ship notices need carton detail and GS1-128 labels, which O/E shipments do not hold by default. Packing data usually comes from a warehouse add-on, a WMS or the EDI solution. Plan this with the warehouse team before go-live.

Best practices

  • Validate customers, items and prices before creating O/E orders.
  • Create shipments from actual picking so ship notices reflect what shipped.
  • Keep partner-specific rules in the integration layer.
  • Retest integrations after Sage 300 upgrades.
  • Start with web EDI for low-volume partners. See web EDI vs integrated EDI.
Sage 300 integration and implementationIntegration methods, document mappings and ECOM services for Sage 300.

Frequently asked questions

Does Sage 300 include EDI?

Sage 300 does not translate X12 or EDIFACT natively. Companies use an EDI integration layer or add-on that creates Sage 300 transactions and reads outbound data.

Why use Sage 300 views for integration?

Views contain Sage 300's business logic, so transactions created through them follow the same validation as data entered in the user interface. Writing directly to the database bypasses those rules.

Can a small Sage 300 company start with web EDI?

Yes. With a few partners and low volumes, web EDI is a practical start. Integration becomes worthwhile as volume grows or partners add requirements such as ship notices with carton detail.

Have an EDI question we did not answer?

ECOM's integration specialists can review your partners, documents and systems and recommend next steps.