顺丰速运快递查询接⼝API和电⼦⾯单接⼝怎么对接？

除了通过顺丰⾃⼰的接⼝对接外，⽤的最多的就是第三⽅通过快递鸟对接了，通过顺丰单号和⼿机号后四位查询轨迹信息，如果是通过快递鸟下单获得的顺丰单号，可通过单号直接查询，具体下载快递鸟接⼝技术⽂档查看接⼝说明。ShipperCode为SF，且快递单号⾮快递渠道返回时，必填，对应收件⼈/寄件⼈⼿机号后四位；ShipperCode为SF，且快递鸟单号为快递渠道返回时，不填。

⼀、接⼊前准备（TO商家业务⼈员）

1、申请顺丰速运⽉结账号

顺丰⽉结账号需要线下与当地顺丰分部签订收派合同，签定后顺丰会提供10位数字的顺丰⽉结账号，⽤于发货结算运费；      注：获取到的⽉结账号不需要在快递鸟官⽹后台添加，直接通过接⼝传值下单即可；

2、购买打印机、打印纸

3.1打印机：

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

3.2打印纸：

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

⼆、开发接⼊（TO商家技术开发⼈员）

1、参照技术⽂档开发

1.1关于请求内容以java为例：

 1.2关于顺丰⽉结账号接⼝传值

MonthCode传值顺丰⽉结账号（PayType为1、2时不填，为3、4时必填）， PayType传值付款⽅式（包含：1-现付，2-到付，3-⽉结，4-第三⽅付），

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

1.3关于快递类型

顺丰速运快递类型如下： 快递类型ExpType传值顺丰标快1

顺丰特惠2 电商特惠3 四⽇件4 顺丰次晨5 顺丰即⽇6 电商速配7

医药常温11 医药温控12 物流普运13 冷运到家14

⽣鲜速配15

⼤闸蟹专递16 汽配吉运17 重货快运18

⾏邮专列20

医药专运（常温）21 医药专运（温控）22 电商专配28

即⽇220034

物资配送35 汇票专送36

证照专递产品110 顺丰空配112

专线普运125 夜配134

重货包裹154

⼩票零担155

医药常温(陆)195 顺丰微⼩件202 医药快运203

陆运微⼩件204 特惠专配208

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

2、关于顺丰速运增值服务传值

2.1保价：

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

2.2代收货款字段传值：

“AddService”:[{“Name”:”COD”,”Value”:”1000″,”CustomerID”:”1234567891″}]

2.3⼦母件：

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

2.4签回单：

IsReturnSignBill传1表⽰需要签回单，并且会返回对应的SignBillPrintTemplate签回单html模板，默认为0不需要； OperateRequire表⽰回单操作要求(如：签名、盖章、×××复印件等)；

3、预约快递员上门

IsNotice表⽰是否通知快递员上门揽件，0-通知，1-不通知，默认为1；关于是否需要预约快递员上门揽件：

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

3.2如是固定⼏个地点发货，且每天都需要发货，可线下与快递员协商定时定点定⼈上门揽件，接⼝上不需要预约；

3.3如是固定地点发货，只是偶尔发⼏票，⾃⼰打印⾯单则随机预约其中⼀个订单，如需要快递员打印则全部预约（快递员是否能打印取决      于顺丰速运当地⽹点）；

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

4、订阅物流节点短信通知

物流节点短信包含：寄件短信、派件短信、签收短信、问题件短信等； 字段传值：IsSendMessage 0-不需要，1-需要

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

5、电⼦⾯单模板样式

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

三联210(TemplateSize传值210)

 ⼆联150新(TemplateSize传值15001)

⼆联180新(TemplateSize传值180)

 三联210(TemplateSize传值21001)

 6、电⼦⾯单模板处理

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

6.1平台性/⼯具/ERP类⽤户

因其系统使⽤商家较多，同⼀模板⽆法满⾜所有商家需求，推荐根据商家需求⾃⾏设计⾯单模板。   优势：灵活性⾼，不受快递鸟模板变动的影响，商家体验更好

劣势：对⽤户技术能⼒有⼀定要求

6.2直接发货商家

A、对模板⽆要求，快递鸟接⼝返回的模板已能满⾜的商家，可直接使⽤。  优势：接⼊成本低，⽅便易⽤，可使⽤快递鸟批量打印功能

劣势：灵活性不⾼

B、对模板有⼀定要求，快递鸟接⼝返回的模板⽆法完全满⾜的商家，可对返回的html模板报⽂进⾏处理，或⾃⾏设计⾯单模板样式。      优势：接⼊成本较低，⽅便快捷

劣势：对⽤户技术能⼒稍有要求

三、接⼝使⽤（TO商家系统操作⼈员）

使⽤过程中如遇到问题，先联系公司内部技术⼈员排查，如需快递鸟协助请让技术⼈员联系。   可能遇到的问题：

1.1接⼝返回“校验码有误”是什么原因？

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

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

1.2电⼦⾯单下单返回结果false，错误码106，订单号已下单成功？

答：电⼦⾯单下单接⼝订单号OrderCode不能重复使⽤，重复使⽤会报错且返回的⾯单是此订单号上次下单的内容；

1.3电⼦⾯单返回“暂⽆打印模板”是什么原因？

