Interface Overview
DSOrder exchanges data with the ERP through a REST API. The ERP initiates every call: it pushes sales, stock, promotions, placements and order fulfillment to DSOrder, and polls DSOrder for submitted purchase orders.
Start with Getting Started for authentication, formats and error handling.
Endpoints
| Data flow | Method and path | Frequency |
|---|---|---|
| ERP → DSOrder | POST /sales/{date}/{store_id} | Daily |
| ERP → DSOrder | POST /stock/{date}/{store_id} | Daily |
| ERP → DSOrder | PATCH /stock/{date}/{store_id} | As needed |
| ERP → DSOrder | POST /promotions | Near real-time |
| ERP → DSOrder | POST /promotions/articles | Near real-time |
| ERP → DSOrder | DELETE /promotions/articles | Near real-time |
| ERP → DSOrder | POST /promotions/articles/placement | Near real-time |
| ERP → DSOrder | POST /articles/placement | Near real-time |
| ERP → DSOrder | DELETE /articles/placement | Near real-time |
| ERP → DSOrder | POST /orders/{order_id}/fulfill | Near real-time |
| ERP → DSOrder | POST /orders/{order_id}/close | Near real-time |
| DSOrder → ERP | GET /orders/submitted | Polled by the ERP (~every 5 min) |
| DSOrder → ERP | GET /promotions/articles/{date}/{store_id} | On demand |
| DSOrder → ERP | GET /articles/placement/{date}/{store_id} | On demand |
Recommended order of imports
Some interfaces reference data created by others. Send them in this order:
- Promotions
- Promotion Articles — the promotion must exist
- Promotion Article Placements — the promotion article must exist
Sales, stock, article placements and order fulfillment have no ordering dependencies between them.