1. 简介

1.1 功能概述

用户可以输入快递单号、快递公司代号与手机后四位，通过物流查询插件，查询到对应的物流信息并填入表单中。

通过物流查询插件，用户可查询到的信息如下，其中历史物流信息以子表方式返回：

查询范围	查询内容
当前物流信息	快递公司
	物流状态
	运输时长
	最新物流
	最新物流变化时间
	快递员
	快递员电话
历史物流信息	地区
	时间
	物流状态
	详细信息

1.2 应用场景

自动化发货与打印：订单状态变成“待发货”时，系统能自动申请电子面单、打单，随后把单号回填。
物流配送调度协同：在配送应用里，能看到司机实时位置、送达状态和电子签收回单，订单、司机、客户的信息方便调度。
发货异常自动预警：当快递长时间卡在某个环节不动，或被系统判定为“滞留”“派送失败”时，插件能自动标识出来，并推给专人跟进，让售后处理更及时。

1.3 版本说明

插件市场与插件安装功能面向企业版及以上用户开放。
本插件为收费服务，单次调用费用为 0.01云币。
每次调用插件时，系统将自动扣除对应云币。
云币余额不足时，插件将无法使用。用户可以进入企业管理充值云币，具体操作详见：云币。

2. 设置入口

2.1 插件安装

操作路径：首页左侧导航栏 >> 点击「开放平台」>> 点击「插件市场」 >> 点击「出生证识别」 >> 点击「安装」

进入详情页后，点击「安装」即可安装插件。在插件详情页中，用户还可以查询到该插件的付费方案。

2.2 启用插件

插件安装完成后，需要启用插件，才能在表单中正常使用。
点击「插件管理」，在「已安装插件」中找到刚安装的插件，将开关按钮打开即可。

3. 操作指南

3.1 表单搭建

用户需要输入快递单号与手机号后四位才能对快递信息进行查询。添加「单行文本」字段存放上述信息。同时添加「按钮」字段用于触发前端事件。

添加字段，用于存放查询到的数据。用户可以根据自身需求添加并修改字段名称。
此处添加「单行文本」字段以放置“快递公司”、“物流状态”、“运输时长”、“最新物流变化时间”、“快递员”、“快递员电话”六个参数。由于返回的“最新物流”信息是一个长文本，因此适合使用「多行文本」字段来存放。

由于返回参数历史浏览信息是一个子表，添加「子表单」字段存放该信息，在子表单中设置“地区”、“时间”、“物流状态”、“详细信息”字段。

“地区”参数可以用「地址」字段或「单行文本」字段存放；

“时间”参数返回的是时间戳，因此使用“日期时间”或“时间”字段存放；

“物流状态”使用单行文本字段存放；

“详细信息”返回的是一个长文本，可以使用「多行文本」已显示全字段。

3.2 前端事件配置

3.2.1 添加前端事件

搭建好表单后，需要在「表单属性」中配置前端事件。

点击右边栏选择「表单属性」选项卡，对前端事件进行设置。

点击右上角的「＋添加前端事件」，进入前端事件设置页面。

3.2.2 设置前端事件

用户可以根据企业需求自定义事件名称与说明，便于用户在使用时区分各前端事件。

前端事件的触发字段是触发前端事件的条件，当触发字段的值被手动修改时，会触发前端事件。
此处设置触发字段为「物流查询按钮」字段。

触发插件是当前前端事件需要使用的插件。此处选择「物流查询」插件。

插件发送参数就是调用插件时输入的数据。此处需要输入快递单号，快递公司代号，手机号后四位的数据，选择表单中对应的字段。

快递单号：必填；
手机号后四位：当查询顺丰/跨境速运/中通时，必填；若为其他快递，选填，点击参数旁问号可以查看说明；

数据填充是指当插件被调用并返回查询结果后，系统自动将获取到的数据填入当前表单的对应字段中。
点击「新增」，选择需要查询的信息，或者全选所有返回信息。

并选择将查询后的结果存储到表单已有字段中。

设置好前端事件后，用户可以选择直接保存前端事件，或选择保存并调试前端事件。

在推出表单前记得保存。

更多前端事件操作详见：前端事件。