一、 接入前准备（TO商家业务人员）

1、 申请快递鸟用户ID和API key

1.1 注册快递鸟账号：http://www.kdniao.com/reg

1.2 进入“我的会员中心”进行实名认证；

1.3 认证成功后，进入“产品服务管理”，开通服务

2、 申请顺丰速运月结账号

顺丰月结账号需要线下与当地顺丰分部签订收派合同，签定后顺丰会提供10位数字的顺丰月结账号，用于发货结算运费；

注：快递鸟官网后台显示的信息和状态（如：“我的物流服务商”页面不显示顺丰或顺丰月结账号）并不影响接口的客户，也不需要在后台添加要使用的客户号，直接通过接口传值下单即可；

3、 购买打印机、打印纸

打印机：

电子面单模板对打印机品牌、型号等没有要求，只要是热敏打印机即可，常见品牌如：斑马、得力、快麦、汉印、佳博等。

打印机可由快递网点提供或者在淘宝京东上购买，安装打印机及驱动程序联系打印机提供方；

打印纸：

顺丰速运使用的打印纸有100mm*150mm（切点90/60）、100mm*180mm（切点110/70）、100mm*210mm（切点90/60/60）三种，打印纸可由快递网点提供或者在淘宝京东上购买，购买时可选择全白热敏纸。

 

二、 开发接入（TO商家技术开发人员）

1、 下载最新快递鸟技术文档和对接攻略

     下载地址：http://kdniao.com/documents

2、 参照技术文档开发

2.1 关于顺丰月结账号接口传值

     MonthCode传值顺丰月结账号（PayType为1、2时不填，为3、4时必填），

     PayType传值付款方式（包含：1-现付，2-到付，3-月结，4-第三方付），

    客户号配置页需留两个栏位（需正确对应以上两个字段）由发货商家填写，商家自己开发的系统也建议保留配置页，万一账号更换了呢？

2.2 关于快递类型

顺丰速运快递类型如下：

快递类型	ExpType传值
顺丰标快	1
顺丰特惠	2
电商特惠	3
四日件	4
顺丰次晨	5
顺丰即日	6
电商速配	7
医药常温	11
医药温控	12
物流普运	13
冷运到家	14
生鲜速配	15
大闸蟹专递	16
汽配吉运	17
重货快运	18
行邮专列	20
医药专运（常温）	21
医药专运（温控）	22
电商专配	28
即日2200	34
物资配送	35
汇票专送	36
证照专递产品	110
顺丰空配	112
专线普运	125
夜配	134
重货包裹	154
小票零担	155
医药常温(陆)	195
医药快运	203

           注：商家的顺丰月结账号是否能发对应的快递类型，请事先和顺丰速运分部人员确认，除1、2、5、6外，其他快递类型都需单独再签协议。

2.3 关于顺丰速运增值服务传值

保价

       字段传值：”AddService”: [{“Name”:”INSURE “,”Value”:”1000″}]

代收货款

        字段传值：”AddService”:[{“Name”:”COD”,”Value”:”1000″,”CustomerID”:”1234567891″}]

子母件

       Quantity传值大于等于2表示子母件，并且会返回对应的SubCount子单数量、SubOrders子单单号、SubPrintTemplates子单html模板；

签回单

       IsReturnSignBill传1表示需要签回单，并且会返回对应的SignBillPrintTemplate签回单html模板，默认为0不需要；

       OperateRequire表示回单操作要求(如：签名、盖章、身份证复印件等)；

预约快递员上门

       IsNotice表示是否通知快递员上门揽件，0-通知，1-不通知，默认为1；

      关于是否需要预约快递员上门揽件：

      1、 如寄件点是全国各地不固定，需要快递员上门揽件则预约（此类情况务必对预约用户做限制，必须本人预约，通过手机验证码验证成功后方可预约，不然会造成用户恶意下单预约，导致顺丰速运投诉）；

      2、 如是固定几个地点发货，且每天都需要发货，可线下与快递员协商定时定点定人上门揽件，接口上不需要预约；

      3、 如是固定地点发货，只是偶尔发几票，自己打印面单则随机预约其中一个订单，如需要快递员打印则全部预约（快递员是否能打印取决于顺丰速运当地网点）；

      注：如出现恶意预约，导致顺丰速运向快递鸟投诉超过3次的，快递鸟将停用用户此接口权限；

订阅物流节点短信通知

     物流节点短信包含：寄件短信、派件短信、签收短信、问题件短信等；

     字段传值：IsSendMessage  0-不需要，1-需要

     短信通知是收费服务，需联系商务同事购买会员套餐或短信套餐后方可使用。

1、 电子面单模板样式

顺丰速运模板共5个规格，具体如下

² 二联150(默认模板，TemplateSize传值为空)

 

² 三联210(TemplateSize传值210)

 

² 二联150新(TemplateSize传值15001)

 

² 二联180新(TemplateSize传值180)

 

² 三联210(TemplateSize传值21001)

 

2、 电子面单模板处理

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

3.1 平台性/工具/ERP类用户

因其系统使用商家较多，同一模板无法满足所有商家需求，推荐根据商家需求自行设计面单模板。

优势：灵活性高，不受快递鸟模板变动的影响，商家体验更好

劣势：对用户技术能力有一定要求

3.2 直接发货商家

A、 对模板无要求，快递鸟接口返回的模板已能满足的商家，可直接使用。

优势：接入成本低，方便易用，可使用快递鸟批量打印功能

劣势：灵活性不高

B、 对模板有一定要求，快递鸟接口返回的模板无法完全满足的商家，可对返回的html模板报文进行处理，或自行设计面单模板样式。

优势：接入成本较低，方便快捷

劣势：对用户技术能力稍有要求

一、 接口使用（TO商家系统操作人员）

使用过程中如遇到问题，先联系公司内部技术人员排查，如需快递鸟协助请让技术人员联系。

可能遇到的问题：

1、 接口返回“校验码有误”是什么原因？

答：快递公司不支持的特殊字符：‘   ”   #    &    +  %     <   >   

请确认请求数据（包含收寄方姓名、电话、地址、商品名称等所有订单数据）中是否含有以上特殊字符；

2、 电子面单下单返回结果false，错误码106，订单号已下单成功？

答：电子面单下单接口订单号OrderCode不能重复使用，重复使用会报错且返回的面单是此订单号上次下单的内容；

3、 电子面单返回“暂无打印模板”是什么原因？

答：默认的模板TemplateSize无需传值，非默认模板传对应模板尺寸，不可传不存在的模板尺寸代码；

4、 电子面单生成后可以取消吗？不发货的话单号会作废吗？

答：下单成功后如不需要发货，直接撕掉面单即可，不需要取消（如果一定要取消可对接”电子面单取消接口”），快递员揽件后才收费，单号不收费；

5、 调用电子面单时，接口返回“不可派送”？

答：不可派送表示派件地址不在顺丰速运服务范围，具体收派范围可在顺丰速运官网查看http://www.sf-express.com/cn/sc/dynamic_function/range/，可更换其他快递发货；

6、 调用电子面单时，接口返回”您的预约超出今日营业时间，无法上门取件。”？

答：顺丰速运每个区域每个分部上门取件的服务时间不固定，建议更换时间预约，一般预约9：00—17：00内；