食品安全控件JS调用接口标准

合集下载

1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。

肉类蔬菜流通追溯体系控件JS调用规范
版本号:1.0.4
2011-10-07
维护记录
版本号更改条款及内容更改人更改日期
2011-06-05 1.0.1 建立初始版本。

孙冬祎、
高晓光
孙冬祎2011-08-13 1.0.2修改功能代码1106增加机构ID入参
修改功能代码1107 增加机构ID 入参
修改功能代码1108 增加机构ID 入参
修改功能代码1110 增加机构ID 入参
修改功能代码1202 增加机构ID 入参
修改功能代码1203 增加机构ID 入参
修改功能代码1213 增加机构ID 入参
新增功能代码1207增加各个市场分秤发
送电子秤追溯信息
新增功能代码 1113 超市大卖场写团体消
费单位的肉菜流通服务卡
修改功能代码1213 增加分秤分送写追溯
标识的功能
修改功能代码1110 增加超市大卖场写卡
标识
修改功能代码1202 增加超市大卖场电子
秤的PLU信息发送
修改功能代码 1203 增加超市大卖场发送
追溯信息的功能
1.0.3 相关IC卡读卡器的调用,增加了读卡器类
孙冬祎2011-09-04 型的选择,新增TX_500B型号,主要用于屠
宰一体机读卡和写卡
修改功能代码1101,1103,1104,1106 增加
了Tx500B读卡器的支持
增加了配置文件和日志文件的说明，另外
配置文件名称进行了更改
wxsafefood.client
增加友声地磅秤台秤重功能，功能代码为
1114、1115、1116
孙冬祎2011-09-09 1.0.4 新增读卡器类型 T8系列，主要用于宁波
市IC卡的读写,所以相关卡的功能均已增
加
1.0.4 增加了1213功能，支持农贸市场分秤发送
孙冬祎2011-09-22 后的更改标识功能
修正了接口1112，1109，支持了对T8读
卡器的支持
新增了新版托利多Btwin秤的接口共有8
个功能接口
1.0.4 对三种读卡器，支持循环写交易记录，防孙冬祎2011-09-25
止零售端不清卡的报错情况
孙冬祎2011-09-27 1.0.4 增加了1117功能,提供猪肉备案中心查验
备案写卡功能
孙冬祎2011-10-07 1.0.4 新增了香山电子秤的接口共有17个功能
接口
目录
1 控件注册说明 (1)
2 调用方式 (1)
3 参数类型说明 (3)
4 接口函数调用说明 (5)
4.1 (207)取得台秤重量（原有保留） (5)
4.2 (212)从回复文件中取得IP返回清单（原有保留） (5)
4.3 (241)设置本地公共参数（原有保留） (5)
4.4 (242)返回本地公共参数（原有保留） (6)
4.5 (243)返回本地打印机列表（原有保留） (6)
4.6 (1100)单独将卡号及商户信息写入肉菜流通服务卡 (7)
4.7 (1101)从肉菜流通服务卡读取经营主体备案号 (7)
4.8 (1102)初次发放肉菜流通服务卡 (7)
4.9 (1103)从肉菜流通服务卡上读取经营主体完整备案信息 (8)
4.10 (1104)从肉菜流通服务卡上读取交易明细记录 (8)
4.11 (1105)清除肉菜流通服务卡上的交易明细记录 (9)
4.12 (1106)根据屠宰成交单号将交易数据写入肉菜流通服务卡 (9)
4.13 (1107)根据猪肉批发市场成交单号将交易数据写肉菜流通服务卡 (10)
4.14 (1108)根据猪肉批发市场摊主对外成交单号将交易数据写入服务卡 (11)
4.15 (1109)恢复肉菜流通服务卡密码 (11)
4.16 (1110)更改交易明细已写卡标识 (12)
4.17 (1111)读取屠宰厂RFID设备信息 (12)
4.18 (1112)初始化S70卡（本地初始化） (12)
4.19 (1113)根据超市大卖场交易单号将交易写入团体消费单位服务卡 (13)
4.20 (1114)读取友声台称称重数据 (13)
4.21 (1115)友声台称称重相关命令 (14)
4.22 (1116)友声台称预设皮重重量 (14)
4.23 (1117)根据猪肉备案单号将备案数据写入肉菜流通服务卡 (14)
4.24 (1201)溯源型电子秤参数设置 (15)
4.25 (1202)向溯源型电子秤发送PLU信息 (15)
4.26 (1203)向溯源型电子秤发送追溯信息 (16)
4.27 (1204)接收溯源型电子秤销售信息（已由李的程序实现） (16)
4.28 (1205)清除溯源型电子秤PLU设置信息 (17)
4.29 (1206)清除溯源型追溯信息 (17)
4.30 (1207)向溯源型电子秤分秤发送追溯信息 (18)
4.31 (1211)清除电子秤销售数据（已由李的程序实现） (18)
4.32 (1231)交易成交打印单据(暂不用实现) (18)
4.33 (1213)更改电子秤发送追溯信息标识 (19)
4.34 (1214)发送产地信息 (19)
4.35 (1215)删除产地信息 (20)
5 错误返回说明 (21)
6 配置文件说明 (22)
6.1 控件系统配置文件 (22)
6.2 友声台秤配置文件 (22)
7 日志文件说明 (24)
1控件注册说明
在WEB页面中首先需要注册，具体标签定义如下：
<OBJECT WIDTH=0 HEIGHT=0
classid="clsid:CC5F2644-4421-4945-A88E-51512A4D22FF"
id="WXSafeFood">
</OBJECT>
2调用方式
通过JS语言调用注册的控件，实现与后台中间件通信服务器及相关硬件设备交互和通讯。

