物流查询
更新时间: 2022-07-25 浏览次数: {{ hits }}

企业通过物流给客户邮寄纸质合同,直接查询和跟踪物流进度,与客户即时沟通,推进项目进度。

1、实现效果

选择物流公司,填写收件人/寄件人手机号后四位,填写快递单号,点击“同步物流信息”按钮。

2、配置账户

前往阿里云API市场,注册并登录,开通和购买物流查询服务

注:请务必防止信息泄露。


购买成功后,前往购买成功后,前往阿里云控制台,通过左侧导航栏进入云市场,云市场中的服务对应的就是阿里云API市场服务,获取服务的AppCode信息。,通过左侧导航栏进入云市场,云市场中的服务对应的就是阿里云API市场服务,获取服务的AppCode信息。

根据获取的服务AppCode信息,在氚云配置账户,第三方选择阿里云API市场。

注:阿里云云市场所有服务的AppCode相同,因此只需要配置一个阿里云API市场账户,用此账户配置多个连接,连接阿里云API市场多个服务,了解更多阿里云API市场账户配置


3、配置连接

根据物流查询服务的API接口,配置请求的URL、请求方式、Header、Query和Body。Body类型使用默认选项,新增3个名称分别为ShipperCode、LogisticCode、CustInfo的请求参数(名称需要与API接口文档一致)。我们默认快递公司为顺丰,ShipperCode默认值为SF,顺丰要求填写收件人/寄件人手机号后四位,也就是CustInfo。


配置返回

返回数据添加6个返回参数,包括成功时的物流状态(State)、所在城市(Location)、轨迹发生时间(Traces.AcceptTime)、轨迹描述(Traces.AcceptStation)和轨迹所在城市(Traces.Location),失败时的错误信息(Reason)。


调试

配置返回参数时,暂时不需要配置返回参数的JsonPath,填写请求参数默认值,点击调试,在调试弹窗中配置JsonPath,确保JsonPath能获取到正确数据作为返回参数值,点击确定。

  • 物流状态:$.State

  • 所在城市:$.Location

  • 物流详情.时间:$.Traces[*].AcceptTime

  • 物流详情.城市:$.Traces[*].Location

  • 物流详情.描述:$.Traces[*].AcceptStation

  • 错误信息:$.Reason

注:了解如何配置Json Path

4、表单配置

在表单设计,添加按钮控件,扩展配置选择刚刚配置的连接。配置数据关联规则的请求,将表单字段“物流公司编码”、“收件人/寄件人手机号后四位”、“快递单号”分别填充至请求参数“ShipperCode”、“CustInfo”、“LogisticCode”。配置数据关联规则的返回,将返回参数填充至表单字段,请求参数“物流详情.时间”、“物流详情.城市”、“物流详情.描述”拥有多个值,建议填充至子表字段。


根据API接口文档,返回参数“State”物流状态的值为状态码,设置计算公式,将状态码转化为具体状态。