Purchase Order Change (860)

A Purchase Order Change (860) is sent by a buyer to modify, cancel, or update an existing purchase order.

Schema Overview Sample Downloads

Field	Type	Required	Description
purpose	string	✓	Intended purpose of the purchase order change transaction (BCH01) Values: `original` `cancellation` `change` `replace` `confirmation` `completion`
purchaseOrderType	string	✓	Type of purchase order issued (BCH02) Values: `blanketEstimated` `blanketFirm` `dropship` `release` `rushOrder` `standalone`
purchaseOrderChangeType	string		Type of purchase order change (BCH15) Values: `order` `productOrService`
purchaseOrderNumber	string	✓	Unique purchase order number (BCH03)
purchaseOrderDate	date	✓	Date the purchase order was issued (BCH06)
purchaseOrderChangeDate	date	✓	Date the purchase order was issued (BCH11)
releaseNumber	string		Release number for the purchase order (BCH04)
changeSequenceNumber	string		BCH05
contractNumber	string		BCH08 only if used correctly
acknowledgmentType	string		BCH14 When used to request a response to the 860 Values: `withDetail` `withExceptionDetail` `productReplenishment` `notRequired`
conditionsAndRestrictionsshow child fieldshide child fields	array
conditionType	string		Type of order condition or restriction Values: `backorderAllowed` `substitutionsAllowed` `doNotSubstitute` `doNotBackorder` `shipComplete` `shipPartialCancelBalance` `shipASAP` `standard` `quickResponse` `speed`
action	string		Action to take on the order Values: `confirm` `holdUntilReleased`
services	string		Service level requirement Values: `oneDayService` `twoDayService`
maxOrderValue	string		Maximum order value limit
partiesshow child fieldshide child fields	object
buyershow child fieldshide child fields	object		(N1 segment, BY) Buying Party = Party who is purchasing the product and/or service, but is not necessarily initiating 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		Type of identification code Values: `sendersId` `receiversId` `duns` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
shipToshow child fieldshide child fields	object		Ship-to location (N1 segment, ST)
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		Type of identification code Values: `sendersId` `receiversId` `duns` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
billToshow child fieldshide child fields	object		Bill-to location (N1 segment, BT)
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		Type of identification code Values: `sendersId` `receiversId` `duns` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
shipFromshow child fieldshide child fields	object
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		Type of identification code Values: `sendersId` `receiversId` `duns` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
accountsPayableshow child fieldshide child fields	object		Invoice-to or accounts payable party (N1 segment, PO) Used when the individual AP department may be different from the parent bill to department.
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		Type of identification code Values: `sendersId` `receiversId` `duns` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
soldToshow child fieldshide child fields	object		N1 segment, SO
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		Type of identification code Values: `sendersId` `receiversId` `duns` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
suppliershow child fieldshide child fields	object		N1 segment, SU, VN
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		Type of identification code Values: `sendersId` `receiversId` `duns` `pantCode` `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	✓	Type of contact Values: `primary` `customerRelations` `orderInquiry` `department` `shipping` `receiving` `hazmat`
name	string		Contact person name
phoneNumber	string		Contact phone number
faxNumber	string		Contact fax number
email	string		Contact email address
buyersCurrencyshow child fieldshide child fields	object		Currency code (CUR segment)
currencyCode	string	✓	ISO currency code (e.g., USD, EUR)
exchangeRate	string		Exchange rate for currency conversion
sellersCurrencyshow child fieldshide child fields	object
currencyCode	string	✓	ISO currency code (e.g., USD, EUR)
exchangeRate	string		Exchange rate for currency conversion
notesshow child fieldshide child fields	object
generalshow child fieldshide child fields	object		Generic notes or standard legal agreements
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
orderInstructionsshow child fieldshide child fields	object		CTB02(CTB01 = OR) or MSG/MTX when the spec is clear
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
shippingInstructionsshow child fieldshide child fields	object		CTB02(CTB01 = SR) or MSG/MTX when the spec is clear
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
giftMessageshow child fieldshide child fields	object		A message for the recipient, typically used in gift orders. Mainly found in dropship orders.
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
packingSlipMessageshow child fieldshide child fields	object		Message that is printed on the packing slip. Often contains a code that could be mapped to text.
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
paperworkshow child fieldshide child fields	array
reportType	string		PWK01 Values: `purchasingSpecification` `storageInquiry` `technicalInformation` `billOfLading` `orderAttachment` `materialDataSheet` `materialCertification`
reportTransmissionType	string		PWK02 Values: `withShipmentPackage`
copiesNeeded	integer		PWK03
isoLanguageCode	string		PWK06: PWK05=LE
url	string		PWK06: PWK05=UR
action	string		PWK08 Values: `generate`
description	string		PWK07
packagingshow child fieldshide child fields	array		PKG
characteristicType	string		Type of packaging characteristic Values: `containerShape` `hazardousMaterial` `packageSpecifications` `packing` `palletType` `productMarking` `shippingPackageLabeling` `typeOfPackage` `wrappingMaterial`
agencyType	string		Agency defining the packaging standard Values: `uniformCodeCouncil`
descriptionType	string		Type of description
description	string		Packaging description
unitLoadOption	string		Unit load configuration option Values: `palletized` `floorStack` `mixed` `slipSheet` `module` `clampable` `bopSheet` `airbagSlipsheetCombo` `CargoQuilt` `shrinkWrap` `loadLock`
termsOfSaleshow child fieldshide child fields	object
type	string		Type of payment terms Values: `basic` `basicDiscountOffered` `discountNotApplicable` `endOfMonth` `endOfMonth10` `extended` `instant` `fixedDate` `proximo` `mutuallyDefined`
basisDate	string		Date basis for calculating payment terms 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	date		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	date		Date when payment is due
discountAmount	string		Fixed discount amount
description	string		Description of payment terms
paymentMethodType	string		Method of payment Values: `check` `letterOfCredit` `wireTransfer` `corporateTradePayment` `specialAccount` `directPayOthers`
referencesshow child fieldshide child fields	object
accountNumbershow child fieldshide child fields	object		REF* 11, CR
value	string
description	string
arrivalCodeshow child fieldshide child fields	object		REF*AR
value	string
description	string
associatedPurchaseOrderNumbershow child fieldshide child fields	object		REF*AN
value	string
description	string
reservationNumbershow child fieldshide child fields	object		REF*CNO, CS for Macy's
value	string
description	string
customerOrderNumbershow child fieldshide child fields	object		REF*CO
value	string
description	string
deliveryReferenceshow child fieldshide child fields	object		REF*KK
value	string
description	string
divisionIdshow child fieldshide child fields	object		REF*19
value	string
description	string
departmentNumbershow child fieldshide child fields	object		REF*DP
value	string
description	string
internalCustomerNumbershow child fieldshide child fields	object		REF*[IT]
value	string
description	string
vendorNumbershow child fieldshide child fields	object		REF*[IA, VR]
value	string
description	string
merchandiseTypeCodeshow child fieldshide child fields	object		REF*MR
value	string
description	string
promotionNumbershow child fieldshide child fields	object		REF*PD
value	string
description	string
storeNumbershow child fieldshide child fields	object		REF*ST
value	string
description	string
thirdPartyReferenceNumbershow child fieldshide child fields	object		REF*GK
value	string
description	string
warehouseStorageLocationshow child fieldshide child fields	object		REF*WS
value	string
description	string
datesshow child fieldshide child fields	object
cancelAfterDate	date
customerOrderDate	date
earliestDeliveryDate	date
earliestShipDate	date
latestShipDate	date
latestDeliveryDate	date
pickupDate	date
promotionStartDate	date
purchaseOrderDate	date		Can be used on release orders for the original PO date
requestedDeliveryDate	date
requestedDeliveryWeekOfDate	date
requestedShipDate	date
carrierDetailsshow child fieldshide child fields	object
routingshow child fieldshide child fields	array
sequenceType	string		Sequence in the routing chain Values: `origin` `1stAfterOrigin` `4thAfterOrigin` `haulage`
standardCarrierAlphaCode	string		SCAC code identifying the carrier
customCarrierCode	string		Custom carrier identifier
transportationMethod	string		Method of transportation Values: `air` `airExpress` `airFreightForward` `backhaul` `bestWay` `commonCarrier` `consolidation` `customerPickup` `expeditedTruck` `lessThanTrailerLoad` `mail` `ocean` `oceanContainerized` `parcelPost` `privateCarrier` `rail` `shipperAgent` `supplierTruck` `mutuallyDefined`
locationType	string		Type of routing location Values: `inStore` `receiversLocation` `allPoints` `portOfArrival` `portOfEmbarkation` `origin` `mutuallyDefined`
location	string		Routing location identifier or name
description	string		Description of routing details
serviceLevel	string		Service level for shipping Values: `deliveryConfirmation` `doorService` `economy` `eveningService` `expedited` `firstClass` `ground` `groundHundredWeight` `international` `metro` `morning` `nextDayAir` `nextDayHundredWeight` `nextDayEvening` `nextDayMorning1030` `nextDayMorning930` `overnight` `poBoxZipCode` `priorityMail` `priorityMailInsured` `proofOfDelivery` `sameDay` `saturdayService` `secondDay` `secondDayHundredWeight` `secondDayAir` `standard` `standardGround` `threeDay`
orderStatus	string		Order shipping status Values: `shipCompleteOnDate` `complete` `partialShipment` `shipPartialBackorderToShipOnDate` `partialShipOnDate` `shipped` `backordered` `mutuallyDefined` `availableScheduledToShip` `availableNoShipSchedule` `multiPickup` `availableToShipUnBilledQuantity` `stopOff`
transitDirectionType	string		Direction of transit Values: `buyerToSeller` `sellerToBuyer` `subcontractorToSeller` `sellerToDropShipLocation` `sellToForwarder` `sellerToSubcontractor` `mutuallyDefined`
transitTimeType	string		Unit for transit time Values: `calendarDays` `hours` `workingDays`
transitTime	string		Expected transit time value
freeOnBoardshow child fieldshide child fields	array
methodOfPayment	string		Freight payment method Values: `airCollect` `airPrepaid` `paidByBuyer` `collect` `mutuallyAgreed` `portOfCall` `halfPrepaid` `mixed` `serviceFreightNoCharge` `advancePrepaid` `customerPickupBackhaul` `prepaidChargeCustomer` `prepaidBySeller` `paidBySeller` `pickup` `thirdPartyPay`
locationType	string		Type of FOB location Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
locationDescription	string		Description of FOB location
titlePassageType	string		Type of title passage location Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
titlePassageDescription	string		Description of title passage location
transportationTermsSource	string		Source of transportation terms Values: `incoTerms` `tradeTerms` `mutuallyDefined`
transportationTerms	string		Incoterms or trade terms code Values: `costAndFreight` `costInsuranceAndFreight` `carriageAndInsurancePaidTo` `carriagePaidTo` `deliveredAtFrontier` `deliverDutyPaid` `deliverDutyUnpaid` `deliveredDutyUnpaid` `deliveredExQuay` `deliveredExShip` `domesticallySupplied` `exQuay` `exShip` `exWorks` `freeAlongsideShip` `freeCarrier` `freightCarriageInsurancePaidTo` `freightCarriagePaidTo` `freeOnBoard` `freeOnRail` `freePnTruck` `nonPrivilegedForeign` `privilegedForeign` `mutuallyDefined`
riskOfLoss	string		Risk of loss transfer point Values: `toDestinationBuyer` `toFreightEqPointSeller` `toPoolPointSeller` `toDestinationSeller` `mutuallyDefined`
description	string		Additional FOB description
specialHandlingshow child fieldshide child fields	array
handlingType	string		Type of special handling required Values: `bulkyArticle` `dangerous` `deliveryService` `domestic` `doNotFreeze` `doNotUseWaterForFire` `environmentalControlLimits` `explosiveGas` `export` `flammable` `flammablePoisonGas` `fragile` `fullContainerConsolidatorLoad` `fullContainerFactoryLoad` `hazardousMaterial` `humiditySensitive` `ice` `keepDry` `marshalingNotRequired` `noPlacardsRequired` `notifyConsigneeBeforeDelivery` `partialShip` `perHourRatesApplied` `perishable` `poisonousGas` `protectFromHeat` `radioactiveMaterial` `refrigerated` `shipperLoadCount` `signatureAndTimeRequired` `stowBelowDeck` `temperatureControl` `trailerFactoryLoad` `transitShip` `unloadAsPlacarded` `waiveInspection` `volatileOrganicCompound`
description	string		Description of special handling
materialId	string		Hazardous material identifier
materialClass	string		Hazardous material class
conditionResponse	boolean		Condition response indicator
allowancesshow child fieldshide child fields	array		SAC loop
type	string	✓	Type of allowance or charge 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		How the charge is handled Values: `collect` `paidByVendor` `paidByCustomer` `prepaid`
description	string		Description of the allowance or charge
chargesshow child fieldshide child fields	array
type	string	✓	Type of allowance or charge 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		How the charge is handled Values: `collect` `paidByVendor` `paidByCustomer` `prepaid`
description	string		Description of the allowance or charge
monetaryAmountsshow child fieldshide child fields	object		AMT If the Debit flag is used, amount should be negative
net	string
gross	string
taxesshow child fieldshide child fields	object		TXI
generalTaxInformationshow child fieldshide child fields	object		For TAX segment
amount	string		Tax amount
percent	string		Tax percentage rate
taxIdNumber	string		Tax identification number
locationId	string		Tax location identifier
exemptionCode	string		Tax exemption status Values: `exempt` `notExempt` `notTaxable`
jurisdictionType	string		Type of tax jurisdiction
jurisdictionCode	string		Tax jurisdiction code
assignedId	string		Assigned tax identifier
lineItemsshow child fieldshide child fields	array		Purchase order change line items (POC loop)
purchaseOrderLineId	string
changeReason	string		POC02 Values: `addItem` `deleteItem` `changeToItem`
originalQuantityshow child fieldshide child fields	object		POC03 - Quantity before the change
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` `celcius` `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`
changeInQuantityshow child fieldshide child fields	object		Amount of change in quantity. Negative if the quantity is decreasing, positive if the quantity is increasing.
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` `celcius` `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`
quantityshow child fieldshide child fields	object		POC04 - Updated quantity after the change
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` `celcius` `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`
unitCostPrice	string
unitPriceBasis	string		Values: `advise` `beforeDiscount` `discount` `net` `noCharge` `perHundred` `perThousand` `perDozen` `perEach` `perFoot` `perGram` `perKilogram` `perTen` `perOunce` `perPound` `perTenThousand` `perUOM` `promotion` `standard` `suggestedRetail` `wholesale` `wholesalePerEach`
additionalPricingshow child fieldshide child fields	array
priceType	string		Type of price Values: `discountAllowed` `highValuePrice` `listCost` `retail` `promotional` `purchase`
unitPrice	string		Unit price value
unitPriceBasis	string		Basis for the unit price Values: `advise` `beforeDiscount` `discount` `net` `noCharge` `perHundred` `perThousand` `perDozen` `perEach` `perFoot` `perGram` `perKilogram` `perTen` `perOunce` `perPound` `perTenThousand` `perUOM` `promotion` `standard` `suggestedRetail` `wholesale` `wholesalePerEach`
quantityPerUnitPrice	string		Quantity per unit price
productIdsshow child fieldshide child fields	object	✓	POC
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	✓	Type of product identifier Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
vendorItemIdsshow child fieldshide child fields	array		Additional vendor product identifiers
type	string	✓	Type of product identifier Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
productAttributesshow child fieldshide child fields	object		PID, MEA, Some POC codes
description	string		General product description
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
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		Unit of measure for product dimensions 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`
outerPackshow child fieldshide child fields	object		PO4 When dimensions are included they apply to Pack/outerPack unless multiple iterations are used and it's clearly separated. PO401 has a value or is empty in some cases
numberOfUnits	string		Number of units in the package
size	string		Size value of the package
sizeUOM	string		Unit of measure for size Values: `bag` `box` `carton` `case` `cassette` `each` `fluidOunce` `gram` `kilogram` `liter` `milliliter` `ounce` `packPAK` `package` `pair` `pound` `roll` `tote` `unit`
packageForm	string		Form of the package Values: `bag` `bottle` `box` `can` `carton` `container` `pallet` `shrinkWrap` `unit`
packageMaterial	string		Material of the package Values: `corrugated` `plastic` `plasticVacuumed` `standard` `wood`
weightUOM	string		Unit of measure for weight Values: `pound` `kilogram`
grossWeight	string		Gross weight including packaging
netWeight	string		Net weight of contents only
volumeUOM	string		Unit of measure for volume Values: `standardCubicFoot` `centiliter` `cubicDecimeter` `cubicCentimeter` `cubicFeet` `cubicInches` `cubicMeter` `cubicYard` `deciliter` `fluidOunce` `gallon` `halfGallon` `kiloliter` `kilogramsPerCubicMeter` `liter` `milliliter` `netGallons` `pint` `halfPint` `quart`
volume	string		Volume value
length	string		Length dimension
width	string		Width dimension
height	string		Height dimension
dimensionUOM	string		Unit of measure for dimensions 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`
packageId	string		Package identifier
innerPackshow child fieldshide child fields	object		PO414 has a value
numberOfUnits	string		Number of units in the package
size	string		Size value of the package
sizeUOM	string		Unit of measure for size Values: `bag` `box` `carton` `case` `cassette` `each` `fluidOunce` `gram` `kilogram` `liter` `milliliter` `ounce` `packPAK` `package` `pair` `pound` `roll` `tote` `unit`
packageForm	string		Form of the package Values: `bag` `bottle` `box` `can` `carton` `container` `pallet` `shrinkWrap` `unit`
packageMaterial	string		Material of the package Values: `corrugated` `plastic` `plasticVacuumed` `standard` `wood`
weightUOM	string		Unit of measure for weight Values: `pound` `kilogram`
grossWeight	string		Gross weight including packaging
netWeight	string		Net weight of contents only
volumeUOM	string		Unit of measure for volume Values: `standardCubicFoot` `centiliter` `cubicDecimeter` `cubicCentimeter` `cubicFeet` `cubicInches` `cubicMeter` `cubicYard` `deciliter` `fluidOunce` `gallon` `halfGallon` `kiloliter` `kilogramsPerCubicMeter` `liter` `milliliter` `netGallons` `pint` `halfPint` `quart`
volume	string		Volume value
length	string		Length dimension
width	string		Width dimension
height	string		Height dimension
dimensionUOM	string		Unit of measure for dimensions 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`
packageId	string		Package identifier
packagingshow child fieldshide child fields	array		PKG
characteristicType	string		Type of packaging characteristic Values: `containerShape` `hazardousMaterial` `packageSpecifications` `packing` `palletType` `productMarking` `shippingPackageLabeling` `typeOfPackage` `wrappingMaterial`
agencyType	string		Agency defining the packaging standard Values: `uniformCodeCouncil`
descriptionType	string		Type of description
description	string		Packaging description
unitLoadOption	string		Unit load configuration option Values: `palletized` `floorStack` `mixed` `slipSheet` `module` `clampable` `bopSheet` `airbagSlipsheetCombo` `CargoQuilt` `shrinkWrap` `loadLock`
datesshow child fieldshide child fields	object		Line level DTM
cancelAfterDate	date
customerOrderDate	date
earliestDeliveryDate	date
earliestShipDate	date
latestShipDate	date
latestDeliveryDate	date
pickupDate	date
promotionStartDate	date
purchaseOrderDate	date		Can be used on release orders for the original PO date
requestedDeliveryDate	date
requestedDeliveryWeekOfDate	date
requestedShipDate	date
referencesshow child fieldshide child fields	object		Line level REF
reservationNumbershow child fieldshide child fields	object		REF*CNO, CS for Macy's
value	string
description	string
divisionIdshow child fieldshide child fields	object		REF*19
value	string
description	string
departmentNumbershow child fieldshide child fields	object		REF*DP
value	string
description	string
merchandiseTypeCodeshow child fieldshide child fields	object		REF*MR
value	string
description	string
promotionNumbershow child fieldshide child fields	object		REF*PD
value	string
description	string
storeNumbershow child fieldshide child fields	object		REF*ST
value	string
description	string
destinationQuantitiesshow child fieldshide child fields	object		SDQ
locationType	string		Type of location identifier Values: `sendersId` `receiversId` `duns` `dunsPlus4` `standardAddressSAN` `warehouse` `globalLocationId`
unitOfMeasure	string		Unit of measure for quantities 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` `celcius` `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`
quantityByLocationshow child fieldshide child fields	object	✓	Destination location identifier
destinationId	string	✓	Destination location identifier
quantity	string	✓	Quantity for this destination
allowancesshow child fieldshide child fields	array		SAC loop
type	string	✓	Type of allowance or charge 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		How the charge is handled Values: `collect` `paidByVendor` `paidByCustomer` `prepaid`
description	string		Description of the allowance or charge
chargesshow child fieldshide child fields	array		SAC loop
type	string	✓	Type of allowance or charge 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		How the charge is handled Values: `collect` `paidByVendor` `paidByCustomer` `prepaid`
description	string		Description of the allowance or charge
monetaryAmountsshow child fieldshide child fields	object		AMT: If the Debit flag is used, amount should be negative
gross	string
net	string
sublineItemsshow child fieldshide child fields	array		SLN loop
sublineId	string		Subline item identifier
quantityshow child fieldshide child fields	object		Quantity for the subline 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` `celcius` `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`
unitCostPrice	string		Unit cost price for the subline item
unitPriceBasis	string		Basis for the unit price Values: `advise` `beforeDiscount` `discount` `net` `noCharge` `perHundred` `perThousand` `perDozen` `perEach` `perFoot` `perGram` `perKilogram` `perTen` `perOunce` `perPound` `perTenThousand` `perUOM` `promotion` `standard` `suggestedRetail` `wholesale` `wholesalePerEach`
productIdsshow child fieldshide child fields	object	✓	Product identifiers for the subline 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	✓	Type of product identifier Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
vendorItemIdsshow child fieldshide child fields	array		Additional vendor product identifiers
type	string	✓	Type of product identifier Values: `catalog` `manufacturerPart` `sku` `style`
value	string	✓	Product identifier value
productAttributesshow child fieldshide child fields	object		Product attributes for the subline item
description	string		General product description
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
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		Unit of measure for product dimensions 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`
notesshow child fieldshide child fields	object
generalshow child fieldshide child fields	object		Generic notes or standard legal agreements
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
orderInstructionsshow child fieldshide child fields	object		CTB02(CTB01 = OR) or MSG/MTX when the spec is clear
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
shippingInstructionsshow child fieldshide child fields	object		CTB02(CTB01 = SR) or MSG/MTX when the spec is clear
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
giftMessageshow child fieldshide child fields	object		A message for the recipient, typically used in gift orders. Mainly found in dropship orders.
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
packingSlipMessageshow child fieldshide child fields	object		Message that is printed on the packing slip. Often contains a code that could be mapped to text.
description	string		Brief description or title of the note
text	array of string		Array of text lines for the note content
paperworkshow child fieldshide child fields	array
reportType	string		PWK01 Values: `purchasingSpecification` `storageInquiry` `technicalInformation` `billOfLading` `orderAttachment` `materialDataSheet` `materialCertification`
reportTransmissionType	string		PWK02 Values: `withShipmentPackage`
copiesNeeded	integer		PWK03
isoLanguageCode	string		PWK06: PWK05=LE
url	string		PWK06: PWK05=UR
action	string		PWK08 Values: `generate`
description	string		PWK07
conditionsAndRestrictionsshow child fieldshide child fields	array
conditionType	string		Type of order condition or restriction Values: `backorderAllowed` `substitutionsAllowed` `doNotSubstitute` `doNotBackorder` `shipComplete` `shipPartialCancelBalance` `shipASAP` `standard` `quickResponse` `speed`
action	string		Action to take on the order Values: `confirm` `holdUntilReleased`
services	string		Service level requirement Values: `oneDayService` `twoDayService`
maxOrderValue	string		Maximum order value limit
carrierDetailsshow child fieldshide child fields	object
routingshow child fieldshide child fields	array
sequenceType	string		Sequence in the routing chain Values: `origin` `1stAfterOrigin` `4thAfterOrigin` `haulage`
standardCarrierAlphaCode	string		SCAC code identifying the carrier
customCarrierCode	string		Custom carrier identifier
transportationMethod	string		Method of transportation Values: `air` `airExpress` `airFreightForward` `backhaul` `bestWay` `commonCarrier` `consolidation` `customerPickup` `expeditedTruck` `lessThanTrailerLoad` `mail` `ocean` `oceanContainerized` `parcelPost` `privateCarrier` `rail` `shipperAgent` `supplierTruck` `mutuallyDefined`
locationType	string		Type of routing location Values: `inStore` `receiversLocation` `allPoints` `portOfArrival` `portOfEmbarkation` `origin` `mutuallyDefined`
location	string		Routing location identifier or name
description	string		Description of routing details
serviceLevel	string		Service level for shipping Values: `deliveryConfirmation` `doorService` `economy` `eveningService` `expedited` `firstClass` `ground` `groundHundredWeight` `international` `metro` `morning` `nextDayAir` `nextDayHundredWeight` `nextDayEvening` `nextDayMorning1030` `nextDayMorning930` `overnight` `poBoxZipCode` `priorityMail` `priorityMailInsured` `proofOfDelivery` `sameDay` `saturdayService` `secondDay` `secondDayHundredWeight` `secondDayAir` `standard` `standardGround` `threeDay`
orderStatus	string		Order shipping status Values: `shipCompleteOnDate` `complete` `partialShipment` `shipPartialBackorderToShipOnDate` `partialShipOnDate` `shipped` `backordered` `mutuallyDefined` `availableScheduledToShip` `availableNoShipSchedule` `multiPickup` `availableToShipUnBilledQuantity` `stopOff`
transitDirectionType	string		Direction of transit Values: `buyerToSeller` `sellerToBuyer` `subcontractorToSeller` `sellerToDropShipLocation` `sellToForwarder` `sellerToSubcontractor` `mutuallyDefined`
transitTimeType	string		Unit for transit time Values: `calendarDays` `hours` `workingDays`
transitTime	string		Expected transit time value
freeOnBoardshow child fieldshide child fields	array
methodOfPayment	string		Freight payment method Values: `airCollect` `airPrepaid` `paidByBuyer` `collect` `mutuallyAgreed` `portOfCall` `halfPrepaid` `mixed` `serviceFreightNoCharge` `advancePrepaid` `customerPickupBackhaul` `prepaidChargeCustomer` `prepaidBySeller` `paidBySeller` `pickup` `thirdPartyPay`
locationType	string		Type of FOB location Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
locationDescription	string		Description of FOB location
titlePassageType	string		Type of title passage location Values: `cityAndState` `country` `destination` `origin` `stateProvince` `warehouse`
titlePassageDescription	string		Description of title passage location
transportationTermsSource	string		Source of transportation terms Values: `incoTerms` `tradeTerms` `mutuallyDefined`
transportationTerms	string		Incoterms or trade terms code Values: `costAndFreight` `costInsuranceAndFreight` `carriageAndInsurancePaidTo` `carriagePaidTo` `deliveredAtFrontier` `deliverDutyPaid` `deliverDutyUnpaid` `deliveredDutyUnpaid` `deliveredExQuay` `deliveredExShip` `domesticallySupplied` `exQuay` `exShip` `exWorks` `freeAlongsideShip` `freeCarrier` `freightCarriageInsurancePaidTo` `freightCarriagePaidTo` `freeOnBoard` `freeOnRail` `freePnTruck` `nonPrivilegedForeign` `privilegedForeign` `mutuallyDefined`
riskOfLoss	string		Risk of loss transfer point Values: `toDestinationBuyer` `toFreightEqPointSeller` `toPoolPointSeller` `toDestinationSeller` `mutuallyDefined`
description	string		Additional FOB description

