Delivery schedule

Choose between delivery schedule or single delivery per order line

Delivery methods overview

Tradecloud supports two delivery methods for order lines:

1. Delivery schedule — multiple scheduled deliveries per order line

2. Single delivery — one scheduled delivery per order line

Each delivery contains a position number, delivery date, and quantity.

Some ERP systems like SAP natively support multiple deliveries per order line, while others only support one delivery per order line.

Delivery schedule

Use the Send order endpoint with the delivery schedule specified in the lines.deliverySchedule field.

You can include multiple delivery lines, up to a maximum of 100 lines per order line.

deliverySchedule fields

• position: Position number in the delivery schedule (distinct from lines.position)

The position must be unique within the delivery schedule and should never change. Never renumber or reuse a position value.

• date: Requested delivery date (ISO 8601 format yyyy-MM-dd)

• quantity: Requested quantity (decimal format, e.g. 1234.56)

• status: Logistics status of this delivery line

• transportMode: Required mode of transport for goods delivery. We recommend using UNECE.org Recommendation 19 codes.

Single delivery

Use the Send single delivery order endpoint with delivery details in the lines.scheduledDelivery field.

Provide only one scheduledDelivery per order line, with a maximum of 100 deliveries per originalPosition across all order lines.

When order lines contain an originalPosition reference, Tradecloud automatically merges their scheduledDelivery and actualDelivery properties into the delivery schedule and history of the line with the matching position number.

scheduledDelivery fields

• date: Requested delivery date (ISO 8601 format yyyy-MM-dd)

• quantity: Requested quantity (decimal format, e.g. 1234.56)

• status: Logistics status of this scheduled delivery

• transportMode: Required mode of transport for goods delivery. We recommend using UNECE.org Recommendation 19 codes.

Logistics status

The logistics status can be one of:

• ReadyToShip: The full delivery line quantity is ready for shipment by the supplier

• Shipped: The full delivery line quantity has been shipped by the supplier

• Delivered: The full delivery line quantity has been delivered to the buyer