GuidesAPI ReferenceChangelogWeb EDISupportContact Us
API Reference

Purchase Order

Purchase Order (850)

A Purchase Order is sent by a buyer to a supplier to request goods or services.

The simplified PURCHASE_ORDER schema can be used for relationships with partners that trade the 850_PURCHASE_ORDER, 875_GROCERY_PRODUCTS_PURCHASE_ORDER, or ORDERS_PURCHASE_ORDER document types.

Field Type Required Description
purpose
 string ✓ Intended purpose of the purchase order transaction (e.g., original, change, cancellation)
Values: original cancellation change replace confirmation informationCopy duplicate
purchaseOrderType
 string ✓ Type of purchase order issued (e.g., standalone, dropship, release)
Values: blanketEstimated blanketFirm confirmation consignment containerFloor floorSample freeGoods dropship directShip portOfEntry preCommitment release rushOrder shippedOrder standalone
orderProcessingType
 object Buyer-assigned code describing how the order is to be processed through their supply chain, such as whether it replenishes existing stock or is routed to a new or cross-docked destination. Distinct from the type of order itself, which the order type describes.
value
 string The reference identifier value
description
 string Additional description or context for the reference
purchaseOrderNumber
 string ✓ Unique purchase order number assigned by the buyer
purchaseOrderDate
 string ✓ Date the purchase order was issued. In EDIFACT, sourced from DTM qualifier "137" (Document/message date) when present, falling back to qualifier "4" (Order date/time). If both qualifiers appear in the input, prefer qualifier 137 for the value AND emit a $collectError noting the ambiguity. If neither qualifier is present, leave this field null — it is optional and a missing document date is not an error.
Formats: date date-time
contractNumber
 string Contract number associated with the purchase order
releaseNumber
 string Release number for blanket or contract orders
acknowledgmentType
 string Type of acknowledgment requested from the supplier
Values: withDetail withExceptionDetail productReplenishment notRequired
conditionsAndRestrictions
 array Order-level conditions and restrictions such as backorder policy
conditionType
 string Type of order condition or restriction
Values: backorderAllowed substitutionsAllowed doNotSubstitute doNotBackorder shipComplete shipPartialCancelBalance shipPartialProportional 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
percent
 string Percentage qualifying the condition — for a partial-shipment condition, the proportion of the ordered quantity that may ship
parties
 object Parties involved in the purchase order transaction. Includes contact information where available
buyer
 object Buying party who is purchasing the product or service
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 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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
shipTo
 object Ship-to location where goods should 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 Type of identification code
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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
billTo
 object Bill-to location for invoicing
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 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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
shipFrom
 object Ship-from location where goods 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 Type of identification code
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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
accountsPayable
 object Accounts payable party for invoice processing
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 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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
soldTo
 object Sold-to party, the entity to whom goods are sold
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 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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
store
 object Retail store location associated with the order, given as a fully addressable location
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 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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
supplier
 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 Type of identification code
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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
manufacturer
 object Party that manufactured the goods — the production plant or factory, as distinct from the vendor that sold them
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 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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
agent
 object Third party acting on another party’s behalf for this order, such as a buying agent on an import 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 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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code
assertions
 object Declarations or special conditions asserted about the order as a whole
isFairLaborStandardsActCompliant
 object Indicates the goods covered by this order are declared compliant with the Fair Labor Standards Act (FLSA).
value
 boolean ✓
buyersCurrency
 object Currency used by the buyer for the transaction
currencyCode
 string ✓ ISO currency code (e.g., USD, EUR)
exchangeRate
 string Exchange rate for currency conversion
sellersCurrency
 object Currency used by the seller for the transaction
currencyCode
 string ✓ ISO currency code (e.g., USD, EUR)
exchangeRate
 string Exchange rate for currency conversion
customsDetails
 object Customs and import details for the goods on this order, sent on import and first-cost orders
tariffNumber
 string Customs tariff classification for the goods — the harmonized 6-digit code, or a country-extended code such as a 10-digit US HTSUS number
countryOfOrigin
 string Country where the goods were manufactured
notes
 object Notes and instructions for the order
general
 object Generic notes or standard legal agreements. Default for N9+L1 unless the guideline note or a different qualifier points elsewhere — pick the best-fitting field.
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
orderInstructions
 object Special instructions for processing the order. Default for CTB02 when CTB01=OR. MSG/MTX free-form text (segments named messageText/text in the input JSON) may also route here when the guideline note indicates order instructions — pick the best-fitting field.
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
shippingInstructions
 object Special instructions for shipping the order. Default for CTB02 when CTB01=SR. MSG/MTX free-form text (segments named messageText/text in the input JSON) may also route here when the guideline note indicates shipping instructions — pick the best-fitting field.
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
paymentInstructions
 object Payment-related notes or instructions (e.g., VAT split-payment marker text)
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
giftMessage
 object Message for the recipient, typically used in gift or dropship orders
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
packingSlipMessage
 object Message to be printed on the packing slip
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
paperwork
 array Paperwork and documentation requirements
reportType
 string Type of report or document required
Values: purchasingSpecification storageInquiry technicalInformation billOfLading orderAttachment materialDataSheet materialCertification
reportTransmissionType
 string Method by which the report should be transmitted
Values: withShipmentPackage
copiesNeeded
 integer Number of copies of the document required
isoLanguageCode
 string ISO language code for the document
url
 string URL where the document can be accessed
action
 string Action to be taken with the paperwork
Values: generate
description
 string Description or additional details about the paperwork
