ERP Integrations2 min read
ERP API Integration Explained: REST, Webhooks, Auth and Idempotency
A plain-English explanation of ERP API integration: REST APIs, webhooks, authentication methods, idempotency, pagination, rate limits and error handling.
Integration · Commerce
Magento ERP integration for complex catalogues
Magento (Adobe Commerce and Magento Open Source) handles large catalogues, B2B pricing and multiple store views well. It is not built to run purchasing, warehouses and accounting. The integration lets each system do its job without manual exports.
Overview
What this integration is for
We build Magento integrations on its REST API, with clear ownership rules per data type and a reconciliation job that catches anything missed.
01Data
What data syncs, and in which direction
| Entity | Direction | Notes |
|---|---|---|
| Orders | App → ERP | Orders imported with lines, discounts, shipping, taxes and payment method, per store view. |
| Customers & B2B companies | App → ERP | Customers matched by email; B2B companies mapped to ERP accounts with credit terms. |
| Products & prices | ERP → App | ERP owns SKUs, cost and base prices; Magento keeps descriptions, images and SEO content. |
| Inventory | ERP → App | Salable quantity per source pushed to Magento's multi-source inventory. |
| Shipments & tracking | ERP → App | Shipments created in Magento with tracking numbers when the ERP delivery is validated. |
| Credit memos | App → ERP | Refunds create credit notes and return receipts in the ERP. |
02Use cases
Common use cases
01
Large catalogues
Thousands of SKUs and configurable products kept in sync.
02
B2B and B2C together
Company accounts, negotiated prices and retail on one ERP.
03
Multi-warehouse stock
Per-source availability from real warehouse stock.
04
Clean accounting
Orders, refunds and payments posted without manual journals.
03 — Architecture
API architecture
Orders are pulled on a short schedule or pushed by an extension into a queue, then processed asynchronously so storefront performance is never affected. Stock and price updates are batched, and large catalogue updates run off-peak.
A nightly reconciliation compares orders, shipments and stock on both sides and reports differences.
04Reliability
Authentication, errors and retries
01
Authentication
An integration user with token-based access limited to the required API resources. Tokens are kept in a secrets manager.
02
Error handling
Orders are processed idempotently using the Magento increment ID. Validation errors go to an exception queue with the reason, for the operations team to fix and replay.
03
Retry strategy
Network and rate-limit failures retry with exponential backoff, then move to a dead-letter queue with an alert.
05 — Data mapping
Field mapping essentials
| Adobe Commerce (Magento) | ERP |
|---|---|
| increment_id | Sales order reference |
| items.sku | Product internal reference |
| store_id | Sales channel / companyPer store view |
| source_code | WarehouseMulti-source inventory |
06 — Automation
Automation opportunities
- Low-stock products hidden or back-ordered automatically
- Shipments notify customers when the ERP delivery is validated
- Daily reconciliation report emailed to operations
07 — Security
Security considerations
TLS everywhere, least-privilege API scopes, no card data stored in the ERP, and logs that exclude personal data where possible.
Related
Where this integration fits
Other integrations
Often connected together
ShopifyOrders, customers, products, stock and fulfilment synchronised between Shopify and your ERP.WooCommerceWooCommerce orders, products, stock and customers connected to your ERP via REST and webhooks.BigCommerceBigCommerce orders, products, stock and fulfilment connected to your ERP.AmazonAmazon Seller Central and FBA orders, inventory, fees and settlements connected via SP-API.
Insights
Related reading
ERP Integrations2 min read
ERP Integration Guide: Patterns, Data Ownership and Reliability
How to integrate an ERP with eCommerce, CRM, payments and other systems: data ownership, integration patterns, middleware, error handling, monitoring and common failure modes.
ERP Integrations2 min read
RFID Integration with Odoo: A Practical Architecture
How to integrate RFID readers with Odoo inventory: middleware design, mapping EPCs to products and serials, receiving and counting flows, performance and what to build vs buy.
FAQ
Frequently asked questions
Does this work with Magento Open Source and Adobe Commerce?
Yes. Both expose the same core REST API; Adobe Commerce B2B features add company and shared catalogue data.
Can we keep product content in Magento?
Yes. A common split is ERP for SKUs, prices and stock, Magento for marketing content.
Next step
Connecting Magento to your ERP?
Tell us your volumes, channels and data rules. We will outline the architecture and the risks before anything is built.