例子如下：
function tran_setpubparm() --定义的JS调用函数名称
{
var sin,retcode,rettext,sret --声明变量
sin='ICREADER|comport|0|' --准备入参采用’|’对多个入参进行分隔
sret=WXSafeFood.ExecTran(241,sin); --调用控件提供的功能函数 241为功能代码 sin为入参
retcode=getToken(sret,1,'|'); --取得功能函数返回值代码 rettext=getToken(sret,2,'|'); --取得功能函数返回文本
alert(sret); --调试时采用对话框将返回内容显示
if (retcode!='0'){ --如果返回值代码不为零则不成功返回显示文本
alert('代码(' + retcode + '):' + rettext); --通过对话框显示返回代码和返回文本
return;
}
sret=getToken(sret,3,'|'); --正常调用取得函数返回的实际内容，采用分隔符取得多个出参内容
sbinfo.value=sret;
}
3参数类型说明
序号参数名称参数代码参数值
1 串口号0-4 串口1至串口5 当读卡器类型为
2 T8型号时，串口号100代表USB
接口
2 波特率
9600 38400 115200
3 电子秤类型0 大华(旧款)收银秤
1 托利多(BTWIN升级版)收银秤
2 顶尖老款收银秤
3 友声(新款)追溯收银秤
4 香山追溯收银秤
4 市场类型1 肉品批发市场
2 农贸市场
3 超市大卖场
5
市场成交类
型1 肉品批发市场一批成交
2 农贸市场进场登记
3 屠宰加工企业出厂成交
4 肉品批发市场二批成交(摊主对
外)
5 超市大卖场进场登记(分秤)
6 超市大卖场团体消费
7 农贸市场进场登记(分秤)
8 猪肉查验备案
6
台秤计量单
位0 克(g)
1 公斤(kg)
2 吨(ton)
7
台秤称重类
型0 毛重
1 净重
2 皮重
8
台秤称重命
令类型0 置零
1 去皮
2 复皮
4接口函数调用说明
4.1 (207)取得台秤重量（原有保留）
功能代码207
功能说明通过串口取得台秤的重量。

适用场合肉品批发市场使用台秤秤重。

适用场合各种与溯源型电子秤通讯的场合。

适用场合各种需要保存配置信息的场合。

适用场合各种需要读取配置信息的场合。

适用场合打印单据时选择指定的打印机。

入参无
出参返回值|返回文本|打印机数量#打印名称1#打印机名称2#|
4.6 (1100)单独将卡号及商户信息写入肉菜流通服务卡
功能代码1100
功能说明直接从肉菜流通服务卡中读取经营主体备案号，IC卡中的存储格式符合商务部规范。

适用场合用于单独读取卡中的经营主体备案号，用于简单判断或使用经营主体备案号进行进一步的处理。

适用场合用于单独读取卡中的经营主体备案号，用于简单判断或使用经营主体备案号进行进一步的处理。

在发卡过程中，会更改服
务卡的授权密码。

适用场合用于各流通节点对于经营主体的注册，使经营主体同流通节点建立关联。

适用场合用于各流通节点对于持卡经营户进场登记信息的读取。

