快递100-快递信息查询订阅推送/跟踪API接口案例代码

网友投稿 978 2022-05-30

一、订阅接口

1.1 订阅请求地址

https://poll.kuaidi100.com/poll

1.2 订阅请求类型

post

1.3 订阅输入参数

请求参数(header)

请求参数(body)

1.4 订阅请求参数示例

schema = json param = { "company": "ems", "number": "1136281381675", "from": "广东省深圳市南山区", "to": "北京市朝阳区", "key": "XXX ", "parameters": { "callbackurl": "您的回调接口的地址,如http://www.您的域名.com/kuaidi?callbackid=...", "salt": "XXXXXXXXXX", "resultv2": "1", "autoCom": "1", "interCom": "1", "departureCountry": "CN", "departureCom": "ems", "destinationCountry": "JP", "destinationCom": "japanposten" } }

1.5 订阅返回信息代码含义

result: true表示成功,false表示失败

1.6 订阅返回示例(JSON格式)

{ "result": true, "returnCode": "200", "message": "提交成功" }

二、推送接口

2.1 推送请求地址

由贵司在订阅请求中通过callbackurl字段提供

2.2 推送请求类型

post

快递100-快递信息查询订阅推送/跟踪API接口案例代码

2.3 推送输入参数

请求参数(header)

请求参数(body)

2.4 推送输入参数示例

param = { "status": "polling", "billstatus": "got", "message": "", "autoCheck": "1", "comOld": "yuantong", "comNew": "ems", "lastResult": { "message": "ok", "state": "0", "status": "200", "condition": "F00", "ischeck": "0", "com": "yuantong", "nu": "V030344422", "data": [ { "context": "上海分拨中心/装件入车扫描 ", "time": "2012-08-28 16:33:19", "ftime": "2012-08-28 16:33:19", "status": "在途", "areaCode": "310000000000", "areaName": "上海市" }, { "context": "上海分拨中心/下车扫描 ", "time": "2012-08-27 23:22:42", "ftime": "2012-08-27 23:22:42", "status": "在途", "areaCode": "310000000000", "areaName": "上海市" } ] }, "destResult": { "message": "ok", "state": "0", "status": "200", "condition": "F00", "ischeck": "0" , "com": "speedpost", "nu": "EX015142583SG", "data": [ { "context": "[01000]Final delivery Delivered to: SLOVESNOV", "time": "2016-05-24 14:00:00", "ftime": "2016-05-24 14:00:00", "status": "签收", "areaCode": null, "areaName": null } ] } }

2.5 运单签收状态服务说明

2.6 推送响应报文及错误码解释

2.7 推送返回示例

当我方调用贵方的回调接口(callbackurl)时,贵方需要先将我方提交的数据保存至贵方的数据库,接着向我方返回是否成功接收的响应报文及代码,即贵公司直接在回调接口的地址的response中填写如下内容:

{ "result":true, "returnCode":"200", "message":"成功" }

注意:对于status= abort(message中包含“3天查询无记录”或者“60天无变化”)的快递单,也需要返回成功接收的响应报文及代码。

三、快递公司编码

下载表格

四、demo下载

JAVA示例代码

PHP示例代码

PYTHON示例代码

.NET示例代码

一、快递信息推送API产品介绍

快递100信息推送服务提供运单查询、追踪的功能,用于企业对寄出的物品进行物流追踪。

信息推送服务是企业提交快递单号,快递100接收到后便对这些运单进行跟踪,当运单状态发生变化的时候,快递100便通过调用回调接口将运单的跟踪信息推送给贵公司,直到这些运单号的生命周期结束(一般以“已签收”为准)。对于某个单号,当贵方正确提交订阅了后,我们一般会在15分钟左右后进行第一次监控,如果监控到单号本身有了跟踪信息,即进行第一次推送,否则等待下一次监控。此后我们一般每4小时进行一次监控,并会根据单号的状态等因素作调整。

二、快递信息推送API应用场景

让顾客登录您的网站、APP、小程序后,直接在“我的订单”页面内就能看到订单的物流状态。

能开发自动的、批量查单功能,自动筛选出“已签收”、“疑难件”等状态的单号,减轻跟单人员的压力。

改变订单的状态与交易流程,例如只要运单号变为“已签收”,就能让订单变更为可以确认退换货等。

核销销售人员,根据“已签收”的运单数,就能算出销售人员的业绩。

评估与选择快递公司,可获得快递实际在途时间,评估快递公司的时效,优化快递选择;

助结算运费,找出“已签收”的单及签收时间,便能轻松应对货到付款的结算与对账。

三、系统结构与流程

四、快递信息推送API费用结算

1. 收费方式

快递信息推送接口属于查询类接口,企业注册快递100账号后可以在企业管理后台查看查询类接口套餐查看查询类接口套餐并购买。

2. 收费价格

查询类接口预充值收费套餐:充值即可开通使用,无需合同流程。

查询类接口按单收费,一个自然月内同一个运单多次查询只收一次费用。

3. 开具发票

快递100支持开具增值税发票,用户购买完成后可在企业管理后台-费用中心-支付记录-请求开票。默认开具电子增值税普通发票,1000元以上可支持开具增值税专用发票。

官方源文档:

https://api.kuaidi100.com/document/5f0ffa7f2977d50a94e1023b.html

https://api.kuaidi100.com/document/5eb9f79186b0df4188313a0d.html

https://api.kuaidi100.com/document/5f0ffa8f2977d50a94e1023c.html

API 智慧物流

版权声明:本文内容由网络用户投稿,版权归原作者所有,本站不拥有其著作权,亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容,请联系我们jiasou666@gmail.com 处理,核实后本网站将在24小时内删除侵权内容。

上一篇:ROS2编程基础课程--DDS
下一篇:ASM字节码编程 | 用字节码增强技术给所有方法加上TryCatch捕获异常并输出
相关文章