国际运费估算 API

POST /v1/fulfillment/shipping/quotes — 轻量计算器；金额为参考价。

兼容别名： POST /v1/fulfillment/shipments/freight/estimate（行为相同，建议新集成使用本路径）。

报价为参考价。包裹入库后 创建发货单 会返回精确运费。

估算 vs 创建

请求体

{
  "destination": {
    "country_code": "US",
    "region": "California",
    "postal_code": "90001"
  },
  "weight_kg": 2.05,
  "length_cm": 30,
  "width_cm": 20,
  "height_cm": 10,
  "attributes": [
    "general"
  ]
}

• weight_kg 和/或 length_cm + width_cm + height_cm（至少提供一组）
• 可选 attributes[]（如 general、battery）
• 无需 parcel_nos，无需完整街道地址

响应

quotes[] 包含 shipping_channel_code、shipping_channel_name、freight、total（分）。字段说明见 响应模型。

商品属性 {#item-attributes}

GET /v1/fulfillment/shipments/item-attributes — 估算接口可用的 attributes[] 编码（如 general、battery）。