版本:202506
查询可用物流线路
POST/openapi/2025-06/shipping-lines/available-lines
获取指定订单和地址可用的物流方案列表。
请求
- application/json
- 请求体
- 示例
请求体必填
- 传入具体省份编码(如
GB-ENG),或 - 传入
ALL,或 - 传入
zip(邮编),系统会根据邮编前缀自动推导省份编码
order_idstring必填
订单 ID
country_codestring必填
国家代码(如 CN)
province_codestring
省份代码。传 ALL 可匹配所有省份(大多数国家的默认行为)。
英国 (GB) 特殊处理: 由于英格兰 (GB-ENG)、苏格兰 (GB-SCT)、威尔士 (GB-WLS)、北爱尔兰 (GB-NIR) 各地区运费差异较大,留空将无法匹配任何运费方案。必须:
zipstring
邮政编码。对于英国 (GB) 地址,当未提供 province_code 时,系统会根据邮编前缀自动推导省份编码
{
"order_id": "string",
"country_code": "string",
"province_code": "string",
"zip": "string"
}
响应
- 200
OK
- application/json
- 数据结构
- 示例
数据结构
- Array [
- ]
codestring
错误码
messagestring
错误信息
data object
shipping_lines object[]
运费行列表
delivery_methodint32
配送方式类型:1 表示快递配送,2 表示本地配送
descstring
配送线路描述
idstring
配送 ID
location_idstring
位置 ID
namestring
名称
plan_codestring
套餐代码
shipping_pricestring
运费金额
support_codint32
是否支持货到付款(COD)
invalid_productsstring[]
无效商品列表
messagestring
第三方计费失败原因
statestring
业务状态码:success(成功)、empty_plan(国家或省份无匹配方案)、empty_shipping_plan(未命中配送方案条件)、invalid_product(商品已被移除)
{
"code": "string",
"message": "string",
"data": {
"shipping_lines": [
{
"delivery_method": 0,
"desc": "string",
"id": "string",
"location_id": "string",
"name": "string",
"plan_code": "string",
"shipping_price": "string",
"support_cod": 0
}
],
"invalid_products": [
"string"
],
"message": "string",
"state": "string"
}
}