获取面单
场景说明
在订单已预报状态时可以返回订单面单标签数据,当返回的响应码为 202 时,表示订单正在预报物流中,需要等待预报物流完成之后才有跟踪号信息
接口名
{域名}/api/svc/getLabel
请求方式
POST
Header请求头
参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|
Authorization | 是 | string | 授权码:访问授权 Token |
请求参数
参数名 | 二级参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|---|
reference_no | 否 | string | 参考号 订单号与参考号传其一即可 | |
order_code | 否 | string | 订单编号 订单号与参考号传其一即可 |
输入示例(body)
{
"order_code": "XXXXXX",
"reference_no":"XXXXXX"
}
返回参数
参数名 | 二级参数名 | 是否必填 | 类型 | 说明 |
---|---|---|---|---|
code | - | 是 | string | 响应码,200-成功 |
result | - | 是 | object | 响应结果 |
msg | - | 是 | string | 响应消息 |
-result | reference_no | 是 | string | 参考号, 用户传入的客户订单号 |
-result | order_code | 是 | string | 订单号, 我司系统唯一单号 |
-result | order_address_type | 是 | string | Commercial 商业 Residential 住宅 |
-result | order_status | 是 | integer | 订单状态, 2 已预报 1已提交 3.已预报 4问题件 |
-result | order_sub_status | 是 | integer | |
-result | order_waiting_status | 是 | integer | |
-result | sync_service_status | 是 | integer | |
-result | logistics_err | 是 | string | 错误信息 |
-result | labels | 是 | array | 面单信息 |
-result.labels | tracking_number | 是 | string | 物流单号 |
-result.labels | tracking_number2 | 否 | string | 物流单号, UPS MI时产品返回USPS单号,其余产品不返回 |
-result.labels | label_url | 否 | string | 面单地址 |
-result.labels | file_type | 否 | string | 面单类型 |
-result | fee | 是 | array | 总费用信息 |
-result.fee | ft_code | 是 | string | 费用英文名称 |
-result.fee | amount | 是 | string | 金额 |
-result.fee | currency_code | 是 | string | 币种 |
-result.fee | ft_name | 是 | string | 费用中文名称 |
-result | fee_detail | 是 | array | 费用详情 |
-result.fee_detail | ft_code | 是 | string | 费用英文名称 |
-result.fee_detail | amount | 是 | string | 金额 |
-result.fee_detail | tracking_number | 是 | string | 物流单号 |
-result.fee_detail | box_code | 是 | string | 箱号 |
-result.fee_detail | currency_code | 是 | string | 币种 |
-result.fee_detail | ft_name | 是 | string | 费用中文名称 |
输出示例
{
"code": 200,
"result": {
"reference_no": "XXXXXX",
"order_code": "XXXXXX",
"order_address_type": "Commercial",
"order_status": 2,
"order_sub_status": 0,
"order_waiting_status": 0,
"sync_service_status": 1,
"logistics_err": "",
"labels": [
{
"tracking_number": "XXXXXX",
"tracking_number2": "XXXX",
"label_url": "http://XXXX.pdf",
"file_type": "pdf"
}
],
"merge_label": "http://XXXXXX.pdf",
"fee": [
{
"ft_code": "shipping",
"amount": "1.00",
"currency_code": "USD",
"ft_name": "运费"
},
{
"ft_code": "FSC",
"amount": "0.01",
"currency_code": "USD",
"ft_name": "燃油附加费"
}
],
"fee_detail": [
{
"ft_code": "shipping",
"amount": "1.00",
"tracking_number": "XXXXXX",
"box_code": "XXXXXX-1",
"currency_code": "USD",
"ft_name": "运费"
},
{
"ft_code": "FSC",
"amount": "0.01",
"tracking_number": "XXXXXX",
"box_code": "XXXXXX-1",
"currency_code": "USD",
"ft_name": "燃油附加费"
}
]
},
"msg": "Success"
}