快遞鳥物流接口技術(shù)文檔

1、快遞鳥接接口(AAPI)技術(shù)文文檔版本日期版本說明作者20144-122-0113.0重新整理理，根據(jù)據(jù)功能分分類，部部分有調(diào)調(diào)整楊文勝20144-011-1113.1對接口的的說明進(jìn)進(jìn)行了注注釋，提提高可讀讀性楊漢汶20144-011-1333.2新增推送送接口楊漢汶20155-033-1113.3新增批量量訂閱推推送接口口，刪除除3.22版本推推送接口口楊文勝20155-100-1223.4新增訂單單分發(fā)接接口，整整理電子子面單接接口曹強(qiáng)20166-011-1993.5重新調(diào)整整在線下下單接口口曹強(qiáng)20166-033-0113.6增加智選選物流接接口曹強(qiáng)20166-033-0113.7分發(fā)

2、及訂訂閱接口口更新任海洋20166-044-0773.7.1推送接口口更新任海洋20166-055-1113.7.2電子面單單新增通通知快遞遞員上門門字段，推送接接口新增增貨款狀狀態(tài)推送送詹益?zhèn)?0166-077-0114.0全新4.0接口口，新增增單號識識別接口口、智選選物流接接口、更更新物流流軌跡接接口（訂訂閱查詢詢）詹益?zhèn)?0166-9-264.0.1推送接口口新增DataaSiggn字段段、訂閱閱2.00新增倉倉庫標(biāo)識識ID、智選物物流接口口新增字字段胡蕾蕾20166-111-0334.1新增在途途監(jiān)控（增值服服務(wù)）曹強(qiáng)20166-122-1334.1.1電子面單單新增第第三方訂訂單號

3、TThrOOrdeerCoode胡蕾蕾20177-1-104.2新增隱私私快遞胡蕾蕾20177-2-164.2.1新增代收收貨款業(yè)業(yè)務(wù)胡蕾蕾20177-4-134.31、即時時查詢接接口中軌軌跡狀態(tài)態(tài)新增00-無軌軌跡 2、普通通回調(diào)接接口中刪刪除2001狀態(tài)態(tài)3、修改改智選物物流接口口文檔4、電子子面單接接口添加加特殊字字符提示示陳愛20177-4-254.4新增申請請電子面面單客戶戶號接口口新增電子子面單余余額查詢詢接口新增電子子面單單單號回收收接口新增申請請客戶號號信息推推送接口口陳愛20177-6-224.5新增短信信接口李旭安20177-7-144.6電子面單單接口新新增支持持郵政快

4、快遞包裹裹吳明名詞定義義必須要求求說明R必填（RRequuireed）。O可選（OOptiionaal）C報文中該該參數(shù)在在一定條條件下可可選（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接口規(guī)規(guī)范及說說明 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接口數(shù)數(shù)據(jù)包結(jié)結(jié)構(gòu) 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網(wǎng)關(guān)地地址 PAGEREF _Toc487812482 h 12 HYPERLINK l _Toc487812483 2.3簽名說說明 PAGEREF _Toc487812483 h 12 HYPERLINK l _Toc487812484 2.3.1關(guān)于簽簽名 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預(yù)約取取件接口口 PAGEREF _Toc487812487 h 15 HYPERLINK l _Toc487812488 3.1.1功能說說明 PAGEREF _Toc487812488 h 15 HYPERLINK l _Toc487812489 3.1.2接口規(guī)規(guī)則 PAGEREF _Toc487812489 h

8、15 HYPERLINK l _Toc487812490 3.1.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812490 h 15 HYPERLINK l _Toc487812491 3.1.4返回結(jié)結(jié)果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF _Toc487812496 h 20 HYPERLINK l _Toc487812497 3.2.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812497 h 20 HYPERLINK l _Toc487812498 3.2.4返回結(jié)結(jié)果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF _Toc487812501 h 25 HYPERLINK l _Toc487812502 3.3.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812502 h 25 HYPERLINK l _To

