ERP integration · SAP
SAP Business One EDI and B2B integration
EDI and API integration for SAP Business One through the Service Layer and DI API, plus implementation services.
- Integration supported
- Implementation services available
- Cloud, on-premises or hybrid
Overview
Connecting SAP Business One with your trading partners
SAP Business One serves small and midsize businesses that often face the same EDI requirements as large enterprises when they sell to major retailers or distributors. Business One exposes its data through the Service Layer, a REST-style interface, and the DI API, a long-standing programming interface, both of which can create sales orders and read deliveries and invoices.
ECOM connects Business One to trading partners through PRISM, translating partner documents into Business One sales orders and generating ship notices and invoices from Business One deliveries and A/R invoices. For companies with few partners, WebEDI can be a simpler starting point before full integration.
Read the in-depth guideSAP Business One EDI integration guide: Service Layer, DI API and best practicesMethods
Integration approaches for SAP Business One
Service Layer
REST and OData-style interface for creating and reading Business One documents, suited to modern integrations.
DI API
Programming interface used by many existing add-ons and integrations.
Import and export
File-based data transfer for simpler scenarios and initial data loads.
Document mapping
How EDI documents map to SAP Business One
Typical mappings between common X12 documents and SAP Business One business objects. Actual designs depend on your configuration and partners.
| EDI document | SAP Business One object | Direction |
|---|---|---|
| 850 Purchase Order | Sales order | Into SAP Business One |
| 856 Advance Ship Notice | Delivery | From SAP Business One |
| 810 Invoice | A/R invoice | From SAP Business One |
| 846 Inventory Advice | Item availability | From SAP Business One |
Planning
Implementation considerations
Item and customer mapping
Partner item numbers and ship-to locations need cross-references in Business One.
Hosting model
Integration options depend on whether Business One runs on premises, hosted or in the cloud.
Growth path
Choose an approach that scales as partner counts and volumes grow.
Integration design
SAP Business One: scope, flows, controls and tests
The scope below describes integration functions and controls that can be included in an ECOM project. Coverage is confirmed for your product version, licensed modules and business requirements. We explain ECOM’s specific connection path and deployment architecture during a live meeting.
Editions and versions we integrate
ECOM scopes SAP Business One integration for the edition and release you run. Coverage, permitted actions and record availability are confirmed for your version, licensed modules and business requirements.
- SAP Business One (B1)
The ERP environment we integrate around
SAP Business One covers accounting, purchasing, inventory, sales and customer management for small and midsize businesses. Available workflows depend on the installed version and selected modules.
The design identifies company database, business partner, branch if enabled and warehouse. These values determine transaction routing, record validity, ownership and the financial or operational context in which a document is processed.
Systems and ownership
| System or participant | Integration responsibility |
|---|---|
| SAP Business One | Maintain the approved ERP records, business rules, stock and financial results within the agreed module scope. |
| Customer or supplier systems | Supply orders, revisions, forecasts, invoice details and partner reference numbers; receive agreed business responses. |
| Warehouse or fulfillment application | Own physical pick, pack, dispatch and receipt facts where separately deployed. Return actual quantities and shipment references. |
| ECOM integration services | Coordinate agreed document exchanges, business data mapping, validation and processing visibility across the defined systems. |
SAP Business One keeps the approved records, business rules and results; partners supply and receive agreed business documents; a separate warehouse application owns physical facts where one is deployed; and ECOM coordinates document exchange, mapping, validation and visibility. A system of record is decided for each data group.
A system-of-record decision is made for each data group. For example, partner purchase order numbers can originate externally while ERP order numbers are assigned by the ERP. External instructions do not automatically authorize changes to item masters, tax settings, accounting periods or payment details.
Input channels can include EDI, PRISM-WebEDI, PRISM-SmartConvert documents and PRISM-WebConnect portal activity, each subject to the same agreed ERP validation and business controls.
ERP records in the proposed scope
- Business Partner
- Item
- Sales Order
- Delivery
- A/R Invoice
- Purchase Order
- Goods Receipt PO
- A/P Invoice
Record availability and permitted actions are checked against the installed environment; the list is a functional scope inventory rather than a claim that every record is enabled in every edition.
Transaction flows and processing rules
Direction is relative to SAP Business One. Each flow is defined by its source, target business record, release condition and successful result. Creation, update, cancellation and enquiry are scoped separately.
Each flow has a source, a target business record, a release condition and a successful result. Creation, update, cancellation and enquiry are scoped separately for SAP Business One.
| Business flow | Direction | Processing and completion rule |
|---|---|---|
| Customer order | Into ERP | Create the appropriate sales order with source PO, line references, customer, ship-to, item, quantity, unit and requested date. |
| Order change or cancellation | Into ERP | Match the existing order and revision. Apply only permitted changes to open quantities; hold conflicts with shipped or invoiced activity. |
| Order response | Out of ERP | Return accepted or rejected lines, confirmed quantity and date, and ERP order reference. Transport receipt alone is not order acceptance. |
| Shipment and ASN | Out of ERP or coordinated | Use actual released shipment facts, order-line references, quantities and packaging details. A planned pick does not establish shipment. |
| Invoice or credit | Out of ERP | Use the agreed released or posted billing record. Retain original order and shipment references, charges, allowances and tax treatment. |
| Supplier purchasing | Both as scoped | Publish approved purchase orders and accept supplier confirmations, receipt information and invoices under the purchasing rules. |
| Availability and status | Out of ERP where scoped | Share the agreed stock or available-to-promise measure and timestamp; distinguish on-hand stock from committed or unavailable stock. |
Partner documents and business meaning
X12 examples include 850 orders, 860 order changes, 855 order acknowledgments, 856 shipment notices, 810 invoices and 820 payment or remittance advice. Relevant EDIFACT messages can be scoped for international partners. A 997 or 999 technical acknowledgment is tracked separately from business acceptance. Document selection follows the partner’s implementation guide, not the ERP product name.
A growing wholesaler receives retailer orders and supplier invoices in different formats. ECOM can help turn those exchanges into a consistent process around Business One sales, purchasing and accounting.
Data mapping and validation
We define a mapping specification at header, line and related-document level. It records source meaning, target business field, transformation, required condition, default ownership and rejection behavior. Partner identifiers remain traceable after ERP identifiers are assigned.
| Data group | ERP fields or business attributes | Validation rule |
|---|---|---|
| Organization | Company, Branch where enabled, Warehouse Code | Validate company database, business partner, branch if enabled and warehouse. Reject unknown or unauthorized combinations. |
| Trading party | Business Partner Code, Ship-to Address Code | Resolve partner identifiers to approved ERP accounts and locations. Do not match solely on a free-text name. |
| Product identity | Item Code, Customer Item Number | Map buyer and supplier item aliases to the correct ERP product. Check variants, revisions and active status where relevant. |
| Quantity and unit | Quantity, UoM Code, Open Quantity | Keep each quantity distinct. Apply approved pack or unit conversion, precision and rounding rules; reject an unknown conversion. |
| Dates | Document Date, Due Date, Tax Date | Preserve meaning, time zone and date-only values. Reject invalid formats and identify stale revisions. |
| Price and money | Unit Price, Currency, Discount, Tax Code | Define the authoritative price and tax calculation. Reconcile line extensions and document totals within approved tolerances. |
| References | Document Entry ID, Document Number, Base Document Line | Use stable line references across splits and updates. Retain original order, shipment, invoice and correction links. |
| Extensions | User-defined business fields approved for the flow | Agree field ownership, allowed values and length. Do not silently truncate values or discard unmapped required data. |
Field labels above identify business attributes; exact technical names, availability and allowed write actions are verified for your release. They do not disclose ECOM’s connection method.
Identity and duplicate control
The business identity starts with company + customer reference + document type + source line. The final rule also distinguishes a new document, a retransmission and a legitimate revision. ERP-assigned IDs are recorded after successful creation. A retry reuses the same business identity instead of creating a second order or invoice.
Processing control and error recovery
Business state controls the next action
For SAP Business One, the design evaluates sales order open quantity, delivery creation, invoice creation and cancellation or return status. A document is not considered complete simply because it arrived or passed a format check. Completion requires the intended ERP business result and its returned reference.
| Processing stage | Required evidence and next action |
|---|---|
| Received | Assign a correlation reference, retain the source identity and record receipt time. Check whether this is a duplicate or new revision. |
| Validated | Confirm required fields, authorized organization, master data, quantities and business rules. Reject or hold a failed document before unintended posting. |
| Submitted | Record the intended target action and processing attempt. Submission is an intermediate state, not evidence of ERP acceptance. |
| Accepted or held | Capture the ERP business record ID or a specific rejection or hold reason. Distinguish a business hold from an unavailable system. |
| Completed and reconciled | Confirm the agreed milestone, expected line results and outbound response. Reconcile source identity to ERP and partner references. |
For SAP Business One, the design evaluates sales order open quantity, delivery creation, invoice creation and cancellation or return status. A document is not considered complete simply because it arrived or passed a format check. Completion requires the intended ERP business result and its returned reference. Held or rejected documents are corrected and replayed with the same business identity, so a retry never creates a second order or invoice.
Changes and sequencing
Process a dependent change against the correct original record and current revision. If a change arrives before the order exists, retain it for controlled review or dependency handling. Define a cut-off state after which quantity, price or ship-to changes require an exception or formal correction. Posted financial history is corrected through the authorized business process.
Safe retry and uncertain results
Temporary availability failures can be retried under an agreed retry limit and escalation policy. Invalid items, closed periods and missing approvals need correction rather than blind retries. When a submission times out, first determine whether the ERP already created the record. An unknown result must not be converted immediately into a new create request.
For multi-step flows, retain completed steps and resume only the incomplete authorized action. An order created successfully must not be recreated because its acknowledgment failed. Recovery should retain original references, corrected values, attempt history and the responsible user or process.
Reconciliation and operational ownership
Reconcile document counts, line counts, quantities, monetary totals and business references at the agreed interval. Identify documents received without ERP results, shipments without required notices, invoices without partner delivery results and aging exceptions. Assign an owner and response target for each exception category. Set the interval and service targets from business deadlines and measured ERP capacity.
SAP Business One-specific integration requirements
Design requirement 1: Preserve base-document and target-document relationships. A delivery and its A/R invoice must refer back to the correct order lines rather than create an unrelated sale.
Design requirement 2: Treat the business document number and persistent record identifier as separate references. Number series and line positions need explicit reconciliation rules.
Design requirement 3: Validate warehouse, unit conversion, tax code and item type before creating stock-related documents. Define whether each business flow uses a delivery before invoicing.
Example integration sequence
A growing wholesaler receives retailer orders and supplier invoices in different formats. ECOM can help turn those exchanges into a consistent process around Business One sales, purchasing and accounting.
- Receive the partner order or demand instruction and identify customer, item, organization and delivery requirements.
- Validate and create or update the agreed ERP record; retain the assigned order and line references.
- Produce a business response from accepted quantities, dates and any holds rather than from message receipt alone.
- Use actual fulfillment information to build the required shipment notice and preserve split-delivery references.
- Publish the agreed billing document and reconcile order, delivered quantity, invoiced quantity and open balance.
Security, testing and production rollout
Security and access requirements
Define access by business action and organizational scope. Separate permissions for reading masters, creating documents, changing open records, releasing transactions and viewing financial data. Use dedicated integration identities and approved credential management; avoid shared administrator access. Keep customer environments and partner configuration boundaries explicit.
Agree protection of data in transit and at rest, secret rotation, audit retention and masking of sensitive logs. Restrict test datasets and exception screens to authorized users. Changes to payment details or sensitive master data require separate business authorization; ordinary transaction processing must not silently update them.
Acceptance tests
| Test condition | Expected evidence |
|---|---|
| Valid transaction | One intended ERP result with correct organization, party, lines, quantities, amounts and external references. |
| Replay and duplicate | A replay does not create a second business record or duplicate a stock or financial movement. |
| Invalid master data | An unknown item, location or account produces a clear exception and no unintended posting. |
| Partial transaction | The completed quantity and remaining quantity reconcile across the original and related records. |
| Revision conflict | A stale or late revision does not overwrite newer or completed business activity. |
| Uncertain submission | A timeout after submission is resolved by checking the business outcome before another create action. |
| Volume and cut-off | Representative peak volume meets agreed deadlines with measured backlog, processing duration and recovery behavior. |
| Authorization | An identity cannot access another company or perform an unapproved release, master-data change or finance action. |
Controlled rollout
Approve the transaction list, mapping rules and success criteria first. Test representative partner documents in the agreed nonproduction environment, then complete partner certification where required. Reconcile opening references and queued documents before production cutover. Start with a defined partner or transaction set and monitor actual results before expanding coverage.
The rollout plan identifies who can pause processing, how queued work is retained, how already posted documents are corrected, and when operations resume. ERP upgrades, cloud releases, new partner requirements and mapping changes require impact review and regression tests for affected flows.
Initial synchronization and cutover data
Define the initial data population separately from ongoing transaction processing. Identify which active customers, suppliers, products, locations and reference values are required before the first live document. Include only the open orders, balances or historical references that the agreed business scope needs. Record source ownership, extraction time and the reconciliation totals for the opening population.
During cutover, distinguish transactions already processed in the previous environment from transactions waiting to be processed. Preserve original partner references and ERP identifiers for open documents. Establish how changes made during the cutover window are captured and reconciled. A historical document used for reference must not accidentally be replayed as a new stock or accounting transaction.
Processing frequency and capacity
Assign a frequency to each flow rather than one timing promise for the entire integration. Urgent order changes, periodic inventory availability, shipment notices and financial reconciliation have different deadlines. Agree the peak document rate, typical and largest line counts, permitted backlog, ERP maintenance windows and the oldest acceptable unprocessed transaction.
Measure acceptance time, business completion time and partner response time separately. Test the effect of an ERP outage and the rate at which accumulated work can safely resume. Publish operating targets only after representative testing; a successful small sample does not establish peak-volume capacity or a guaranteed near-real-time service level.
Trading partners
Integration guides that pair with SAP Business One
SAP Business One integration FAQs
Can SAP Business One handle retail EDI?
Yes, with an integration layer. ECOM translates partner EDI into Business One documents and generates outbound documents from Business One data.
Should we use the Service Layer or DI API?
The Service Layer is generally preferred for new integrations, while the DI API remains common in existing add-ons. ECOM recommends based on your version and hosting.
Does ECOM implement SAP Business One?
Yes. ECOM provides SAP Business One implementation services alongside integration.
How quickly are transactions processed?
Timing is defined by business need, ERP capacity and partner deadlines. The design distinguishes event-driven business triggers, scheduled processing windows and bulk reconciliation requirements without promising an unmeasured latency.
What happens when the ERP rejects a transaction?
The operating design identifies the failed document, relevant fields, business reason and responsible owner. Correction and replay must preserve the original identity and prevent duplicate posting.
What will ECOM explain during the live meeting?
We review the actual connection path, hosting and deployment requirements, environment prerequisites and detailed technical responsibilities after understanding your ERP and scope.
Keep exploring
Related
Solution
ERP Integration
Connect your ERP to trading partners through EDI, APIs, IDocs, files and connectors.
Product
PRISM-WebEDI
Browser-based transaction management for trading partners without traditional EDI systems, on the supplier side and the customer side.
Service
ERP Implementation
ERP implementation for SAP, Oracle, Microsoft, NetSuite, Infor, Epicor, QAD and Sage, with B2B integration built in.
ERP
SAP Business ByDesign
Order, shipment and invoice integration for SAP Business ByDesign, with validation and reconciliation.
ERP
SAP ECC
IDoc-based EDI integration for SAP ECC and support for migrating partner interfaces to S/4HANA.
ERP
SAP S/4HANA
IDoc, API and EDI integration for SAP S/4HANA, plus S/4HANA implementation services.
ERP
SAP S/4HANA Cloud Public Edition
Order, shipment and invoice integration for SAP S/4HANA Cloud Public Edition, with mapping, validation and reconciliation.
Integrating or implementing SAP Business One?
Bring your SAP Business One version, installed modules, priority transactions, sample documents and known exceptions. ECOM will review the required systems integration, explain the specific integration path during a live meeting and define a practical implementation scope with your team.




