中間件接口mtsca開(kāi)發(fā)對(duì)外發(fā)布

1、中間件服務(wù)接口開(kāi)檔1文檔介紹61.1文檔目的與范圍61.2系統(tǒng)要求62調(diào)用參數(shù)說(shuō)明62.1調(diào)用方式介紹62.2方法，和參數(shù)說(shuō)明92.2.1DLL API 方式02ExecuteTaskInFile9ExecuteTaskInFileW9ExecuteTaskInString10ExecuteTaskInStringW10QueryTask11QueryTaskW11CancelTask12CancelTaskW12Query

2、Status12QueryStatusW13Free13Release133數(shù)據(jù)傳輸結(jié)構(gòu)說(shuō)明143.1任務(wù)信息結(jié)構(gòu)143.2電子秤信息結(jié)構(gòu)173.3命令字信息結(jié)構(gòu)203.4任務(wù)執(zhí)行結(jié)果信息213.5數(shù)據(jù)內(nèi)容信息結(jié)構(gòu)253.5.1商品數(shù)據(jù)25Page 2 / 95中間件服務(wù)接口開(kāi)檔3.5.2附加文本323.5.3預(yù)置鍵333.5.4標(biāo)頭腳注363.5.5條碼格式373.5.6文本403.5.7游動(dòng)字幕403.5.8皮重413.5.9操作員信息423.5.10時(shí)間信息433.5.11支付方式443.5.12電子秤狀態(tài)473.5.13會(huì)員價(jià)信息484數(shù)據(jù)同步（取數(shù)）功能說(shuō)明494.1數(shù)據(jù)同步說(shuō)明49

3、4.2數(shù)據(jù)庫(kù)結(jié)構(gòu)說(shuō)明494.2.1商品數(shù)據(jù)494.2.2附加文本565流水回收功能說(shuō)明565.1流水回收說(shuō)明565.2數(shù)據(jù)庫(kù)結(jié)構(gòu)說(shuō)明57Page 3 / 95中間件服務(wù)接口開(kāi)檔5.2.1常規(guī)數(shù)據(jù)庫(kù)結(jié)構(gòu)5明細(xì)表結(jié)構(gòu)57非現(xiàn)金支付表結(jié)構(gòu)59小計(jì)表結(jié)構(gòu)606會(huì)員支付功能說(shuō)明626.1邏輯視圖626.2接口實(shí)現(xiàn)方式626.2.1動(dòng)態(tài)庫(kù)接口6接口63消費(fèi)接口64消費(fèi)沖正接口65充值接口66充值沖正接口676.2.2應(yīng)用程序接口686.2.3HTTP 接口66.

4、..客戶(hù)端簽到接口70接口71消費(fèi)接口73消費(fèi)沖正接口76充值接口79充值沖正接口816.2.4Socket 接口846.3錯(cuò)誤碼對(duì)照表856.4數(shù)據(jù)加密說(shuō)明886.5代碼示例89附錄89·1常用應(yīng)用場(chǎng)景示例89Page 4 / 95中間件服務(wù)接口開(kāi)檔1.1下發(fā)商品數(shù)據(jù)891.2下發(fā)預(yù)置鍵911.3參數(shù)設(shè)置931.4回收流水?dāng)?shù)據(jù)95Page 5 / 95中間件服務(wù)接口開(kāi)檔1 文檔介紹1.1 文檔目的與范圍此文檔包含了 MTScaleKey 的接口說(shuō)明。MTScaleKey 是目前 Mettler Toledo商衡電子秤的數(shù)據(jù)傳輸服務(wù)，

5、只要遵循接口說(shuō)明， 用戶(hù)可以在開(kāi)發(fā)中與MTScaleKey 進(jìn)行通訊，完成對(duì)電子秤數(shù)據(jù)的下發(fā)和回收。1.2 系統(tǒng)要求MTScaleKey 的運(yùn)行要求:Windows 下：Windows2000 以上版本，需要 MicrosoftVisual C+Runntime 支持。Linux 下：需要 C+ 庫(kù)支持。2 調(diào)用參數(shù)說(shuō)明2.1 調(diào)用方式介紹MTScaleKey 是一款數(shù)據(jù)通訊中間件程序，它的主要作用是MT 電子秤和軟件集成商之間商品數(shù)據(jù)通訊的橋梁，目前它支持的 MT 電子秤類(lèi)型包括：I15，bTwin,8442, RL00, bCom, bPro, bMobile, bPLUS, Freshb

6、ase;Page 6 / 95中間件服務(wù)接口開(kāi)檔對(duì)于軟件集成商：·只需要了解 MTScaleKey 提供的通訊接口格式，而無(wú)須關(guān)心 MT 各款電子秤之間數(shù)據(jù)結(jié)構(gòu)的差別，這在很大程度縮短了系統(tǒng)對(duì)接的時(shí)間同時(shí)提升了對(duì)接的效率；·一旦對(duì)接完成以后無(wú)須再進(jìn)行任何系統(tǒng)代碼的修改，即使 MT 電子秤升級(jí)也只需要簡(jiǎn)單升級(jí) MTScaleKey 程序即可，因?yàn)?MTScaleKey 將一直保持通訊接口格式的一致；·MTScaleKey 集成了之前各款 MT 數(shù)據(jù)通訊中間件的功能，目前它是MT 對(duì)外提供的唯一中間件程序，軟件集成商無(wú)須再為使用哪款中間件而困惑；·MTSca