11、c487812503 3.3.4返回結(jié)結(jié)果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF _Toc487812508 h 27 HYPERLINK l _Toc487812509 3.4.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812509 h 27 HYPERLINK l _Toc487812510 3.4.4返回結(jié)結(jié)果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF _Toc487812515 h 29 HYPERLINK l _Toc487812516 3.5.3系統(tǒng)級級和應(yīng)

14、用用級輸入入?yún)?shù) PAGEREF _Toc487812516 h 29 HYPERLINK l _Toc487812517 3.5.4返回結(jié)結(jié)果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF _Toc487812522 h 31 HYPERLINK l _Toc487812523 3.6.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812523 h 31 HYPERLINK l _Toc487812524 3.6.4返回結(jié)結(jié)果參數(shù)數(shù) 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增值服服務(wù)列表表 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接口規(guī)規(guī)則 PAGEREF _Toc487812530 h 33 HYPERLINK l _Toc487812531 3.8.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812531 h 33 HYPERLINK l _Toc487812532 3.8.4返回結(jié)結(jié)果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF

19、_Toc487812538 h 37 HYPERLINK l _Toc487812539 4.1.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812539 h 37 HYPERLINK l _Toc487812540 4.1.4返回結(jié)結(jié)果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF _Toc487812545 h 40 HYPERLINK l _Toc487812546 4.2.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812546 h 40 HYPERLINK l _Toc487812547 4.2.4返

21、回結(jié)結(jié)果參數(shù)數(shù) 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異步步推送（回調(diào)）接口 PAGEREF _Toc487812550 h 45 HYPERLINK l _Toc487812551 5.1功能說說明 PAGEREF _Toc487812551 h 45

22、 HYPERLINK l _Toc487812552 5.2接口規(guī)規(guī)則 PAGEREF _Toc487812552 h 45 HYPERLINK l _Toc487812553 5.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812553 h 45 HYPERLINK l _Toc487812554 5.3.1訂閱查查詢結(jié)果果（ReequeestTTypee：1011） PAGEREF _Toc487812554 h 46 HYPERLINK l _Toc487812555 5.3.2訂閱查查詢（增增值版）結(jié)果（ReqquesstTyype：1022） PAGEREF _To

23、c487812555 h 47 HYPERLINK l _Toc487812556 5.3.3貨款狀狀態(tài)（RRequuesttTyppe：1077） PAGEREF _Toc487812556 h 48 HYPERLINK l _Toc487812557 5.4返回結(jié)結(jié)果參數(shù)數(shù) 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智能能服務(wù) 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.接接口規(guī)則則 PAGEREF _Toc487812563 h 53 HYPERLINK l _Toc487812564 6.1.3.應(yīng)應(yīng)用級輸輸入?yún)?shù)數(shù) P

25、AGEREF _Toc487812564 h 54 HYPERLINK l _Toc487812565 6.1.4.返返回結(jié)果果參數(shù) 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運(yùn)運(yùn)費(fèi)模板板導(dǎo)入接接口 PAGEREF _Toc487812568 h

26、 61 HYPERLINK l _Toc487812569 6.2.1.功功能說明明 PAGEREF _Toc487812569 h 61 HYPERLINK l _Toc487812570 6.2.2.接接口規(guī)則則 PAGEREF _Toc487812570 h 61 HYPERLINK l _Toc487812571 6.2.3.系系統(tǒng)級輸輸入?yún)?shù)數(shù) PAGEREF _Toc487812571 h 61 HYPERLINK l _Toc487812572 6.2.4.應(yīng)應(yīng)用級輸輸入?yún)?shù)數(shù) PAGEREF _Toc487812572 h 62 HYPERLINK l _Toc48781257

27、3 6.2.5.返返回結(jié)果果參數(shù) 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.接接口規(guī)則則 PAGEREF _Toc487812578 h 65 HYPERLINK l _Toc487812579 6.3.3.系系統(tǒng)級和和應(yīng)用級級輸入?yún)?shù) PAGEREF _Toc487812579 h 65 HYPERLINK l _Toc487812580 6.3.4.返返回結(jié)果果參數(shù) PAGEREF _Toc487812580 h 66 HYPERLINK l _Toc487812581 7在途途監(jiān)控（增值版版） 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接口規(guī)規(guī)則 PAGEREF _Toc487812584 h 66 HYPERLINK l _Toc487812585 7.1.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812585 h 67 HYPERLINK l _Toc487812586 7.1.4返回結(jié)結(jié)

