行業新聞

國家獸藥產品追溯系統數據交換文件規范

2019-06-05 11:00:31 154

國家獸藥產品追溯系統數據交換文件規范

1.范圍

本標準主要規定了國家獸藥產品追溯系統追溯碼及數據交換文件規范。

本標準適用于國家獸藥產品追溯系統的各類數據采集及交換。

2.概述

本規范根據獸藥監管信息化建設的需要,圍繞獸藥產品從出廠到使用全程追溯,規范國家獸藥產品追溯系統所涉及的追溯碼及數據交換文件接口標準。

本規范詳細說明國家獸藥產品追溯系統的追溯碼及數據交換文件,除“追溯碼文件”采用指定的文本文件格式外,其他的接口均采用XML1.0的國際標準文件格式進行數據交換。

3.追溯碼文件規范說明

追溯碼文件是把國家獸藥產品追溯系統生成的追溯碼數據下載成文件,以供生產企業使用。追溯碼文件生成的規范為TXT文件,然后被壓縮為ZIP文件供用戶下載。

4.數據交換文件規范說明

數據交換文件規范定義參考xml schema的格式進行定義,但不同于xml schema的語法規則, 元素節點規則如下:

<節點1名稱 屬性1名稱(屬性1中文名稱 屬性1類型 可選/必選),屬性2名稱(屬性2中文名稱 屬性2類型 可選/必選),>

<節點2名稱 屬性定義…>

</節點2名稱>

<節點n名稱 …/>

</節點1名稱>

每個節點都可以包含多個屬性, 也可以包含下級節點。

5.追溯碼文件

5.1追溯碼編碼規則

獸藥產品追溯碼是國家獸藥產品追溯系統隨機產生的24位數字,編碼規范滿足唯一性、穩定性的原則。獸藥產品追溯碼生成二維碼的碼制是QR碼,字符編碼采用UTF-8。

5.2追溯碼編碼示意

獸藥產品追溯碼示意如下:

201902190000000000330132

5.3追溯碼文件名稱定義

追溯碼默認文件名稱是系統自動生成,生成規則是:追溯碼文件為“申請號_產品名.TXT”;如果用戶為追溯碼申請設置了大于1級的文件分割記錄,則追溯碼文件為“申請號_產品名_級數.TXT”。壓縮后的追溯碼文件名為“申請號_產品名.ZIP”。

例:201901290038_副豬嗜血桿菌病滅活疫苗.txt。壓縮文件名為: 201901290038_副豬嗜血桿菌病滅活疫苗.zip。

201901290038_雞新城疫滅活疫苗(La Sota株)_1.txt,201901290038_雞新城疫滅活疫苗(La Sota株)_2.txt。壓縮文件名為: 201901290038_雞新城疫滅活疫苗(La Sota株).zip。

5.4追溯碼文件規范

追溯碼文件為txt文本文件,其文件內容格式如下:

第一行:^生產企業名稱^產品名稱^審批通過碼數量^此分割文件中的碼數量^版本號

其他行:追溯碼,產品名稱,批準文號,生產企業簡稱,聯系電話

其中第一行為頭信息,其他行為二維碼信息數據,頭信息行以英文“^”開頭,各屬性

以英文“^”隔開;其他行以全角“,”隔開。

屬性含義解釋如下:

1)生產企業名稱:提出追溯碼申請的企業名稱;

2)產品名稱:申請的追溯碼所屬的產品的名稱;

3)批準文號:要追溯的產品的批準文號或進口注冊證書號;

4)審批通過碼數量:審批人員批準的追溯碼數量;

5)分割文件中的碼數量:如果所屬追溯碼申請沒有分割,則此值等于審批通過的碼數量;

否則等于此級數分割文件記錄中的碼數量。

6)版本號:標識追溯碼文件的版本信息,目前為固定值“1.0”。

文件總行數應該為:此分割文件中的碼數量+1。

5.5追溯碼文件示例

追溯碼文件(

201901290038_副豬嗜血桿菌病滅活疫苗.txt)內容:

^XXX公司^副豬嗜血桿菌病滅活疫苗^1000^1000^1.0

201902190000000000380158副豬嗜血桿菌病滅活疫苗獸藥生字(2018)XXXXXXXXX企業簡稱010-12345678

