零售电商平台及ISV商家对物流api接口的需求有很多,今天我们主要分享的就是快递鸟快递单号查询接口的对接指南,快递单号查询接口对接的应用场景有很多,很多场景会遇到,最主要的就是电商网站用户打开“我的订单”时调用此API显示物流信息详情,电商管理后台的物流系统,客服在对账前查询所有运单的签收状态,并追踪问题,电商平台对商家物流管控,要求必须在多久快递必须发出要看到揽件状态,多久必须收到货物看到签收状态,根据这些状态对商家管控从而提高用户的整体满意度。
调用快递鸟快递单号查询API接口,就能查询到1600多家以上快递公司单号从收件、运输,到转运中心,派送到签收等各个环节的物流发货状态。快递鸟api接口不区分开发语言,支持Java,C#,PHP,Python,ObjectC等开发语言的程序调用。下面具体讲解实现过程:
对接使用流程
1、将快递单号和快递公司编码发送給快递鸟
2、快递鸟根据单号和快递公司查询到物流轨迹状态
3、快递鸟将查询到的物流轨迹状态反馈給电商平台或ISV服务商
4、电商平台或ISV服务商接收数据并实时处理做数据展示或应用
接口描述说明
(1)查询接口支持按照运单号查询(单个查询)。 (2)接口需要指定快递单号的快递公司编码,格式不对或则编码错误都会返失败的信息。 如:EMS物流单号应选择快递公司编码(EMS)查看下载快递鸟快递公司编码(快递鸟官网联系我们的在线客服)(3)返回的物流跟踪信息按照发生的时间升序排列。 (4)接口指令1002。 (5)接口支持的消息接收方式为HTTP POST,请求方法的编码格式(utf-8):"
application/x-www-form-urlencoded;charset=utf-8"。 (6)测试调用地址:http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json (7)正式调用地址:http://api.kdniao.com/api/dist(8)快递鸟官网地址:【快递鸟API】-快递单号查询接口-快递电子面单-全球物流数据服务商
(9)返回类型:JSON
(10)调试页面:
http://kdniao.com/UserCenter/v2/SandBox/TrackQuery.aspx
(11)调试工具:去调试(使用快递鸟账号登录)
请求系统级参数说明:
备注:R-必填(Required),O-可选(Optional),C-报文中该参数在一定条件下可选(Conditional)
【接口参数】
请求内容字段定义:
返回参数定义:
示例
请求示例 JSON
{
“OrderCode”: “”,
“ShipperCode”: “SF”,
“LogisticCode”: “118650888018”
}
返回示例 JSON
没有物流轨迹的
{
“EBusinessID”: “1109259”,
“Traces”: [],
“OrderCode”: “”,
“ShipperCode”: “SF”,
“LogisticCode”: “118461988807”,
“Success”: false,
“Reason”: null
}
有物流轨迹的
{
“EBusinessID”: “1109259”,
“OrderCode”: “”,
“ShipperCode”: “SF”,
“LogisticCode”: “118461988807”,
“Success”: true,
“State”: 3,
“Reason”: null,
“Traces”: [
{
“AcceptTime”: “2014/06/25 08:05:37”,
“AcceptStation”: “正在派件…(派件人:邓裕富,电话:18718866310)[深圳 市]”,
“Remark”: null
},
{
“AcceptTime”: “2014/06/25 04:01:28”,
“AcceptStation”: “快件在 深圳集散中心 ,准备送往下一站 深圳 [深圳市]”,
“Remark”: null
},
{
“AcceptTime”: “2014/06/25 01:41:06”,
“AcceptStation”: “快件在 深圳集散中心 [深圳市]”,
“Remark”: null
},
{
“AcceptTime”: “2014/06/24 20:18:58”,
“AcceptStation”: “已收件[深圳市]”,
“Remark”: null
},
{
“AcceptTime”: “2014/06/24 20:55:28”,
“AcceptStation”: “快件在 深圳 ,准备送往下一站 深圳集散中心 [深圳市]”,
“Remark”: null