追溯码及数据交换文件规范.docx
《追溯码及数据交换文件规范.docx》由会员分享，可在线阅读，更多相关《追溯码及数据交换文件规范.docx（20页珍藏版）》请在冰豆网上搜索。
追溯码及数据交换文件规范
附件2
国家兽药产品追溯系统
追溯码及数据交换文件规范
11 范围
本标准主要规定了国家兽药产品追溯系统追溯码及数据交换文件规范。
本标准适用于国家兽药产品追溯系统的各类数据采集及交换。
12 规范性引用文件
中国目前的国家标准是QR码（QuickResponseCode）和PDF417码。
QR码的中文译名为“快速响应矩阵码”，是一种矩阵式二维码。
每个QR码符号由正方形模块组成的一个正方形阵列构成，就象其它矩阵式二维码一样，它是通过模块的颜色深浅来表达数据，深色模块表示二进制1，浅色模块表示二进制0。
QR码的特征是在其左上角、右上角和左下角的三个由同心正方形构成的位置探测图形。
每个QR码符号最多可以包含：
1.数字数据：
7089个字符
2.字母数字数据：
4296个字符
3.8位字节数据：
2953个字符
4.日本汉字数据：
1817个字符
5.中国汉字数据：
1817个字符
QR码有L、M、Q、H四种纠错等级，可恢复的码字比例分别为7%、15%、25%、30%。
13 术语和定义
1.追溯码：
按照国家兽药产品追溯系统编码规则产生的24位随机数字，是兽药产品追溯的唯一性标识；追溯码中显示的数字与产品的实际生产日期、批号等信息无任何关系。
2.最小贴码单位：
产品的最小贴码单位，可以是产品的最小包装（如瓶），也可以是根据实际情况选择的某级包装（如盒、箱）。
3.最小包装单位：
是指不可再拆分兽药产品的最小包装。
4.最小贴码单位与最小包装单位的比例值：
一个最小贴码单位包装中存放的最小包装单位的数量。
如10，则表示一个贴码单位包装中可以存放10个最小包装单位的产品。
默认值为1，表示最小贴码单位与最小包装单位相同。
5.包装级别：
1为最小贴码单位包装级别，数字越大，包装级别越大。
1级为最内层贴码包装，2级为1级的外包装，3级为2级的外包装，依次类推。
6.包装比例：
指从最外层贴码包装到最小贴码单位所属包装级别的各级包装的存放比例，之间用半角冒号分隔。
如1:
4:
40，表示共有三级包装需要贴码，1个3级贴码包装中存放4个2级贴码包装，1个2级贴码包装中存放10个1级最小贴码包装。
包装比例一般为两级或以上包装，如有一级包装情况，则可将包装比例设置为“1：
实际生产数量”。
14 概述
本规范根据兽药行业信息化建设的需要，围绕兽药产品从出厂到使用全程追溯，规范了国家兽药产品追溯系统所涉及的追溯码及数据交换文件接口标准。
本规范详细说明了国家兽药产品追溯系统的追溯码及数据交换文件，除“追溯码文件”采用指定的文本文件格式外，其他的接口均采用XML1.0的国际标准文件格式进行数据交换。
15 追溯码文件规范说明
追溯码文件是把国家兽药产品追溯系统生成的追溯码数据下载成文件，以供生产企业使用。
追溯码文件生成的规范为TXT文件，然后被压缩为ZIP文件供用户下载。
16 数据交换文件规范说明
数据交换文件规范定义参考xmlschema的格式进行定义,但不同于xmlschema的语法规则,元素节点规则如下:
<节点1名称属性1名称（属性1中文名称属性1类型可选/必选）,
属性2名称（属性2中文名称属性2类型可选/必选）,
…
>
<节点2名称属性定义…>
…..
….
<节点n名称…/>
每个节点都可以包含多个属性,也可以包含下级节点。
17 追溯码文件
7.1追溯码编码规则
兽药产品追溯码是国家兽药产品追溯系统随机产生24位数字，编码规范满足唯一性、稳定性的原则。
兽药产品追溯码生成二维码的码制是QR码，字符编码采用UTF-8。
7.2追溯码编码示例
示例如下：
28。
注：
追溯码中显示的数字与产品的实际生产日期、批号等信息无任何关系。
7.3追溯码文件名称定义
追溯码默认文件名称是系统自动生成，生成规则是：
追溯码文件为“申请号_产品名.TXT”；如果用户为追溯码申请设置了大于1级的文件分割记录，则追溯码文件为“申请号_产品名_级数.TXT”。
压缩后的追溯码文件名为“申请号_产品名.ZIP”。
例：
28_副猪嗜血杆菌病灭活疫苗.txt。
压缩文件名为：
28_副猪嗜血杆菌病灭活疫苗.zip。
28_鸡新城疫灭活疫苗（LaSota株）_1.txt，28_鸡新城疫灭活疫苗（LaSota株）_2.txt。
压缩文件名为：
28_鸡新城疫灭活疫苗（LaSota株）.zip。
7.4追溯码文件规范
追溯码文件为txt文本文件，其文件内容格式如下：
第一行：
^生产企业名称^产品名称^审批通过码数量^此分割文件中的码数量^版本号
其他行：
追溯码，产品名称，批准文号，生产企业简称，联系电话
其中第一行为头信息，其他行为二维码信息数据，头信息行以英文“^”开头，各属性以英文“^”
隔开；其他行以全角“，”隔开。
属性含义解释如下：
（1）生产企业名称：
提出追溯码申请的企业名称；
（2）产品名称：
申请的追溯码所属的产品的名称；
（3）批准文号：
要追溯的产品的批准文号或进口注册证书号；
（4）审批通过码数量：
审批人员批准的追溯码数量；
（5）分割文件中的码数量：
如果所属追溯码申请没有分割，则此值等于审批通过的码数量；否则等于此级数分割文件记录中的码数量。
（6）版本号：
标识追溯码文件的版本信息，目前为固定值“1.0”。
文件总行数应该为：
此分割文件中的码数量+1。
7.5追溯码文件示例
追溯码文件（28_副猪嗜血杆菌病灭活疫苗.txt）内容：
^武汉科前动物生物制品有限责任公司^副猪嗜血杆菌病灭活疫苗^1000^1000^1.0
28，副猪嗜血杆菌病灭活疫苗，兽药生字（2011）170041065，武汉科前，
28，副猪嗜血杆菌病灭活疫苗，兽药生字（2011）170041065，武汉科前，
……
28，副猪嗜血杆菌病灭活疫苗，兽药生字（2011）170041065，武汉科前，
28，副猪嗜血杆菌病灭活疫苗，兽药生字（2011）170041065，武汉科前，
18 数据交换文件
数据交换文件是兽药产品入库数据文件和兽药产品出库数据文件两类。
8.1兽药产品入库数据文件
该文件为使用追溯系统的企业导出兽药产品入库数据给追溯系统时使用。
根据使用对象分为两类：
生产企业入库文件、其他企业入库文件。
8.1.1生产企业入库文件
（1）生产企业入库文件规范
规范定义如下：
xmlversion="1.0"encoding="UTF-8"?
>
xsi=""xsi:
noNamespaceSchemaLocation="兽药产品入库数据_生产企业.xsd">
……
……
……
（2）XMLSchema规范
兽药产品入库数据（生产企业）的XML文件的Schema规范，结构如下：
各节点注释如下表：
节点名称
节点含义
节点属性
下级节点
DataList
文档根节点
corpName：
入库企业名称，必选
dataType：
数据类型，只能为“wareHouseIn”，必选
version：
版本号，默认1.0，必选
Product
Product
DataList子节点，可出现多次，必须至少出现一次。
其子元素为不同批号产品入库数据
productName：
产品通用名，必选
pzwh：
产品批准文号，必选
Batch
Batch
Product子节点，可出现多次，必须至少出现一次。
其子元素为当前批号产品入库数据记录
batchNo：
批号，必选
specification：
产品规格[包含单位]，必选
minPackUnit：
最小包装单位，必选
minTagUnit：
最小贴码单位，必选
tagPackRatio：
最小贴码单位与最小包装单位的比例值，可选
tagRatio：
贴码包装比例，必选
produceDate:
：
生产日期，必选，样式为：
YYYY/MM/DD
operator：
入库操作员，可选
oprDate：
入库日期，必选，样式为：
YYYY/MM/DD
count：
入库数量，可选
countUnit:
数量单位。
1-最小包装单位；2-最小贴码单位，可选
Data
Data
Batch子节点，可出现多次，必须至少出现一次。
表示产品入库数据记录。
code:
入库追溯码，必选
（3）生产企业入库文件示例
xmlversion="1.0"encoding="UTF-8"?
>
xsi=""xsi:
noNamespaceSchemaLocation="兽药产品入库数据_生产企业.xsd">
4：
40"produceDate="2012/12/25"operator="张三"oprDate="2012/12/25">
……
……
……
……
……
……
……
……
4"produceDate="2012/12/25"operator="李四"oprDate="2012/12/25">
8.1.2其他企业入库文件
其他企业含有经营企业、养殖场等非生产企业用户。
（1）其他企业入库文件规范
规范定义如下：
xmlversion="1.0"encoding="UTF-8"?
>
xsi=""xsi:
noNamespaceSchemaLocation="兽药产品入库数据_其他企业1.1.xsd">
……
……
（2）XMLSchema规范
兽药产品入库数据（其他企业）的XML文件的Schema规范，结构如下：
各节点注释如下表：
节点名称
节点含义
节点属性
下级节点
DataList
文档根节点
corpName：
入库企业名称，必选
dataType：
数据类型，只能为“wareHouseIn”，必选
version：
版本号，默认1.1，必选
Product
Product
DataList子节点，必须至少出现一次
Batch
Batch
Product子节点，可出现多次，必须至少出现一次。
其子元素为企业入库数据记录
batchNo：
批号/流水号，可选
operator：
入库操作员，可选
oprDate：
入库日期，必选，样式为：
YYYY/MM/DD
Data
Data
Batch子节点，可出现多次，必须至少出现一次。
表示产品入库数据记录。
code:
入库追溯码，必选
（3）其他企业入库文件示例
xmlversion="1.0"encoding="UTF-8"?
>
xsi=""xsi:
noNamespaceSchemaLocation="兽药产品入库数据_其他企业1.1.xsd">
8.2兽药产品出库数据文件
该接口文件为兽药生产企业、经营企业等用户导出兽药产品出库数据给追溯系统时使用。
（1）兽药产品出库数据文件规范
规范定义如下：
xmlversion="1.0"encoding="UTF-8"?
>
xsi=""xsi:
noNamespaceSchemaLocation="兽药产品出库数据1.1.xsd">
……
……
……
（2）XMLSchema规范
兽药产品出库数据的XML文件的Schema规范，结构如下：
各节点注释如下表：
节点名称
节点含义
节点属性
下级节点
DataList
文档根节点
corpName：
出库企业名称，必选
dataType：
数据类型，只能为“wareHouseOut”，必选
version：
版本号，默认1.1，必选
Product
Product
DataList子节点，必须至少出现一次
Batch
Batch
Product子节点，可出现多次，必须至少出现一次。
其子元素为企业出库数据记录
batchNo：
批号，可选
operator：
出库操作员，可选
oprDate：
出库日期，必选，样式为：
YYYY/MM/DD
toProvince：
收货省份，必选
toCity：
收货市，可选
toCounty：
收货县，可选
toUnit：
具体收货单位，可选
Data
Data
Batch子节点，可出现多次，必须至少出现一次。
表示产品出库数据记录
code：
出库追溯码，必选
（3）兽药产品出库数据文件示例
兽药生产企业产品出库数据文件示例：
xmlversion="1.0"encoding="UTF-8"?
>
xsi=""xsi:
noNamespaceSchemaLocation="兽药产品出库数据1.1.xsd">
兽药经营企业产品出库数据文件示例：
xmlversion="1.0"encoding="UTF-8"?
>
xsi=""xsi:
noNamespaceSchemaLocation="兽药产品出库数据1.1.xsd">
附件3
国家兽药产品追溯系统数据采集设备接口标准
1.范围
本标准规定了数据采集设备和追溯系统平台间的接口标准。
本标准适用于数据采集设备和追溯系统平台间的信息交互，供各类数据采集设备的厂商使用。
2.概述
本标准根据兽药行业信息化建设的需要，围绕兽药产品从出厂到使用全程兽药产品追溯，规范了国家兽药产品追溯系统所涉及的数据采集设备接口标准。
本标准的第3章给出了数据采集设备和追溯系统平台服务端接口的通信方式；第4章具体给出了接口的描述和定义，函数名称，入口和出口参数描述。
3.通信方式
数据采集设备和追溯系统平台服务端接口遵循webservice协议，采用标准的webservice协议定义描述双方调用的服务函数的入口参数和出口参数，双方均按照wsdl相关协议解析信息，服务地址及名称如下形式（或域名）:
端口/服务，采用一个服务，多个函数的方式提供给数据采集设备调用。
例如：
。
4.接口描述和定义
4.1获取用户信息
获取用户信息的函数名称：
SysUserOfWsgetUserInfo（Charuserid,Charuserpwd）;
入口参数描述：
字段名
约束
类型
最大长度
说明
userid
必填
Char
30
用户ID
userpwd
必填
Char
30
用户密码
出口参数描述（返回的SysUserOfWs类的属性描述）：
字段名
约束
类型
最大长度
说明
curdate
必填
Char
20
服务器时间，样式为：
YYYY/MM/DDHH:
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
用户密码
4.2修改用户信息
修改用户信息是指修改当前登录用户的密码和用户名信息;
函数名称为：
CharupdateUserInfo（Charuserid,CharuserOldPwd,CharuserNewPwd,Charusername）;
入口参数描述：
字段名
约束
类型
最大长度
说明
userid
必填
Char
30
用户ID
userOldPwd
必填
Char
30
用户旧密码
userNewPwd
必填
Char
30
用户新密码
username
必填
Char
50
用户名
出口参数描述：
字段名
约束
类型
最大长度
说明
Char
“success”表示修改信息成功，否则为失败原因
4.3获取兽药生产企业信息
获取兽药生产企业信息是指取得审核通过的兽药生产企业信息数组;
函数名称：
Qyxx[]getSys
升级会员 