快递100物流刷新常见问题解答

    星空企业版/标准版的供应链领域对接了快递100功能，其中主要包含有快递100的电子面单接口，快递管家的订单导入接口以及物流详细信息接口，本文仅简单介绍物流详细信息接口遇到的常见问题。

    问题 1：销售物流信息列表刷新物流信息时提示验证码错误，如下图1-1所示：

图1-1

    问题 1分析：这种一般是寄件人手机号输入错误导致的，请在单据上的物流跟踪页签中输入正确的寄件人手机号（这里可以是真实的寄件人手机号码，也可以是真实的收件人手机号码）；如果是顺丰物流单号且在顺丰官网有物流信息，但在星空返回'查询无结果，请隔段时间再查'，则是由于寄件人手机号没有输入的原因，详情可参阅：https://vip.kingdee.com/article/430762690320029184  。建议通过顺丰小程序验证手机号是否正确，如下图1-1.1所示：

图1-1.1

    问题2：销售物流信息列表刷新物流信息时报错'远程主机强迫关闭了一个现有的连接' 或者在 销售物流更新 执行计划里报错日志信息提示有'无法连接到远程服务器'，如下图1-2所示：

图1-2

    问题2分析：这种是星空服务器没有访问快递100物流接口的权限，注意这里不是快递100官网地址而是http://poll.kuaidi100.com/poll/query.do ，可以在星空系统所在的服务器的浏览器上输入前面的地址测试下看看能否访问成功，一般来说要能返回'{"result":false,"returnCode":"400","message":"数据不完整"}'则代表访问没问题。如果星空应用服务器是集群部署，则要确保每台服务器都要有权限访问，如果服务器有代理配置或者通过其它网络工具设置白名单，则要放开接口http://poll.kuaidi100.com/poll/query.do 地址  。

    问题3：销售物流信息列表刷新物流信息时报错'远程服务器返回错误：(403)已禁止。'，如下图1-3所示：

图1-3

    问题3分析：这种是快递100参数配置中的KEY长期欠费导致的，请及时充值，如果充值后还不生效，则要提供星空系统服务器公网IP给快递100官方解封，长期欠费是按快递100KEY来封IP的，如果在星空快递100参数配置中换一个有单量的KEY（公司编号和授权秘钥），则同一台服务器还是能查询到物流详情的。另外一种可能是请求数据包中带有危险攻击请求数据，比如物流单号为 =VLOOKUP(G668,[1]sheet1!$I:$J,2,0) 。欠费后请求或恶意攻击请求都有可能导致快递100封IP。

    问题4：销售物流信息列表刷新物流信息时报错'Error converting value {null} to type 'System.Boolean'. Could not cast or convert from {null} to System.Boolean'，如下图1-4所示：

图1-4

    问题4分析：这个报错是星空版本 PT-146884 [7.7.0.202108]（不包含此版本） 之前才这么提示的，它代表对应的快递100账号要充值，如果是 PT-146884 [7.7.0.202108]（包含此版本） 之后的版本，则会提示的'没该功能权限'，如下图1-4.1所示：

图1-4.1

总结：

    不管是在销售物流信息列表手工刷新物流，还是通过执行计划'销售物流更新'自动定期更新物流（执行计划里面如果有异常也是有上面类似的日志记录的），如果异常信息中包含有'快递100返回信息：XXX'，则说明快递100接口调通了，但是有异常，冒号后面的XXX就是快递100原封不动地返回的异常信息。如果是其它的报错一般就要看看是不是网络访问不了，或者IP是否被快递100封禁了。被快递100官方封禁IP的原因有很多，比如长期欠费还去请求接口，或者使用不合法的物流单号多次去请求快递100物流接口。