自动生成快递单插件

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(微信同号)

文档内容是否对您有帮助?
有帮助
没帮助没帮助
如需获取即时帮助,请联系技术支持
咨询
扫码领取100+零代码资料简道云官方微信号400-111-0890
图标在线咨询
立即体验