Delivery schedule

Choose between delivery schedule or single delivery per order line.

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 delivery schedule in this case.

Other ERP systems can only work with only one delivery per order line. Use single delivery in this case.

Delivery schedule

The default is to send and receive a delivery schedule.

Sending an order with a delivery schedule

When sending an order, use the Send order endpoint.

The field lines.deliverySchedule contains the delivery schedule of this order line.

Receiving an order response with a delivery schedule

When receiving an order response, the "Orders Webhook Integration" setting "My system supports" must be set to the default "Multiple deliveries per order line".

Use the orderEvent field of the 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.

Single delivery

The alternative is to send and receive a single delivery per order line.

Sending an order with a single delivery

When sending an order, use the Send single delivery order endpoint.

The field lines.scheduledDelivery contains the scheduled delivery of this order line.

Tradecloud will merge scheduledDelivery's of order lines with the same item, prices and terms into one order line having a delivery schedule.

Receiving an order response with single delivery

When receiving an order response, you must have the "Orders Webhook Integration" setting "My system supports" set to "Only one single delivery per order line".

Use the singleDeliveryOrderEvent field of the order webhook endpoint.

The field lines.statusLine.scheduledDelivery contains the current scheduled delivery of this order line.

Tradecloud will split the delivery schedule into order line's having only one lines.statusLine.scheduledDelivery.

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.

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:

• Open: no or partial quantity Produced, ReadyToShip, Shipped or Delivered

• Produced: the delivery line quantity is produced by the supplier

• ReadyToShip: the delivery line quantity is ready to be shipped by the supplier

• Shipped: the delivery line quantity is shipped by the supplier

• Delivered: the delivery line quantity is delivered at the buyer