物流通插件
1. 简介
1.1 插件简介
物流通是一款面向物流运输场景的简道云插件,(无需新装设备)根据货车车牌号将最新位置数据自动同步至简道云,支撑实际业务中的运输管理、过程追踪与风险控制,助力企业提升供应链安全与运营效率。
1.2 使用场景
适用于多种需要跟踪货物运输路由的场景中,如:
- 车辆位置信息手工录入量大、易错:物流客服每天手动输入/更新专线或整车的车辆位置到简道云
- 位置节点信息散落、口径不一:发车/在途/到达各人各记,位置数据不统一
- 位置异常发现滞后:偏离路线/超时停留/异常区域往往事后才知道
- 车辆状态实时性差:无法实时掌握车辆当前位置和运输状态
- 缺乏位置异常预警机制:无法及时发现车辆偏离正常路线或异常停留
1.3 预期效果
以每隔 6 小时自动记录一次车辆实时位置的数据为例(测试用车),效果如下所示:

1.4 使用说明
1)物流通插件适用于简道云企业版、独享版。
2)物流通插件采用年费订阅模式,(限时优惠)每年收费 88 个 云币。一旦用户成功订阅,在订阅有效期内可无限次调用该插件,无需每次调用时单独支付费用。订阅到期后,若用户希望继续使用获取物流通插件的功能,则需续订下一年的服务。若未续订,插件功能将无法使用。
2. 获取平台授权
请联系中交兴路平台获取授权信息,亦可联系插件开发者获取优惠渠道,获取到的信息包含以下内容:
- 用户名
- 密码
- 私钥
- clientId
3. 插件安装及配置
3.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:物流通插件。
- 安装成功后,可参考本文【3.2 配置插件】和【3.3 启用插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
2)在简道云「插件市场」处,安装「物流通」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
3.2 配置插件
3.2.1 获取简道云apikey
在「密钥管理 >> API Key」处,创建并获取 API Key。

3.2.2 获取应用ID和表单ID
在「开发文档 >> 参数说明」中,将应用切换至「物流通」处,选择表单为「物流跟踪记录」表单,查看并复制对应的应用 ID 和表单 ID。

3.2.3 配置插件
安装后,在插件管理处,点击插件右侧的设置按钮,进行插件配置:
- 应用ID:将【3.2.2 获取 应用ID 和 表单ID】中获取到的「应用 ID」配置进去;
- 表单ID:将【3.2.2 获取 应用ID 和 表单ID】中获取到的「物流跟踪记录」的表单 ID 配置进去;
- 简道云API_KEY:将【3.2.1 获取 简道云apikey】中获取到的「 API Key」配置进去;
- 用户名_中交:将【2.1 获取中交兴路平台授权】中获取的中交兴路「用户名」 配置进去;
- 密码_中交:将【2.1 获取中交兴路平台授权】中获取的中交兴路「密码」 配置进去;
- 私钥_中交:将【2.1 获取中交兴路平台授权】中获取的中交兴路「私钥」 配置进去;
- client_id_中交:将【2.1 获取中交兴路平台授权】中获取的中交兴路「ClientId」 配置进去.

3.3 启用插件
在插件管理中,「物流通」插件右侧开关,启用插件。

4. 表单搭建
4.1 创建表单
插件使用体验可点击右侧链接:物流通,本文将按照示例表单进行讲解。
示例应用中共有 5 张表单,其中插件配置需要使用 3 张表单,分别是:
- 运单信息表:一份运单示例模板,用以记录运单信息,并与跟踪记录相关联;
- 物流跟踪记录:从平台获取的路由信息存储到此表单;
- 实时路由信息定时触发器:首次使用时,通过该表单启动首次定时任务,并通过智能助手触发插件。

4.2 设置字段别名
进入「物流跟踪记录」表单中,在「扩展功能 >> 数据推送」处点击「设置字段别名」:
- 关联运单:填写为「related_shipment」;
- 跟踪时间:填写为「tracking_time」;
- 当前位置:填写为「adr」;
- 备注:填写为「note」;
- 车辆定位时间:填写为「positioning_time」;
- 车辆定位时间戳:填写为「positioning_timestamp」;
- 最后定位纬度:填写为「lat」;
- 最后定位经度:填写为「lon」;
- 省:填写为「province」;
- 市:填写为「city」;
- 县:填写为「county」;
- 速度:填写为「speed」。
全部填写完成后,切记点击「保存」。

5. 智能助手配置
5.1 设置定时触发器
5.1.1 添加定时触发智能助手
进入表单「实时路由信息定时触发器」,在「扩展功能 >> 智能助手」处点击「新建智能助手」,设定便于识别和管理的名称,如「定时触发器」,并选择触发方式为定时触发。

