快递100接口快递查询类服务常见问题和解决方法 - kuaidi100-api/technical-issues-FAQ GitHub Wiki

请用正确的x-www-form-urlencoded方式提交参数，也可以参考GitHub上的demo：https://github.com/kuaidi100-api

查询失败和查无结果的响应报文与查询成功的字段不一样。建议先判断returnCode不为空时，即查询无结果或者是其他异常报错。

请检查是否请求格式错误，是否把x-www-form-urlencoded方式错用成了application/json，导致获取不到参数的值；可以在企业管理后台的调试工具中进行调试，查看参数是否缺失。

订阅成功后，我们连续跟踪3天均查不到跟踪信息，我们认为可能是单号对应的包裹还未被快递员送出去、单号过期了或单号是错误的了，这时会 （1）判断一次贵司提交的快递公司编码是否正确，如果正确，给贵司的回调接口（callbackurl）返回带有如下字段的信息：autoCheck=0、comOld与comNew都为空； （2）如果贵司提交的快递公司编码出错，我们会帮忙用正确的快递公司编码+原来的运单号重新提交订阅并开启监控（后续如果监控到单号有更新就给贵司的回调接口（callbackurl）推送带有如下字段的信息：autoCheck=1、comOld=原来的公司编码、comNew=新的公司编码）；并且给贵方的回调接口（callbackurl）推送一条含有如下字段的信息：status=abort、autoCheck=0、comOld为空、comNew=纠正后的快递公司编码。所以，如果判断到status=abort且comNew为空，则重新提交订阅；如查判断到status=abort且comNew不为空，则不需要重新提交订阅，且将贵司原来的快递公司编码改为comNew后的值，或在贵司数据库中增加一个快递公司编码为comNew+原来单号的运单；如果判断到status=polling且autoCheck=1，则此单为纠正公司编码后的跟踪信息，应保存。

如果收到超时关闭的消息推送，也需要返回成功的响应报文，表示已经成功接收该消息通知，否是系统会作为该消息推送失败处理，隔半小时再次重推该消息（最多重推3次）。用户后续可以判断自己快递公司编码或者单号是否有误，如果还需要继续跟踪，隔半小时后再用正确的快递公司编码和正确的单号发起订阅即可继续跟踪推送流程。

收到这种推送，也需要返回成功的响应报文，否则系统会作为推送失败处理，隔半小时再次推送该消息的(最多重推3次)。

如果company填了快递公司编码，则autoCom=1会失效

如果不需要校验推送sign，订阅的时候salt设置为null或者推送消息处理的时候忽略sign的校验

此报错是因为回调地址为https导致（默认只支持http），可联系快递100工作人员处理

重开是指对已经关闭订阅状态的运单重新开启订阅； 重推是指将上次推送的内容再推送一次； 关闭是指对正在订阅跟踪状态的运单进行关闭操作。

企业管理后台>数据管理>订阅记录，可以查询到运单的推送详情，如果这个订阅记录查询不到推送失败的记录，说明后面重推成功了。短信的统计是每次推送的结果累加值，管理后台看到的是最后一次推送情况。

可在企业管理后台>数据管理>订阅记录中，通过快递公司编码和单号找到订阅记录，先关闭订阅，隔半小时后再使用正确的回调地址去重新订阅。如果数据比较多，可以联系管理员进行批量处理。

"有两种情况，一是传入的快递编码错误，可在企业管理后台查看正确的编码进行查询即可；二是该快递公司快递100暂时不支持，可联系快递100工作人员"。

推送失败后，会重试3次，每次间隔大约半小时。如果3次均失败，会停止推送，等待下一次跟踪节点有变化后再进行推送。

可能是状态识别错误，同城件会比较多出现这种情况，此问题可反馈快递100工作人员进行确认，轨迹中出现环路轨迹也会被判定退签。可通过传出发地和目的地参数，提高识别准确率。

快递100是按成功接收的运单数量（即成功提交给快递100的运单数量）计费（即“快递100信息推送服务”以返回含有result=true、returnCode=200的订阅响应报文为计费标准，“快递100实时快递查询接口”以返回含有status=200或returnCode =500的报文为计费。请求成功但查无结果也是需要收费的

登录账号进入企业管理后台，在我的信息-企业信息中查看

快递100目前支持1200+国内外的快递物流公司的信息查询，包含国内所有的主流快递物流公司，可注册账号登录后，在企业管理后台-技术文档-快递公司编码中进行查询和下载快递公司名单

1.检查是否用了顺丰丰密模板，如果用了此类模板，需要按照参数字典（链接：https://api.kuaidi100.com/document/5f0ff6e82977d50a94e10237.html）内顺丰丰密传入参数； 2.参数如不清楚，可在丰桥开放平台上(链接：http://qiao.sf-express.com/pages/service/third.html)获取，路径为丰桥服务-文档服务-第三方软件加接入-快递100，或联系顺丰业务人员获取。

请使用顺丰丰密面单模板，并按照电子面单-参数字典（链接：https://api.kuaidi100.com/document/5f0ff6e82977d50a94e10237.html）录入顺丰丰密必填的账号参数内容即可。

可在丰桥开放平台上(链接：http://qiao.sf-express.com/pages/service/third.html)获取，路径为丰桥服务-文档服务-第三方软件加接入-快递100，或联系顺丰业务人员获取。

请联系京东业务人员开通白名单，即可正常使用。

生成跨越电子面单的时候,需要在param层多传入预约取件的参数“startGotTime” （以时间戳的字符串形式,例如"startGotTime":“1605256080000”，预约时间必须大于当前时间），否则将导致下单失败或仅有大网系统存在订单而不分配给具体网点。

请设置一下本地打印机，设置对应的纸张大小或其他打印效果参数。

顺丰速运默认业务类型为“顺丰特快“，如未传入指定业务类型即为默认，如传入了指定业务类型但未生效，则有属于以下情况，如举例内容均不包含，可联系快递100客服人员或顺丰网点沟通问题： 1、顺丰次晨和顺丰标快（400KM以上跨省流向）整合升级为顺丰特快； 2、顺丰标快（陆运）和顺丰标快（400KM以内同城或省内流向）整合升级为新一代顺丰标快；

1.首先确认合作的快递公司品牌是否支持面单上字段隐藏，目前快递100已知的品牌为顺丰及京东，为了避免客户实际发货，建议与快递公司先做沟通及确认； 2.如需要隐藏，且是电子面单图片或打印接口客户，可在管理后台-模板配置处编辑模板，具体字段可咨询快递100工作人员。

此处的“电子面单数量”不是指快递100管理后台接口调用单量，而是客户的月结账号在快递公司处的电子面单号数量，此报错的内容需要快递公司网点处理。

此信息说明客户录入的月结账号到快递公司处校验失败，请跟快递网点确认企业开通的账号信息。