7、leKey 大幅提升了數(shù)據(jù)傳輸?shù)男阅芡瑫r(shí)提供了測(cè)試工具，軟件集成商進(jìn)行系統(tǒng)的調(diào)試和問(wèn)題的更加方便；目前 MTScaleKey 主要提供兩種形式的接口：Page 7 / 95中間件服務(wù)接口開(kāi)檔DLL 形式：適用于只需要商品數(shù)據(jù)傳輸?shù)膱?chǎng)合 （免安裝，直接拷貝）DLL+服務(wù)形式: 適用于所有應(yīng)用場(chǎng)合（需要安裝）；系統(tǒng)在安裝完成后，會(huì)在用戶(hù)指定的目錄下自動(dòng)生成 MTScaleAPI 文件夾同時(shí)在自動(dòng)運(yùn)行服務(wù)程序；MTScaleAPI 文件夾包含了接口調(diào)用需要的所有文件，只需要將文件內(nèi)容全部拷貝到目標(biāo)程序目錄下即可；如果選擇的是安裝版程序，需要將 MTScaleKey 安裝程序打包到最終的軟件釋放包中或

8、者在客戶(hù)目標(biāo)機(jī)上安裝 MTScaleKey 安裝包；MTScaleKey 接互的數(shù)據(jù)參數(shù)使用 Xml 結(jié)構(gòu)的字或者文件。接口調(diào)用的主要步驟如下：l 生成任務(wù)信息，包含任務(wù)的類(lèi)型，下達(dá)任務(wù)的時(shí)間，執(zhí)行任務(wù)的電子秤列表編號(hào)，具體任務(wù)信息結(jié)構(gòu)參見(jiàn)3.1 任務(wù)信息結(jié)構(gòu)l 生成電子秤列表信息，包含要執(zhí)行任務(wù)的電子秤信息，具體電子秤信息結(jié)構(gòu)參見(jiàn)3.2 電子秤信息結(jié)構(gòu)，如果是參數(shù)設(shè)置，那么生成參數(shù)列表信息，具體的參數(shù)信息結(jié)構(gòu)參見(jiàn)3.6 參數(shù)設(shè)置信息結(jié)構(gòu)，下面的步驟可以跳過(guò)。每臺(tái)秤生成一個(gè)命令字信息，包含這臺(tái)秤要進(jìn)行通訊令，具體命令字l結(jié)構(gòu)參見(jiàn)3.3 命令字信息結(jié)構(gòu)每個(gè)命令字生成要通訊的數(shù)據(jù)內(nèi)容，例如要下發(fā)商

9、品數(shù)據(jù)，則需要生成商l品數(shù)據(jù)列表供 MTScaleKey，具體數(shù)據(jù)內(nèi)容的格式參見(jiàn)3.5 數(shù)據(jù)內(nèi)容信息結(jié)構(gòu)中的內(nèi)容。Page 8 / 95中間件服務(wù)接口開(kāi)檔2.2 方法，和參數(shù)說(shuō)明以下的接口方法、和參數(shù)說(shuō)明提供多種字符編碼版本，請(qǐng)參照格式調(diào)用，比如C+，C#調(diào)用推薦使用 Ansi 版本，JAVA 調(diào)用推薦使用 Unicode 版本。2.2.1 DLL API 方式DLL 是 采用 VC+編寫(xiě)的 DLL，調(diào)用 MTScaleAPI.dll, 相關(guān)庫(kù)文件見(jiàn)安裝目錄中的 MTScaleAPI 子目錄。 ExecuteTaskInFile以文件方式傳入?yún)?shù)執(zhí)行任務(wù)，Ansi 版本，文件必須

10、以 UTF-8 格式保存函數(shù)：extern "C" bool _stdcall ExecuteTaskInFile(const char *szTaskID, const char*szInputFile, const char *szOutputFile, bool bSynch)傳入?yún)?shù)：szTaskID: String 類(lèi)型，傳入的任務(wù)編號(hào)（唯一），Ansi 編碼szInputFile: String 類(lèi)型，傳入的任務(wù)信息文件名（全路徑），Ansi 編碼 szOutputFile: String 類(lèi)型，需要生成的任務(wù)結(jié)果信息文件名（全路徑），Ansi 編碼bSynch

11、：bool 類(lèi)型，執(zhí)行方式，True 為同步執(zhí)行，即傳輸完畢后再返回，F(xiàn)alse 為異步執(zhí)行，即驗(yàn)證完輸入?yún)?shù)正確性后就返回，自動(dòng)執(zhí)行任務(wù)。返回值：bool 類(lèi)型，返回調(diào)用是否。 ExecuteTaskInFileW以文件方式傳入?yún)?shù)執(zhí)行任務(wù)，Unicode 版本，文件必須以 UTF-8 格式保存函數(shù)：extern "C" bool _stdcall ExecuteTaskInFileW(const wchar_t *szTaskID, constwchar_t *szInputFile, const wchar_t *szOutputFile, bool b

12、Synch)Page 9 / 95中間件服務(wù)接口開(kāi)檔傳入?yún)?shù)：szTaskID: WideString 類(lèi)型，傳入的任務(wù)編號(hào)（唯一），Unicode 編碼szInputFile: WideString 類(lèi)型，傳入的任務(wù)信息文件名（全路徑）， Unicode 編碼szOutputFile: WideString 類(lèi)型，需要生成的任務(wù)結(jié)果信息文件名（全路徑）， Unicode 編碼bSynch：bool 類(lèi)型，執(zhí)行方式，True 為同步執(zhí)行，即傳輸完畢后再返回，F(xiàn)alse 為異步執(zhí)行，即驗(yàn)證完輸入?yún)?shù)正確性后就返回，自動(dòng)執(zhí)行任務(wù)。返回值：bool 類(lèi)型，返回調(diào)用是否。 Execute

13、TaskInString以 Xml 字的方式傳入?yún)?shù)執(zhí)行任務(wù)，Ansi 版本，由于內(nèi)存占用的關(guān)系，字方式不能執(zhí)行大數(shù)據(jù)的任務(wù)函數(shù)：extern "C" char *_stdcall ExecuteTaskInString(const char *szTaskID, const char*szInput, bool bSynch)傳入?yún)?shù)：szTaskID: String 類(lèi)型，傳入的任務(wù)編號(hào)（唯一），Ansi 編碼szInput: String 類(lèi)型，傳入的 Xml 信息字Ansi 編碼，Xml 結(jié)構(gòu)參見(jiàn)3 傳輸結(jié)構(gòu)說(shuō)明，bSynch：bool 類(lèi)型，執(zhí)行方式，True 為

