中间件接口mtsca开发对外发布

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任务执行结果信息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电子秤状态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常规数据库结构5明细表结构57非现金支付表结构59小计表结构606会员支付功能说明626.1逻辑视图626.2接口实现方式626.2.1动态库接口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下发商品数据891.2下发预置键911.3参数设置931.4回收流水数据95Page 5 / 95中间件服务接口开档1 文档介绍1.1 文档目的与范围此文档包含了 MTScaleKey 的接口说明。MTScaleKey 是目前 Mettler Toledo商衡电子秤的数据传输服务，

5、只要遵循接口说明， 用户可以在开发中与MTScaleKey 进行通讯，完成对电子秤数据的下发和回收。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 生成任务信息，包含任务的类型，下达任务的时间，执行任务的电子秤列表编号，具体任务信息结构参见3.1 任务信息结构l 生成电子秤列表信息，包含要执行任务的电子秤信息，具体电子秤信息结构参见3.2 电子秤信息结构，如果是参数设置，那么生成参数列表信息，具体的参数信息结构参见3.6 参数设置信息结构，下面的步骤可以跳过。每台秤生成一个命令字信息，包含这台秤要进行通讯令，具体命令字l结构参见3.3 命令字信息结构每个命令字生成要通讯的数据内容，例如要下发商

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以文件方式传入参数执行任务，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 类型，执行方式，True 为同步执行，即传输完毕后再返回，False 为异步执行，即验证完输入参数正确性后就返回，自动执行任务。返回值：bool 类型，返回调用是否。 ExecuteTaskInFileW以文件方式传入参数执行任务，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 类型，执行方式，True 为同步执行，即传输完毕后再返回，False 为异步执行，即验证完输入参数正确性后就返回，自动执行任务。返回值：bool 类型，返回调用是否。 Execute

13、TaskInString以 Xml 字的方式传入参数执行任务，Ansi 版本，由于内存占用的关系，字方式不能执行大数据的任务函数：extern "C" char *_stdcall ExecuteTaskInString(const char *szTaskID, const char*szInput, bool bSynch)传入参数：szTaskID: String 类型，传入的任务编号（唯一），Ansi 编码szInput: String 类型，传入的 Xml 信息字Ansi 编码，Xml 结构参见3 传输结构说明，bSynch：bool 类型，执行方式，True 为

14、同步执行，即传输完毕后再返回，False 为异步执行，即验证完输入参数正确性后就返回，自动执行任务。返回值：String 类型，返回调用传输后的结果，以 Xml 形式体现，Ansi 编码。 ExecuteTaskInStringW以 Xml 字的方式传入参数执行任务，Unicode 版本，由于内存占用的关系，字方式不能执行大数据的任务函数：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 类型，执行方式，True 为同步执行，即传输完毕后再返回，False 为异步执行，即验证完输入参数正确性后就返回，自动执行任务。返回值：WideString 类型，返回调用传输后的结果，以 Xml 形式体现，Unicode 编码。 QueryTask指定的任务状态，以 Xml 字的方式传入参数，Ansi 版本

16、。函数：extern "C" char *_stdcall QueryTask(const char *szInput)传入参数：szInput: String 类型，传入的 Xml 信息字Ansi 编码，Xml 结构参见3 传输结构说明，返回值：String 类型，返回指定的任务状态，以 Xml 形式体现，如果是批量多个任务，只返回已经存在的任务的状态，Ansi 编码。 QueryTaskW指定的任务状态，以 Xml 字的方式传入参数，Unicode 版本。函数：extern "C" wchar_t *_stdcall QueryTask