30、果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF _Toc487812591 h 71 HYPERLINK l _Toc487812592 7.2.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812592 h 71 HYPERLINK l _Toc487812593 7.2.4返回結(jié)結(jié)果參數(shù)數(shù) 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短信發(fā)發(fā)送 PAGEREF _Toc487812597 h 75 HYPERLINK l _Toc487812598 8.1.1功能說說明 PAGEREF _Toc487812598 h 75 HYPERLINK l _Toc487812599 8.1.2接口規(guī)規(guī)則 PAGEREF _Toc487812599 h 75 HY

33、PERLINK l _Toc487812600 8.1.3返回結(jié)結(jié)果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF _Toc487812605 h 77 HYPERLINK l _Toc487812606 8.2.3系統(tǒng)級級和應(yīng)用用級輸入入?yún)?shù) PAGEREF _Toc487812606 h 77 HYPERLINK l _Toc487812607 8.2.4返回結(jié)結(jié)果參數(shù)數(shù) 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接口規(guī)規(guī)則 PAGEREF _Toc487812612 h 79 HYPERLINK l _Toc487812613 8.3.3系統(tǒng)級級和應(yīng)用

36、用級輸入入?yún)?shù) PAGEREF _Toc487812613 h 79 HYPERLINK l _Toc487812614 8.3.4返回結(jié)結(jié)果參數(shù)數(shù) 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電子面面單模板板規(guī)格 PAGEREF _Toc487812620 h 81 HYPERLINK l _Toc487812621 9.4返回編編碼列表表 PAGEREF _Toc487812621 h 83 HYPERLINK l _Toc487812622 10技技術(shù)支持持 P

38、AGEREF _Toc487812622 h 83前言快遞鳥鳥APII旨在為為電商、電商平平臺、物物流工具具、倉儲儲系統(tǒng)等等等系統(tǒng)統(tǒng)提供專專業(yè)、穩(wěn)穩(wěn)定、優(yōu)優(yōu)質(zhì)的物物流服務(wù)務(wù)，為不不同的用用戶量身身定做了了專業(yè)的的APII接口服服務(wù)，供供不同的的用戶各各取所需需。本文檔檔就各個個APII接口進(jìn)進(jìn)行詳細(xì)細(xì)的說明明，方便便快遞鳥鳥的用戶戶快速對對接，方方便快捷捷使用快快遞鳥服服務(wù)。概述用戶使用用流程圖圖快遞鳥AAPI全全流程服服務(wù)（電電商）流流程圖基于電商商現(xiàn)有的的服務(wù)流流程，快快遞鳥為為電商、電商平平臺、EERP系系統(tǒng)、倉倉儲系統(tǒng)統(tǒng)等系統(tǒng)統(tǒng)在用戶戶下單、選擇物物流、下下單、打打單、軌軌跡跟蹤蹤等關(guān)