14、同步執(zhí)行，即傳輸完畢后再返回，F(xiàn)alse 為異步執(zhí)行，即驗(yàn)證完輸入?yún)?shù)正確性后就返回，自動(dòng)執(zhí)行任務(wù)。返回值：String 類(lèi)型，返回調(diào)用傳輸后的結(jié)果，以 Xml 形式體現(xiàn)，Ansi 編碼。 ExecuteTaskInStringW以 Xml 字的方式傳入?yún)?shù)執(zhí)行任務(wù)，Unicode 版本，由于內(nèi)存占用的關(guān)系，字方式不能執(zhí)行大數(shù)據(jù)的任務(wù)函數(shù)：extern "C" wchar_t *_stdcall ExecuteTaskInStringW(const wchar_t *szTaskID,const wchar_t *szInput, bool bSynch)Pa

15、ge 10 / 95中間件服務(wù)接口開(kāi)檔傳入?yún)?shù)：szTaskID: WideString 類(lèi)型，傳入的任務(wù)編號(hào)（唯一），Ansi 編碼szInput: WideString 類(lèi)型，傳入的 Xml 信息字明，Ansi 編碼，Xml 結(jié)構(gòu)參見(jiàn)3 傳輸結(jié)構(gòu)說(shuō)bSynch：bool 類(lèi)型，執(zhí)行方式，True 為同步執(zhí)行，即傳輸完畢后再返回，F(xiàn)alse 為異步執(zhí)行，即驗(yàn)證完輸入?yún)?shù)正確性后就返回，自動(dòng)執(zhí)行任務(wù)。返回值：WideString 類(lèi)型，返回調(diào)用傳輸后的結(jié)果，以 Xml 形式體現(xiàn)，Unicode 編碼。 QueryTask指定的任務(wù)狀態(tài)，以 Xml 字的方式傳入?yún)?shù)，Ansi 版本

16、。函數(shù)：extern "C" char *_stdcall QueryTask(const char *szInput)傳入?yún)?shù)：szInput: String 類(lèi)型，傳入的 Xml 信息字Ansi 編碼，Xml 結(jié)構(gòu)參見(jiàn)3 傳輸結(jié)構(gòu)說(shuō)明，返回值：String 類(lèi)型，返回指定的任務(wù)狀態(tài)，以 Xml 形式體現(xiàn)，如果是批量多個(gè)任務(wù)，只返回已經(jīng)存在的任務(wù)的狀態(tài)，Ansi 編碼。 QueryTaskW指定的任務(wù)狀態(tài)，以 Xml 字的方式傳入?yún)?shù)，Unicode 版本。函數(shù)：extern "C" wchar_t *_stdcall QueryTask

17、W(const wchar_t *szInput)傳入?yún)?shù)：szInput: WideString 類(lèi)型，傳入的 Xml 信息字明，Unicode 編碼，Xml 結(jié)構(gòu)參見(jiàn)3 傳輸結(jié)構(gòu)說(shuō)返回值：WideString 類(lèi)型，返回指定的任務(wù)狀態(tài)，以 Xml 形式體現(xiàn)，如果是批量多個(gè)任務(wù)，只返回已經(jīng)存在的任務(wù)的狀態(tài)， Unicode 編碼。Page 11 / 95中間件服務(wù)接口開(kāi)檔 CancelTask取消指定的任務(wù)，以字的方式傳入?yún)?shù)，Ansi 編碼。函數(shù)：extern "C" bool _stdcall CancelTask(const char *szInput

18、)傳入?yún)?shù)：szInput: String 類(lèi)型，傳入的任務(wù)編號(hào)，Ansi 編碼。返回值：bool 類(lèi)型，返回調(diào)用是否。 CancelTaskW取消指定的任務(wù)，以字的方式傳入?yún)?shù)，Unicode 版本。函數(shù)：extern "C" bool _stdcall CancelTaskW(const wchar_t *szInput)傳入?yún)?shù)：szInput: WideString 類(lèi)型，傳入的任務(wù)編號(hào)，Unicode 編碼。返回值：bool 類(lèi)型，返回調(diào)用是否。 QueryStatus中間件指定組件的配置參數(shù)，或電子秤列表，以字的方式傳入?yún)?shù)，Ansi

19、版本。函數(shù)：extern "C" char *_stdcall QueryStatus(const char *szInput)傳入?yún)?shù)：szInput: String 類(lèi)型，傳入的 Xml 信息字Ansi 編碼。, Xml 結(jié)構(gòu)參見(jiàn)3 傳輸結(jié)構(gòu)說(shuō)明，返回值：String 類(lèi)型，返回指定組件的配置參數(shù)或者電子秤列表，以 Xml 形式體現(xiàn)，AnsiPage 12 / 95中間件服務(wù)接口開(kāi)檔編碼。0 QueryStatusW中間件指定組件的配置參數(shù)，或電子秤列表，以字的方式傳入?yún)?shù)， Unicode版本。函數(shù)：extern "C" wchar_

20、t *_stdcall QueryStatusW(const wchar_t *szInput)傳入?yún)?shù)：szInput: WideString 類(lèi)型，傳入的 Xml 信息字Unicode 編碼。, Xml 結(jié)構(gòu)參見(jiàn)3 傳輸結(jié)構(gòu)說(shuō)明，返回值：WideString 類(lèi)型，返回指定組件的配置參數(shù)或者電子秤列表，以 Xml 形式體現(xiàn)，Unicode 編碼。1 Free以上方法中返回的字，必須調(diào)用，否則會(huì)產(chǎn)生內(nèi)存泄漏。函數(shù)：extern "C" void _stdcall Free(void *p)傳入?yún)?shù)：p: 指針類(lèi)型，傳入的字指針。無(wú)返回值2 Re

