物流信息

物流上传接口

物流上传接口

POST//unknown/openApi/logistics

Authorization

Authorization

Query parameters

Header parameters

Response

200

OK

Body

*/*response body

dataUploadResp

上传响应对象

resultResult

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//unknown/openApi/logistics?trackingWeb=text', {
    method: 'POST',
    headers: {
      "authorization": "text",
      "request-id": "text",
      "request-time": "text"
    },
});
const data = await response.json();

Response

200

{
  "data": {
    "resultCode": "0000",
    "resultMessage": "SUCCESS",
    "tradeNo": 2.0210928100113805e+21
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

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

uploadLogistics.sh

curl --request POST \
  --url https://{openApiUrl}/openApi/logistics \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'request-id: 58675' \
  --header 'request-time: 2022-05-21T23:59:59' \
  --header 'authorization:Bearer 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822' \
  --data 'merNo=12345&gatewayNo=12345001&tradeNo=2022042617331600244628&orderNo=20220426173311&trackingNo=7442543666&trackingWeb=www.yimei.com&lcCode=aCommerce'

物流上传接口

物流上传接口

POST//unknown/openApi/logistics

Authorization

Authorization

Query parameters

Header parameters

Response

200

OK

Body

*/*response body

dataUploadResp

上传响应对象

resultResult

Request

JavaScriptCurlPythonHTTP

const response = await fetch('//unknown/openApi/logistics?trackingWeb=text', {
    method: 'POST',
    headers: {
      "authorization": "text",
      "request-id": "text",
      "request-time": "text"
    },
});
const data = await response.json();

Response

200

{
  "data": {
    "resultCode": "0000",
    "resultMessage": "SUCCESS",
    "tradeNo": 2.0210928100113805e+21
  },
  "result": {
    "code": "text",
    "message": "text"
  }
}

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

logistics.sh

curl --request GET\
  --url https://{openApiUrl}/openApi/logistics/2022051618185700208077 \
  --header 'request-id: 58675' \
  --header 'request-time: 2022-05-21T23:59:59' \
  --header 'authorization:Bearer 787966BF2479A1BE8E1886CD18E6919447FAF4F357E7056188D4F035661B822' \

结果对象属性描述

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

物流信息查询

GET//unknown/openApi/logistics/{tradeNos}

Authorization

Authorization

Path parameters

tradeNos*string

交易流水号（多笔时以逗号 , 分割）;最小长度为1，最大长度为2500，如：2021050715591893808753,2021050715591893808723

Header parameters

Response

200

OK

Body

*/*response body

dataarray of TrackingNoBillsDto

resultResult

Request

JavaScriptCurlPythonHTTP

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

Response

200

{
  "data": [
    {
      "gatewayNo": 0,
      "logisticsStatus": "text",
      "merNo": 0,
      "orderNo": "text",
      "tbLcCode": "text",
      "trackingNo": "text",
      "trackingWeb": "text",
      "tradeNo": "text"
    }
  ],
  "result": {
    "code": "text",
    "message": "text"
  }
}

结果对象属性描述

property name	type	description
result	Object	请求响应对象
code	String	响应码
message	String	响应信息
data	Object	数据体
merNo	Integer	商户号
gatewayNo	Integer	网关号
logisticsStatus	String	物流状态，Pending待查询、NotFound 查询不到 、InfoReceived 预报发货 、InTransit 运输途中 、ArrivedDelivery 到达待取 、Delivering 派送途中、Delivered 成功派送、Exception 包裹异常、DeliveryFailure 投递失败、Return 包裹退回
tbLcCode	String	物流运输商编号
trackingNo	String	物流单号
trackingWeb	String	物流网址
tradeNo	String	交易流水号