Complete an order

Complete an order line in Tradecloud when it is completely handled at the buyer, usually when the supplier invoice is received and approved by buyer.

• Issued, In progress, Rejected and Confirmed lines will become Completed
• Cancelled lines cannot be completed
• Completed lines cannot be completed again
• Completing has precedence over cancelling at the same time

Caution

Single delivery behavior:

When all primary and related split lines are completed; the primary order line will become completed.

Completing by resending an order using the /order endpoint

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

Update an existing orderHow to update an existing purchase order as a buyer

Note

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

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

Completing by sending the completed indicator using the /order/indicators endpoint

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

Use the Send order indicators endpoint to send the completed indicator to Tradecloud.

Caution

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

Note

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

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

Revert completion

Revert the completion of a Completed line by setting the line-level indicator completed=false on the /order endpoint (or /order/single-delivery).

Note

Only an explicit false on line level reverts. Omitting the completed indicator leaves the line unchanged and is not the same as sending false. A false on order level does not revert, and the /order/indicators endpoint does not support reverting.

Caution

Single delivery behavior:

A completed=false on the primary or on any related split line reverts the completion of the primary order line.

The resulting status depends on whether the line was agreed with the supplier before:

• If the line was never confirmed, it becomes InProgress with in progress status RevertedCompletedLine and the supplier is asked to confirm it.
• If the line was confirmed and the agreed prices, delivery schedule and charge lines are unchanged, it returns to Confirmed. This creates no supplier task.
• If the line was confirmed and the agreed prices, delivery schedule or charge lines changed, and the line has no open shipment reschedule request, a buyer reopen request is created. The line becomes InProgress with OpenBuyerReopenRequest and the confirmed values stay in place until the supplier approves. See Reopen an order. An open shipment reschedule request rejects the order update, so the line stays Completed.

Webhook subscribers receive CompletedOrderLinesRevertedByBuyer, or OrderLinesReopenRequestedByBuyer on the changed-agreement path.