- Customers who are to be sent from the ERP system to the ONe platform should be marked in the ERP system with an appropriate checkbox
- Quantity stocks should be sent from the ERP system to the ONe platform only for products that have been marked in the ERP system with the appropriate checkbox
- Prices should be sent from the ERP system to the ONe platform only for products that have been marked in the ERP system with the appropriate checkbox
- In the case of long request (especially in the case of request regarding sent stocks, prices, customer migrations), it is required to divide the request into smaller ones and queue them. We recommend not exceeding 10,000 lines in a single query.
- It is worth securing the continuity of integration operation in the event of receiving error information from the ONe server (e.g. code 404 - client not found).
- PRICING: The limit of price lists sent to a single B2B client is 2000. Each unused price list should be deleted.
Integration of basic objects
STAGE I
Lp. | Objects | Flow direction | Endpoint | Link to API documentation | The proposed frequency of data exchange |
1 | Segments of Client (optional) | ERP → ONe | /api/v1/account/integrations/auth-required/segments/{segmentId} | sent to ONe with Client | |
2 | Warehouses (optional) | ERP → ONe | /api/v1/account/integrations/auth-required/warehouses | once on initial import | |
3 | Stocks | ERP → ONe | /api/v1/stock/integrations/auth-required/warehouses/{warehouse}/stocks/incremental | every 2 minutes | |
4 | Client | ERP → ONe | /api/v1/account/integrations/auth-required/clients | - adding Client - every 10 minutes, every hour (e.g. 13:10:00, 13:20:00, 16:40)
- update of Client - every 10 minutes, from 50 seconds, every hour (e.g. 13:00:50, 13:10:50, 17:30:50) | |
5 | Client | ONe → ERP | /api/v1/account/integrations/auth-required/clients/{clientId} | every 2 minutes (adding and update) | |
6 | Customer credit limit (optional date of payment) | ERP → ONe | /api/v1/account/integrations/auth-required/trade-credits/{organizationId} | sent to ONe with Client | |
7 | Customer blockade | ERP → ONe | /api/v1/account/integrations/auth-required/client-blockades/{clientId} | sent to ONe with Client |
STAGE II
Lp. | Objects | Flow direction | Endpoint | Link to API documentation | The proposed frequency of data exchange |
1 | B2C prices | ERP → ONe | /api/v1/pricing/integrations/auth-required/retail-prices | every 10 minutes (e.g. 8:35:00, 8:45:00, etc.) | |
2 | B2B prices | ERP → ONe | /api/v1/pricing/integrations/auth-required/prices | once a day, every day, 15 minutes after midnight |
STAGE III
Lp. | Objects | Flow direction | Endpoint | Link to API documentation | The proposed frequency of data exchange |
1 | Invoice (content) | ERP → ONe | /api/v1/invoices/integrations/auth-required/invoices | every 30 minutes, between 8.20 every day, (e.g. 12:30, 13:00 14:30 etc.) | |
2 | Invoice PDF file | ERP → ONe | /api/v1/invoices/integrations/auth-required/invoices/file-upload-begin + /api/v1/invoices/integrations/auth-required/invoices/file-upload-complete | as above | |
3 | Invoice statuses (optional) | ERP → ONe | /api/v1/invoices/integrations/auth-required/invoices/status | every 30 minutes, in the 5th minute, between 8 - 20 every day, (e.g. 8:35:00, 10:35:00) | |
4 | WZ (content) | ERP → ONe | /api/v1/goods-issued-notes/integrations/auth-required/goods-issued-notes | every 30 minutes, between 8.20 every day, (e.g. 12:30, 13:00 14:30 etc.) | |
5 | WZ PDF file | ERP → ONe | /api/v1/goods-issued-notes/integrations/auth-required/goods-issued-notes/file-upload-finalize +/api/v1/goods-issued-notes/integrations/auth-required/goods-issued-notes/file-upload-initialize | as above | |
6 | Order | ONe → ERP | /api/v1/account/integrations/auth-required/order/shipment | every one minute | |
7 | Order fulfillment status | ERP → ONe | /api/v1/account/integrations/auth-required/order/status | at forty seconds, every ten minutes, (e.g. 10:00:40, 10:10:40, 10:20:40 etc. | |
8 | Offline orders (optional) | ERP → ONe | /api/v1/orders/integrations/auth-required/offline-order/shipment | every one minute |