敏思達(dá)大客戶平臺通用接口_v27

1、敏思達(dá)大客戶平臺通用接口版本號：2.7深圳市敏思達(dá)技術(shù)有限公司 版權(quán)所有接口版本改動說明面單發(fā)放信息查詢 (vip0001)102 返回了具體的錯誤信息傳統(tǒng)面單模板數(shù)據(jù)查詢 (vip0002)102 返回了具體的錯誤信息傳統(tǒng)面單打印 (vip0003)json 格式數(shù)據(jù)非法時，提示：含 有無法解析字符 ,請檢查傳入的JSON 數(shù)據(jù)是否正確熱敏單打印 (vip0004)json 格式數(shù)據(jù)非法時，提示：含 有無法解析字符 ,請檢查傳入的JSON 數(shù)據(jù)是否正確運單跟蹤記錄 (vip0005)102 返回了具體的錯誤信息運單信息上傳 (vip0007)欄位校驗熱敏單號獲取 (vip0009)102 返

2、回具體錯誤信息運單撤銷 (vip0010)102 返回了具體的錯誤信息所有接口v2.3添加客戶密碼校驗， 增強數(shù)據(jù)安全 性運單信息上傳 (vip0007)V2.4字段欄位大小調(diào)整： 寄件人， 寄件 人電話， 寄件人地址， 收件人，收 件人電話，收件人地址對接流程說明以及部分接口關(guān)閉V2.6對接流程說明以及部分接口關(guān)閉添加密碼校驗V2.7添加密碼校驗文檔說明1.1 功能描述為提高熱敏面單使用率，并對已有系統(tǒng)的大客戶建立統(tǒng)一接入標(biāo)準(zhǔn)，現(xiàn)要求在原申通大客戶平臺基礎(chǔ)上，開發(fā)若干數(shù)據(jù)接口文件。與物流公司的交互具體包括以下接口運單信息上傳接口獲取熱敏單號接口備注： $basepath 表示接口部署路勁 ,

3、實際調(diào)用過程中換成data_digest 方法簽名是由總部給 erp 系統(tǒng) ,不針對 erp 系統(tǒng)客戶 cuspwd 表示在大客戶平臺里面的密碼 ,密碼由所屬站點或總部提供1.2 運單信息上傳 (vip0007)1. 接口提供方：申通總部2. 接口調(diào)用方：總部網(wǎng)點客戶3. 支持調(diào)用方式： get 或者 post4. 接口名： vip00075. 接口描述：運單信息上傳6. 接口請求字段描述訂單狀態(tài)信息查詢接口主對象字段名字段描述字段類型字段長度是否可空code請求的方法名StringNdata_digest方法簽名StringNcuspwd客戶密碼StringNdata請求參數(shù)對象Object

4、Ndata 對象字段名字段描述字段類型字段長度是否可空billno運單編號String20Nsenddate寄件日期 yyyy-mm-ddStringNsendsite網(wǎng)點名稱String20Nsendcus客戶名稱String60Nsendperson寄件人String60Nsendtel寄件人電話String60Nreceivecus收件客戶String60Yreceiveperson收件人String60Nreceivetel收件人電話String60Ngoodsname內(nèi)件品名String500Ninputdate錄入時間 yyyy-mm-ddStringNinputperson錄入人

5、String20Ninputsite錄入網(wǎng)點String20Nlasteditdate最后編輯時間StringYlasteditperson最后編輯人String20Ylasteditsite最后編輯網(wǎng)點String20Yremark備注String200Yreceiveprovince收件省份String40Nreceivecity收件城市String40Nreceivearea收件地區(qū)String40Nreceiveaddress收件地址String200Nsendprovince寄件省份String40Nsendcity寄件城市String40Nsendarea寄件地區(qū)String40N

6、sendaddress寄件地址String200Nweight重量StringYproductcode產(chǎn)品代碼String40Ysendpcode寄件省份編號String20Ysendccode寄件城市編號String20Ysendacode寄件地區(qū)編號String20Yreceivepcode收件省份編號String20Yreceiveccode收件城市編號String20Yreceiveacode收件地區(qū)編號String20Ybigchar大字String20Yorderno訂單號String30Y7. 接口應(yīng)答字段返回值字段名字段描述字段類型字段長度是否可空success接口操作成功或失

7、敗 true: 成功 false: 失敗StringNmessage錯誤碼StringNdata調(diào)用接口返回結(jié)果ObjectNdata 對象字段名字段描述字段類型字段長度是否可空orderno訂單號StringNbigchar大字StringNexpno運單編號StringN8. json 格式請求樣例$basepath/PreviewInterfaceAction.action?code=vip0007&data_digest=vip&cuspwd=xxx&data='billno':'220999999900','sendda

8、te':'2014-02-27','sendsite':' 上海陳行公司 ','sendcus': ' 深圳敏思達(dá) ','sendperson': '李名學(xué) ','sendtel':'#39;,'receivecus':' 深 圳 天 翼 德 ','receiveperson': '小橋','receivetel':'10086',&

9、#39;goodsname': '蘋果測試','inputdate':'','inputperson':' 東 商 ','inputsite':' 上 海 陳 行公司','lasteditdate': '','lasteditperson':'','lasteditsite':'','remark': '測試備注 ','receiveprov

