国际运费估算 API

POST /v1/fulfillment/shipments/freight/estimate — 轻量计算器；金额为参考价。

可与 发货预览 对比（入库后的精确价格）。

估算 vs 预览

freight/estimatepreview
时机入库前 / 无入库包裹包裹已在仓库
输入国家/邮编 + 重量/尺寸parcel_nos[] + 完整收件人 + 渠道
输出quotes[] 参考价格单个 freight / services / total

请求体

{
  "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）。