39、鍵鍵節(jié)點(diǎn)，均提供供了專業(yè)業(yè)、高效效的APPI接口口，方便便各個平平臺實(shí)現(xiàn)現(xiàn)一次接接入，便便可使用用國內(nèi)外外主流物物理公司司的服務(wù)務(wù)?？爝f鳥AAPI全全流程服服務(wù)（工工具）流流程圖對于物流流工具，基于用用戶的操操作習(xí)慣慣，只需需要輸入入單號，快遞鳥鳥即可完完成后續(xù)續(xù)的物流流公司識識別、查查詢軌跡跡等工作作，為工工具類用用戶提供供一站式式的服務(wù)務(wù)。接口規(guī)范范及說明明報文及報報文編碼碼Jsoon格式式。編碼格格式：UUTF-8交互協(xié)協(xié)議上統(tǒng)統(tǒng)一用UUTF-8，避避免傳遞遞中文數(shù)數(shù)據(jù)出現(xiàn)現(xiàn)亂碼。接入步驟驟 注冊成成為快遞遞鳥用戶戶(注：注注冊成功功后進(jìn)行行實(shí)名認(rèn)認(rèn)證，申申請開通通接口，后續(xù)會會再對用用

40、戶的注注冊信息息進(jìn)行審審批)。注冊成成功后，登錄用用戶管理理后臺就就可以查查看到用用戶所屬屬唯一的的商戶IID和APII keey。按照快遞遞鳥官網(wǎng)網(wǎng)提示進(jìn)進(jìn)行注冊冊申請，注冊成成功后登登錄用戶戶管理后后臺，您您將得到到由快遞遞鳥提供供的一組組商戶IID和APII Keey。商戶IID是調(diào)調(diào)用接口口服務(wù)的的身份證證明，不不可更改改、不可可轉(zhuǎn)用，APII Keey是應(yīng)應(yīng)用訪問問APII的簽名名附加密密鑰，必必須妥善善保存。兩者關(guān)關(guān)系類似似于登錄錄帳號和和密碼，兩者都都會在簽簽名和業(yè)業(yè)務(wù)參數(shù)數(shù)中使用用。注冊成功功登錄用用戶管理理后臺可可以查看看商戶IID和AAPI Keyy，需實(shí)實(shí)名認(rèn)證證后才能能

41、申請開開通接口口。開發(fā)服務(wù)務(wù)開發(fā)自身身業(yè)務(wù)的的服務(wù)，服務(wù)需需遵循接口口的定義義規(guī)則。查看接口口調(diào)用的的DEMMO快遞鳥物物流技術(shù)術(shù)接口提提供調(diào)用用快遞鳥鳥物流接接口的DDEMOO(.Neet版本本，Jaava版版本，PPHP版版本)，包括網(wǎng)網(wǎng)上在線線訂單下下單、物物流軌跡跡查詢等等物流行行業(yè)標(biāo)準(zhǔn)準(zhǔn)化的下下單操作作流程與與數(shù)據(jù)查查詢格式式。提交交接入處處理的相相關(guān)代碼碼如有不不明白的的地方可可與快遞遞鳥物流流技術(shù)接接口人協(xié)協(xié)作開發(fā)發(fā)。DEMOO下載地地址：hhttpp:/wwww.kddniaao.ccom/dowwnlooad (如鏈鏈接無法法打開，請打開開瀏覽器器，在瀏瀏覽器中中輸入)接口數(shù)

42、據(jù)據(jù)包結(jié)構(gòu)構(gòu)圖例 - 數(shù)據(jù)據(jù)包結(jié)構(gòu)構(gòu) (系系統(tǒng)級數(shù)據(jù))JSONN 范例例strringg usserIID = 1110992599;strringgkeyyVallue = 56dda2ccf8-c8aa2-444b22-b66fa-4766cd77d1bba177;/加加密私鑰鑰，由發(fā)發(fā)貨通提提供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)進(jìn)行MMD5加加密，然然后Baase664編碼碼，最后后 進(jìn)行行URLL(uttf-8

44、8)編碼碼striing PosstSttr = RRequuesttTyppe=110022&EBBusiinesssIDD= uuserrID &ReequeestDDataa=jssonSStr &DaataSSignn= ddataasiggn&DDataaTyppe=DDataaTyppe; /請求報報文參數(shù)數(shù)striing posst = thhis.DoPPostt(urrl, PosstSttr);/ 通訊協(xié)協(xié)議使用用Htttp協(xié)議議Posst請求求方式流程示意意圖網(wǎng)關(guān)地址址測試接口口：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簽名說明明關(guān)于簽名名快遞鳥和和第三方方電子商商務(wù)公司司系統(tǒng)進(jìn)進(jìn)行對接接，有一定的的安全機(jī)機(jī)制。采用IIP認(rèn)證證加簽名名的方式式對接，具體方方案如下下：防止數(shù)據(jù)據(jù)被篡改改在POSST請求求中會傳傳遞5個必須須（R）參數(shù)Requue