17、W(const wchar_t *szInput)传入参数：szInput: WideString 类型，传入的 Xml 信息字明，Unicode 编码，Xml 结构参见3 传输结构说返回值：WideString 类型，返回指定的任务状态，以 Xml 形式体现，如果是批量多个任务，只返回已经存在的任务的状态， 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动态库，动态调用动态库时，必须在卸载动态库之前调用此方法，直接卸载动态库会导致错误。函数：extern "C" void _stdcall Release()无传入参数Page 13 / 95中间件服务接口开档无返回值3 数据传输结构说明3.1 任务信息结构任务信息结构中包含了要执行的任务信息，其中的任务信息结构如下（属性名中红色部分为必填信息，部分为在选定情况下必填信息，其他可不填，下同）：Xml 节点名：MTTaskPage 14 / 95Xml 节点名Xml 节点类型数据类型说明Version属性StringXml 格式的版本号TaskID子节点String

22、任务编号，唯一标识，在任何情况下都不能重复TaskTime子节点String任务生成时间，时间格式为YYYY-MM-DDTHH:mm:ss，例如： 2014-06-09T09:12:12，其他所有日期时间的格式都与此相同TaskType子节点int任务类型：0：下发数据1：回收流水3：检查状态4:：自动发现设备87:会员卡组件的状态89： 自动发现设备组件的状态90： WANService 组件的状态91： RetrieveData 组件的状态92： TransferData 组件的状态93： ReceiveTrade 组件的状态94： CheckOnline 组件的状态95： 电子秤列表96

23、： MTScaleKey 状态97， 多个任务状态中间件服务接口开档Setting 结构：Xml 节点名：Setting附加配置信息包括如下信息：Page 15 / 95配置名称配置说明取值范围UseDept是否启用部门管理，涉及到部分协议中部门号的拆分处理，对bMobile/bDrive 以及 bPlus 无效True False默认为 True，不区分大小写Xml 节点名Xml 节点类型数据类型说明Name子节点String参数名。Value子节点String参数值。Scales子节点在以字方式调用时，存放电子秤列表，其中可包含多个 Scale 子节点98，单个任务状态99：设置参数100

24、：停止进程DataFile子节点String以文件方式调用时， 对应电子秤列表文件名或设置参数文件名。OutputFile子节点String任务结果输出文件名，在字方式调用时，可以用这个字段来指定输出目录。Scales子节点在以字方式调用时， 存放电子秤列表，其中可包含多个 Scale 子节点Settings子节点在以字 方式调用时， 存放设置参数列表，其中可包含多个 MTSetting 子节点AdditionalConfig子节点String附加的配置信息，单个配置信息结构为： Name:Value，多个配置信息以逗号分隔，字符与预定义的关键字，使用转义。例如： UseDept:True,E

25、TLinkPLU:False 表示使用部门管理，ET 与 PLU 不同号中间件服务接口开档Page 16 / 95Password秤通讯，只对bCom/bPro， bMobile/bDrive 以及 bPlus 有效秤通讯ETLinkPLUPlu 和 ET 是否同号的设置True False默认为 False，不区分大小写ETMethod表示 ET 处理方式（仅支持bCom/bPro）：0：不分片，1：分片处理默认为 0TraceIndexType表示追溯码索引格 式 （ 仅 支 持bCom/bPro ， RL00）0：字，1：数字默认为 0FixWeightUsage表示秤内固定重量字段的用

26、途（仅支持bCom/bPro ，RL00）：0：固定重量，1：计数商品默认为 0UpdateItemTID表示下发私有类追溯码时是否需要更新商品信息中的TraceInfoIDTrue False默认为 True，不区分大小写AutoFitScaleType自动适配秤类型数据下发True False默认为 True，不区分大小写，不支持 i15，bTwin， bHighTraceIndexFormat追溯码助记符格式字格式，默认为 PPPPPPPPPTCheckOnlineMethod检测方式选择0：Ping 和连接端口测试1：只做 Ping默认为 0中间件服务接口开档Setting 中涉及到的

