1、1附件 2国家兽药产品追溯系统追溯码及数据交换文件规范1 范围本标准主要规定了国家兽药产品追溯系统追溯码及数据交换文件规范。本标准适用于国家兽药产品追溯系统的各类数据采集及交换。2 规范性引用文件中国目前的国家标准是QR码（Quick Response Code）和PDF417码。QR码的中文译名为“快速响应矩阵码”，是一种矩阵式二维码。每个QR码符号由正方形模块组成的一个正方形阵列构成，就象其它矩阵式二维码一样，它是通过模块的颜色深浅来表达数据，深色模块表示二进制1，浅色模块表示二进制0。QR码的特征是在其左上角、右上角和左下角的三个由同心正方形构成的位置探测图形。每个QR码符号最多可以包含
2、：1.数字数据：7089 个字符2.字母数字数据：4296 个字符3.8位字节数据：2953 个字符 4.日本汉字数据：1817 个字符5.中国汉字数据：1817 个字符QR码有 L、M、Q、H 四种纠错等级，可恢复的码字比例分别为 7%、15%、25%、30%。3 术语和定义1.追溯码：按照国家兽药产品追溯系统编码规则产生的24位随机数字，是兽药产品追溯的唯一性标识；追溯码中显示的数字与产品的实际生产日期、批号等信息无任何关系。2. 最小贴码单位：产品的最小贴码单位，可以是产品的最小包装（如瓶），也可以是根据实际情况选择的某级包装（如盒、箱）。3. 最小包装单位：是指不可再拆分兽药产品的最小
3、包装。4. 最小贴码单位与最小包装单位的比例值：一个最小贴码单位包装中存放的最小包装单位的数量。如10，则表示一个贴码单位包装中可以存放10个最小包装单位的产品。默认值为1，表示最小贴码单位与最小包装单位相同。5.包装级别：1为最小贴码单位包装级别，数字越大，包装级别越大。1级为最内层贴码包装，2级为1级的外包装，3级为2级的外包装，依次类推。6.包装比例：指从最外层贴码包装到最小贴码单位所属包装级别的各级包装的存放比例，之间用半角冒号分隔。如1:4:40，表示共有三级包装需要贴码，1个3级贴码包装中存放4个2级贴码包装，1个2级贴码包装中存放10个1级最小贴码包装。包装比例一般为两级或以上包
4、装，如有一级包装情况，则可将包装比例设置为“1：实际生产数量”。4 概述本规范根据兽药行业信息化建设的需要，围绕兽药产品从出厂到使用全程追溯，规范2了国家兽药产品追溯系统所涉及的追溯码及数据交换文件接口标准。本规范详细说明了国家兽药产品追溯系统的追溯码及数据交换文件，除“追溯码文件”采用指定的文本文件格式外，其他的接口均采用XML1.0的国际标准文件格式进行数据交换。5 追溯码文件规范说明追溯码文件是把国家兽药产品追溯系统生成的追溯码数据下载成文件，以供生产企业使用。追溯码文件生成的规范为TXT文件，然后被压缩为ZIP文件供用户下载。6 数据交换文件规范说明数据交换文件规范定义参考xml sc
5、hema的格式进行定义,但不同于xml schema的语法规则, 元素节点规则如下:.每个节点都可以包含多个属性, 也可以包含下级节点。7 追溯码文件7.1 追溯码编码规则兽药产品追溯码是国家兽药产品追溯系统随机产生 24 位数字，编码规范满足唯一性、稳定性的原则。兽药产品追溯码生成二维码的码制是 QR 码，字符编码采用 UTF-8。7.2 追溯码编码示例示例如下：201401290003800000020462。注：追溯码中显示的数字与产品的实际生产日期、批号等信息无任何关系。7.3 追溯码文件名称定义追溯码默认文件名称是系统自动生成，生成规则是：追溯码文件为“申请号_产品名.TXT”；如果
6、用户为追溯码申请设置了大于 1 级的文件分割记录，则追溯码文件为“申请号_产品名_级数.TXT” 。压缩后的追溯码文件名为“申请号_产品名.ZIP” 。例：2012122929028_副猪嗜血杆菌病灭活疫苗.txt。压缩文件名为： 2012122929028_副猪嗜血杆菌病灭活疫苗.zip。2012122910008_鸡新城疫灭活疫苗（La Sota 株）_1.txt，2012122910008_鸡新城疫灭活疫苗（La Sota 株）_2.txt。压缩文件名为： 2012122910008_鸡新城疫灭活疫苗（La Sota株）.zip 。37.4 追溯码文件规范追溯码文件为 txt 文本文件，
7、其文件内容格式如下：第一行： 生产企业名称 产品名称审批通过码数量 此分割文件中的码数量版本号其他行：追溯码，产品名称，批准文号，生产企业简称，联系电话其中第一行为头信息，其他行为二维码信息数据，头信息行以英文“”开头，各属性以英文“ ”隔开；其他行以全角“， ”隔开。属性含义解释如下：（1）生产企业名称：提出追溯码申请的企业名称；（2）产品名称：申请的追溯码所属的产品的名称； （3）批准文号：要追溯的产品的批准文号或进口注册证书号；（4）审批通过码数量：审批人员批准的追溯码数量；（5）分割文件中的码数量：如果所属追溯码申请没有分割，则此值等于审批通过的码数量；否则等于此级数分割文件记录中的码
8、数量。（6）版本号：标识追溯码文件的版本信息，目前为固定值“1.0”。文件总行数应该为：此分割文件中的码数量+1。7.5 追溯码文件示例追溯码文件（2012012900038_副猪嗜血杆菌病灭活疫苗.txt ）内容：武汉科前动物生物制品有限责任公司副猪嗜血杆菌病灭活疫苗100010001.0201201290003800000010123，副猪嗜血杆菌病灭活疫苗，兽药生字（2011）170041065，武汉科前，0351-1234567201201290003800000020462，副猪嗜血杆菌病灭活疫苗，兽药生字（2011）170041065，武汉科前，0351-1234567201201
9、290003800009980995，副猪嗜血杆菌病灭活疫苗，兽药生字（2011）170041065，武汉科前，0351-1234567201201290003800010000166，副猪嗜血杆菌病灭活疫苗，兽药生字（2011）170041065，武汉科前，0351-12345678 数据交换文件数据交换文件是兽药产品入库数据文件和兽药产品出库数据文件两类。8.1 兽药产品入库数据文件该文件为使用追溯系统的企业导出兽药产品入库数据给追溯系统时使用。根据使用对象分为两类：生产企业入库文件、其他企业入库文件。8.1.1 生产企业入库文件（1）生产企业入库文件规范规范定义如下：（2）XML Sch
10、ema 规范兽药产品入库数据（生产企业）的XML 文件的Schema 规范，结构如下：D a t a L i s t P r o d u c t B a t c h D a t a1 . . 1 . . 1 . . 各节点注释如下表：节点名称 节点含义 节点属性 下级节点DataList 文档根节点 corpName：入库企业名称，必选dataType：数据类型，只能为“wareHouseIn”，必选version：版本号，默认 1.0，必选ProductProduct DataList 子节点，可出现多次，必须至少出现一次。其子元素为不同批号产品入库数据productName：产品通用名，必
11、选pzwh：产品批准文号，必选BatchBatch Product 子节点，可出现多次，必须至少出现一次。其子元素为当前批号产品入库数据记录batchNo：批号，必选specification：产品规格 包含单位， 必选minPackUnit：最小包装单位，必选minTagUnit：最小贴码单位，必选 Data5tagPackRatio：最小贴码单位与最小包装单位的比例值，可选tagRatio：贴码包装比例，必选produceDate:：生产日期 ，必选，样式为：YYYY/MM/DDoperator：入库操作员，可选oprDate：入库日期，必选，样式为：YYYY/MM/DDcount：入库数
12、量，可选countUnit:数量单位。 1-最小包装单位；2-最小贴码单位，可选Data Batch 子节点，可出现多次，必须至少出现一次。表示产品入库数据记录。code: 入库追溯码，必选（3）生产企业入库文件示例68.1.2 其他企业入库文件其他企业含有经营企业、养殖场等非生产企业用户。（1）其他企业入库文件规范规范定义如下：7（2） XML Schema 规范兽药产品入库数据（其他企业）的XML 文件的Schema 规范，结构如下：D a t a L i s t P r o d u c t B a t c h D a t a1 . . 1 . . 1 . . 各节点注释如下表：节点名称
13、节点含义 节点属性 下级节点DataList 文档根节点 corpName：入库企业名称，必选dataType：数据类型，只能为“wareHouseIn”，必选version：版本号，默认 1.1，必选ProductProduct DataList 子节点，必须至少出现一次BatchBatch Product 子节点，可出现多次，必须至少出现一次。其子元素为企业入库数据记录batchNo：批号/流水号，可选operator：入库操作员，可选oprDate：入库日期，必选，样式为：YYYY/MM/DDDataData Batch 子节点，可出现多次，必须至少出现一次。表示产品入库数据记录。cod
14、e: 入库追溯码，必选8（3） 其他企业入库文件示例8.2 兽药产品出库数据文件该接口文件为兽药生产企业、经营企业等用户导出兽药产品出库数据给追溯系统时使用。（1）兽药产品出库数据文件规范规范定义如下：（2）XML Schema 规范兽药产品出库数据的XML文件的 Schema规范，结构如下：D a t a L i s t P r o d u c t B a t c h D a t a1 . . 1 . . 1 . . 9各节点注释如下表：节点名称 节点含义 节点属性 下级节点DataList 文档根节点 corpName：出库企业名称，必选dataType：数据类型，只能为“wareHous
15、eOut” ，必选version：版本号，默认 1.1，必选ProductProduct DataList 子节点，必须至少出现一次BatchBatch Product 子节点，可出现多次，必须至少出现一次。其子元素为企业出库数据记录batchNo：批号，可选operator：出库操作员，可选oprDate：出库日期，必选，样式为：YYYY/MM/DDtoProvince：收货省份，必选toCity：收货市，可选toCounty：收货县，可选toUnit：具体收货单位，可选DataData Batch 子节点，可出现多次，必须至少出现一次。表示产品出库数据记录code：出库追溯码，必选（3）兽
16、药产品出库数据文件示例兽药生产企业产品出库数据文件示例：10兽药经营企业产品出库数据文件示例：11附件 3国家兽药产品追溯系统数据采集设备接口标准1. 范围本标准规定了数据采集设备和追溯系统平台间的接口标准。本标准适用于数据采集设备和追溯系统平台间的信息交互，供各类数据采集设备的厂商使用。2. 概述本标准根据兽药行业信息化建设的需要，围绕兽药产品从出厂到使用全程兽药产品追溯，规范了国家兽药产品追溯系统所涉及的数据采集设备接口标准。本标准的第3章给出了数据采集设备和追溯系统平台服务端接口的通信方式；第4章具体给出了接口的描述和定义，函数名称，入口和出口参数描述。3. 通信方式数据采集设备和追溯系
17、统平台服务端接口遵循webservice协议，采用标准的webservice协议定义描述双方调用的服务函数的入口参数和出口参数，双方均按照wsdl相关协议解析信息，服务地址及名称如下形式 http:/ip（或域名）:端口/服务，采用一个服务，多个函数的方式提供给数据采集设备调用。例如：http:/222.35.47.104:8081/SyZs/SyzsWsPort?wsdl。4. 接口描述和定义4.1 获取用户信息获取用户信息的函数名称： SysUserOfWs getUserInfo(Char userid,Char userpwd);入口参数描述：字段名 约束 类型 最大长度 说明user
18、id 必填 Char 30 用户 IDuserpwd 必填 Char 30 用户密码出口参数描述（返回的 SysUserOfWs 类的属性描述）：字段名 约束 类型 最大长度 说明curdate 必填 Char 20 服务器时间，样式为：YYYY/MM/DD HH:MM:SS12rolename Char 50 角色unit Char 32 所属单位 IDunitname Char 200 所属单位名称unittype Char 2 单位类型， 00-监管单位；01-生产企业；02-经营企业；03-使用者userid 必填 Char 30 用户 IDusername 必填 Char 50 用户
19、名userpwd 必填 Char 30 用户密码4.2 修改用户信息修改用户信息是指修改当前登录用户的密码和用户名信息;函数名称为：Char updateUserInfo(Char userid,Char userOldPwd,Char userNewPwd,Char username);入口参数描述：字段名 约束 类型 最大长度 说明userid 必填 Char 30 用户 IDuserOldPwd 必填 Char 30 用户旧密码userNewPwd 必填 Char 30 用户新密码username 必填 Char 50 用户名出口参数描述：字段名 约束 类型 最大长度 说明Char “s
20、uccess”表示修改信息成功，否则为失败原因134.3 获取兽药生产企业信息获取兽药生产企业信息是指取得审核通过的兽药生产企业信息数组;函数名称：Qyxx getSyscqys ();入口参数描述：无出口参数描述（返回的数组元素 Qyxx 类的属性描述）：字段名 约束 类型 最大长度 说明itemid Char 32 企业 IDqydm Char 50 企业代码qyqc Char 200 企业全称qyzcdz Char 200 注册地址regionname Char 100 所在地scfw Char 600 生产范围4.4 获取企业的兽药产品信息获取企业的兽药产品信息是指获取生产企业的兽药产
21、品数组，按生产企业排序；函数名称为：Sycpxx getSycps (Char qyids);入口参数描述：字段名 约束 类型 最大长度 说明qyids 必填 Char 企业 ID，如果是多个企业，之间用半角逗号分隔出口参数描述（返回的数组元素 Sycpxx 类的属性描述）：字段名 约束 类型 最大长度 说明gg Char 200 规格itemid Char 32 药品 IDpzrq Char 20 批准文号的批准日期，样式为：YYYY/MI/DD14pzwh Char 30 批准文号qyid Char 32 企业 IDqyname Char 200 企业名称spm Char 200 商品名t
22、ym 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 HH：MM：SSjxname Cha
23、r 100 剂型minpackunit Char 30 最小包装单位mintagunit Char 30 最小贴码单位ph Char 60 批号15pzwh 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 单位 IDqylx Char 2 企业类型，02-经营企业；03-使用者qyqc Char 200 企业名称regioncode Char 20 所属行政区划编码regionname Char 100 所属行政区划名称
