中間件接口mtsca開發(fā)對外發(fā)布

1、中間件服務接口開檔1文檔介紹61.1文檔目的與范圍61.2系統要求62調用參數說明62.1調用方式介紹62.2方法，和參數說明92.2.1DLL API 方式02ExecuteTaskInFile9ExecuteTaskInFileW9ExecuteTaskInString10ExecuteTaskInStringW10QueryTask11QueryTaskW11CancelTask12CancelTaskW12Query

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

3、4.2數據庫結構說明494.2.1商品數據494.2.2附加文本565流水回收功能說明565.1流水回收說明565.2數據庫結構說明57Page 3 / 95中間件服務接口開檔5.2.1常規(guī)數據庫結構5明細表結構57非現金支付表結構59小計表結構606會員支付功能說明626.1邏輯視圖626.2接口實現方式626.2.1動態(tài)庫接口6接口63消費接口64消費沖正接口65充值接口66充值沖正接口676.2.2應用程序接口686.2.3HTTP 接口66.

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

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

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

7、leKey 大幅提升了數據傳輸的性能同時提供了測試工具，軟件集成商進行系統的調試和問題的更加方便；目前 MTScaleKey 主要提供兩種形式的接口：Page 7 / 95中間件服務接口開檔DLL 形式：適用于只需要商品數據傳輸的場合 （免安裝，直接拷貝）DLL+服務形式: 適用于所有應用場合（需要安裝）；系統在安裝完成后，會在用戶指定的目錄下自動生成 MTScaleAPI 文件夾同時在自動運行服務程序；MTScaleAPI 文件夾包含了接口調用需要的所有文件，只需要將文件內容全部拷貝到目標程序目錄下即可；如果選擇的是安裝版程序，需要將 MTScaleKey 安裝程序打包到最終的軟件釋放包中或

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

9、品數據，則需要生成商l品數據列表供 MTScaleKey，具體數據內容的格式參見3.5 數據內容信息結構中的內容。Page 8 / 95中間件服務接口開檔2.2 方法，和參數說明以下的接口方法、和參數說明提供多種字符編碼版本，請參照格式調用，比如C+，C#調用推薦使用 Ansi 版本，JAVA 調用推薦使用 Unicode 版本。2.2.1 DLL API 方式DLL 是 采用 VC+編寫的 DLL，調用 MTScaleAPI.dll, 相關庫文件見安裝目錄中的 MTScaleAPI 子目錄。 ExecuteTaskInFile以文件方式傳入參數執(zhí)行任務，Ansi 版本，文件必須

10、以 UTF-8 格式保存函數：extern "C" bool _stdcall ExecuteTaskInFile(const char *szTaskID, const char*szInputFile, const char *szOutputFile, bool bSynch)傳入參數：szTaskID: String 類型，傳入的任務編號（唯一），Ansi 編碼szInputFile: String 類型，傳入的任務信息文件名（全路徑），Ansi 編碼 szOutputFile: String 類型，需要生成的任務結果信息文件名（全路徑），Ansi 編碼bSynch

11、：bool 類型，執(zhí)行方式，True 為同步執(zhí)行，即傳輸完畢后再返回，False 為異步執(zhí)行，即驗證完輸入參數正確性后就返回，自動執(zhí)行任務。返回值：bool 類型，返回調用是否。 ExecuteTaskInFileW以文件方式傳入參數執(zhí)行任務，Unicode 版本，文件必須以 UTF-8 格式保存函數：extern "C" bool _stdcall ExecuteTaskInFileW(const wchar_t *szTaskID, constwchar_t *szInputFile, const wchar_t *szOutputFile, bool b

12、Synch)Page 9 / 95中間件服務接口開檔傳入參數：szTaskID: WideString 類型，傳入的任務編號（唯一），Unicode 編碼szInputFile: WideString 類型，傳入的任務信息文件名（全路徑）， Unicode 編碼szOutputFile: WideString 類型，需要生成的任務結果信息文件名（全路徑）， Unicode 編碼bSynch：bool 類型，執(zhí)行方式，True 為同步執(zhí)行，即傳輸完畢后再返回，False 為異步執(zhí)行，即驗證完輸入參數正確性后就返回，自動執(zhí)行任務。返回值：bool 類型，返回調用是否。 Execute

