Receive goods

How to announce the buyer has received goods

There are two ways to announce the buyer has received goods:

• using the actual delivery, which is preferred over the delivered indicator, as it is more precise regarding partial deliveries.

• using the delivered indicator

Actual delivery history

The delivery history contains the actual physical deliveries. With the actual deliveries versus the planned deliveries, Tradecloud can calculate which goods should still be delivered or are overdue.

There are two ways to send the delivery history to Tradecloud:

Send the delivery history by updating an order using the /order endpoint

Send the actual delivery schedule by setting the lines.deliveryHistory field when your ERP system supports a delivery schedule natively, and update the order using the Send order endpoint.

Send the actual delivery by setting the lines.actualDelivery field when using the single delivery per order line feature, and update the order using the Send single delivery order endpoint.

Update an existing order

Send delivery events using the /api-connector/order/deliveries endpoint

Send delivery events for one or multiple existing order lines using the Send order deliveries events endpoint. This will append the deliveries to the order line's delivery history.

Before adding a delivery to an order, the order must have been sent to Tradecloud first.

The /order/deliveries endpoint is not supported when using the single delivery feature. Let support know when you need this endpoint for single delivery.

Delivered indicator

When an order or line is received, regardless of actual quantity or date, it can be marked as delivered by setting indicators.delivered on either order or line level.

Single delivery behavior:

When the primary or any related split lines is delivered; the corresponding delivery line will become delivered.

Mark as delivered by updating an order using the /order endpoint

The existing order or line can be marked as delivered by setting indicators.delivered on either order or line level and updating the order using the Send order endpoint:

Update an existing order

If you provide a delivered indicator on order level, ONLY the lines provided in this order message will be marked as delivered.

If you also provide a delivered indicator on line level, it has precedence over the order level delivered indicator.

Mark as delivered by sending the delivered indicator using the /order/indicators endpoint

The order or line can be marked as delivered by setting indicators.delivered on either order or line level and sending this indicator only, using the Send order indicators endpoint.

The /order/indicators endpoint is not supported when using the single delivery feature. Let support know when you need this endpoint for single delivery.

If you provide a delivered indicator on order level, ALL the lines in the order will be delivered.

If you also provide a delivered indicator on line level, it has precedence over the order level delivered indicator.