27、配置参数的字段名称参见附录 1Task.xmlXml 文本示例：文件方式：TaskString.xml字方式（以下发商品数据为例）：3.2 电子秤信息结构电子秤列表结构中包含了要进行数据传输的电子秤列表，其中的电子秤信息结构如下：Page 17 / 95AutoEnterBoot刷秤时自动进入刷秤模式True False默认为 True,不区分大小写，只支持bCom，bProTraceTextLength追溯码长度数字，表示追溯码文本的长度，默认为 20，仅在 RL00 中私有追溯码索引为数字时生效TraceDescLength追溯码描述长度数字，表示追溯码描述文本的长度， 默认为 4，仅在R

28、L00 中私有追溯码索引为数字时 生效CheckOnlineTimeout检测时的超时时间Ping 的 超 时 时间， 以毫秒为单位，默认 500msCheckOnlineRetryTimes检测重试次数Ping 的 重 试 次数，默认 3CheckOnlineMaxThreads检测同时检测秤的数量默认为 20中间件服务接口开档Xml 节点名：ScalePage 18 / 95Xml 节点名Xml 节点类型数据类型说明DeviceID子节点String设备号，唯一标识，当MTScaleKey 中设置以秤号为索引时，设备号等于秤号；当设置成以 IP 为索引时，设备号等于 IP 地址。Conne

29、ctType子节点String通讯类型： Network：局域网Internet：广域网ScaleNoint秤号。ScaleName子节点String秤名称。CWANID子节点String广域网客户号。LocalStoreID子节点String门店号。ConnectParams子节点其中包含 NetworkParams（局域网参数）以及 InternetParams（广域网参数）两个子节点用于设置电子秤的连接参数，两种方式必须至少填一种ScaleType子节点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 节点名：

31、NetworkParamsInternetParams 结构（广域网连接参数，选填）：Xml 节点名：InternetParamsPage 19 / 95Xml 节点名Xml 节点类型数据类型说明Address属性StringIP 地址。Port属性int网络端，默认 8001。Xml 节点名Xml 节点类型数据类型说明Address属性StringIP 地址。Port属性Int网络端，默认 3001。Rider 5000：Rider 5000 秤，同FreshBase 类型Rider 8000：Rider 8000 秤，同FreshBase 类型Etica：Etica 类型的秤Unknown

32、： 未知秤类型， 仅用于自动发现时无法确定秤类型使用。其他所有 ScaleType 节点都与此相同CODName子节点StringCOD 号，标准版本下可不填。DecimalDigits子节点int小数点位数，与秤内设置的小数点位数一致，用于金额的计算，国内一般设置为 2。DataFile子节点String以文件方式调用时，存放命令字文件名Commands子节点以字方式调用时，存放命令字信息，其中可包含多个 Command 子节点AdditionalConfig子节点String附加的配置信息，与任务信息中的结构相同，如果定义的配置信息与任务信息中的重复，则电子秤信息中的为准中间件服务接口开档

33、ScaleList.xmlXml 文本示例：注：文件方式下，ScaleList 的根节点为 Devices3.3 命令字信息结构命令字列表结构中包含了对应的电子秤所要进行数据传输的指令集，其中令字信息结构如下：Xml 节点名：CommandPage 20 / 95Xml 节点名Xml 节点类型数据类型说明CommandID子节点String命令字编号，在每台秤令列表中必须唯一。CommandText子节点String命令字，如 Item。Control子节点String命令字：Update：更新数据。Delete：删除指定数据。DeleteAll：删除全部数据。Read：当前数据。ReadAl

34、l：所有数据。其他所有 Control 节点均与此相同。ClearData子节点bool标志下发前是否清空数据，即是否先把秤内对应数据清空后再下发，仅在命令字为 Write 或 Update 时有效DataFile子节点String以文件方式调用时，存放命令字数据文件名。Data子节点以字方式调用时，存放数据内容， 其中可包含多个数据节点AdditionalConfig子节点String附加的配置信息，与任务信息中的结构相同，如果定义的配置信息与任务信息或电子秤信息中的重复，则以命令字信息中的为准中间件服务接口开档Commands.xmlXml 文本示例：3.4 任务执行结果信息任务执行结果信