46、sttDatta=數(shù)據(jù)內(nèi)內(nèi)容(UURL編編碼:UUTF-8)EBussineessIID=電商IIDRequuesttTyppe=請請求指令令類型DataaSiggn=數(shù)據(jù)內(nèi)內(nèi)容簽名名：把（請求內(nèi)內(nèi)容（未未編碼）+AppiKeey）進(jìn)進(jìn)行MDD5加密密，然后后Basse644編碼，最后進(jìn)進(jìn)行URRL（uutf-8）編編碼DaataTTypee=返返回數(shù)據(jù)據(jù)類型(2-jjsonn)注：DaataSSignn生成后，對方方接收到到數(shù)據(jù)后后，以同同樣的算算法進(jìn)行行簽名，生成摘摘要，對對比兩者者的摘要要是否相相同，如如果不同同，說明明傳遞過過程中發(fā)發(fā)生數(shù)據(jù)據(jù)篡改，對接過過程中如如有不明明白之處處可雙方

47、方技術(shù)協(xié)協(xié)作進(jìn)行行調(diào)用接口口的身份份認(rèn)證注冊成為為快遞鳥鳥用戶后后，會生生成對應(yīng)應(yīng)的電商商ID和和ApppKeyy，電商IID相當(dāng)當(dāng)于用戶戶名，AAppKKey相相當(dāng)于密密碼。注注：請勿勿遺漏或或傳遞可可能遞增增大快遞遞鳥接口口調(diào)用維護(hù)護(hù)舉例說明明：假設(shè)ReequeestDDataa(JSOON)內(nèi)容為為： “OrrderrCodde”:”,“ShhippperCCodee”:”SF”,”LoogissticcCodde”:1118995499075573經(jīng)過過URLL(UTTF-88)編碼碼的內(nèi)容容為%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簽名的的內(nèi)容為為OrrderrCodde:,ShhippperCCodee:SF,LLogiistiicCoode:1118995499075573566da22cf88-c88a2-44bb2-bb6faa-4776cdd7d11ba117，

49、經(jīng)經(jīng)過mdd5和basse644后的內(nèi)內(nèi)容就為為OWFFhM22I5NN2ViiM2UU2MGGRkMMjc44YzUU2NmmVlZZWI33ZDkk0MmmE=，在經(jīng)過過URLL(UTTF-88)編碼碼的內(nèi)容容為OWWFhMM2I55N2VViM22U2MMGRkkMjcc4YzzU2NNmVllZWII3ZDDk0MMmE%3d最最終要發(fā)發(fā)送的數(shù)數(shù)據(jù)為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接收方收收到數(shù)據(jù)據(jù)后，獲獲得EBBusiinesssIDD和ReqquesstDaata和和DattaSiign等等這幾個個數(shù)據(jù)。接收方對對EBuusinnesssID得到AAppKKey，ReqquesstDaata+ApppKeyy的數(shù)據(jù)據(jù)進(jìn)行mmd5和和basse64

51、4后的內(nèi)內(nèi)容就為為OWFFhM22I5NN2ViiM2UU2MGGRkMMjc44YzUU2NmmVlZZWI33ZDkk0MmmE=接收方判判斷簽名名后的數(shù)數(shù)據(jù)跟傳傳遞過來來的DaataSSignn是否一一致，如如果一致致進(jìn)行業(yè)業(yè)務(wù)操作作，如果果不一致致返回錯錯誤。(C#)DattaSiign簽簽名加密密代碼/電電商Siign簽簽名/內(nèi)容/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);下單預(yù)約取件件接口功能說明明預(yù)約取取件接口口是快遞鳥鳥

55、提供給給獨(dú)立電商商、倉儲儲管理系系統(tǒng)、物物流供應(yīng)應(yīng)鏈等物物流系統(tǒng)統(tǒng)平臺使使用的下下單接口口，為客客戶解決決在線發(fā)發(fā)貨需求求，客戶戶通過網(wǎng)網(wǎng)絡(luò)選擇擇快遞公公司發(fā)送送請求通通知貴公公司有快快遞要發(fā)發(fā)貨，貴貴公司把把數(shù)據(jù)通通過此接接口轉(zhuǎn)發(fā)發(fā)到快遞遞鳥，由由快遞鳥鳥為您提提供通知知快遞員員上門取取件的服服務(wù)。接口規(guī)則則(1)、訂單單編號(OrdderCCodee)不可可重復(fù)提提交，重重復(fù)提交交系統(tǒng)會會返回具具體錯誤誤代碼。 (2)、目前前預(yù)約取取件接口口支持了了：德邦邦、EMMS、天天地華宇宇、百世世快遞、京東、龍邦快快遞、順順豐快遞遞、中通通速遞、韻達(dá)快快遞、圓圓通速遞遞、宅急急送，后后續(xù)更多多的快

56、遞遞公司正正在對接接中。 (3)、接口口只支持持Jsoon格式式參數(shù)，接口指指令10001。只支持持POSST請求求方式，utff-8編編碼。 (4)、支持持增值服服務(wù)，保保價、代代收貨款款、貨款款直退、貨款墊墊付等。(5)、測試地地址：hhttpp:/tesstappi.kkdniiao.cc:80881/aapi/oorrderrserrvicce/正式式地址：htttp:/appi.kkdniiao.cc/apii/ooordeerseerviice系統(tǒng)級和和應(yīng)用級級輸入?yún)?shù)系統(tǒng)級輸輸入?yún)?shù)數(shù)應(yīng)用級輸輸入?yún)?shù)數(shù)類型是否必須須描述RequuesttDatta（必必填參數(shù)數(shù)，請求求內(nèi)容，J

