Order Acknowledgement

Purchase Order Acknowledgment (855)

A Purchase Order Acknowledgment (855) is sent by a supplier to confirm, reject, or provide status on a received purchase order.

Schema Overview Sample Downloads

Field	Type	Required	Description
purchaseOrderNumber	string	✓	Purchase order number being acknowledged
purpose	string		Intended purpose of the acknowledgment transaction (BAK01) Values: `original` `cancellation` `change` `replace` `confirmation`
status	string	✓	Overall acknowledgment status of the purchase order (BAK02) Values: `accepted` `changed` `rejected`
statusReasonCode	string		Reason code explaining why the order was rejected, if applicable Values: `discontinued` `invalidAddress` `invalidBillToCode` `invalidItemNumber` `invalidPrice` `invalidItemQuantity` `invalidShipFrom` `invalidShipMethod` `invalidShipToName` `invalidShipToAddress1` `invalidShipToAddress2` `invalidShipToCity` `invalidShipToStateOrProvince` `invalidShipToPostalCode` `invalidShipToCountry` `itemRecall` `itemSetupIssue` `mainlandOnly` `missingLineItemId` `missingOrderId` `missingShipId` `naturalDisaster` `outOfStock` `seasonalOrEndOfLife` `shippingInFull` `systemIssue` `taxNexusIssue` `transportationIssuePrepaid` `transportationIssueCollect` `undeliverableAddress` `weather`
statusNoteshow child fieldshide child fields	object		Additional notes or comments about the acknowledgment
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
datesshow child fieldshide child fields	object		Important dates such as scheduled ship date and estimated delivery date
purchaseOrderDate	unknown		Date the purchase order was issued
estimatedDeliveryDate	unknown		Estimated date of delivery to the buyer
requestedPickupDate	unknown		Requested date for pickup by carrier
scheduledShipDate	unknown		Scheduled date for shipment
salesOrderDate	unknown		Date the supplier created the corresponding sales order in their system. Uncommon — the more typical BAK09 usage (acknowledgment creation date) is handled in mapping and not exposed as a field.
partiesshow child fieldshide child fields	object		Ship-to location where goods will be delivered
shipToshow child fieldshide child fields	object		Ship-to location where goods will be delivered
name	string		Party name or company name
additionalName1	string		Additional name line 1
additionalName2	string		Additional name line 2
identificationCode	string		Party identification code value
identificationCodeType	string		N103: Codes 91 and 92 are specific to the direction of the transaction. Retail Example: For the 850 92 maps to sender and 91 maps to receiver. For the 856, 810 - sender maps to 91 and receiver maps to 92 Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId`
addressLine1	string		Street address line 1
addressLine2	string		Street address line 2
addressLine3	string		Street address line 3
addressLine4	string		Street address line 4
city	string		City name
stateOrProvinceCode	string		State or province code
postalCode	string		Postal or ZIP code
countryCode	string		Country code (ISO)
zoneType	string		Address zone type Values: `residential` `commercial`
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number. Default source is the comm-number paired with a TE qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type (e.g.
faxNumber	string		Contact fax number. Default source is the comm-number paired with an FX qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on a comm-number element labels its value as fax even when the qualifier is TE/EM, follow the note and route the value here.
email	string		Contact email address. Default source is the comm-number paired with an EM qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type, follow the note and route accordingly.
shipFromshow child fieldshide child fields	object		Ship-from location where goods will originate
name	string		Party name or company name
additionalName1	string		Additional name line 1
additionalName2	string		Additional name line 2
identificationCode	string		Party identification code value
identificationCodeType	string		N103: Codes 91 and 92 are specific to the direction of the transaction. Retail Example: For the 850 92 maps to sender and 91 maps to receiver. For the 856, 810 - sender maps to 91 and receiver maps to 92 Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId`
addressLine1	string		Street address line 1
addressLine2	string		Street address line 2
addressLine3	string		Street address line 3
addressLine4	string		Street address line 4
city	string		City name
stateOrProvinceCode	string		State or province code
postalCode	string		Postal or ZIP code
countryCode	string		Country code (ISO)
zoneType	string		Address zone type Values: `residential` `commercial`
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number. Default source is the comm-number paired with a TE qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type (e.g.
faxNumber	string		Contact fax number. Default source is the comm-number paired with an FX qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on a comm-number element labels its value as fax even when the qualifier is TE/EM, follow the note and route the value here.
email	string		Contact email address. Default source is the comm-number paired with an EM qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type, follow the note and route accordingly.
suppliershow child fieldshide child fields	object		Supplier or vendor fulfilling the order
name	string		Party name or company name
additionalName1	string		Additional name line 1
additionalName2	string		Additional name line 2
identificationCode	string		Party identification code value
identificationCodeType	string		N103: Codes 91 and 92 are specific to the direction of the transaction. Retail Example: For the 850 92 maps to sender and 91 maps to receiver. For the 856, 810 - sender maps to 91 and receiver maps to 92 Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId`
addressLine1	string		Street address line 1
addressLine2	string		Street address line 2
addressLine3	string		Street address line 3
addressLine4	string		Street address line 4
city	string		City name
stateOrProvinceCode	string		State or province code
postalCode	string		Postal or ZIP code
countryCode	string		Country code (ISO)
zoneType	string		Address zone type Values: `residential` `commercial`
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number. Default source is the comm-number paired with a TE qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type (e.g.
faxNumber	string		Contact fax number. Default source is the comm-number paired with an FX qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on a comm-number element labels its value as fax even when the qualifier is TE/EM, follow the note and route the value here.
email	string		Contact email address. Default source is the comm-number paired with an EM qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type, follow the note and route accordingly.
billToshow child fieldshide child fields	object		Bill-to party for invoicing purposes
name	string		Party name or company name
additionalName1	string		Additional name line 1
additionalName2	string		Additional name line 2
identificationCode	string		Party identification code value
identificationCodeType	string		N103: Codes 91 and 92 are specific to the direction of the transaction. Retail Example: For the 850 92 maps to sender and 91 maps to receiver. For the 856, 810 - sender maps to 91 and receiver maps to 92 Values: `sendersId` `receiversId` `duns` `plantCode` `dunsPlus4` `drugEnforcementAdmin` `telephone` `federalReserveRouting` `standardAddressSAN` `healthIndustryHIN` `warehouse` `schoolId` `memberId` `stateLicenseId` `globalLocationId`
addressLine1	string		Street address line 1
addressLine2	string		Street address line 2
addressLine3	string		Street address line 3
addressLine4	string		Street address line 4
city	string		City name
stateOrProvinceCode	string		State or province code
postalCode	string		Postal or ZIP code
countryCode	string		Country code (ISO)
zoneType	string		Address zone type Values: `residential` `commercial`
contactsshow child fieldshide child fields	array		Contact persons for this party
type	string	✓	Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number. Default source is the comm-number paired with a TE qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type (e.g.
faxNumber	string		Contact fax number. Default source is the comm-number paired with an FX qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on a comm-number element labels its value as fax even when the qualifier is TE/EM, follow the note and route the value here.
email	string		Contact email address. Default source is the comm-number paired with an EM qualifier (PER03/04, PER05/06, or PER07/08). If the partner guideline note on the comm-number element labels the value as a different comm type, follow the note and route accordingly.
termsOfSaleshow child fieldshide child fields	object		Payment terms and conditions
type	string		Values: `basic` `basicDiscountOffered` `discountNotApplicable` `endOfMonth` `endOfMonth10` `extended` `instant` `fixedDate` `proximo` `mutuallyDefined`
basisDate	string		Values: `invoiceDate` `receiptOfGoods` `deliveryDate` `shipDate` `mutuallyDefined` `gageApprovalDate` `specifiedDate` `acceptanceDate` `invoiceTransmissionDate` `effectiveDate`
discountPercent	string		Discount percentage if paid early
discountDaysDue	integer		Number of days to qualify for discount
discountDueDate	unknown		Date by which payment must be made for discount
dayOfMonth	integer		Day of month for payment
netDaysDue	integer		Number of days until payment is due
netDueDate	unknown		Date when payment is due
discountAmount	string		Fixed discount amount
description	string		Description of payment terms
paymentMethodType	string		Values: `check` `letterOfCredit` `wireTransfer` `corporateTradePayment` `specialAccount` `directPayOthers`
references	object		Reference numbers associated with the purchase order being acknowledged
carrierDetailsshow child fieldshide child fields	object		FOB (Free on Board) terms and conditions
freeOnBoardshow child fieldshide child fields	array		FOB (Free on Board) terms and conditions
methodOfPayment	string		Values: `airCollect` `airPrepaid` `paidByBuyer` `collect` `mutuallyAgreed` `portOfCall` `halfPrepaid` `mixed` `serviceFreightNoCharge` `advancePrepaid` `customerPickupBackhaul` `prepaidChargeCustomer` `prepaidBySeller` `paidBySeller` `pickup` `thirdPartyPay`
locationType	string		Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
locationDescription	string		Description of FOB location
titlePassageType	string		Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
titlePassageDescription	string		Description of title passage location
transportationTermsSource	string		Values: `incoTerms` `tradeTerms` `mutuallyDefined`
transportationTerms	string		Values: `costAndFreight` `costInsuranceAndFreight` `carriageAndInsurancePaidTo` `carriagePaidTo` `deliveredAtFrontier` `deliverDutyPaid` `deliverDutyUnpaid` `deliveredDutyUnpaid` `deliveredExQuay` `deliveredExShip` `domesticallySupplied` `exQuay` `exShip` `exWorks` `freeAlongsideShip` `freeCarrier` `freightCarriageInsurancePaidTo` `freightCarriagePaidTo` `freeOnBoard` `freeOnRail` `freeOnTruck` `nonPrivilegedForeign` `privilegedForeign` `mutuallyDefined`
riskOfLoss	string		Values: `toDestinationBuyer` `toFreightEqPointSeller` `toPoolPointSeller` `toDestinationSeller` `mutuallyDefined`
description	string		Additional FOB description
allowancesshow child fieldshide child fields	array		Allowances or discounts applied to the order
type	string	✓	Values: `advertising` `defectiveAllowance` `discount` `freight` `handling` `newStore` `other` `promotionalAllowance` `quantityDiscount` `rebate` `restocking` `serviceAtPickupOrDelivery` `shipping` `shippingAndHandling` `swell` `unsaleableMerchandiseAllowance` `volume` `warehouse`
amount	string		Fixed amount of allowance or charge
percent	string		Percentage of allowance or charge
percentBasis	string		Basis for calculating percentage Values: `basePrice`
methodOfHandling	string		Values: `collect` `paidByVendor` `paidByCustomer` `prepaid`
description	string		Description of the allowance or charge
chargesshow child fieldshide child fields	array		Additional charges applied to the order
type	string	✓	Values: `advertising` `defectiveAllowance` `discount` `freight` `handling` `newStore` `other` `promotionalAllowance` `quantityDiscount` `rebate` `restocking` `serviceAtPickupOrDelivery` `shipping` `shippingAndHandling` `swell` `unsaleableMerchandiseAllowance` `volume` `warehouse`
amount	string		Fixed amount of allowance or charge
percent	string		Percentage of allowance or charge
percentBasis	string		Basis for calculating percentage Values: `basePrice`
methodOfHandling	string		Values: `collect` `paidByVendor` `paidByCustomer` `prepaid`
description	string		Description of the allowance or charge
lineItemsshow child fieldshide child fields	array		Line items with their acknowledgment status and details
purchaseOrderLineId	string		Line item identifier from the original purchase order
productIdsshow child fieldshide child fields	object	✓	Product identification codes such as UPC, SKU, or vendor item number
buyerItemNumber	string		Buyer-assigned item number
vendorItemNumber	string		Vendor-assigned item number
gtin12	string		GTIN-12 (UPC-A) barcode
gtin13	string		GTIN-13 (EAN) barcode
gtin14	string		GTIN-14 (ITF-14) case code barcode
caseCode	string		Case code identifier
drugCode	string		National Drug Code (NDC)
standardBookNumber	string		ISBN or standard book number
buyerItemIdsshow child fieldshide child fields	array		Additional buyer product identifiers
type	string	✓	Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
vendorItemIdsshow child fieldshide child fields	array		Additional vendor product identifiers
type	string	✓	Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
productAttributesshow child fieldshide child fields	object		Product attributes such as color, size, and description
description	string		General product description
shortDescription	string		Short product description
brand	string		Brand or label name for the product
colorCode	string		Color code identifier
colorDescription	string		Color description text
sizeCode	string		Size code identifier
sizeDescription	string		Size description text
materialCode	string		Material code identifier
materialDescription	string		Material description text
materialAttributesshow child fieldshide child fields	object		Material type or classification
type	string		Material type or classification
grade	string		Material grade or quality tier (e.g., prime, excessPrime, waste)
annealMethod	string		Annealing method applied to the material
temper	string		Heat treatment or mechanical processing state of the material
finish	string		Surface finish or texture applied to the material
outerCoating	string		Outer surface coating or plating
innerCoating	string		Inner surface coating or plating
surfaceProtection	string		Surface protection method or specification
treatment	string		Chemical or mechanical treatment applied to the material
weld	string		Welding specification or classification for the material
processCode	string		Process code identifier
processDescription	string		Process description text
height	string		Product height dimension
length	string		Product length dimension
width	string		Product width dimension
dimensionUOM	string		Values: `standardCubicFoot` `boardFeet` `hundredBoardFeet` `cubicDecimeter` `cubicCentimeter` `cubicFeet` `cubicInches` `centimeter` `cubicMeter` `cubicYard` `decimeter` `foot` `hundredFeet` `hundredFeetLinear` `hundredSquareFeet` `hundredYards` `inch` `linearFoot` `linearMeter` `linearYard` `millimeter` `meter` `squareFoot` `squareInches` `squareMeter` `squareYard` `thousandSquareInches` `thousandFeetLinear` `thousandFeetBoard` `tenSquareFeet` `thousandSquareFeet` `yard`
orderQuantityshow child fieldshide child fields	object		Quantity originally requested on the purchase order. Compare against an accepted action
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity Values: `assembly` `assortment` `bag` `bale` `ball` `bar` `barrel` `belt` `bin` `block` `boardFeet` `bolt` `book` `bottle` `box` `bulk` `bundle` `bushel` `cake` `can` `card` `carton` `cartridge` `case` `cassette` `celsius` `cell` `centigram` `centiliter` `centimeter` `coil` `combo` `cone` `container` `count` `cover` `display` `dozen` `drum` `each` `flakeTon` `foot` `gallon` `gram` `gramsPerLiter` `inch` `kilogram` `kit` `knots` `linearFoot` `liter` `meter` `milliliter` `monetaryValue` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sheet` `sixPack` `squareFoot` `syringe` `thousand` `threePack` `tote` `tube` `unit` `vial`
orderUnitPrice	string		Unit price originally requested on the purchase order. Compare against an accepted action
requestedShipDate	unknown		Ship date originally requested on the purchase order. Compare against an accepted action
requestedDeliveryDate	unknown		Delivery date originally requested on the purchase order. Compare against an accepted action
carrierDetailsshow child fieldshide child fields	object		FOB (Free on Board) terms and conditions for this line item
freeOnBoardshow child fieldshide child fields	array		FOB (Free on Board) terms and conditions for this line item
methodOfPayment	string		Values: `airCollect` `airPrepaid` `paidByBuyer` `collect` `mutuallyAgreed` `portOfCall` `halfPrepaid` `mixed` `serviceFreightNoCharge` `advancePrepaid` `customerPickupBackhaul` `prepaidChargeCustomer` `prepaidBySeller` `paidBySeller` `pickup` `thirdPartyPay`
locationType	string		Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
locationDescription	string		Description of FOB location
titlePassageType	string		Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
titlePassageDescription	string		Description of title passage location
transportationTermsSource	string		Values: `incoTerms` `tradeTerms` `mutuallyDefined`
transportationTerms	string		Values: `costAndFreight` `costInsuranceAndFreight` `carriageAndInsurancePaidTo` `carriagePaidTo` `deliveredAtFrontier` `deliverDutyPaid` `deliverDutyUnpaid` `deliveredDutyUnpaid` `deliveredExQuay` `deliveredExShip` `domesticallySupplied` `exQuay` `exShip` `exWorks` `freeAlongsideShip` `freeCarrier` `freightCarriageInsurancePaidTo` `freightCarriagePaidTo` `freeOnBoard` `freeOnRail` `freeOnTruck` `nonPrivilegedForeign` `privilegedForeign` `mutuallyDefined`
riskOfLoss	string		Values: `toDestinationBuyer` `toFreightEqPointSeller` `toPoolPointSeller` `toDestinationSeller` `mutuallyDefined`
description	string		Additional FOB description
allowancesshow child fieldshide child fields	array		Allowances or discounts applied to this line item
type	string	✓	Values: `advertising` `defectiveAllowance` `discount` `freight` `handling` `newStore` `other` `promotionalAllowance` `quantityDiscount` `rebate` `restocking` `serviceAtPickupOrDelivery` `shipping` `shippingAndHandling` `swell` `unsaleableMerchandiseAllowance` `volume` `warehouse`
amount	string		Fixed amount of allowance or charge
percent	string		Percentage of allowance or charge
percentBasis	string		Basis for calculating percentage Values: `basePrice`
methodOfHandling	string		Values: `collect` `paidByVendor` `paidByCustomer` `prepaid`
description	string		Description of the allowance or charge
chargesshow child fieldshide child fields	array		Additional charges applied to this line item
type	string	✓	Values: `advertising` `defectiveAllowance` `discount` `freight` `handling` `newStore` `other` `promotionalAllowance` `quantityDiscount` `rebate` `restocking` `serviceAtPickupOrDelivery` `shipping` `shippingAndHandling` `swell` `unsaleableMerchandiseAllowance` `volume` `warehouse`
amount	string		Fixed amount of allowance or charge
percent	string		Percentage of allowance or charge
percentBasis	string		Basis for calculating percentage Values: `basePrice`
methodOfHandling	string		Values: `collect` `paidByVendor` `paidByCustomer` `prepaid`
description	string		Description of the allowance or charge
actionsshow child fieldshide child fields	array	✓	Actions taken on this line item (accepted, rejected, or backordered)
status accepted ▸accepted ▾ rejected ▸rejected ▾ backordered ▸backordered ▾ onHold ▸onHold ▾	string	✓	The fields available for each item in this array depend on the value of `status` ("accepted", "rejected", "backordered", "onHold"). Expand a value below to see its specific fields.
statusNoteshow child fieldshide child fields	object		Additional notes or comments about the acceptance
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
quantityshow child fieldshide child fields	object		Confirmed quantity for this line item. This value must be sent in the payload to confirm what you are accepting. When receiving and acknowledgement: compare against the line item
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity Values: `assembly` `assortment` `bag` `bale` `ball` `bar` `barrel` `belt` `bin` `block` `boardFeet` `bolt` `book` `bottle` `box` `bulk` `bundle` `bushel` `cake` `can` `card` `carton` `cartridge` `case` `cassette` `celsius` `cell` `centigram` `centiliter` `centimeter` `coil` `combo` `cone` `container` `count` `cover` `display` `dozen` `drum` `each` `flakeTon` `foot` `gallon` `gram` `gramsPerLiter` `inch` `kilogram` `kit` `knots` `linearFoot` `liter` `meter` `milliliter` `monetaryValue` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sheet` `sixPack` `squareFoot` `syringe` `thousand` `threePack` `tote` `tube` `unit` `vial`
scheduledShipDate	unknown		Scheduled date for shipment
estimatedDeliveryDate	unknown		Estimated date of delivery
unitCostPrice	string		Confirmed unit price for this line item. When sending: include only if changing from the original purchase order. When receiving: always populated via mapping — compare against the line item
substitutedItemshow child fieldshide child fields	object		Product identifiers for the substituted item
productIdsshow child fieldshide child fields	object	✓	Product identifiers for the substituted item
buyerItemNumber	string		Buyer-assigned item number
vendorItemNumber	string		Vendor-assigned item number
gtin12	string		GTIN-12 (UPC-A) barcode
gtin13	string		GTIN-13 (EAN) barcode
gtin14	string		GTIN-14 (ITF-14) case code barcode
caseCode	string		Case code identifier
drugCode	string		National Drug Code (NDC)
standardBookNumber	string		ISBN or standard book number
buyerItemIdsshow child fieldshide child fields	array		Additional buyer product identifiers
type	string	✓	Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
vendorItemIdsshow child fieldshide child fields	array		Additional vendor product identifiers
type	string	✓	Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
statusReasonCode	string		Reason code explaining why the item was rejected Values: `discontinued` `invalidAddress` `invalidBillToCode` `invalidItemNumber` `invalidPrice` `invalidItemQuantity` `invalidShipFrom` `invalidShipMethod` `invalidShipToName` `invalidShipToAddress1` `invalidShipToAddress2` `invalidShipToCity` `invalidShipToStateOrProvince` `invalidShipToPostalCode` `invalidShipToCountry` `itemRecall` `itemSetupIssue` `mainlandOnly` `missingLineItemId` `missingOrderId` `missingShipId` `naturalDisaster` `outOfStock` `seasonalOrEndOfLife` `shippingInFull` `systemIssue` `taxNexusIssue` `transportationIssuePrepaid` `transportationIssueCollect` `undeliverableAddress` `weather`
statusNoteshow child fieldshide child fields	object		Additional notes or comments about the rejection
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
quantityshow child fieldshide child fields	object		Quantity being rejected
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity Values: `assembly` `assortment` `bag` `bale` `ball` `bar` `barrel` `belt` `bin` `block` `boardFeet` `bolt` `book` `bottle` `box` `bulk` `bundle` `bushel` `cake` `can` `card` `carton` `cartridge` `case` `cassette` `celsius` `cell` `centigram` `centiliter` `centimeter` `coil` `combo` `cone` `container` `count` `cover` `display` `dozen` `drum` `each` `flakeTon` `foot` `gallon` `gram` `gramsPerLiter` `inch` `kilogram` `kit` `knots` `linearFoot` `liter` `meter` `milliliter` `monetaryValue` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sheet` `sixPack` `squareFoot` `syringe` `thousand` `threePack` `tote` `tube` `unit` `vial`
statusReasonCode	string		Reason code explaining why the item is backordered Values: `discontinued` `invalidAddress` `invalidBillToCode` `invalidItemNumber` `invalidPrice` `invalidItemQuantity` `invalidShipFrom` `invalidShipMethod` `invalidShipToName` `invalidShipToAddress1` `invalidShipToAddress2` `invalidShipToCity` `invalidShipToStateOrProvince` `invalidShipToPostalCode` `invalidShipToCountry` `itemRecall` `itemSetupIssue` `mainlandOnly` `missingLineItemId` `missingOrderId` `missingShipId` `naturalDisaster` `outOfStock` `seasonalOrEndOfLife` `shippingInFull` `systemIssue` `taxNexusIssue` `transportationIssuePrepaid` `transportationIssueCollect` `undeliverableAddress` `weather`
statusNoteshow child fieldshide child fields	object		Additional notes or comments about the backorder
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
quantityshow child fieldshide child fields	object		Quantity being backordered
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity Values: `assembly` `assortment` `bag` `bale` `ball` `bar` `barrel` `belt` `bin` `block` `boardFeet` `bolt` `book` `bottle` `box` `bulk` `bundle` `bushel` `cake` `can` `card` `carton` `cartridge` `case` `cassette` `celsius` `cell` `centigram` `centiliter` `centimeter` `coil` `combo` `cone` `container` `count` `cover` `display` `dozen` `drum` `each` `flakeTon` `foot` `gallon` `gram` `gramsPerLiter` `inch` `kilogram` `kit` `knots` `linearFoot` `liter` `meter` `milliliter` `monetaryValue` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sheet` `sixPack` `squareFoot` `syringe` `thousand` `threePack` `tote` `tube` `unit` `vial`
scheduledShipDate	unknown		Scheduled date for shipment of backordered items
estimatedDeliveryDate	unknown		Estimated delivery date for backordered items
statusNoteshow child fieldshide child fields	object		Additional notes or comments about the hold
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
quantityshow child fieldshide child fields	object		Quantity on hold
value	string	✓	Numeric quantity value
unitOfMeasure	string		Unit of measure for the quantity Values: `assembly` `assortment` `bag` `bale` `ball` `bar` `barrel` `belt` `bin` `block` `boardFeet` `bolt` `book` `bottle` `box` `bulk` `bundle` `bushel` `cake` `can` `card` `carton` `cartridge` `case` `cassette` `celsius` `cell` `centigram` `centiliter` `centimeter` `coil` `combo` `cone` `container` `count` `cover` `display` `dozen` `drum` `each` `flakeTon` `foot` `gallon` `gram` `gramsPerLiter` `inch` `kilogram` `kit` `knots` `linearFoot` `liter` `meter` `milliliter` `monetaryValue` `ocularInsertSystem` `order` `ounce` `packPAK` `package` `pad` `pail` `pair` `pairInches` `palletLift` `palletUnitLoad` `person` `piece` `pint` `pound` `poundEquivalent` `poundGross` `quart` `reel` `roll` `section` `set` `sheet` `sixPack` `squareFoot` `syringe` `thousand` `threePack` `tote` `tube` `unit` `vial`

{
  "type": "855_PURCHASE_ORDER_ACKNOWLEDGMENT",
  "stream": "test",
  "senderId": "SELLERISA",
  "receiverId": "BUYERISA",
  "message": {
    "purchaseOrderNumber": "PO5786344061670677",
    "status": "accepted",
    "statusNote": {
      "description": "Order Confirmation",
      "text": [
        "Order acknowledged with exceptions on lines 3 and 5.",
        "Purple toothpaste is out of stock and cannot be backordered per PO instructions.",
        "Placeholder SKU substituted with equivalent test product."
      ]
    },
    "dates": {
      "purchaseOrderDate": "2026-02-12",
      "scheduledShipDate": "2026-02-19",
      "estimatedDeliveryDate": "2026-02-21"
    },
    "parties": {
      "shipFrom": {
        "name": "Toothpaste Warehouse West",
        "identificationCode": "WH-WEST-01",
        "identificationCodeType": "warehouse",
        "addressLine1": "2200 Distribution Pkwy",
        "city": "Edison",
        "stateOrProvinceCode": "NJ",
        "postalCode": "08817",
        "countryCode": "US",
        "contacts": [
          {
            "type": "shipping",
            "name": "Fulfillment Desk",
            "phoneNumber": "732-555-0100",
            "email": "[email protected]"
          }
        ]
      },
      "supplier": {
        "name": "Toothpaste Co.",
        "identificationCode": "4875905",
        "identificationCodeType": "sendersId",
        "addressLine1": "500 Oral Care Blvd",
        "city": "Newark",
        "stateOrProvinceCode": "NJ",
        "postalCode": "07102",
        "countryCode": "US",
        "contacts": [
          {
            "type": "primary",
            "name": "Order Management",
            "phoneNumber": "973-555-0200",
            "email": "[email protected]"
          }
        ]
      }
    },
    "termsOfSale": {
      "type": "basic",
      "basisDate": "deliveryDate",
      "discountPercent": "1",
      "discountDaysDue": 45,
      "description": "Net 45 Days"
    },
    "references": {
      "vendorNumber": {
        "value": "4875905"
      },
      "departmentNumber": {
        "value": "011"
      }
    },
    "lineItems": [
      {
        "purchaseOrderLineId": "1",
        "productIds": {
          "buyerItemNumber": "10000002",
          "gtin12": "002837465832"
        },
        "productAttributes": {
          "description": "Green toothpaste"
        },
        "actions": [
          {
            "status": "accepted",
            "quantity": {
              "value": "5",
              "unitOfMeasure": "each"
            },
            "unitCostPrice": "101.00",
            "scheduledShipDate": "2026-02-19",
            "estimatedDeliveryDate": "2026-02-21"
          }
        ]
      },
      {
        "purchaseOrderLineId": "2",
        "productIds": {
          "buyerItemNumber": "10000004",
          "gtin12": "002837465837"
        },
        "productAttributes": {
          "description": "Orange toothpaste"
        },
        "actions": [
          {
            "status": "accepted",
            "quantity": {
              "value": "20",
              "unitOfMeasure": "each"
            },
            "unitCostPrice": "88.00",
            "scheduledShipDate": "2026-02-19",
            "estimatedDeliveryDate": "2026-02-21"
          }
        ]
      },
      {
        "purchaseOrderLineId": "3",
        "productIds": {
          "buyerItemNumber": "10000003",
          "gtin12": "002837465836"
        },
        "productAttributes": {
          "description": "Purple toothpaste"
        },
        "actions": [
          {
            "status": "rejected",
            "statusReasonCode": "outOfStock",
            "statusNote": {
              "description": "Out of Stock",
              "text": [
                "Purple toothpaste is currently unavailable.",
                "Do-not-backorder instruction honored. Please reorder when stock replenishes."
              ]
            },
            "quantity": {
              "value": "5",
              "unitOfMeasure": "each"
            }
          }
        ]
      },
      {
        "purchaseOrderLineId": "4",
        "productIds": {
          "buyerItemNumber": "10000001",
          "gtin12": "002837465831"
        },
        "productAttributes": {
          "description": "Yellow toothpaste"
        },
        "actions": [
          {
            "status": "accepted",
            "quantity": {
              "value": "10",
              "unitOfMeasure": "each"
            },
            "unitCostPrice": "95.00",
            "scheduledShipDate": "2026-02-19",
            "estimatedDeliveryDate": "2026-02-21",
            "statusNote": {
              "description": "Price Adjustment",
              "text": ["Unit price reduced from $100.00 to $95.00 per promotional agreement."]
            }
          }
        ]
      },
      {
        "purchaseOrderLineId": "5",
        "productIds": {
          "buyerItemNumber": "ORDERFUL-TEST-SKU-005",
          "gtin12": "012345678005"
        },
        "productAttributes": {
          "description": "Placeholder product for scenario testing"
        },
        "actions": [
          {
            "status": "accepted",
            "quantity": {
              "value": "5",
              "unitOfMeasure": "each"
            },
            "unitCostPrice": "19.99",
            "scheduledShipDate": "2026-02-19",
            "estimatedDeliveryDate": "2026-02-21",
            "substitutedItem": {
              "productIds": {
                "buyerItemNumber": "ORDERFUL-TEST-SKU-005A",
                "gtin12": "012345678015"
              }
            },
            "statusNote": {
              "description": "Substitution",
              "text": ["Original test SKU replaced with updated revision SKU-005A at same price."]
            }
          }
        ]
      }
    ]
  }
}

File	Description	Download
sample.json	Sample JSON payload	Download
schema.json	JSON Schema for validation	Download
schema.csv	Schema fields in CSV format	Download