自动生成快递单插件
1. 简介
1.1 插件简介
该插件支持自动生成快递单,并回填快递单号。可连接快递 100 云打印机自动打印快递单,也可根据链接自行打印快递单。
1.2 应用场景
常用于根据订单中的收货信息自动生成快递单,并自动打印快递单,无需人工再单独填写快递单。
1.3 预期效果
开启自动生成快递单插件,在「简易发货单」表单中新增数据后,自动生成快递单,并将快递单号回填到当前表单中。效果如下所示:
1.4 使用说明
自动生成快递单为付费插件,每次调用插件进行自动生成快递单消耗 0.1 个 云币。在使用插件时自动扣除云币数量,当云币余额可支付的识别次数为 0 时,将无法使用自动生成快递单插件。
2. 插件安装及启用
2.1 安装插件
1)直接安装
- 您可点击右方链接直接安装插件:自动生成快递单插件安装。
- 安装成功后,可参考本文【2.2 配置插件】和【2.3 启用插件】,前往「开放平台 >> 插件管理」处配置并启用插件。
2)插件市场处安装
在简道云「插件市场」处,安装「自动生成快递单」插件。插件市场处安装方法可参见文档:插件市场中【2.3 插件安装】。
2.3 启用插件
在插件管理中,打开「自动生成快递单」插件右侧开关,启用插件。
3. 表单搭建
插件使用体验可先安装:自动生成快递单插件模板表单。本文将按照示例表单进行讲解。
以自动生成快递单并自动打印快递单为例,新建「简易发货单」表单,字段设置如下所示:
字段名称 | 字段类型 |
收件人姓名 | 单行文本 |
收件人电话 | |
收件人地址 | 地址 |
寄件人姓名 | 单行文本 |
寄件人电话 | |
寄件人地址 | 地址 |
物品名称 | 单行文本 |
备注 | |
生成快递单 | 单选按钮组 |
再次打印快递单 | |
取消快递单 | |
快递单链接 | 单行文本 |
快递单号 | |
快递公司单号 | |
打印任务ID |
4. 前端事件配置
本章节的【4.1 自动生成快递单配置】、【4.2 再次打印快递单配置】和【4.3 取消打印快递单配置】并非全部需要配置,企业可根据自己实际业务情况按需配置即可。
4.1 自动生成快递单配置
4.1.1 添加前端事件
进入「表单属性」,点击前端事件下的设置,添加前端事件:
4.1.2 设置事件名称和说明
添加好前端事件后,首先设置前端事件的基础信息,即事件名称和事件说明,用于区分前端事件:
4.1.3 设置触发动作
设置触发动作:触发字段选择「生成快递单」字段。
4.1.4 设置执行动作
1)设置执行动作如下:
- 选择插件和事件:选择「自动生成快递单」插件,并选择「自动生成快递单」事件;
- 根据自身需求,设置其他字段及参数,详情可参见【 2)执行动作字段说明】。
2)执行动作字段说明
字段名称 | 是否必填 | 字段来源 | 字段说明 |
快递 100 云打印机ID | 非必填 | 自定义/字段值 | 1)若设置,则自动打印快递单;若不设置,则返回链接自行打印快递单。 2)设置时,若是固定一种云打印机,则以「自定义」方式输入云打印机 ID;若需选择不同的云打印机,则以「字段值」方式,选择表单的字段,传入每一单需要使用的云打印机。 |
平台面单 | 必填 | —— | 若是第三方平台的面单,选择具体的平台;若不是则选择「其他」。 |
快递公司 | 自定义/字段值 | 1)若是固定一家快递公司发运,则以「自定义」方式输入快递公司名称;若需选择不同的快递公司发运,则以「字段值」方式,选择表单的字段,传入每一单需要发运的快递公司名称。 2)快递公司以名称方式识别,因此需要使用标准名称,详见注意事项【5.3 快递公司参数对照表】中的快递公司名称。 | |
支付方式 | 1)若是固定一种支付方式,则以「自定义」方式输入支付方式;若需选择不同的支付方式,则以「字段值」方式,选择表单的字段,传入每一单需要的支付方式。 2)支付方式仅有三种:寄方付、到付、月结。 | ||
产品类型 | 1)若是固定一种产品类型,则以「自定义」方式输入产品类型;若需选择不同的产品类型,则以「字段值」方式,选择表单的字段,传入每一单需要使用的产品类型。 2)产品类型以名称方式识别,因此需要使用标准名称,且每家快递公司产品类型不同,详见注意事项【5.4 产品类型参数表】。 | ||
面单账户 | 自定义/字段值 | 用于填写电子面单客户账户或月结账号 | |
面单密码 | 非必填 | 自定义/字段值 | 用于填写电子面单密码 |
网点名称 | 收件网点名称,由快递公司当地网点分配 | ||
承载编号 | 是否必填该属性,可查看【5.3 快递公司参数对照表】 | 当地快递公司网点申请 | |
承载快递员名 | 是否必填该属性,可查看【5.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 设置执行动作
设置执行动作如下:
- 选择插件:选择「自动生成快递单」插件,选择「取消快递单」事件;
- 选择快递公司:当时生成快递单对应的快递公司;若是固定的一家快递公司发运,则以「自定义」方式输入快递公司名称;若当时是选择的不同的快递公司发运,则以「字段值」方式,选择表单的字段,传入每一单需要发运的快递公司名称;
- 输入「面单账户」、「面单密码」、「网点名称」、「承载编号」、「取消原因」:每个快递公司需要填写的内容不同,具体要求参考【5.3 快递公司参数对照表】;
- 以「字段值」方式选择:「快递单号」、「快递公司单号」。
注:快递公司以名称方式识别,因此需要使用标准名称,详见注意事项【5.3 快递公司参数对照表】中的快递公司名称。
2)在设置字段存储关系处,点击「添加」按钮,添加「取消打印反馈信息」字段,并回填至「取消打印反馈信息」表单字段中。设置完成保点击「保存」。
4.4 效果演示
效果参见本文【1.3 预期效果】。
5. 注意事项
5.1 关于快递100云打印机的说明
如需本插件对接的快递 100 云打印机进行生成快递单和打印快递单,请在快递 100 官网或者电商店铺中购买快递 100 的云打印机(售价:500 元左右)。
注:快递100云打印机非必需品,用户可按需选择自行打印或连接云打印机打印。
5.2 关于再次打印快递单的说明
仅针对使用快递 100 云打印机的用户,可进行快递单的重复打印,2 天内可以重复打印 10 次。
5.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 | 哪吒速运 | 客户编码 |
2)参数说明:
- partnerId: 电子面单账户号码,需向快递公司在贵司当地的网点申请;
- partnerKey: 电子面单账户密码,需向快递公司在贵司当地的网点申请;
- partnerSecret: 电子面单密钥,需向快递公司在贵司当地的网点申请;
- partnerName: 电子面单客户账户名称,需向快递公司在贵司当地的网点申请;
- net: 网点名称,需向快递公司在贵司当地的网点申请;
- code: 电子面单承载编号,需向快递公司在贵司当地的网点申请;
- checkMan: 电子面单承载快递员名,需向快递公司在贵司当地的网点申请。
注:京东快运 partnerId 获取步骤请查看 京东快运 partnerId 获取。
5.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(新杰物流) | 标准快递 |
5.5 关于面单账户的说明
若已有面单账户,直接添加使用即可;若无,请联系需要合作的快递公司申请面单账户。
5.6 关于第三方平台面单授权
若是基于第三方平台和快递公司合作的,请点击 授权链接 进行授权,在邮箱中接收面单账户信息,再进行插件的配置。
5.7 关于快递单号和快递公司单号的说明
「快递单号」为外部使用的统一的快递单号,所有生成快递单都会返回此单号;「快递公司单号」为部分快递公司内部自己的单号,若返回了此单号,那么取消快递单时需要提供此单号,建议 2 个单号都保存,以备使用。
6. 联系方式
该插件为官方合作的服务商开发,若您在使用过程中有任何疑问,可通过以下方式咨询:
- 公司:成都轻如燕企业服务有限公司
- 联系人:赵鹏
- 联系电话:18583980516(微信同号)