13、TaskInString以 Xml 字的方式傳入參數執(zhí)行任務，Ansi 版本，由于內存占用的關系，字方式不能執(zhí)行大數據的任務函數：extern "C" char *_stdcall ExecuteTaskInString(const char *szTaskID, const char*szInput, bool bSynch)傳入參數：szTaskID: String 類型，傳入的任務編號（唯一），Ansi 編碼szInput: String 類型，傳入的 Xml 信息字Ansi 編碼，Xml 結構參見3 傳輸結構說明，bSynch：bool 類型，執(zhí)行方式，True 為

14、同步執(zhí)行，即傳輸完畢后再返回，False 為異步執(zhí)行，即驗證完輸入參數正確性后就返回，自動執(zhí)行任務。返回值：String 類型，返回調用傳輸后的結果，以 Xml 形式體現，Ansi 編碼。 ExecuteTaskInStringW以 Xml 字的方式傳入參數執(zhí)行任務，Unicode 版本，由于內存占用的關系，字方式不能執(zhí)行大數據的任務函數：extern "C" wchar_t *_stdcall ExecuteTaskInStringW(const wchar_t *szTaskID,const wchar_t *szInput, bool bSynch)Pa

15、ge 10 / 95中間件服務接口開檔傳入參數：szTaskID: WideString 類型，傳入的任務編號（唯一），Ansi 編碼szInput: WideString 類型，傳入的 Xml 信息字明，Ansi 編碼，Xml 結構參見3 傳輸結構說bSynch：bool 類型，執(zhí)行方式，True 為同步執(zhí)行，即傳輸完畢后再返回，False 為異步執(zhí)行，即驗證完輸入參數正確性后就返回，自動執(zhí)行任務。返回值：WideString 類型，返回調用傳輸后的結果，以 Xml 形式體現，Unicode 編碼。 QueryTask指定的任務狀態(tài)，以 Xml 字的方式傳入參數，Ansi 版本

16、。函數：extern "C" char *_stdcall QueryTask(const char *szInput)傳入參數：szInput: String 類型，傳入的 Xml 信息字Ansi 編碼，Xml 結構參見3 傳輸結構說明，返回值：String 類型，返回指定的任務狀態(tài)，以 Xml 形式體現，如果是批量多個任務，只返回已經存在的任務的狀態(tài)，Ansi 編碼。 QueryTaskW指定的任務狀態(tài)，以 Xml 字的方式傳入參數，Unicode 版本。函數：extern "C" wchar_t *_stdcall QueryTask