packaging
 array Packaging and marking requirements for the order
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 - how the shipment is physically arranged
Values: palletized floorStack mixed slipSheet module clampable bopSheet airbagSlipSheetCombo cargoQuilt shrinkWrap loadLock
termsOfSale
 object Payment terms and conditions for the order
type
 string Type of payment terms
Values: basic basicDiscountOffered discountNotApplicable endOfMonth endOfMonth10 extended instant fixedDate proximo deferred mutuallyDefined
basisDate
 string Date basis for calculating payment terms
Values: invoiceDate receiptOfGoods deliveryDate shipDate mutuallyDefined gageApprovalDate specifiedDate acceptanceDate invoiceTransmissionDate effectiveDate
effectiveDate
 string Date on which the payment terms take effect
Formats: date date-time
discountPercent
 string Discount percentage if paid early
discountDaysDue
 integer Number of days to qualify for discount
discountDueDate
 string Date by which payment must be made for discount
Formats: date date-time
dayOfMonth
 integer Day of month for payment
netDaysDue
 integer Number of days until payment is due
netDueDate
 string Date when payment is due
Formats: date date-time
discountAmount
 string Fixed discount amount
description
 string Description of payment terms
deferredDueDate
 string Date when the deferred payment or percent of invoice payable is due, typically used with seasonal or installment terms
Formats: date date-time
deferredAmountDue
 string Amount due on the deferred payment date, used with deferred or installment terms
percentOfInvoicePayable
 string Percentage of the invoice amount payable on the deferred due date, used with deferred or installment terms
paymentMethodType
 string Method of payment
Values: check letterOfCredit wireTransfer corporateTradePayment specialAccount directPayOthers
references
 object Reference numbers associated with the order. Each subfield routes ONE specific reference qualifier — match by the field description (which states the qualifier semantics), not by the path-filter alone. When a partner sends a qualifier whose semantics do not match any subfield description, emit a SCHEMA GAP rather than auto-routing it.
accountNumber
 object Account number or credit reference for the order
value
 string The reference identifier value
description
 string Additional description or context for the reference
appointmentNumber
 object Identifier for a scheduled delivery or pickup appointment booked with the receiving location
value
 string The reference identifier value
description
 string Additional description or context for the reference
arrivalCode
 object Code indicating arrival information or instructions
value
 string The reference identifier value
description
 string Additional description or context for the reference
associatedPurchaseOrderNumber
 object Related or parent purchase order number
value
 string The reference identifier value
description
 string Additional description or context for the reference
reservationNumber
 object Reservation number
value
 string The reference identifier value
description
 string Additional description or context for the reference
customerOrderNumber
 object Customer-assigned order number for tracking
value
 string The reference identifier value
description
 string Additional description or context for the reference
deliveryReference
 object Reference number for delivery coordination
value
 string The reference identifier value
description
 string Additional description or context for the reference
divisionId
 object Identifier for the business division placing the order
value
 string The reference identifier value
description
 string Additional description or context for the reference
departmentNumber
 object Department number within the buying organization
value
 string The reference identifier value
description
 string Additional description or context for the reference
freightPayerReference
 object Freight payer reference number
value
 string The reference identifier value
description
 string Additional description or context for the reference
internalCustomerNumber
 object Internal customer identifier used by the buyer
value
 string The reference identifier value
description
 string Additional description or context for the reference
vendorNumber
 object Vendor or supplier identifier assigned by the buyer
value
 string The reference identifier value
description
 string Additional description or context for the reference
loadPlanningNumber
 object Load planning or load ID number
value
 string The reference identifier value
description
 string Additional description or context for the reference
merchandiseTypeCode
 object Code classifying the type of merchandise
value
 string The reference identifier value
description
 string Additional description or context for the reference
pricingQuote
 object Pricing quote reference number
value
 string The reference identifier value
description
 string Additional description or context for the reference
promotionNumber
 object Promotional campaign or deal identifier
value
 string The reference identifier value
description
 string Additional description or context for the reference
storeNumber
 object Retail store location identifier. Commonly carried inside a party (N1) loop qualifying the ship-to or bill-to rather than at document level; it names the same store either way.
value
 string The reference identifier value
description
 string Additional description or context for the reference
thirdPartyReferenceNumber
 object Reference number from a third-party system
value
 string The reference identifier value
description
 string Additional description or context for the reference
warehouseStorageLocation
 object Warehouse or storage location identifier
value
 string The reference identifier value
description
 string Additional description or context for the reference
dates
 object Important dates for the order such as purchase order date, ship date, and requested delivery date
cancelAfterDate
 string Date after which the order should be cancelled if not fulfilled
Formats: date date-time
customerOrderDate
 string Date when the customer originally placed the order
Formats: date date-time
earliestDeliveryDate
 string Earliest acceptable date for delivery
Formats: date date-time
estimatedDeliveryMonthOfDate
 string Month during which the goods are estimated to arrive. Only the month and year are meaningful — the day is set to the 1st of the month by convention.
Formats: date date-time
earliestShipDate
 string Earliest acceptable date for shipment
Formats: date date-time
latestShipDate
 string Latest acceptable date for shipment
Formats: date date-time
latestDeliveryDate
 string Latest acceptable date for delivery. Covers 063 ("Do Not Deliver After"), 106 ("Required By") and 074 ("Requested for Delivery (Prior to and Including)") — all three name the last acceptable delivery date, whether phrased as a prohibition or a request.
Formats: date date-time
pickupDate
 string Scheduled date for pickup
Formats: date date-time
promotionStartDate
 string Start date of the promotional period