35、息结果包含了任务执行的状态或结果信息：Xml节点名：MTTaskResultPage 21 / 95Xml 节点名Xml 节点类型数据类型说明TaskID子节点String任务编号。TaskType子节点Int任务类型。StartTime子节点String任务开始时间。EndTime子节点String任务结束时间。ProcessPercent子节点Int任务执行的进度百分比。ReturnCode子节点String任务执行的返回代码： 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 节点均与此相同，今后根据需要会有新增TaskStatus子节点String任务状态：Waiting:等待执行。Executing:正在执行。Output:正在输出数据。Complete:执行完毕。Erro

38、r:执行错误。Prepare:准备执行。ErrorMessage子节点String错误信息。OtherMessage子节点String其他信息。OutputFile子节点String任务结果输出文件名。SettingResults子节点存放 状态或设置参数的结果， 其中可包含多个 SettingResult 子节点，与每一个设置项一一对应ScaleResults子节点存放电子秤任务的结果，其中可包含多个 ScaleResult 子节点，与每台秤任务一一对应Scales子节点在做自动发现任务时，返回自动发现的电子秤列表，其中可包含多个Scale 子节点。中间件服务接口开档Xml 节点名：Scal

39、eResultCommandResult 结构：Xml 节点名：CommandResultPage 23 / 95Xml 节点名Xml 节点类型数据类型说明CommandID子节点String命令字编号。CommandText子节点String命令字。Control子节点String字。StartTime子节点String命令字任务开始时间。EndTime子节点String命令字任务结束时间、ReturnCode子节点String任务执行的返回代码。ErrorMessage子节点String错误信息。Succeeded子节点Int数。Failed子节点Int失败数。Total子节点Int总数。

40、DataFile子节点String以文件方式调用时，存放数据文件Xml 节点名Xml 节点类型数据类型说明DeviceID子节点String设备号。ScaleNo子节点Int秤号。ScaleType子节点String秤类型。StartTime子节点String电子秤任务开始时间。EndTime子节点String电子秤任务结束时间、ReturnCode子节点String任务执行的返回代码。ErrorMessage子节点String错误信息。CommandResults子节点命令字结果信息，其中可包含多个CommandResult 子节点，与命令字信息一一对应OtherMessage子节点Stri

41、ng其他信息。ProcessPercent子节点Int电子秤任务执行的百分比TaskStatus子节点String任务状态： Waiting:等待执行。Executing:正在执行。Output:正在输出数据。Complete:执行完毕。Error:执行错误。Prepare:准备执行。中间件服务接口开档SettingResult 结构：Xml 节点名：SettingResultTaskResult.xmlXml 文本示例：文件方式：TaskResultString. xml字方式（以状态为例）：Page 24 / 95Xml 节点名Xml 节点类型数据类型说明Name子节点String设置项名

42、称。Value子节点String设置项的值。ReturnCode子节点String任务执行的返回代码。ErrorMessage子节点String错误信息。Succeeded子节点Int数。Failed子节点Int失败数。Total子节点Int总数。Scales子节点存放的电子秤列表，其中可包含多个 Scale 子节点名。Data子节点以字方式调用时，存放数据内容，其中可包含多个数据节点OtherMessage子节点String其他信息。ProcessPercent子节点Int命令字通讯时的百分比，在下件以及固件信息时使用此字段可以知道具体进度。TaskStatus子节点String任务状态：

43、Waiting:等待执行。Executing:正在执行。Output:正在输出数据。Complete:执行完毕。Error:执行错误。Prepare:准备执行。中间件服务接口开档3.5 数据内容信息结构数据内容信息中包含了对应的指令集所要进行数据传输的数据。以下的指令集并不是所有秤都支持，如果在实际操作中无法进行传输，即表明该秤类型不支持此指令集。3.5.1商品数据命令号：Item，支持字：o Update： 所有类型的秤ete： 所有类型的秤eteAll： 除 bTwin,bHigh,Etica 外所有秤o Read：除 Etica 外所有类型的秤o ReadAll：除 Etica 外所有类

