快递查询

POST

/Ebusiness/EbusinessOrderHandle.aspx

（1）查询接口支持按照运单号查询(单个查询)。
（2）接口需要指定快递单号，格式不对或则编码错误都会返失败的信息。主流13家不需要选择快递公司编码，其他需要选择快递公司编码，查看快递公司编码。
（3）返回的物流跟踪信息按照发生的时间升序排列。
（4）接口指令8002。
（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。
（6）测试地址：http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json
（7）正式地址：https://api.kdniao.com/Ebusiness/EbusinessOrderHandle.aspx

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST 'http://prod-cn.your-api-server.com/Ebusiness/EbusinessOrderHandle.aspx' \
--header 'Content-Type: application/json' \
--data-raw '{
    "LogisticCode":"772004651594875"
}'

响应示例

成功示例（没有物流轨迹的）

{
  "LogisticCode": "7720046515948751",
  "Traces": [],
  "State": "0",
  "EBusinessID": "1470400",
  "Reason": "暂无轨迹信息",
  "Success": true
}

请求参数

Body 参数application/json

RequestData

string

必需

请求内容需进行URL(utf-8)编码。请求内容JSON格式，须和DataType一致。

EBusinessID

string

必需

商户ID，请在我的服务页面查看。

RequestType

string

必需

请求指令类型：1007

DataSign

string

必需

数据内容签名：把(请求内容(未编码)+AppKey)进行MD5加密，然后Base64编码，最后进行URL(utf-8)编码。详细过程请查看Demo。

DataType

string

可选

请求、返回数据类型：只支持JSON格式

OrderCode

string

订单编号

必需

CustomerName

string

可选

ShipperCode 为JD，必填，对应京东的青龙配送编码，也叫商家编码，格式：数字＋字母＋数字，9 位数字加一个字母，共10 位，举例：001K123450；ShipperCode 为SF，且快递单号非快递鸟渠道返回时，必填，对应收件人/寄件人手机号后四位；ShipperCode 为SF，且快递单号为快递鸟渠道返回时，不填；ShipperCode 为其他快递时，不填

ShipperCode

string

快递公司编码

可选

LogisticCode

string

物流单号

必需

示例

返回响应

🟢200成功

application/json

Body

EBusinessID

string

用户ID

必需

OrderCode

string

订单编号

必需

ShipperCode

string

快递公司编码

必需

LogisticCode

string

物流运单号

必需

Success

boolean

成功与否

必需

Reason

string

失败原因

必需

State

string

必需

物流状态：0-暂无轨迹信息,1-已揽收,2-在途中,3-签收,4-问题件

StateEx

string

必需

增值物流状态： 0-暂无轨迹信息 1-已揽收 2-在途中 201-到达派件城市, 202-派件中, 211-已放入快递柜或驿站, 3-已签收 301-正常签收, 302-派件异常后最终签收, 304-代收签收, 311-快递柜或驿站签收, 4-问题件 401-发货无信息, 402-超时未签收, 403-超时未更新, 404-拒收(退件), 405-派件异常, 406-退货签收, 407-退货未签收, 412-快递柜或驿站超时未取

Location

string

所在城市

必需

Traces

array [object {5}]

必需

Action

string

必需

当前状态(同StateEx)

AcceptStation

string

描述

必需

AcceptTime

string

时间

必需

Location

string

所在城市

必需

Remark

string

备注

必需

应用场景/功能说明/使用流程