您当前的位置:首页 > 兽药二维码追溯 > 资料下载
国家兽药产品追溯系统数据采集设备接口标准(据农业部公告 第2210号)
发布时间:2015-01-27
来源:中国兽医药品监察所
打印

   国家兽药产品追溯系统数据采集设备接口标准

  1范围 

  本标准规定了数据采集设备和追溯系统平台间的接口标准。 

  本标准适用于数据采集设备和追溯系统平台间的信息交互,供各类数据采集设备的厂商使用。 

  2. 概述 

  本标准根据兽药行业信息化建设的需要,围绕兽药产品从出厂到使用全程兽药产品追溯,规范了国家兽药产品追溯系统所涉及的数据采集设备接口标准。 

  本标准的第3章给出了数据采集设备和追溯系统平台服务端接口的通信方式;第4章具体给出了接口的描述和定义,函数名称,入口和出口参数描述。 

  3. 通信方式 

  数据采集设备和追溯系统平台服务端接口遵循webservice协议,采用标准的webservice协议定义描述双方调用的服务函数的入口参数和出口参数,双方均按照wsdl相关协议解析信息,服务地址及名称如下形式 http://ip(或域名):端口/服务,采用一个服务,多个函数的方式提供给数据采集设备调用。例如:http://222.35.47.104:8081/SyZs/SyzsWsPort?wsdl 

  4. 接口描述和定义 

  4.1获取用户信息 

  获取用户信息的函数名称:  

  SysUserOfWs getUserInfo(Char  userid,Char  userpwd); 

  入口参数描述: 

字段名 

约束 

类型 

最大长度 

说明 

userid 

必填 

Char 

30 

用户ID 

userpwd 

必填 

Char 

30 

用户密码 

  出口参数描述(返回的SysUserOfWs类的属性描述): 

字段名 

约束 

类型 

最大长度 

说明 

curdate 

必填 

Char 

20 

服务器时间,样式为:YYYY/MM/DD HH:MM:SS 

rolename 

  

Char 

50 

角色 

unit 

  

Char 

32 

所属单位ID 

unitname 

  

Char 

200 

所属单位名称 

unittype 

  

Char 

2 

单位类型,‘00-监管单位;‘01-生产企业;‘02-经营企业;‘03-使用者 

userid 

必填 

Char 

30 

用户ID 

username 

 

Char 

50 

用户名 

userpwd 

必填 

Char 

30 

用户密码 

  4.2修改用户信息 

  修改用户信息是指修改当前登录用户的密码和用户名信息; 

  函数名称为: 

  Char updateUserInfo(Char userid,Char userOldPwd,Char  userNewPwd,Char  username); 

  入口参数描述: 

字段名 

约束 

类型 

最大长度 

说明 

userid 

必填 

Char 

30 

用户ID 

userOldPwd 

必填 

Char 

30 

用户旧密码 

userNewPwd 

必填 

Char 

30 

用户新密码 

username 

必填 

Char 

50 

用户名 

  出口参数描述: 

字段名 

约束 

类型 

最大长度 

说明 

  

  

Char 

  

success”表示修改信息成功,否则为失败原因 

    

   

  4.3获取兽药生产企业信息 

  获取兽药生产企业信息是指取得审核通过的兽药生产企业信息数组; 

  函数名称: 

  Qyxx[] getSyscqys (); 

  入口参数描述:无 

  出口参数描述(返回的数组元素Qyxx类的属性描述): 

字段名 

约束 

类型 

最大长度 

说明 

itemid 

  

Char 

32 

企业ID 

qydm 

  

Char 

50 

企业代码 

qyqc 

  

Char 

200 

企业全称 

qyzcdz 

  

Char 

200 

注册地址 

regionname 

  

Char 

100 

所在地 

scfw 

  

Char 

600 

生产范围 

    

  4.4获取企业的兽药产品信息 

  获取企业的兽药产品信息是指获取生产企业的兽药产品数组,按生产企业排序; 

  函数名称为: 

  Sycpxx[] getSycps (Char  qyids); 

  入口参数描述: 

字段名 

约束 

类型 

最大长度 

说明 

qyids 

必填 

Char 

  

企业ID,如果是多个企业,之间用半角逗号分隔 

  出口参数描述(返回的数组元素Sycpxx类的属性描述): 

字段名 

约束 

类型 

最大长度 

说明 

gg 

  

Char 

200 

规格 

itemid 

  

Char 

32 

药品ID 

pzrq 

  

Char 

20 

批准文号的批准日期,样式为:YYYY/MI/DD 

pzwh 

  

Char 

30 

批准文号 

qyid 

  

Char 

32 

企业ID 

qyname 

  

Char 

200 

企业名称 

spm 

  

Char 

200 

商品名 

tym 

  

Char 

200 

通用名 

    

  4.5获取追溯码信息 

  获取追溯码信息是指获取扫描的追溯码的贴码产品信息; 

  函数名称: 

  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 HHMMSS 

jxname 

  

Char 

100 

剂型 

minpackunit 

  

Char 

30 

最小包装单位 

mintagunit 

  

Char 

30 

最小贴码单位 

ph 

  

Char 

60 

批号 

pzwh 

  

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 

单位ID 

qylx 

  

Char 

2 

企业类型,02-经营企业;03-使用者 

qyqc 

  

Char 

200 

企业名称 

regioncode 

  

Char 

20 

所属行政区划编码 

regionname 

  

Char 

100 

所属行政区划名称 

  追溯附件3.doc     

《国家兽药产品追溯系统数据采集设备接口标准》.doc