10、ince': '廣東省 ','receivecity': '深圳市 ','receivearea': '南山區(qū) ','receiveaddress': '收件地址 ','sendprovince':'湖南省 ','sendcity':'郴州市 ','sendarea': '永 興 縣 ','sendaddress': '寄 件 地 址 ','

11、weight':'12','productcode':'','sendpcode': '','sendccode':'','sendacode':'','receivepcode': '','receiveccode': '','receiveacode':'','bigchar': '廣東省深圳市 ','or

12、derno':'081120317'9. json 格式返回樣例"success":true,"message":"103","data":"orderno":"081120317","bigchar":"東省深圳市 ","expno":"220999999900"1.3 大字查詢 (vip0008)1. 接口提供方：申通總部2. 接口調(diào)用方：總部網(wǎng)點客戶3. 支持調(diào)用方式

13、： post4. 接口名： vip00085. 接口描述：根據(jù)省市區(qū)查詢大字,區(qū)域不是必填項6. 接口請求字段描述大字查詢接口主對象字段名字段描述字段類型字段長度是否可空code請求的方法名StringNdata_digest方法簽名StringNcuspwd客戶密碼StringNreceiveprovince收件人省份StringNreceivecity收件人城市StringNreceivearea收件人地區(qū)StringN7. 接口應(yīng)答字段返回值字段名字段描述字段類型字段長度是否可空success接口操作成功或失敗 true: 成功 false: 失敗StringNmessage錯誤碼Str

14、ingNdata調(diào)用接口返回結(jié)果StringN8. json 格式請求樣例$basepath/PreviewInterfaceAction.action?code=vip0008&data_digest=vip&cu spwd=xxx&receiveprovince= 廣東省 &receivecity= 深圳市 &receivearea= 南山區(qū)9. json格式返回樣例"success": true,"data": " 廣東南山 1.4 熱敏單號獲取 (vip0009)1. 接口提供方：申通總部2. 接

15、口調(diào)用方：總部網(wǎng)點客戶3. 支持調(diào)用方式： post4. 接口名： vip00095. 接口描述： 熱敏單號獲取6. 接口請求字段描述大字查詢接口主對象字段名字段描述字段類型字段長度是否可空code請求的方法名StringNdata_digest方法簽名StringNcuspwd客戶密碼StringNcusname客戶名稱StringNcusite網(wǎng)點名稱StringNlen個數(shù)intN7. 接口應(yīng)答字段返回值字段名字段描述字段類型字段長度是否可空success接口操作成功或失敗 true: 成功 false: 失敗StringNmessage錯誤碼StringNdata調(diào)用接口返回結(jié)果Str

16、ingN8. json 格式請求樣例$basepath/PreviewInterfaceAction.action?code=vip0009&data_digest=vip&cu spwd=xxx&cusname= 東商 &cusite= 上海陳行公司 &len=39. json 格式返回樣例"success": true, "message": "103","data": "22xxxxxxxxxx,22xxxxxxxxxx,22xxxxxxxxxxx"

17、 接口流程說明1. 整體流程說明a） 0009（ 獲取熱敏單號 ）-0007（ 推送）2. 舉例說明a） 比如你通過 E 店寶軟件下載了 100 條要發(fā)貨的訂單，調(diào)用0009 獲取 100 個單號， 然后調(diào)用 0007 推送給我們， 我們會自動返回：運單號，訂單號，大字錯誤碼說明編號編號說明100轉(zhuǎn)換請求參數(shù)對象失敗101簽名不正確102vip0001 查詢面單發(fā)放信息異常 , 請求參數(shù) :params vip0002 查詢傳統(tǒng)面單模版數(shù)據(jù)異常vip0005 查詢快件跟蹤異常 , 請求參數(shù) :params Vip0007 上傳訂單數(shù)據(jù)異常 ,exception 簡要信息 vip0009 獲取熱

18、敏單號失敗 ,exception 簡要信息 vip0010 撤銷運單異常 ! 運單編號 :billno103查詢成功104沒有足夠的單號105推送記錄不能大于 1000106運單編號未發(fā)放 ,不允許錄單107運單編號已錄單 ,不允許重復(fù)錄入108發(fā)放客戶或者發(fā)放網(wǎng)點必須要填寫109請?zhí)顚懶枰扑瓦^來的數(shù)據(jù)110撤銷運單數(shù)量大于 100111參數(shù)有誤112運單撤銷失敗 !113含有無法解析字符 , 請檢查傳入的 JSON 數(shù)據(jù)是否正確114推送數(shù)據(jù)中必須要有運單編號115運單編號【 xxx 】,寄件日期必須要填寫116運單編號【 xxx 】,網(wǎng)點名稱必須要填寫133客戶密碼不正確134驗證通過JAVA 調(diào)用接口實例數(shù)據(jù)過多時候會導(dǎo)致調(diào)用接口的時候自己要分清好到底是 get 還是 post，get 是有長度限制的， 推送數(shù)據(jù)不完整 ,瀏覽器自動截取的HttpClient httpclient = new DefaultHttpClient();");HttpPost httpPost = new HttpPost("$b