快递鸟物流接口技术文档

1、快递鸟接接口(AAPI)技术文文档版本日期版本说明作者20144-122-0113.0重新整理理，根据据功能分分类，部部分有调调整杨文胜20144-011-1113.1对接口的的说明进进行了注注释，提提高可读读性杨汉汶20144-011-1333.2新增推送送接口杨汉汶20155-033-1113.3新增批量量订阅推推送接口口，删除除3.22版本推推送接口口杨文胜20155-100-1223.4新增订单单分发接接口，整整理电子子面单接接口曹强20166-011-1993.5重新调整整在线下下单接口口曹强20166-033-0113.6增加智选选物流接接口曹强20166-033-0113.7分发

2、及订订阅接口口更新任海洋20166-044-0773.7.1推送接口口更新任海洋20166-055-1113.7.2电子面单单新增通通知快递递员上门门字段，推送接接口新增增货款状状态推送送詹益伟20166-077-0114.0全新4.0接口口，新增增单号识识别接口口、智选选物流接接口、更更新物流流轨迹接接口（订订阅查询询）詹益伟20166-9-264.0.1推送接口口新增DataaSiggn字段段、订阅阅2.00新增仓仓库标识识ID、智选物物流接口口新增字字段胡蕾蕾20166-111-0334.1新增在途途监控（增值服服务）曹强20166-122-1334.1.1电子面单单新增第第三方订订单号

3、TThrOOrdeerCoode胡蕾蕾20177-1-104.2新增隐私私快递胡蕾蕾20177-2-164.2.1新增代收收货款业业务胡蕾蕾20177-4-134.31、即时时查询接接口中轨轨迹状态态新增00-无轨轨迹 2、普通通回调接接口中删删除2001状态态3、修改改智选物物流接口口文档4、电子子面单接接口添加加特殊字字符提示示陈爱20177-4-254.4新增申请请电子面面单客户户号接口口新增电子子面单余余额查询询接口新增电子子面单单单号回收收接口新增申请请客户号号信息推推送接口口陈爱20177-6-224.5新增短信信接口李旭安20177-7-144.6电子面单单接口新新增支持持邮政快

4、快递包裹裹吴明名词定义义必须要求求说明R必填（RRequuireed）。O可选（OOptiionaal）C报文中该该参数在在一定条条件下可可选（CCondditiionaal）TOC o 1-5 h z u HYPERLINK l _Toc487812473 1前言言 PAGEREF _Toc487812473 h 7 HYPERLINK l _Toc487812474 2概述述 PAGEREF _Toc487812474 h 8 HYPERLINK l _Toc487812475 2.1用户使使用流程程图 PAGEREF _Toc487812475 h 8 HYPERLINK l _Toc4

5、87812476 2.2接口规规范及说说明 PAGEREF _Toc487812476 h 9 HYPERLINK l _Toc487812477 2.2.1报文及及报文编编码 PAGEREF _Toc487812477 h 9 HYPERLINK l _Toc487812478 2.2.2接入步步骤 PAGEREF _Toc487812478 h 10 HYPERLINK l _Toc487812479 2.2.3接口数数据包结结构 PAGEREF _Toc487812479 h 11 HYPERLINK l _Toc487812480 2.2.4JSOON 范范例 PAGEREF _Toc

6、487812480 h 11 HYPERLINK l _Toc487812481 2.2.5流程示示意图 PAGEREF _Toc487812481 h 12 HYPERLINK l _Toc487812482 2.2.6网关地地址 PAGEREF _Toc487812482 h 12 HYPERLINK l _Toc487812483 2.3签名说说明 PAGEREF _Toc487812483 h 12 HYPERLINK l _Toc487812484 2.3.1关于签签名 PAGEREF _Toc487812484 h 12 HYPERLINK l _Toc487812485 2.3.