{
  "purpose": "change",
  "purchaseOrderType": "standalone",
  "purchaseOrderChangeType": "order",
  "purchaseOrderNumber": "PO-2024-001234",
  "purchaseOrderDate": "2024-01-10",
  "purchaseOrderChangeDate": "2024-01-15",
  "changeSequenceNumber": "001",
  "acknowledgmentType": "withDetail",
  "parties": {
    "buyer": {
      "name": "Retail Corp",
      "identificationCode": "RETAILCORP",
      "identificationCodeType": "receiversId",
      "addressLine1": "100 Commerce Street",
      "city": "New York",
      "stateOrProvinceCode": "NY",
      "postalCode": "10001",
      "countryCode": "US",
      "contacts": [
        {
          "type": "primary",
          "name": "Jane Doe",
          "email": "purchasing@retailcorp.com",
          "phoneNumber": "555-987-6543"
        }
      ]
    },
    "shipTo": {
      "name": "Retail Corp - Distribution Center",
      "identificationCode": "DC-EAST-01",
      "identificationCodeType": "warehouse",
      "addressLine1": "500 Warehouse Blvd",
      "city": "Newark",
      "stateOrProvinceCode": "NJ",
      "postalCode": "07101",
      "countryCode": "US"
    },
    "supplier": {
      "name": "Acme Products LLC",
      "identificationCode": "ACMEPRODUCTS",
      "identificationCodeType": "sendersId"
    }
  },
  "buyersCurrency": {
    "currencyCode": "USD"
  },
  "notes": {
    "general": {
      "description": "Order modification",
      "text": ["Increasing quantity on line 1, cancelling line 3"]
    },
    "shippingInstructions": {
      "text": ["Please expedite shipment due to increased demand"]
    }
  },
  "termsOfSale": {
    "type": "basic",
    "basisDate": "invoiceDate",
    "discountPercent": "2",
    "discountDaysDue": 10,
    "netDaysDue": 30
  },
  "references": {
    "departmentNumber": {
      "value": "DEPT-200"
    },
    "vendorNumber": {
      "value": "VN-12345"
    }
  },
  "dates": {
    "requestedDeliveryDate": "2024-02-01",
    "cancelAfterDate": "2024-02-15"
  },
  "carrierDetails": {
    "routing": [
      {
        "transportationMethod": "lessThanTrailerLoad",
        "standardCarrierAlphaCode": "UPSN",
        "serviceLevel": "ground"
      }
    ],
    "freeOnBoard": [
      {
        "methodOfPayment": "prepaidBySeller",
        "locationType": "destination"
      }
    ]
  },
  "lineItems": [
    {
      "purchaseOrderLineId": "001",
      "changeReason": "changeToItem",
      "originalQuantity": {
        "value": "100",
        "unitOfMeasure": "each"
      },
      "changeInQuantity": {
        "value": "50",
        "unitOfMeasure": "each"
      },
      "quantity": {
        "value": "150",
        "unitOfMeasure": "each"
      },
      "unitCostPrice": "25.00",
      "unitPriceBasis": "perEach",
      "productIds": {
        "buyerItemNumber": "SKU-WIDGET-001",
        "vendorItemNumber": "ACME-W100",
        "gtin12": "012345678901"
      },
      "productAttributes": {
        "description": "Premium Widget - Standard",
        "colorDescription": "Black"
      },
      "dates": {
        "requestedShipDate": "2024-01-25"
      }
    },
    {
      "purchaseOrderLineId": "002",
      "changeReason": "addItem",
      "quantity": {
        "value": "75",
        "unitOfMeasure": "each"
      },
      "unitCostPrice": "18.50",
      "unitPriceBasis": "perEach",
      "productIds": {
        "buyerItemNumber": "SKU-GADGET-002",
        "vendorItemNumber": "ACME-G200",
        "gtin12": "012345678902"
      },
      "productAttributes": {
        "description": "Deluxe Gadget - New Item"
      },
      "notes": {
        "general": {
          "text": ["New item added to order"]
        }
      }
    },
    {
      "purchaseOrderLineId": "003",
      "changeReason": "deleteItem",
      "originalQuantity": {
        "value": "50",
        "unitOfMeasure": "each"
      },
      "quantity": {
        "value": "0",
        "unitOfMeasure": "each"
      },
      "productIds": {
        "buyerItemNumber": "SKU-TOOL-003",
        "vendorItemNumber": "ACME-T300"
      },
      "productAttributes": {
        "description": "Basic Tool - Cancelled"
      }
    }
  ]
}

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