Formats: date date-time
purchaseOrderDate
 string Date of the original purchase order, used on release orders
Formats: date date-time
requestedDeliveryDate
 string Requested date for delivery
Formats: date date-time
requestedShipDate
 string Date the buyer wants the goods shipped. Covers 010 ("Requested Ship") and 068 ("Current Schedule Ship") — on a purchase order both name a single point the buyer is asking the vendor to ship on; who arranged the freight is carried by the carrier details, not by this qualifier.
Formats: date date-time
requestedDeliveryWeekOfDate
 string Week during which delivery is requested
Formats: date date-time
revisionDate
 string Date of the most recent revision to the order, or the date of the initial version if never revised
Formats: date date-time
carrierDetails
 object Carrier and shipping details for the order
quantityAndWeight
 array Quantity and weight details for the shipment
packageForm
 string Form of packaging
Values: bag carton case coil pallet
packageMaterial
 string Material of packaging
Values: aluminum corrugated plastic plasticVacuumed standard steel wood
ladingQuantity
 string Number of shipping packages in this quantity-and-weight entry, counted in the packaging form given by packageForm — pallets when that is pallet, cartons when it is carton
totalQuantity
 string Document-level hash total of item quantities — the sum of the line-item quantities, not a count of shipping packages
totalQuantityUOM
 string Unit of measure for the total 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 hundredweight inch kilogram keg 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
weightUOM
 string Unit of measure for weight
Values: pound kilogram gram ounce
grossWeight
 string Gross weight including packaging
netWeight
 string Net weight of contents only
volume
 string Total volume of the shipment
volumeUOM
 string Unit of measure for volume
Values: cubicFeet cubicInches cubicMeter cubicYard gallon liter
dimensionUOM
 string Unit of measure for length
Values: foot meter
length
 string Total linear length of coils in the shipment
basebox
 string Billable quantity in baseboxes (tin plate industry unit: 112 sheets × 14"×20" = 31,360 sq in)
routing
 array Carrier routing and transportation method details
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. EDIFACT: prefer C001.8179 (transportMeansDescriptionCode) — its means/vessel-level codes match this enum directly. Fall back to C220.8067 (transportModeNameCode) ONLY when 8179 is absent; 8067 carries broad-mode codes only (1=Maritime, 2=Rail, 3=Road, 4=Air, 5=Mail, 6=Multimodal, 7=Fixed installation, 8=Inland water) which map loosely: 1→ocean, 2→rail, 3→supplierTruck, 4→air. Granular enum values (airExpress, oceanContainerized, trailer, etc.) cannot be recovered from 8067 — emit a SCHEMA GAP if neither path carries the partner value.
Values: air airExpress airFreightForward backhaul bestWay commonCarrier consolidation customerPickup expeditedTruck lessThanTrailerLoad mail ocean oceanContainerized parcelPost privateCarrier rail shipperAgent supplierTruck trailer 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 nextDaySaturday overnight poBoxZipCode priorityMail priorityMailInsured proofOfDelivery sameDay saturdayService secondDay secondDayHundredWeight secondDayAir secondDaySaturday 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
freeOnBoard
 array FOB (Free on Board) terms and conditions
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 foreignFreightForwarder onVessel mutuallyDefined
locationDescription
 string Description of FOB location
titlePassageType
 string Type of title passage location
Values: cityAndState country destination origin stateProvince warehouse foreignFreightForwarder
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 freeOnTruck nonPrivilegedForeign privilegedForeign mutuallyDefined
riskOfLoss
 string Risk of loss transfer point
Values: toDestinationBuyer toFreightEqPointSeller toPoolPointSeller toDestinationSeller mutuallyDefined
description
 string Additional FOB description
specialHandling
 array Special handling requirements for the shipment
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
allowances
 array Allowances or discounts applied to the order
type
 string ✓ Type of allowance or charge
Values: advertising centralBuy competitiveAllowance cooperativeAdvertising customsBrokerFee customsEntry commission damagedMerchandiseAllowance defectiveAllowance coreCharge deposit discount displayAllowance earlyBuyAllowance forwardingCharge freeGoods freight fuelSurcharge handling iceCharge inboundFreight inlandTransportation labelAllowance latePaymentCharge networkAllowance newDistributionAllowance newStore newWarehouse other pallet pickup pickupAndDelivery priceDeviation promotionalAllowance quantityDiscount quantitySurcharge rebate refrigeration restocking royalty serviceAtPickupOrDelivery shipping shippingAndHandling specialAllowance specialBuy splitDelivery swell tax temperatureProtection tobaccoProductsReportCharge truckloadDiscount unloading unsaleableMerchandiseAllowance valueAddedTax volume warehouse duty
amount
 string Fixed amount of allowance or charge
percent
 string Percentage of allowance or charge
percentBasis
 string Basis for calculating percentage
Values: basePrice basePricePerUnit discountGross
rate
 string Rate per unit at which the allowance or charge is calculated
quantity
 object Quantity of goods the allowance or charge applies to
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 hundredweight inch kilogram keg 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
methodOfHandling
 string How the charge is handled
Values: collect paidByVendor paidByCustomer prepaid billBack offInvoice creditCustomerAccount
description
 string Description of the allowance or charge
charges
 array Additional charges applied to the order
type
 string ✓ Type of allowance or charge
