{
  "schemaVersion": "cargomath-quote-action.v1",
  "name": "freight_quote_request",
  "endpoint": "https://cargomath.com/api/quote",
  "openapi": "https://cargomath.com/quote/openapi.json",
  "operator": {
    "name": "Honourocean Shipping",
    "legalName": "Honour Ocean Shipping Co., Ltd.",
    "url": "https://honourocean.com",
    "sameAs": [
      "https://honourocean.com",
      "https://www.honouroceanshipping.com",
      "https://www.linkedin.com/company/honouroceanshipping"
    ],
    "relationship": "CargoMath quote requests are reviewed for human follow-up by Honourocean Shipping."
  },
  "method": "POST",
  "transport": {
    "protocol": "first-party-json-api",
    "contentType": "application/json",
    "idempotencyHeader": "Idempotency-Key",
    "agentHeader": "X-Agent-Name"
  },
  "required": [
    "contact.name",
    "contact.email",
    "shipment.origin",
    "shipment.destination",
    "shipment.cargoSummary"
  ],
  "optional": [
    "shipment.mode",
    "shipment.incoterm",
    "shipment.amazonFba"
  ],
  "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, or port."
    },
    {
      "name": "shipment.destination",
      "type": "string",
      "required": true,
      "description": "Destination city, warehouse, port, or Amazon FBA location."
    },
    {
      "name": "shipment.mode",
      "type": "string",
      "required": false,
      "enum": [
        "ocean-fcl",
        "ocean-lcl",
        "air",
        "express",
        "unsure"
      ],
      "description": "Preferred transport mode."
    },
    {
      "name": "shipment.incoterm",
      "type": "string",
      "required": false,
      "enum": [
        "ddp",
        "dap",
        "fob",
        "exw",
        "unsure"
      ],
      "description": "Commercial term preference."
    },
    {
      "name": "shipment.cargoSummary",
      "type": "string",
      "required": true,
      "description": "Dimensions, weight, commodity, declared value, and any battery or DG details."
    },
    {
      "name": "shipment.amazonFba",
      "type": "boolean",
      "required": false,
      "description": "Whether the shipment is delivering to Amazon FBA."
    }
  ],
  "success": {
    "acceptedStatus": 202,
    "meaning": "Request accepted for human review and follow-up.",
    "humanFollowUpTarget": "helen@honourocean.com",
    "responseFields": [
      "accepted",
      "leadId",
      "status",
      "message"
    ]
  },
  "limitations": [
    "Submitting the form does not create a binding quotation or booking.",
    "Battery cargo, dangerous goods, liquids, and customs-sensitive products require manual review.",
    "The endpoint accepts requests for human review; it does not issue a binding rate, booking, or customs decision."
  ],
  "fallback": {
    "email": "mailto:helen@honourocean.com",
    "whatsapp": "https://wa.me/8618923724899"
  }
}