答：默认的模板TemplateSize⽆需传值，⾮默认模板传对应模板尺⼨，不可传不存在的模板尺⼨代码；

1.4电⼦⾯单⽣成后可以取消吗？不发货的话单号会作废吗？

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

1.5调⽤电⼦⾯单时，接⼝返回”您的预约超出今⽇营业时间，⽆法上门取件。”？

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

2、顺丰快递单号查询接⼝对接指南

2.1⽬的

便于快递鸟⽤户理解快递单号查询接⼝作⽤并正确应⽤到实际场景。

接⼝作⽤

轨迹类接⼝包含：即时查询接⼝和物流跟踪接⼝。

即时查询接⼝：实时查询某个快递单号当前的物流状态； 物流跟踪接⼝：监控某个快递单号完整的物流状态。

2.2应⽤场景

可应⽤于电商平台、⾃营商城、ERP、打单⼯具、楼宇/物业系统、云打印、微信⼩程序/公众号、APP、OA等需要查看物流信息的场景。接⼝逻辑

2.3说明：

快递鸟接⼝作为数据中转站，不对物流信息做处理，不做语⾔转换，只对数据字段做转换，分析物流状态；

快递鸟接⼝返回的物流轨迹信息按照发⽣时间的升序排列。

应⽤⽅法：

接⼝返回物流信息后直接展⽰优势：⽅便简单

劣势：受⽹络影响，响应较慢，⽤户体验⽋佳

接⼝返回物流信息后保存在本地数据库，当⽤户查询时调⽤本地数据再做展⽰  优势：本地调⽤响应快，不受⽹络影响，⽤户体验好

劣势：需本地保存应⽤实例

类似微信扫⼀扫查快递，通过扫⼀扫功能扫描⾯单上的条码跟踪物流状态（需结合快递鸟单号识别接⼝使⽤）；——适⽤即时查询接⼝     前端展⽰单号轨迹框，由⽤户填写单号后查询对应物流信息（可结合快递鸟单号识别接⼝使⽤）；——适⽤即时查询接⼝

输⼊顺丰快递单号，显⽰可能属于的快递公司列表选择顺丰快递公司后，展⽰详细的物流信息。

电商平台、⾃营商城等展⽰订单的物流信息，可监控平台商家是否按时发货；——适⽤物流跟踪接⼝APP上展⽰订单流转路径；——适⽤物流跟踪接⼝

发送物流节点短信通知；——适⽤物流跟踪接⼝数据报表；——适⽤物流跟踪接⼝

物流体验：分析每天快件状态，统计揽收率、签收率、问题件率等；——适⽤物流跟踪接⼝

退货险：平台根据快件流转的时间、揽件城市、签收城市等数据判断商家是否虚假退货；——适⽤物流跟踪接⼝

轨迹拼接：转动公司/平台，将海外订单的物流信息和国内清关后的物流信息拼接在⼀起，⽅便买家查询海淘订单；——适⽤物流跟踪接⼝     

3、对接指南

3.1登录快递鸟官⽹注册页⾯注册快递鸟账号

⽹址：​​http://www.kdniao.com/reg

3.2登录快递鸟⽤户管理后台

⽹址：​​快递鸟API让物流接⼝对接更简单​​

注：登录快递鸟⽤户管理后台后获得⽤户ID和APIKey，此⽤于保证应⽤来源的可靠性，避免应⽤伪造，被不法使⽤。       

3.3进⼊“我的会员中⼼”进⾏实名认证

注：

3.1.1认证类型、应⽤类型根据⽤户实际情况选择即可，接⼝返回数据与选择结果⽆关；

3.1.2标记为*的为必填，要求上传清晰、jpg格式且⼩于2M的证件图⽚；

3.1.3技术对接⼈信息为⽤户⽅对接⼯程师的信息；

3.1.4如有其他疑问可进⼊官⽹加⼊商务合作群进⾏咨询。

3.1.5认证成功后，进⼊“产品服务管理”，开通相关会员服务

注：

物流查询（免费版）会员套餐为免费版，有效期1年结束后，如在近3个⽉内有数据交互系统会⾃动免费续期；免费试用地址：​​http://www.kdniao.com/v2/activity/try.aspx

如有其他疑问可进⼊官⽹加⼊商务合作群进⾏咨询。

4、开发对接

4.1即时查询（RequestType：1002/8001）

1. 查看快递公司对应快递鸟的编码可以下载“2019快递鸟接⼝⽀持快递公司编码列表.xlsx”。
2. 接⼝开发可以下载“即时查询demo”进⾏参考（仅提供了.NET、Java、PHP三种语⾔demo）；
3. 接⼝开发可以下载“快递鸟接⼝技术⽂档”进⾏参考；即时查询，参考技术⽂档中的4.1或5.1.1部分；
4. 请求接⼝之前需要先实名认证，开通相关会员服务，否则会请求失败并返回提⽰“未申请开通接⼝”；

注：快递鸟官⽹-帮助与⽂档地址（http://www.kdniao.com/v2/activity/try.aspx​⽂档-快递鸟code接⼝⽂档   ） 快递鸟API接⼝DEMO下载：http://www.kdniao.com/documents-demo​​，快递鸟「即时查询DEMO」让对接更简单