《国家兽药产品追溯系统数据交换文件规范.docx》由会员分享,可在线阅读,更多相关《国家兽药产品追溯系统数据交换文件规范.docx(17页珍藏版)》请在得力文库 - 分享文档赚钱的网站上搜索。
1、附件1国家兽药产品追溯系统数据交换文件规范1.1.范围范围本标准主要规定了国家兽药产品追溯系统追溯码及数据交换文件规范。本标准适用于国家兽药产品追溯系统的各类数据采集及交换。2.2.概述概述本规范根据兽药监管信息化建设的需要,围绕兽药产品从出厂到使用全程追溯,规范国家兽药产品追溯系统所涉及的追溯码及数据交换文件接口标准。本规范详细说明国家兽药产品追溯系统的追溯码及数据交换文件,除“追溯码文件”采用指定的文本文件格式外,其他的接口均采用XML1.0的国际标准文件格式进行数据交换。3.3.追溯码文件规范说明追溯码文件规范说明追溯码文件是把国家兽药产品追溯系统生成的追溯码数据下载成文件,以供生产企业
2、使用。追溯码文件生成的规范为TXT文件,然后被压缩为ZIP文件供用户下载。4.4.数据交换文件规范说明数据交换文件规范说明数据交换文件规范定义参考xml schema的格式进行定义,但不同于xml schema的语法规则, 元素节点规则如下:每个节点都可以包含多个属性, 也可以包含下级节点。5.5.追溯码文件追溯码文件5.15.1 追溯码编码规则追溯码编码规则兽药产品追溯码是国家兽药产品追溯系统随机产生的24位数字,编码规范满足唯一性、稳定性的原则。兽药产品追溯码生成二维码的码制是QR码,字符编码采用UTF-8。5.25.2 追溯码编码追溯码编码示意示意兽药产品追溯码示意如下:20190219
3、00000000003301325.35.3 追溯码文件名称定义追溯码文件名称定义追溯码默认文件名称是系统自动生成,生成规则是:追溯码文件为“申请号_产品名.TXT” ;如果用户为追溯码申请设置了大于 1 级的文件分割记录,则追溯码文件为“申请号_产品名_级数.TXT” 。压缩后的追溯码文件名为“申请号_产品名.ZIP” 。例:201901290038_副猪嗜血杆菌病灭活疫苗.txt。压缩文件名为: 201901290038_副猪嗜血杆菌病灭活疫苗.zip。201901290038_鸡新城疫灭活疫苗(La Sota 株)_1.txt,201901290038_鸡新城疫灭活疫苗(La Sota
4、株)_2.txt。压缩文件名为: 201901290038_鸡新城疫灭活疫苗(La Sota 株).zip。5.45.4 追溯码文件规范追溯码文件规范追溯码文件为 txt 文本文件,其文件内容格式如下:第一行:生产企业名称产品名称审批通过码数量此分割文件中的码数量版本号其他行:追溯码,产品名称,批准文号,生产企业简称,联系电话其中第一行为头信息,其他行为二维码信息数据,头信息行以英文“”开头,各属性以英文“”隔开;其他行以全角“, ”隔开。属性含义解释如下:(1)生产企业名称:提出追溯码申请的企业名称;(2)产品名称:申请的追溯码所属的产品的名称;(3)批准文号:要追溯的产品的批准文号或进口注
5、册证书号;(4)审批通过码数量:审批人员批准的追溯码数量;(5)分割文件中的码数量:如果所属追溯码申请没有分割,则此值等于审批通过的码数量;否则等于此级数分割文件记录中的码数量。(6)版本号:标识追溯码文件的版本信息,目前为固定值“1.0” 。文件总行数应该为:此分割文件中的码数量+1。5.55.5 追溯码文件示例追溯码文件示例追溯码文件(201901290038_副猪嗜血杆菌病灭活疫苗.txt)内容:XXX 公司副猪嗜血杆菌病灭活疫苗100010001.0201902190000000000380158,副猪嗜血杆菌病灭活疫苗,兽药生字(2018)XXXXXXXXX,企业简称,010-123
6、45678201902190000000000390106,猪嗜血杆菌病灭活疫苗,兽药生字(2018)XXXXXXXXX,企业简称,010-12345678201902190000000000400740,副猪嗜血杆菌病灭活疫苗,兽药生字(2018)XXXXXXXXX,企业简称,010-12345678201902190000000000430103,副猪嗜血杆菌病灭活疫苗,兽药生字(2018)XXXXXXXXX,企业简称,010-123456786.6.数据交换文件数据交换文件数据交换文件是兽药产品入库数据文件和兽药产品出库数据文件两类。6.16.1 兽药产品入库数据文件兽药产品入库数据文件
7、该文件为使用追溯系统的企业导出兽药产品入库数据给追溯系统时使用。根据使用对象分为两类:生产企业入库文件、其他企业入库文件。6.1.16.1.1 生产企业生产企业入库文件入库文件(1 1)生产企业入库文件规范)生产企业入库文件规范规范定义如下:(2 2)XMLXML SchemaSchema 规范规范兽药产品入库数据(生产企业)的 XML 文件的 Schema 规范,结构如下:DataListProductBatchData1.1.1.各节点注释如下表: 节点节点名称名称节点节点含义含义节点属性节点属性下级下级节点节点DataList文档根节点corpName:入库企业名称,必选manCode:
8、追溯设备厂商代码,必选dataType:数据类型,只能为“wareHouseIn” ,必选Productversion:版本号,默认 1.0,必选ProductDataList 子节点,可出现多次,必须至少出现一次。其子元素为不同批号产品入库数据productName:产品通用名,必选pzwh:产品批准文号,必选packing:包装规格,必选,例如 质量单位:kg、g、mg;体积单位:l、ml;疫苗单位:头份、羽份等 BatchBatchProduct 子节点,可出现多次,必须至少出现一次。其子元素为当前批号产品入库数据记录batchNo:批号,必选specification:产品规格包含单位
9、, 必选minPackUnit:最小包装单位,必选minTagUnit:最小贴码单位,必选 tagPackRatio:最小贴码单位与最小包装单位的比例值,可选tagRatio:贴码包装比例,必选produceDate::生产日期 ,必选,样式为:YYYY/MM/DDoperator:入库操作员,可选oprDate:入库日期,必选,样式为:YYYY/MM/DDcount:入库数量,可选countUnit:数量单位。1-最小包装单位;2-最小贴码单位,可选DataDataBatch 子节点,可出现多次,必须至少出现一次。表示产品入库数据记code:入库追溯码,必选录。(3 3)生产企业入库文件示例
10、)生产企业入库文件示例6.1.26.1.2 其他企业其他企业入库文件入库文件其他企业含有经营企业、养殖场等非生产企业用户。(1 1)其他企业入库文件规范其他企业入库文件规范规范定义如下:(2 2) XMLXML SchemaSchema 规范规范兽药产品入库数据(其他企业)的XML文件的Schema规范,结构如下:DataListProductBatchData1.1.1.各节点注释如下表:节点名称节点名称节点含义节点含义节点属性节点属性下级节点下级节点DataList文档根节点corpName:入库企业名称,必选manCode:追溯设备厂商代码,必选dataType:数据类型,只能为“war
11、eHouseIn” ,必选version:版本号,默认 1.1,必选ProductProductDataList 子节点,必须至少出现一次BatchBatchProduct 子节点,可出现多次,必须至少出现一次。其子元素为企业入库数据记录batchNo:批号/流水号,可选operator:入库操作员,可选oprDate:入库日期,必选,样式为:YYYY/MM/DDDataDataBatch 子节点,可出现多次,必须至少出现一次。表示产品入库数据记录。code: 入库追溯码,必选(3 3)其他企业入库文件示例)其他企业入库文件示例6.26.2 兽药产品出库数据文件兽药产品出库数据文件该接口文件为
12、兽药生产企业、经营企业等用户导出兽药产品出库数据给追溯系统时使用。根据使用对象分为两类,生产企业出库文件、经营企业出库文件。(1 1)兽药产品出库数据文件规范)兽药产品出库数据文件规范规范定义如下:(2 2)XMLXML SchemaSchema 规范规范兽药产品出库数据的XML文件的Schema规范,结构如下:DataListProductBatchData1.1.1.各节点注释如下表:节点名称节点名称节点含义节点含义节点属性节点属性下级节点下级节点DataList文档根节点corpName:出库企业名称,必选toUnitType:收货单位种类,必选,1 为经营企业;2 为其他manCode
13、:追溯设备厂商代码,必选dataType:数据类型,只能为wareHouseOut:必选version:版本号,默认 1.1,必选ProductProductDataList 子节点,必须至少出现一次BatchBatchProduct 子节点,可出现多次,必须至少出现一次。其子元素为企业出库数据记录batchNo:批号,可选operator:出库操作员,可选oprDate:出库日期,必选,样式为:YYYY/MM/DDtoProvince:收货省份toCity:收货市toCounty:收货县toUnit:具体收货单位toUnitcode:具体收货单位代码当 toUnitType:收货单位种类为
14、1 时,toProvince、toCity、toCounty、 toUnit、toUnitcode 必填;当toUnitType:收货单位种类为 2 时toProvince、toCity、toCounty、toUnit 必填;toUnitcode 非必选DataDataBatch 子节点,可出现多次,必须至少出现一次。表示产品出库数据记录code:出库追溯码,必选(3 3)兽药产品出库数据文件示例)兽药产品出库数据文件示例兽药生产企业产品出库数据文件示例(收货单位为经营企业):兽药生产企业产品出库数据文件示例(收货单位为其他):兽药经营企业产品出库数据文件示例:附件2国家兽药产品追溯系统备案登
15、记和接口调用规范1.1.范围范围本标准规定追溯设备厂商、各省自建兽药监管系统与国家兽药产品追溯系统间的接口交互方式;本标准适用于追溯设备厂商、各省自建兽药监管系统在国家兽药产品追溯系统进行备案,获取备案编码密钥、备案编码、对应类型接口文档。2.2.概述概述本标准根据兽药监管信息化建设的需要,围绕兽药产品从出厂到使用全程兽药产品追溯,规范国家兽药产品追溯系统所涉及的追溯设备厂商、各省自建兽药监管系统国家兽药产品追溯系统间的接口交互方式。本标准的第3部分给出数据采集设备和追溯系统服务端接口的通信方式;具体接口的描述和定义,函数名称,入口和出口参数描述,在追溯设备厂商、各省自建兽药监管系统备案成功后
16、会将对应类型接口文档以邮件形式发送至备案时填写的邮箱。3.3.通信方式通信方式数据采集设备和追溯系统平台服务端接口遵循webservice协议,采用标准的webservice协议定义描述双方调用的服务函数的入口参数和出口参数,双方均按照wsdl相关协议解析信息,服务地址及名称在中国兽药信息网-国家兽药产品追溯系统首页公布,采用一个服务,多个函数的方式提供给追溯设备厂商调用。4.4.备案和接口调用备案和接口调用国家兽药产品追溯系统使用环境推荐:Windows7 操作系统以上,谷歌(Chrome)浏览器。4.14.1 备案步骤备案步骤打开国家兽药产品追溯系统的备案登记登陆页面。此前已有备案编码的追
17、溯设备厂商、各省自建兽药监管系统监管单位不需要再次备案。选择用户所属单位的类型【追溯设备厂商、各省自建兽药监管系统监管单位】 ,点击【下一步】 。点击【同意并继续】 ,进入备案页面。选择身份后,填写相关信息(省市区为 PDA 追溯设备厂商、各省自建兽药监管系统监管单位所在地地址) ,星号*项为必填项,点击【备案】 ,备案成功后系统会向备案时所填写的邮箱,发送备案编码密钥、备案代码、对应类型接口文档。注意请勿泄露备案编码密钥!4.24.2 调用接口调用接口WSDL 地址:在中国兽药信息网-国家兽药产品追溯系统首页公布新增 code 参数:备案编码密钥(必填)示意:示意:调用函数时,需要在网络请求的 header 中设置 code 的值SOAP UI 调用方式:【新建 SOAP Project】,如下图。WSDL 地址必须添加正确的 code 参数(备案编码密钥),否则视为无效的 WSDL 地址。进入调用方法,以 getZsmLevel 方法为例,如下图。在调用方法的页面,点击 headers,点击加号添加正确的参数 code(备案编码密钥),如下图。调用成功:
限制150内