物流

物流相关接口

物流上传接口

物流上传接口

POST//unknown/openApi/V2022-03/logistics

Header parameters

Body

application/json

req

lcCodestring(50)

物流运输商代码；最大长度为50，如：TWTH

Example: "TWTH"

orderNostring(64)

商户订单号；当流水订单号为空时，则该字段时必须的；最小长度为1，最大长度为64，如：12167001000000000001

Example: 12167001000000000000

trackingNo*string(50)

物流单号；最小长度为2，最大长度为50，如：1223212312

Example: 1223212312

trackingWeb*string(200)

物流网址；最小长度为2，最大长度为200，如：https://abc.com

Example: "https://abc.com"

tradeNostring(64)

流水订单号；当商户订单号为空时，则该字段时必须的；最小长度为1，最大长度为64，如：2021092810011380477264

Example: "2021092810011380477264"

Response

200

OK

Body

*/*response body

codestring

返回码

Example: "00000"

data上传物流单号响应对象

上传物流单号响应对象

messagestring

返回信息

Example: "message info"

Request

JavaScriptCurlPython

const response = await fetch('//unknown/openApi/V2022-03/logistics', {
    method: 'POST',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "trackingNo": 1223212312,
      "trackingWeb": "https://abc.com"
    }),
});
const data = await response.json();

Response

200

{
  "code": "00000",
  "data": {
    "description": "uploadSuccess",
    "status": "success",
    "tradeNo": 2.0210928100113805e+21
  },
  "message": "message info"
}

物流上传接口请求报文示例

uploadLogistics.sh

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"
}'

结果对象属性描述

property name	type	description
code	String	响应码
message	String	响应信息
data	Object	数据体
tradeNo	String	交易流水号
status	String	上传结果状态码
description	String	上传结果信息描述

物流信息查询请求报文示例

logistics.sh

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' \

物流信息查询

GET//unknown/openApi/V2022-03/logistics/{tradeNos}

Path parameters

tradeNos*string

交易流水号，传入多个时英文逗号隔开，如：2021092810011380477264,2021092810011380477265

Header parameters

Response

200

OK

Body

*/*response body

codestring

返回码

Example: "00000"

dataarray of 物流信息响应对象

返回数据

messagestring

返回信息

Example: "message info"

Request

JavaScriptCurlPython

const response = await fetch('//unknown/openApi/V2022-03/logistics/{tradeNos}', {
    method: 'GET',
    headers: {
      "gateway-no": "text",
      "request-id": "text",
      "request-time": "text",
      "sign-info": "text"
    },
});
const data = await response.json();

Response

200

{
  "code": "00000",
  "data": [
    {
      "logisticsStatus": "Delivered",
      "tbLcCode": "TWTH",
      "trackingNo": 1223212312,
      "trackingWeb": "https://abc.com",
      "tradeNo": "2021092810011380477264"
    }
  ],
  "message": "message info"
}

结果对象属性描述

property name	type	description
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	交易流水号