快递API物流轨迹查询接口接入表

admin管理员组

文章数量:1530846

2023年12月18日发(作者：)

快递鸟API接口对接流程

填写用户信息登记表

发送到

service@kdni

签订合作协

（商务+产品+技术）

成立项目小组

物流数据需求

（提供需求快递公司列表以及对应测试单号）

对接方案

（双方技术负责人沟通确定）

接口对接

接口核验

提供编码对照表

技术支持

QQ群：200121393

双方配合流程

用户流程

快递鸟流程

用户信息登记表

注：提供真实而准确的数据将有助于我们为您提供更优的数据服务方案以及资源配置。

我们承若，对数据绝对的保密。

用户基本信息

快递鸟账号

公司名称

项目负责人

商务对接联系人信息

姓名

职务

技术对接联系人信息

姓名

职务

QQ

联系电话

QQ

联系电话

邮箱

网址

公司地址

联系方式

产品对接联系人信息

姓名

职务

邮箱

QQ

联系电话

邮箱

数据服务接口需求

使用方式 口 电商网站 口 ERP软件 口 仓储软件 口 其他

口 页面展示 口 异常件提醒 口 签收提醒 口 妥投率统计 口 揽收情况统计

使用场景 口 快递时效统计 口 快递线路优化 口 快递取件通知 口 打印电子面单

口 其他

口 轨迹查询服务（提供物流轨迹数据的即时查询接口，含跨境与国际快递轨迹查询。）

接入功能 口 轨迹订阅推送（提供物流轨迹数据的推送接口服务，同时推送物流轨迹状态及轨迹信息。）

口 在线下单与订阅 （提供在线发快递数据的接口，将快递订单分发给附近快递员，同时订阅单号。）

口 电子面单与订阅 （支持多家快递在线打印电子面单的接口服务，同时订阅单号。）

最近一月发货情况

日均发货量

订单峰值时段

日均订单量

数据统计周期

2015.10.7-2015.11.6

口 顺丰 口 EMS 口 中通 口 申通 口 汇通 口 圆通 口 韵达 口 邮政

合作快递公司

口 DHL 口 UPS 口 TNT 口 FedEX 口 EMS国际 口 国际邮政小包

口 其他

目前物流接口提供口 有 口 无

商

代收货款及金融服务需求

代收货款订单客单日均代收货款单量

价

代收货款最高单价 数据统计周期

省内： 口 广东省 口 上海 口 浙江省 口 北京 口 其他

代收货款订单

全国： 口 广东-全国 口 上海-全国 口 浙江-全国 口 北京-全国

收派区域分布情况

口 其他

目前代收货款使用口 优速 口 顺丰 口 速尔 口 龙邦 口 其他

的快递公司

代收货款返款方式

代收货款返款周期

目前使用的支付方口 现金 口 转账

口 T+3 口 T+5 口 T+7 口 月结

口 货到付款 口 支付宝 口 微信 口 银联 口 其他

式

目前平台日交易流口 0-50万 口 50-100万 口 100-200万 口 200-500万 口 500万以上

量

物流数据需求表

说明：取最近30天的数据。提供真实而准确的数据，快递鸟进行接口核验并根据实际需求配置相关资源，并提供对应的快递公司编码。

物流公司

(根据实际情况完善)

平均日单量（件） 最高日单量（件）

实际单号

（每个快递提供至少5个单号）

发货高峰时间段

总量

EMS

申通

快递

圆通

韵达

快运

中通

速递

汇通

快运

天天

快递

156500

22500

332300 16:00-20:00

75000 02，02，02，02 16:00-20:00

顺丰

速运

邮政

小包

***

***

***

***

***

***

***

***

***

对接方案

说明：根据订单量、用户场景的不同，选择最优对接方案。

方案一

日订单量

对接方案

方案说明

适用对象

<3000单

即时查询接口

应用场景 打开“我的订单”展示物流信息

根据快递单号和快递公司编码实时查询物流轨迹信息(支持所有快递单号)

电商网站、微商城、生活工具

方案二（推荐方案）

日订单量

对接方案

方案说明

>3000单

订阅推送接口

应用场景 异常件提醒、签收提醒、统计妥投率、统计揽收情况

快递鸟系统会时推送新的物流信息到用户系统。

适用对象 电商ERP、仓储系统、清关公司、网站管理后台

方案三

异常件提醒、签收提醒、统计妥投率、统计揽收情况、电子日订单量 >3000单 应用场景

面单打印、取件通知

对接方案 电子面单+订阅推送接口

1、通过快递鸟电子面单接口直接打印对应快递公司电子面单，同时订阅单号信息。

