Update an existing order

How to update an existing purchase order as a buyer

As buyer you can send either a new or updated purchase order to Tradecloud.

Order process

Most supplier ERP integrations do not have the capability to automatically process an updated order. It will be processed manually by the supplier and the order will have a longer human response time.

• If an order line has order process status Issued or In Progress and it is updated, it will keep the same status.

• If the line has status Rejected (by supplier) and it is reissued, it will become In Progress.

• If the line has status Confirmed and it is reopened, it will become In Progress.

• If the line is In Progress with an open buyer reopen request and your update makes the requested delivery schedule and prices equal to the confirmed values again, Tradecloud reverts that reopen request — see Revert a reopen request.

• In case of any other status like Completed or Cancelled the order update will be ignored.

Endpoints

Use the Send order endpoint when your ERP system supports a delivery schedule natively.

Or use the Send single delivery order endpoint for the single delivery per order line feature.

Please see this page to choose between the delivery schedule or single delivery per order line:

Delivery schedule

Tradecloud will update the order based on the purchaseOrderNumber and will add or update lines, delivery schedules and delivery histories where needed.

Order lines will be matched based on lines.position, deliverySchedule.position and deliveryHistory.position.

The order update should preferable only contain order lines that are new or changed. But you can also send all lines anyway.

Additional fields

Actual delivery history

The actual delivery history may be added in an order update when your ERP system supports a delivery schedule natively. These will be used to calculate the line Overdue indicator.

The actual delivery history is matched against the delivery schedule by date and quantity, not by delivery line position. deliveryHistory.position and deliverySchedule.position do not have to use the same values.

For stock items with delivery tolerances, you may additionally set indicators.delivered on the line to mark it delivered when the received quantity is within tolerance. Unlike the delivery history, the delivered indicator is applied by order line or delivery line position. See Delivered indicator.

• lines.deliveryHistory: the historical actual delivery schedule. Provide zero, one or multiple delivery history lines. Provide all delivery history lines in an update. The total number of delivery history lines is limited to 100 lines per order line.

• deliveryHistory.position: the position in the delivery schedule. Not to be confused with the line.position. deliverySchedule.position versus deliveryHistory.position do not have to use the same values.

• deliveryHistory.date: the actual delivery date of this delivery schedule position. Date has ISO 8601 date yyyy-MM-dd format. See also Standards.

• deliveryHistory.quantity: the actual delivered quantity of this delivery schedule position. Quantity has a decimal 1234.56 format with any number of digits.

Actual delivery

Or use the actual delivery field when using the single delivery per order line:

• lines.actualDelivery: the actual delivery at the buyer for this order line.

• actualDelivery.date: the actual delivery date of this delivery. Date has ISO 8601 date yyyy-MM-dd format. See also Standards.

• actualDelivery.quantity: the actual delivered quantity of this delivery. Quantity has a decimal 1234.56 format with any number of digits.

The deliveryHistory (multiple actual deliveries) field is not supported when using the single delivery feature. Let support know when you need deliveryHistory for single delivery.

Additional order and line indicators

Additional indicators may be set in an order update:

• indicators:

Receive goodsComplete an orderCancel an orderReopen an order

Updated order meta data

• erpLastChangeDateTime: Date and time the order was updated in your ERP system. DateTime has ISO 8601 local date/time format yyyy-MM-ddThh:mm:ss. See also Standards.

• erpLastChangedBy: the user email or user name as known in your ERP system who updated this order