Purchase Order Acknowledgment (855)

An 855 Purchase Order Acknowledgment can be used either to simply acknowledge a buyer's purchase order, or it can be used as a notification that the vendor has generated an order on their end.

Purchase Order Acknowledgment Example Transaction

{
  "purchaseOrderNumber": "PO-2024-005678",
  "status": "accepted",
  "statusNote": {
    "description": "Order acknowledged and will be processed",
    "text": [
      "All items are in stock and ready to ship",
      "Expected to ship within 2 business days"
    ]
  },
  "dates": {
    "scheduledShipDate": "2024-03-18",
    "estimatedDeliveryDate": "2024-03-22",
    "requestedPickupDate": "2024-03-18"
  },
  "parties": {
    "supplier": {
      "name": "Vendor Corp",
      "additionalName1": "Vendor Distribution",
      "additionalName2": "Main Warehouse",
      "identificationCode": "VEND-12345",
      "identificationCodeType": "duns",
      "addressLine1": "5678 Corporate Drive",
      "addressLine2": "Building B",
      "addressLine3": "Suite 200",
      "addressLine4": "Distribution Center",
      "city": "Chicago",
      "stateOrProvinceCode": "IL",
      "postalCode": "60601",
      "countryCode": "US",
      "zoneType": "commercial",
      "contacts": [
        {
          "type": "primary",
          "name": "John Smith",
          "phoneNumber": "312-555-0100",
          "faxNumber": "312-555-0101",
          "email": "[email protected]"
        },
        {
          "type": "orderInquiry",
          "name": "Order Desk",
          "phoneNumber": "312-555-0200",
          "email": "[email protected]"
        },
        {
          "type": "shipping",
          "name": "Shipping Department",
          "phoneNumber": "312-555-0300",
          "email": "[email protected]"
        }
      ]
    },
    "shipFrom": {
      "name": "Vendor Distribution Center",
      "identificationCode": "VDC-001",
      "identificationCodeType": "warehouse",
      "addressLine1": "1234 Warehouse Blvd",
      "addressLine2": "Building A",
      "city": "Atlanta",
      "stateOrProvinceCode": "GA",
      "postalCode": "30309",
      "countryCode": "US",
      "zoneType": "commercial",
      "contacts": [
        {
          "type": "shipping",
          "name": "Warehouse Manager",
          "phoneNumber": "404-555-0100",
          "email": "[email protected]"
        }
      ]
    }
  },
  "termsOfSale": {
    "type": "basic",
    "netDaysDue": 30,
    "netDueDate": "2024-04-21",
    "basisDate": "invoiceDate",
    "discountPercent": "2",
    "discountDaysDue": 10,
    "discountDueDate": "2024-03-28",
    "discountAmount": "10.00",
    "description": "Net 30, 2% discount if paid within 10 days",
    "paymentMethodType": "check"
  },
  "lineItems": [
    {
      "purchaseOrderLineId": "001",
      "productIds": {
        "buyerItemNumber": "Z0003800",
        "vendorItemNumber": "DVB-140",
        "gtin14": "10012345678905"
      },
      "productAttributes": {
        "description": "140 capacity DVD Album",
        "colorCode": "BLK",
        "colorDescription": "Black",
        "sizeCode": "140",
        "sizeDescription": "140 capacity",
        "materialCode": "PLASTIC",
        "materialDescription": "Plastic",
        "height": "11",
        "width": "9"
      },
      "actions": [
        {
          "status": "accepted",
          "quantity": {
            "value": "10",
            "unitOfMeasure": "each"
          },
          "scheduledShipDate": "2024-03-18",
          "estimatedDeliveryDate": "2024-03-22",
          "unitCostPrice": "21.75",
          "statusNote": {
            "description": "Item accepted and in stock",
            "text": [
              "Ready to ship",
              "Standard packaging"
            ]
          }
        }
      ]
    },
    {
      "purchaseOrderLineId": "002",
      "productIds": {
        "buyerItemNumber": "Z0003801",
        "vendorItemNumber": "DVB-120",
        "gtin13": "1234567890123"
      },
      "productAttributes": {
        "description": "120 capacity DVD Album",
        "colorCode": "BLU",
        "colorDescription": "Blue"
      },
      "actions": [
        {
          "status": "accepted",
          "quantity": {
            "value": "3",
            "unitOfMeasure": "each"
          },
          "scheduledShipDate": "2024-03-18",
          "estimatedDeliveryDate": "2024-03-22",
          "unitCostPrice": "15.50",
          "statusNote": {
            "description": "Partial quantity accepted"
          }
        },
        {
          "status": "backordered",
          "statusReasonCode": "outOfStock",
          "quantity": {
            "value": "2",
            "unitOfMeasure": "each"
          },
          "scheduledShipDate": "2024-03-25",
          "estimatedDeliveryDate": "2024-03-29",
          "statusNote": {
            "description": "Item temporarily out of stock",
            "text": [
              "Expected restock date: 2024-03-24",
              "Will ship immediately upon restock"
            ]
          }
        }
      ]
    },
    {
      "purchaseOrderLineId": "003",
      "productIds": {
        "buyerItemNumber": "Z0003802",
        "vendorItemNumber": "CDB-200",
        "gtin12": "123456789012"
      },
      "productAttributes": {
        "description": "200 capacity CD Binder",
        "colorCode": "RED",
        "colorDescription": "Red"
      },
      "actions": [
        {
          "status": "accepted",
          "quantity": {
            "value": "5",
            "unitOfMeasure": "each"
          },
          "scheduledShipDate": "2024-03-18",
          "estimatedDeliveryDate": "2024-03-22",
          "unitCostPrice": "32.00",
          "substitutedItem": {
            "productIds": {
              "buyerItemNumber": "Z0003802-ALT",
              "vendorItemNumber": "CDB-200-ALT",
              "gtin14": "10012345678919"
            }
          },
          "statusNote": {
            "description": "Item substituted with equivalent product",
            "text": [
              "Original item discontinued",
              "Substitute item has same specifications"
            ]
          }
        }
      ]
    },
    {
      "purchaseOrderLineId": "004",
      "productIds": {
        "vendorItemNumber": "USB-500",
        "gtin13": "1234567890123"
      },
      "productAttributes": {
        "description": "500GB USB Flash Drive"
      },
      "actions": [
        {
          "status": "rejected",
          "statusReasonCode": "discontinued",
          "quantity": {
            "value": "2",
            "unitOfMeasure": "each"
          },
          "statusNote": {
            "description": "Item has been discontinued",
            "text": [
              "Product no longer available",
              "Please select alternative product"
            ]
          }
        }
      ]
    },
    {
      "purchaseOrderLineId": "005",
      "productIds": {
        "buyerItemNumber": "Z0003803",
        "vendorItemNumber": "CASE-001",
        "buyerItemIds": [
          {
            "type": "sku",
            "value": "SKU-12345"
          },
          {
            "type": "catalog",
            "value": "CAT-67890"
          }
        ],
        "vendorItemIds": [
          {
            "type": "manufacturerPart",
            "value": "MP-11111"
          }
        ]
      },
      "productAttributes": {
        "description": "Storage Case",
        "materialCode": "METAL",
        "materialDescription": "Metal",
        "processCode": "WELD",
        "processDescription": "Welded construction"
      },
      "actions": [
        {
          "status": "accepted",
          "quantity": {
            "value": "1",
            "unitOfMeasure": "case"
          },
          "scheduledShipDate": "2024-03-19",
          "estimatedDeliveryDate": "2024-03-23",
          "unitCostPrice": "45.99"
        }
      ]
    }
  ]
}