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 API

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 simple delivery schedule, and update the order using the Send simple order endpoint.

pageUpdate an existing order

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

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.

When using the simple delivery schedule, the deliveries endpoint only supports the first order line of each item number. The deliveries of the first line will be applied to all order lines having the same item number.

Delivered indicator

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

When using the simple delivery schedule, the delivered indicator is only supported for the first order line of each item number. The other lines with the same item number will also be marked as delivered together with the first line.

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

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:

pageUpdate 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 API

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.

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.

When sending order indicators the provided purchase order number will be verified.

Last updated