National veterinary drug product traceability system registration and interface call specification

1 国家兽药产品追溯系统备案登记和接口调用规范 2. 范围 本标准规定追溯设备厂商、各省自建兽药监管系统与国家兽药产品追溯系统间的接口 交互方式； 本标准适用于追溯设备厂商、各省自建兽药监管系统在国家兽药产品追溯系统进行备 案，获取备案编码密钥、备案编码、对应类型接口文档。 2.概述 本标准根据兽药监管信息化建设的需要，围绕兽药产品从出厂到使用全程兽药产品追 溯，规范国家兽药产品追溯系统所涉及的追溯设备厂商、各省自建兽药监管系统国家兽药产 品追溯系统间的接口交互方式。 本标准的第3章给出数据采集设备和追溯系统服务端接口的通信方式；具体接口的描述 和定义，函数名称，入口和出口参数描述，在追溯设备厂商、各省自建兽药监管系统备案成 功后会将对应类型接口文档以邮件形式发送至备案时填写邮箱。 3.通信方式 数据采集设备和追溯系统平台服务端接口遵循 webservice协议，采用标准的 webservice协议定义描述双方调用的服务函数的入口参数和出口参数，双方均按照wsdl相关 协议解析信息，服务地址及名称在中国兽药信息网-国家兽药产品追溯系统首页公布，采用 一个服务，多个函数的方式提供给追溯设备厂商调用。 4.备案和接口调用 国家兽药产品追溯系统使用环境推荐：Windows7操作系统以上，谷歌(Chrome)浏览器。 4.1备案步骤 打开国家兽药产品追溯系统的备案登记登陆页面。此前已有备案编码的追溯设备厂商、 各省自建兽药监管系统监管单位不需要再次备案。 选择用户所属单位的类型【追溯设备厂商、各省自建兽药监管系统监管单位】，点击【下 一步】。点击【同意并继续】，进入备案页面。 2 选择身份后，填写相关信息（省市区为 PDA 追溯设备厂商、各省自建兽药监管系统监 管单位所在地地址），星号*项为必填项，点击【备案】，备案成功后系统会向备案时所填写 的 Email（必须正确如实填写）发送备案编码密钥、备案代码、对应类型接口文档，注意请 勿泄露备案编码密钥！ 4.2调用接口 WSDL地址： 在中国兽药信息网-国家兽药产品追溯系统首页公布。 新增 code参数：备案编码密钥（必填） 4.2.1示意： 调用函数时，需要在网络请求的 header中设置 code的值 SOAP UI调用方式： 【新建 SOAP Project】，如下图。 WSDL地址必须添加正确的 code参数（备案编码密钥）,否则视为无效的 WSDL地址。 进入调用方法，以 getZsmLevel方法为例，如下图。 3 在调用方法的页面，点击 headers，点击加号添加正确的参数 code（备案编码密钥）， 如下图。 4 调用成功：