农业部办公厅关于实施兽药质量安全追溯工作.doc
1附件 3国家兽药产品追溯系统数据采集设备接口标准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必填Char30用户 IDuserpwd必填Char30用户密码出口参数描述（返回的 SysUserOfWs 类的属性描述）：字段名约束类型最大长度说明curdate必填Char20服务器时间，样式为：YYYY/MM/DD HH:MM:SSrolenameChar50角色2unitChar32所属单位 IDunitnameChar200所属单位名称unittypeChar2单位类型， 00-监管单位；01-生产企业；02-经营企业；03-使用者userid必填Char30用户 IDusername必填Char50用户名userpwd必填Char30用户密码4.2 修改用户信息修改用户信息是指修改当前登录用户的密码和用户名信息; 函数名称为：Char updateUserInfo(Char userid,Char userOldPwd,Char userNewPwd,Char username);入口参数描述：字段名约束类型最大长度说明userid必填Char30用户 IDuserOldPwd必填Char30用户旧密码userNewPwd必填Char30用户新密码username必填Char50用户名出口参数描述：字段名约束类型最大长度说明Char“success”表示修改信息 成功，否则为失败原因34.3 获取兽药生产企业信息 获取兽药生产企业信息是指取得审核通过的兽药生产企业信息数组; 函数名称：Qyxx getSyscqys ();入口参数描述：无 出口参数描述（返回的数组元素 Qyxx 类的属性描述）：字段名约束类型最大长度说明itemidChar32企业 IDqydmChar50企业代码qyqcChar200企业全称qyzcdzChar200注册地址regionnameChar100所在地scfwChar600生产范围4.4 获取企业的兽药产品信息获取企业的兽药产品信息是指获取生产企业的兽药产品数组，按生产企业排序； 函数名称为：Sycpxx getSycps (Char qyids);入口参数描述：字段名约束类型最大长度说明qyids必填Char企业 ID，如果是多个企业，之间用半角逗号分隔出口参数描述（返回的数组元素 Sycpxx 类的属性描述）：字段名约束类型最大长度说明ggChar200规格itemidChar32药品 IDpzrqChar20批准文号的批准日期，样式为：YYYY/MI/DD4pzwhChar30批准文号qyidChar32企业 IDqynameChar200企业名称spmChar200商品名tymChar200通用名4.5 获取追溯码信息获取追溯码信息是指获取扫描的追溯码的贴码产品信息； 函数名称：Tmcpxx getZsmInfo (Char zsm);入口参数描述：字段名约束类型最大长度说明zsm必填Char24要查询的追溯码出口参数描述（返回的 Tmcpxx 类的属性描述）：字段名约束类型最大长度说明chsfChar200收货单位cpnameChar200产品名称spmChar200商品名cxcsint码查询次数dyccxsjChar20第一次查询时间, 样式为：YYYY/MI/DD HH：MM：SSjxnameChar100剂型minpackunitChar30最小包装单位mintagunitChar30最小贴码单位phChar60批号5pzwhChar30批准文号qynameChar200生产企业scrqChar20生产日期specificationChar200产品规格sxrqChar20失效日期tagratioChar30贴码包装比例tmjbint贴码级别yplxnameChar100药品类型4.6 获取出库企业的收货单位信息获取出库企业的收货单位信息是指获取出库企业的收货单位数组，按企业类型和企业 全称排序； 函数名称为：Shdwxx getShdws (Char userid);入口参数描述：字段名约束类型最大长度说明userid必填CharPDA 用户 ID 出口参数描述（返回的数组元素 Shdwxx 类的属性描述）：字段名约束类型最大长度说明itemidChar32单位 IDqylxChar2企业类型，02-经营企业；03-使用者qyqcChar200企业名称regioncodeChar20所属行政区划编码regionnameChar100所属行政区划名称
