SchemasParts · R05RFC / v0.1

Parts Order

v0.1.0

A parts procurement order raised by a dealer parts department against a vendor or manufacturer. Captures the full lifecycle of stock replenishment, special orders, emergency orders, and returns — including per-line quantities ordered/received/backordered/shipped/canceled, dealer-cost, list-price and core-charge money, rolled-up totals, ship-to / bill-to addresses, freight and payment terms, return/RMA handling, and shipment tracking. Links to the Vendor, Dealer, and (when the order backs a repair order or a retail counter sale) the Service Order and Customer. Modernizes ADF/AutomotiveAPI parts-order messaging into a typed JSON entity that a DMS or parts catalog can implement against for parts.get_order, parts.create_order, and parts.list_orders.

Resourcesparts.get_orderparts.create_orderparts.list_orders

parts-order.example.jsonJSON

{
  "id": "3f1a2b9c-8d4e-4f6a-9b12-7c5e6d8a1f23",
  "source_ids": [
    {
      "system": "cdk_drive",
      "id": "PO-2026-004518",
      "sequence": 1
    },
    {
      "system": "oem_parts_edi",
      "id": "SOR-778812",
      "sequence": 2
    }
  ],
  "order_number": "PO-2026-004518",
  "vendor_order_number": "TDPC-8841207",
  "type": "special_order",
  "status": "partial",
  "priority": "vor",
  "currency": "USD",
  "vendor_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
  "dealer_id": "d4c3b2a1-f6e5-4b7a-9c8d-1f0e2a3b4c5d",
  "service_order_id": "9c8d7e6f-5a4b-4c3d-8e2f-1a0b9c8d7e6f",
  "customer_id": "12345678-90ab-4cde-8f01-234567890abc",
  "ordered_by_id": "0a1b2c3d-4e5f-4061-8273-849506a7b8c9",
  "contact": {
    "name": {
      "first": "Dana",
      "last": "Whitfield"
    },
    "email": {
      "address": "parts@rivertoyota.example"
    },
    "phone": {
      "number": "+1 816 555 0142"
    }
  },
  "ship_to_address": {
    "city": "Kansas City",
    "region": "MO",
    "postal_code": "64120",
    "country": "US",
    "lines": [
      "1450 Industrial Pkwy",
      "Dock 3 - Parts Receiving"
    ]
  },
  "bill_to_address": {
    "city": "Kansas City",
    "region": "MO",
    "postal_code": "64120",
    "country": "US",
    "lines": [
      "1450 Industrial Pkwy",
      "Attn: Accounts Payable"
    ]
  },
  "freight_terms": "prepaid_and_charge",
  "payment_terms": "net_30",
  "lines": [
    {
      "line_number": 1,
      "part_id": "aaaa1111-bbbb-4ccc-8ddd-eeee2222ffff",
      "part_number": "04465-33471",
      "manufacturer_code": "TOY",
      "description": "Front Brake Pad Kit",
      "unit_of_measure": "kit",
      "bin_location": "A-14-3",
      "part_condition": "new",
      "quantity_ordered": 2,
      "quantity_shipped": 2,
      "quantity_received": 2,
      "quantity_backordered": 0,
      "quantity_canceled": 0,
      "line_status": "received",
      "list_price": {
        "amount": 98.4,
        "currency": "USD"
      },
      "unit_cost": {
        "amount": 62.5,
        "currency": "USD"
      },
      "discount_percentage": 36.48,
      "extended_cost": {
        "amount": 125,
        "currency": "USD"
      }
    },
    {
      "line_number": 2,
      "part_id": "bbbb2222-cccc-4ddd-8eee-ffff3333aaaa",
      "part_number": "43512-33130",
      "manufacturer_code": "TOY",
      "superseded_by_part_number": "43512-33131",
      "description": "Front Brake Rotor",
      "unit_of_measure": "each",
      "bin_location": "A-15-1",
      "part_condition": "new",
      "quantity_ordered": 2,
      "quantity_shipped": 1,
      "quantity_received": 1,
      "quantity_backordered": 1,
      "quantity_canceled": 0,
      "line_status": "backordered",
      "backorder_eta": "2026-07-08",
      "list_price": {
        "amount": 132,
        "currency": "USD"
      },
      "unit_cost": {
        "amount": 88,
        "currency": "USD"
      },
      "core_charge": {
        "amount": 0,
        "currency": "USD"
      },
      "extended_cost": {
        "amount": 176,
        "currency": "USD"
      },
      "notes": "Backordered unit expedite requested - vehicle off road."
    }
  ],
  "totals": {
    "subtotal": {
      "amount": 301,
      "currency": "USD"
    },
    "core_charges": {
      "amount": 0,
      "currency": "USD"
    },
    "discount": {
      "amount": 0,
      "currency": "USD"
    },
    "shipping": {
      "amount": 14.95,
      "currency": "USD"
    },
    "tax": {
      "amount": 24.83,
      "currency": "USD"
    },
    "total": {
      "amount": 340.78,
      "currency": "USD"
    }
  },
  "ordered_at": "2026-06-28T14:32:00Z",
  "submitted_at": "2026-06-28T14:32:00Z",
  "acknowledged_at": "2026-06-28T15:07:41Z",
  "expected_at": "2026-07-02",
  "shipped_at": "2026-06-29T22:05:00Z",
  "received_at": "2026-06-30T09:15:00Z",
  "carrier": "UPS Ground",
  "carrier_scac": "UPSN",
  "tracking_number": "1Z999AA10123456784",
  "tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
  "notes": "Special order backing RO 9c8d7e6f. Call parts contact before any substitution.",
  "created_at": "2026-06-28T14:30:00Z",
  "updated_at": "2026-06-30T09:16:12Z",
  "extensions": {
    "acme_dms:priority_flag": "hot",
    "acme_dms:pdc_code": "KC1"
  }
}

Object shapes align with the AutomotiveAPI open data standard where sensible, and with the industry's ADF lead format — so a conformant server maps cleanly onto systems dealers already run.