物流
物流相关接口
物流上传接口
网关号
请求id,30分钟之内唯一
时间戳,以毫秒(ms)为单位,请求误差不能超过10分钟
验签字段,具体加签方式请参阅数据签名过程章节
物流单号上传对象
物流运输商代码;最大长度为50,如:TWTH
TWTH
商户订单号;当流水订单号为空时,则该字段时必须的;最小长度为1,最大长度为64,如:12167001000000000001
12167001000000000000
物流单号;最小长度为2,最大长度为50,如:1223212312
1223212312
流水订单号;当商户订单号为空时,则该字段时必须的;最小长度为1,最大长度为64,如:2021092810011380477264
2021092810011380477264
POST /openApi/V2022-03/logistics HTTP/1.1
Host: {openapiurl}
gateway-no: null
request-id: null
request-time: null
sign-info: null
Content-Type: application/json
Accept: */*
Content-Length: 139
{
"lcCode": "TWTH",
"orderNo": 12167001000000000000,
"trackingNo": 1223212312,
"trackingWeb": "https://abc.com",
"tradeNo": "2021092810011380477264"
}
OK
{
"code": "00000",
"data": {
"description": "uploadSuccess",
"status": "success",
"tradeNo": 2.0210928100113805e+21
},
"message": "message info"
}
物流上传接口请求报文示例
curl --request POST \
--url https://{openApiUrl}/openApi/V2022-03/logistics \
--header 'Content-Type: application/json' \
--header 'request-id: 58675' \
--header 'request-time: 1651888520935' \
--header 'gateway-no: 12345001' \
--header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \
--data '{
"lcCode": "aCommerce",
"orderNo": "NEW_API1213244582639",
"trackingNo": "7735609666",
"trackingWeb": "www.hinlc.com",
"tradeNo": "2022051810582957553787"
}'
结果对象属性描述
code
String
响应码
message
String
响应信息
data
Object
数据体
tradeNo
String
交易流水号
status
String
上传结果状态码
description
String
上传结果信息描述
物流信息查询请求报文示例
curl --request GET\
--url https://{openApiUrl}/openApi/V2022-03/logistics/2022051618185700208077 \
--header 'request-id: 58675' \
--header 'request-time: 1651888520935' \
--header 'gateway-no: 12345001' \
--header 'sign-info: 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822B' \
交易流水号,传入多个时英文逗号隔开,如:2021092810011380477264,2021092810011380477265
网关号
请求id,30分钟之内唯一
时间戳,以毫秒(ms)为单位,请求误差不能超过10分钟
验签字段,具体加签方式请参阅数据签名过程章节
GET /openApi/V2022-03/logistics/{tradeNos} HTTP/1.1
Host: {openapiurl}
gateway-no: null
request-id: null
request-time: null
sign-info: null
Accept: */*
OK
{
"code": "00000",
"data": [
{
"logisticsStatus": "Delivered",
"tbLcCode": "TWTH",
"trackingNo": 1223212312,
"trackingWeb": "https://abc.com",
"tradeNo": "2021092810011380477264"
}
],
"message": "message info"
}
结果对象属性描述
code
String
响应码
message
String
响应信息
data
Object
数据体
logisticsStatus
String
物流状态,Pending待查询、NotFound 查询不到 、InfoReceived 预报发货 、InTransit 运输途中 、ArrivedDelivery 到达待取 、Delivering 派送途中、Delivered 成功派送、Exception 包裹异常、DeliveryFailure 投递失败、Return 包裹退回
tbLcCode
String
物流运输商编号
trackingNo
String
物流单号
trackingWeb
String
物流网址
tradeNo
String
交易流水号
Last updated