17、W(const wchar_t *szInput)傳入參數：szInput: WideString 類型，傳入的 Xml 信息字明，Unicode 編碼，Xml 結構參見3 傳輸結構說返回值：WideString 類型，返回指定的任務狀態(tài)，以 Xml 形式體現，如果是批量多個任務，只返回已經存在的任務的狀態(tài)， Unicode 編碼。Page 11 / 95中間件服務接口開檔 CancelTask取消指定的任務，以字的方式傳入參數，Ansi 編碼。函數：extern "C" bool _stdcall CancelTask(const char *szInput

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

19、版本。函數：extern "C" char *_stdcall QueryStatus(const char *szInput)傳入參數：szInput: String 類型，傳入的 Xml 信息字Ansi 編碼。, Xml 結構參見3 傳輸結構說明，返回值：String 類型，返回指定組件的配置參數或者電子秤列表，以 Xml 形式體現，AnsiPage 12 / 95中間件服務接口開檔編碼。0 QueryStatusW中間件指定組件的配置參數，或電子秤列表，以字的方式傳入參數， Unicode版本。函數：extern "C" wchar_

20、t *_stdcall QueryStatusW(const wchar_t *szInput)傳入參數：szInput: WideString 類型，傳入的 Xml 信息字Unicode 編碼。, Xml 結構參見3 傳輸結構說明，返回值：WideString 類型，返回指定組件的配置參數或者電子秤列表，以 Xml 形式體現，Unicode 編碼。1 Free以上方法中返回的字，必須調用，否則會產生內存泄漏。函數：extern "C" void _stdcall Free(void *p)傳入參數：p: 指針類型，傳入的字指針。無返回值2 Re

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

22、任務編號，唯一標識，在任何情況下都不能重復TaskTime子節(jié)點String任務生成時間，時間格式為YYYY-MM-DDTHH:mm:ss，例如： 2014-06-09T09:12:12，其他所有日期時間的格式都與此相同TaskType子節(jié)點int任務類型：0：下發(fā)數據1：回收流水3：檢查狀態(tài)4:：自動發(fā)現設備87:會員卡組件的狀態(tài)89： 自動發(fā)現設備組件的狀態(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， 多個任務狀態(tài)中間件服務接口開檔Setting 結構：Xml 節(jié)點名：Setting附加配置信息包括如下信息：Page 15 / 95配置名稱配置說明取值范圍UseDept是否啟用部門管理，涉及到部分協議中部門號的拆分處理，對bMobile/bDrive 以及 bPlus 無效True False默認為 True，不區(qū)分大小寫Xml 節(jié)點名Xml 節(jié)點類型數據類型說明Name子節(jié)點String參數名。Value子節(jié)點String參數值。Scales子節(jié)點在以字方式調用時，存放電子秤列表，其中可包含多個 Scale 子節(jié)點98，單個任務狀態(tài)99：設置參數100

24、：停止進程DataFile子節(jié)點String以文件方式調用時， 對應電子秤列表文件名或設置參數文件名。OutputFile子節(jié)點String任務結果輸出文件名，在字方式調用時，可以用這個字段來指定輸出目錄。Scales子節(jié)點在以字方式調用時， 存放電子秤列表，其中可包含多個 Scale 子節(jié)點Settings子節(jié)點在以字 方式調用時， 存放設置參數列表，其中可包含多個 MTSetting 子節(jié)點AdditionalConfig子節(jié)點String附加的配置信息，單個配置信息結構為： Name:Value，多個配置信息以逗號分隔，字符與預定義的關鍵字，使用轉義。例如： UseDept:True,E

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

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

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

28、L00 中私有追溯碼索引為數字時 生效CheckOnlineTimeout檢測時的超時時間Ping 的 超 時 時間， 以毫秒為單位，默認 500msCheckOnlineRetryTimes檢測重試次數Ping 的 重 試 次數，默認 3CheckOnlineMaxThreads檢測同時檢測秤的數量默認為 20中間件服務接口開檔Xml 節(jié)點名：ScalePage 18 / 95Xml 節(jié)點名Xml 節(jié)點類型數據類型說明DeviceID子節(jié)點String設備號，唯一標識，當MTScaleKey 中設置以秤號為索引時，設備號等于秤號；當設置成以 IP 為索引時，設備號等于 IP 地址。Conne

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

30、o：bPro 類型的秤Apollo：Apollo 秤，同 bPro 類型bTwin：bTwin 類型的秤bHigh：bHigh 類型的秤i15：i15 類型的秤RL00：RL00/RL00+類型的秤bMobile：bMobile 類型的秤bDrive：bDrive 類型的秤Skipper 5000:Skipper 5000 類型，同 bMobile。Skipper 7000: Skipper 7000 類型，同 bDrivebPlus：bPlus 類型的秤FreshBase：FreshBase 類型的秤中間件服務接口開檔NetworkParams 結構（局域網連接參數，選填）：Xml 節(jié)點名：

31、NetworkParamsInternetParams 結構（廣域網連接參數，選填）：Xml 節(jié)點名：InternetParamsPage 19 / 95Xml 節(jié)點名Xml 節(jié)點類型數據類型說明Address屬性StringIP 地址。Port屬性int網絡端，默認 8001。Xml 節(jié)點名Xml 節(jié)點類型數據類型說明Address屬性StringIP 地址。Port屬性Int網絡端，默認 3001。Rider 5000：Rider 5000 秤，同FreshBase 類型Rider 8000：Rider 8000 秤，同FreshBase 類型Etica：Etica 類型的秤Unknown

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

33、ScaleList.xmlXml 文本示例：注：文件方式下，ScaleList 的根節(jié)點為 Devices3.3 命令字信息結構命令字列表結構中包含了對應的電子秤所要進行數據傳輸的指令集，其中令字信息結構如下：Xml 節(jié)點名：CommandPage 20 / 95Xml 節(jié)點名Xml 節(jié)點類型數據類型說明CommandID子節(jié)點String命令字編號，在每臺秤令列表中必須唯一。CommandText子節(jié)點String命令字，如 Item。Control子節(jié)點String命令字：Update：更新數據。Delete：刪除指定數據。DeleteAll：刪除全部數據。Read：當前數據。ReadAl

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

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

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

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

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

39、eResultCommandResult 結構：Xml 節(jié)點名：CommandResultPage 23 / 95Xml 節(jié)點名Xml 節(jié)點類型數據類型說明CommandID子節(jié)點String命令字編號。CommandText子節(jié)點String命令字。Control子節(jié)點String字。StartTime子節(jié)點String命令字任務開始時間。EndTime子節(jié)點String命令字任務結束時間、ReturnCode子節(jié)點String任務執(zhí)行的返回代碼。ErrorMessage子節(jié)點String錯誤信息。Succeeded子節(jié)點Int數。Failed子節(jié)點Int失敗數。Total子節(jié)點Int總數。

40、DataFile子節(jié)點String以文件方式調用時，存放數據文件Xml 節(jié)點名Xml 節(jié)點類型數據類型說明DeviceID子節(jié)點String設備號。ScaleNo子節(jié)點Int秤號。ScaleType子節(jié)點String秤類型。StartTime子節(jié)點String電子秤任務開始時間。EndTime子節(jié)點String電子秤任務結束時間、ReturnCode子節(jié)點String任務執(zhí)行的返回代碼。ErrorMessage子節(jié)點String錯誤信息。CommandResults子節(jié)點命令字結果信息，其中可包含多個CommandResult 子節(jié)點，與命令字信息一一對應OtherMessage子節(jié)點Stri

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

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

43、Waiting:等待執(zhí)行。Executing:正在執(zhí)行。Output:正在輸出數據。Complete:執(zhí)行完畢。Error:執(zhí)行錯誤。Prepare:準備執(zhí)行。中間件服務接口開檔3.5 數據內容信息結構數據內容信息中包含了對應的指令集所要進行數據傳輸的數據。以下的指令集并不是所有秤都支持，如果在實際操作中無法進行傳輸，即表明該秤類型不支持此指令集。3.5.1商品數據命令號：Item，支持字：o Update： 所有類型的秤ete： 所有類型的秤eteAll： 除 bTwin,bHigh,Etica 外所有秤o Read：除 Etica 外所有類型的秤o ReadAll：除 Etica 外所有類

44、型的秤Xml 節(jié)點名：ItemPage 25 / 95Xml 節(jié)點名Xml 節(jié)點類型數據類型說明PLU子節(jié)點Int商品號。DepartmentID子節(jié)點Int部門號，在 bMobile/bDrive 以及 bPlus 中為必填項，不填則默認為 0。AlternativeItemIDs子節(jié)點貨號列表，其中可包含多個AlternativeItemID 子節(jié)點，用以存放商品貨號。Descriptions子節(jié)點商品描述列表，其中可包含多個Description 子節(jié)點，用以存放商品名稱，附加文本信息等。中間件服務接口開檔Page 26 / 95Dates子節(jié)點日期標志，其中可包含多個 Date 子節(jié)點

45、，用以存放商品的日期打印信息。ItemGroupID子節(jié)點Int商品組號。只對 bMobile/bDrive以及 bPlus 有效CategoryIDs子節(jié)點商品分類列表，其中可包含多個CategoryID 子節(jié)點，用以存放商品的分類號。只對 bMobile、bDrive 以及 bPlus 有效Tares子節(jié)點商品皮重號列表，其中可包含多個 TareID 子節(jié)點以及TareWeight 子節(jié)點，用以存放商品的皮重號和皮重數據。ItemPrices子節(jié)點商品價格列表，其中可包含多個ItemPrice 子節(jié)點，用以存放商品的價格信息。Taxes子節(jié)點商品稅號列表，其中可包含多個TaxRuleID

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

47、子節(jié)點，用以存放商品的營養(yǎng)表號。只對bMobile/bDrive 以及bPlus有效FixedQuantity子節(jié)點商品固定重量，在一個 Item 結構中可以包含多個 FixedQuantity 節(jié)點。TraceInfoID子節(jié)點追溯信息號。中間件服務接口開檔AlternativeItemID 結構（貨號）：Xml 節(jié)點名：AlternativeItemIDDescription 結構（商品描述文本）：Xml 節(jié)點名：DescriptionPage 27 / 95Xml 節(jié)點名Xml 節(jié)點類型數據類型說明Type屬性String文本類型：ItemName：商品名稱ItemShortName：商

48、品第二名稱ExtraText：附加文本ShortPinYinCode：拼音簡稱ID屬性Int文 本 編 號 ， 當 文 本 類 型 為ExtraText 時，輸入附加文本號， 其他類型不填。Language屬性String文本語言： 只對 bMobile/bDrive以及 bPlus 有效zho：中文eng：英文 fra：法語 deu：德語其他所有 Language 節(jié)點均與此Xml 節(jié)點名Xml 節(jié)點類型數據類型說明AlternativeItemID文本String貨號，最長 13 位TraceabilityFlag子節(jié)點追溯碼啟用標志，此標志對于bPlus，bMobile/bDrive 秤

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