Delivery schedule

Choose between the native or simple delivery schedule

Native versus simple delivery schedule

Tradecloud works with a delivery schedule per order line. Each delivery line in a schedule consists of a position, delivery date and a quantity.
Some ERP systems like SAP work natively with multiple delivery lines per order line. Use the Tradecloud native delivery schedule in this case.
Other ERP systems can only work with only one delivery per order line. Use the Tradecloud simple delivery schedule in this case.

Native delivery schedule

The default is to receive the native delivery schedule. The "Orders Webhook Integration" setting "My system supports" must be set to the default "Multiple delivery lines per order line".
Use the orderEvent field of the POST order webhook endpoint.
The field lines.deliverySchedule contains the current delivery schedule of this order line.

deliverySchedule fields

  • position: the position in the delivery schedule. Not to be confused with the lines.position.
The position may be unassigned in case of a delivery line split by a supplier. The buyer ERP system must assign a position to the split delivery line and update the order line to Tradecloud.
  • date: the requested delivery date of this delivery schedule position. Date has ISO 8601 date yyyy-MM-dd format. See also Standards.
  • quantity: the requested quantity of this delivery schedule position. Quantity has a decimal 1234.56 format with any number of digits.
  • status: The logistics status of this delivery line according to the buyer.
  • transportMode: The Mode of Transport used for the delivery of goods as required by the buyer. UNECE.org Recommendation 19 is advised for Codes for Modes of Transport.

Simple delivery schedule

To receive the simple delivery schedule you must have the "Orders Webhook Integration" setting "My system supports" set to "Only one delivery line per order line".
Use the simpleOrderEvent field of the POST order webhook endpoint.
The field lines.scheduledDelivery contains the current delivery line of this order line.
Tradecloud will expand a delivery schedule into order lines with the same item number having scheduledDelivery's. The deliverySchedule.position will be taken as lines.position.
The order line position may be unassigned in case of an order line split by a supplier. The ERP system must assign a position to the split order line and update the order line to Tradecloud.
The simple delivery schedule is only supported by the POST webhook API, and not supported by the GET webhook API and polling.

scheduledDelivery fields

  • date: the requested delivery date of this order line. Date has ISO 8601 date yyyy-MM-dd format. See also Standards.
  • quantity: the requested quantity of this order line. Quantity has a decimal 1234.56 format with any number of digits.
  • status: The logistics status of this scheduled delivery according to the buyer.
  • transportMode: The Mode of Transport used for the delivery of goods as required by the buyer. UNECE.org Recommendation 19 is advised for Codes for Modes of Transport.

Logistics status

The logistics status is one of:
  • ReadyToShip: full quantity ready to be shipped by the supplier
  • Shipped: full quantity shipped by the supplier
  • Delivered: full quantity delivered at the buyer