DB15T 3952-2025農(nóng)畜產(chǎn)品質(zhì)量安全數(shù)據(jù)交換規(guī)范

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