Values: advertising centralBuy competitiveAllowance cooperativeAdvertising customsBrokerFee customsEntry commission damagedMerchandiseAllowance defectiveAllowance coreCharge deposit discount displayAllowance earlyBuyAllowance forwardingCharge freeGoods freight fuelSurcharge handling iceCharge inboundFreight inlandTransportation labelAllowance latePaymentCharge networkAllowance newDistributionAllowance newStore newWarehouse other pallet pickup pickupAndDelivery priceDeviation promotionalAllowance quantityDiscount quantitySurcharge rebate refrigeration restocking royalty serviceAtPickupOrDelivery shipping shippingAndHandling specialAllowance specialBuy splitDelivery swell tax temperatureProtection tobaccoProductsReportCharge truckloadDiscount unloading unsaleableMerchandiseAllowance valueAddedTax volume warehouse duty
amount
 string Fixed amount of allowance or charge
percent
 string Percentage of allowance or charge
percentBasis
 string Basis for calculating percentage
Values: basePrice basePricePerUnit discountGross
rate
 string Rate per unit at which the allowance or charge is calculated
quantity
 object Quantity of goods the allowance or charge applies to
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 hundredweight inch kilogram keg 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
methodOfHandling
 string How the charge is handled
Values: collect paidByVendor paidByCustomer prepaid billBack offInvoice creditCustomerAccount
description
 string Description of the allowance or charge
monetaryAmounts
 object Monetary amounts for the order
net
 string Order total after allowances, charges and adjustments — the amount payable.
gross
 string Order total before allowances, charges and adjustments — the merchandise value summed across the lines.
taxes
 object Tax information for the order
countyTax
 object County-level tax information
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 — partner-internal accounting reference for this tax line
generalTaxInformation
 object General tax information when no specific tax type applies
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 — partner-internal accounting reference for this tax line
goodsAndServicesTax
 object Goods and services tax (GST) or value-added tax (VAT) information
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 — partner-internal accounting reference for this tax line
harmonizedSalesTax
 object Harmonized sales tax (HST) information
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 — partner-internal accounting reference for this tax line
preThresholdTax
 object Tax applied before a threshold amount
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 — partner-internal accounting reference for this tax line
postThresholdTax
 object Tax applied after a threshold amount
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 — partner-internal accounting reference for this tax line
stateProvincialTax
 object State or provincial sales tax (PST/QST) information
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 — partner-internal accounting reference for this tax line
stateProvincialTaxOnGoods
 object State or provincial tax on goods
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 — partner-internal accounting reference for this tax line
stateProvincialTaxOnServices
 object State or provincial tax on services
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 — partner-internal accounting reference for this tax line
localTax
 object Local tax information
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 — partner-internal accounting reference for this tax line
lineItems
 array ✓ Line items included in the purchase order
purchaseOrderLineId
 string Unique identifier for the line item within the purchase order. Usually a simple counter, this number should be kept consistent when referencing a specific line item on return documents.
quantity
 object Quantity ordered for this 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 hundredweight inch kilogram keg 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 price or cost for the item
unitPriceBasis
 string Basis on which the unit price is calculated
Values: advise beforeDiscount discount net noCharge perHundred perThousand perDozen perEach perFoot perGram perKilogram perTen perOunce perPound perTenThousand perUOM promotion retail standard suggestedRetail wholesale wholesalePerEach
additionalPricing
 array Additional pricing information such as list price or promotional pricing
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 retail standard suggestedRetail wholesale wholesalePerEach
quantityPerUnitPrice
 string Quantity per unit price
discountMultiplier
 string Discount multiplier factor applied to the unit price to derive the net cost (e.g., 0.57 means a 43% discount). The actual discount percent is 1 minus this value.
productIds
 object ✓ Product identification codes such as UPC, SKU, or vendor item number
buyerItemNumber
 string Buyer-assigned item number
