管理規(guī)范-集團(tuán)(公司)內(nèi)部軟件開(kāi)發(fā)標(biāo)準(zhǔn)接口文檔規(guī)范V2

管理規(guī)范集團(tuán)（公司）內(nèi)部軟件開(kāi)發(fā)標(biāo)準(zhǔn)接口文檔規(guī)范文件編號(hào)202XQK011/BT-ZTA-QK011文件狀態(tài)[]草稿[√]正式發(fā)布[]正在修改當(dāng)前版本Version：0.1擬制日期審核日期目錄TOC\o"1-3"\h\u23506第一章文檔概述 620499第二章業(yè)務(wù)對(duì)接說(shuō)明 7265792.1.接口說(shuō)明 778662.1.1.接口地址 7113952.1.2.接口參數(shù) 794422.2.接口清單 7273972.3.標(biāo)準(zhǔn)API列表 834642.4.貨品檔案同步 8325522.4.1.功能說(shuō)明 8140792.4.2.應(yīng)用入?yún)⒄f(shuō)明 11247742.4.3.數(shù)據(jù)格式 11187532.4.4.報(bào)文格式 1344312.4.5.響應(yīng)格式 15235092.5.入庫(kù)單下發(fā) 15242262.5.1.功能說(shuō)明 1540412.5.2.應(yīng)用入?yún)⒄f(shuō)明 17280562.5.3.數(shù)據(jù)格式 17262572.5.4.明細(xì)信息 20209692.5.5.報(bào)文格式 2194162.5.6.響應(yīng)格式 28262072.6.出庫(kù)單下發(fā) 28184812.6.1.功能說(shuō)明 28285242.6.2.應(yīng)用入?yún)⒄f(shuō)明 2946992.6.3.數(shù)據(jù)格式 3091152.6.4.報(bào)文格式 33301732.6.5.響應(yīng)格式 37206092.7.運(yùn)輸單下發(fā) 37250982.7.1.功能說(shuō)明 37184382.7.2.應(yīng)用入?yún)⒄f(shuō)明 3824272.7.3.數(shù)據(jù)格式 39249092.7.4.明細(xì)信息 42250812.7.5.報(bào)文格式 43290552.7.6.響應(yīng)格式 47206062.8.訂單取消 4710902.8.1.功能說(shuō)明 47190422.8.2.應(yīng)用入?yún)⒄f(shuō)明 4863162.8.3.出參說(shuō)明 49156142.9.物流跟蹤信息查詢 4938142.9.1.功能說(shuō)明 49223382.9.2.應(yīng)用入?yún)⒄f(shuō)明 5050912.9.3.數(shù)據(jù)格式 51279182.9.4.明細(xì)信息 519822.9.5.報(bào)文格式 52108352.9.6.響應(yīng)報(bào)文 53167152.10.交貨量同步 53154342.10.1.功能說(shuō)明 53117872.10.2.應(yīng)用級(jí)入?yún)⒄f(shuō)明 5423632.10.3.數(shù)據(jù)格式 5572302.10.4.明細(xì)信息 5550392.10.5.報(bào)文格式 553492.10.6.響應(yīng)格式 57194592.11.訂單對(duì)賬推送接口 57168822.11.1.功能說(shuō)明 57275682.11.2.數(shù)據(jù)格式 57256692.11.3.報(bào)文格式 5940422.11.4.響應(yīng)格式 60105852.12.訂單狀態(tài)推送接口 60134452.12.1.功能說(shuō)明 60181512.12.2.數(shù)據(jù)格式 604432.12.3.報(bào)文格式 6246772.12.4.響應(yīng)格式 6363432.13.入庫(kù)單結(jié)果反饋 64110882.13.1.功能說(shuō)明 64220762.13.2.數(shù)據(jù)格式 64286242.13.3.報(bào)文格式 65200262.13.4.響應(yīng)報(bào)文 677642.14.出庫(kù)單結(jié)果反饋 67164882.14.1.功能說(shuō)明 67209872.14.2.數(shù)據(jù)格式 68268582.14.3.報(bào)文格式 6914352.14.4.響應(yīng)報(bào)文 71321922.15.GPS設(shè)備信息查詢 7147572.15.1.功能說(shuō)明 71257212.15.2.應(yīng)用入?yún)⒄f(shuō)明 72258762.15.3.數(shù)據(jù)格式 73189732.15.4.響應(yīng)格式 7418783第三章響應(yīng)報(bào)文 76224553.1.響應(yīng)說(shuō)明 767153.2.報(bào)文格式 7620458第四章?tīng)顟B(tài)碼 77193094.1.接口狀態(tài)碼 7716514.2.業(yè)務(wù)狀態(tài)碼 77DocumentAttribute文檔屬性項(xiàng)目名稱(chēng)XXXX項(xiàng)目編號(hào)XXXX文檔主題協(xié)同平臺(tái)標(biāo)準(zhǔn)對(duì)接文檔文檔編號(hào)XXXX文檔創(chuàng)建人XXXX創(chuàng)建日期20XX.1.1文檔目的內(nèi)部參閱和存檔ChangeHistory文檔變更版本修訂日期修訂人描述V0.120XX.1.1XXXX創(chuàng)建版本日期: 20XX/1/1版本: V0.1保密范圍與等級(jí):機(jī)密

