FBA 头程运价查询

按亚马逊 FBA 仓代码 + 重量查询头程运价。覆盖美西/美东主要 FBA 仓库，聚合多家服务商渠道，返回按总价升序排列的对外最终报价。2 积分/次。

接口信息

接口路径	POST /api/openapi/v1/freight/fba/search
积分消耗	2 积分 / 次
数据更新	每日更新
超时建议	客户端 timeout ≥ 3 秒

请求参数

字段名	类型	必填	说明	示例
fba_code	string	是	亚马逊 FBA 仓代码（4 位大写字母+数字）查代码 ↗	FTW1 / ONT8 / LAX9
weight	number	是	实际货重 kg（与 min_weight 取大作为计费重，最大 5000）	21.5
pol_code	string	否	起运港代码（限定港组，默认不限）查代码 ↗	CNSZX / CNGZG
goods_type	int	否	货物类型（默认 1，普货）	1

响应字段

字段名	类型	说明
resolved.fba_code	string	回显本次解析后的 FBA 仓代码（已大写规整）
list[]	array	渠道列表，按 total_amount 升序
list[].channel_name	string	渠道名称（对外展示名）
list[].fba_code	string	FBA 仓代码
list[].zip_code	string	FBA 仓库邮编
list[].pol_group	string	起运港组（如「华南港组」「华东港组」）
list[].min_weight	number	渠道最低计费重 kg（计费重 = max(weight, min_weight)）
list[].chargeable_weight	number	实际计费重 kg
list[].unit_price	number	对外单价 / kg
list[].total_amount	number	合计总价（unit_price × chargeable_weight）
list[].currency	string	币种（默认 CNY）
list[].tt	string	预计派送时效（如「25-30 天」）
list[].remarks	string	渠道备注（含尾程派送/关税方式/旺季/操作要求等，已合并多源用「/」分隔）
credit_used	int	本次扣减的积分数
credit_balance	int	扣减后剩余积分

完整 curl 请求示例

curl -X POST https://www.5688.cn/api/openapi/v1/freight/fba/search \
  -H "Content-Type: application/json" \
  -H "X-Awice-AppKey: AK_xxxxxxxxxxxxxxxx" \
  -H "X-Awice-Timestamp: 1746086400" \
  -H "X-Awice-Nonce: a1b2c3d4e5f6a7b8" \
  -H "X-Awice-Signature: 7f8e9d6c5b4a..." \
  -d '{
    "fba_code": "FTW1",
    "weight": 21.5,
    "pol_code": "CNSZX"
  }'

成功响应示例

{
  "code": 0,
  "msg": "success",
  "request_id": "req_xxxxxxxxxxxxxxxx",
  "data": {
    "resolved": { "fba_code": "FTW1" },
    "list": [
      {
        "channel_name": "美国 FBA 海派 - DDP",
        "fba_code": "FTW1",
        "zip_code": "76177",
        "pol_group": "华南港组",
        "min_weight": 21,
        "chargeable_weight": 21.5,
        "unit_price": 18.5,
        "total_amount": 397.75,
        "currency": "CNY",
        "tt": "25-30 天",
        "remarks": "含尾程派送 / 不含关税 / 旺季可能延期"
      }
    ]
  },
  "credit_used": 2,
  "credit_balance": 9498
}

空数据响应

当查询的 fba_code 暂无可用渠道时，返回空 list 数组。该情况仍会扣积分，建议在前置流程中提前用 FBA 仓库列表校验代码合法性。

{
  "code": 0,
  "msg": "success",
  "request_id": "req_xxxxxxxxxxxxxxxx",
  "data": {
    "resolved": { "fba_code": "XYZ9" },
    "list": []
  },
  "credit_used": 2,
  "credit_balance": 9498
}

注意事项：

FBA 仓代码须用 4 位大写字母+数字格式（FTW1/ONT8/LAX9 等），可在仓库列表查询
total_amount 已是对外最终报价，无需客户端再次乘以重量
min_weight 是渠道的最低计费门槛：若实重 21kg、min_weight 50kg，按 50kg 计费
pol_code 不传时默认覆盖所有港组（深圳/东莞/广州/中山华南港组为主）

下一步：基础数据字典