方案说明

2、快递鸟定时推送新的物流信息到用户系统。

适用对象 电商ERP、仓储系统、清关公司、网站管理后台

方案四

异常件提醒、签收提醒、统计妥投率、统计揽收情况、快递日订单量 >3000单 应用场景 时效统计、线路优化、电子面单打印、取件通知、在线发快递

对接方案 在线下单+电子面单+订阅推送接口

1、发货的同时，将快递需求推送到附近的快递员，通知快递上门取件，并将对应反馈信息（快递员信息）推送给用户。

方案说明

2、通过快递鸟电子面单接口直接打印对应快递公司电子面单，同时订阅单号信息。

3、快递鸟定时推送新的物流信息到用户系统。

适用对象

电商ERP、仓储系统、清关公司、网站管理后台

快递鸟通讯录

商务对接联系人信息

姓名 QQ

手机

职务

邮箱

技术对接联系人信息

姓名 QQ

手机

职务

邮箱

产品对接联系人信息

姓名 QQ

手机

职务

邮箱

对接常见问题

说明：接口对接

1、如何申请快递鸟APIKey？别的网站可以用我的key吗？

请通过快递鸟（）官网申请服务，一个Key原则上只对接问题

能用于一个网站或软件，如果您有多个网站，建议分开来进行申请。另外，为了您的利益，请妥善保管您的Key，勿向他人或其他组织

透露。对于已被盗用的Key，我们将会作禁用处理。

2、接口支持什么语言？

答：快递鸟接口适用于任何开发语言

3、有没有相关的demo？

答：快递鸟提供PHP、java、语言DEMO工具，请前往/下载

4、订阅推送可以指定多台接收服务器吗？

答：一个用户ID只能对应一台推送服务器，如需配置多台，可注册多个ID并提交快递鸟研发人员进行资源配置

5、即时查询接口有没有限制查询次数？

答：即时查询接口日查询次数不超过3000，如每日单量>3000，

或有其他特殊需求，建议对接订阅接口

6、订阅推送订阅最高支持多少并发？

答：快递鸟订阅服务器支持单次并发3000个，为保障资源的合理利用，快递鸟开放给订阅用户默认限制并发为30个请求/秒。

1、为什么有些邮政单号查不到物流信息？

答：首先，确认单号所属物流公司，并前往对应快递公司官网确认单号可用。

然后，确认请求调用的对应物流编码正确无误。

如：邮政小包对应编码YZPY，EMS对应编码EMS。

2、快递公司那边已经签收了，为什么快递鸟推送的内容还是派件中接口问题

状态？

答：首先，确认接收接口是否可以正常访问。然后，确认接口是否能承受压力，导致接收信息响应时间过长，影响推送的效率。

3、快递公司那边已经更新了，为什么即时查询接口的数据没更新？

答：首先，确认单号所属物流公司，确认快递鸟是否支持该物流公司的物流信息查询。然后，确认调用参数格式。

联合调试

调试内容：双方基础通讯性能基准测试、订阅调试、推送调试

说明：联合调试旨在双方在调通接口后，通过多次调试与参数优化，最大程度的发挥通讯性能与数据处理效率，为日后持续稳定运行与降低双方维护成本打好良好的基础。

用户负责人 手机 QQ

快递鸟负责

人

基准测试

联调时间 调试单量 执行人

手机 QQ

由用户方发起请求，持续调用快递鸟基准测试服务器指定接口(次数根据用户方日均单量与出口性能

促销单量决定)，我方根据接收数据情评估用户方性能是否满足我方接入要求

如果用户方接入快递鸟订阅推送接口，则需要由快递鸟发起请求，持续调用用户方接收接接收性能 口(次数根据用户方日均单量与促销单量决定)，记录总用时及成功率，并评估用户方接收性能是否满足我方接入要求

评估结果

解决方案

第1次联调

联调时间 调试单量 执行人

订阅频率：*个订阅线程，每秒并发**个请求，每个请求**个单号

联调方案 推送频率：*个推送线程，每秒并发**个请求，每个请求**个单号

推送类型：全量推送

调试结果

优化方案

下次联调时

间

第2次联调

联调时间 调试单量 执行人

订阅频率：*个订阅线程，每秒并发**个请求，每个请求**个单号

联调方案 推送频率：*个推送线程，每秒并发**个请求，每个请求**个单号

推送类型：只推送问题件及签收件

调试结果

优化方案

下次联调时

间

第3次联调

联调时间

联调方案

调试结果

优化方案

下次联调时

间

调试单量 执行人

本文标签： 快递接口推送