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

2、申请圆通速递电子面单客户号 申请客户号有以下两种方式，互不冲突，任选其一即可；（不支持菜鸟、京东、拼多多电子面单客户号）； 2.1线下与当地圆通网点签订合作协议，并申请圆通速递自有电子面单客户号；

2.2在快递鸟官网申请，申请路径：用户管理后台——电子面单——申请新的物流服务商——申请圆通快递——填写信息后提交，待快递公司总部审核通过后（一般在2-3个工作日审核通过，如长时间未审核，建议直接联系网点催促审核或进行线下申请），会有短信通知到申请人手机号上，使用前需联系网点充值单号。 注：获取到的电子面单客户号不需要在快递鸟官网后台添加，直接通过接口传值下单即可；

3、购买打印机、打印纸 3.1打印机： 电子面单模板对打印机品牌、型号等没有要求，只要是热敏打印机即可，常见品牌如：斑马、得力、快麦、汉印、佳博等。 打印机可由快递网点提供或者在淘宝京东上购买，安装打印机及驱动程序联系打印机提供方；

3.2打印纸： 圆通速递可以使用的打印纸分别是100mm*180mm（切点110/70）、100mm*180mm（切点 110/30/40），打印纸可由快递网点提供或者在淘宝京东上购买，购买时可选择全白热敏纸。

二、开发接入（TO商家技术开发人员） 1、下载最新快递鸟技术文档和对接攻略 在技术QQ群/快递鸟官网http://kdniao.com/documents下载；

2、参考技术文档开发 2.1 关于请求内容 以java为例：  

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

2.3 关于快递类型 圆通快递类型如下 快递类型ExpType传值 上门揽收1

2.4关于圆通增值服务传值 代收货款 字段传值："AddService": [{"Name":"COD","Value":"1000"}]

订阅物流节点短信通知     物流节点短信包含：寄件短信、派件短信、签收短信、问题件短信等； 字段传值：IsSendMessage  0-不需要，1-需要  短信通知是收费服务，需联系商务同事购买会员套餐或短信套餐后方可使用。

3、电子面单模板样式 圆通速递模板共3个规格，具体如下： 3.1二联180（默认模板，TemplateSize传值为空）：  

3.2三联180（TemplateSize传值180）：  

3.3二联180 新（TemplateSize传值18001）：  

4、电子面单模板处理 用户可根据自身的实际情况及未来发展的需要来决定是否需要接口返回模板【参数：IsReturnPrintTemplate  0-不需要，1-需要（默认不返回）】，推荐平台/工具/ERP类用户自行开发设计，直接发货商家使用接口返回的模板，如有特殊需求可自行开发；

3.1 平台性/工具/ERP类用户 因其系统使用商家较多，同一模板无法满足所有商家需求，推荐根据商家需求自行设计面单模板。 优势：灵活性高，不受快递鸟模板变动的影响，商家体验更好 劣势：对用户技术能力有一定要求

3.2 直接发货商家 A、对模板无要求，快递鸟接口返回的模板已能满足的商家，可直接使用。 优势：接入成本低，方便易用，可使用快递鸟批量打印功能 劣势：灵活性不高 B、对模板有一定要求，快递鸟接口返回的模板无法完全满足的商家，可对返回的html模板报文进行处理，或自行设计面单模板样式。 优势：接入成本较低，方便快捷 劣势：对用户技术能力稍有要求

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

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

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

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

5、圆通电子面单接口下单返“请将和网点申请的密钥串填在MonthCode字段”；“该客户没有生成秘钥,请联系负责网点生成秘钥后重试!”；“203填写的快递公司电子面单账号密码有误，请核实确认”是什么意思？  答：圆通下单报此类错，是电子面单账户异常，排查您的电子面单账户字段传值 必须在CustomerName字段传值商家代码，MonthCode字段传值密钥串，其他 字段不用传值。每家快递公司对应的账号信息传值的字段不同，具体字段可在官网 （http://www.kdniao.com/documents）下载《电子面单客户号参数对照表》进 行查看。