China Import Quote Preflight

Use BEFORE accepting or paying a China supplier quote for one China → US or China → EU shipment. This shipment-level gate exposes missing landed-cost inputs, dated low-value rule changes, and compliance blockers for low-regulation physical goods. Use normalize_supplier_quote for one quote, compare_preflight_quotes for 2–5 quotes, and check_trade_requirements for a checklist. Do not use it as a freight-rate marketplace, HTS/TARIC classifier, customs brokerage service, or legal advice. Output includes status, corridor, missing_fields, dated authoritative_sources, estimated_landed_cost_components, de_minimis_low_value_treatment, compliance_flags, human_review_reason, and disclaimer. UNKNOWN means a cost or rule cannot be established from supplied inputs; NEEDS_MORE_DATA means required values are missing; MANUAL_REVIEW means a human importer, broker, or compliance reviewer must decide.

{
  "type": "object",
  "properties": {
    "product_description": {
      "type": "string",
      "description": "Required plain-language description of the physical good; include material and intended use here or in material_use. Do not use for services or restricted goods."
    },
    "origin_country": {
      "type": "string",
      "description": "Required country where the goods ship from; this v1 accepts China, CN, PRC, or equivalent wording."
    },
    "destination_country": {
      "type": "string",
      "description": "Required destination country or EU; this v1 supports United States and EU member states only."
    },
    "unit_value": {
      "description": "Required non-negative per-unit goods value. Pass a number with unit_value_currency, or an object containing amount/value and currency.",
      "oneOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "object",
          "properties": {
            "amount": {
              "type": "number",
              "minimum": 0,
              "description": "Non-negative amount in the stated currency."
            },
            "value": {
              "type": "number",
              "minimum": 0,
              "description": "Alias for amount; use amount when possible."
            },
            "currency": {
              "type": "string",
              "pattern": "^[A-Za-z]{3}$",
              "description": "Three-letter ISO 4217 currency code, for example USD or EUR."
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "unit_value_currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Currency for a numeric unit_value. Omit only when unit_value is an object that already carries currency; omitting both leaves the goods subtotal UNKNOWN."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "description": "Required positive number of physical units; use the supplier quote quantity, not cartons unless each carton is the priced unit."
    },
    "shipping_cost": {
      "description": "Optional quoted shipping/freight amount for the shipment. Omit when unknown; the output will mark shipping and the all-in total UNKNOWN.",
      "oneOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "object",
          "properties": {
            "amount": {
              "type": "number",
              "minimum": 0,
              "description": "Non-negative amount in the stated currency."
            },
            "value": {
              "type": "number",
              "minimum": 0,
              "description": "Alias for amount; use amount when possible."
            },
            "currency": {
              "type": "string",
              "pattern": "^[A-Za-z]{3}$",
              "description": "Three-letter ISO 4217 currency code, for example USD or EUR."
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "shipping_cost_currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Currency for a numeric shipping_cost. Omit when shipping_cost is an object carrying currency or when shipping_cost is omitted."
    },
    "hs_code": {
      "type": "string",
      "description": "Optional supplier- or broker-provided HS/HTS/CN code. Omit if not already available; this tool never fabricates or independently validates classification and will request manual review."
    },
    "incoterm": {
      "type": "string",
      "description": "Optional three-letter Incoterms rule such as EXW, FOB, DAP, or DDP. Supply it when stated on the quote; omit only when unknown and expect a missing-field flag."
    },
    "material_use": {
      "type": "string",
      "description": "Optional material and intended-use context, such as textile consumer gift item. Supply it to improve restricted-category and compliance screening; omit only when genuinely unknown."
    }
  },
  "required": [
    "product_description",
    "origin_country",
    "destination_country",
    "unit_value",
    "quantity"
  ],
  "additionalProperties": false
}

Use BEFORE asking a China supplier for a final quote or before paying, when you need the minimum data/compliance checklist for China → US or China → EU low-regulation physical goods. Use normalize_supplier_quote when you already have one quote, compare_preflight_quotes for 2–5 quotes, and trade_preflight for shipment-level cost/rule screening. Do not use it as a tariff classifier, freight marketplace, customs broker, or legal adviser. Output includes required_fields, recommended_fields, manual_review_flags, product_risk_flags, authoritative_sources, and status. UNKNOWN means the corridor or a requirement cannot be established; NEEDS_MORE_DATA means more inputs are needed; MANUAL_REVIEW means a human must review the product or entry.

{
  "type": "object",
  "properties": {
    "origin_country": {
      "type": "string",
      "description": "Required origin country; use China/CN/PRC for this v1 corridor."
    },
    "destination_country": {
      "type": "string",
      "description": "Required destination country or EU; use United States or an EU member state."
    },
    "product_description": {
      "type": "string",
      "description": "Optional plain-language physical-good description. Omit only if unknown; product-specific requirements then remain incomplete."
    },
    "material_use": {
      "type": "string",
      "description": "Optional material and intended use, such as textile or consumer gift item. Supply when known to improve risk screening."
    }
  },
  "required": [
    "origin_country",
    "destination_country"
  ],
  "additionalProperties": false
}

Use BEFORE accepting or paying one China supplier quote. Turn the quote into a comparable preflight_quote_passport, preserve Incoterm and validity context, and expose missing landed-cost fields and hidden/unknown costs. Use compare_preflight_quotes for 2–5 quotes and trade_preflight for a shipment-level gate. Do not use it as a live freight quote, HTS/TARIC classifier, customs brokerage service, or legal advice. Output includes quote, preflight, missing_quote_fields, hidden_or_unknown_costs, ready_for_comparison, and disclaimer. UNKNOWN means a cost or field is not supplied; NEEDS_MORE_DATA means the passport cannot support a reliable comparison; MANUAL_REVIEW means a human must decide.

{
  "type": "object",
  "properties": {
    "product_description": {
      "type": "string",
      "description": "Optional plain-language physical-good description; strongly recommended before payment and needed for a useful product-risk screen."
    },
    "unit_price": {
      "description": "Required non-negative per-unit supplier price. Pass a number with currency, or an object containing amount/value and currency.",
      "oneOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "object",
          "properties": {
            "amount": {
              "type": "number",
              "minimum": 0,
              "description": "Non-negative amount in the stated currency."
            },
            "value": {
              "type": "number",
              "minimum": 0,
              "description": "Alias for amount; use amount when possible."
            },
            "currency": {
              "type": "string",
              "pattern": "^[A-Za-z]{3}$",
              "description": "Three-letter ISO 4217 currency code, for example USD or EUR."
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Currency for a numeric unit_price. Omit only when unit_price is an object carrying currency; otherwise the passport marks currency missing."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "description": "Required positive number of units covered by the supplier quote."
    },
    "incoterm": {
      "type": "string",
      "description": "Optional stated Incoterms rule, for example EXW, FOB, DAP, or DDP. Omit only when absent from the quote; it will be listed as missing."
    },
    "origin_country": {
      "type": "string",
      "description": "Required country of shipment origin; this v1 is for China/CN/PRC."
    },
    "shipping_cost": {
      "description": "Optional quoted freight/shipping amount. Omit when the supplier did not state it; hidden_or_unknown_costs will flag the gap.",
      "oneOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "object",
          "properties": {
            "amount": {
              "type": "number",
              "minimum": 0,
              "description": "Non-negative amount in the stated currency."
            },
            "value": {
              "type": "number",
              "minimum": 0,
              "description": "Alias for amount; use amount when possible."
            },
            "currency": {
              "type": "string",
              "pattern": "^[A-Za-z]{3}$",
              "description": "Three-letter ISO 4217 currency code, for example USD or EUR."
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "shipping_currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "Currency for a numeric shipping_cost. Omit when shipping_cost is an object carrying currency or is absent."
    },
    "destination_country": {
      "type": "string",
      "description": "Required destination country or EU; this v1 supports United States and EU member states."
    },
    "hs_code": {
      "type": "string",
      "description": "Optional supplier- or broker-provided HS/HTS/CN code. Omit if unavailable; no classification is fabricated."
    },
    "material_use": {
      "type": "string",
      "description": "Optional material and intended-use context. Supply it when known to improve restricted-category screening."
    },
    "quote_valid_until": {
      "type": "string",
      "description": "Optional supplier validity date or text, preferably YYYY-MM-DD. Omit when the quote has no stated expiry."
    },
    "lead_time": {
      "type": "string",
      "description": "Optional supplier production/transit lead-time text, such as 15 days. Omit when not stated."
    }
  },
  "required": [
    "unit_price",
    "quantity",
    "origin_country",
    "destination_country"
  ],
  "additionalProperties": false
}

Use BEFORE choosing or paying a supplier to compare 2–5 China supplier quotes for the same China → US or China → EU purchase. Each item may be a raw quote accepted by normalize_supplier_quote or an existing preflight_quote_passport. Use normalize_supplier_quote first when you have only one quote, and trade_preflight for a shipment-level gate. Do not use it as a freight-rate marketplace, tariff classifier, customs brokerage service, or legal advice. Output includes comparable, comparison_basis, rows, ranking, excluded_from_comparison, and message. UNKNOWN means goods-plus-shipping cannot be computed; NEEDS_MORE_DATA means inputs are incomplete; MANUAL_REVIEW means a human must resolve a product/compliance flag. A ranking is never an all-in landed-cost winner.

{
  "type": "object",
  "properties": {
    "quotes": {
      "type": "array",
      "minItems": 2,
      "maxItems": 5,
      "description": "Required array of 2–5 raw supplier quote objects or preflight_quote_passport outputs. Keep corridor, currency, quantity, unit price, and shipping fields comparable; missing or mixed values are reported rather than guessed.",
      "items": {
        "type": "object",
        "description": "One raw supplier quote with normalize_supplier_quote fields, or one preflight_quote_passport returned by that tool."
      }
    }
  },
  "required": [
    "quotes"
  ],
  "additionalProperties": false
}