PurchaseOrderUpdate
New expected dates for a purchase order and its lines, as stated by the supplier. Scoped to the purchase order, with the affected lines nested. Apply the dates as updated promise dates on the purchase order.
The whole request body, sent without the shared event envelope.
Every event carries at least one new date — on the purchase order, on a line, or both. Each date field is individually optional because dates appear only at the level the supplier stated them, so no single field is the one that is always set. That is a guarantee about what Augment sends, not a shape you have to validate.
- collected
At required- Type: Format: date-time
When Augment collected the update from the supplier, as a UTC ISO 8601 timestamp ending in
Z. Use it to order updates for the same purchase order — a latercollectedAtreflects the more recent thing the supplier said.
- lineType:
Items requiredProperties: 4The lines that have a new date. Lines the supplier said nothing new about are omitted, so this array is empty when the supplier stated dates only at purchase order level.
- purchaseType: string
Order Number requiredYour purchase order number, as sent when the purchase order was created.
- sourceenumconst:SUPPLIER_EMAILrequired
Where the dates came from. New values may be added as Augment collects updates over other channels, so treat this as an open set.
- expectedType: string | nullFormat: date
Arrival Date New expected arrival date for the whole purchase order, as a UTC calendar day. Present only when the supplier stated one date for the order rather than per line. Null otherwise.
- expectedType: string | nullFormat: date
Ship Date New expected ship date for the whole purchase order, as a UTC calendar day. Present only when the supplier stated one date for the order rather than per line. Null otherwise.
- noteType: string | null
What the typed fields cannot carry — the supplier's account of why the dates moved, at purchase order level.