This page contains an example 850 Purchase Order
Use the payload below as the "message" when posting a test payload to the API or via the "upload" button on the UI.
Purchase Order Example Transaction
{
"purpose": "original",
"purchaseOrderType": "standalone",
"purchaseOrderNumber": "PO-2024-001234",
"purchaseOrderDate": "2024-01-15",
"releaseNumber": "REL-001",
"contractNumber": "CNT-2024-ABC",
"acknowledgmentType": "withDetail",
"conditionsAndRestrictions": [
{
"conditionType": "shipComplete",
"action": "confirm",
"services": "twoDayService",
"maxOrderValue": "50000.00"
}
],
"parties": {
"buyer": {
"name": "Acme Corporation",
"additionalName1": "Procurement Department",
"identificationCode": "123456789",
"identificationCodeType": "duns",
"addressLine1": "123 Main Street",
"addressLine2": "Suite 500",
"city": "Chicago",
"stateOrProvinceCode": "IL",
"postalCode": "60601",
"countryCode": "US",
"zoneType": "commercial",
"contacts": [
{
"type": "primary",
"name": "John Smith",
"phoneNumber": "312-555-0100",
"email": "[email protected]"
},
{
"type": "orderInquiry",
"name": "Order Desk",
"phoneNumber": "312-555-0200",
"email": "[email protected]"
}
]
},
"shipTo": {
"name": "Acme Corporation - Warehouse",
"identificationCode": "987654321",
"identificationCodeType": "duns",
"addressLine1": "456 Warehouse Boulevard",
"city": "Elk Grove Village",
"stateOrProvinceCode": "IL",
"postalCode": "60007",
"countryCode": "US",
"zoneType": "commercial",
"contacts": [
{
"type": "receiving",
"name": "Receiving Department",
"phoneNumber": "847-555-0300"
}
]
},
"billTo": {
"name": "Acme Corporation",
"identificationCode": "123456789",
"identificationCodeType": "duns",
"addressLine1": "123 Main Street",
"addressLine2": "Accounts Payable",
"city": "Chicago",
"stateOrProvinceCode": "IL",
"postalCode": "60601",
"countryCode": "US"
},
"shipFrom": {
"name": "Global Suppliers Inc.",
"identificationCode": "555123456",
"identificationCodeType": "duns",
"addressLine1": "789 Manufacturing Drive",
"city": "Dallas",
"stateOrProvinceCode": "TX",
"postalCode": "75201",
"countryCode": "US"
},
"accountsPayable": {
"name": "Acme Corporation - AP",
"addressLine1": "123 Main Street",
"addressLine2": "Finance Department",
"city": "Chicago",
"stateOrProvinceCode": "IL",
"postalCode": "60601",
"countryCode": "US"
},
"soldTo": {
"name": "Acme Corporation",
"identificationCode": "123456789",
"identificationCodeType": "duns",
"addressLine1": "123 Main Street",
"city": "Chicago",
"stateOrProvinceCode": "IL",
"postalCode": "60601",
"countryCode": "US"
},
"supplier": {
"name": "Global Suppliers Inc.",
"additionalName1": "Sales Division",
"identificationCode": "555123456",
"identificationCodeType": "duns",
"addressLine1": "789 Manufacturing Drive",
"city": "Dallas",
"stateOrProvinceCode": "TX",
"postalCode": "75201",
"countryCode": "US",
"zoneType": "commercial",
"contacts": [
{
"type": "primary",
"name": "Sarah Johnson",
"phoneNumber": "214-555-0400",
"email": "[email protected]"
}
]
}
},
"buyersCurrency": {
"currencyCode": "USD",
"exchangeRate": "1.00"
},
"sellersCurrency": {
"currencyCode": "USD",
"exchangeRate": "1.00"
},
"notes": {
"general": {
"description": "General order notes",
"text": [
"Please ensure all items are properly packaged",
"Include packing slip with shipment"
]
},
"orderInstructions": {
"description": "Order specific instructions",
"text": [
"All items must be shipped together",
"Use standard carrier for delivery"
]
},
"shippingInstructions": {
"description": "Shipping instructions",
"text": [
"Deliver during business hours only",
"Contact receiving department 24 hours before delivery"
]
}
},
"paperwork": [
{
"reportType": "materialDataSheet",
"reportTransmissionType": "withShipmentPackage",
"copiesNeeded": 2,
"isoLanguageCode": "en",
"description": "Material safety data sheets required"
},
{
"reportType": "technicalInformation",
"url": "https://example.com/tech-specs",
"description": "Technical specifications available online"
}
],
"packaging": [
{
"characteristicType": "palletType",
"description": "Standard 48x40 pallets required",
"unitLoadOption": "palletized"
},
{
"characteristicType": "shippingPackageLabeling",
"description": "Include PO number on all labels",
"agencyType": "uniformCodeCouncil"
}
],
"termsOfSale": {
"type": "basicDiscountOffered",
"basisDate": "invoiceDate",
"discountPercent": "2.0",
"discountDaysDue": 10,
"discountDueDate": "2024-02-25",
"netDaysDue": 30,
"netDueDate": "2024-02-15",
"discountAmount": "200.00",
"description": "2/10 Net 30 payment terms",
"paymentMethodType": "check"
},
"references": {
"accountNumber": {
"value": "ACC-12345",
"description": "Buyer account number"
},
"customerOrderNumber": {
"value": "CUST-ORD-789",
"description": "Customer order reference"
},
"vendorNumber": {
"value": "VND-456",
"description": "Vendor number"
},
"departmentNumber": {
"value": "DEPT-10",
"description": "Department code"
},
"storeNumber": {
"value": "STORE-001",
"description": "Store location"
},
"promotionNumber": {
"value": "PROMO-2024-Q1",
"description": "Promotion identifier"
}
},
"dates": {
"purchaseOrderDate": "2024-01-15",
"requestedShipDate": "2024-02-01",
"requestedDeliveryDate": "2024-02-05",
"earliestShipDate": "2024-01-28",
"latestShipDate": "2024-02-05",
"earliestDeliveryDate": "2024-02-01",
"latestDeliveryDate": "2024-02-10",
"cancelAfterDate": "2024-02-15",
"customerOrderDate": "2024-01-10"
},
"carrierDetails": {
"routing": [
{
"sequenceType": "origin",
"standardCarrierAlphaCode": "FEDX",
"transportationMethod": "commonCarrier",
"locationType": "origin",
"location": "Dallas, TX",
"serviceLevel": "ground",
"transitDirectionType": "sellerToBuyer",
"transitTimeType": "workingDays",
"transitTime": "3"
}
],
"freeOnBoard": [
{
"methodOfPayment": "prepaidBySeller",
"locationType": "origin",
"locationDescription": "Dallas, TX",
"titlePassageType": "origin",
"titlePassageDescription": "Dallas, TX",
"transportationTermsSource": "tradeTerms",
"transportationTerms": "freeOnBoard",
"riskOfLoss": "toDestinationBuyer"
}
],
"specialHandling": [
{
"handlingType": "fragile",
"description": "Handle with care"
},
{
"handlingType": "temperatureControl",
"description": "Maintain temperature between 60-70°F"
}
]
},
"allowances": [
{
"type": "volume",
"amount": "500.00",
"percent": "5.0",
"percentBasis": "basePrice",
"methodOfHandling": "paidByVendor",
"description": "Volume discount for orders over $10,000"
}
],
"charges": [
{
"type": "freight",
"amount": "250.00",
"methodOfHandling": "prepaid",
"description": "Prepaid freight charges"
}
],
"monetaryAmounts": {
"gross": "10500.00",
"net": "10000.00"
},
"taxes": {
"stateProvincialTax": {
"amount": "650.00",
"percent": "6.5",
"jurisdictionType": "state",
"jurisdictionCode": "IL"
},
"localTax": {
"amount": "100.00",
"percent": "1.0",
"jurisdictionType": "local",
"jurisdictionCode": "CHI"
}
},
"lineItems": [
{
"purchaseOrderLineId": "1",
"quantity": {
"value": "100",
"unitOfMeasure": "each"
},
"unitCostPrice": "45.00",
"unitPriceBasis": "perEach",
"additionalPricing": [
{
"priceType": "promotional",
"unitPrice": "42.00",
"unitPriceBasis": "perEach",
"quantityPerUnitPrice": "1"
}
],
"productIds": {
"buyerItemNumber": "ACME-12345",
"vendorItemNumber": "GSI-78901",
"gtin13": "1234567890123",
"buyerItemIds": [
{
"type": "sku",
"value": "SKU-ACME-12345"
}
]
},
"productAttributes": {
"description": "Premium Widget - Blue",
"colorCode": "BLU",
"colorDescription": "Blue",
"sizeCode": "LG",
"sizeDescription": "Large",
"materialCode": "STEEL",
"materialDescription": "Stainless Steel"
},
"outerPack": {
"numberOfUnits": "10",
"size": "12",
"sizeUOM": "each",
"packageForm": "box",
"packageMaterial": "corrugated",
"weightUOM": "pound",
"grossWeight": "50",
"netWeight": "45",
"dimensionUOM": "inch",
"length": "24",
"width": "18",
"height": "12",
"packageId": "PKG-001"
},
"innerPack": {
"numberOfUnits": "1",
"size": "1",
"sizeUOM": "each",
"packageForm": "box",
"packageMaterial": "corrugated",
"weightUOM": "pound",
"grossWeight": "5",
"netWeight": "4.5"
},
"packaging": [
{
"characteristicType": "typeOfPackage",
"description": "Corrugated cardboard box",
"unitLoadOption": "palletized"
}
],
"dates": {
"requestedShipDate": "2024-02-01",
"requestedDeliveryDate": "2024-02-05",
"earliestShipDate": "2024-01-28"
},
"references": {
"departmentNumber": {
"value": "DEPT-10",
"description": "Department"
},
"storeNumber": {
"value": "STORE-001",
"description": "Store location"
}
},
"destinationQuantities": {
"locationType": "warehouse",
"unitOfMeasure": "each",
"quantityByLocation": [
{
"destinationId": "WH-001",
"quantity": "60"
},
{
"destinationId": "WH-002",
"quantity": "40"
}
]
},
"allowances": [
{
"type": "quantityDiscount",
"amount": "50.00",
"percent": "1.0",
"methodOfHandling": "paidByVendor",
"description": "Quantity discount for 100+ units"
}
],
"charges": [
{
"type": "handling",
"amount": "25.00",
"methodOfHandling": "prepaid",
"description": "Special handling charge"
}
],
"monetaryAmounts": {
"gross": "4500.00",
"net": "4450.00"
},
"sublineItems": [
{
"sublineId": "1-1",
"quantity": {
"value": "50",
"unitOfMeasure": "each"
},
"productIds": {
"buyerItemNumber": "ACME-12345-A",
"vendorItemNumber": "GSI-78901-A"
},
"unitCostPrice": "45.00",
"unitPriceBasis": "perEach"
}
],
"notes": {
"general": {
"description": "Line item notes",
"text": [
"Ensure proper packaging",
"Include installation instructions"
]
},
"shippingInstructions": {
"description": "Shipping notes",
"text": [
"Ship in original packaging",
"Do not stack more than 5 high"
]
}
},
"paperwork": [
{
"reportType": "materialDataSheet",
"copiesNeeded": 1,
"description": "MSDS required for this item"
}
],
"conditionsAndRestrictions": [
{
"conditionType": "shipComplete",
"action": "confirm"
}
],
"carrierDetails": {
"routing": [
{
"sequenceType": "origin",
"transportationMethod": "commonCarrier",
"serviceLevel": "ground"
}
],
"freeOnBoard": [
{
"methodOfPayment": "prepaidBySeller",
"locationType": "origin"
}
]
}
},
{
"purchaseOrderLineId": "2",
"quantity": {
"value": "250",
"unitOfMeasure": "case"
},
"unitCostPrice": "18.50",
"unitPriceBasis": "perEach",
"productIds": {
"buyerItemNumber": "ACME-67890",
"vendorItemNumber": "GSI-23456",
"gtin14": "12345678901234"
},
"productAttributes": {
"description": "Standard Widget - Red",
"colorCode": "RED",
"colorDescription": "Red",
"sizeCode": "MD",
"sizeDescription": "Medium"
},
"outerPack": {
"numberOfUnits": "25",
"size": "1",
"sizeUOM": "case",
"packageForm": "box",
"packageMaterial": "corrugated",
"weightUOM": "pound",
"grossWeight": "30",
"netWeight": "28"
},
"dates": {
"requestedShipDate": "2024-02-01",
"requestedDeliveryDate": "2024-02-05"
},
"monetaryAmounts": {
"gross": "4625.00",
"net": "4625.00"
},
"notes": {
"general": {
"description": "Standard item",
"text": [
"Standard packaging acceptable"
]
}
}
},
{
"purchaseOrderLineId": "3",
"quantity": {
"value": "50",
"unitOfMeasure": "each"
},
"unitCostPrice": "17.50",
"productIds": {
"buyerItemNumber": "ACME-11111",
"vendorItemNumber": "GSI-33333",
"gtin12": "123456789012"
},
"monetaryAmounts": {
"gross": "875.00",
"net": "875.00"
}
}
]
}