57、SOON格式式,須和和DattaTyype一一致）WareehouuseIIDStriingO倉庫標(biāo)識識(備用用字段)WareehouuseAAddrresssStriingO倉庫地址址(備用用字段)CalllBacckStriingO商戶標(biāo)識識(備用用字段)MembberIIDStriingO會員標(biāo)識識(備用用字段)ShippperrCoddeStriingR快遞公司司編碼LogiistiicCoodeStriingO快遞單號號OrdeerCoodeStriingR訂單編號號MontthCoodeStriingC月結(jié)編碼碼PayTTypeeIntR郵費(fèi)支付付方式:1-現(xiàn)付付，2-到付，3-月

58、月結(jié)，44-第三三方支付付ExpTTypeeIntR快遞類型型：1-標(biāo)準(zhǔn)快快件CosttDoubbleO寄件費(fèi)（運(yùn)費(fèi)）OtheerCoostDoubbleO其他費(fèi)用用ReceeiveerComppanyyStriingO收件人公公司NameeStriingR收件人TelStriingR電話與手手機(jī)，必必填一個個MobiileStriingPosttCoddeStriingO收件人郵郵編ProvvincceNaameStriingR收件?。ㄈ鐝V東東省，不不要缺少少“省”）CityyNammeStriingR收件市（如深圳圳市，不不要缺少少“市”）ExpAAreaaNammeStriingO收件區(qū)

59、（如福田田區(qū)，不不要缺少少“區(qū)”或“縣”）AddrresssStriingR收件人詳詳細(xì)地址址SendderComppanyyStriingO發(fā)件人公公司NameeStriingR發(fā)件人TelStriingR電話與手手機(jī)，必必填一個個MobiileStriingPosttCoddeStriingO發(fā)件人郵郵編ProvvincceNaameStriingO發(fā)件?。ㄈ鐝V東東省，不不要缺少少“省”）CityyNammeStriingR發(fā)件市（如深圳圳市，不不要缺少少“市”）ExpAAreaaNammeStriingO發(fā)件區(qū)（如福田田區(qū)，不不要缺少少“區(qū)”或“縣”）AddrresssStriingR發(fā)

60、件詳細(xì)細(xì)地址StarrtDaateStriingO上門取貨貨時間段段:yyyyy-MMM-ddd HHH:mmm:sss格格式化，本文中中所有時時間格式式相同EndDDateeStriingOWeigghtDoubbleO物品總重重量kggQuanntittyIntO件數(shù)/包包裹數(shù)VoluumeDoubbleO物品總體體積m33RemaarkStriingO備注AddSServviceeNameeStriing0增值服務(wù)務(wù)名稱ValuueStriing0增值服務(wù)務(wù)值CusttomeerIDDStriing0客戶標(biāo)識識(選填填)CommmodiityGooddsNaameStriingR商品名稱