{
  "schemaVersion": "freightfba-quote-action.v1",
  "name": "amazon_fba_freight_quote_request",
  "endpoint": "https://freightfba.com/quote/",
  "method": "POST",
  "required": [
    "contact.name",
    "contact.email",
    "shipment.origin",
    "shipment.destination",
    "shipment.cargoSummary"
  ],
  "optional": [
    "shipment.mode",
    "shipment.incoterm",
    "shipment.amazonFbaWarehouse",
    "shipment.readyDate",
    "shipment.commodity",
    "shipment.hasBatteryOrDangerousGoods"
  ],
  "fields": [
    {
      "name": "contact.name",
      "type": "string",
      "required": true,
      "description": "Human contact name for follow-up."
    },
    {
      "name": "contact.email",
      "type": "string",
      "required": true,
      "description": "Reply-to email for the freight quote."
    },
    {
      "name": "shipment.origin",
      "type": "string",
      "required": true,
      "description": "Origin city, factory address, or port in China."
    },
    {
      "name": "shipment.destination",
      "type": "string",
      "required": true,
      "description": "Amazon FBA warehouse, prep center, city, or final delivery address."
    },
    {
      "name": "shipment.mode",
      "type": "string",
      "required": false,
      "enum": [
        "air",
        "ocean-lcl",
        "ocean-fcl",
        "express",
        "ddp",
        "unsure"
      ],
      "description": "Preferred shipping mode."
    },
    {
      "name": "shipment.incoterm",
      "type": "string",
      "required": false,
      "enum": [
        "exw",
        "fob",
        "fca",
        "dap",
        "ddp",
        "unsure"
      ],
      "description": "Trade term or responsibility boundary."
    },
    {
      "name": "shipment.cargoSummary",
      "type": "string",
      "required": true,
      "description": "Carton count, dimensions, gross weight, commodity, declared value, and timing."
    },
    {
      "name": "shipment.hasBatteryOrDangerousGoods",
      "type": "boolean",
      "required": false,
      "description": "Whether the cargo includes batteries, liquids, magnets, powder, chemicals, or DG restrictions."
    }
  ],
  "success": {
    "acceptedStatus": 202,
    "meaning": "Request accepted for human review and follow-up.",
    "humanFollowUpTarget": "helen@honourocean.com"
  },
  "limitations": [
    "Submitting a form does not create a binding quote, booking, or customs commitment.",
    "Final pricing requires lane, cargo, season, customs, appointment, and destination-fee review.",
    "Amazon FBA receiving delays and appointment availability are outside calculator guarantees."
  ],
  "fallback": {
    "email": "mailto:helen@honourocean.com",
    "whatsapp": "https://wa.me/8618923724899"
  }
}