常用物流快递单号查询接口种类及对接方法
admin
2023-02-17 18:20:02
0次
目前快递查询接口有两种方式可以对接，一是和顺丰、圆通、中通、天天、韵达、德邦这些快递公司一一对接接口，二是和快递鸟这样第三方集成接口一次性对接多家常用快递。第一种耗费时间长，但是是直接和快递公司合作，第二种虽然是间接对接，但是对接简便，对后期的接口维护可以省很多时间和人力成本。
集成接口还有其他公司提供，有其他需要可以去找，快递鸟其实能满足电商、ERP系统商这些企业需求了。这里就以快递鸟为例说说对接方法。
快递鸟物流查询接口有免费和收费版本，对接周期大概在一天左右，他们有写好的demo，可以直接使用。
一.即时查询接口（免费）- 接口规则
(1)、查询接口支持按照运单号查询(单个查询，并发不超过10个/S)。
(2)、指定的物流运单号选择相应的快递公司编码，格式不对或则编码错误都会返失败的信息。如EMS物流单号应选择快递公司编码（EMS）
(3)、返回的物流跟踪信息按照发生的时间升序排列。
(4)、接口指令1002。
(5)、请求地址：快递鸟
- 系统级和应用级输入参数
3.返回结果参数
- 示例
{ "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118650888018" } //返回示例
//没有物流轨迹的 { "EBusinessID": "1109259", "Traces": [], "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118461988807", "Success": true, "Reason": null } //有物流轨迹的 { "EBusinessID": "1109259", "OrderCode": "", "ShipperCode": "SF", "LogisticCode": "118461988807", "Success": true, "CallBack":"", "State": , "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 }, { "AcceptTime": "2014/06/25 10:23:03", "AcceptStation": "派件已签收[深圳市]", "Remark": null }, { "AcceptTime": "2014/06/25 10:23:03", "AcceptStation": "签收人是：已签收[深圳市]", "Remark": null } ] }2.2接收接口
这个是用户在订阅单号成功且有物流轨迹更新后，快递鸟的推送 客户通过下单、订阅接口，把运单号在快递鸟系统订阅。运单物流信息有更新，快递鸟通过推送接口把更新的信息推送给客户。推送接口由用户按照快递鸟规则实现。商户开放接口，快递鸟定时将最新的物流轨迹推送到商户平台。
优点：客户不需要关注轨迹变化，一旦有更新，快递鸟自动推送。
缺点：对客户的服务器性能有所要求，快递鸟定时请求接口，对客户的服务器有一定的影响，客户服务器异常将接受不到最新数据。 快递鸟推送接口根据业务不同，会根据RequestType的分类推送不同的数据，用户需对推送的数据进行分类保存。原推送接口无需变化，快递鸟会根据推送版本进行推送。
- 接口规则
(1)、客户服务器必须稳定，并且有一定的接受数据能力（需要在5S内给快递鸟返回成功示例，超时会判断推送失败）。快递鸟通过多线程推送物流信息给客户。
(2)、客户需要按快递鸟要求开发接口，保证信息的正常接收。客户接数据后，存储并马上返回接收响应。如果客户对数据进行处理，再做出响应。这会造成网络超时，传输效率低下。 (3)、主动推送时物流信息接收接口由客户提供，接口必须按照快递鸟的要求实现。
(4)、客户提供接口地址，用户登陆用户管理后台-----调试平台-----推送接口进行测试---（成功返回示例后）才可以配置。
(5)、接口只支持Json数据格式。
(6)、POST方式请求。
示例：
//快递鸟请求接收接口示例
订阅查询结果示例：
{
"EBusinessID": "1109259",
"Count": "2",
"PushTime": "2015-03-11 16:21:06",
"Data": [
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "EMS",
"LogisticCode": "5042260908504",
"Success": true,
"Reason": "",
"State": "2",
"CallBack": "0",
"Traces": [
{
"AcceptTime": "2015-03-06 21:16:58",
"AcceptStation": "深圳市横岗速递营销部已收件，（揽投员姓名：钟定基;联系电话：）",
"Remark": ""
},
{
"AcceptTime": "2015-03-07 14:25:00",
"AcceptStation": "离开深圳市 发往广州市",
"Remark": ""
},
{
"AcceptTime": "2015-03-08 00:17:00",
"AcceptStation": "到达广东速递物流公司广航中心处理中心（经转）",
"Remark": ""
},
{
"AcceptTime": "2015-03-08 01:15:00",
"AcceptStation": "离开广州市 发往北京市（经转）",
"Remark": ""
},
{
"AcceptTime": "2015-03-09 09:01:00",
"AcceptStation": "到达北京黄村转运站处理中心（经转）",
"Remark": ""
},
{
"AcceptTime": "2015-03-09 18:39:00",
"AcceptStation": "离开北京市 发往呼和浩特市（经转）",
"Remark": ""
},
{
"AcceptTime": "2015-03-10 18:06:00",
"AcceptStation": "到达 呼和浩特市 处理中心",
"Remark": ""
},
{
"AcceptTime": "2015-03-11 09:53:48",
"AcceptStation": "呼和浩特市邮政速递物流分公司金川揽投部安排投递（投递员姓名：安长虹;联系电话：18047140142）",
"Remark": ""
}
]
},
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "EMS",
"LogisticCode": "5042260943004",
"Success": true,
"Reason": "",
"State": "2",
"CallBack": "0",
"Traces": [
{
"AcceptTime": "2015-03-07 15:26:09",
"AcceptStation": "深圳市横岗速递营销部已收件，（揽投员姓名：周宏彪;联系电话：13689537568）",
"Remark": ""
},
{
"AcceptTime": "2015-03-08 16:32:00",
"AcceptStation": "离开深圳市 发往广州市",
"Remark": ""
},
{
"AcceptTime": "2015-03-09 00:58:00",
"AcceptStation": "到达广东速递物流公司广航中心处理中心（经转）",
"Remark": ""
},
{
"AcceptTime": "2015-03-09 01:15:00",
"AcceptStation": "离开广州市 发往北京市（经转）",
"Remark": ""
},
{
"AcceptTime": "2015-03-10 05:20:00",
"AcceptStation": "到达北京黄村转运站处理中心（经转）",
"Remark": ""
},
{
"AcceptTime": "2015-03-10 11:59:00",
"AcceptStation": "离开北京市 发往廊坊市（经转）",
"Remark": ""
},
{
"AcceptTime": "2015-03-10 14:23:00",
"AcceptStation": "到达廊坊市处理中心（经转）",
"Remark": ""
},
{
"AcceptTime": "2015-03-11 08:55:00",
"AcceptStation": "离开廊坊市 发往保定市（经转）",
"Remark": ""
}
]
}
]
}
货款状态：
{
"EBusinessID": "1109259",
"Count": "2",
"PushTime": "2015/3/11 16:21:06",
"Data": [
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "EMS",
"LogisticCode": "5042260908504",
"Success": true,
"Reason": "",
"State": "2",
"CallBack": "0",
"OrderState":"1",
"AccountName":"张三",
"AccountTel":"13800000000",
"AccountNum":"0321"
},
{
"EBusinessID": "1109259",
"OrderCode": "",
"ShipperCode": "EMS",
"LogisticCode": "5042260908522",
"Success": true,
"Reason": "",
"State": "2",
"CallBack": "0",
"OrderState":"1",
"AccountName":"张三",
"AccountTel":"13800000011",
"AccountNum":"0321"
}
]
}
上一篇：移动APP开发的三种技术对比
下一篇：App二维码邀请的解决方案
相关内容
热门资讯
欧盟对俄制裁列单中企，中国驻欧...
问：2026年7月23日，欧盟通过第21轮对俄罗斯制裁方案，新增列单制裁中国企业。中方对此有何评论？...
特朗普预警9月政府“停摆”，美...
一国总统公开预警自家联邦政府即将“停摆”，这种魔幻剧情又双叒叕要在华盛顿上演？当地时间7月22日，特...
视频丨2026年APEC数字和...
昨天（23日），2026年亚太经合组织数字和人工智能部长会议在四川成都举行。本届会议的主题为“数字和...
海南商发二期发射区土建完工，建...
7 月 24 日消息，海南商发今日宣布，海南商业航天发射场二期发射区建设项目土建工作完成，全面转入设...
菲律宾，没有以色列的命，得了以...
菲律宾，马尼拉。美国国务卿鲁比奥来了。菲律宾期盼已久的“救星”来了。菲律宾认为的“阳光”来了。从机场...
服务器盛会东莞启幕，松山湖软硬...
7月23日至24日，“智算筑基 融链共赢——2026年服务器产业供需对接活动”在东莞举行。作为系列配...
面向6G通信、高端安检、精准医...
太赫兹作为“电磁波段最后一块未开垦之地”，近年在超快光电子、低尺度半导体技术的推动下，逐步从实验室走...
获得全球最高奖项的中国数学家，...
一个喜欢玩梗的二次元大佬，竟然站上了数学界最高荣誉的领奖台。他就是今年的菲尔兹奖得主之一，邓煜。另一...
单向空间杭州旗舰店8年后谢幕，...
去年12月，单向空间杭州乐堤港店员工回应闭店谣言，称“没有收到任何闭店通知”。不到一年，停止营业的消...
带娃家长刷不到下铺，算法不该把...
据新华社的报道，一位宝妈带4岁娃要从昭通去杭州南，在12306上购票时反复被分到上铺，一天内取消三次...