21、lease動(dòng)態(tài)庫(kù)，動(dòng)態(tài)調(diào)用動(dòng)態(tài)庫(kù)時(shí)，必須在卸載動(dòng)態(tài)庫(kù)之前調(diào)用此方法，直接卸載動(dòng)態(tài)庫(kù)會(huì)導(dǎo)致錯(cuò)誤。函數(shù)：extern "C" void _stdcall Release()無(wú)傳入?yún)?shù)Page 13 / 95中間件服務(wù)接口開(kāi)檔無(wú)返回值3 數(shù)據(jù)傳輸結(jié)構(gòu)說(shuō)明3.1 任務(wù)信息結(jié)構(gòu)任務(wù)信息結(jié)構(gòu)中包含了要執(zhí)行的任務(wù)信息，其中的任務(wù)信息結(jié)構(gòu)如下（屬性名中紅色部分為必填信息，部分為在選定情況下必填信息，其他可不填，下同）：Xml 節(jié)點(diǎn)名：MTTaskPage 14 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明Version屬性StringXml 格式的版本號(hào)TaskID子節(jié)點(diǎn)String

22、任務(wù)編號(hào)，唯一標(biāo)識(shí)，在任何情況下都不能重復(fù)TaskTime子節(jié)點(diǎn)String任務(wù)生成時(shí)間，時(shí)間格式為YYYY-MM-DDTHH:mm:ss，例如： 2014-06-09T09:12:12，其他所有日期時(shí)間的格式都與此相同TaskType子節(jié)點(diǎn)int任務(wù)類(lèi)型：0：下發(fā)數(shù)據(jù)1：回收流水3：檢查狀態(tài)4:：自動(dòng)發(fā)現(xiàn)設(shè)備87:會(huì)員卡組件的狀態(tài)89： 自動(dòng)發(fā)現(xiàn)設(shè)備組件的狀態(tài)90： WANService 組件的狀態(tài)91： RetrieveData 組件的狀態(tài)92： TransferData 組件的狀態(tài)93： ReceiveTrade 組件的狀態(tài)94： CheckOnline 組件的狀態(tài)95： 電子秤列表96

23、： MTScaleKey 狀態(tài)97， 多個(gè)任務(wù)狀態(tài)中間件服務(wù)接口開(kāi)檔Setting 結(jié)構(gòu)：Xml 節(jié)點(diǎn)名：Setting附加配置信息包括如下信息：Page 15 / 95配置名稱(chēng)配置說(shuō)明取值范圍UseDept是否啟用部門(mén)管理，涉及到部分協(xié)議中部門(mén)號(hào)的拆分處理，對(duì)bMobile/bDrive 以及 bPlus 無(wú)效True False默認(rèn)為 True，不區(qū)分大小寫(xiě)Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明Name子節(jié)點(diǎn)String參數(shù)名。Value子節(jié)點(diǎn)String參數(shù)值。Scales子節(jié)點(diǎn)在以字方式調(diào)用時(shí)，存放電子秤列表，其中可包含多個(gè) Scale 子節(jié)點(diǎn)98，單個(gè)任務(wù)狀態(tài)99：設(shè)置參數(shù)100

24、：停止進(jìn)程DataFile子節(jié)點(diǎn)String以文件方式調(diào)用時(shí)， 對(duì)應(yīng)電子秤列表文件名或設(shè)置參數(shù)文件名。OutputFile子節(jié)點(diǎn)String任務(wù)結(jié)果輸出文件名，在字方式調(diào)用時(shí)，可以用這個(gè)字段來(lái)指定輸出目錄。Scales子節(jié)點(diǎn)在以字方式調(diào)用時(shí)， 存放電子秤列表，其中可包含多個(gè) Scale 子節(jié)點(diǎn)Settings子節(jié)點(diǎn)在以字 方式調(diào)用時(shí)， 存放設(shè)置參數(shù)列表，其中可包含多個(gè) MTSetting 子節(jié)點(diǎn)AdditionalConfig子節(jié)點(diǎn)String附加的配置信息，單個(gè)配置信息結(jié)構(gòu)為： Name:Value，多個(gè)配置信息以逗號(hào)分隔，字符與預(yù)定義的關(guān)鍵字，使用轉(zhuǎn)義。例如： UseDept:True,E

25、TLinkPLU:False 表示使用部門(mén)管理，ET 與 PLU 不同號(hào)中間件服務(wù)接口開(kāi)檔Page 16 / 95Password秤通訊，只對(duì)bCom/bPro， bMobile/bDrive 以及 bPlus 有效秤通訊ETLinkPLUPlu 和 ET 是否同號(hào)的設(shè)置True False默認(rèn)為 False，不區(qū)分大小寫(xiě)ETMethod表示 ET 處理方式（僅支持bCom/bPro）：0：不分片，1：分片處理默認(rèn)為 0TraceIndexType表示追溯碼索引格 式 （ 僅 支 持bCom/bPro ， RL00）0：字，1：數(shù)字默認(rèn)為 0FixWeightUsage表示秤內(nèi)固定重量字段的用

26、途（僅支持bCom/bPro ，RL00）：0：固定重量，1：計(jì)數(shù)商品默認(rèn)為 0UpdateItemTID表示下發(fā)私有類(lèi)追溯碼時(shí)是否需要更新商品信息中的TraceInfoIDTrue False默認(rèn)為 True，不區(qū)分大小寫(xiě)AutoFitScaleType自動(dòng)適配秤類(lèi)型數(shù)據(jù)下發(fā)True False默認(rèn)為 True，不區(qū)分大小寫(xiě)，不支持 i15，bTwin， bHighTraceIndexFormat追溯碼助記符格式字格式，默認(rèn)為 PPPPPPPPPTCheckOnlineMethod檢測(cè)方式選擇0：Ping 和連接端口測(cè)試1：只做 Ping默認(rèn)為 0中間件服務(wù)接口開(kāi)檔Setting 中涉及到的

