Delivery schedule

Choose between delivery schedule or single delivery per order line.

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

ERP system compatibility is an important consideration when choosing between delivery methods:

• Multiple deliveries support: Some ERP systems (like SAP) natively support multiple deliveries per order line, making them fully compatible with Tradecloud's delivery schedule approach.

• Single delivery limitation: Other ERP systems can only handle one delivery per order line. If your ERP system has this limitation, the single delivery method is recommended for seamless integration.

Delivery schedule

The delivery schedule is the default method, where each order line can have multiple delivery lines. Each delivery line contains a position number, delivery date, and quantity. Delivery schedules represent Tradecloud's native approach to handling deliveries, as the platform is designed from the ground up to work with this structure.

Sending an order with a delivery schedule

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

Receiving an order response with a delivery schedule

There are two methods to receive order responses:

Method 1: Order webhook (Push)

• Ensure your "Orders Webhook Integration" setting has "My system supports" set to "Multiple deliveries per order line" (this is the default)

• Process the orderEvent field in the order webhook payload

Method 2: Polling (Pull)

Use the Poll orders endpoint to periodically check for updates.

With either method, the current delivery schedule will be in the lines.deliverySchedule field.

Delivery schedule fields

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

• 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 according to the buyer

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

When a supplier splits a delivery line, the position may be unassigned. The buyer's ERP system must assign a position to the split delivery line and update the order line in Tradecloud.

Single delivery

The single delivery method allows only one scheduled delivery per order line in the communications between Tradecloud and your ERP system. This approach simplifies order management for ERP systems that don't support multiple deliveries per line. With single delivery each order line has exactly one scheduled delivery date and quantity.

Sending an order with single delivery

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

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

Receiving an order response with single delivery

There are two methods to receive order responses:

Method 1: Order Webhook (Push)

• Set your "Orders Webhook Integration" setting "My system supports" to "Only one single delivery per order line"

• Process the singleDeliveryOrderEvent field in the order webhook payload

Method 2: Polling (Pull)

Use the Poll single delivery orders endpoint to periodically check for updates.

With either method, the current delivery information will be in the lines.statusLine.scheduledDelivery field.

When a supplier splits an order line, the new line's position may be unassigned. The buyer's ERP system must assign a new unique position identifier to this split line and update it in Tradecloud.

When updating a split order line in Tradecloud, the buyer's ERP system must include the originalPosition value that references the original line. This preserves the relationship between the split line and the original order line, ensuring proper tracking and data integrity.

Scheduled delivery 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 according to the buyer

• 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:

• Open: No quantity or only partial quantity has been Produced, ReadyToShip, Shipped or Delivered

• Produced: The full delivery line quantity has been produced by the supplier

• 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