44、型的秤Xml 节点名：ItemPage 25 / 95Xml 节点名Xml 节点类型数据类型说明PLU子节点Int商品号。DepartmentID子节点Int部门号，在 bMobile/bDrive 以及 bPlus 中为必填项，不填则默认为 0。AlternativeItemIDs子节点货号列表，其中可包含多个AlternativeItemID 子节点，用以存放商品货号。Descriptions子节点商品描述列表，其中可包含多个Description 子节点，用以存放商品名称，附加文本信息等。中间件服务接口开档Page 26 / 95Dates子节点日期标志，其中可包含多个 Date 子节点

45、，用以存放商品的日期打印信息。ItemGroupID子节点Int商品组号。只对 bMobile/bDrive以及 bPlus 有效CategoryIDs子节点商品分类列表，其中可包含多个CategoryID 子节点，用以存放商品的分类号。只对 bMobile、bDrive 以及 bPlus 有效Tares子节点商品皮重号列表，其中可包含多个 TareID 子节点以及TareWeight 子节点，用以存放商品的皮重号和皮重数据。ItemPrices子节点商品价格列表，其中可包含多个ItemPrice 子节点，用以存放商品的价格信息。Taxes子节点商品税号列表，其中可包含多个TaxRuleID

46、子节点，用以存放商品的税号。Ingredients子节点商品成分列表，其中可包含多个IngredientID 子节点，用以存放商品的成分表号。只对 bMobile、bDrive 以及 bPlus 有效LabelFormats子节点商品号列表，其中可包含多个 LabelFormatID 子节点，用以存放商品的号。Barcodes子节点商品条码号列表，其中可包含多个 BarcodeID 子节点，用以存放商品的条码号。只对 bMobile、bDrive 以及 bPlus 有效NutritionInformation子节点商品营养表号列表，其中可包含多个 NutritionInformationID

47、子节点，用以存放商品的营养表号。只对bMobile/bDrive 以及bPlus有效FixedQuantity子节点商品固定重量，在一个 Item 结构中可以包含多个 FixedQuantity 节点。TraceInfoID子节点追溯信息号。中间件服务接口开档AlternativeItemID 结构（货号）：Xml 节点名：AlternativeItemIDDescription 结构（商品描述文本）：Xml 节点名：DescriptionPage 27 / 95Xml 节点名Xml 节点类型数据类型说明Type属性String文本类型：ItemName：商品名称ItemShortName：商

48、品第二名称ExtraText：附加文本ShortPinYinCode：拼音简称ID属性Int文 本 编 号 ， 当 文 本 类 型 为ExtraText 时，输入附加文本号， 其他类型不填。Language属性String文本语言： 只对 bMobile/bDrive以及 bPlus 有效zho：中文eng：英文 fra：法语 deu：德语其他所有 Language 节点均与此Xml 节点名Xml 节点类型数据类型说明AlternativeItemID文本String货号，最长 13 位TraceabilityFlag子节点追溯码启用标志，此标志对于bPlus，bMobile/bDrive 秤

49、不生效。PriceRule子节点Int单价规则号，对于 bPlus， bMobile/bDrive 不生效。Images子节点图片号列表，其中可包含多个Image 子节点，用以存放商品的图片号。只对 bCom/bPro， bMobile/bDrive 以及bPlus 有效StaggerPrices子节点阶梯价列表， 其中可包含多个StaggerPrice 子节点，用以存放商品的阶梯价格。只对 bMobile、bDrive、bPlus、FreshBase 有效中间件服务接口开档Date 结构（日期打印标志）：Xml 节点名：DateoffsetCategoryID 结构（分类号）：Page 28 / 95Xml 节点名Xml 节点类型数据类型说明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 有