vendorItemNumber
 string Vendor-assigned item number (EDIFACT LIN/PIA supplier's 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
priceLookupNumber
 string Price Look-Up (PLU) code used at point of sale, typically for loose or variable-weight retail goods
buyerItemIds
 array Additional buyer product identifiers
type
 string ✓ Type of product identifier
Values: catalog manufacturerPart sku style
value
 string ✓ Product identifier value
vendorItemIds
 array Additional vendor product identifiers
type
 string ✓ Type of product identifier
Values: catalog manufacturerPart sku style
value
 string ✓ Product identifier value
productAttributes
 object Product attributes such as color, size, and description
description
 string General product description. Sourced from X12 PID05 when PID02="08" (Product Description, general) or when PID02 is absent. In EDIFACT, sourced from EVERY IMD composite for this line item where itemDescriptionCode="SP" (Product) — there may be MULTIPLE matching IMD repetitions per line item, and ALL of them must be included. Within each matching IMD, concatenate itemDescription + itemDescription_1 (the continuation field) with a single space; then $join those per-IMD strings across ALL matching IMDs with a single space separator. Do NOT pick only the first matching IMD — partners commonly split a long description across multiple IMD segments because each itemDescription element is capped at 35 characters. The qualifier code "SP" (or X12 "08") is positional — it identifies which IMDs carry the product description, and must NOT be reported as a schema gap.
shortDescription
 string {"description":"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
prepackType
 string Prepack assortment or configuration type
widthClassification
 string Width classification for the product, such as a footwear width (e.g. "M", "W", "N"). Not a measurement — see width for the physical dimension.
materialCode
 string Material code identifier
materialDescription
 string Material description text
materialAttributes
 object
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 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
vehicleFitment
 object The vehicle the ordered part is an application for (automotive fitment)
vin
 string Vehicle Identification Number (VIN) of the specific vehicle the part fits
make
 string Vehicle manufacturer / make the part is an application for (e.g., Honda, Toyota)
model
 string Vehicle model the part is an application for (e.g., Civic, Camry)
equipmentDescription
 string Equipment/handling descriptor for the line (e.g. REFER = refrigerated). Partner override of X12 CG.
outerPack
 object Physical details for the outer packaging (case/carton level)
numberOfUnits
 string Number of units in the package
size
 string Size value of the package
sizeUOM
 string Unit of measure for size
Values: bag belt bottle box carton case cassette display each fluidOunce gram keg kilogram liter milliliter ounce packPAK package pair pound roll tote unit
packageForm
 string Form of the package
Values: bag bottle box can carton coil 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
totalUnits
 string Total count of individual selling units (eaches) in the outer container, summed across every item inside it — not a count of the inner packages themselves.
basebox
 string Billable quantity in baseboxes (tin plate industry unit: 112 sheets × 14"×20" = 31,360 sq in)
baseboxBasisWeight
 string Basis weight in pounds per base box — the standard steel mill weight specification unit
innerPack
 object Physical details for the inner packaging
numberOfUnits
 string Number of units in the package
size
 string Size value of the package
sizeUOM
 string Unit of measure for size
Values: bag belt bottle box carton case cassette display each fluidOunce gram keg kilogram liter milliliter ounce packPAK package pair pound roll tote unit
packageForm
 string Form of the package
Values: bag bottle box can carton coil 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
totalUnits
 string Total count of individual selling units (eaches) in the outer container, summed across every item inside it — not a count of the inner packages themselves.
basebox
 string Billable quantity in baseboxes (tin plate industry unit: 112 sheets × 14"×20" = 31,360 sq in)
baseboxBasisWeight
 string Basis weight in pounds per base box — the standard steel mill weight specification unit
packaging
 array Packaging and marking requirements
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 - how the shipment is physically arranged
Values: palletized floorStack mixed slipSheet module clampable bopSheet airbagSlipSheetCombo cargoQuilt shrinkWrap loadLock
serialShippingIds
 array of string GS1 Serial Shipping Container Codes (SSCC) the buyer pre-assigns to the shipping units ordered on this line, for the supplier to apply when packing them. An SSCC is an 18-digit globally unique code, serially assigned per logistics unit — not derived from the product UPC. An array because one code is pre-assigned per shipping unit ordered.
dates
 object Date requirements specific to this line item
cancelAfterDate
 string Date after which the order should be cancelled if not fulfilled
Formats: date date-time
customerOrderDate
 string Date when the customer originally placed the order
Formats: date date-time
earliestDeliveryDate
 string Earliest acceptable date for delivery
Formats: date date-time
estimatedDeliveryMonthOfDate
 string Month during which the goods are estimated to arrive. Only the month and year are meaningful — the day is set to the 1st of the month by convention.
Formats: date date-time
earliestShipDate
 string Earliest acceptable date for shipment
Formats: date date-time
latestShipDate
 string Latest acceptable date for shipment
Formats: date date-time
latestDeliveryDate
 string Latest acceptable date for delivery. Covers 063 ("Do Not Deliver After"), 106 ("Required By") and 074 ("Requested for Delivery (Prior to and Including)") — all three name the last acceptable delivery date, whether phrased as a prohibition or a request.
Formats: date date-time
pickupDate
 string Scheduled date for pickup
Formats: date date-time
promotionStartDate
 string Start date of the promotional period
Formats: date date-time
purchaseOrderDate
 string Date of the original purchase order, used on release orders
Formats: date date-time
requestedDeliveryDate
 string Requested date for delivery
Formats: date date-time
requestedShipDate
 string Date the buyer wants the goods shipped. Covers 010 ("Requested Ship") and 068 ("Current Schedule Ship") — on a purchase order both name a single point the buyer is asking the vendor to ship on; who arranged the freight is carried by the carrier details, not by this qualifier.
Formats: date date-time
requestedDeliveryWeekOfDate
 string Week during which delivery is requested
Formats: date date-time
revisionDate
 string Date of the most recent revision to the order, or the date of the initial version if never revised
Formats: date date-time
references
 object Reference numbers specific to this line item
contractNumber
 object Contract number for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
customerOrderLineNumber
 object Customer order line number for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
customerOrderNumber
 object Customer order number for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
reservationNumber
 object Reservation number for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
divisionId
 object Business division identifier for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
departmentNumber
 object Department number for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
merchandiseTypeCode
 object Merchandise classification code for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
pricingQuote
 object Pricing quote reference for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
promotionNumber
 object Promotional campaign identifier for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
storeNumber
 object Store location identifier for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
trackingNumber
 object Tracking number for this line item
value
 string The reference identifier value
description
 string Additional description or context for the reference
destinationQuantities
 object Quantity distribution across multiple destinations
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 celsius cell centigram centiliter centimeter coil combo cone container count cover display dozen drum each flakeTon foot gallon gram gramsPerLiter hundredweight inch kilogram keg 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
quantityByLocation
 array ✓ Quantity breakdown by destination
destinationId
 string ✓ Destination location identifier
quantity
 string ✓ Quantity for this destination
allowances
 array Allowances or discounts applied to this line item
type
 string ✓ Type of allowance or charge
Values: advertising centralBuy competitiveAllowance cooperativeAdvertising customsBrokerFee customsEntry commission damagedMerchandiseAllowance defectiveAllowance coreCharge deposit discount displayAllowance earlyBuyAllowance forwardingCharge freeGoods freight fuelSurcharge handling iceCharge inboundFreight inlandTransportation labelAllowance latePaymentCharge networkAllowance newDistributionAllowance newStore newWarehouse other pallet pickup pickupAndDelivery priceDeviation promotionalAllowance quantityDiscount quantitySurcharge rebate refrigeration restocking royalty serviceAtPickupOrDelivery shipping shippingAndHandling specialAllowance specialBuy splitDelivery swell tax temperatureProtection tobaccoProductsReportCharge truckloadDiscount unloading unsaleableMerchandiseAllowance valueAddedTax volume warehouse duty
amount
 string Fixed amount of allowance or charge
percent
 string Percentage of allowance or charge
percentBasis
 string Basis for calculating percentage
Values: basePrice basePricePerUnit discountGross
rate
 string Rate per unit at which the allowance or charge is calculated
quantity
 object Quantity of goods the allowance or charge applies to
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 hundredweight inch kilogram keg 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
methodOfHandling
 string How the charge is handled
Values: collect paidByVendor paidByCustomer prepaid billBack offInvoice creditCustomerAccount
description
 string Description of the allowance or charge
charges
 array Additional charges applied to this line item
type
 string ✓ Type of allowance or charge
Values: advertising centralBuy competitiveAllowance cooperativeAdvertising customsBrokerFee customsEntry commission damagedMerchandiseAllowance defectiveAllowance coreCharge deposit discount displayAllowance earlyBuyAllowance forwardingCharge freeGoods freight fuelSurcharge handling iceCharge inboundFreight inlandTransportation labelAllowance latePaymentCharge networkAllowance newDistributionAllowance newStore newWarehouse other pallet pickup pickupAndDelivery priceDeviation promotionalAllowance quantityDiscount quantitySurcharge rebate refrigeration restocking royalty serviceAtPickupOrDelivery shipping shippingAndHandling specialAllowance specialBuy splitDelivery swell tax temperatureProtection tobaccoProductsReportCharge truckloadDiscount unloading unsaleableMerchandiseAllowance valueAddedTax volume warehouse duty
amount
 string Fixed amount of allowance or charge
percent
 string Percentage of allowance or charge
percentBasis
 string Basis for calculating percentage
Values: basePrice basePricePerUnit discountGross
rate
 string Rate per unit at which the allowance or charge is calculated
quantity
 object Quantity of goods the allowance or charge applies to
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 hundredweight inch kilogram keg 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
methodOfHandling
 string How the charge is handled
Values: collect paidByVendor paidByCustomer prepaid billBack offInvoice creditCustomerAccount
description
 string Description of the allowance or charge
serviceRequirements
 array Value-added service requirements for this line — VICS garment prep carried in the SAC loop (SAC01=N), unified with the N9 label, hangtag, and packaging type specifications.
type
 string The value-added service or specification required for the item.
Values: hanger ticketing labelType hangtagType stringTagType specialPackaging
reference
 string Code identifying the required service — the ticketing code, or the label/hangtag/packaging type code.
description
 string Additional description for the service or type, such as the brand or label name.
monetaryAmounts
 object Monetary amounts for the line item
gross
 string Gross monetary amount for the line item
net
 string Net monetary amount for the line item
sublineItems
 array Subline items for component or kit details
sublineId
 string Subline item identifier
quantity
 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 celsius cell centigram centiliter centimeter coil combo cone container count cover display dozen drum each flakeTon foot gallon gram gramsPerLiter hundredweight inch kilogram keg 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 retail standard suggestedRetail wholesale wholesalePerEach
additionalPricing
 array Additional pricing for this component, such as a component-level retail price when the components of a kit or prepack are priced individually
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 retail standard suggestedRetail wholesale wholesalePerEach
quantityPerUnitPrice
 string Quantity per unit price
discountMultiplier
 string Discount multiplier factor applied to the unit price to derive the net cost (e.g., 0.57 means a 43% discount). The actual discount percent is 1 minus this value.
productIds
 object ✓ Product identifiers for the subline item
buyerItemNumber
 string Buyer-assigned item number
vendorItemNumber
 string Vendor-assigned item number (EDIFACT LIN/PIA supplier's 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
priceLookupNumber
 string Price Look-Up (PLU) code used at point of sale, typically for loose or variable-weight retail goods
buyerItemIds
 array Additional buyer product identifiers
type
 string ✓ Type of product identifier
Values: catalog manufacturerPart sku style
value
 string ✓ Product identifier value
vendorItemIds
 array Additional vendor product identifiers
type
 string ✓ Type of product identifier
Values: catalog manufacturerPart sku style
value
 string ✓ Product identifier value
productAttributes
 object Product attributes for the subline item
description
 string General product description. Sourced from X12 PID05 when PID02="08" (Product Description, general) or when PID02 is absent. In EDIFACT, sourced from EVERY IMD composite for this line item where itemDescriptionCode="SP" (Product) — there may be MULTIPLE matching IMD repetitions per line item, and ALL of them must be included. Within each matching IMD, concatenate itemDescription + itemDescription_1 (the continuation field) with a single space; then $join those per-IMD strings across ALL matching IMDs with a single space separator. Do NOT pick only the first matching IMD — partners commonly split a long description across multiple IMD segments because each itemDescription element is capped at 35 characters. The qualifier code "SP" (or X12 "08") is positional — it identifies which IMDs carry the product description, and must NOT be reported as a schema gap.
shortDescription
 string {"description":"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
prepackType
 string Prepack assortment or configuration type
widthClassification
 string Width classification for the product, such as a footwear width (e.g. "M", "W", "N"). Not a measurement — see width for the physical dimension.
materialCode
 string Material code identifier
materialDescription
 string Material description text
materialAttributes
 object
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 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
vehicleFitment
 object The vehicle the ordered part is an application for (automotive fitment)
vin
 string Vehicle Identification Number (VIN) of the specific vehicle the part fits
make
 string Vehicle manufacturer / make the part is an application for (e.g., Honda, Toyota)
model
 string Vehicle model the part is an application for (e.g., Civic, Camry)
lotNumber
 string Lot or batch number for the subline item
notes
 object Notes and instructions for this line item
general
 object Generic notes or standard legal agreements. Default for N9+L1 unless the guideline note or a different qualifier points elsewhere — pick the best-fitting field.
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
orderInstructions
 object Special instructions for processing the order. Default for CTB02 when CTB01=OR. MSG/MTX free-form text (segments named messageText/text in the input JSON) may also route here when the guideline note indicates order instructions — pick the best-fitting field.
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
shippingInstructions
 object Special instructions for shipping the order. Default for CTB02 when CTB01=SR. MSG/MTX free-form text (segments named messageText/text in the input JSON) may also route here when the guideline note indicates shipping instructions — pick the best-fitting field.
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
paymentInstructions
 object Payment-related notes or instructions (e.g., VAT split-payment marker text)
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
giftMessage
 object Message for the recipient, typically used in gift or dropship orders
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
packingSlipMessage
 object Message to be printed on the packing slip
description
 string Brief description or title of the note
text
 array of string Array of text lines for the note content
paperwork
 array Paperwork requirements for this line item
reportType
 string Type of report or document required
Values: purchasingSpecification storageInquiry technicalInformation billOfLading orderAttachment materialDataSheet materialCertification
reportTransmissionType
 string Method by which the report should be transmitted
Values: withShipmentPackage
copiesNeeded
 integer Number of copies of the document required
isoLanguageCode
 string ISO language code for the document
url
 string URL where the document can be accessed
action
 string Action to be taken with the paperwork
Values: generate
description
 string Description or additional details about the paperwork
conditionsAndRestrictions
 array Conditions and restrictions for this line item
conditionType
 string Type of order condition or restriction
Values: backorderAllowed substitutionsAllowed doNotSubstitute doNotBackorder shipComplete shipPartialCancelBalance shipPartialProportional 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
percent
 string Percentage qualifying the condition — for a partial-shipment condition, the proportion of the ordered quantity that may ship
carrierDetails
 object Carrier and shipping details for this line item
routing
 array Carrier routing information for this line item
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. EDIFACT: prefer C001.8179 (transportMeansDescriptionCode) — its means/vessel-level codes match this enum directly. Fall back to C220.8067 (transportModeNameCode) ONLY when 8179 is absent; 8067 carries broad-mode codes only (1=Maritime, 2=Rail, 3=Road, 4=Air, 5=Mail, 6=Multimodal, 7=Fixed installation, 8=Inland water) which map loosely: 1→ocean, 2→rail, 3→supplierTruck, 4→air. Granular enum values (airExpress, oceanContainerized, trailer, etc.) cannot be recovered from 8067 — emit a SCHEMA GAP if neither path carries the partner value.
Values: air airExpress airFreightForward backhaul bestWay commonCarrier consolidation customerPickup expeditedTruck lessThanTrailerLoad mail ocean oceanContainerized parcelPost privateCarrier rail shipperAgent supplierTruck trailer 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 nextDaySaturday overnight poBoxZipCode priorityMail priorityMailInsured proofOfDelivery sameDay saturdayService secondDay secondDayHundredWeight secondDayAir secondDaySaturday 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
freeOnBoard
 array FOB (Free on Board) terms for this line item
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 foreignFreightForwarder onVessel mutuallyDefined
locationDescription
 string Description of FOB location
titlePassageType
 string Type of title passage location
Values: cityAndState country destination origin stateProvince warehouse foreignFreightForwarder
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 freeOnTruck nonPrivilegedForeign privilegedForeign mutuallyDefined
riskOfLoss
 string Risk of loss transfer point
Values: toDestinationBuyer toFreightEqPointSeller toPoolPointSeller toDestinationSeller mutuallyDefined
description
 string Additional FOB description
taxes
 object Tax information for the line item
countyTax
 object County-level tax information
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 — partner-internal accounting reference for this tax line
generalTaxInformation
 object General tax information when no specific tax type applies
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 — partner-internal accounting reference for this tax line
goodsAndServicesTax
 object Goods and services tax (GST) or value-added tax (VAT) information
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 — partner-internal accounting reference for this tax line
harmonizedSalesTax
 object Harmonized sales tax (HST) information
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 — partner-internal accounting reference for this tax line
preThresholdTax
 object Tax applied before a threshold amount
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 — partner-internal accounting reference for this tax line
postThresholdTax
 object Tax applied after a threshold amount
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 — partner-internal accounting reference for this tax line
stateProvincialTax
 object State or provincial sales tax (PST/QST) information
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 — partner-internal accounting reference for this tax line
stateProvincialTaxOnGoods
 object State or provincial tax on goods
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 — partner-internal accounting reference for this tax line
stateProvincialTaxOnServices
 object State or provincial tax on services
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 — partner-internal accounting reference for this tax line
localTax
 object Local tax information
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 — partner-internal accounting reference for this tax line
parties
 object Parties specific to this line item
soldTo
 object Sold-to party for this line item — the entity the goods on this line are sold to. Used when the sold-to differs line by line, for example a drop-ship order that names a different end customer on each line.
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 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
deliveryPoint
 string Specific delivery point within this location, such as a dock, door or bay, identifying where goods should be presented on arrival
contacts
 array Contact persons for this party
type
 string ✓ Type of contact — the role this person or office serves for the party they belong to
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. "Fax #", "Email"), follow the note and route accordingly.
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.
contactReference
 string Reference that clarifies the contact — e.g. an organizational unit, department/role, or partner-assigned code 
{
  "type": "850_PURCHASE_ORDER",
  "stream": "test",
  "senderId": "BUYERISA",
  "receiverId": "SELLERISA",
  "message": {
    "purpose": "original",
    "purchaseOrderType": "standalone",
    "purchaseOrderNumber": "PO5786344061670677",
    "purchaseOrderDate": "2026-02-12",
    "releaseNumber": "004010",
    "conditionsAndRestrictions": [
      {
        "conditionType": "doNotBackorder"
      }
    ],
    "parties": {
      "buyer": {
        "name": "Retail Integration Testing",
        "identificationCode": "5438",
        "identificationCodeType": "sendersId"
      },
      "shipTo": {
        "name": "Retail Integration Testing",
        "identificationCode": "5438",
        "identificationCodeType": "sendersId",
        "addressLine1": "4055 MAIN ST",
        "city": "NEW YORK",
        "stateOrProvinceCode": "NY",
        "postalCode": "10001",
        "countryCode": "US"
      },
      "billTo": {
        "name": "Retail Integration Testing",
        "identificationCode": "5438",
        "identificationCodeType": "sendersId",
        "addressLine1": "4055 MAIN ST",
        "city": "NEW YORK",
        "stateOrProvinceCode": "NY",
        "postalCode": "10001",
        "countryCode": "US"
      }
    },
    "termsOfSale": {
      "type": "basic",
      "basisDate": "deliveryDate",
      "discountPercent": "1",
      "discountDaysDue": 45,
      "description": "Net 45 Days"
    },
    "references": {
      "vendorNumber": {
        "value": "4875905"
      },
      "departmentNumber": {
        "value": "011"
      }
    },
    "dates": {
      "earliestShipDate": "2026-02-17",
      "latestShipDate": "2026-02-22"
    },
    "carrierDetails": {
      "routing": [
        {
          "description": "2"
        }
      ],
      "freeOnBoard": [
        {
          "methodOfPayment": "mutuallyAgreed"
        }
      ]
    },
    "allowances": [
      {
        "type": "discount",
        "amount": "196.2475",
        "description": "Discount"
      }
    ],
    "charges": [
      {
        "type": "freight",
        "amount": "784.99",
        "description": "Freight Charge"
      }
    ],
    "lineItems": [
      {
        "purchaseOrderLineId": "1",
        "quantity": {
          "value": "5",
          "unitOfMeasure": "each"
        },
        "unitCostPrice": "101.00",
        "productIds": {
          "buyerItemNumber": "10000002",
          "gtin12": "002837465832",
          "caseCode": "002837465832"
        },
        "productAttributes": {
          "description": "Green toothpaste"
        },
        "outerPack": {
          "numberOfUnits": "10"
        },
        "innerPack": {
          "numberOfUnits": "10"
        }
      },
      {
        "purchaseOrderLineId": "2",
        "quantity": {
          "value": "20",
          "unitOfMeasure": "each"
        },
        "unitCostPrice": "88.00",
        "productIds": {
          "buyerItemNumber": "10000004",
          "gtin12": "002837465837",
          "caseCode": "002837465837"
        },
        "productAttributes": {
          "description": "Orange toothpaste"
        },
        "outerPack": {
          "numberOfUnits": "8"
        },
        "innerPack": {
          "numberOfUnits": "8"
        }
      },
      {
        "purchaseOrderLineId": "3",
        "quantity": {
          "value": "5",
          "unitOfMeasure": "each"
        },
        "unitCostPrice": "112.00",
        "productIds": {
          "buyerItemNumber": "10000003",
          "gtin12": "002837465836",
          "caseCode": "002837465836"
        },
        "productAttributes": {
          "description": "Purple toothpaste"
        },
        "outerPack": {
          "numberOfUnits": "12"
        },
        "innerPack": {
          "numberOfUnits": "12"
        }
      },
      {
        "purchaseOrderLineId": "4",
        "quantity": {
          "value": "10",
          "unitOfMeasure": "each"
        },
        "unitCostPrice": "100.00",
        "productIds": {
          "buyerItemNumber": "10000001",
          "gtin12": "002837465831",
          "caseCode": "002837465831"
        },
        "productAttributes": {
          "description": "Yellow toothpaste"
        },
        "outerPack": {
          "numberOfUnits": "10"
        },
        "innerPack": {
          "numberOfUnits": "10"
        }
      },
      {
        "purchaseOrderLineId": "5",
        "quantity": {
          "value": "5",
          "unitOfMeasure": "each"
        },
        "unitCostPrice": "19.99",
        "productIds": {
          "buyerItemNumber": "ORDERFUL-TEST-SKU-005",
          "gtin12": "012345678005",
          "caseCode": "012345678005"
        },
        "productAttributes": {
          "description": "Placeholder product for scenario testing"
        },
        "outerPack": {
          "numberOfUnits": "1"
        },
        "innerPack": {
          "numberOfUnits": "1"
        }
      }
    ]
  }
}
File Description Download
sample.json Sample JSON payload Download
schema.json JSON Schema for validation Download

Updated about 19 hours ago

Did this page help you?

Updated about 19 hours ago

Did this page help you?