1、接入前准备（TO商家业务人员）
一、申请快递鸟用户ID和API key
1.1登陆快递鸟官网注册页面http://www.kdniao.com/reg注册快递鸟帐号；
1.2登陆快递鸟用户管理后台，进入“个人会员中心”进行实名认证；
1.3认证成功后，进入“产品服务管理”，开通会员服务（可开通免费套餐测试）。html
二、韵达速递申请电子面单客户号
申请客户号有如下两种方式，互不冲突，任选其一便可；（不支持菜鸟、京东、拼多多电子面单客户号）；
2.1线下与当地韵达网点签定合做协议，并申请韵达自有电子面单客户号；
2.2在快递鸟官网申请，申请路径：用户管理后台——电子面单——申请新的物流服务商——申请韵达快递——填写信息后提交，待快递公司总部审核经过后（通常在2-3个工做日审核经过，如长时间未审核，建议直接联系网点催促审核或进行线下申请），会有短信通知到申请人手机号上，使用前需联系网点充值单号。
2.3网点开通客户号操做流程见下图：
注：获取到的电子面单客户号不须要在快递鸟官网后台添加，直接经过接口传值下单便可；java
三、购买打印机、打印纸
3.1打印机：
电子面单模板对打印机品牌、型号等没有要求，只要是热敏打印机便可，常见品牌如：斑马、得力、快麦、汉印、佳博等。
打印机可由快递网点提供或者在淘宝京东上购买，安装打印机及驱动程序联系打印机提供方；
3.2打印纸：
韵达快递使用的打印纸分别是100mm*180mm（切点110/70），100mm*203mm（切点152/51），打印纸可由快递网点提供或者在淘宝京东上购买，购买时可选择全白热敏纸。工具
2、开发接入（TO商家技术开发人员）
一、下载最新快递鸟技术文档和对接攻略
在技术QQ群/快递鸟官网http://kdniao.com/documents下载；
二、参考技术文档开发
2.1 关于请求内容
以java为例：
测试
2.2关于韵达客户号接口传值
CustomerName传值客户ID
CustomerPwd传值接口联调密码
客户号配置页需留两个栏位（需正确对应以上两个字段）由发货商家填写，商家本身开发的系统也建议保留配置页，万一帐号更换了呢？设计
2.3 关于快递类型
韵达快递类型以下
快递类型 ExpType传值
普通订单 1htm
2.4关于韵达增值服务传值
代收货款（使用代收货款须要联系网点充值代收面单方可以使用）
字段传值："AddService": [{"Name":"COD","Value":"1000"}]
订阅物流节点短信通知
物流节点短信包含：寄件短信、派件短信、签收短信、问题件短信等；
字段传值：IsSendMessage 0-不须要，1-须要
短信通知是收费服务，需联系商务同事购买会员套餐或短信套餐后方可以使用。接口
三、电子面单模板样式
韵达快递模板共2个规格，具体以下
二联203（默认模板，TemplateSize传值为空）：
二联180（TemplateSize传值180）：
开发
四、电子面单模板处理
用户可根据自身的实际状况及将来发展的须要来决定是否须要接口返回模板【参数：IsReturnPrintTemplate 0-不须要，1-须要（默认不返回）】，推荐平台/工具/ERP类用户自行开发设计，直接发货商家使用接口返回的模板，若有特殊需求可自行开发；
4.1 平台性/工具/ERP类用户
因其系统使用商家较多，同一模板没法知足全部商家需求，推荐根据商家需求自行设计面单模板。
优点：灵活性高，不受快递鸟模板变更的影响，商家体验更好
劣势：对用户技术能力有必定要求
4.2 直接发货商家
A、对模板无要求，快递鸟接口返回的模板已能知足的商家，可直接使用。
优点：接入成本低，方便易用，可以使用快递鸟批量打印功能
劣势：灵活性不高
B、对模板有必定要求，快递鸟接口返回的模板没法彻底知足的商家，可对返回的html模板报文进行处理，或自行设计面单模板样式。
优点：接入成本较低，方便快捷
劣势：对用户技术能力稍有要求文档
3、接口使用（TO商家系统操做人员）
使用过程当中如遇到问题，先联系公司内部技术人员排查，如需快递鸟协助请让技术人员联系。
可能遇到的问题：
一、接口返回“校验码有误”是什么缘由？
答：快递公司不支持的特殊字符：' " # & + % \ < >
请确认请求数据（包含收寄方姓名、电话、地址、商品名称等全部订单数据）中是否含有以上特殊字符；产品
二、电子面单下单返回结果false，错误码106，订单号已下单成功？
答：电子面单下单接口订单号OrderCode不能重复使用，重复使用会报错且返回的面单是此订单号上次下单的内容；
三、电子面单返回“暂无打印模板”是什么缘由？
答：默认的模板TemplateSize无需传值，非默认模板传对应模板尺寸，不可传值不存在的模板尺寸代码；
四、电子面单生成后能够取消吗？不发货的话单号会做废吗？
答：韵达支持经过电子面单取消接口进行取消，同时快递公司有单号回收机制，未使用的单号会自动回收。具体回收规则请与快递公司网点确认；
五、电子面单接口测试环境顺丰、韵达的能够测通，像申通、安能、宅急送等测试报错是什么缘由？
答：测试环境是由快递公司维护，常常调整会不稳定甚至不可用，正式环境能够正常
使用。测试环境是提供给用户调通接口的，全部快递公司的逻辑同样，只要一家调通
接口就没有问题了，测试的话您试下顺丰、EMS就好哈
六、韵达电子面单接口下单返回“错误：合做方ID不存在”或者"错误：签名不正确”是什么意思？
答：韵达下单报这个错，是电子面单帐户异常，须要联系网点拿到正确的客户ID和接口联调密码。
正确样式如：
七、韵达电子面单接口没法返回集包地或者下单报错【反序列化】？
答：是您的电子面单帐号配置有问题，用户若是首次申请帐号时候没有选择订单来源：
快递鸟，下单不会返回集包地，网点没法直接从新配置，只能联系快递公司总部去修
改，快递公司总部联系电话：4008209669转1转2，改为明文便可。
八、韵达电子面单下单成功后模板显示乱码？ 答：是您的电子面单帐号配置问题，请联系网点从新配置，或联系快递公司总部修 改，快递公司总部联系电话：4008209669转1转2，改为明文便可。