文檔概述本文檔是協(xié)同平臺(tái)對(duì)客戶提供的一套標(biāo)準(zhǔn)對(duì)接文檔。業(yè)務(wù)對(duì)接說(shuō)明接口說(shuō)明接口地址測(cè)試地址：正式地址：接口參數(shù)參數(shù)名參數(shù)說(shuō)明參數(shù)值備注method接口方法名詳見(jiàn)接口appkey接口公鑰測(cè)試：23578355正式：23567577requestTime請(qǐng)求時(shí)間yyyy-MM-ddHH:mm:ssfromSYS來(lái)源系統(tǒng)對(duì)接聯(lián)調(diào)時(shí)雙方約定用于確定系統(tǒng)來(lái)源secret接口秘鑰測(cè)試：f505bfa05be4dde19be0230df0799b7d正式：04fb413e2f0702dfd50f833e25ad2059requestContent請(qǐng)求報(bào)文詳見(jiàn)接口接口清單序號(hào)場(chǎng)景處理方式接口提供方備注1貨品檔案同步推送鮮易貨品檔案同步2入庫(kù)單下發(fā)推送鮮易回傳入庫(kù)狀態(tài)3出庫(kù)單下發(fā)推送鮮易回傳出庫(kù)單4運(yùn)輸單下發(fā)推送鮮易回傳出庫(kù)狀態(tài)5訂單取消推送鮮易訂單取消6物流跟蹤信息查詢推送鮮易7交貨量同步推送鮮易8訂單對(duì)賬推送推送客戶9訂單狀態(tài)推送推送客戶10入庫(kù)單結(jié)果反饋推送客戶11出庫(kù)單結(jié)果反饋推送客戶12GPS設(shè)備信息查詢推送鮮易標(biāo)準(zhǔn)API列表貨品檔案同步功能說(shuō)明客戶公司增加或更新貨品檔案時(shí)，需要向檔案中心系統(tǒng)同步貨品檔案信息服務(wù)方：調(diào)用方：客戶接口方向：客戶通阿里云Api網(wǎng)關(guān)調(diào)用,目前只支持map的傳遞方式,如何調(diào)用阿里云api網(wǎng)關(guān)示例代碼由提供Url:http:///restApi/epc/getProductSync系統(tǒng)參數(shù)傳遞方式:Map{Key=”method”,value=”getProductSync”;Key=”appkey”,value=””;Key=”requestTime”,value=””;Key=”fromSYS=”,value=””;Key=”secret”,value=””;Key=”requestContent”,value=””}應(yīng)用入?yún)⒄f(shuō)明字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注接口方法名method50YgetProductSync密鑰appkey50Y簽名密鑰secret50Y請(qǐng)求時(shí)間requestTimeN平臺(tái)會(huì)按請(qǐng)求時(shí)間存,如果輸入,格式必須為yyyy-MM-ddHH:mm:ss來(lái)源系統(tǒng)fromSYS50Y請(qǐng)求報(bào)文requestContentY無(wú)長(zhǎng)度限制數(shù)據(jù)格式字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注客戶編碼customerCode32Y鮮易平臺(tái)為客戶分配的客戶編碼貨品編碼goodsCode50Y客戶系統(tǒng)的商品編碼貨品名稱(chēng)goodsName50Y客戶系統(tǒng)的商品名稱(chēng)貨品條碼barCode50客戶系統(tǒng)的自編號(hào)貨品種類(lèi)goodTypeCode32鮮易平臺(tái)的貨品一級(jí)分類(lèi)編碼畜禽類(lèi)貨品小類(lèi)smallGoodTypeCode8鮮易平臺(tái)的貨品二級(jí)分類(lèi)編碼區(qū)分鮮品、凍品、肉制品（需要映射）貨品規(guī)格specification50客戶系統(tǒng)的規(guī)格貨品單位unit50客戶系統(tǒng)的單位編碼溫度帶keeptemperate32鮮易平臺(tái)的溫度帶編碼1:冷凍，2:冷藏，3:常溫4:恒溫是否批次管理batchManagement50YY、N；此字段為預(yù)留字段是否保質(zhì)期管理expiryDateManagement50YY、N；此字段為預(yù)留字段保質(zhì)期expiryDate50單位天長(zhǎng)length50單位m(長(zhǎng)度不能大于10)寬width50單位m(長(zhǎng)度不能大于10)高h(yuǎn)eight50單位m(長(zhǎng)度不能大于10)體積volume50單位m3(不能超過(guò)1000)重量weight50單位Kg(保留3位小數(shù))貨品狀態(tài)state20Y狀態(tài)：正常停用貨品描述description200客戶系統(tǒng)備注品牌brand50客戶分類(lèi)custGoodTypeCode50客戶方分類(lèi)末級(jí)信息(對(duì)應(yīng)我方小類(lèi)映射)是否倉(cāng)儲(chǔ)業(yè)務(wù)isWhType10傳Y/NY表示倉(cāng)儲(chǔ)業(yè)務(wù)報(bào)文格式<?xmlversion="1.0"encoding="UTF-8"?><products><product><customerCode>abc</customerCode><goodsCode>/</goodsCode><goodsName>/</goodsName><barCode>/</barCode><goodTypeCode>/</goodTypeCode><smallGoodTypeCode>/</smallGoodTypeCode><specification>/</specification><unit>/</unit><keeptemperate>/</keeptemperate><batchManagement>/</batchManagement><expiryDateManagement>/</expiryDateManagement><expiryDate>/</expiryDate><length>/</length><width>/</width><height>/</height><volume>/</volume><weight>/</weight><state>/</state><description>/</description><brand>/</brand><custGoodTypeCode>/</custGoodTypeCode><isWhType></isWhType><product><products>響應(yīng)格式參照4.1響應(yīng)報(bào)文入庫(kù)單下發(fā)功能說(shuō)明客戶審核通過(guò)采購(gòu)運(yùn)輸計(jì)劃后，當(dāng)倉(cāng)庫(kù)是我司時(shí)，需要向我司提供入庫(kù)的信息。服務(wù)方：調(diào)用方：客戶接口方向：客戶通阿里云Api網(wǎng)關(guān)調(diào)用,目前只支持map的傳遞方式,如何調(diào)用阿里云api網(wǎng)關(guān)示例代碼由提供Url:http:///restApi/epc/getInStockOrder系統(tǒng)參數(shù)傳遞方式:Map{Key=”method”,value=”getInStockOrder”;Key=”appkey”,value=””;Key=”requestTime”,value=””;Key=”fromSYS=”,value=””;Key=”secret”,value=””;Key=”requestContent”,value=””}應(yīng)用入?yún)⒄f(shuō)明字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注接口方法名method50YgetInStockOrder密鑰appkey50Y簽名密鑰secret50Y請(qǐng)求時(shí)間requestTimeN平臺(tái)會(huì)按請(qǐng)求時(shí)間存,如果輸入,格式必須為yyyy-MM-ddHH:mm:ss來(lái)源系統(tǒng)fromSYS50Y請(qǐng)求報(bào)文requestContentY無(wú)長(zhǎng)度限制數(shù)據(jù)格式字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注倉(cāng)庫(kù)編碼warehouseCode50Y鮮易平臺(tái)的倉(cāng)庫(kù)編碼，需要映射倉(cāng)庫(kù)名稱(chēng)warehouseName50倉(cāng)庫(kù)名稱(chēng)客戶編碼custCode50Y鮮易平臺(tái)為客戶分配的客戶編碼客戶名稱(chēng)custName50Y客戶名稱(chēng)訂單類(lèi)型orderType20Y60-運(yùn)輸訂單,僅運(yùn)輸業(yè)務(wù)61-倉(cāng)配訂單，有合作倉(cāng)同時(shí)配送業(yè)務(wù)業(yè)務(wù)類(lèi)型businessType20Y訂單類(lèi)型：【61】業(yè)務(wù)類(lèi)型:610-【銷(xiāo)售出庫(kù)】611-【調(diào)撥出庫(kù)】612-【報(bào)損出庫(kù)】613-【其他出庫(kù)】620-【采購(gòu)入庫(kù)】621-【調(diào)撥入庫(kù)】622-【退貨入庫(kù)】623-【加工入庫(kù)】是否包含運(yùn)輸業(yè)務(wù)provideTransport1Y0-否1-是客戶訂單編號(hào)custOrderCode30Y客戶系統(tǒng)的訂單流水號(hào)訂單時(shí)間orderTimeyyyy-MM-ddHH:mm:ssY客戶訂單創(chuàng)建時(shí)間供應(yīng)商名稱(chēng)supportContact30Y商品的供應(yīng)商名稱(chēng)發(fā)貨單位consignorName50客戶系統(tǒng)的發(fā)貨單位發(fā)貨單位聯(lián)系人consignorContact250Y客戶系統(tǒng)的發(fā)貨單位聯(lián)系人發(fā)貨人聯(lián)系電話consignorPhone250Y客戶系統(tǒng)的發(fā)貨聯(lián)系電話發(fā)貨省consignorProvince255Y客戶系統(tǒng)的發(fā)貨地址發(fā)貨市consignorCity255Y客戶系統(tǒng)的發(fā)貨地址發(fā)貨區(qū)縣consignorCounty255Y客戶系統(tǒng)的發(fā)貨地址發(fā)貨街道consignorTown255客戶系統(tǒng)的發(fā)貨地址發(fā)貨詳細(xì)地址consignorAddress255Y客戶系統(tǒng)的發(fā)貨地址預(yù)計(jì)入庫(kù)時(shí)間arriveTimeyyyy-MM-ddHH:mm:ss(2016-12-2318:16:23)相關(guān)單號(hào)relationOrder退貨入庫(kù)：原始出庫(kù)單號(hào)調(diào)撥入庫(kù)：調(diào)撥出庫(kù)單號(hào)此字段為預(yù)留字段；運(yùn)輸車(chē)輛車(chē)牌號(hào)plateNumber30運(yùn)輸車(chē)輛司機(jī)姓名driverName30運(yùn)輸車(chē)輛聯(lián)系電話contactNumber30取貨時(shí)間pickupTime時(shí)間格式:yyyy-MM-ddHH:mm:ss(2016-12-2318:16:23)運(yùn)輸要求transRequire500重量weight18，小數(shù)點(diǎn)三位體積cubage20件數(shù)quantity18，小數(shù)點(diǎn)三位合計(jì)標(biāo)準(zhǔn)箱totalStandardBox8最大值9999備注notes300明細(xì)信息字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注貨品編碼goodsCode30Y客戶系統(tǒng)的商品編碼貨品名稱(chēng)goodsName1000Y客戶系統(tǒng)的商品名稱(chēng)貨品規(guī)格goodsSpec20客戶系統(tǒng)的規(guī)格預(yù)期數(shù)量quantity18，保留小數(shù)點(diǎn)兩位Y入庫(kù)件數(shù)貨品單位unit6Y生產(chǎn)批次productionBatch100生產(chǎn)日期productionTimeyyyy-MM-dd失效日期invalidTimeyyyy-MM-dd銷(xiāo)售單價(jià)unitPrice20Y單位人民幣包裝pack30供應(yīng)商批次supportBatch50批號(hào)lotNumber50重量weight18，小數(shù)點(diǎn)三位單位kg體積cubage20單位報(bào)文格式<?xmlversion="1.0"encoding="UTF-8"?><orders><order><warehouseCode></warehouseCode><warehouseName></warehouseName><custCode></custCode><custName></custName><orderType></orderType><businessType></businessType><provideTransport></provideTransport><custOrderCode></custOrderCode><orderTime></orderTime><supportContact></supportContact><consignorName></consignorName><consignorContact></consignorContact><consignorPhone></consignorPhone><consignorProvince></consignorProvince><consignorCity></consignorCity><consignorCounty></consignorCounty><consignorTown></consignorTown><consignorAddress></consignorAddress><arriveTime></arriveTime><relationOrder></relationOrder><plateNumber></plateNumber><driverName></driverName><contactNumber></contactNumber><pickupTime></pickupTime><transRequire></transRequire><weight></weight><cubage></cubage><quantity></quantity><totalStandardBox></totalStandardBox><notes></notes><orderDetails><orderDetail><goodsCode></goodsCode><goodsName></goodsName><goodsSpec></goodsSpec><quantity></quantity><unit></unit><productionBatch></productionBatch><productionTime></productionTime><invalidTime></invalidTime><unitPrice></unitPrice><pack></pack><supportBatch></supportBatch><lotNumber></lotNumber><weight></weight><cubage></cubage></orderDetail></orderDetails></order></orders>響應(yīng)格式參照4.1響應(yīng)報(bào)文出庫(kù)單下發(fā)功能說(shuō)明當(dāng)客戶完成出庫(kù)作業(yè)后觸發(fā)該接口，將出庫(kù)發(fā)運(yùn)數(shù)據(jù)推送到協(xié)同平臺(tái)，支持批量業(yè)務(wù)處理。服務(wù)方：調(diào)用方：客戶接口方向：客戶通阿里云Api網(wǎng)關(guān)調(diào)用,目前只支持map的傳遞方式,如何調(diào)用阿里云api網(wǎng)關(guān)示例代碼由提供Url:http:///restApi/epc/getOutStockOrder系統(tǒng)參數(shù)傳遞方式:Map{Key=”method”,value=”getOutStockOrder”;Key=”appkey”,value=””;Key=”requestTime”,value=””;Key=”fromSYS=”,value=””;Key=”secret”,value=””;Key=”requestContent”,value=””}應(yīng)用入?yún)⒄f(shuō)明字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注接口方法名method50YgetOutStockOrder密鑰appkey50Y簽名密鑰secret50Y請(qǐng)求時(shí)間requestTimeN平臺(tái)會(huì)按請(qǐng)求時(shí)間存,如果輸入,格式必須為yyyy-MM-ddHH:mm:ss來(lái)源系統(tǒng)fromSYS50Y請(qǐng)求報(bào)文requestContentY無(wú)長(zhǎng)度限制數(shù)據(jù)格式字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注倉(cāng)庫(kù)編碼warehouseCode50Y鮮易平臺(tái)的倉(cāng)庫(kù)編碼倉(cāng)庫(kù)名稱(chēng)warehouseName50Y倉(cāng)庫(kù)名稱(chēng)客戶編碼custCode50Y鮮易平臺(tái)為客戶分配的客戶編碼客戶名稱(chēng)custName50Y客戶名稱(chēng)訂單類(lèi)型orderType2Y60-運(yùn)輸訂單,僅運(yùn)輸業(yè)務(wù)61-倉(cāng)配訂單，有合作倉(cāng)同時(shí)配送業(yè)務(wù)業(yè)務(wù)類(lèi)型businessType20Y訂單類(lèi)型：【61】業(yè)務(wù)類(lèi)型:610-【銷(xiāo)售出庫(kù)】611-【調(diào)撥出庫(kù)】612-【報(bào)損出庫(kù)】613-【其他出庫(kù)】620-【采購(gòu)入庫(kù)】621-【調(diào)撥入庫(kù)】622-【退貨入庫(kù)】623-【加工入庫(kù)】客戶訂單編號(hào)custOrderCode30Y客戶系統(tǒng)的訂單流水號(hào)是否包含運(yùn)輸業(yè)務(wù)provideTransportY0-否1-是訂單時(shí)間orderTime格式：yyyy-MM-ddHH:mm:ss(2016-12-2318:16:23)Y客戶訂單創(chuàng)建時(shí)間收貨方聯(lián)系人編碼consigneeContactCode250收貨方聯(lián)系人編碼收貨單位consigneeName250Y收貨方名稱(chēng)收貨單位聯(lián)系人consigneeContact250Y收貨單位聯(lián)系人收貨人聯(lián)系電話consigneePhone250Y收貨人聯(lián)系電話收貨省consigneeProvince255Y收貨省收貨市consigneeCity255Y收貨市收貨區(qū)縣consigneeCounty255Y收貨區(qū)縣收貨街道consigneeTown255收貨街道收貨詳細(xì)地址consigneeAddress255Y收貨詳細(xì)地址運(yùn)輸司機(jī)姓名driverName30車(chē)牌號(hào)plateNumber30聯(lián)系電話contactNumber30預(yù)計(jì)出庫(kù)時(shí)間arriveTime格式：yyyy-MM-ddHH:mm:ss(2016-12-2318:16:23N客戶系統(tǒng)計(jì)劃時(shí)間相關(guān)單號(hào)relationOrder退貨入庫(kù)：原始出庫(kù)單號(hào)調(diào)撥入庫(kù)：調(diào)撥出庫(kù)單號(hào)此字段為預(yù)留字段運(yùn)輸要求transRequire500合計(jì)標(biāo)準(zhǔn)箱totalStandardBox8重量weight18，小數(shù)點(diǎn)三位體積cubage20件數(shù)quantity18，小數(shù)點(diǎn)三位備注notes300代收標(biāo)識(shí)collectFlag2我司為客戶支持代收服務(wù)代收貨款金額collectLoanAmount18，小數(shù)點(diǎn)兩位是否打印發(fā)票printInvoice10買(mǎi)家支付方式buyerPaymentMethod1000是否保價(jià)insure10保價(jià)金額insureValue100字段名稱(chēng)字段回傳字段長(zhǎng)度是否必輸備注貨品編碼goodsCode30Y貨品名稱(chēng)goodsName1000Y批次號(hào)productionBatch100Y生產(chǎn)日期productionTimeyyyy-MM-dd失效日期invalidTimeyyyy-MM-dd貨品規(guī)格goodsSpec20銷(xiāo)售單價(jià)unitPrice20Y單位人民幣預(yù)期數(shù)量quantity18，小數(shù)點(diǎn)兩位Y貨品單位unit6Y包裝pack30供應(yīng)商批次supportBatch50批號(hào)lotNumber50重量weight18，小數(shù)點(diǎn)三位單位kg體積cubage20單位立方米報(bào)文格式<?xmlversion="1.0"encoding="UTF-8"?><orders><order><warehouseName></warehouseName><custCode></custCode><custName></custName><orderType></orderType><businessType></businessType><custOrderCode></custOrderCode><provideTransport></provideTransport><orderTime></orderTime><consigneeContactCode></consigneeContactCode><consigneeName></consigneeName><consigneeContact></consigneeContact><consigneePhone></consigneePhone><consigneeProvince></consigneeProvince><consigneeCity></consigneeCity><consigneeCounty></consigneeCounty><consigneeTown></consigneeTown><consigneeAddress></consigneeAddress><driverName></driverName><plateNumber></plateNumber><contactNumber></contactNumber><arriveTime></arriveTime><relationOrder></relationOrder><transRequire></transRequire><totalStandardBox></totalStandardBox><weight></weight><cubage></cubage><quantity></quantity><notes></notes><collectFlag></collectFlag><collectLoanAmount></collectLoanAmount><printInvoice></printInvoice><buyerPaymentMethod></buyerPaymentMethod><insure></insure><insureValue></insureValue><orderDetails><orderDetail><goodsCode></goodsCode><goodsName></goodsName><productionBatch></productionBatch><productionTime></productionTime><invalidTime></invalidTime><goodsSpec></goodsSpec><unitPrice></unitPrice><quantity></quantity><unit></unit><pack></pack><supportBatch></supportBatch><lotNumber></lotNumber><weight></weight><cubage></cubage></orderDetail></orderDetails></order></orders>響應(yīng)格式參照4.1響應(yīng)報(bào)文運(yùn)輸單下發(fā)功能說(shuō)明當(dāng)客戶操作出庫(kù)作業(yè)時(shí)，客戶及時(shí)將出庫(kù)單狀態(tài)推送到協(xié)同平臺(tái)，支持批量業(yè)務(wù)處理。服務(wù)方：調(diào)用方：客戶接口方向：客戶Url:http:///restApi/epc/getTransportOrder系統(tǒng)參數(shù)傳遞方式:Map{Key=”method”,value=”getTransportOrder”;Key=”appkey”,value=””;Key=”requestTime”,value=””;Key=”fromSYS=”,value=””;Key=”secret”,value=””;Key=”requestContent”,value=””}應(yīng)用入?yún)⒄f(shuō)明字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注接口方法名method50YgetTransportOrder密鑰appkey50Y簽名密鑰secret50Y請(qǐng)求時(shí)間requestTimeN平臺(tái)會(huì)按請(qǐng)求時(shí)間存,如果輸入,格式必須為yyyy-MM-ddHH:mm:ss來(lái)源系統(tǒng)fromSYS50Y請(qǐng)求報(bào)文requestContentY無(wú)長(zhǎng)度限制數(shù)據(jù)格式字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注客戶編碼custCode50Y鮮易平臺(tái)為客戶分配的客戶編碼客戶名稱(chēng)custName50Y鮮易平臺(tái)客戶的名稱(chēng)客戶訂單編號(hào)custOrderCode30Y客戶系統(tǒng)的單據(jù)流水號(hào)訂單時(shí)間orderTime格式：yyyy-MM-ddHH:mm:ss(2016-12-2318:16:23客戶訂單創(chuàng)建時(shí)間訂單類(lèi)型orderType20Y60-運(yùn)輸訂單,僅運(yùn)輸業(yè)務(wù),61-倉(cāng)配訂單，有合作倉(cāng)同時(shí)配送業(yè)務(wù)運(yùn)輸類(lèi)型transportType20N10-零擔(dān),20-整車(chē),不傳默認(rèn)為10-零擔(dān)業(yè)務(wù)類(lèi)型businessType20Y訂單類(lèi)型：【60】業(yè)務(wù)類(lèi)型：600-【城配】601-【干線】訂單類(lèi)型：【61】業(yè)務(wù)類(lèi)型:610-【銷(xiāo)售出庫(kù)】611-【調(diào)撥出庫(kù)】612-【報(bào)損出庫(kù)】613-【其他出庫(kù)】620-【采購(gòu)入庫(kù)】621-【調(diào)撥入庫(kù)】622-【退貨入庫(kù)】623-【加工入庫(kù)】發(fā)貨方編碼consignorCode50N為空時(shí)，發(fā)貨方信息都為必填，不為空時(shí)，發(fā)貨方信息可以未不必填發(fā)貨單位consignorName100發(fā)貨單位發(fā)貨單位聯(lián)系人consignorContact250發(fā)貨單位聯(lián)系人發(fā)貨人聯(lián)系電話consignorPhone250發(fā)貨人聯(lián)系電話發(fā)貨省consignorProvince250發(fā)貨省發(fā)貨市consignorCity250發(fā)貨市發(fā)貨區(qū)縣consignorCounty250發(fā)貨區(qū)縣發(fā)貨街道consignorTown250發(fā)貨街道發(fā)貨詳細(xì)地址consignorAddress250發(fā)貨詳細(xì)地址收貨方編碼consigneeCode50N為空時(shí)，收貨方信息都為必填，不為空時(shí)，收貨方信息可以未不必填收貨單位consigneeName100收貨單位收貨單位聯(lián)系人consigneeContact250收貨單位聯(lián)系人收貨人聯(lián)系電話consigneePhone250收貨人聯(lián)系電話收貨省consigneeProvince250收貨省收貨市consigneeCity250收貨市收貨區(qū)縣consigneeCounty250收貨區(qū)縣收貨街道consigneeTown250收貨街道收貨詳細(xì)地址consigneeAddress250收貨詳細(xì)地址重量weight18，小數(shù)點(diǎn)三位單位kg體積cubage20立方米件數(shù)quantity18，小數(shù)點(diǎn)三位承諾到達(dá)時(shí)間expectedArrivedTime格式：yyyy-MM-ddHH:mm:ss(2016-12-2318:16:23)承諾到達(dá)時(shí)間運(yùn)輸要求transRequire500運(yùn)輸要求備注notes250備注代收標(biāo)識(shí)collectFlag2代收標(biāo)識(shí)代收貨款金額collectLoanAmount18，小數(shù)點(diǎn)兩位是否打印發(fā)票printInvoice10買(mǎi)家支付方式buyerPaymentMethod100是否保價(jià)insure10保價(jià)金額insureValue100明細(xì)信息字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注客戶貨品分類(lèi)custGoodsTypeCode20客戶系統(tǒng)自有分類(lèi)平臺(tái)貨品大類(lèi)goodsTypeCode20客戶按平臺(tái)分類(lèi)映射推送的貨品大類(lèi)平臺(tái)貨品小類(lèi)goodsCategoryCode20客戶按平臺(tái)分類(lèi)映射推送的貨品小類(lèi)貨品編碼goodsCode30Y貨品編碼貨品名稱(chēng)goodsName1000Y貨品名稱(chēng)貨品規(guī)格goodsSpec20貨品規(guī)格預(yù)期數(shù)量quantity18，小數(shù)點(diǎn)兩位預(yù)期數(shù)量重量weight18，小數(shù)點(diǎn)三位Y體積cubage20生產(chǎn)日期productionTimeyyyy-MM-dd生產(chǎn)日期失效日期invalidTimeyyyy-MM-dd失效日期批次號(hào)productionBatch100批次號(hào)貨品單位unit6貨品單位貨品單價(jià)unitPrice18，小數(shù)點(diǎn)兩位貨品單價(jià)報(bào)文格式<?xmlversion="1.0"encoding="UTF-8"?><orders><order><custCode></custCode><custName></custName><custOrderCode></custOrderCode><orderTime></orderTime><orderType></orderType><transportType></transportType><businessType></businessType><consignorCode></consignorCode><consignorName></consignorName><consignorContact></consignorContact><consignorPhone></consignorPhone><consignorProvince></consignorProvince><consignorCity></consignorCity><consignorCounty></consignorCounty><consignorTown></consignorTown><consignorAddress></consignorAddress><consigneeCode></consigneeCode><consigneeName></consigneeName><consigneeContact></consigneeContact><consigneePhone></consigneePhone><consigneeProvince></consigneeProvince><consigneeCity></consigneeCity><consigneeCounty></consigneeCounty><consigneeTown></consigneeTown><consigneeAddress></consigneeAddress><weight></weight><cubage></cubage><quantity></quantity><expectedArrivedTime></expectedArrivedTime><transRequire></transRequire><notes></notes><collectFlag></collectFlag><collectLoanAmount></collectLoanAmount><printInvoice></printInvoice><buyerPaymentMethod></buyerPaymentMethod><insure></insure><insureValue></insureValue><orderDetails><orderDetail><custGoodsTypeCode></custGoodsTypeCode><goodsTypeCode></goodsTypeCode><goodsCategoryCode></goodsCategoryCode><goodsCode></goodsCode><goodsName></goodsName><goodsSpec></goodsSpec><quantity></quantity><weight></weight><cubage></cubage><productionTime></productionTime><invalidTime></invalidTime><productionBatch></productionBatch><unit></unit><unitPrice></unitPrice></orderDetail></orderDetails></order></orders>響應(yīng)格式參照4.1響應(yīng)報(bào)文訂單取消功能說(shuō)明推送訂單后,如需要取消,可通過(guò)此接口推送訂單號(hào),將客戶訂單號(hào)推送過(guò)來(lái),由協(xié)同平臺(tái)進(jìn)行取消操作.并對(duì)進(jìn)行反饋服務(wù)方：協(xié)同平臺(tái)調(diào)用方：接口方向：協(xié)同平臺(tái)通阿里云Api網(wǎng)關(guān)調(diào)用,目前只支持map的傳遞方式,如何調(diào)用阿里云api網(wǎng)關(guān)示例代碼由提供Url:http:///restApi/epc/cancelOrder系統(tǒng)參數(shù)傳遞方式:Map{Key=“method”,value=””;Key=“appkey”,value=””;Key=“requestTime”,value=””;Key=“fromSYS”,value=””;Key=“secret”,value=””;Key=“customerCode”，value=“”;Key=“requestContent”,value=””}應(yīng)用入?yún)⒄f(shuō)明字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注接口方法名method50YcancelOrder密鑰appkey50Y簽名密鑰secret50Y請(qǐng)求時(shí)間requestTimeN平臺(tái)會(huì)按請(qǐng)求時(shí)間存,如果輸入,格式必須為yyyy-MM-ddHH:mm:ss來(lái)源系統(tǒng)fromSYS50Y請(qǐng)求報(bào)文requestContentY無(wú)長(zhǎng)度限制客戶編碼customerCode50Y出參說(shuō)明響應(yīng)報(bào)文參照4.1響應(yīng)報(bào)文狀態(tài)碼參照5.1狀態(tài)碼物流跟蹤信息查詢功能說(shuō)明按訂單查詢，需要提供具體的客戶編號(hào)和客戶單號(hào)服務(wù)方：調(diào)用方：客戶接口方向：客戶通阿里云Api網(wǎng)關(guān)調(diào)用,目前只支持map的傳遞方式,如何調(diào)用阿里云api網(wǎng)關(guān)示例代碼由提供Url:http:///restApi/epc/getTransportStatus系統(tǒng)參數(shù)傳遞方式:Map{Key=”method”,value=”getTransportStatus”;Key=”appkey”,value=””;Key=”requestTime”,value=””;Key=”fromSYS=”,value=””;Key=”secret”,value=””;Key=”customerOrderCode”,value=””Key=”customerCode”,value=””;}應(yīng)用入?yún)⒄f(shuō)明字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注接口方法名method50YgetTransportStatus密鑰appkey50Y簽名密鑰secret50Y請(qǐng)求時(shí)間requestTimeN平臺(tái)會(huì)按請(qǐng)求時(shí)間存,如果輸入,格式必須為yyyy-MM-ddHH:mm:ss來(lái)源系統(tǒng)fromSYS50Y客戶訂單號(hào)customerOrderCode50Y客戶編碼customerCode10Y數(shù)據(jù)格式字段名稱(chēng)字段編碼字段長(zhǎng)度是否必填備注客戶編碼customerCode客戶訂單號(hào)customerOrderCode運(yùn)輸單號(hào)transportNo明細(xì)信息字段名稱(chēng)字段編碼字段長(zhǎng)度是否必填備注操作類(lèi)型status位置location溫度temperature操作員operator操作單位unit操作時(shí)間traceTime描述信息description報(bào)文格式<?xmlversion="1.0"encoding="UTF-8"?><transportList><transport><customerOrderCode>/</customerOrderCode><customerCode>/</customerCode><transportNo>/</transportNo><transportStates><transportState><status>/</status><location>/</location><temperature>/</temperature> <operator>/</operator><unit>/</unit><description>/</description><traceTime>/</traceTime></transportState></transportStates></transport></transportList>響應(yīng)報(bào)文交貨量同步功能說(shuō)明通過(guò)此接口,可修改運(yùn)輸單的明細(xì),只限于單子為發(fā)運(yùn).服務(wù)方：調(diào)用方：客戶接口方向：客戶Url:http:///restApi/epc/goodsAmountSync系統(tǒng)參數(shù)傳遞方式:Map{Key=”method”,value=”goodsAmountSync”;Key=”appkey”,value=””;Key=”requestTime”,value=””;Key=”fromSYS=”,value=””;Key=”secret”,value=””;Key=”requestContent”,value=””}應(yīng)用級(jí)入?yún)⒄f(shuō)明字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注接口方法名method50YgoodsAmountSync密鑰appkey50Y簽名密鑰secret50Y請(qǐng)求時(shí)間requestTimeN平臺(tái)會(huì)按請(qǐng)求時(shí)間存,如果輸入,格式必須為yyyy-MM-ddHH:mm:ss來(lái)源系統(tǒng)fromSYS50Y請(qǐng)求報(bào)文requestContentY無(wú)長(zhǎng)度限制數(shù)據(jù)格式字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注客戶編碼custCode50Y客戶名稱(chēng)custName50Y客戶訂單編號(hào)custOrderCode30Y銷(xiāo)售訂單編號(hào)明細(xì)信息字段名稱(chēng)字段編碼字段長(zhǎng)度是否必輸備注貨品編碼goodsCode50Y貨品名稱(chēng)goodsName1000Y貨品單位unit6Y交貨重量weight18，小數(shù)點(diǎn)兩位Y（數(shù)量重量二者有一）眾品對(duì)接實(shí)際出庫(kù)數(shù)量交貨數(shù)量qty18，小數(shù)點(diǎn)兩位Y（數(shù)量重量二者有一）新增字段交貨體積volume20N新增字段報(bào)文格式<?xmlversion="1.0"encoding="UTF-8"?><goodsList><goods><custCode></custCode><custName></custName><custOrderCode></custOrderCode><goodsDetailList><goodsDetail><goodsCode></goodsCode><goodsName></goodsName><unit></unit><weight></weight><qty></qty><volume></volume></goodsDetail></goodsDetailList></goods></goodsList>響應(yīng)格式參照4.1響應(yīng)報(bào)文訂單對(duì)賬推送接口功能說(shuō)明結(jié)算中心，收入確認(rèn)之后,按單將收入確認(rèn)推送到眾品。確認(rèn)修改審核通過(guò)后，按單將收入確認(rèn)推送到眾品。批量最多1000服務(wù)方：調(diào)用方：接口方向：客戶數(shù)據(jù)格式字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注訂單號(hào)orderCode100Y客戶訂單號(hào)custOrderCode50Y客戶編號(hào)custCode50Y平臺(tái)類(lèi)型platformType50Y訂單類(lèi)型orderType50Y60:運(yùn)輸訂單61:倉(cāng)儲(chǔ)訂單業(yè)務(wù)類(lèi)型businessType50Y600:城配601:干線602:卡班610:銷(xiāo)售出庫(kù)611:調(diào)撥出庫(kù)612:報(bào)損出庫(kù)613:其他出庫(kù)620:采購(gòu)入庫(kù)621:調(diào)撥入庫(kù)622:退貨入庫(kù)623:加工入庫(kù)調(diào)度單號(hào)scheduleCode100Y車(chē)牌號(hào)shipmentBus100Y重量weight50Y體積cubage100Y數(shù)量quantity50Y結(jié)算金額serviceCharge50Y發(fā)車(chē)時(shí)間shipmentDateN收入確認(rèn)時(shí)間settleTimeY報(bào)文格式<?xmlversion="1.0"encoding="UTF-8"?><orderReconciliations><orderReconciliation><orderCode></orderCode><custOrderCode></custOrderCode><custCode></custCode><orderType></orderType><businessType></businessType><scheduleCode></scheduleCode><shipmentBus></shipmentBus><weight></weight><cubage></cubage><quantity></quantity><serviceCharge></serviceCharge><shipmentDate></shipmentDate><settleTime></settleTime></orderReconciliation></orderReconciliations>響應(yīng)格式參照4.1響應(yīng)報(bào)文訂單狀態(tài)推送接口功能說(shuō)明服務(wù)方：調(diào)用方：接口方向：客戶數(shù)據(jù)格式字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注訂單號(hào)orderCode100Y客戶訂單號(hào)custOrderCode50Y客戶編號(hào)custCode50Y訂單類(lèi)型orderType50Y60:運(yùn)輸訂單61:倉(cāng)儲(chǔ)訂單業(yè)務(wù)類(lèi)型businessType50Y600:城配601:干線602:卡班610:銷(xiāo)售出庫(kù)611:調(diào)撥出庫(kù)612:報(bào)損出庫(kù)613:其他出庫(kù)620:采購(gòu)入庫(kù)621:調(diào)撥入庫(kù)622:退貨入庫(kù)623:加工入庫(kù)調(diào)度單號(hào)deliveryCode100Y車(chē)牌號(hào)vehicle100Y車(chē)型carLen100狀態(tài)status已裝車(chē)、已發(fā)車(chē)、已運(yùn)達(dá)、已簽收簽收方式signMode1手機(jī)APP簽收，2網(wǎng)站簽收(APP,PC)簽收坐標(biāo)(經(jīng)度,維度)signCoordinate如果是手機(jī)APP簽收則取手機(jī)數(shù)據(jù)，沒(méi)有就取車(chē)載GPS數(shù)據(jù)，在沒(méi)有就是空。網(wǎng)站簽收就取車(chē)載GPS數(shù)據(jù)，在沒(méi)有就是空簽收地址signAddress根據(jù)簽收坐標(biāo)計(jì)算操作時(shí)間operatingTime車(chē)輛類(lèi)型carTyp載重carryCapacity報(bào)文格式<?xmlversion="1.0"encoding="UTF-8"?><orderStatuss><orderStatus><orderCode></orderCode><custOrderCode></custOrderCode><custCode></custCode><orderType></orderType><businessType></businessType><deliveryCode></deliveryCode><vehicle></vehicle><status></status><signMode></signMode><signCoordinate></signCoordinate><signAddress></signAddress><carLen></carLen><carTyp></carTyp><carryCapacity></carryCapacity><operatingTime></operatingTime></orderStatus></orderStatuss>響應(yīng)格式響應(yīng)報(bào)文參照4.1響應(yīng)報(bào)文狀態(tài)碼詳見(jiàn)5.2入庫(kù)單結(jié)果反饋功能說(shuō)明平臺(tái)接收WMS入庫(kù)完成后,將實(shí)際入庫(kù)結(jié)果反饋給客戶.數(shù)據(jù)格式表頭:字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注訂單號(hào)orderCode100Y倉(cāng)庫(kù)編碼wareHouseCode倉(cāng)庫(kù)名稱(chēng)wareHouseName客戶訂單號(hào)custOrderCode50Y客戶編號(hào)custCode50Y客戶名稱(chēng)custName入庫(kù)時(shí)間inStockTime表體:字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注貨品編碼goodsCode100Y貨品名稱(chēng)goodsName50Y單位unit50Y規(guī)格goodsSpec包裝package預(yù)計(jì)數(shù)量quantity實(shí)際數(shù)量realQuantity預(yù)計(jì)主單位數(shù)量quantityMainUnit實(shí)際主單位數(shù)量realQuantityMainUnit批次號(hào)productionBatch生產(chǎn)日期productionTime失效日期invalidTime供應(yīng)商批次supportBatch批號(hào)lotNumber質(zhì)量狀態(tài)goodsStatusY正品N殘品報(bào)文格式<?xmlversion="1.0"encoding="UTF-8"?><InStockResult><orderCode></orderCode><wareHouseCode></wareHouseCode><wareHouseName></wareHouseName><custOrderCode></custOrderCode><custCode></custCode><custName></custName><inStockTime></inStockTime><InStockDetails><InStockDetail><goodsCode></goodsCode><goodsName></goodsName><unit></unit><goodsSpec></goodsSpec><package></package><quantity></quantity><realQuantity></realQuantity><quantityMainUnit></quantityMainUnit><realQuantityMainUnit></realQuantityMainUnit><productionBatch></productionBatch><productionTime></productionTime><invalidTime></invalidTime><supportBatch></supportBatch><lotNumber></lotNumber></InStockDetail></InStockDetails><InStockResult>響應(yīng)報(bào)文參照4.1響應(yīng)報(bào)文出庫(kù)單結(jié)果反饋功能說(shuō)明平臺(tái)接收WMS出庫(kù)完成后,將實(shí)際出庫(kù)結(jié)果反饋給客戶.數(shù)據(jù)格式表頭字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注訂單號(hào)orderCode100Y倉(cāng)庫(kù)編碼wareHouseCode倉(cāng)庫(kù)名稱(chēng)wareHouseName客戶訂單號(hào)custOrderCode50Y客戶編號(hào)custCode50Y客戶名稱(chēng)custName出庫(kù)時(shí)間outDeliverTime表體字段名稱(chēng)回傳字段字段長(zhǎng)度是否必輸備注貨品編碼goodsCode100Y貨品名稱(chēng)goodsName50Y單位unit50Y規(guī)格goodsSpec包裝pa