201902190000000000390106豬嗜血桿菌病滅活疫苗獸藥生字(2018)XXXXXXXXX企業簡稱010-12345678

……

201902190000000000400740副豬嗜血桿菌病滅活疫苗獸藥生字(2018)XXXXXXXXX企業簡稱010-12345678

201902190000000000430103副豬嗜血桿菌病滅活疫苗獸藥生字(2018)XXXXXXXXX企業簡稱010-12345678

6.數據交換文件

數據交換文件是獸藥產品入庫數據文件和獸藥產品出庫數據文件兩類。

6.1獸藥產品入庫數據文件

該文件為使用追溯系統的企業導出獸藥產品入庫數據給追溯系統時使用。根據使用對象分為兩類:生產企業入庫文件、其他企業入庫文件。

6.1.1生產企業入庫文件

1)生產企業入庫文件規范

規范定義如下:

<?xml version="1.0" encoding="UTF-8"?>

<DataList corpName (入庫企業名稱 字符型 必選) manCode (追溯設備廠商代碼 字符型 必選) datatype (數據類型 字符型 必選 固定值”wareHouseIn”) version (文件版本號 字符型 必選 目前為固定值“1.0”) xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="獸藥產品入庫數據_生產企業.xsd">

<Product productName

(產品通用名 字符型 必選) pzwh (產品批準文號 字符型 必選) packing (最小貼碼單位的包裝規格[包含單位][例如 質量單位:kg、g、mg;體積單位:l、ml;疫苗單位:頭份、羽份等] 字符型 必選)>

<Batch batchNo (批號 字符型 必選) specification (產品規格[包含單位] 字符型 必選) minPackUnit (最小包裝單位 字符型 必選) minTagUnit (最小貼碼單位 字符型 必選) tagPackRatio (最小貼碼單位與最小包裝單位的比例值 字符型 可選) tagRatio (貼碼包裝比例 字符型 必選) produceDate (生產日期 字符型 必選) operator (入庫操作員 字符型 可選) oprDate (入庫日期 字符型 必選) count (入庫數量 整型 可選) countUnit (數量單位 字符型 可選)>

<Data code (入庫追溯碼 字符型 必選)/>

……

</Batch>

……

</Product>

……

</DataList>

2)XML Schema規范

獸藥產品入庫數據(生產企業)的XML文件的Schema規范,結構如下:

各節點注釋如下表:

節點

名稱

節點

含義

節點屬性

下級

節點

DataList

文檔根節點

corpName:入庫企業名稱,必選

manCode:追溯設備廠商代碼,必選

dataType:數據類型,只能為“wareHouseIn”,必選

version:版本號,默認1.0,必選

Product

Product

DataList子節點,可出現多次,必須至少出現一次。其子元素為不同批號產品入庫數據

productName:產品通用名,必選

pzwh:產品批準文號,必選

packing:包裝規格,必選,[例如 質量單位:kg、g、mg;體積單位:l、ml;疫苗單位:頭份、羽份等]

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)生產企業入庫文件示例

<?xml version="1.0" encoding="UTF-8"?>

<DataList corpName="獸藥生產企業A" manCode="12345678" dataType="wareHouseIn" version="1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="獸藥產品入庫數據_生產企業.xsd">

<Product productName="獸藥產品A" pzwh="獸藥生字(2011)011230124 packing="5g">

<Batch batchNo="20121225" specification="10ml" minPackUnit="瓶" minTagUnit="瓶" tagPackRatio="1" tagRatio="1:4:40" produceDate="2012/12/25" operator="張三" oprDate="2012/12/25" >

<Data code="201902190000000004730163"/>

……

<Data code="201902190000000000940244"/>

<Data code="201902190000000000480125"/>

<Data code="201902190000000000510248"/>

……

<Data code="201902190000000000520213"/>

<Data code="201902190000000000550123"/>

<Data code="201902190000000000540143"/>

……

<Data code="201902190000000000530330"/>

<Data code="201902190000000000570162"/>

<Data code="201902190000000000580590"/>

……

<Data code="201902190000000000610500"/>

<Data code="201902190000000000620310"/>

<Data code="201902190000000000630235"/>

<Data code="201902190000000000640690"/>

……

