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.
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 simple order endpoint for the simple delivery schedule.
Please see this page to choose between the native or simple delivery schedule:
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.
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 simple delivery schedule:
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.
Additional order and line indicators
Additional indicators may be set in an order update:
indicators:
Receive goods
Complete an order
Cancel an order
Reopen 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: he user email or user name as known in your ERP system who updated this order

Choose attach document API

Receive an order response

Last modified 18d ago