国家兽药产品追溯系统数据采集设备接口标准
1范围
本标准规定了数据采集设备和追溯系统平台间的接口标准。
本标准适用于数据采集设备和追溯系统平台间的信息交互,供各类数据采集设备的厂商使用。
本标准根据兽药行业信息化建设的需要,围绕兽药产品从出厂到使用全程兽药产品追溯,规范了国家兽药产品追溯系统所涉及的数据采集设备接口标准。
本标准的第3章给出了数据采集设备和追溯系统平台服务端接口的通信方式;第4章具体给出了接口的描述和定义,函数名称,入口和出口参数描述。
数据采集设备和追溯系统平台服务端接口遵循webservice协议,采用标准的webservice协议定义描述双方调用的服务函数的入口参数和出口参数,双方均按照wsdl相关协议解析信息,服务地址及名称如下形式 http://ip(或域名):端口/服务,采用一个服务,多个函数的方式提供给数据采集设备调用。例如:http://222.35.47.104:8081/SyZs/SyzsWsPort?wsdl。
获取用户信息的函数名称:
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 |
用户密码 |
修改用户信息是指修改当前登录用户的密码和用户名信息;
函数名称为:
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”表示修改信息成功,否则为失败原因 |
获取兽药生产企业信息是指取得审核通过的兽药生产企业信息数组;
函数名称:
Qyxx[] getSyscqys ();
入口参数描述:无
出口参数描述(返回的数组元素Qyxx类的属性描述):
字段名 |
约束 |
类型 |
最大长度 |
说明 |
itemid |
|
Char |
32 |
企业ID |
qydm |
|
Char |
50 |
企业代码 |
qyqc |
|
Char |
200 |
企业全称 |
qyzcdz |
|
Char |
200 |
注册地址 |
regionname |
|
Char |
100 |
所在地 |
scfw |
|
Char |
600 |
生产范围 |
获取企业的兽药产品信息是指获取生产企业的兽药产品数组,按生产企业排序;
函数名称为:
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 |
通用名 |
获取追溯码信息是指获取扫描的追溯码的贴码产品信息;
函数名称:
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:SS |
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 |
药品类型 |
获取出库企业的收货单位信息是指获取出库企业的收货单位数组,按企业类型和企业全称排序;
函数名称为:
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