農(nóng)畜產(chǎn)品質(zhì)量安全數(shù)據(jù)交換規(guī)范Specificationfordataexchangef2025-03-14發(fā)布2025-04-14實施內(nèi)蒙古自治區(qū)市場監(jiān)督管理局發(fā)布I 12規(guī)范性引用文件 13術語和定義 14信息交換原則 24.1統(tǒng)一性原則 24.2唯一性原則 24.3規(guī)范性原則 24.4可拓展性原則 25數(shù)據(jù)接口設計要求 25.1數(shù)據(jù)接口設計原則 25.2數(shù)據(jù)接口基本要求 25.3數(shù)據(jù)接口協(xié)議 35.4數(shù)據(jù)接口功能 36追溯數(shù)據(jù)交換內(nèi)容 36.1數(shù)據(jù)元 36.2數(shù)據(jù)交換格式 36.3數(shù)據(jù)記錄 37接口安全 57.1安全認證 57.2數(shù)字令牌 57.3傳輸安全 57.4數(shù)據(jù)加密 5本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起本文件由內(nèi)蒙古自治區(qū)農(nóng)牧廳歸口。本文件起草單位：內(nèi)蒙古自治區(qū)農(nóng)畜產(chǎn)品質(zhì)量安全中心、內(nèi)蒙古自治區(qū)質(zhì)量和標準化研究院、錫林郭勒盟農(nóng)畜產(chǎn)品質(zhì)量安全監(jiān)測中心、烏蘭察布市農(nóng)牧局、呼和浩特市農(nóng)牧局、鄂爾多斯市農(nóng)畜產(chǎn)品質(zhì)量安全中心、烏蘭察布市農(nóng)畜產(chǎn)品質(zhì)量安全中心、巴彥淖爾市農(nóng)牧局、達拉特旗農(nóng)畜產(chǎn)品質(zhì)量安全中心、察哈爾右翼前旗農(nóng)畜產(chǎn)品質(zhì)量安全檢驗檢測站、成都曙光光纖網(wǎng)絡有限責任公司、東河區(qū)農(nóng)牧林草事業(yè)發(fā)展中心、扎蘭屯市農(nóng)畜產(chǎn)品質(zhì)量安全中心、準格爾旗農(nóng)畜產(chǎn)品安全與生態(tài)資源保護中心、呼和浩特市文化旅游廣電局綜合保障中心、扎賚特旗農(nóng)畜產(chǎn)品質(zhì)量安全中心。本文件主要起草人：云巖春、許大偉、李超、伊日貴、畢力格、顧海濤、趙雪、李剛、楊佳慧、曾大章、李強、曹志偉、奇寶力格、杜建云、特日格樂、任膺潔、于潔、于婷婷、閆肅、王靜、王慧娟、郭春暉、郝貴賓、于海東、張欣昕、萬通、趙波、馬德惠、李佳、徐靜、王麗霞、張妍、曹士安、鄧貴權。1農(nóng)畜產(chǎn)品質(zhì)量安全數(shù)據(jù)交換規(guī)范1范圍本文件規(guī)定了農(nóng)畜產(chǎn)品質(zhì)量安全數(shù)據(jù)交換規(guī)范的信息交換原則、數(shù)據(jù)接口設計要求、追溯數(shù)據(jù)交換內(nèi)容、接口安全。本文件適用于農(nóng)畜產(chǎn)品追溯系統(tǒng)之間信息交換的規(guī)劃、設計、系統(tǒng)開發(fā)以及運行維護管理。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T7408.1日期和時間信息交換表示法第1部分：基本原則GB/T36478.4物聯(lián)網(wǎng)信息交換和共享第4部分：數(shù)據(jù)接口GB/T38672信息技術大數(shù)據(jù)接口基本要求GB/T40094.3電子商務數(shù)據(jù)交易第3部分：數(shù)據(jù)接口規(guī)范GB/T44583重要產(chǎn)品追溯追溯碼編碼規(guī)范NY/T3177農(nóng)產(chǎn)品分類與代碼3術語和定義下列術語和定義適用于本文件。責任主體thesubjectofresponsibility農(nóng)畜產(chǎn)品生產(chǎn)、收購、貯藏、運輸過程中對質(zhì)量安全負有直接責任的自然人或法人。追溯系統(tǒng)中對追溯單元進行唯一標識的代碼。在農(nóng)畜產(chǎn)品生產(chǎn)過程中投入使用的各種物品和要素，包括農(nóng)資類、其他生產(chǎn)資料類、飼料類、獸藥類、疫苗類等。農(nóng)畜產(chǎn)品追溯系統(tǒng)之間互相發(fā)送、傳輸和接收數(shù)據(jù)的過程。DB15/T3952-20252在產(chǎn)品或服務的全生命周期中能夠反映質(zhì)量水平和安全程度，保障其符合質(zhì)量和安全要求相關的依據(jù)。4信息交換原則4.1統(tǒng)一性原則各信息系統(tǒng)進行數(shù)據(jù)交換時追溯碼編碼應按照GB/T44583的要求。4.2唯一性原則追溯碼編碼與農(nóng)畜產(chǎn)品追溯單元一一對應。4.3規(guī)范性原則按照規(guī)范格式確定信息交換的內(nèi)容和數(shù)據(jù)格式，見表1、表2。4.4可拓展性原則各信息系統(tǒng)之間可根據(jù)實際需要確定擴展信息。5數(shù)據(jù)接口設計要求5.1數(shù)據(jù)接口設計原則接口設計應遵循高內(nèi)聚、低耦合的設計原則，降低復雜度，提高系統(tǒng)的擴展性，保證實際運用中的便捷性和通用性。應符合以下要求：a)宜采用GB/T38672的規(guī)定，實現(xiàn)系統(tǒng)間的松耦合；b)充分考慮接口所涉及的各個系統(tǒng)的應用擴展情況，確保靈活地支撐需求變化；保證接口數(shù)據(jù)在各個系統(tǒng)間的一致性；c)在數(shù)據(jù)交互過程中，應具有傳送和接收后的確認過程；d)使用簡單、快捷、通用性好、可靠性高。5.2數(shù)據(jù)接口基本要求農(nóng)畜產(chǎn)品追溯數(shù)據(jù)接口通過服務調(diào)用獲取所需的信息，應符合下列要求：a)采用IETFRFC2818的HTTPS協(xié)議作為底層承載協(xié)議；b)采用IETFRFC3629規(guī)定的UTF-8字符集；c)采用GB/T7408.1規(guī)定的日期類型；d)采用IETFRFC3548規(guī)定的Base64編碼規(guī)則將圖片、文件二進制字節(jié)流轉(zhuǎn)換為字符串；e)接口響應宜采用IETFRFC4627規(guī)定的JSON數(shù)據(jù)格式；f)建立接口日志記錄，能識別數(shù)據(jù)異?；蜃匪萁粨Q數(shù)據(jù)情況；g)發(fā)生錯誤時，接口將詳細的錯誤代碼和錯誤信息返回給接口使用方，以利于接口使用方進行記錄分析和整改。3DB15/T3952-20255.3數(shù)據(jù)接口協(xié)議數(shù)據(jù)接口協(xié)議宜符合RESTful風格接口的方式進行相互通信。符合RESTful風格的接口采用基于HTTP/HTTPS的簡單訪問方法GET、POST等。數(shù)據(jù)庫接口方式應符合GB/T36478.4和GB/T40094.3的要求。5.4數(shù)據(jù)接口功能接口宜具有Web服務的注冊、發(fā)布、管理、監(jiān)控等功能。6追溯數(shù)據(jù)交換內(nèi)容6.1數(shù)據(jù)元包括農(nóng)畜產(chǎn)品質(zhì)量安全追溯系統(tǒng)中設計的各個數(shù)據(jù)元的名稱、標識、數(shù)據(jù)類型、數(shù)據(jù)格式、說明以及性質(zhì)，具體描述如下：a)名稱：描述追溯數(shù)據(jù)的技術語言；b)標識：唯一代表某一個數(shù)據(jù)元的標識符；c)數(shù)據(jù)類型：數(shù)據(jù)元的存儲類型；d)數(shù)據(jù)格式：描述數(shù)據(jù)元的長度或精度、表示格式，其中代表日期的數(shù)據(jù)元統(tǒng)一采用GB/T7408.1的表示方法；e)說明：對數(shù)據(jù)元的簡單描述；f)性質(zhì)：表示數(shù)據(jù)元與農(nóng)畜產(chǎn)品質(zhì)量安全的相關性，分為重要、一般。6.2數(shù)據(jù)交換格式采用JSON或XML可擴展標記語言確定數(shù)據(jù)交換格式。6.3數(shù)據(jù)記錄農(nóng)畜產(chǎn)品追溯數(shù)據(jù)記錄主要包括產(chǎn)品追溯信息、責任主體信息、品種信息、用藥信息、疫苗信息、飼料信息、其他投入品信息、產(chǎn)品檢測信息和包裝信息等。以產(chǎn)品追溯信息和責任主體信息為例，見表1、表6.3.1產(chǎn)品信息記錄農(nóng)畜產(chǎn)品追溯信息的數(shù)據(jù)元素，如表1所示。表1農(nóng)畜產(chǎn)品追溯主要數(shù)據(jù)元數(shù)據(jù)類型說明性質(zhì)唯一標識某一追溯單元的農(nóng)畜產(chǎn)品責任主體編碼責任主體的唯一標識畜產(chǎn)品類別代碼4表1農(nóng)畜產(chǎn)品追溯主要數(shù)據(jù)元(續(xù))數(shù)據(jù)類型說明性質(zhì)日期其他有關責任主體的信息<Tracing_code></Traci<Responsible_entity_code></Responsible_entity_code><Classification_and_coding_of_agricultural_and_livestock_products></Clasand_coding_of_agricultural_and_livesto<Name_of_agricultural_and_livestock_products></Name_of_agricultural_and<Place_of_origin></Place_of<Processing_site></Processi<Processing_date></Processi數(shù)據(jù)類型說明性質(zhì)責任主體名稱責任主體的中文名稱，自然人為責任主體時為姓名責任主體編碼責任主體統(tǒng)一社會信信用體時為身份證號或護照號。責任主體類型人三種法人代表身份證、護照號，責任主體為自然人時聯(lián)系人姓名責任主體的聯(lián)系人姓名長度11責任主體地址其他有關責任主體的信息56.3.4責任主體XML格式<The_name_of_the_responsible_subject></The_name_of_the_responsib<Responsible_entity_code></Responsible_entity_code><The_type_of_responsibility_body></The_type_of_responsibil<Legal_representative></Legal_repre<Name_of_contact_person></Name_of_contac<Contact_phone></Contac7接口安全7.1安全認證數(shù)據(jù)接口安全認證應按照GB/T40094.3的要求。7.2數(shù)字令牌數(shù)據(jù)接口調(diào)用者應向數(shù)據(jù)接口服務提供方申請數(shù)字令牌，數(shù)字令牌通常包含appKey和appSecret兩部分，appKey是調(diào)用者身份的標識，appSecret是調(diào)用