POA1.0.6

Purchase Order Acknowledgement Example

Approved canonical example from the published Purchase Order Acknowledgement JSON Schema. Use Preview to see schema fields alongside example values, or Code for the canonical JSON payload.

Field	Required	Description	Example value
`docType`	Yes	Canonical document type. For purchase order acknowledgements this value is POA.	`POA`
`correlationId`	Yes	Stable UUID used to trace this acknowledgement against the purchase order lifecycle.	`347ed126-1456-4f0e-84f4-b16f018f6e61`
`timestamp`	Yes	UTC timestamp indicating when DataShift created the canonical acknowledgement.	`2026-05-16T01:00:00Z`
`metadata.sourceLanguage`	Yes		`cxml`
`metadata.sourceVersion`	Yes	Canonical schema version used to create this document	`1.0.6`
`metadata.payloadId`	No	Original cXML payload ID	`poa-example-10001`
`metadata.userAgent`	Yes	DataShift Edge version that generated the canonical document	`DataShift Edge v1`
`data.poaNumber`	Yes	Supplier-assigned acknowledgement identifier used for duplicate detection and support references.	`POA-10001`
`data.confirmationType`	No	DataShift-managed order-level acknowledgement outcome calculated from line-level status and tolerance validation.	`accept`
`data.operation`	No	Whether this creates, updates, or deletes a confirmation	`-`
`data.noticeDate`	Yes	Date and time the supplier created the acknowledgement.	`2026-05-16T01:00:00Z`
`data.poNumber`	Yes	Purchase order number being acknowledged.	`PO-10001`
`data.poVersion`	No	Purchase order version being acknowledged.	`1`
`data.orderReference.documentId`	No		`-`
`data.orderReference.payloadId`	No		`-`
`data.orderReference.orderDate`	No		`-`
`data.documentReference.documentId`	No		`-`
`data.documentReference.payloadId`	No		`-`
`data.deliveryDate`	No	Expected delivery business date-time. Valid ISO offsets are allowed.	`2026-05-23T00:00:00Z`
`data.dropship`	No	Indicates if this is a direct ship/dropship order	`-`
`data.invoiceId`	No	Optional supplier-generated invoice ID associated with this confirmation	`-`
`data.shipping.amount`	No		`-`
`data.shipping.currency`	No	ISO 4217 currency codes supported by DataShift canonical schemas	`-`
`data.shipping.carrier`	No	Carrier name	`-`
`data.shipping.route`	No	Shipping route method	`-`
`data.shipping.shippingInstructions`	No	Detailed shipping instructions	`-`
`data.shipping.buyerAcctNumber`	No	Buyer's shipping account number	`-`
`data.shipping.incoTerms`	No	International Commercial Terms	`-`
`data.tax.amount`	No		`-`
`data.tax.currency`	No	ISO 4217 currency codes supported by DataShift canonical schemas	`-`
`data.total.amount`	No		`-`
`data.total.currency`	No	ISO 4217 currency codes supported by DataShift canonical schemas	`-`
`data.contacts[].role`	Yes		`-`
`data.contacts[].name`	No		`-`
`data.contacts[].email`	No		`-`
`data.contacts[].phone`	No		`-`
`data.billTo.addressId`	No		`-`
`data.billTo.addressee`	No		`-`
`data.billTo.street1`	Yes		`-`
`data.billTo.street2`	No		`-`
`data.billTo.city`	Yes		`-`
`data.billTo.state`	Yes		`-`
`data.billTo.postalCode`	Yes		`-`
`data.billTo.country`	Yes		`-`
`data.shipTo.addressId`	No		`-`
`data.shipTo.addressee`	No		`-`
`data.shipTo.street1`	Yes		`-`
`data.shipTo.street2`	No		`-`
`data.shipTo.city`	Yes		`-`
`data.shipTo.state`	Yes		`-`
`data.shipTo.postalCode`	Yes		`-`
`data.shipTo.country`	Yes		`-`
`data.comments`	No	Human-readable notes about this confirmation	`-`
`data.lineItems[].lineNumber`	Yes	Line number from the original purchase order.	`1`
`data.lineItems[].uniqueLineKey`	No	DataShift-managed stable line key from the original purchase order, used by internal connectors for cross-document correlation.	`PO-10001-1`
`data.lineItems[].statusType`	No	System-calculated status based on tolerance validation. Not mappable by sender; use supplierLineStatus for sender intent.	`-`
`data.lineItems[].supplierLineStatus`	No	Supplier-provided line acknowledgement intent. Defaults to unknown when omitted or blank.	`accept`
`data.lineItems[].supplierItemId`	No	Supplier's part/item number	`SUP-001`
`data.lineItems[].supplierItemAuxiliaryId`	No	Supplier's alternate/auxiliary part ID	`-`
`data.lineItems[].buyerItemId`	No	Buyer's part/item number	`BUY-001`
`data.lineItems[].gtin`	No	Global Trade Item Number (GTIN-8, GTIN-12, GTIN-13, or GTIN-14)	`-`
`data.lineItems[].description`	No	Item description	`-`
`data.lineItems[].originalQuantity`	No	Quantity originally ordered	`12`
`data.lineItems[].confirmedQuantity`	No	Quantity the supplier confirms for this line.	`12`
`data.lineItems[].quantityBackordered`	No	Quantity backordered by the supplier	`-`
`data.lineItems[].unitOfMeasure`	No	UN/ECE Recommendation 20 unit of measure codes for DataShift canonical documents	`EA`
`data.lineItems[].unitPrice`	No	Confirmed unit price (if different from order)	`25`
`data.lineItems[].currency`	No	ISO 4217 currency codes supported by DataShift canonical schemas	`AUD`
`data.lineItems[].unitPriceUom`	No	Unit of measure for price basis (e.g., price per 100)	`-`
`data.lineItems[].lineTotalExTax`	No		`-`
`data.lineItems[].lineTotalInclTax`	No		`-`
`data.lineItems[].classificationDomain`	No	Product classification domain	`-`
`data.lineItems[].classificationCode`	No	Product classification code	`-`
`data.lineItems[].shipmentDate`	No	Expected or actual shipment date for this line	`-`
`data.lineItems[].deliveryDate`	No	Expected delivery date for this line	`-`
`data.lineItems[].rejectionReason`	No	Reason for rejection or backorder	`-`
`data.lineItems[].substitution.supplierItemId`	No		`-`
`data.lineItems[].substitution.buyerItemId`	No		`-`
`data.lineItems[].substitution.description`	No		`-`
`data.lineItems[].substitution.quantity`	No		`-`
`data.lineItems[].substitution.unitOfMeasure`	No	UN/ECE Recommendation 20 unit of measure codes for DataShift canonical documents	`-`
`data.lineItems[].substitution.unitPrice`	No		`-`
`data.lineItems[].comments`	No	Line-level comments	`-`
`data.extrinsics`	No	Partner-specific extension fields that are not part of the canonical core contract.	`{"supplierPortalReference":"ACK-7788"}`