<Data code="201902190000000000600198"/>

<Data code="201902190000000000650177"/>

<Data code="201902190000000000660156"/>

……

<Data code="201902190000000000680241"/>

<Data code="201902190000000000690500"/>

<Data code="201902190000000000700128"/>

      </Batch>

</Product>

<Product productName="獸藥產品B" pzwh="獸藥生字(2011)011230126" packing="5g">

<Batch batchNo="20121225" specification="10ml" minPackUnit="瓶" minTagUnit="瓶" tagPackRatio="10" tagRatio="1:4" produceDate="2012/12/25" operator="李四" oprDate="2012/12/25">

<Data code="201902190000000000730173"/>

<Data code="201902190000000000740300"/>

<Data code="201902190000000000750247"/>

<Data code="201902190000000000760218"/>

<Data code="201902190000000000770460"/>

</Batch>

</Product>

</DataList>

6.1.2其他企業入庫文件

其他企業含有經營企業、養殖場等非生產企業用戶。

其他企業入庫文件規范

規范定義如下:

<?xml version="1.0" encoding="UTF-8"?>

<DataList corpName (入庫企業名稱 字符型 必選) manCode (追溯設備廠商代碼 字符型 必選) datatype (數據類型 字符型 必選 固定值”wareHouseIn”) version (文件版本號 字符型 必選 目前為固定值“1.1”) xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="獸藥產品入庫數據_其他企業1.1.xsd">

<Product>

<Batch batchNo (批號/流水號 字符型 可選) operator (入庫操作員 字符型 可選) oprDate (入庫日期 字符型 必選)>

<Data code (入庫追溯碼 字符型 必選)/>

……

</Batch>

……

</Product>

</DataList>

2) XML Schema規范

獸藥產品入庫數據(其他企業)的XML文件的Schema規范,結構如下:

各節點注釋如下表:

節點名稱

節點含義

節點屬性

下級節點

DataList

文檔根節點

corpName:入庫企業名稱,必選

manCode:追溯設備廠商代碼,必選

dataType:數據類型,只能為“wareHouseIn”,必選

version:版本號,默認1.1,必選

Product

 

Product

DataList子節點,必須至少出現一次


Batch

Batch

Product子節點,可出現多次,必須至少出現一次。其子元素為企業入庫數據記錄

batchNo:批號/流水號,可選

operator:入庫操作員,

oprDate:入庫日期,必選,樣式為:YYYY/MM/DD

Data

Data

Batch子節點,可出現多次,必須至少出現一次。表示產品入庫數據記錄。

code: 入庫追溯碼,必選

 


 

3)其他企業入庫文件示例

<?xml version="1.0" encoding="UTF-8"?>

<DataList corpName="獸藥經營企業A" manCode="12345678" dataType="wareHouseIn" version="1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="獸藥產品入庫數據_其他企業1.1.xsd">

<Product>

<Batch batchNo="1" operator="張三" oprDate="2012/12/25">

<Data code="201902190000000000780183"/>

            </Batch>

<Batch batchNo="2" operator="張三" oprDate="2012/12/25">

<Data code="201902190000000000810197"/>

</Batch>

</Product>

</DataList>

6.2獸藥產品出庫數據文件

該接口文件為獸藥生產企業、經營企業等用戶導出獸藥產品出庫數據給追溯系統時使用。根據使用對象分為兩類,生產企業出庫文件、經營企業出庫文件。

1)獸藥產品出庫數據文件規范

規范定義如下:

<?xml version="1.0" encoding="UTF-8"?>

<DataList corpName (出庫企業名稱 字符型 必選) toUnitType (收貨單位種類[1;2][1-經營企業;2-其他] 字符型 必選) manCode (追溯設備廠商代碼 字符型 必選) datatype (數據類型 字符型 必選 固定值"wareHouseOut") version (文件版本號 字符型 必選 目前為固定值“1.1”) xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="獸藥產品出庫數據1.1.xsd">

<Product>

<Batch batchNo (批號 字符型 可選) operator (出庫操作員 字符型 ) oprDate (出庫日期 字符 必選) toProvince (收貨省份 字符型 必填) toCity (收貨市 字符型 必填) toCounty (收貨縣 字符型 必填) toUnit (具體收貨單位 字符型 必填) toUnitcode 收貨單位代碼 字符型 視收貨單位種類確定是否必選 >

