Ace Hardware · Schema

AceHardwareEdiPurchaseOrder

An Ace Hardware EDI 850 Purchase Order representing a vendor purchase order from Ace Hardware's distribution system.

RetailHardwareHome ImprovementToolsPaintCooperativeEDIAffiliate

Properties

Name	Type	Description
poNumber	string	Purchase order number assigned by Ace Hardware
orderDate	string	Date the purchase order was created
shipByDate	string	Required ship-by date for the order
vendorId	string	Ace Hardware vendor identifier
vendorName	string	Name of the vendor fulfilling the order
shipToAddress	object	Destination distribution center or store address
lineItems	array	List of products ordered
totalAmount	number	Total order value in USD
currency	string	Currency code

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ace-hardware/refs/heads/main/json-schema/ace-hardware-edi-purchase-order-schema.json",
  "title": "AceHardwareEdiPurchaseOrder",
  "description": "An Ace Hardware EDI 850 Purchase Order representing a vendor purchase order from Ace Hardware's distribution system.",
  "type": "object",
  "properties": {
    "poNumber": {
      "type": "string",
      "description": "Purchase order number assigned by Ace Hardware",
      "example": "PO-2026-001234"
    },
    "orderDate": {
      "type": "string",
      "format": "date",
      "description": "Date the purchase order was created",
      "example": "2026-04-19"
    },
    "shipByDate": {
      "type": "string",
      "format": "date",
      "description": "Required ship-by date for the order",
      "example": "2026-04-30"
    },
    "vendorId": {
      "type": "string",
      "description": "Ace Hardware vendor identifier",
      "example": "VND-00987"
    },
    "vendorName": {
      "type": "string",
      "description": "Name of the vendor fulfilling the order",
      "example": "Hardware Supplier Corp."
    },
    "shipToAddress": {
      "type": "object",
      "description": "Destination distribution center or store address",
      "properties": {
        "name": {"type": "string", "example": "Ace Hardware DC - Chicago"},
        "address1": {"type": "string", "example": "1000 Distribution Way"},
        "city": {"type": "string", "example": "Chicago"},
        "state": {"type": "string", "example": "IL"},
        "zip": {"type": "string", "example": "60601"},
        "country": {"type": "string", "example": "US"}
      }
    },
    "lineItems": {
      "type": "array",
      "description": "List of products ordered",
      "items": {
        "$ref": "#/$defs/LineItem"
      }
    },
    "totalAmount": {
      "type": "number",
      "description": "Total order value in USD",
      "example": 15420.50
    },
    "currency": {
      "type": "string",
      "description": "Currency code",
      "example": "USD"
    }
  },
  "required": ["poNumber", "orderDate", "vendorId", "lineItems"],
  "$defs": {
    "LineItem": {
      "type": "object",
      "description": "A single line item in a purchase order",
      "properties": {
        "lineNumber": {"type": "integer", "description": "Sequential line item number", "example": 1},
        "upc": {"type": "string", "description": "Universal Product Code", "example": "012345678901"},
        "vendorSku": {"type": "string", "description": "Vendor's product SKU", "example": "SKU-HAMMER-16OZ"},
        "aceItemNumber": {"type": "string", "description": "Ace Hardware internal item number", "example": "4082165"},
        "description": {"type": "string", "description": "Product description", "example": "16 oz Claw Hammer"},
        "quantity": {"type": "integer", "description": "Quantity ordered", "example": 48},
        "unitCost": {"type": "number", "description": "Cost per unit in USD", "example": 12.99},
        "extendedCost": {"type": "number", "description": "Total line cost (quantity x unitCost)", "example": 623.52}
      },
      "required": ["lineNumber", "upc", "quantity", "unitCost"]
    }
  }
}