通过快递鸟如何接入申通快递电子面单
一、接入前准备（TO商家业务人员）
1、申请快递鸟用户ID和API key
1.1登录快递鸟官网注册页面http://www.kdniao.com/reg注册快递鸟账号；
1.2登录快递鸟用户管理后台，进入“我的会员中心”进行实名认证；
1.3认证成功后，进入“产品服务管理”，开通会员服务（可开通免费套餐测试）。
2、申请申通快递电子面单客户号
申请申通快递客户号仅有一种方式，直接联系当地的申通网点，在梧桐系统申请（不支持菜鸟、京东、拼多多电子面单客户号）；
2.1线下与当地申通快递网点签订合作协议，并申请申通快递自有电子面单客户号；
2.2申通快递客户号有多种类型，需选购以下任意一种，若快递网点不知如何处理，打总部电话021-60375299：
1、申购22开头的电子面单客户号，并且充值22开头的单号；
2、申购44开头的电子面单客户号，并且充值44开头的单号；
3、申购772开头的电子面单客户号，并且充值772开头的单号。
3、购买打印机、打印纸
3.1打印机：
电子面单模板对打印机品牌、型号等没有要求，只要是热敏打印机即可，常见品牌如：斑马、得力、快麦、汉印、佳博等。
打印机可由快递网点提供或者在淘宝京东上购买，安装打印机及驱动程序联系打印机提供方；
3.2打印纸：
申通快递常用的打印纸是100mm*150mm（切点90/60）、100mm*180mm（切点110/70）、100mm*180mm（切点110/30/40），打印纸可由快递网点提供或者在淘宝京东上购买，购买时可选择全白热敏纸，建议结合自身业务需求和网点实际要求，再选购对应规格的热敏纸。
二、开发接入（TO商家技术开发人员）
1、下载最新快递鸟技术文档和对接攻略
在技术QQ群/快递鸟官网http://kdniao.com/documents下载；
2、关于请求内容
3、参照技术文档开发
3.1 关于申通快递客户号接口传值
CustomerName传值客户简称，
CustomerPwd传值客户密码，
SendSite传值网点名称（纯汉字），
上述填写的信息，必须是申通快递网点的梧桐系统里面的显示，如下图标记：
客户号配置页需留三个栏位（需正确对应以上三个字段）由发货商家填写，商家自己开发的系统也建议保留配置页，万一账号更换了呢？
3.2 关于快递业务类型
申通快递业务类型如下
快递类型ExpType传值
普通订单1
3.3 关于申通增值服务传值
订阅物流节点短信通知
物流节点短信包含：寄件短信、派件短信、签收短信、问题件短信等；
字段传值：IsSendMessage 0-不需要，1-需要
短信通知是收费服务，需联系商务同事购买会员套餐或短信套餐后方可使用。
4、电子面单模板样式
申通模板共4个规格，具体如下
4.1二联150(TemplateSize传值150)
4.2二联180(默认模板返回，TemplateSize为空)
4.3新二联180(TemplateSize传值180)
4.4三联180(TemplateSize传值18003)
5、电子面单模板处理
用户可根据自身的实际情况及未来发展的需要来决定是否需要接口返回模板（参数：IsReturnPrintTemplate 0-不需要，1-需要），推荐平台/工具/ERP类用户自行开发设计，直接发货商家使用接口返回的模板，如有特殊需求可自行开发；
5.1 平台性/工具/ERP类用户
因其系统使用商家较多，同一模板无法满足所有商家需求，推荐根据商家需求自行设计面单模板。
优势：灵活性高，不受快递鸟模板变动的影响，商家体验更好
劣势：对用户技术能力有一定要求
5.2 直接发货商家
A、对模板无要求，快递鸟接口返回的模板已能满足的商家，可直接使用。
优势：接入成本低，方便易用，可使用快递鸟批量打印功能
劣势：灵活性不高
B、对模板有一定要求，快递鸟接口返回的模板无法完全满足的商家，可对返回的html模板报文进行处理，或自行设计面单模板样式。
优势：接入成本较低，方便快捷
劣势：对用户技术能力稍有要求
三、接口使用（TO商家系统操作人员）
使用过程中如遇到问题，务必先联系系统/平台公司内部技术人员排查，如需快递鸟协助请让技术人员联系。
可能遇到的问题：
1、电子面单接口下单返回”单号不足”“余量不足”“没有可用单号”“没有库存”是什么意思？
答：电子面单客户号需有足够的单号才能下单成功，当单号不足时请联系网点进行充值；
2、接口返回“校验码有误”是什么原因？
答：快递公司不支持的特殊字符：' " # & + % \ < >
请确认请求数据（包含收寄方姓名、电话、地址、商品名称等所有订单数据）中是否含有以上特殊字符；
3、电子面单下单返回结果false，错误码106，订单号已下单成功？
答：电子面单下单接口订单号OrderCode不能重复使用，重复使用会报错且返回的面单是此订单号上次下单的内容；
4、电子面单返回“暂无打印模板”是什么原因？
答：默认的模板TemplateSize无需传值，非默认模板传对应模板尺寸，不可传值不存在的模板尺寸代码；
5、电子面单生成后可以取消吗？不发货的话单号会作废吗？
答：快递公司有单号回收机制，未使用的单号会自动回收。具体回收规则请与快递公司网点确认；
6、电子面单下单后返回"该客户没有开通电子面单服务!"或"密码不正确!"？
答：电子面单客户号其中某个数值错误导致，务必核实CustomerName客户简称、CustomerPwd客户密码和SendSite所属网点，是否正确，并且在对应字段传值和充值足够的单号；