适用场合用于各流通节点对于持卡经营户进场登记信息的读取完成后，置空处理。

入参串口号|波特率|
出参返回值|返回文本|
4.12 (1106)根据屠宰成交单号将交易数据写入肉菜流通服务卡功能代码1106
功能说明将屠宰厂交易成交信息写入肉菜流通服务卡中。

支持一次写多张卡的功能
此处开始的明细记录序号与成交单号将传到后台取得上次没
有写完的成交记录起始记录序号。

适用场合用于屠宰厂出厂结算环节。

支持一次写多张卡的功能。

支持一次写多张卡的功能（同1106
功能说明）
适用场合用于猪肉批发市场一批结算环节。

支持一次写多张卡的功能。

支持一次写多张卡的功能
（同1106功能说明）
适用场合用于猪肉批发市场经营摊主对外批发结算环节。

用于使用追溯秤含读卡器的经营摊主向团体消费单位写肉菜流通服务卡。

适用场合用于将旧卡恢复为再次发卡的状态。

入参串口号|波特率|
出参返回值|返回文本|
4.16 (1110)更改交易明细已写卡标识
功能代码1110
功能说明更改各种交易场合的交易单据已写卡的标记。

适用场合用于交易时标识写卡状态。

在发卡过程中，会更改服务卡的授权密码。

支持一次写多张卡的功能。

支持一次写多张卡的功能（同1106功能说
明）
适用场合用于超市大卖场向团体消费单位零售环节。

适用场合用于屠宰厂与一体机连接的台秤称重过程，屠宰厂批发环节。

适用场合用于屠宰厂与一体机连接的台秤称重过程，屠宰厂批发环节。

入参台秤编号|台秤称重命令类型|
出参返回值|返回文本|
4.22 (1116)友声台称预设皮重重量
功能代码1116
功能说明设置友声台称皮重。

适用场合用于屠宰厂与一体机连接的台秤称重过程，屠宰厂批发环节。

支持一次写多张卡的功能或循环写卡功能。

此处开始的明细记录序号与查验备案单号将传到后台取得上
次没有写完的成交记录起始记录序号。

适用场合用于猪肉备案中心猪查验备案登记环节。

适用场合初始化或设置溯源型电子秤配置时使用。

适用场合初始化或设置溯源型电子秤PLU信息。

适用场合批发市场、零售市场用于进场登记或成交结算环节，向溯源型电子秤发送追溯信息。

适用场合批发市场、零售市场采集溯源型电子秤销售记录。

适用场合溯源型电子秤PLU配置。

适用场合清除溯源型电子秤保存的追溯信息。

适用场合批发市场、零售市场用于进场登记或成交结算环节，向多台溯源型电子秤发送追溯信息。

适用场合清除溯源型电子秤保存的销售信息。

入参电子秤类型|IP地址1#IP地址2#|
出参返回值|返回文本|
4.32 (1231)交易成交打印单据(暂不用实现)
功能代码1231
功能说明打印交易成交单据。

适用场合成交结算打印单据。

入参市场成交类型|成交单号|
出参返回值|返回文本|
4.33 (1213)更改电子秤发送追溯信息标识
功能代码1213
功能说明更改各种进场登记或交易场合的单据已发送追溯信息的标记。

适用场合用于对单据标识追溯信息发送状态。

配置文件中的内容可以通过接口方法自行增加和删除，系统必须保留的参数(控件运行过程中自动获取)如下：
序号类别参数名称参数值备注
1
ICESERVER(应用服
务器) CONNTP 0 连接应用服务器的模式，
默认值为0 直接模式
1间接模式
2 HOST IP地址应用服务器的地址
3 PORT 端口号应用服务器侦听端口
4 ICREADER（读卡器）RdType 读卡器
类型0 明华系列 1 TX500B 2 T8
6.2 友声台秤配置文件
在调用友声台秤功能时会使用到配置文件，配置文件在系统目录下的
config.txt，如C:\WINDOWS\SYSTEM32\config.txt。

具体配置文件中的设置参数如下：
序号参数名称参数值(默认值) 备注
1 port 1 台秤使用串口1至串口4
2 retry 5 打开串口的重试次数
3 baud 38400 台秤使用的串口波特率
7日志文件说明
本控件在运行过程中会对错误的详细情况记录至系统目录下的wxSafeFood.log，如C:\WINDOWS\SYSTEM32\wxSafeFood.log，可以使用记录本打开日志文件，有助于分析问题原因。