Skip to content
AutomotiveMCP
SchemasParts · R05RFC / v0.1

Part

v0.1.0

A single parts-catalog / inventory item in a dealer parts department, modeled richly for DMS, e-commerce, and AI-agent consumption. Modernizes ADF's parts-order line items into a typed, catalog-aware JSON entity that carries manufacturer identity, supersession chains, multi-location on-hand inventory, tiered pricing (list / cost / core / selling / MAP), unit-of-measure and packaging, hazmat/regulatory metadata, and year-range fitment. Referenced by service and deal entities via part_id.

Resourcesparts.get_partparts.search_partsparts.check_availability

part.example.jsonJSON
{
  "id": "7c9e6f2a-3b1d-4e5f-8a2b-1c2d3e4f5a6b",
  "source_ids": [
    {
      "system": "cdk_dms",
      "id": "PN-15809397",
      "sequence": 1
    },
    {
      "system": "gm_epc",
      "id": "15809397",
      "sequence": 2
    }
  ],
  "part_number": "15809397",
  "part_number_normalized": "15809397",
  "alternate_part_numbers": [
    "PF63",
    "PF-63E",
    "12690385"
  ],
  "upc": "036666088014",
  "gtin": "00036666088014",
  "manufacturer": "ACDelco",
  "manufacturer_code": "ACD",
  "brand": "Professional",
  "country_of_origin": "US",
  "description": "Engine Oil Filter - Professional",
  "long_description": "ACDelco Professional engine oil filter with high-efficiency filtration media and an anti-drainback valve for GM 5.3L and 6.2L V8 engines.",
  "category": "filters",
  "subcategory": "oil_filter",
  "part_type": "oem",
  "condition": "new",
  "is_oem": true,
  "is_serialized": false,
  "is_special_order": false,
  "is_discontinued": false,
  "supersession": {
    "superseded_by": "12690385",
    "supersedes": [
      "PF48",
      "PF48E"
    ],
    "superseded_at": "2025-11-01"
  },
  "unit_of_measure": "each",
  "package_quantity": 1,
  "quantity": {
    "on_hand": 42,
    "on_order": 24,
    "allocated": 6,
    "available": 36,
    "backordered": 0,
    "reorder_point": 12,
    "reorder_quantity": 24,
    "min_stock": 6,
    "max_stock": 60
  },
  "locations": [
    {
      "warehouse": "MAIN",
      "bin": "A-14-03",
      "quantity": 30,
      "is_primary": true
    },
    {
      "warehouse": "WEST-DC",
      "bin": "C-02-11",
      "quantity": 12,
      "is_primary": false
    }
  ],
  "pricing": {
    "list": {
      "amount": 14.99,
      "currency": "USD"
    },
    "cost": {
      "amount": 6.42,
      "currency": "USD"
    },
    "core": {
      "amount": 0,
      "currency": "USD"
    },
    "selling": {
      "amount": 11.99,
      "currency": "USD"
    },
    "map": {
      "amount": 9.99,
      "currency": "USD"
    },
    "trade": {
      "amount": 8.75,
      "currency": "USD"
    },
    "is_taxable": true,
    "effective_date": "2026-01-01"
  },
  "fitment": [
    {
      "make": "Chevrolet",
      "model": "Silverado 1500",
      "year_start": 2014,
      "year_end": 2019,
      "engine": "5.3L V8",
      "trim": "LT",
      "position": "not_applicable",
      "notes": "gasoline engines only"
    },
    {
      "make": "GMC",
      "model": "Sierra 1500",
      "year_start": 2014,
      "year_end": 2019,
      "engine": "6.2L V8",
      "trim": "Denali",
      "position": "not_applicable"
    }
  ],
  "fitment_universal": false,
  "weight_lb": 0.75,
  "dimensions": {
    "length_in": 3.75,
    "width_in": 3.75,
    "height_in": 4.5
  },
  "is_hazmat": false,
  "is_returnable": true,
  "return_policy": {
    "return_window_days": 30,
    "restocking_fee_percentage": 15
  },
  "warranty_months": 12,
  "warranty_miles": 12000,
  "lead_time_days": 2,
  "primary_supplier": {
    "name": "GM Parts Distribution",
    "supplier_part_number": "15809397",
    "account_number": "GMPD-4471"
  },
  "images": [
    "https://cdn.example-parts.com/img/15809397.jpg"
  ],
  "installation_labor_hours": 0.4,
  "velocity_class": "a",
  "status": "superseded",
  "last_sold_at": "2026-06-27T11:05:00Z",
  "last_received_at": "2026-06-20T08:00:00Z",
  "created_at": "2026-01-14T09:32:00Z",
  "updated_at": "2026-06-28T15:47:12Z",
  "extensions": {
    "x_acme_dms_velocity_class": "A",
    "x_acme_dms_last_counted_at": "2026-06-01"
  }
}
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.