<Data code (入庫追溯碼 字符型 必選)/>

……

</Batch>

……

</Product>

……

</DataList>

2)XML Schema規范

獸藥產品出庫數據的XML文件的Schema規范,結構如下:

各節點注釋如下表:

節點名稱

節點含義

節點屬性

下級節點

DataList

文檔根節點

corpName:出庫企業名稱,必選

toUnitType:收貨單位種類,必選,1為經營企業;2為其他

manCode:追溯設備廠商代碼,必選

dataType:數據類型,只能為wareHouseOut:必選

version:版本號,默認1.1,必選

Product

Product

DataList子節點,必須至少出現一次


Batch

Batch

Product子節點,可出現多次,必須至少出現一次。其子元素為企業出庫數據記錄

batchNo:批號,可選

operator:出庫操作員,可選

oprDate:出庫日期,必選,樣式為:YYYY/MM/DD

toProvince:收貨省份

toCity:收貨市

toCounty:收貨縣

toUnit:具體收貨單位

toUnitcode:具體收貨單位代碼

當toUnitType:收貨單位種類為1時,toProvince、toCity、toCounty、 toUnit、toUnitcode必填;當toUnitType:收貨單位種類為2時toProvince、toCity、toCounty、toUnit必填;toUnitcode非必選

Data

Data

Batch子節點,可出現多次,必須至少出現一次。表示產品出庫數據記錄

code:出庫追溯碼,必選

 




 

3)獸藥產品出庫數據文件示例

 

獸藥生產企業產品出庫數據文件示例(收貨單位為經營企業):

<?xml version="1.0" encoding="UTF-8"?>

<DataList corpName="獸藥生產企業A" toUnitType="1" manCode="12345678" dataType="wareHouseOut" version="1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="獸藥產品出庫數據1.1.xsd">

<Product>

<Batch batchNo="1" operator="張三" oprDate="2012/12/29"

 toProvince="新疆" toCity="喀什市" toCounty="葉城縣" toUnit="經營企業A" toUnitcode="8dh08ufj3209fhds" >

<Data code="190129000344445410327222" />

</Batch>

<Batch batchNo="2" operator="張三" oprDate="2012/12/30" toProvince="新疆" toCity="喀什市" toCounty="葉城縣" toUnit="經營企業B" toUnitcode="ci39fc5qr7rs30s4" 

<Data code="201902190000000000820232" />

<Data code="201902190000000000830280" />

</Batch>

</Product>

</DataList >

獸藥生產企業產品出庫數據文件示例(收貨單位為其他):

<?xml version="1.0" encoding="UTF-8"?>

<DataList corpName="獸藥生產企業A" toUnitType="2" manCode="12345678" dataType="wareHouseOut" version="1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="獸藥產品出庫數據1.1.xsd">

<Product>

<Batch batchNo="1" operator="張三" oprDate="2012/12/29" toProvince="新疆" toCity="喀什市" toCounty="葉城縣" toUnit="養殖場A" >

<Data code="190129000344445410327222" />

</Batch>

<Batch batchNo="2" operator="張三" oprDate="2012/12/30" toProvince="新疆" toCity="喀什市" toCounty="葉城縣" toUnit="養殖場B" >

<Data code="201902190000000000820232" />

<Data code="201902190000000000830280" />

</Batch>

</Product>

</DataList >

 

獸藥經營企業產品出庫數據文件示例:

<?xml version="1.0" encoding="UTF-8"?>

<DataList corpName="獸藥經營企業A" manCode="12345678" dataType="wareHouseOut" version="1.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="獸藥產品出庫數據1.1.xsd">

<Product>

<Batch batchNo="1" operator="張三" oprDate="2012/12/29" toProvince="新疆" toCity="喀什市" toCounty="葉城縣" toUnit="養殖場A">

<Data code="201902190000000000850700"/>

</Batch>

<Batch batchNo="2" operator="張三" oprDate="2012/12/30" toProvince="新疆" toCity="喀什市" toCounty="葉城縣" toUnit="養殖場B">

<Data code="201902190000000000860107"/>

<Data code="201902190000000000890242"/>

</Batch>

</Product>

</DataList>