logo

Several important and practical information for ERP team integration

  • 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

Powered by Notaku