{
  "id": "openai.feed.required-fields",
  "protocol": "openai-feed",
  "layer": "product-data",
  "role": "merchant",
  "status": "required",
  "title": "Include the nine OpenAI required fields",
  "description": "Required: item_id, title, description, url, brand, seller_name, image_url, availability, price.",
  "goal": "Rows missing these are not useful for discovery; invalid availability rejects the row.",
  "note": "Re-verified 2026-10-12 against the file upload products spec. Omitted, empty or unrecognized availability rejects the row; use unknown explicitly when stock status is unknown. item_id must be stable and never reused for a different item. Price is the regular price in major currency units plus currency code, for example 79.99 USD.",
  "how_to_implement": {
    "steps": [
      "Map your catalog to the nine fields.",
      "Use explicit availability values (in_stock, out_of_stock, pre_order, backorder, unknown)."
    ],
    "snippet": {
      "lang": "jsonl",
      "code": "{\"item_id\":\"MUG-350-BLUE\",\"title\":\"Blue ceramic mug, 350 mL\",\"description\":\"Dishwasher-safe glazed ceramic mug with a handle.\",\"url\":\"https://example.com/products/mug-blue\",\"brand\":\"Northline\",\"seller_name\":\"Northline Home\",\"image_url\":\"https://example.com/images/mug-blue.jpg\",\"price\":\"18.00 USD\",\"availability\":\"in_stock\"}",
      "source_url": "https://developers.openai.com/commerce/specs/file-upload/products",
      "source_label": "OpenAI feed spec, minimal example"
    }
  },
  "resources": [
    {
      "label": "OpenAI file upload: products spec",
      "url": "https://developers.openai.com/commerce/specs/file-upload/products",
      "type": "spec",
      "publisher": "OpenAI"
    },
    {
      "label": "OpenAI product feed spec",
      "url": "https://developers.openai.com/commerce/specs/file-upload/products",
      "type": "spec",
      "publisher": "OpenAI"
    }
  ],
  "audit": {
    "method": "feed_check",
    "automatable": true,
    "expect": {
      "required_fields": [
        "item_id",
        "title",
        "description",
        "url",
        "brand",
        "seller_name",
        "image_url",
        "availability",
        "price"
      ]
    },
    "human": "Every feed row has all nine required fields with valid values."
  },
  "how_to_verify": "Every feed row has all nine required fields with valid values.",
  "artifacts": [
    "item_id",
    "title",
    "description",
    "url",
    "brand",
    "seller_name",
    "image_url",
    "availability",
    "price"
  ],
  "depends_on": [],
  "status_note": "Re-verified 2026-10-12 against the file upload products spec. Omitted, empty or unrecognized availability rejects the row; use unknown explicitly when stock status is unknown. item_id must be stable and never reused for a different item. Price is the regular price in major currency units plus currency code, for example 79.99 USD.",
  "verified": true,
  "slug": "openai-feed-required-fields",
  "category": "product-data",
  "url": "https://vreeman.ai/commerce/checklist#openai.feed.required-fields",
  "updated": "2026-10-12",
  "sources": [
    {
      "label": "OpenAI file upload: products spec",
      "url": "https://developers.openai.com/commerce/specs/file-upload/products",
      "type": "spec",
      "publisher": "OpenAI"
    },
    {
      "label": "OpenAI product feed spec",
      "url": "https://developers.openai.com/commerce/specs/file-upload/products",
      "type": "spec",
      "publisher": "OpenAI"
    }
  ],
  "related_slugs": []
}