食品安全電子追溯數(shù)據(jù)交換接口規(guī)范

1食品安全電子追溯數(shù)據(jù)交換接口規(guī)范本標(biāo)準(zhǔn)規(guī)定了食品安全電子追溯數(shù)據(jù)交換的數(shù)據(jù)接口要求和數(shù)據(jù)接口參數(shù)。本標(biāo)準(zhǔn)適用于食品安全電子追數(shù)據(jù)交換和接口實(shí)現(xiàn)。2規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T7027信息分類和編碼的基本原則與方法GB/T7635.1全國主要產(chǎn)品分類與代碼第1部分:可運(yùn)輸產(chǎn)品(上、下)GB12904商品條碼零售商品編碼與條碼表示NY/T1430農(nóng)產(chǎn)品產(chǎn)地編碼規(guī)則RFC1738統(tǒng)一資源定位符（URL）通用語法（Uniformresourcelocators(URL)）RFC1945超文本傳輸協(xié)議-HTTP/1.0（Hypertexttransferprotocol-HTTP/1.0）RFC2616超文本傳輸協(xié)議-HTTP/1.1（Hypertexttransferprotocol-HTTP/1.1）RFC4627JSON格式定義（Theapplication/JSONmediaTypeforjavascriptobjectnotation）RFC4825可擴(kuò)展標(biāo)記語言配置接入?yún)f(xié)議（Theextensiblemarkuplanguage(XML)configurationaccessprotocol(XCAP)）3術(shù)語和定義GB/T22000、GB/T22005、GB/T25008確立的以及下列術(shù)語和定義適用于本文件。為了便于使用，以下重復(fù)列出了GB/T22000、GB/T22005、GB/T25008中的某些術(shù)語和定義。3.1網(wǎng)元networkelement由軟硬件共同組成的能實(shí)現(xiàn)網(wǎng)絡(luò)中的一種或多種邏輯功能的邏輯單元。3.2IRS網(wǎng)元identificationresolutionservicenetworkelement提供追溯標(biāo)識注冊和追溯標(biāo)識解析服務(wù)的網(wǎng)元。3.3IQS網(wǎng)元informationqueryservicenetworkelement提供可視化追溯信息查詢服務(wù)的網(wǎng)元。3.42DB32/TXXXX—2018DCS網(wǎng)元datacatalogservicenetworkelement以追溯標(biāo)識為單位提供追溯路徑的建立和查詢服務(wù)的網(wǎng)元。3.5追溯代理traceabilityproxy以用戶發(fā)起的HTTP追溯查詢請求為觸發(fā)，代替追溯用戶調(diào)用IRS,DCS和IQS網(wǎng)元的多個(gè)接口完成追溯查詢邏輯功能的網(wǎng)元。3.6EU網(wǎng)元endusernetworkelement終端用戶所使用的具備追溯查詢能力的軟件系統(tǒng)的統(tǒng)稱。3.7CU網(wǎng)元captureunitnetworkelement負(fù)責(zé)采集主數(shù)據(jù)、交易數(shù)據(jù)和事件數(shù)據(jù)并提交到IQS網(wǎng)元，完成數(shù)據(jù)采集功能的網(wǎng)元。3.8SP網(wǎng)元SupervisorPlatformNetworkElement接收IQS網(wǎng)元上報(bào)的追溯數(shù)據(jù)，支撐政府監(jiān)管人員利用追溯數(shù)據(jù)開展對企業(yè)監(jiān)管的網(wǎng)元。3.9投入產(chǎn)出input-output食品生產(chǎn)企業(yè)所生產(chǎn)的產(chǎn)品生產(chǎn)投入和使用去向的情況。4縮略語CU：捕獲單元(CaptureUnit)DNS：域名服務(wù)(DomainNameService)DCS：數(shù)據(jù)目錄服務(wù)(DataCatalogService)EU：終端用戶(EndUser)GTIN：全球貿(mào)易項(xiàng)目代碼(GlobalTradeItemNumber)IQS：信息查詢服務(wù)(InformationQueryService)IRS：標(biāo)識解析服務(wù)(IdentificationResolutionService)JSON：JS對象標(biāo)記(JavaScriptObjectNotation)RFID：射頻識別(RadioFrequencyIdentification)SP：監(jiān)管平臺(SupervisorPlatform)URI：統(tǒng)一資源標(biāo)識符(UniformResourceIdentifier)URL：統(tǒng)一資源定位符(UniformResourceLocator)URN：統(tǒng)一資源名稱(UniformResourceName)XML：可擴(kuò)展標(biāo)記語言(ExtensibleMarkupLanguage)5追溯系統(tǒng)35.1系統(tǒng)架構(gòu)5.1.1概述食品安全電子追溯系統(tǒng)應(yīng)由企業(yè)平臺、查詢平臺、監(jiān)管平臺組成。食品安全電子追溯系統(tǒng)的系統(tǒng)架構(gòu)見DB32/TXXXX。企業(yè)應(yīng)確保食品鏈的可追溯性，并通過建設(shè)符合框架規(guī)定的相關(guān)接口的企業(yè)平臺，加入食品安全電子追溯系統(tǒng)。，食品安全電子追溯數(shù)據(jù)交換結(jié)構(gòu)圖見圖1。圖1食品安全電子追溯數(shù)據(jù)交換結(jié)構(gòu)圖5.1.2網(wǎng)元基本要求IQS網(wǎng)元應(yīng)提供追溯信息傳輸、查詢服務(wù)和數(shù)據(jù)上報(bào)服務(wù)的功能。SP網(wǎng)元應(yīng)部署在監(jiān)管部門的服務(wù)器系統(tǒng)上，SP網(wǎng)元應(yīng)支撐利用追溯數(shù)據(jù)開展對企業(yè)的監(jiān)管功5.2基本功能食品安全電子追溯數(shù)據(jù)交換主要包括IQS網(wǎng)元、SP網(wǎng)元和與SP網(wǎng)元進(jìn)行數(shù)據(jù)交換的其他平臺。其中：a)IQS網(wǎng)元只進(jìn)行數(shù)據(jù)上報(bào)，不進(jìn)行數(shù)據(jù)獲取。b)與SP網(wǎng)元進(jìn)行數(shù)據(jù)交換的主要為各政府監(jiān)管部門及權(quán)威認(rèn)證的檢驗(yàn)檢測機(jī)構(gòu)，如與各市監(jiān)管部門進(jìn)行食品生產(chǎn)數(shù)據(jù)交換、與農(nóng)副產(chǎn)品物流中心及農(nóng)業(yè)部農(nóng)副產(chǎn)品質(zhì)量安全監(jiān)督平臺進(jìn)行大宗農(nóng)副產(chǎn)品追溯數(shù)據(jù)的交換。6數(shù)據(jù)接口6.1數(shù)據(jù)交換流程數(shù)據(jù)交換流程見圖2。4DB32/TXXXX—2018圖2食品安全電子追溯數(shù)據(jù)交換流程交換流程為：a)交換數(shù)據(jù)請求方向交換數(shù)據(jù)提供方發(fā)起數(shù)據(jù)交換查詢請求；b)交換數(shù)據(jù)提供方按照請求方的權(quán)限，進(jìn)行權(quán)限審核，返回請求方在所屬權(quán)限下可同步的數(shù)據(jù)情c)交換數(shù)據(jù)請求方發(fā)起數(shù)據(jù)交換請求；d)交換數(shù)據(jù)提供方按照請求方的權(quán)限，返回?cái)?shù)據(jù)交換響應(yīng)結(jié)果。6.2調(diào)用方式6.2.1概述數(shù)據(jù)交換內(nèi)容統(tǒng)一采用XML的形式進(jìn)行描述，每個(gè)交換XML文件中的記錄數(shù)以不影響XML文件解析性能為宜。6.2.2請求請求接口應(yīng)通過RFC1945或RFC2616中規(guī)定的HTTP請求，使用Get或者Post方法調(diào)用數(shù)據(jù)交換權(quán)限和數(shù)據(jù)交換請求接口。請求接口將請求參數(shù)按照消息格式用JSON封裝后，包含在HTTP的Request消息的Body中發(fā)送給對方。6.2.3響應(yīng)請求接口調(diào)用成功或失敗以后，應(yīng)以RFC4825中規(guī)定的XML或RFC4627中規(guī)定的JSON格式將處理結(jié)果放置在HTTP的Response消息的Body中，返回給調(diào)用者。HTTP的Response消息應(yīng)符合RFC1945或RFC2616中的要求。6.3數(shù)據(jù)交換格式數(shù)據(jù)交換的XML報(bào)文數(shù)據(jù)格式為：5<?xmlversion="1.0"encoding="UTF-8"?><entitysxmlns:xsi="/2001/XMLSchema-instance"xmlns:xsd="/2001/XMLSchema"Version="3.0"><entity><property>value</property><property>value</property></entity><entity><property>value</property><property>value</property></entity></entitys>其中，entity應(yīng)填寫交換數(shù)據(jù)內(nèi)容，見表1。property字段應(yīng)填寫交換數(shù)據(jù)內(nèi)容應(yīng)交換的參數(shù)，參數(shù)名稱見表3至表15，value字段應(yīng)按符合交換數(shù)據(jù)內(nèi)容參數(shù)類型要求，見表3至表15。表1交換數(shù)據(jù)內(nèi)容標(biāo)識entityAgriculturalProductionBe6.4基本數(shù)據(jù)類型說明使用的基本數(shù)據(jù)類型定義見表2，應(yīng)對接口傳輸消息中JSON或XML格式的文本內(nèi)容做限定。表2基本數(shù)據(jù)類型定義說明6DB32/TXXXX—20186.5參數(shù)要求6.5.1生產(chǎn)數(shù)據(jù)參數(shù)企業(yè)基本數(shù)據(jù)參數(shù)主要與各市監(jiān)管平臺等機(jī)構(gòu)進(jìn)行企業(yè)基本數(shù)據(jù)交換，交換參數(shù)見表3。表3企業(yè)基本信息數(shù)據(jù)是是否否原料進(jìn)廠數(shù)據(jù)參數(shù)主要與各市監(jiān)管平臺等機(jī)構(gòu)進(jìn)行原料進(jìn)廠數(shù)據(jù)交換，交換參數(shù)見表4。表4原料進(jìn)廠數(shù)據(jù)是6是是否否否是是是是是否6否否6否否wareHouseCode是7表4原料進(jìn)廠數(shù)據(jù)（續(xù)）wareHouseName是否否是否否否6是是是原料自檢數(shù)據(jù)主要與各市監(jiān)管平臺等機(jī)構(gòu)進(jìn)行原料自檢數(shù)據(jù)交換，交換參數(shù)見表5。表5原料自檢數(shù)據(jù)是是是是6是是是否/是投入產(chǎn)出數(shù)據(jù)主要與各市監(jiān)管平臺等機(jī)構(gòu)進(jìn)行投入產(chǎn)出數(shù)據(jù)交換，交換參數(shù)見表6。表6投入產(chǎn)出數(shù)據(jù)是是8DB32/TXXXX—2018表6投入產(chǎn)出數(shù)據(jù)（續(xù)）是是否否是是是workshopNumber否否否生產(chǎn)線（班組）號productionLineHeadP否List<inputOutputItme/是出廠檢驗(yàn)數(shù)據(jù)主要與各市監(jiān)管平臺等機(jī)構(gòu)進(jìn)行出廠檢驗(yàn)數(shù)據(jù)交換，交換參數(shù)見表7。表7出廠檢驗(yàn)數(shù)據(jù)是是是否6是是是是否/是出廠銷售數(shù)據(jù)主要與各市監(jiān)管平臺等機(jī)構(gòu)進(jìn)行出廠銷售數(shù)據(jù)交換，交換參數(shù)見表8。9表8出廠銷售數(shù)據(jù)是是是是是是否否否否批次、單品信息數(shù)據(jù)主要與各市監(jiān)管平臺等機(jī)構(gòu)進(jìn)行批次、單品信息數(shù)據(jù)交換，交換參數(shù)見表9。表9批次、單品信息數(shù)據(jù)是是是否否產(chǎn)品召回事件數(shù)據(jù)主要與各市監(jiān)管平臺等機(jī)構(gòu)進(jìn)行產(chǎn)品召回事件數(shù)據(jù)交換，交換參數(shù)見表10。表10產(chǎn)品召回事件數(shù)據(jù)是是是是是否否是DB32/TXXXX—2018表10產(chǎn)品召回事件數(shù)據(jù)（續(xù)）填是產(chǎn)品召回跟蹤數(shù)據(jù)主要與各市監(jiān)管平臺等機(jī)構(gòu)進(jìn)行產(chǎn)品召回跟蹤數(shù)據(jù)交換，交換參數(shù)見表11。表11產(chǎn)品召回跟蹤數(shù)據(jù)是是是是是是否否否是否6.5.2食品安全風(fēng)險(xiǎn)監(jiān)測數(shù)據(jù)參數(shù)主要與疾控中心等機(jī)構(gòu)進(jìn)行食品安全風(fēng)險(xiǎn)監(jiān)測數(shù)據(jù)交換，交換參數(shù)見表13。表12食源性疾控?cái)?shù)據(jù)是否是是是否是是是表12食源性疾控?cái)?shù)據(jù)（續(xù)）填/是是是是是是是是6.5.3檢驗(yàn)檢測數(shù)據(jù)參數(shù)主要與各檢驗(yàn)檢測機(jī)構(gòu)進(jìn)行檢驗(yàn)檢測數(shù)據(jù)交換，交換參數(shù)見表13。表13檢驗(yàn)項(xiàng)目數(shù)據(jù)是否是否否是否是是是否是是是是是否/是6.5.4大宗農(nóng)副產(chǎn)品追溯數(shù)據(jù)參數(shù)DB32/TXXXX—2018主要與農(nóng)副產(chǎn)品物流中心、農(nóng)產(chǎn)品質(zhì)量安全監(jiān)督平臺等機(jī)構(gòu)進(jìn)行大宗農(nóng)副產(chǎn)品追溯數(shù)據(jù)交換，交換參數(shù)見表14。表14大宗農(nóng)副產(chǎn)品追溯數(shù)據(jù)是是是是是是是是種植(養(yǎng)殖)基地編碼，符合NY/T1430的要求/是是/是是是否是是/是是否是是（規(guī)范性附錄）編碼規(guī)則表A.1至表A.4給出了標(biāo)準(zhǔn)使用到的編碼規(guī)則。表A.1原料產(chǎn)品分類編碼123表A.2檢驗(yàn)情況編碼123表A.3自行檢驗(yàn)情況編碼123表A.4檢驗(yàn)結(jié)論編碼123DB32/TXXXX—2018BA（規(guī)范性附錄）數(shù)據(jù)結(jié)構(gòu)定義B.1投放明細(xì)數(shù)據(jù)類型inputOutputItmestype定義數(shù)據(jù)明細(xì)數(shù)據(jù)類型inputOutputItmestype定義見表B.1。表B.1投放明細(xì)數(shù)據(jù)類型inputOutputItmestype定義是是6是是是是否wareHouseName否否否否B.2檢驗(yàn)檢測數(shù)據(jù)類型checkdatatype定義檢驗(yàn)檢測數(shù)據(jù)類型checkdatatype定義見表B.2。表B.2檢驗(yàn)檢測數(shù)據(jù)類型checkdatatype定義是是是否否否B.3肥料施用明細(xì)數(shù)據(jù)類型FertilizersType定義肥料施用明細(xì)數(shù)據(jù)類型FertilizersType定義見表B.3。表B.3肥料施用明細(xì)數(shù)據(jù)類型FertilizersType定義是是是是否