7、2(C#)DaataSSignn签名加加密代码码 PAGEREF _Toc487812485 h 13 HYPERLINK l _Toc487812486 3下单单 PAGEREF _Toc487812486 h 15 HYPERLINK l _Toc487812487 3.1预约取取件接口口 PAGEREF _Toc487812487 h 15 HYPERLINK l _Toc487812488 3.1.1功能说说明 PAGEREF _Toc487812488 h 15 HYPERLINK l _Toc487812489 3.1.2接口规规则 PAGEREF _Toc487812489 h

8、15 HYPERLINK l _Toc487812490 3.1.3系统级级和应用用级输入入参数 PAGEREF _Toc487812490 h 15 HYPERLINK l _Toc487812491 3.1.4返回结结果参数数 PAGEREF _Toc487812491 h 18 HYPERLINK l _Toc487812492 3.1.5Jsoon请求求示例 PAGEREF _Toc487812492 h 18 HYPERLINK l _Toc487812493 3.1.6Jsonn请求返返回示例例 PAGEREF _Toc487812493 h 19 HYPERLINK l _Toc

9、487812494 3.2电子面面单 PAGEREF _Toc487812494 h 20 HYPERLINK l _Toc487812495 3.2.1功能说说明 PAGEREF _Toc487812495 h 20 HYPERLINK l _Toc487812496 3.2.2接口规规则 PAGEREF _Toc487812496 h 20 HYPERLINK l _Toc487812497 3.2.3系统级级和应用用级输入入参数 PAGEREF _Toc487812497 h 20 HYPERLINK l _Toc487812498 3.2.4返回结结果参数数 PAGEREF _Toc4

10、87812498 h 24 HYPERLINK l _Toc487812499 3.3电子面面单余量量查询接接口 PAGEREF _Toc487812499 h 25 HYPERLINK l _Toc487812500 3.3.1功能说说明 PAGEREF _Toc487812500 h 25 HYPERLINK l _Toc487812501 3.3.2接口规规则 PAGEREF _Toc487812501 h 25 HYPERLINK l _Toc487812502 3.3.3系统级级和应用用级输入入参数 PAGEREF _Toc487812502 h 25 HYPERLINK l _To

11、c487812503 3.3.4返回结结果参数数 PAGEREF _Toc487812503 h 26 HYPERLINK l _Toc487812504 3.3.5JSOON请求求示例 PAGEREF _Toc487812504 h 26 HYPERLINK l _Toc487812505 3.3.6JSOON返回回示例 PAGEREF _Toc487812505 h 26 HYPERLINK l _Toc487812506 3.4电子面面单单号号取消 PAGEREF _Toc487812506 h 27 HYPERLINK l _Toc487812507 3.4.1功能说说明 PAGERE

12、F _Toc487812507 h 27 HYPERLINK l _Toc487812508 3.4.2接口规规则 PAGEREF _Toc487812508 h 27 HYPERLINK l _Toc487812509 3.4.3系统级级和应用用级输入入参数 PAGEREF _Toc487812509 h 27 HYPERLINK l _Toc487812510 3.4.4返回结结果参数数 PAGEREF _Toc487812510 h 28 HYPERLINK l _Toc487812511 3.4.5Jsoon请求求示例 PAGEREF _Toc487812511 h 28 HYPERL

13、INK l _Toc487812512 3.4.6Jsoon请求求返回示示例 PAGEREF _Toc487812512 h 28 HYPERLINK l _Toc487812513 3.5申请电电子面单单客户号号 PAGEREF _Toc487812513 h 28 HYPERLINK l _Toc487812514 3.5.1功能说说明 PAGEREF _Toc487812514 h 28 HYPERLINK l _Toc487812515 3.5.2接口规规则 PAGEREF _Toc487812515 h 29 HYPERLINK l _Toc487812516 3.5.3系统级级和应

14、用用级输入入参数 PAGEREF _Toc487812516 h 29 HYPERLINK l _Toc487812517 3.5.4返回结结果参数数 PAGEREF _Toc487812517 h 30 HYPERLINK l _Toc487812518 3.5.5Jsoon请求求示例 PAGEREF _Toc487812518 h 30 HYPERLINK l _Toc487812519 3.5.6Jsoon请求返返回示例例 PAGEREF _Toc487812519 h 30 HYPERLINK l _Toc487812520 3.6申请客客户号信信息推送送 PAGEREF _Toc48

15、7812520 h 31 HYPERLINK l _Toc487812521 3.6.1功能说说明 PAGEREF _Toc487812521 h 31 HYPERLINK l _Toc487812522 3.6.2接口规规则 PAGEREF _Toc487812522 h 31 HYPERLINK l _Toc487812523 3.6.3系统级级和应用用级输入入参数 PAGEREF _Toc487812523 h 31 HYPERLINK l _Toc487812524 3.6.4返回结结果参数数 PAGEREF _Toc487812524 h 31 HYPERLINK l _Toc487

16、812525 3.6.5Jsoon请求求示例 PAGEREF _Toc487812525 h 32 HYPERLINK l _Toc487812526 3.6.6Jsoon请求求返回示示例 PAGEREF _Toc487812526 h 32 HYPERLINK l _Toc487812527 3.7增值服服务列表表 PAGEREF _Toc487812527 h 32 HYPERLINK l _Toc487812528 3.8安全号号码接口口 PAGEREF _Toc487812528 h 33 HYPERLINK l _Toc487812529 3.8.1功能说说明 PAGEREF _To

17、c487812529 h 33 HYPERLINK l _Toc487812530 3.8.2接口规规则 PAGEREF _Toc487812530 h 33 HYPERLINK l _Toc487812531 3.8.3系统级级和应用用级输入入参数 PAGEREF _Toc487812531 h 33 HYPERLINK l _Toc487812532 3.8.4返回结结果参数数 PAGEREF _Toc487812532 h 35 HYPERLINK l _Toc487812533 3.8.5JSOON请求求示例 PAGEREF _Toc487812533 h 35 HYPERLINK l

18、 _Toc487812534 3.8.6JSOON请求求返回示示例 PAGEREF _Toc487812534 h 36 HYPERLINK l _Toc487812535 4轨迹迹查询 PAGEREF _Toc487812535 h 37 HYPERLINK l _Toc487812536 4.1物流轨轨迹（即即时查询询） PAGEREF _Toc487812536 h 37 HYPERLINK l _Toc487812537 4.1.1功能说说明 PAGEREF _Toc487812537 h 37 HYPERLINK l _Toc487812538 4.1.2接口规规则 PAGEREF

19、_Toc487812538 h 37 HYPERLINK l _Toc487812539 4.1.3系统级级和应用用级输入入参数 PAGEREF _Toc487812539 h 37 HYPERLINK l _Toc487812540 4.1.4返回结结果参数数 PAGEREF _Toc487812540 h 37 HYPERLINK l _Toc487812541 4.1.5JSOON请求求示例 PAGEREF _Toc487812541 h 38 HYPERLINK l _Toc487812542 4.1.6JSOON返回回示例 PAGEREF _Toc487812542 h 38 HYP

20、ERLINK l _Toc487812543 4.2物流轨轨迹（订订阅查询询） PAGEREF _Toc487812543 h 40 HYPERLINK l _Toc487812544 4.2.1功能说说明 PAGEREF _Toc487812544 h 40 HYPERLINK l _Toc487812545 4.2.2接口规规则 PAGEREF _Toc487812545 h 40 HYPERLINK l _Toc487812546 4.2.3系统级级和应用用级输入入参数 PAGEREF _Toc487812546 h 40 HYPERLINK l _Toc487812547 4.2.4返

21、回结结果参数数 PAGEREF _Toc487812547 h 43 HYPERLINK l _Toc487812548 4.2.5JSOON请求求示例 PAGEREF _Toc487812548 h 43 HYPERLINK l _Toc487812549 4.2.6JSOON返回回示例 PAGEREF _Toc487812549 h 44 HYPERLINK l _Toc487812550 5异步步推送（回调）接口 PAGEREF _Toc487812550 h 45 HYPERLINK l _Toc487812551 5.1功能说说明 PAGEREF _Toc487812551 h 45

22、 HYPERLINK l _Toc487812552 5.2接口规规则 PAGEREF _Toc487812552 h 45 HYPERLINK l _Toc487812553 5.3系统级级和应用用级输入入参数 PAGEREF _Toc487812553 h 45 HYPERLINK l _Toc487812554 5.3.1订阅查查询结果果（ReequeestTTypee：1011） PAGEREF _Toc487812554 h 46 HYPERLINK l _Toc487812555 5.3.2订阅查查询（增增值版）结果（ReqquesstTyype：1022） PAGEREF _To

23、c487812555 h 47 HYPERLINK l _Toc487812556 5.3.3货款状状态（RRequuesttTyppe：1077） PAGEREF _Toc487812556 h 48 HYPERLINK l _Toc487812557 5.4返回结结果参数数 PAGEREF _Toc487812557 h 49 HYPERLINK l _Toc487812558 5.5JSOON请求求示例 PAGEREF _Toc487812558 h 49 HYPERLINK l _Toc487812559 5.6JSOON返回回示例 PAGEREF _Toc487812559 h 53

24、 HYPERLINK l _Toc487812560 6智能能服务 PAGEREF _Toc487812560 h 53 HYPERLINK l _Toc487812561 6.1智智选物流流 PAGEREF _Toc487812561 h 53 HYPERLINK l _Toc487812562 6.1.1.功功能说明明 PAGEREF _Toc487812562 h 53 HYPERLINK l _Toc487812563 6.1.2.接接口规则则 PAGEREF _Toc487812563 h 53 HYPERLINK l _Toc487812564 6.1.3.应应用级输输入参数数 P

25、AGEREF _Toc487812564 h 54 HYPERLINK l _Toc487812565 6.1.4.返返回结果果参数 PAGEREF _Toc487812565 h 56 HYPERLINK l _Toc487812566 6.1.5.JJSONN请求示示例 PAGEREF _Toc487812566 h 57 HYPERLINK l _Toc487812567 6.1.6.JJSONN返回示示例 PAGEREF _Toc487812567 h 59 HYPERLINK l _Toc487812568 6.2运运费模板板导入接接口 PAGEREF _Toc487812568 h

26、 61 HYPERLINK l _Toc487812569 6.2.1.功功能说明明 PAGEREF _Toc487812569 h 61 HYPERLINK l _Toc487812570 6.2.2.接接口规则则 PAGEREF _Toc487812570 h 61 HYPERLINK l _Toc487812571 6.2.3.系系统级输输入参数数 PAGEREF _Toc487812571 h 61 HYPERLINK l _Toc487812572 6.2.4.应应用级输输入参数数 PAGEREF _Toc487812572 h 62 HYPERLINK l _Toc48781257

27、3 6.2.5.返返回结果果参数 PAGEREF _Toc487812573 h 63 HYPERLINK l _Toc487812574 6.2.6.JJSONN请求示示例 PAGEREF _Toc487812574 h 63 HYPERLINK l _Toc487812575 6.2.7.JJSONN返回示示例 PAGEREF _Toc487812575 h 64 HYPERLINK l _Toc487812576 6.3单单号识别别 PAGEREF _Toc487812576 h 65 HYPERLINK l _Toc487812577 6.3.1.功功能说明明 PAGEREF _Toc

28、487812577 h 65 HYPERLINK l _Toc487812578 6.3.2.接接口规则则 PAGEREF _Toc487812578 h 65 HYPERLINK l _Toc487812579 6.3.3.系系统级和和应用级级输入参参数 PAGEREF _Toc487812579 h 65 HYPERLINK l _Toc487812580 6.3.4.返返回结果果参数 PAGEREF _Toc487812580 h 66 HYPERLINK l _Toc487812581 7在途途监控（增值版版） PAGEREF _Toc487812581 h 66 HYPERLINK

29、l _Toc487812582 7.1物流轨轨迹（即即时查询询增值版版） PAGEREF _Toc487812582 h 66 HYPERLINK l _Toc487812583 7.1.1功能说说明 PAGEREF _Toc487812583 h 66 HYPERLINK l _Toc487812584 7.1.2接口规规则 PAGEREF _Toc487812584 h 66 HYPERLINK l _Toc487812585 7.1.3系统级级和应用用级输入入参数 PAGEREF _Toc487812585 h 67 HYPERLINK l _Toc487812586 7.1.4返回结结

30、果参数数 PAGEREF _Toc487812586 h 67 HYPERLINK l _Toc487812587 7.1.5JSOON请求求示例 PAGEREF _Toc487812587 h 68 HYPERLINK l _Toc487812588 7.1.6JSOON返回回示例 PAGEREF _Toc487812588 h 68 HYPERLINK l _Toc487812589 7.2物流轨轨迹（订订阅查询询增值版版） PAGEREF _Toc487812589 h 70 HYPERLINK l _Toc487812590 7.2.1功能说说明 PAGEREF _Toc4878125

31、90 h 70 HYPERLINK l _Toc487812591 7.2.2接口规规则 PAGEREF _Toc487812591 h 71 HYPERLINK l _Toc487812592 7.2.3系统级级和应用用级输入入参数 PAGEREF _Toc487812592 h 71 HYPERLINK l _Toc487812593 7.2.4返回结结果参数数 PAGEREF _Toc487812593 h 74 HYPERLINK l _Toc487812594 7.2.5JSOON请求求示例 PAGEREF _Toc487812594 h 74 HYPERLINK l _Toc487

32、812595 7.2.6JSOON返回回示例 PAGEREF _Toc487812595 h 75 HYPERLINK l _Toc487812596 8短信信 PAGEREF _Toc487812596 h 75 HYPERLINK l _Toc487812597 8.1短信发发送 PAGEREF _Toc487812597 h 75 HYPERLINK l _Toc487812598 8.1.1功能说说明 PAGEREF _Toc487812598 h 75 HYPERLINK l _Toc487812599 8.1.2接口规规则 PAGEREF _Toc487812599 h 75 HY

33、PERLINK l _Toc487812600 8.1.3返回结结果参数数 PAGEREF _Toc487812600 h 76 HYPERLINK l _Toc487812601 8.1.4JSOON请求求示例 PAGEREF _Toc487812601 h 76 HYPERLINK l _Toc487812602 8.1.5JSOON返回回示例 PAGEREF _Toc487812602 h 77 HYPERLINK l _Toc487812603 8.2短信模模板 PAGEREF _Toc487812603 h 77 HYPERLINK l _Toc487812604 8.2.1功能说说

34、明 PAGEREF _Toc487812604 h 77 HYPERLINK l _Toc487812605 8.2.2接口规规则 PAGEREF _Toc487812605 h 77 HYPERLINK l _Toc487812606 8.2.3系统级级和应用用级输入入参数 PAGEREF _Toc487812606 h 77 HYPERLINK l _Toc487812607 8.2.4返回结结果参数数 PAGEREF _Toc487812607 h 78 HYPERLINK l _Toc487812608 8.2.5JSOON请求求示例 PAGEREF _Toc487812608 h 7

35、8 HYPERLINK l _Toc487812609 8.2.6JSOON返回回示例 PAGEREF _Toc487812609 h 79 HYPERLINK l _Toc487812610 8.3短信黑黑名单 PAGEREF _Toc487812610 h 79 HYPERLINK l _Toc487812611 8.3.1功能说说明 PAGEREF _Toc487812611 h 79 HYPERLINK l _Toc487812612 8.3.2接口规规则 PAGEREF _Toc487812612 h 79 HYPERLINK l _Toc487812613 8.3.3系统级级和应用

36、用级输入入参数 PAGEREF _Toc487812613 h 79 HYPERLINK l _Toc487812614 8.3.4返回结结果参数数 PAGEREF _Toc487812614 h 80 HYPERLINK l _Toc487812615 8.3.5JSOON请求求示例 PAGEREF _Toc487812615 h 80 HYPERLINK l _Toc487812616 8.3.6JSOON返回回示例 PAGEREF _Toc487812616 h 81 HYPERLINK l _Toc487812617 9附录录 PAGEREF _Toc487812617 h 81 HY

37、PERLINK l _Toc487812618 9.1快递公公司编码码 PAGEREF _Toc487812618 h 81 HYPERLINK l _Toc487812619 9.2常见问问题解答答Q&AA PAGEREF _Toc487812619 h 81 HYPERLINK l _Toc487812620 9.3电子面面单模板板规格 PAGEREF _Toc487812620 h 81 HYPERLINK l _Toc487812621 9.4返回编编码列表表 PAGEREF _Toc487812621 h 83 HYPERLINK l _Toc487812622 10技技术支持持 P

38、AGEREF _Toc487812622 h 83前言快递鸟鸟APII旨在为为电商、电商平平台、物物流工具具、仓储储系统等等等系统统提供专专业、稳稳定、优优质的物物流服务务，为不不同的用用户量身身定做了了专业的的APII接口服服务，供供不同的的用户各各取所需需。本文档档就各个个APII接口进进行详细细的说明明，方便便快递鸟鸟的用户户快速对对接，方方便快捷捷使用快快递鸟服服务。概述用户使用用流程图图快递鸟AAPI全全流程服服务（电电商）流流程图基于电商商现有的的服务流流程，快快递鸟为为电商、电商平平台、EERP系系统、仓仓储系统统等系统统在用户户下单、选择物物流、下下单、打打单、轨轨迹跟踪踪等关

39、键键节点，均提供供了专业业、高效效的APPI接口口，方便便各个平平台实现现一次接接入，便便可使用用国内外外主流物物理公司司的服务务。快递鸟AAPI全全流程服服务（工工具）流流程图对于物流流工具，基于用用户的操操作习惯惯，只需需要输入入单号，快递鸟鸟即可完完成后续续的物流流公司识识别、查查询轨迹迹等工作作，为工工具类用用户提供供一站式式的服务务。接口规范范及说明明报文及报报文编码码Jsoon格式式。编码格格式：UUTF-8交互协协议上统统一用UUTF-8，避避免传递递中文数数据出现现乱码。接入步骤骤 注册成成为快递递鸟用户户(注：注注册成功功后进行行实名认认证，申申请开通通接口，后续会会再对用用

40、户的注注册信息息进行审审批)。注册成成功后，登录用用户管理理后台就就可以查查看到用用户所属属唯一的的商户IID和APII keey。按照快递递鸟官网网提示进进行注册册申请，注册成成功后登登录用户户管理后后台，您您将得到到由快递递鸟提供供的一组组商户IID和APII Keey。商户IID是调调用接口口服务的的身份证证明，不不可更改改、不可可转用，APII Keey是应应用访问问APII的签名名附加密密钥，必必须妥善善保存。两者关关系类似似于登录录帐号和和密码，两者都都会在签签名和业业务参数数中使用用。注册成功功登录用用户管理理后台可可以查看看商户IID和AAPI Keyy，需实实名认证证后才能能

41、申请开开通接口口。开发服务务开发自身身业务的的服务，服务需需遵循接口口的定义义规则。查看接口口调用的的DEMMO快递鸟物物流技术术接口提提供调用用快递鸟鸟物流接接口的DDEMOO(.Neet版本本，Jaava版版本，PPHP版版本)，包括网网上在线线订单下下单、物物流轨迹迹查询等等物流行行业标准准化的下下单操作作流程与与数据查查询格式式。提交交接入处处理的相相关代码码如有不不明白的的地方可可与快递递鸟物流流技术接接口人协协作开发发。DEMOO下载地地址：hhttpp:/wwww.kddniaao.ccom/dowwnlooad (如链链接无法法打开，请打开开浏览器器，在浏浏览器中中输入)接口数

42、据据包结构构图例 - 数据据包结构构 (系系统级数据)JSONN 范例例strringg usserIID = 1110992599;strringgkeyyVallue = 56dda2ccf8-c8aa2-444b22-b66fa-4766cd77d1bba177;/加加密私钥钥，由发发货通提提供strringg urrl = hhttpp:/apii.kddniaao.ccc/EEbussineess/EbuusinnesssOrdderHHanddle.asppx; /请求求地址strringg DaataTTypee =2; 2-jsoonstrringg chharsset=UTT

43、F-88;/字字符编码码采用UUTF-8striingjsoonSttr=OrrderrCodde:,SShippperrCodde:SF,LoogissticcCodde:1188461198888077;/ JSOON字符符串sttrinng dataasiggn=HtttpUttiliity.UrllEnccodee(baase664( MD55(jssonSStr+keyyVallue, UUTF-8),UUTF-8),Enncoddingg.UTTF8);/把(jsoonSttr+AAppKKey)进行MMD5加加密，然然后Baase664编码码，最后后 进行行URLL(uttf-8

44、8)编码码striing PosstSttr = RRequuesttTyppe=110022&EBBusiinesssIDD= uuserrID &ReequeestDDataa=jssonSStr &DaataSSignn= ddataasiggn&DDataaTyppe=DDataaTyppe; /请求报报文参数数striing posst = thhis.DoPPostt(urrl, PosstSttr);/ 通讯协协议使用用Htttp协议议Posst请求求方式流程示意意图网关地址址测试接口口：htttp:/teestaapi.kdnniaoo.ccc:80081/Ebuusinnes

45、ss/EbbusiinesssOrrderrHanndlee.asspx测试电商商ID=122371100，ApppKeyy=5518aa73dd8-11f7ff-4441a-b6444-333e777b449d8846正式接口口：htttp:/appi.kkdniiao.cc/Ebuusinnesss/EbbusiinesssOrrderrHanndlee.asspx签名说明明关于签名名快递鸟和和第三方方电子商商务公司司系统进进行对接接，有一定的的安全机机制。采用IIP认证证加签名名的方式式对接，具体方方案如下下：防止数据据被篡改改在POSST请求求中会传传递5个必须须（R）参数Requue

46、sttDatta=数据内内容(UURL编编码:UUTF-8)EBussineessIID=电商IIDRequuesttTyppe=请请求指令令类型DataaSiggn=数据内内容签名名：把（请求内内容（未未编码）+AppiKeey）进进行MDD5加密密，然后后Basse644编码，最后进进行URRL（uutf-8）编编码DaataTTypee=返返回数据据类型(2-jjsonn)注：DaataSSignn生成后，对方方接收到到数据后后，以同同样的算算法进行行签名，生成摘摘要，对对比两者者的摘要要是否相相同，如如果不同同，说明明传递过过程中发发生数据据篡改，对接过过程中如如有不明明白之处处可双方

47、方技术协协作进行行调用接口口的身份份认证注册成为为快递鸟鸟用户后后，会生生成对应应的电商商ID和和ApppKeyy，电商IID相当当于用户户名，AAppKKey相相当于密密码。注注：请勿勿遗漏或或传递可可能递增增大快递递鸟接口口调用维护护举例说明明：假设ReequeestDDataa(JSOON)内容为为： “OrrderrCodde”:”,“ShhippperCCodee”:”SF”,”LoogissticcCodde”:1118995499075573经过过URLL(UTTF-88)编码码的内容容为%77b%227OrrderrCodde%227%33a%227%227%22c%227Sh

48、hippperCCodee%277%3aa%277SF%27%2c%27LLogiistiicCoode%27%3a%271118995499075573%27%7d，EBuusinnesssID为为110092559，ApppKeyy为56dda2ccf8-c8aa2-444b22-b66fa-4766cd77d1bba177那么DaataSSignn签名的的内容为为OrrderrCodde:,ShhippperCCodee:SF,LLogiistiicCoode:1118995499075573566da22cf88-c88a2-44bb2-bb6faa-4776cdd7d11ba117，

49、经经过mdd5和basse644后的内内容就为为OWFFhM22I5NN2ViiM2UU2MGGRkMMjc44YzUU2NmmVlZZWI33ZDkk0MmmE=，在经过过URLL(UTTF-88)编码码的内容容为OWWFhMM2I55N2VViM22U2MMGRkkMjcc4YzzU2NNmVllZWII3ZDDk0MMmE%3d最最终要发发送的数数据为RRequuesttTyppe=110022&EBuusinnesssID=110092559&ReqquesstDaata =%77b%227OrrderrCodde%227%33a%227%227%22c%227ShhippperCCo

50、dee%277%3aa%277SF%27%2c%27LLogiistiicCoode%27%3a%271118995499075573%27%7d &DaataSSignn=OWFFhM22I5NN2ViiM2UU2MGGRkMMjc44YzUU2NmmVlZZWI33ZDkk0MmmE%33d& DaataTTypee=2接收方收收到数据据后，获获得EBBusiinesssIDD和ReqquesstDaata和和DattaSiign等等这几个个数据。接收方对对EBuusinnesssID得到AAppKKey，ReqquesstDaata+ApppKeyy的数据据进行mmd5和和basse64

51、4后的内内容就为为OWFFhM22I5NN2ViiM2UU2MGGRkMMjc44YzUU2NmmVlZZWI33ZDkk0MmmE=接收方判判断签名名后的数数据跟传传递过来来的DaataSSignn是否一一致，如如果一致致进行业业务操作作，如果果不一致致返回错错误。(C#)DattaSiign签签名加密密代码/电电商Siign签签名/内容/Apppkeey/URLL编码 /DDataaSiggn签名名Publlic Strringg Enncryypt (Sttrinng cconttentt, SStriing keyyVallue, Sttrinng ccharrsett)if (key

52、yVallue != nulll)retuurn basse644(MDD5(cconttentt + keyyVallue, chharsset), ccharrsett);retuurn basse644(MDD5(cconttentt, ccharrsett), chaarseet);/ 字符串串MD55加密/要加密密的字符符串/密密文Privvatee sttrinng MMD5(strringg Teext, sttrinng ccharrsett)bytee buffferr = Sysstemm.Teext.Enccodiing.GettEnccodiing(chaarseet)

53、.GettByttes(Texxt);trySysstemm.Seecurrityy.Crrypttogrraphhy.MMD5CCrypptoSServviceeProovidder cheeck;cheeck = nnew Sysstemm.Seecurrityy.Crrypttogrraphhy.MMD5CCrypptoSServviceeProovidder();bytee sommme = cchecck.CCompputeeHassh(bbufffer);striing rett = ;foreeachh (bbytee a in sommme)if (a 166)rett +=

54、00 + a.ToSStriing(X);elseerett += a.ToSStriing(X);retuurn rett.TooLowwer();catcch throow; Privvatee sttatiic sstriing basse644(Sttrinng sstr, Sttrinng ccharrsett)retuurnCConvvertt.TooBasse644Strringg(Syysteem.TTextt.Enncoddingg.GeetEnncoddingg(chharsset).GeetByytess(sttr);下单预约取件件接口功能说明明预约取取件接口口是快递鸟鸟

55、提供给给独立电商商、仓储储管理系系统、物物流供应应链等物物流系统统平台使使用的下下单接口口，为客客户解决决在线发发货需求求，客户户通过网网络选择择快递公公司发送送请求通通知贵公公司有快快递要发发货，贵贵公司把把数据通通过此接接口转发发到快递递鸟，由由快递鸟鸟为您提提供通知知快递员员上门取取件的服服务。接口规则则(1)、订单单编号(OrdderCCodee)不可可重复提提交，重重复提交交系统会会返回具具体错误误代码。 (2)、目前前预约取取件接口口支持了了：德邦邦、EMMS、天天地华宇宇、百世世快递、京东、龙邦快快递、顺顺丰快递递、中通通速递、韵达快快递、圆圆通速递递、宅急急送，后后续更多多的快

56、递递公司正正在对接接中。 (3)、接口口只支持持Jsoon格式式参数，接口指指令10001。只支持持POSST请求求方式，utff-8编编码。 (4)、支持持增值服服务，保保价、代代收货款款、货款款直退、货款垫垫付等。(5)、测试地地址：hhttpp:/tesstappi.kkdniiao.cc:80881/aapi/oorrderrserrvicce/正式式地址：htttp:/appi.kkdniiao.cc/apii/ooordeerseerviice系统级和和应用级级输入参参数系统级输输入参数数应用级输输入参数数类型是否必须须描述RequuesttDatta（必必填参数数，请求求内容，J

57、SOON格式式,须和和DattaTyype一一致）WareehouuseIIDStriingO仓库标识识(备用用字段)WareehouuseAAddrresssStriingO仓库地址址(备用用字段)CalllBacckStriingO商户标识识(备用用字段)MembberIIDStriingO会员标识识(备用用字段)ShippperrCoddeStriingR快递公司司编码LogiistiicCoodeStriingO快递单号号OrdeerCoodeStriingR订单编号号MontthCoodeStriingC月结编码码PayTTypeeIntR邮费支付付方式:1-现付付，2-到付，3-月

58、月结，44-第三三方支付付ExpTTypeeIntR快递类型型：1-标准快快件CosttDoubbleO寄件费（运费）OtheerCoostDoubbleO其他费用用ReceeiveerComppanyyStriingO收件人公公司NameeStriingR收件人TelStriingR电话与手手机，必必填一个个MobiileStriingPosttCoddeStriingO收件人邮邮编ProvvincceNaameStriingR收件省（如广东东省，不不要缺少少“省”）CityyNammeStriingR收件市（如深圳圳市，不不要缺少少“市”）ExpAAreaaNammeStriingO收件区

59、（如福田田区，不不要缺少少“区”或“县”）AddrresssStriingR收件人详详细地址址SendderComppanyyStriingO发件人公公司NameeStriingR发件人TelStriingR电话与手手机，必必填一个个MobiileStriingPosttCoddeStriingO发件人邮邮编ProvvincceNaameStriingO发件省（如广东东省，不不要缺少少“省”）CityyNammeStriingR发件市（如深圳圳市，不不要缺少少“市”）ExpAAreaaNammeStriingO发件区（如福田田区，不不要缺少少“区”或“县”）AddrresssStriingR发

60、件详细细地址StarrtDaateStriingO上门取货货时间段段:yyyyy-MMM-ddd HHH:mmm:sss格格式化，本文中中所有时时间格式式相同EndDDateeStriingOWeigghtDoubbleO物品总重重量kggQuanntittyIntO件数/包包裹数VoluumeDoubbleO物品总体体积m33RemaarkStriingO备注AddSServviceeNameeStriing0增值服务务名称ValuueStriing0增值服务务值CusttomeerIDDStriing0客户标识识(选填填)CommmodiityGooddsNaameStriingR商品名称