{
  "openapi": "3.1.0",
  "jsonSchemaDialect": "https://spec.openapis.org/oas/3.1/dialect/base",
  "info": {
    "title": "The Power Contractor — Genuine OEM Industrial Catalog & B2B RFQ API",
    "version": "1.0.0",
    "summary": "Search 21,975 genuine OEM industrial products, inspect part specifications, precheck multi-SKU BOMs in <150ms, and submit tracked B2B RFQs.",
    "description": "Official machine-to-machine API for The Power Contractor (pc-cn.com, HQ: No. 128 Kaichen Street, Jiangning District, Nanjing, Jiangsu, China). Supplies 100% new, genuine OEM spare parts and project equipment (ABB, Siemens, Allen-Bradley, Hagglunds, Sitop, EagleBurgmann, Yokogawa, Rosemount, Bently Nevada, HIMA, valves, and MV/LV switchgear) to Iraq, Saudi Arabia, UAE, MENA, and global industrial buyers. Official Email: info@pc-cn.com | Official WhatsApp: +86 153 1498 7933 | Remote MCP: https://mcp.pc-cn.com/mcp.",
    "termsOfService": "https://pc-cn.com/legal/terms",
    "contact": {
      "name": "The Power Contractor — Global & MENA Quote Desk",
      "url": "https://pc-cn.com/rfq",
      "email": "info@pc-cn.com"
    }
  },
  "servers": [
    {
      "url": "https://pc-cn.com",
      "description": "Production Cloudflare Edge Gateway"
    }
  ],
  "paths": {
    "/api/v1/catalog/search": {
      "get": {
        "operationId": "searchIndustrialCatalog",
        "summary": "Search 21,975 genuine OEM industrial products by MPN, brand, or keyword",
        "description": "Returns matching genuine OEM products with normalized MPNs, category slugs, canonical HTML URLs, and <420-token Markdown twin URLs.",
        "x-openai-isConsequential": false,
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Manufacturer Part Number (MPN), model prefix, or technical keyword.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160,
              "examples": [
                "3BDS005799R1",
                "3BHB005171R0101",
                "6EP1332-1LB00"
              ]
            }
          },
          {
            "name": "brand",
            "in": "query",
            "required": false,
            "description": "Optional OEM manufacturer filter.",
            "schema": {
              "type": "string",
              "maxLength": 60,
              "examples": [
                "ABB",
                "Siemens",
                "Allen-Bradley"
              ]
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Optional canonical category slug.",
            "schema": {
              "type": "string",
              "enum": [
                "motors-drives",
                "industrial-connectivity-protection",
                "automation-control",
                "instrumentation-sensors",
                "switchgear-power-distribution",
                "mechanical-seals",
                "valves-actuators",
                "pumps-rotating-equipment",
                "power-supplies-ups",
                "heat-transfer"
              ],
              "examples": [
                "automation-control",
                "power-supplies-ups"
              ]
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum results to return (1–25).",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 25,
              "default": 10
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deterministic catalog search hits.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogSearchResponse"
                }
              }
            }
          }
        }
      }
    },
    "/api/v1/catalog/{mpn}": {
      "get": {
        "operationId": "getIndustrialPartByMpn",
        "summary": "Retrieve deterministic JSON technical specification and sourcing dossier by MPN or handle",
        "description": "Resolves normalized MPNs (e.g. 3BDS005799R1 or 3BHB005171R0101) or catalog handles (e.g. abb-pm665-3bds005799r1) to OEM specifications, sub-variants, cross-references, and RFQ links.",
        "x-openai-isConsequential": false,
        "parameters": [
          {
            "name": "mpn",
            "in": "path",
            "required": true,
            "description": "Manufacturer Part Number or catalog handle.",
            "schema": {
              "type": "string",
              "minLength": 2,
              "maxLength": 250,
              "examples": [
                "3BDS005799R1",
                "3BHB005171R0101",
                "abb-pm665-3bds005799r1"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Structured JSON technical dossier for the requested part.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CatalogPartDetail"
                }
              }
            }
          },
          "404": {
            "description": "MPN not in static index; eligible for 24h custom OEM sourcing via POST /api/v1/agent/rfq."
          }
        }
      }
    },
    "/api/v1/agent/bom-precheck": {
      "post": {
        "operationId": "precheckIndustrialBom",
        "summary": "Side-effect-free <150ms multi-SKU BOM normalization, OCR typo repair & corridor precheck",
        "description": "Validates 1–200 industrial BOM lines against 34,505 catalog variants without sending emails, flags discontinued MPNs with replacements, and computes Iraq/MENA air & sea transit windows. Also aliased at POST /api/v1/agent/rfq/bom-precheck.",
        "x-openai-isConsequential": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BomPrecheckRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Synchronous BOM validation and corridor precheck report.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BomPrecheckResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error or Oceania solar redirect to info@tpcsolar.com."
          },
          "451": {
            "description": "Sanctioned jurisdiction blocked (IR, SY, KP, CU)."
          }
        }
      }
    },
    "/api/v1/agent/rfq/bom-precheck": {
      "post": {
        "operationId": "precheckIndustrialBomAlias",
        "summary": "Alias for POST /api/v1/agent/bom-precheck (side-effect-free BOM precheck)",
        "description": "Compatibility alias for POST /api/v1/agent/bom-precheck returning identical synchronous BOM normalization and freight corridor estimates.",
        "x-openai-isConsequential": false,
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BomPrecheckRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Synchronous BOM validation and corridor precheck report.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BomPrecheckResponse"
                }
              }
            }
          },
          "422": {
            "description": "Validation error or Oceania solar redirect to info@tpcsolar.com."
          },
          "451": {
            "description": "Sanctioned jurisdiction blocked (IR, SY, KP, CU)."
          }
        }
      }
    },
    "/api/v1/agent/rfq": {
      "post": {
        "operationId": "submitStructuredRfq",
        "summary": "Submit an official B2B Request for Quotation (RFQ) and receive instant PCC-XXXX tracking",
        "description": "Executes <800ms BOM precheck, enforces 72h idempotency, mints rfq_reference_id (PCC-XXXX) + rfq_read_token (tpc_qtok_*), and dispatches to info@pc-cn.com / TPC Quote Desk.",
        "x-openai-isConsequential": true,
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": false,
            "description": "Unique client UUID or hash (8–128 chars; X-Idempotency-Key also accepted) preventing duplicate RFQs across 72h.",
            "schema": {
              "type": "string",
              "minLength": 8,
              "maxLength": 128,
              "examples": [
                "rfq-basra-20261122-0001"
              ]
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AgentRfqRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Idempotent replay of previously submitted RFQ.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentRfqResponse"
                }
              }
            }
          },
          "201": {
            "description": "RFQ created, prechecked in <800ms, and queued for written USD quotation.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentRfqResponse"
                }
              }
            }
          },
          "422": {
            "description": "Schema validation error or Oceania solar brand-isolation redirect."
          },
          "451": {
            "description": "Sanctioned jurisdiction blocked (IR, SY, KP, CU)."
          }
        }
      }
    },
    "/api/v1/agent/rfq/{id}": {
      "get": {
        "operationId": "getRfqStatusAndQuote",
        "summary": "Poll lifecycle status and formal USD quotation by PCC-XXXX or TPC-RFQ-* ID",
        "description": "Requires Authorization: Bearer <tpc_qtok_*> token issued by POST /api/v1/agent/rfq.",
        "x-openai-isConsequential": false,
        "security": [
          {
            "RfqReadToken": []
          }
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Commercial reference PCC-XXXX or trace ID TPC-RFQ-YYYYMMDD-XXXXXXXX.",
            "schema": {
              "type": "string",
              "examples": [
                "PCC-A9K4",
                "TPC-RFQ-20261122-9F4A2C1B"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Current RFQ status and verified USD commercial quotation when ready.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AgentRfqStatusResponse"
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid Bearer rfq_read_token."
          },
          "404": {
            "description": "Unknown RFQ identifier."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "RfqReadToken": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "tpc_qtok",
        "description": "Scoped single-RFQ bearer token returned at submission time."
      }
    },
    "schemas": {
      "CatalogItemSummary": {
        "type": "object",
        "required": [
          "mpn",
          "brand",
          "title",
          "handle",
          "condition",
          "sourcing_tier",
          "match_tier",
          "canonical_url",
          "markdown_twin_url",
          "json_twin_url"
        ],
        "properties": {
          "mpn": {
            "type": "string",
            "examples": [
              "3BHB005171R0101",
              "3BDS005799R1"
            ]
          },
          "brand": {
            "type": "string",
            "examples": [
              "ABB",
              "Siemens"
            ]
          },
          "title": {
            "type": "string",
            "examples": [
              "ABB PM665 3BDS005799R1"
            ]
          },
          "handle": {
            "type": "string",
            "examples": [
              "3bhb005171r0101-abb",
              "abb-pm665-3bds005799r1"
            ]
          },
          "category": {
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "automation-control"
            ]
          },
          "condition": {
            "type": "string",
            "examples": [
              "New Genuine OEM Only"
            ]
          },
          "sourcing_tier": {
            "type": "string",
            "examples": [
              "TIER_1_CATALOG_STANDARD",
              "TIER_2_OEM_ENGINEERED_BUILD"
            ]
          },
          "match_tier": {
            "type": "string",
            "enum": [
              "exact_mpn",
              "ocr_or_prefix",
              "keyword"
            ]
          },
          "canonical_url": {
            "type": "string",
            "format": "uri",
            "examples": [
              "https://pc-cn.com/catalog/product/abb-pm665-3bds005799r1"
            ]
          },
          "markdown_twin_url": {
            "type": "string",
            "format": "uri",
            "examples": [
              "https://pc-cn.com/catalog/part/3BDS005799R1.md"
            ]
          },
          "json_twin_url": {
            "type": "string",
            "format": "uri",
            "examples": [
              "https://pc-cn.com/api/v1/catalog/3BDS005799R1"
            ]
          }
        }
      },
      "CatalogSearchResponse": {
        "type": "object",
        "required": [
          "query",
          "total_returned",
          "total_matches",
          "results"
        ],
        "properties": {
          "query": {
            "type": "string",
            "examples": [
              "3BDS005799R1"
            ]
          },
          "total_returned": {
            "type": "integer",
            "examples": [
              1
            ]
          },
          "total_matches": {
            "type": "integer",
            "examples": [
              1
            ]
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CatalogItemSummary"
            }
          }
        }
      },
      "CatalogPartDetail": {
        "type": "object",
        "required": [
          "schema_version",
          "found",
          "match_status",
          "requested_mpn",
          "mpn",
          "handle",
          "title",
          "brand",
          "manufacturer",
          "condition",
          "procurement_type",
          "sourcing_tier",
          "canonical_url",
          "ar_url",
          "markdown_twin_url",
          "json_twin_url",
          "specifications",
          "trade_and_logistics",
          "rfq_handoff"
        ],
        "properties": {
          "schema_version": {
            "type": "string",
            "examples": [
              "2026-11"
            ]
          },
          "found": {
            "type": "boolean",
            "examples": [
              true
            ]
          },
          "match_status": {
            "type": "string",
            "examples": [
              "EXACT_MPN",
              "EXACT_HANDLE"
            ]
          },
          "requested_mpn": {
            "type": "string",
            "examples": [
              "3BDS005799R1"
            ]
          },
          "mpn": {
            "type": "string",
            "examples": [
              "3BDS005799R1"
            ]
          },
          "handle": {
            "type": "string",
            "examples": [
              "abb-pm665-3bds005799r1"
            ]
          },
          "title": {
            "type": "string",
            "examples": [
              "ABB PM665 3BDS005799R1"
            ]
          },
          "brand": {
            "type": "string",
            "examples": [
              "ABB"
            ]
          },
          "manufacturer": {
            "type": "string",
            "examples": [
              "ABB"
            ]
          },
          "category_slug": {
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "automation-control"
            ]
          },
          "category_label": {
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "Automation & Control"
            ]
          },
          "condition": {
            "type": "string",
            "examples": [
              "New Genuine OEM Only"
            ]
          },
          "procurement_type": {
            "type": "string",
            "examples": [
              "quote_required"
            ]
          },
          "sourcing_tier": {
            "type": "string",
            "examples": [
              "TIER_1_CATALOG_STANDARD"
            ]
          },
          "canonical_url": {
            "type": "string",
            "format": "uri",
            "examples": [
              "https://pc-cn.com/catalog/product/abb-pm665-3bds005799r1"
            ]
          },
          "ar_url": {
            "type": "string",
            "format": "uri",
            "examples": [
              "https://pc-cn.com/ar/catalog/product/abb-pm665-3bds005799r1"
            ]
          },
          "markdown_twin_url": {
            "type": "string",
            "format": "uri",
            "examples": [
              "https://pc-cn.com/catalog/part/3BDS005799R1.md"
            ]
          },
          "json_twin_url": {
            "type": "string",
            "format": "uri",
            "examples": [
              "https://pc-cn.com/api/v1/catalog/3BDS005799R1"
            ]
          },
          "images": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uri"
            }
          },
          "summary": {
            "type": [
              "string",
              "null"
            ]
          },
          "sub_variants": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "specifications": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "name",
                "value"
              ],
              "properties": {
                "name": {
                  "type": "string"
                },
                "value": {
                  "type": "string"
                }
              }
            }
          },
          "lifecycle": {
            "type": [
              "object",
              "null"
            ]
          },
          "compatible_assembly_bom": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "trade_and_logistics": {
            "type": "object"
          },
          "rfq_handoff": {
            "type": "object",
            "required": [
              "agent_rfq_post",
              "bom_precheck_post",
              "web_rfq_url",
              "whatsapp_url",
              "whatsapp_display",
              "email",
              "quote_sla_hours"
            ],
            "properties": {
              "agent_rfq_post": {
                "type": "string",
                "format": "uri",
                "examples": [
                  "https://pc-cn.com/api/v1/agent/rfq"
                ]
              },
              "bom_precheck_post": {
                "type": "string",
                "format": "uri",
                "examples": [
                  "https://pc-cn.com/api/v1/agent/bom-precheck"
                ]
              },
              "web_rfq_url": {
                "type": "string",
                "format": "uri"
              },
              "whatsapp_url": {
                "type": "string",
                "format": "uri"
              },
              "whatsapp_display": {
                "type": "string",
                "examples": [
                  "+86 153 1498 7933"
                ]
              },
              "email": {
                "type": "string",
                "examples": [
                  "info@pc-cn.com"
                ]
              },
              "quote_sla_hours": {
                "type": "integer",
                "examples": [
                  24
                ]
              }
            }
          }
        }
      },
      "BomLineItemInput": {
        "type": "object",
        "required": [
          "qty"
        ],
        "properties": {
          "client_line_id": {
            "type": "string",
            "maxLength": 64,
            "examples": [
              "L1"
            ]
          },
          "mpn": {
            "type": "string",
            "minLength": 2,
            "maxLength": 80,
            "examples": [
              "3BHB005171R0101",
              "6EP1332-1LB00"
            ]
          },
          "manufacturer": {
            "type": "string",
            "maxLength": 80,
            "examples": [
              "ABB",
              "Siemens"
            ]
          },
          "description": {
            "type": "string",
            "maxLength": 400
          },
          "qty": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100000,
            "default": 1
          },
          "uom": {
            "type": "string",
            "enum": [
              "EA",
              "SET",
              "MTR",
              "KG",
              "LOT"
            ],
            "default": "EA"
          },
          "notes": {
            "type": "string",
            "maxLength": 400,
            "examples": [
              "50Hz Iraq substation ambient 55C"
            ]
          },
          "epc_scope_spec": {
            "type": "object"
          }
        }
      },
      "BomPrecheckRequest": {
        "type": "object",
        "required": [
          "items"
        ],
        "properties": {
          "destination_country": {
            "type": "string",
            "pattern": "^[A-Z]{2}$",
            "default": "IQ",
            "examples": [
              "IQ",
              "SA",
              "AE"
            ]
          },
          "destination_city_or_port": {
            "type": "string",
            "maxLength": 120,
            "examples": [
              "Basra",
              "Umm Qasr",
              "Erbil"
            ]
          },
          "iraq_customs_zone": {
            "type": "string",
            "maxLength": 32,
            "examples": [
              "federal_iraq",
              "krg"
            ]
          },
          "urgency": {
            "type": "string",
            "enum": [
              "standard_24h",
              "urgent_same_day",
              "critical_downtime"
            ],
            "default": "standard_24h"
          },
          "items": {
            "type": "array",
            "minItems": 1,
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/BomLineItemInput"
            }
          }
        }
      },
      "NormalizedBomLine": {
        "type": "object",
        "required": [
          "line_no",
          "submitted_mpn",
          "canonical_mpn",
          "resolved_brand",
          "catalog_handle",
          "catalog_url",
          "catalog_markdown_url",
          "qty",
          "uom",
          "match_status",
          "sourcing_tier",
          "lead_time_business_days",
          "suggested_replacements"
        ],
        "properties": {
          "line_no": {
            "type": "integer"
          },
          "client_line_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "submitted_mpn": {
            "type": [
              "string",
              "null"
            ]
          },
          "canonical_mpn": {
            "type": [
              "string",
              "null"
            ]
          },
          "resolved_brand": {
            "type": [
              "string",
              "null"
            ]
          },
          "catalog_handle": {
            "type": [
              "string",
              "null"
            ],
            "examples": [
              "3bhb005171r0101-abb"
            ]
          },
          "catalog_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "examples": [
              "https://pc-cn.com/catalog/product/3bhb005171r0101-abb"
            ]
          },
          "catalog_markdown_url": {
            "type": [
              "string",
              "null"
            ],
            "format": "uri",
            "examples": [
              "https://pc-cn.com/catalog/part/3BHB005171R0101.md"
            ]
          },
          "title": {
            "type": [
              "string",
              "null"
            ]
          },
          "category_slug": {
            "type": [
              "string",
              "null"
            ]
          },
          "qty": {
            "type": "integer"
          },
          "uom": {
            "type": "string",
            "enum": [
              "EA",
              "SET",
              "MTR",
              "KG",
              "LOT"
            ]
          },
          "match_status": {
            "type": "string"
          },
          "sourcing_tier": {
            "type": "string"
          },
          "lead_time_business_days": {
            "type": "object",
            "properties": {
              "min_days": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "max_days": {
                "type": [
                  "integer",
                  "null"
                ]
              },
              "dispatch_hub": {
                "type": "string"
              },
              "notes": {
                "type": "string"
              }
            }
          },
          "suggested_replacements": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      },
      "BomPrecheckResponse": {
        "type": "object",
        "required": [
          "precheck_latency_ms",
          "summary",
          "normalized_items",
          "shipping_corridors",
          "compliance_pack"
        ],
        "properties": {
          "precheck_latency_ms": {
            "type": "number"
          },
          "summary": {
            "type": "object",
            "required": [
              "total_lines",
              "catalog_verified_lines",
              "typo_corrected_lines",
              "obsolete_with_replacement_lines",
              "custom_sourcing_lines",
              "genuine_oem_guarantee"
            ],
            "properties": {
              "total_lines": {
                "type": "integer"
              },
              "catalog_verified_lines": {
                "type": "integer"
              },
              "typo_corrected_lines": {
                "type": "integer"
              },
              "obsolete_with_replacement_lines": {
                "type": "integer"
              },
              "custom_sourcing_lines": {
                "type": "integer"
              },
              "genuine_oem_guarantee": {
                "type": "string"
              }
            }
          },
          "normalized_items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NormalizedBomLine"
            }
          },
          "shipping_corridors": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "compliance_pack": {
            "type": "object",
            "properties": {
              "standard_included": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "country_specific_frameworks": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "accepted_tic_inspectors": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          }
        }
      },
      "AgentRfqRequest": {
        "type": "object",
        "required": [
          "buyer",
          "delivery",
          "items",
          "oem_genuine_only_acknowledged"
        ],
        "properties": {
          "idempotency_key": {
            "type": "string",
            "minLength": 8,
            "maxLength": 128,
            "description": "Optional client idempotency key (auto-derived deterministically when omitted).",
            "examples": [
              "rfq-basra-20261122-0001"
            ]
          },
          "buyer": {
            "type": "object",
            "required": [
              "contact_name",
              "company_name",
              "contact_email"
            ],
            "properties": {
              "contact_name": {
                "type": "string",
                "minLength": 2,
                "maxLength": 150,
                "examples": [
                  "Eng. Kareem Al-Jabouri"
                ]
              },
              "company_name": {
                "type": "string",
                "minLength": 2,
                "maxLength": 150,
                "examples": [
                  "Al-Furat Power Maintenance"
                ]
              },
              "contact_email": {
                "type": "string",
                "format": "email",
                "maxLength": 200,
                "examples": [
                  "procurement@example.iq"
                ]
              },
              "contact_phone_or_whatsapp": {
                "type": "string",
                "maxLength": 40,
                "examples": [
                  "+964 780 000 0000"
                ]
              },
              "company_website": {
                "type": "string",
                "format": "uri",
                "maxLength": 255,
                "examples": [
                  "https://example.iq"
                ]
              }
            }
          },
          "delivery": {
            "type": "object",
            "required": [
              "destination_country",
              "urgency"
            ],
            "properties": {
              "destination_country": {
                "type": "string",
                "pattern": "^[A-Z]{2}$",
                "examples": [
                  "IQ",
                  "SA",
                  "AE"
                ]
              },
              "destination_city_or_port": {
                "type": "string",
                "maxLength": 120,
                "examples": [
                  "Basra",
                  "Umm Qasr",
                  "Baghdad"
                ]
              },
              "iraq_customs_zone": {
                "type": "string",
                "maxLength": 32,
                "examples": [
                  "federal_iraq",
                  "krg"
                ]
              },
              "preferred_incoterm": {
                "type": "string",
                "enum": [
                  "EXW",
                  "FCA",
                  "CPT",
                  "CIP",
                  "CFR",
                  "CIF",
                  "DAP",
                  "DDP"
                ],
                "default": "CIF"
              },
              "urgency": {
                "type": "string",
                "enum": [
                  "standard_24h",
                  "urgent_same_day",
                  "critical_downtime"
                ]
              }
            }
          },
          "project_notes": {
            "type": "string",
            "maxLength": 4000
          },
          "items": {
            "type": "array",
            "minItems": 1,
            "maxItems": 200,
            "items": {
              "$ref": "#/components/schemas/BomLineItemInput"
            }
          },
          "oem_genuine_only_acknowledged": {
            "type": "boolean",
            "const": true,
            "enum": [
              true
            ],
            "description": "Confirms acknowledgement that TPC supplies 100% new genuine OEM equipment only."
          }
        }
      },
      "AgentRfqResponse": {
        "type": "object",
        "required": [
          "rfq_reference_id",
          "attribution_trace_id",
          "idempotency_replayed",
          "status",
          "status_url",
          "rfq_read_token",
          "poll_after_seconds",
          "expected_formal_quote_sla_hours",
          "payment_terms_supported",
          "summary",
          "normalized_items",
          "shipping_corridors",
          "compliance_pack",
          "continuity_channels"
        ],
        "properties": {
          "precheck_latency_ms": {
            "type": "number"
          },
          "rfq_reference_id": {
            "type": "string",
            "examples": [
              "PCC-A9K4"
            ]
          },
          "attribution_trace_id": {
            "type": "string",
            "examples": [
              "TPC-RFQ-20261122-9F4A2C1B"
            ]
          },
          "idempotency_replayed": {
            "type": "boolean"
          },
          "status": {
            "type": "string",
            "enum": [
              "PRECHECKED_PENDING_PRICER",
              "CLARIFICATION_REQUESTED",
              "QUOTED",
              "REVISED_QUOTED",
              "DECLINED_UNSOURCEABLE",
              "EXPIRED"
            ],
            "examples": [
              "PRECHECKED_PENDING_PRICER"
            ]
          },
          "status_url": {
            "type": "string",
            "format": "uri",
            "examples": [
              "https://pc-cn.com/api/v1/agent/rfq/PCC-A9K4"
            ]
          },
          "rfq_read_token": {
            "type": "string",
            "examples": [
              "tpc_qtok_9f83c4d2e1b74a0c8d5e2f11a9b3c7d4"
            ]
          },
          "poll_after_seconds": {
            "type": "integer",
            "examples": [
              900
            ]
          },
          "expected_formal_quote_sla_hours": {
            "type": "integer",
            "examples": [
              24
            ]
          },
          "payment_terms_supported": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "summary": {
            "type": "object"
          },
          "normalized_items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NormalizedBomLine"
            }
          },
          "shipping_corridors": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "compliance_pack": {
            "type": "object"
          },
          "continuity_channels": {
            "type": "object",
            "properties": {
              "whatsapp_deeplink": {
                "type": "string",
                "format": "uri"
              },
              "whatsapp_e164": {
                "type": "string",
                "examples": [
                  "+8615314987933"
                ]
              },
              "mailto_uri": {
                "type": "string",
                "format": "uri"
              },
              "email_address": {
                "type": "string",
                "examples": [
                  "info@pc-cn.com"
                ]
              }
            }
          }
        }
      },
      "AgentRfqStatusResponse": {
        "type": "object",
        "required": [
          "rfq_reference_id",
          "attribution_trace_id",
          "status",
          "created_at",
          "updated_at"
        ],
        "properties": {
          "rfq_reference_id": {
            "type": "string",
            "examples": [
              "PCC-A9K4"
            ]
          },
          "attribution_trace_id": {
            "type": "string",
            "examples": [
              "TPC-RFQ-20261122-9F4A2C1B"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "PRECHECKED_PENDING_PRICER",
              "CLARIFICATION_REQUESTED",
              "QUOTED",
              "REVISED_QUOTED",
              "DECLINED_UNSOURCEABLE",
              "EXPIRED"
            ]
          },
          "created_at": {
            "type": "string",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "format": "date-time"
          },
          "expected_formal_quote_sla_hours": {
            "type": "integer",
            "examples": [
              24
            ]
          },
          "formal_quotation": {
            "type": [
              "object",
              "null"
            ]
          },
          "clarification_question": {
            "type": [
              "string",
              "null"
            ]
          },
          "summary": {
            "type": "object"
          },
          "continuity_channels": {
            "type": "object"
          }
        }
      }
    }
  }
}