27、配置參數(shù)的字段名稱(chēng)參見(jiàn)附錄 1Task.xmlXml 文本示例：文件方式：TaskString.xml字方式（以下發(fā)商品數(shù)據(jù)為例）：3.2 電子秤信息結(jié)構(gòu)電子秤列表結(jié)構(gòu)中包含了要進(jìn)行數(shù)據(jù)傳輸?shù)碾娮映恿斜?，其中的電子秤信息結(jié)構(gòu)如下：Page 17 / 95AutoEnterBoot刷秤時(shí)自動(dòng)進(jìn)入刷秤模式True False默認(rèn)為 True,不區(qū)分大小寫(xiě)，只支持bCom，bProTraceTextLength追溯碼長(zhǎng)度數(shù)字，表示追溯碼文本的長(zhǎng)度，默認(rèn)為 20，僅在 RL00 中私有追溯碼索引為數(shù)字時(shí)生效TraceDescLength追溯碼描述長(zhǎng)度數(shù)字，表示追溯碼描述文本的長(zhǎng)度， 默認(rèn)為 4，僅在R

28、L00 中私有追溯碼索引為數(shù)字時(shí) 生效CheckOnlineTimeout檢測(cè)時(shí)的超時(shí)時(shí)間Ping 的 超 時(shí) 時(shí)間， 以毫秒為單位，默認(rèn) 500msCheckOnlineRetryTimes檢測(cè)重試次數(shù)Ping 的 重 試 次數(shù)，默認(rèn) 3CheckOnlineMaxThreads檢測(cè)同時(shí)檢測(cè)秤的數(shù)量默認(rèn)為 20中間件服務(wù)接口開(kāi)檔Xml 節(jié)點(diǎn)名：ScalePage 18 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明DeviceID子節(jié)點(diǎn)String設(shè)備號(hào)，唯一標(biāo)識(shí)，當(dāng)MTScaleKey 中設(shè)置以秤號(hào)為索引時(shí)，設(shè)備號(hào)等于秤號(hào)；當(dāng)設(shè)置成以 IP 為索引時(shí)，設(shè)備號(hào)等于 IP 地址。Conne

29、ctType子節(jié)點(diǎn)String通訊類(lèi)型： Network：局域網(wǎng)Internet：廣域網(wǎng)ScaleNoint秤號(hào)。ScaleName子節(jié)點(diǎn)String秤名稱(chēng)。CWANID子節(jié)點(diǎn)String廣域網(wǎng)客戶(hù)號(hào)。LocalStoreID子節(jié)點(diǎn)String門(mén)店號(hào)。ConnectParams子節(jié)點(diǎn)其中包含 NetworkParams（局域網(wǎng)參數(shù)）以及 InternetParams（廣域網(wǎng)參數(shù)）兩個(gè)子節(jié)點(diǎn)用于設(shè)置電子秤的連接參數(shù)，兩種方式必須至少填一種ScaleType子節(jié)點(diǎn)String秤類(lèi)型：8442：8442 類(lèi)型的秤BlackEagle： BlackEagle 類(lèi)型的秤bCom：bCom 類(lèi)型的秤bPr

30、o：bPro 類(lèi)型的秤Apollo：Apollo 秤，同 bPro 類(lèi)型bTwin：bTwin 類(lèi)型的秤bHigh：bHigh 類(lèi)型的秤i15：i15 類(lèi)型的秤RL00：RL00/RL00+類(lèi)型的秤bMobile：bMobile 類(lèi)型的秤bDrive：bDrive 類(lèi)型的秤Skipper 5000:Skipper 5000 類(lèi)型，同 bMobile。Skipper 7000: Skipper 7000 類(lèi)型，同 bDrivebPlus：bPlus 類(lèi)型的秤FreshBase：FreshBase 類(lèi)型的秤中間件服務(wù)接口開(kāi)檔NetworkParams 結(jié)構(gòu)（局域網(wǎng)連接參數(shù)，選填）：Xml 節(jié)點(diǎn)名：

31、NetworkParamsInternetParams 結(jié)構(gòu)（廣域網(wǎng)連接參數(shù)，選填）：Xml 節(jié)點(diǎn)名：InternetParamsPage 19 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明Address屬性StringIP 地址。Port屬性int網(wǎng)絡(luò)端，默認(rèn) 8001。Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明Address屬性StringIP 地址。Port屬性Int網(wǎng)絡(luò)端，默認(rèn) 3001。Rider 5000：Rider 5000 秤，同F(xiàn)reshBase 類(lèi)型Rider 8000：Rider 8000 秤，同F(xiàn)reshBase 類(lèi)型Etica：Etica 類(lèi)型的秤Unknown

32、： 未知秤類(lèi)型， 僅用于自動(dòng)發(fā)現(xiàn)時(shí)無(wú)法確定秤類(lèi)型使用。其他所有 ScaleType 節(jié)點(diǎn)都與此相同CODName子節(jié)點(diǎn)StringCOD 號(hào)，標(biāo)準(zhǔn)版本下可不填。DecimalDigits子節(jié)點(diǎn)int小數(shù)點(diǎn)位數(shù)，與秤內(nèi)設(shè)置的小數(shù)點(diǎn)位數(shù)一致，用于金額的計(jì)算，國(guó)內(nèi)一般設(shè)置為 2。DataFile子節(jié)點(diǎn)String以文件方式調(diào)用時(shí)，存放命令字文件名Commands子節(jié)點(diǎn)以字方式調(diào)用時(shí)，存放命令字信息，其中可包含多個(gè) Command 子節(jié)點(diǎn)AdditionalConfig子節(jié)點(diǎn)String附加的配置信息，與任務(wù)信息中的結(jié)構(gòu)相同，如果定義的配置信息與任務(wù)信息中的重復(fù)，則電子秤信息中的為準(zhǔn)中間件服務(wù)接口開(kāi)檔

