自动生成快递单插件
1. 简介
1.1 插件简介
该插件支持自动生成快递单，并回填快递单号，同时支持物流信息订阅功能，即时推送物流进度信息。可连接快递 100 云打印机自动打印快递单，也可根据链接自行打印快递单。
1.2 应用场景
常用于根据订单中的收货信息自动生成快递单，并自动打印快递单，无需人工再单独填写快递单。
1.3 预期效果
开启自动生成快递单插件，在「简易发货单」表单中新增数据后，自动生成快递单，并将快递单号回填到当前表单中。效果如下所示：
1.4 使用说明
自动生成快递单为付费插件，每次调用插件进行自动生成快递单消耗 0.1 个 云币。在使用插件时自动扣除云币数量，当云币余额可支付的识别次数为 0 时，将无法使用自动生成快递单插件。
2. 插件安装及启用
2.1 安装插件
1）直接安装
- 您可点击右方链接直接安装插件：自动生成快递单插件安装。
- 安装成功后，可参考本文【2.2 启用插件】，前往「开放平台 >> 插件管理」处配置并启用插件。
2）插件市场处安装
在简道云「插件市场」处，安装「自动生成快递单」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。
2.2 启用插件
在插件管理中，打开「自动生成快递单」插件右侧开关，启用插件。
3. 表单搭建
插件使用体验可先安装：自动生成快递单插件模板表单。本文将按照示例表单进行讲解。
以自动生成快递单并自动打印快递单为例，新建「简易发货单」表单，字段设置如下所示：
字段说明 | 字段名称 | 字段类型 |
收件人信息 | 收件人姓名 | 单行文本 |
收件人电话 | ||
收件人地址 | 地址 | |
寄件人信息 | 寄件人姓名 | 单行文本 |
寄件人电话 | ||
寄件人地址 | 地址 | |
物品名称 | 单行文本 | |
备注 | ||
触发字段 | 生成快递单 | 单选按钮组 |
再次打印快递单 | ||
取消快递单 | ||
回填信息 | 快递单链接 | 单行文本 |
快递单号 | ||
快递公司单号 | ||
打印任务ID | ||
物流订阅 | 快递单号 | 单行文本 |
收/寄件人电话 | ||
出发城市 | ||
到达城市 | ||
物流信息 | 子表单 | |
物流日期 | 子表单-日期时间 | |
内容 | 子表单-单行文本 | |
状态 | ||
当前位置 |
注：
1）物流订阅及以下字段并非必填项，企业可根据自己实际业务情况是否需要物流订阅功能按需创建字段；
2）订阅后，一般会在 15 分钟左右进行第一次监控，部分快递公司，快递官网的物流信息有更新会即时推送；
3）对于同一快递公司同一个快递单号，每月最大订阅次数为 4 次，超过 4 次的订阅在提交时会报重复订阅；
4）收、寄件人的电话号码，手机和固定电话均可填写，但只能填写一个，顺丰速运、顺丰快运必填此项，其它快递公司选填；如座机号码有分机号，分机号无需上传；如号码是电商虚拟号码需传入「-」后的后四位。
4. 前端事件配置
4.1 自动生成快递单配置
4.1.1 添加前端事件
进入「表单属性」，点击前端事件下的设置，添加前端事件：
4.1.2 设置事件名称和说明
添加好前端事件后，首先设置前端事件的基础信息，即事件名称和事件说明，用于区分前端事件：
4.1.3 设置触发动作
设置触发动作：触发字段选择「生成快递单」字段。
4.1.4 设置执行动作
1）设置执行动作如下：
- 选择插件和事件：选择「自动生成快递单」插件，并选择「自动生成快递单」事件；
- 根据自身需求，设置其他字段及参数，详情可参见【 2）执行动作字段说明】。
2）执行动作字段说明
字段名称 | 是否必填 | 字段来源 | 字段说明 |
快递 100 云打印机ID | 非必填 | 自定义/字段值 | 1）若设置，则自动打印快递单；若不设置，则返回链接自行打印快递单。 2）设置时，若是固定一种云打印机，则以「自定义」方式输入云打印机 ID；若需选择不同的云打印机，则以「字段值」方式，选择表单的字段，传入每一单需要使用的云打印机。 |
平台面单 | 必填 | —— | 若是第三方平台的面单，选择具体的平台；若不是则选择「其他」。 |
快递公司 | 自定义/字段值 | 1）若是固定一家快递公司发运，则以「自定义」方式输入快递公司名称；若需选择不同的快递公司发运，则以「字段值」方式，选择表单的字段，传入每一单需要发运的快递公司名称。 2）快递公司以名称方式识别，因此需要使用标准名称，详见注意事项【6.3 快递公司参数对照表】中的快递公司名称。 | |
支付方式 | 1）若是固定一种支付方式，则以「自定义」方式输入支付方式；若需选择不同的支付方式，则以「字段值」方式，选择表单的字段，传入每一单需要的支付方式。 2）支付方式仅有三种：寄方付、到付、月结。 | ||
产品类型 | 1）若是固定一种产品类型，则以「自定义」方式输入产品类型；若需选择不同的产品类型，则以「字段值」方式，选择表单的字段，传入每一单需要使用的产品类型。 2）产品类型以名称方式识别，因此需要使用标准名称，且每家快递公司产品类型不同，详见注意事项【6.4 产品类型参数表】。 | ||
面单账户 | 自定义/字段值 | 用于填写电子面单客户账户或月结账号 | |
面单密码 | 非必填 | 自定义/字段值 | 用于填写电子面单密码 |
网点名称 | 收件网点名称,由快递公司当地网点分配 | ||
承载编号 | 是否必填该属性，可查看【6.3 快递公司参数对照表】 | 当地快递公司网点申请 | |
承载快递员名 | 是否必填该属性，可查看【6.3 快递公司参数对照表】 | 向当地快递公司网点申请 | |
授权网点 | 非必填 | 在使用菜鸟/淘宝/拼多多授权电子面单时，若月结账号下存在多个网点，则 tbNet="网点名称,网点编号" ，此处为英文逗号； | |
收件人姓名 | 必填 | 字段值 | 用于填写收件人的相关信息。 |
收件人手机 | |||
收件人地址 | |||
寄件人姓名 | 用于填写寄件人相关信息。 | ||
寄件人手机 | |||
寄件人地址 | |||
物品名称 | 用于填写快递的物品名称。 | ||
备注 | 非必填 | 自定义/字段值 | 用于填写快递单备注信息 |
保价额度 | 用于填写快递的保价额度 | ||
电商自定义模板地址 | 若你需要打印其他信息，例如备注，需自行创建自定义模板 | ||
电商模板参数 | 自定义模板参数，格式：参数名=参数值,多个逗号隔开 | ||
子母单 | —— | 1）指同一个订单打印出多张电子面单，即同一个订单返回多个面单号； 2）若选择了需要子母单，则包裹总数必填，且必须大于 1。 | |
包裹总数 | 自定义/字段值 | 1）若选择不需要子母单，则可不填。 2）若选择了需要子母单，则包裹总数必填，且必须大于 1。 |
3）在设置字段存储关系处，点击「添加」按钮，添加「全部」，并分别回填至如下所示的表单字段中。全部设置完成保点击「保存」。
4.2 再次打印快递单配置
注：再次打印快递单，仅针对使用快递 100 云打印机的用户，其他用户可不配置此项，直接通过链接重复打印。
4.2.1 添加前端事件
进入「表单属性」，点击前端事件下的设置，添加前端事件：
4.2.2 设置事件名称和说明
添加好前端事件后，首先设置前端事件的基础信息，即事件名称和事件说明，用于区分前端事件：
4.2.3 设置触发动作
设置触发动作：触发字段选择「再次打印快递单」字段。
4.2.4 设置执行动作
1）设置执行动作如下：
- 选择插件和事件：选择「自动生成快递单」插件，选择「再次打印快递单」事件；
- 以「字段值」方式选择：「打印任务ID」。
2）在设置字段存储关系处，点击「添加」按钮，添加「再次打印反馈信息」字段，并回填至「再次打印反馈信息」表单字段中。设置完成保点击「保存」。
4.3 取消快递单配置
4.3.1 添加前端事件
进入「表单属性」，点击前端事件下的设置，添加前端事件：
4.3.2 设置事件名称和说明
添加好前端事件后，首先设置前端事件的基础信息，即事件名称和事件说明，用于区分前端事件：
4.3.3 设置触发动作
设置触发动作：触发字段选择「取消快递单」字段。
4.3.4 设置执行动作
设置执行动作如下：
- 选择插件：选择「自动生成快递单」插件，选择「取消快递单」事件；
- 选择快递公司：当时生成快递单对应的快递公司；若是固定的一家快递公司发运，则以「自定义」方式输入快递公司名称；若当时是选择的不同的快递公司发运，则以「字段值」方式，选择表单的字段，传入每一单需要发运的快递公司名称；
- 输入「面单账户」、「面单密码」、「网点名称」、「承载编号」、「取消原因」：每个快递公司需要填写的内容不同，具体要求参考【6.3 快递公司参数对照表】；
- 以「字段值」方式选择：「快递单号」、「快递公司单号」。
注：快递公司以名称方式识别，因此需要使用标准名称，详见注意事项【6.3 快递公司参数对照表】中的快递公司名称。
2）在设置字段存储关系处，点击「添加」按钮，添加「取消打印反馈信息」字段，并回填至「取消打印反馈信息」表单字段中。设置完成保点击「保存」。
5. 智能助手Pro配置
如需查询物流订阅信息，需配置提交订阅智能助手Pro如下：
5.1 获取物流
5.1.1 配置HTTP触发动作
1）在「扩展功能 >> 智能助手」处，点击「新建智能助手」，并修改智能助手的名称为「物流订阅」，设置触发方式为「HTTP 触发」。
2）点击HTTP触发，复制触发地址后，点击右方链接：触发数据列表 ，进入触发数据列表页面后粘贴触发地址，获取触发结果。
3）触发结果为「success」时，返回至 HTTP 触发动作配置中，在「触发数据列表」处点击「点击获取示例数据」。
4）获取到示例数据后，设置触发配置如下：
- 勾选自定义返回内容，设置 JSON 示例代码为：{ "result":true, "returnCode":"200", "message":"成功"}。
注：配置时，需先获取示例数据后再设置 自定义返回内容，否则可能会有获取示例数据不成功的情况。
5.1.2 配置插件节点
添加插件节点，修改名称为「获取物流信息」进行如下设置：
- 插件读写表单：选择表单「简易发货单」；
- 执行插件：选择「自动生成快递单 >> 获取物流」；
- 数据Body：选择字段值，勾选「触发数据--body_param」或「触发数据--body」；
- 执行结果：添加「状态」，选择「文本类型」；
- 执行结果：添加「快递单号」，选择「文本类型」；
- 执行结果：添加「物流信息.日期」字段，选择「日期时间类型」；
- 执行结果：添加「物流信息.描述」字段，选择「文本类型」；
- 执行结果：添加「物流信息.状态」字段，选择「文本类型」
- 执行结果：添加「物流信息.位置」字段，选择「文本类型」。
注：因对应的 http 返回格式不同，在「数据 Body」配置处，选择字段值后，如有「触发数据--body_param」则勾选配置，如无此项，则勾选「触发数据--body」配置即可。
5.1.3 配置修改数据节点
1）添加修改数据节点，进行如下操作：
- 修改对象：选择表单修改数据「简易发货单 」；
- 筛选出要修改的数据：添加「快递单号 」,勾选「获取物流信息--快递单号」字段；
2）在「字段值选择」处，选择修改数据，相关字段设置如下所示：
- 添加「子表单.内容 」，勾选「获取物流信息--物流信息.描述」；
- 添加「子表单.状态 」，勾选「获取物流信息--物流信息.状态」；
- 添加「子表单.当前位置 」，勾选「获取物流信息--物流信息.位置」；
- 添加「子表单.物流日期 」，勾选「获取物流信息--物流信息.日期」；
- 设置子表单修改条件：添加「子表单.物流日期 」等于「获取物流信息--物流信息.日期」。
3）在「字段值选择」处，选择新增数据，相关字段设置如下所示：
- 添加「子表单.物流日期 」，勾选「获取物流信息--物流信息.日期」；
- 添加「子表单.内容」，勾选「获取物流信息--物流信息.描述」；
- 添加「子表单.状态 」，勾选「获取物流信息--物流信息.状态」；
- 添加「子表单.当前位置 」，勾选「获取物流信息--物流信息.位置」。
5.2 物流订阅
5.2.1 新建智能助手
点击「扩展功能 >> 智能助手」，在新建智能助手 Pro 中选择表单触发：
5.2.2 配置触发动作
- 触发动作：选择「新增数据时」和「修改数据时 >> 任意字段」修改时。
- 触发条件：设置「添加条件 >> 快递单号」不为空时。
5.2.3 配置插件节点
点击插件配置节点，进行以下操作：
- 插件：选择「自动生成快递单 >> 物流订阅」插件；
- 快递单号：设置为「字段值」，即「快递单号」字段；
- 收/寄件人电话：「字段值」，即「收/寄件人电话」字段；
- 出发城市：设置为「字段值」，即「出发城市」字段；
- 目的城市：设置为「字段值」，即「目的城市」字段；
- 回调地址：设置为自定义，填写智能助手 Pro 中 HTTP 触发时获取到的触发地址，获取方式参考【5.1配置 HTTP 触发动作】。
- 字段存储关系：点击「添加」按钮，设置「查询编号」为「文本类型」，设置「查询结果」为「文本类型」。
5.3 效果演示
效果参见本文【1.3 预期效果】。
6. 注意事项
6.1 关于快递100云打印机的说明
如需本插件对接的快递 100 云打印机进行生成快递单和打印快递单，请在快递 100 官网或者电商店铺中购买快递 100 的云打印机（售价：500 元左右）。
注：快递100云打印机非必需品，用户可按需选择自行打印或连接云打印机打印。
6.2 关于再次打印快递单的说明
仅针对使用快递 100 云打印机的用户，可进行快递单的重复打印，2 天内可以重复打印 10 次。
6.3 快递公司参数对照表
1）不同快递公司，参数要求不同，查询下方对照表，按对应快递公司的要求进行配置。
快递公司编码 | 快递公司名称 | partnerId/电子面单账户号码 | partnerKey/电子面单账户密码 | partnerSecret/电子面单密钥 | partnerName/电子面单客户账户名称 | net/网点名称 | code/ 电子面单承载编号 | checkMan/电子面单承载快递员名 |
debangkuaidi | 德邦快递 | 客户编码 | ||||||
debangwuliu | 德邦物流 | 客户编码 | ||||||
ems | EMS | 协议客户号 | 电商客户标识 | |||||
huitongkuaidi | 百世快递 | 操作编码 | 密钥 | |||||
baishiwuliu | 百世快运 | 账户信息 | 账户密码 | |||||
jd | 京东快递 | 商家编码 | ||||||
kuayue | 跨越速运 | 客户编码 | ||||||
pjbest | 品骏快递 | 月结账号 | 客户编码 | |||||
shentong | 申通快递 | 客户名称 | 客户密码 | 网点 | 44 | |||
shunfeng | 顺丰速运 | 月结账号 | ||||||
shunfengkuaiyun | 顺丰快运 | 月结账号 | ||||||
fengwang | 丰网速运 | 账户名称 | 账户密码 | |||||
youzhengguonei | 邮政快递包裹 | 协议客户号 | 电商客户标识 | |||||
yuantong | 圆通速递 | 商家代码 | 商家密钥 | |||||
yunda | 韵达快递 | 韵达白马账号 | 联调密码 | |||||
zhaijisong | 宅急送 | 月结账号 | ||||||
zhongtong | 中通快递 | 合作方代码 | 合作方密钥 | 网点编码 | ztoOpen | |||
ewe | EWE全球快递 | 代理店验证用户名 | 验证密码 | |||||
jtexpress | 极兔速递 | 客户编码 | 客户密码 | |||||
huisenky | 汇森速运 | 商家编号 | 订购申请编号 | 月结客户编码 | 业务员编码 | |||
zhongyouex | 众邮快递 | 客户编码 | 网点编号 | |||||
jiayunmeiwuliu | 加运美速递 | 客户编号 | 客户名称 | 寄件网点编号 | 取件员编号 | |||
sxjdfreight | 顺心捷达 | 商户ID | 服务订购号 | 网点编号 | ||||
suteng | 速腾快递 | 客户编码 | 网点名称 | 快递员姓名 | ||||
jiayiwuliu | 佳怡物流 | 商家ID | 商家密码 | 网点编号 | ||||
nezhasuyun | 哪吒速运 | 客户编码 | ||||||
lianhaowuliu | 联昊通速递 | 客户编号 |
2）参数说明：
- partnerId： 电子面单账户号码，需向快递公司在贵司当地的网点申请；
- partnerKey： 电子面单账户密码，需向快递公司在贵司当地的网点申请；
- partnerSecret： 电子面单密钥，需向快递公司在贵司当地的网点申请；
- partnerName： 电子面单客户账户名称，需向快递公司在贵司当地的网点申请；
- net: 网点名称，需向快递公司在贵司当地的网点申请；
- code： 电子面单承载编号，需向快递公司在贵司当地的网点申请；
- checkMan： 电子面单承载快递员名，需向快递公司在贵司当地的网点申请。
6.4 产品类型参数表
国内快递公司编码(名称) | 产品类型 | |
annengwuliu（安能快运） | 标准快递、标准快运、定时达、普惠达、Mini 电商小件 | |
debangkuaidi（德邦快递） | 标准快递、360 特惠件、特快专递、特准快件、德邦快递、大件快递 360、重包入户、重包特惠、同城件、微小件特惠、经济大件、航空大件次日达、航空大件隔日达 | |
debangwuliu（德邦物流） | 精准卡航、精准汽运、精准包裹、精准空运、精准整车、整车配送、精准专车、精准拼车、精准重货 | |
ems（EMS) | 标准快递、代收到付 | |
huitongkuaidi（百世快递） | 标准快递 | |
baishiwuliu（百世快运） | 标准快递 | |
jd（京东快递） | 标准快递、京东到付、特快送、城际闪送、同城当日达、次晨达、生鲜专送、生鲜特快、生鲜特惠、函速达、特惠小包、特惠小件、医药冷链、冷链专送 | |
kuayue（跨越速运） | 标准快递、陆运件、同城次日、同城即日、省内次日、省内即日、隔日达、次日达、次晨达、当天达、航空件、空运、专运 | |
pjbest（品骏快递） | 标准快递、标准快运、整车运输 | |
shentong（申通快递） | 标准快递 | |
shunfeng（顺丰速运） | 顺丰特快、顺丰标快、电商特惠、电商标快、顺丰即日、电商速配、丰网速运、顺丰宝平邮、顺丰宝挂号、医药常温、医药专递、物流普运、冷运到家、生鲜速配、大闸蟹专递、汽配专线、重货快运 国际特惠（试点）、行邮专列、医药专运（常温）、医药专运（温控）、国际特惠-文件、国际特惠-B类包裹、国际特惠-D类包裹、国际特惠（保税）、国际特惠（商家代理） 电商专配、顺丰干配、顺丰空配、重货包裹、小票零担、顺丰微小件、限时KC24、特惠专配 大票零担、陆运包裹、极速包裹、极置店配、极置店配（专线）、冷运标快、专线普运、商务标快、快运标准达D类、顺丰卡航、顺丰卡航（D类） | |
shunfengkuaiyun（顺丰快运） | 标准快递、顺丰标快、顺丰特惠、重货包裹、小票零担、物流普运、专线普运、重货专运、大票零担、快运标准达、标准零担、大票直送、整车直达、特惠专配、专线普运、特惠件、纯重特配、顺丰干配 | |
fengwang（丰网速运） | 标准快递 | |
xinfengwuliu（信丰物流） | 标准快递 | |
youshuwuliu（优速快递） | 标准快递 | |
youzhengguonei（邮政快递包裹） | 快递包裹 | |
yuantong（圆通速递） | 标准快递、圆准达 | |
yunda（韵达快递） | 标准快递 | |
zhaijisong（宅急送） | 标准快递 | |
zhongtong（中通快递） | 标准快递、尊享、两小时、标快、zhongtongkuaiyun（中通快运） | |
ewe（EWE全球快递） | 标准快递、经济奶粉、标准杂货、经济杂货、快速奶粉、杂货 | |
ytchengnuoda（圆通承诺达） | 标准快递 | |
weitepai（微特派） | 标准快递、次日达、今夜达、当日达 | |
dsukuaidi（D速快递） | 标准快递 | |
cfss（银雁专送） | 标准快递 | |
jtexpress（极兔速递） | 标准快递 | |
huisenky（汇森速运） | 标准快递 | |
zhongyouex（众邮快递） | 标准快递 | |
jiayunmeiwuliu（加运美速递） | 标准快递 | |
idamalu（大马鹿） | 标准当日达、特惠当日达、标准快递 | |
sxjdfreight（顺心捷达） | 标准快递 | |
yimidida（壹米滴答） | 标准快递 | |
jingdongkua（京东快运） | 标准快递、特惠送、零担、特快送、特惠零担、特快零担、航空代理、航空直客、铁路直客、特惠拼车 同城直配、医药零担、特快重货 | |
yundadiantongda（韵达点通达）） | 标准快递 | |
suteng（速腾快递） | 标准快递 | |
lianhaowuliu（联昊通速递） | 标准快递 | |
jiayiwuliu（佳怡物流） | 标准快递 | |
jinguangsudikuaijian（京广速递） | 标准快递 | |
yundakuaiyun（韵达快运） | 标准快递、标准快运、电商件、168大件 | |
tiandihuayu（天地华宇） | 标准快递、定日达、经济快运 | |
cccc58（中集冷云） | 标准快递 | |
nezhasuyun（哪吒速运） | 标准快递 | |
sunjex（新杰物流） | 标准快递 | |
lianhaowuliu（联昊通速递） | 标准快递 | |
6.5 关于面单账户的说明
若已有面单账户，直接添加使用即可；若无，请联系需要合作的快递公司申请面单账户。
6.6 关于第三方平台面单授权
若是基于第三方平台和快递公司合作的，请点击 授权链接 进行授权，在邮箱中接收面单账户信息，再进行插件的配置。
6.7 关于快递单号和快递公司单号的说明
「快递单号」为外部使用的统一的快递单号，所有生成快递单都会返回此单号；「快递公司单号」为部分快递公司内部自己的单号，若返回了此单号，那么取消快递单时需要提供此单号，建议 2 个单号都保存，以备使用。
7. 联系方式
该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：
- 公司：成都轻如燕企业服务有限公司
- 联系人：赵鹏
- 联系电话：18583980516（微信同号）
400-111-0890
在线咨询