1、1附件 3国家兽药产品追溯系统数据采集设备接口标准1. 范围本标准规定了数据采集设备和追溯系统平台间的接口标准。本标准适用于数据采集设备和追溯系统平台间的信息交互,供各类数据采集设备的厂商使用。2. 概述本标准根据兽药行业信息化建设的需要,围绕兽药产品从出厂到使用全程兽药产品追溯,规范了国家兽药产品追溯系统所涉及的数据采集设备接口标准。本标准的第3章给出了数据采集设备和追溯系统平台服务端接口的通信方式;第4章具体给出了接口的描述和定义,函数名称,入口和出口参数描述。3. 通信方式数据采集设备和追溯系统平台服务端接口遵循webservice协议,采用标准的webservice协议定义描述双方调用
2、的服务函数的入口参数和出口参数,双方均按照wsdl相关协议解析信息,服务地址及名称如下形式 http:/ip(或域名):端口/服务,采用一个服务,多个函数的方式提供给数据采集设备调用。例如:http:/222.35.47.104:8081/SyZs/SyzsWsPort?wsdl。4. 接口描述和定义4.1 获取用户信息获取用户信息的函数名称: SysUserOfWs getUserInfo(Char userid,Char userpwd);入口参数描述:字段名 约束 类型 最大长度 说明userid 必填 Char 30 用户 IDuserpwd 必填 Char 30 用户密码出口参数描述
3、(返回的 SysUserOfWs 类的属性描述):字段名 约束 类型 最大长度 说明curdate 必填 Char 20 服务器时间,样式为:YYYY/MM/DD HH:MM:SSrolename Char 50 角色2unit Char 32 所属单位 IDunitname Char 200 所属单位名称unittype Char 2 单位类型, 00-监管单位;01-生产企业;02-经营企业;03-使用者userid 必填 Char 30 用户 IDusername 必填 Char 50 用户名userpwd 必填 Char 30 用户密码4.2 修改用户信息修改用户信息是指修改当前登录用
4、户的密码和用户名信息;函数名称为:Char updateUserInfo(Char userid,Char userOldPwd,Char userNewPwd,Char username);入口参数描述:字段名 约束 类型 最大长度 说明userid 必填 Char 30 用户 IDuserOldPwd 必填 Char 30 用户旧密码userNewPwd 必填 Char 30 用户新密码username 必填 Char 50 用户名出口参数描述:字段名 约束 类型 最大长度 说明Char “success”表示修改信息成功,否则为失败原因34.3 获取兽药生产企业信息获取兽药生产企业信息是
5、指取得审核通过的兽药生产企业信息数组;函数名称:Qyxx getSyscqys ();入口参数描述:无出口参数描述(返回的数组元素 Qyxx 类的属性描述):字段名 约束 类型 最大长度 说明itemid Char 32 企业 IDqydm Char 50 企业代码qyqc Char 200 企业全称qyzcdz Char 200 注册地址regionname Char 100 所在地scfw Char 600 生产范围4.4 获取企业的兽药产品信息获取企业的兽药产品信息是指获取生产企业的兽药产品数组,按生产企业排序;函数名称为:Sycpxx getSycps (Char qyids);入口参
6、数描述:字段名 约束 类型 最大长度 说明qyids 必填 Char 企业 ID,如果是多个企业,之间用半角逗号分隔出口参数描述(返回的数组元素 Sycpxx 类的属性描述):字段名 约束 类型 最大长度 说明gg Char 200 规格itemid Char 32 药品 IDpzrq Char 20 批准文号的批准日期,样式为:YYYY/MI/DD4pzwh Char 30 批准文号qyid Char 32 企业 IDqyname Char 200 企业名称spm Char 200 商品名tym Char 200 通用名4.5 获取追溯码信息获取追溯码信息是指获取扫描的追溯码的贴码产品信息;
7、函数名称:Tmcpxx getZsmInfo (Char zsm);入口参数描述:字段名 约束 类型 最大长度 说明zsm 必填 Char 24 要查询的追溯码出口参数描述(返回的 Tmcpxx 类的属性描述):字段名 约束 类型 最大长度 说明chsf Char 200 收货单位cpname Char 200 产品名称spm Char 200 商品名cxcs int 码查询次数dyccxsj Char 20 第一次查询时间, 样式为:YYYY/MI/DD HH:MM:SSjxname Char 100 剂型minpackunit Char 30 最小包装单位mintagunit Char 3
8、0 最小贴码单位ph Char 60 批号5pzwh Char 30 批准文号qyname Char 200 生产企业scrq Char 20 生产日期specification Char 200 产品规格sxrq Char 20 失效日期tagratio Char 30 贴码包装比例tmjb int 贴码级别yplxname Char 100 药品类型4.6 获取出库企业的收货单位信息获取出库企业的收货单位信息是指获取出库企业的收货单位数组,按企业类型和企业全称排序;函数名称为:Shdwxx getShdws (Char userid);入口参数描述:字段名 约束 类型 最大长度 说明userid 必填 Char PDA 用户 ID 出口参数描述(返回的数组元素 Shdwxx 类的属性描述):字段名 约束 类型 最大长度 说明itemid Char 32 单位 IDqylx Char 2 企业类型,02-经营企业;03-使用者qyqc Char 200 企业名称regioncode Char 20 所属行政区划编码regionname Char 100 所属行政区划名称6