33、ScaleList.xmlXml 文本示例：注：文件方式下，ScaleList 的根節(jié)點(diǎn)為 Devices3.3 命令字信息結(jié)構(gòu)命令字列表結(jié)構(gòu)中包含了對(duì)應(yīng)的電子秤所要進(jìn)行數(shù)據(jù)傳輸?shù)闹噶罴?，其中令字信息結(jié)構(gòu)如下：Xml 節(jié)點(diǎn)名：CommandPage 20 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明CommandID子節(jié)點(diǎn)String命令字編號(hào)，在每臺(tái)秤令列表中必須唯一。CommandText子節(jié)點(diǎn)String命令字，如 Item。Control子節(jié)點(diǎn)String命令字：Update：更新數(shù)據(jù)。Delete：刪除指定數(shù)據(jù)。DeleteAll：刪除全部數(shù)據(jù)。Read：當(dāng)前數(shù)據(jù)。ReadAl

34、l：所有數(shù)據(jù)。其他所有 Control 節(jié)點(diǎn)均與此相同。ClearData子節(jié)點(diǎn)bool標(biāo)志下發(fā)前是否清空數(shù)據(jù)，即是否先把秤內(nèi)對(duì)應(yīng)數(shù)據(jù)清空后再下發(fā)，僅在命令字為 Write 或 Update 時(shí)有效DataFile子節(jié)點(diǎn)String以文件方式調(diào)用時(shí)，存放命令字?jǐn)?shù)據(jù)文件名。Data子節(jié)點(diǎn)以字方式調(diào)用時(shí)，存放數(shù)據(jù)內(nèi)容， 其中可包含多個(gè)數(shù)據(jù)節(jié)點(diǎn)AdditionalConfig子節(jié)點(diǎn)String附加的配置信息，與任務(wù)信息中的結(jié)構(gòu)相同，如果定義的配置信息與任務(wù)信息或電子秤信息中的重復(fù)，則以命令字信息中的為準(zhǔn)中間件服務(wù)接口開(kāi)檔Commands.xmlXml 文本示例：3.4 任務(wù)執(zhí)行結(jié)果信息任務(wù)執(zhí)行結(jié)果信

35、息結(jié)果包含了任務(wù)執(zhí)行的狀態(tài)或結(jié)果信息：Xml節(jié)點(diǎn)名：MTTaskResultPage 21 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明TaskID子節(jié)點(diǎn)String任務(wù)編號(hào)。TaskType子節(jié)點(diǎn)Int任務(wù)類(lèi)型。StartTime子節(jié)點(diǎn)String任務(wù)開(kāi)始時(shí)間。EndTime子節(jié)點(diǎn)String任務(wù)結(jié)束時(shí)間。ProcessPercent子節(jié)點(diǎn)Int任務(wù)執(zhí)行的進(jìn)度百分比。ReturnCode子節(jié)點(diǎn)String任務(wù)執(zhí)行的返回代碼： OK:無(wú)錯(cuò)誤。ProgramError:程序錯(cuò)誤。DataFileError:數(shù)據(jù)文件錯(cuò)誤。: TaskTypeError:任務(wù)類(lèi)型錯(cuò)誤。TaskRepeatEr

36、ror:任務(wù)重復(fù)。TaskNotExistedError:任務(wù)不存在。TransferError:傳輸錯(cuò)誤。ScaleDataError:電子秤數(shù)據(jù)錯(cuò)誤。DataNotFoundError:數(shù)據(jù)不存在 錯(cuò)誤。ConnectError:電子秤連接錯(cuò)誤。ServiceError:服務(wù)連接不上錯(cuò)誤。UnexpectedStopError:未知的中 斷錯(cuò)誤。 DataNotSupportedError: 不支持傳入的數(shù)據(jù)操作。Cancelled：任務(wù)被取消。ReadFileError:讀文件錯(cuò)誤NeedRestart：需要重啟中間件服務(wù)接口開(kāi)檔TaskResult.xmlXml 文本示例：ScaleR

37、esult 結(jié)構(gòu)：Page 22 / 95MTScaleKey ScaleNotSupportedDataError： 電子秤不支持。 PasswordError：錯(cuò)誤ScaleSpaceFullError：電子秤空間不足。ScaleTypeError：秤類(lèi)型錯(cuò)誤。DataRepeatedError:數(shù)據(jù)重復(fù)錯(cuò)誤。SaveFileError:電子秤保存文件錯(cuò)誤。其他所有 ReturnCode 節(jié)點(diǎn)均與此相同，今后根據(jù)需要會(huì)有新增TaskStatus子節(jié)點(diǎn)String任務(wù)狀態(tài)：Waiting:等待執(zhí)行。Executing:正在執(zhí)行。Output:正在輸出數(shù)據(jù)。Complete:執(zhí)行完畢。Erro

38、r:執(zhí)行錯(cuò)誤。Prepare:準(zhǔn)備執(zhí)行。ErrorMessage子節(jié)點(diǎn)String錯(cuò)誤信息。OtherMessage子節(jié)點(diǎn)String其他信息。OutputFile子節(jié)點(diǎn)String任務(wù)結(jié)果輸出文件名。SettingResults子節(jié)點(diǎn)存放 狀態(tài)或設(shè)置參數(shù)的結(jié)果， 其中可包含多個(gè) SettingResult 子節(jié)點(diǎn)，與每一個(gè)設(shè)置項(xiàng)一一對(duì)應(yīng)ScaleResults子節(jié)點(diǎn)存放電子秤任務(wù)的結(jié)果，其中可包含多個(gè) ScaleResult 子節(jié)點(diǎn)，與每臺(tái)秤任務(wù)一一對(duì)應(yīng)Scales子節(jié)點(diǎn)在做自動(dòng)發(fā)現(xiàn)任務(wù)時(shí)，返回自動(dòng)發(fā)現(xiàn)的電子秤列表，其中可包含多個(gè)Scale 子節(jié)點(diǎn)。中間件服務(wù)接口開(kāi)檔Xml 節(jié)點(diǎn)名：Scal

