通过快递鸟如何接入韵达速递电子面单

一、接入前准备（TO商家业务人员）
1、申请快递鸟用户ID和API key
1.1登录快递鸟官网注册页面http://www.kdniao.com/reg注册快递鸟账号；
1.2登录快递鸟用户管理后台，进入“我的会员中心”进行实名认证；
1.3认证成功后，进入“产品服务管理”，开通会员服务（可开通免费套餐测试）。

2、韵达速递申请电子面单客户号
    申请客户号有以下两种方式，互不冲突，任选其一即可；（不支持菜鸟、京东、拼多多电子面单客户号）；
2.1线下与当地韵达网点签订合作协议，并申请韵达自有电子面单客户号；
2.2在快递鸟官网申请，申请路径：用户管理后台——电子面单——申请新的物流服务商——申请韵达快递——填写信息后提交，待快递公司总部审核通过后（一般在2-3个工作日审核通过，如长时间未审核，建议直接联系网点催促审核或进行线下申请），会有短信通知到申请人手机号上，使用前需联系网点充值单号。
2.3网点开通客户号操作流程见下图：
 
注：获取到的电子面单客户号不需要在快递鸟官网后台添加，直接通过接口传值下单即可；

3、购买打印机、打印纸
3.1打印机：
电子面单模板对打印机品牌、型号等没有要求，只要是热敏打印机即可，常见品牌如：斑马、得力、快麦、汉印、佳博等。
打印机可由快递网点提供或者在淘宝京东上购买，安装打印机及驱动程序联系打印机提供方；
3.2打印纸：
韵达快递使用的打印纸分别是100mm*180mm（切点110/70），100mm*203mm（切点152/51），打印纸可由快递网点提供或者在淘宝京东上购买，购买时可选择全白热敏纸。

二、开发接入（TO商家技术开发人员）
1、下载最新快递鸟技术文档和对接攻略
在技术QQ群/快递鸟官网http://kdniao.com/documents下载；
2、参考技术文档开发
2.1 关于请求内容
以java为例：
 

2.2关于韵达客户号接口传值
CustomerName传值客户ID
CustomerPwd传值接口联调密码
客户号配置页需留两个栏位（需正确对应以上两个字段）由发货商家填写，商家自己开发的系统也建议保留配置页，万一账号更换了呢？

2.3 关于快递类型
韵达快递类型如下
 
快递类型  ExpType传值
普通订单    1

2.4关于韵达增值服务传值
代收货款（使用代收货款需要联系网点充值代收面单方可使用）
字段传值："AddService": [{"Name":"COD","Value":"1000"}]
订阅物流节点短信通知
    物流节点短信包含：寄件短信、派件短信、签收短信、问题件短信等；
字段传值：IsSendMessage  0-不需要，1-需要
 短信通知是收费服务，需联系商务同事购买会员套餐或短信套餐后方可使用。

3、电子面单模板样式
韵达快递模板共2个规格，具体如下
二联203（默认模板，TemplateSize传值为空）：
 
二联180（TemplateSize传值180）：
 

4、电子面单模板处理
用户可根据自身的实际情况及未来发展的需要来决定是否需要接口返回模板【参数：IsReturnPrintTemplate  0-不需要，1-需要（默认不返回）】，推荐平台/工具/ERP类用户自行开发设计，直接发货商家使用接口返回的模板，如有特殊需求可自行开发；
4.1 平台性/工具/ERP类用户
因其系统使用商家较多，同一模板无法满足所有商家需求，推荐根据商家需求自行设计面单模板。
优势：灵活性高，不受快递鸟模板变动的影响，商家体验更好
劣势：对用户技术能力有一定要求
4.2 直接发货商家
A、对模板无要求，快递鸟接口返回的模板已能满足的商家，可直接使用。
优势：接入成本低，方便易用，可使用快递鸟批量打印功能
劣势：灵活性不高
B、对模板有一定要求，快递鸟接口返回的模板无法完全满足的商家，可对返回的html模板报文进行处理，或自行设计面单模板样式。
优势：接入成本较低，方便快捷
劣势：对用户技术能力稍有要求

三、接口使用（TO商家系统操作人员）
使用过程中如遇到问题，先联系公司内部技术人员排查，如需快递鸟协助请让技术人员联系。
可能遇到的问题：
1、接口返回“校验码有误”是什么原因？
答：快递公司不支持的特殊字符：'   "   #    &    +  %   \  <   >   
请确认请求数据（包含收寄方姓名、电话、地址、商品名称等所有订单数据）中是否含有以上特殊字符；

2、电子面单下单返回结果false，错误码106，订单号已下单成功？
答：电子面单下单接口订单号OrderCode不能重复使用，重复使用会报错且返回的面单是此订单号上次下单的内容；

3、电子面单返回“暂无打印模板”是什么原因？
答：默认的模板TemplateSize无需传值，非默认模板传对应模板尺寸，不可传值不存在的模板尺寸代码；

4、电子面单生成后可以取消吗？不发货的话单号会作废吗？
答：韵达支持通过电子面单取消接口进行取消，同时快递公司有单号回收机制，未使用的单号会自动回收。具体回收规则请与快递公司网点确认；

5、电子面单接口测试环境顺丰、韵达的可以测通，像申通、安能、宅急送等测试报错是什么原因？
答：测试环境是由快递公司维护，经常调整会不稳定甚至不可用，正式环境可以正常
使用。测试环境是提供给用户调通接口的，所有快递公司的逻辑一样，只要一家调通
接口就没有问题了，测试的话您试下顺丰、EMS就好哈 

6、韵达电子面单接口下单返回“错误：合作方ID不存在”或者"错误：签名不正确”是什么意思？
答：韵达下单报这个错，是电子面单账户异常，需要联系网点拿到正确的客户ID和接口联调密码。

正确样式如：
 
7、韵达电子面单接口无法返回集包地或者下单报错【反序列化】？
答：是您的电子面单账号配置有问题，用户如果首次申请账号时候没有选择订单来源：
快递鸟，下单不会返回集包地，网点无法直接重新配置，只能联系快递公司总部去修
改，快递公司总部联系电话：4008209669转1转2，改成明文即可。

8、韵达电子面单下单成功后模板显示乱码？
  答：是您的电子面单账号配置问题，请联系网点重新配置，或联系快递公司总部修
改，快递公司总部联系电话：4008209669转1转2，改成明文即可。