顺丰快递单号查询API开发指南-快递鸟

news/2024/11/23 2:28:13/

一、接口描述/说明

（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

请求系统级参数说明：

二、接口参数

请求内容字段定义：

返回参数定义：

三、示例

请求示例 JSON

{"LogisticCode":"772004651594875"
}

返回示例 JSON

没有物流轨迹的
{"LogisticCode":"7720046515948751","Traces":[],"State":"0","EBusinessID":"1470400","Reason":"暂无轨迹信息","Success":true
}有物流轨迹的
{"StateEx":"2","LogisticCode":"3103630045838","ShipperCode":"YD","Traces":[{"Action":"1","AcceptStation":"【深圳市】广东深圳公司中心分拨分部 已揽收","AcceptTime":"2020-06-17 03:31:04","Location":"深圳市"},{"Action":"2","AcceptStation":"【深圳市】已离开 广东深圳公司中心分拨分部；发往 上海分拨中心","AcceptTime":"2020-06-17 03:34:08","Location":"深圳市"},{"Action":"2","AcceptStation":"【深圳市】广东深圳公司 已揽收","AcceptTime":"2020-06-17 03:37:46","Location":"深圳市"},{"Action":"2","AcceptStation":"【深圳市】已到达 广东深圳公司","AcceptTime":"2020-06-17 08:02:33","Location":"深圳市"},{"Action":"2","AcceptStation":"【深圳市】已离开 广东深圳公司；发往 上海分拨中心","AcceptTime":"2020-06-17 08:11:33","Location":"深圳市"},{"Action":"2","AcceptStation":"【深圳市】广东深圳公司福田区水围站分部 已揽收","AcceptTime":"2020-06-17 09:22:25","Location":"深圳市"}],"State":"2","EBusinessID":"1470400","Success":true,"Location":"深圳市"

四、接入流程