39、eResultCommandResult 結(jié)構(gòu)：Xml 節(jié)點(diǎn)名：CommandResultPage 23 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明CommandID子節(jié)點(diǎn)String命令字編號(hào)。CommandText子節(jié)點(diǎn)String命令字。Control子節(jié)點(diǎn)String字。StartTime子節(jié)點(diǎn)String命令字任務(wù)開(kāi)始時(shí)間。EndTime子節(jié)點(diǎn)String命令字任務(wù)結(jié)束時(shí)間、ReturnCode子節(jié)點(diǎn)String任務(wù)執(zhí)行的返回代碼。ErrorMessage子節(jié)點(diǎn)String錯(cuò)誤信息。Succeeded子節(jié)點(diǎn)Int數(shù)。Failed子節(jié)點(diǎn)Int失敗數(shù)。Total子節(jié)點(diǎn)Int總數(shù)。

40、DataFile子節(jié)點(diǎn)String以文件方式調(diào)用時(shí)，存放數(shù)據(jù)文件Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明DeviceID子節(jié)點(diǎn)String設(shè)備號(hào)。ScaleNo子節(jié)點(diǎn)Int秤號(hào)。ScaleType子節(jié)點(diǎn)String秤類(lèi)型。StartTime子節(jié)點(diǎn)String電子秤任務(wù)開(kāi)始時(shí)間。EndTime子節(jié)點(diǎn)String電子秤任務(wù)結(jié)束時(shí)間、ReturnCode子節(jié)點(diǎn)String任務(wù)執(zhí)行的返回代碼。ErrorMessage子節(jié)點(diǎn)String錯(cuò)誤信息。CommandResults子節(jié)點(diǎn)命令字結(jié)果信息，其中可包含多個(gè)CommandResult 子節(jié)點(diǎn)，與命令字信息一一對(duì)應(yīng)OtherMessage子節(jié)點(diǎn)Stri

41、ng其他信息。ProcessPercent子節(jié)點(diǎn)Int電子秤任務(wù)執(zhí)行的百分比TaskStatus子節(jié)點(diǎn)String任務(wù)狀態(tài)： Waiting:等待執(zhí)行。Executing:正在執(zhí)行。Output:正在輸出數(shù)據(jù)。Complete:執(zhí)行完畢。Error:執(zhí)行錯(cuò)誤。Prepare:準(zhǔn)備執(zhí)行。中間件服務(wù)接口開(kāi)檔SettingResult 結(jié)構(gòu)：Xml 節(jié)點(diǎn)名：SettingResultTaskResult.xmlXml 文本示例：文件方式：TaskResultString. xml字方式（以狀態(tài)為例）：Page 24 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明Name子節(jié)點(diǎn)String設(shè)置項(xiàng)名

42、稱(chēng)。Value子節(jié)點(diǎn)String設(shè)置項(xiàng)的值。ReturnCode子節(jié)點(diǎn)String任務(wù)執(zhí)行的返回代碼。ErrorMessage子節(jié)點(diǎn)String錯(cuò)誤信息。Succeeded子節(jié)點(diǎn)Int數(shù)。Failed子節(jié)點(diǎn)Int失敗數(shù)。Total子節(jié)點(diǎn)Int總數(shù)。Scales子節(jié)點(diǎn)存放的電子秤列表，其中可包含多個(gè) Scale 子節(jié)點(diǎn)名。Data子節(jié)點(diǎn)以字方式調(diào)用時(shí)，存放數(shù)據(jù)內(nèi)容，其中可包含多個(gè)數(shù)據(jù)節(jié)點(diǎn)OtherMessage子節(jié)點(diǎn)String其他信息。ProcessPercent子節(jié)點(diǎn)Int命令字通訊時(shí)的百分比，在下件以及固件信息時(shí)使用此字段可以知道具體進(jìn)度。TaskStatus子節(jié)點(diǎn)String任務(wù)狀態(tài)：

43、Waiting:等待執(zhí)行。Executing:正在執(zhí)行。Output:正在輸出數(shù)據(jù)。Complete:執(zhí)行完畢。Error:執(zhí)行錯(cuò)誤。Prepare:準(zhǔn)備執(zhí)行。中間件服務(wù)接口開(kāi)檔3.5 數(shù)據(jù)內(nèi)容信息結(jié)構(gòu)數(shù)據(jù)內(nèi)容信息中包含了對(duì)應(yīng)的指令集所要進(jìn)行數(shù)據(jù)傳輸?shù)臄?shù)據(jù)。以下的指令集并不是所有秤都支持，如果在實(shí)際操作中無(wú)法進(jìn)行傳輸，即表明該秤類(lèi)型不支持此指令集。3.5.1商品數(shù)據(jù)命令號(hào)：Item，支持字：o Update： 所有類(lèi)型的秤ete： 所有類(lèi)型的秤eteAll： 除 bTwin,bHigh,Etica 外所有秤o Read：除 Etica 外所有類(lèi)型的秤o ReadAll：除 Etica 外所有類(lèi)

44、型的秤X(jué)ml 節(jié)點(diǎn)名：ItemPage 25 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明PLU子節(jié)點(diǎn)Int商品號(hào)。DepartmentID子節(jié)點(diǎn)Int部門(mén)號(hào)，在 bMobile/bDrive 以及 bPlus 中為必填項(xiàng)，不填則默認(rèn)為 0。AlternativeItemIDs子節(jié)點(diǎn)貨號(hào)列表，其中可包含多個(gè)AlternativeItemID 子節(jié)點(diǎn)，用以存放商品貨號(hào)。Descriptions子節(jié)點(diǎn)商品描述列表，其中可包含多個(gè)Description 子節(jié)點(diǎn)，用以存放商品名稱(chēng)，附加文本信息等。中間件服務(wù)接口開(kāi)檔Page 26 / 95Dates子節(jié)點(diǎn)日期標(biāo)志，其中可包含多個(gè) Date 子節(jié)點(diǎn)