5.1.2 设置触发动作
智能助手触发条件设置如下:
- 触发时间类型:选择「根据表单日期字段 >> 实时路由信息定时触发器」;
- 表单日期时间字段:设置为「下次记录时间 >> 当时」;
- 重复触发:选择「不重复触发」。

5.1.3 配置计算节点
点击节点连接线上的加号按钮,添加计算节点,设定节点名称后进行如下设置:
- 计算方式:选择「公式计算」。
- 计算规则:点击「设置公式」后输入公式DATE(YEAR(SYSTIME()),MONTH(SYSTIME()),DAY(SYSTIME()),HOUR(SYSTIME())+6,MINUTE(SYSTIME()),0)
- 计算结果类型:选择「日期时间」。
注:公式中设置「+6」的作用为每 6 小时触发一次插件,如需每 12 小时触发一次,可设置为 12,以此类推。最小设置为 每分钟,建议只设置整数,并且上限后不低于 1 小时以降低查询成本。

5.1.4 配置新增数据节点
点击节点连接线上的加号按钮,添加新增数据节点,设定节点名称后进行如下设置:
- 目标表单:选择「实时路由信息定时触发器」。
- 设置字段值:「下次记录时间」字段,设置为节点字段值,选择「计算下次触发时间-计算下次触发时间」。

5.1.5 配置查询多条数据节点
点击节点连接线上的加号按钮,添加查询多条数据节点,设定节点名称后进行如下设置:
- 查询条件:选择「表单数据 >> 运单信息表」;
- 查询条件:示例中选择「运单状态>> 等于>>已提货」,实际可根据实际情况设定状态值;
- 查询结果:示例中输入200,可根据实际情况调整。

5.1.6 配置循环容器节点
点击节点连接线上的加号按钮,添加循环容器节点,进行如下设置:
- 循环方式:选择「指定节点 >> 查询运输中的运单」(即上一个环节配置的查询多条数据节点);

5.1.7 配置插件节点
点击节点连接线上的加号按钮,添加插件节点,进行如下设置:
- 执行插件:选择「物流通 >> 增加白名单车辆」;
- 车牌号:设置为字段值,并选择「本次循环数据—车牌号」;
- 执行结果:点击「添加 >> 返回结果」。

5.1.8 配置计算节点
点击节点连接线上的加号按钮,添加计算节点,进行如下设置:
- 计算方式:选择「公式计算」;
- 计算规则:点击「设置公式」后输入公式UUID()
- 计算结果类型:点击「文本」。

5.1.9 配置修改数据节点
点击节点连接线上的加号按钮,添加修改数据节点,进行如下设置:
- 修改对象:选择「选择节点修改数据 >> 本次循环数据」;
- 设置字段值:点击「添加字段 >> 路由跟踪触发 >> 计算UUID」(路由跟踪触发是运单信息表中的字段,计算 UUID 是上一个环节自定义名称的节点)。

5.2 运单跟踪
5.2.1 添加新增路由信息智能助手
进入表单「运单信息表」,在「扩展功能 >> 智能助手」处点击「新建智能助手」,设定便于识别和管理的名称,如「运单跟踪」,并选择触发方式为表单触发。

5.2.2 设置触发动作
设置触发动作如下:
- 触发动作:选择修改数据时,即当修改「任意指定字段 >> 路由触发跟踪」时。
建议根据实际情况,增加触发条件设置,避免其他情况下开发异常活动导致产生不必要的查询成本。

5.2.3 设置插件节点
点击节点连接线上的加号按钮,添加插件节点,插件节点设置如下所示:
- 执行插件:选择「物流通 >> 获取车辆定位」;
- 车牌号:设置为字段值,并选择「车牌号」;
- 运单数据 ID:设置为字段值,并选择「触发数据—数据ID」;
- 执行结果:点击「添加 >> 返回结果」。

5.3 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
1)服务中返回的坐标是 84 坐标系,经纬度为车机终端上报的原始坐标,没有经过偏移处理。
2)全部配置完成后,在表单「实时路由信息定时触发器」中手动新增一条数据后即可持续自动触发。填写「下次记录时间 」字段时需要是未来的时间。
7. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问、意见或建议,欢迎您通过以下方式咨询,我们将提供免费的技术指导和技术落地方案。
- 公司:轻舟芯创
- 联系人:蔡宇松
- 联系电话:17843120293
欢迎您点击 链接,反馈意见、建议与新的插件需求。





400-111-0890
在线咨询