Us Foods Order Structure

{
  "title": "US Foods Order Structure",
  "description": "Documentation of the data structure for foodservice orders in US Foods ordering and integration systems",
  "type": "object",
  "fields": [
    {
      "name": "orderId",
      "type": "string",
      "required": true,
      "description": "Unique order identifier assigned by US Foods systems",
      "example": "USF-2026-000123456"
    },
    {
      "name": "customerId",
      "type": "string",
      "required": true,
      "description": "US Foods customer account number (6-7 digit account)",
      "example": "1234567"
    },
    {
      "name": "orderDate",
      "type": "string",
      "format": "date-time",
      "required": true,
      "description": "ISO 8601 timestamp when the order was placed",
      "example": "2026-04-28T14:30:00Z"
    },
    {
      "name": "deliveryDate",
      "type": "string",
      "format": "date",
      "required": false,
      "description": "Expected delivery date based on customer's delivery schedule",
      "example": "2026-04-30"
    },
    {
      "name": "status",
      "type": "string",
      "required": true,
      "description": "Current order lifecycle status",
      "values": ["draft", "submitted", "confirmed", "picking", "loaded", "in-transit", "delivered", "invoiced", "cancelled"]
    },
    {
      "name": "distributionCenter",
      "type": "string",
      "required": false,
      "description": "Name or code of the US Foods distribution center fulfilling the order",
      "example": "Chicago DC"
    },
    {
      "name": "items",
      "type": "array",
      "required": true,
      "description": "Array of product line items",
      "itemStructure": {
        "lineNumber": "Integer line number within the order",
        "itemNumber": "US Foods product item number (required)",
        "description": "Product description",
        "brand": "Product brand",
        "packSize": "Pack size specification",
        "quantityOrdered": "Number of cases ordered",
        "unitPrice": "Price per case",
        "extendedPrice": "Total line item price",
        "isSubstitute": "Whether item was substituted"
      }
    },
    {
      "name": "purchaseOrderNumber",
      "type": "string",
      "required": false,
      "description": "Customer's internal PO number for EDI and accounting reconciliation",
      "example": "PO-2026-04-001"
    },
    {
      "name": "notes",
      "type": "string",
      "required": false,
      "description": "Special delivery instructions, substitution preferences, or order notes",
      "example": "Please deliver to back dock, ring bell"
    }
  ],
  "integration_notes": {
    "edi_transactions": {
      "850": "Purchase Order - initial order placement",
      "855": "Purchase Order Acknowledgment - order confirmation",
      "856": "Advance Ship Notice - dispatch notification",
      "810": "Invoice - billing document"
    },
    "gdsn_sync": "Product information (ingredients, allergens, nutrition facts, images) synchronized via GS1 GDSN through a data pool"
  }
}