45、，用以存放商品的日期打印信息。ItemGroupID子節(jié)點(diǎn)Int商品組號(hào)。只對(duì) bMobile/bDrive以及 bPlus 有效CategoryIDs子節(jié)點(diǎn)商品分類(lèi)列表，其中可包含多個(gè)CategoryID 子節(jié)點(diǎn)，用以存放商品的分類(lèi)號(hào)。只對(duì) bMobile、bDrive 以及 bPlus 有效Tares子節(jié)點(diǎn)商品皮重號(hào)列表，其中可包含多個(gè) TareID 子節(jié)點(diǎn)以及TareWeight 子節(jié)點(diǎn)，用以存放商品的皮重號(hào)和皮重?cái)?shù)據(jù)。ItemPrices子節(jié)點(diǎn)商品價(jià)格列表，其中可包含多個(gè)ItemPrice 子節(jié)點(diǎn)，用以存放商品的價(jià)格信息。Taxes子節(jié)點(diǎn)商品稅號(hào)列表，其中可包含多個(gè)TaxRuleID

46、子節(jié)點(diǎn)，用以存放商品的稅號(hào)。Ingredients子節(jié)點(diǎn)商品成分列表，其中可包含多個(gè)IngredientID 子節(jié)點(diǎn)，用以存放商品的成分表號(hào)。只對(duì) bMobile、bDrive 以及 bPlus 有效LabelFormats子節(jié)點(diǎn)商品號(hào)列表，其中可包含多個(gè) LabelFormatID 子節(jié)點(diǎn)，用以存放商品的號(hào)。Barcodes子節(jié)點(diǎn)商品條碼號(hào)列表，其中可包含多個(gè) BarcodeID 子節(jié)點(diǎn)，用以存放商品的條碼號(hào)。只對(duì) bMobile、bDrive 以及 bPlus 有效NutritionInformation子節(jié)點(diǎn)商品營(yíng)養(yǎng)表號(hào)列表，其中可包含多個(gè) NutritionInformationID

47、子節(jié)點(diǎn)，用以存放商品的營(yíng)養(yǎng)表號(hào)。只對(duì)bMobile/bDrive 以及bPlus有效FixedQuantity子節(jié)點(diǎn)商品固定重量，在一個(gè) Item 結(jié)構(gòu)中可以包含多個(gè) FixedQuantity 節(jié)點(diǎn)。TraceInfoID子節(jié)點(diǎn)追溯信息號(hào)。中間件服務(wù)接口開(kāi)檔AlternativeItemID 結(jié)構(gòu)（貨號(hào)）：Xml 節(jié)點(diǎn)名：AlternativeItemIDDescription 結(jié)構(gòu)（商品描述文本）：Xml 節(jié)點(diǎn)名：DescriptionPage 27 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明Type屬性String文本類(lèi)型：ItemName：商品名稱(chēng)ItemShortName：商

48、品第二名稱(chēng)ExtraText：附加文本ShortPinYinCode：拼音簡(jiǎn)稱(chēng)ID屬性Int文 本 編 號(hào) ， 當(dāng) 文 本 類(lèi) 型 為ExtraText 時(shí)，輸入附加文本號(hào)， 其他類(lèi)型不填。Language屬性String文本語(yǔ)言： 只對(duì) bMobile/bDrive以及 bPlus 有效zho：中文eng：英文 fra：法語(yǔ) deu：德語(yǔ)其他所有 Language 節(jié)點(diǎn)均與此Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明AlternativeItemID文本String貨號(hào)，最長(zhǎng) 13 位TraceabilityFlag子節(jié)點(diǎn)追溯碼啟用標(biāo)志，此標(biāo)志對(duì)于bPlus，bMobile/bDrive 秤

49、不生效。PriceRule子節(jié)點(diǎn)Int單價(jià)規(guī)則號(hào)，對(duì)于 bPlus， bMobile/bDrive 不生效。Images子節(jié)點(diǎn)圖片號(hào)列表，其中可包含多個(gè)Image 子節(jié)點(diǎn)，用以存放商品的圖片號(hào)。只對(duì) bCom/bPro， bMobile/bDrive 以及bPlus 有效StaggerPrices子節(jié)點(diǎn)階梯價(jià)列表， 其中可包含多個(gè)StaggerPrice 子節(jié)點(diǎn)，用以存放商品的階梯價(jià)格。只對(duì) bMobile、bDrive、bPlus、FreshBase 有效中間件服務(wù)接口開(kāi)檔Date 結(jié)構(gòu)（日期打印標(biāo)志）：Xml 節(jié)點(diǎn)名：DateoffsetCategoryID 結(jié)構(gòu)（分類(lèi)號(hào)）：Page 28 / 95Xml 節(jié)點(diǎn)名Xml 節(jié)點(diǎn)類(lèi)型數(shù)據(jù)類(lèi)型說(shuō)明Type屬性String日期類(lèi)型：SellBy：保質(zhì)日期 BestBefore：推薦日期PackedDate：包裝日期UserDef1：用戶(hù)自定義日期 1 UserDef2：用戶(hù)自定義日期 2UnitOfOffset屬性String：day：天數(shù)hour：小時(shí)數(shù)，只對(duì) bMobile， bDrive，bPlus，F(xiàn)reshBase 有效， 對(duì)包裝日期不生效date：日期，只對(duì) bMobile， bDrive，bPlus，F(xiàn)reshBase 有效。time:時(shí)間，只對(duì) bMobile， bDrive，bPlus，F(xiàn)reshBase 有