食品安全電子追溯標(biāo)識解析服務(wù)數(shù)據(jù)接口規(guī)范

1食品安全電子追溯標(biāo)識解析服務(wù)數(shù)據(jù)接口規(guī)范本標(biāo)準(zhǔn)規(guī)定了食品安全電子追溯標(biāo)識解析服務(wù)的功能要求和數(shù)據(jù)接口。本標(biāo)準(zhǔn)適用于食品安全電子追溯標(biāo)識解析服務(wù)的接口實現(xiàn)。2規(guī)范性引用文件下列文件對于本文件的應(yīng)用是必不可少的。凡是注日期的引用文件，僅注日期的版本適用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB12904商品條碼零售商品編碼與條碼表示RFC1945超文本傳輸協(xié)議1.0(Hypertexttransferprotocol--HTTP/1.0)RFC2616超文本傳輸協(xié)議1.1(Hypertexttransferprotocol--HTTP/1.1)RFC4627JSON格式定義(Theapplication/JSONmediatypeforjavascriptobjectnotation)RFC4825可擴展標(biāo)記語言配置接入?yún)f(xié)議(Theextensiblemarkuplanguage(XML)configurationaccessprotocol(XCAP))3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1標(biāo)識解析服務(wù)identificationresolutionservice將物品的追溯標(biāo)識翻譯成物品所歸屬的數(shù)據(jù)目錄服務(wù)器URL地址的過程。3.2數(shù)據(jù)目錄服務(wù)datacatalogservice以物品的追溯標(biāo)識為索引建立物品所流經(jīng)的信息查詢服務(wù)器URL地址列表的過程。3.3信息查詢服務(wù)informationqueryservice向數(shù)據(jù)目錄服務(wù)器注冊追溯標(biāo)識，并以格式化的數(shù)據(jù)結(jié)構(gòu)向追溯代理提供追溯信息查詢的過程。3.4網(wǎng)元networkelement由軟硬件共同組成的能實現(xiàn)網(wǎng)絡(luò)中的一種或多種邏輯功能的邏輯單元。3.52DB32/TXXXX—2018IRS網(wǎng)元identificationresolutionservicenetworkelement提供追溯標(biāo)識注冊和追溯標(biāo)識解析服務(wù)的網(wǎng)元。3.6IQS網(wǎng)元informationqueryservicenetworkelement提供可視化追溯信息查詢服務(wù)的網(wǎng)元。3.7DCS網(wǎng)元datacatalogservicenetworkelement以追溯標(biāo)識為單位提供追溯路徑的建立和查詢服務(wù)的網(wǎng)元。3.8追溯代理traceabilityproxy以用戶發(fā)起的HTTP追溯查詢請求為觸發(fā)，代替追溯用戶調(diào)用IRS,DCS和IQS網(wǎng)元的多個接口完成追溯查詢邏輯功能的網(wǎng)元。3.9EU網(wǎng)元endusernetworkelement終端用戶所使用的具備追溯查詢能力的軟件系統(tǒng)的統(tǒng)稱。3.10CU網(wǎng)元captureunitnetworkelement負(fù)責(zé)采集主數(shù)據(jù)、交易數(shù)據(jù)和事件數(shù)據(jù)并提交到IQS網(wǎng)元，完成數(shù)據(jù)采集功能的網(wǎng)元。3.11SP網(wǎng)元SupervisorPlatformNetworkElement接收IQS網(wǎng)元上報的追溯數(shù)據(jù)，支撐政府監(jiān)管人員利用追溯數(shù)據(jù)開展對企業(yè)監(jiān)管的網(wǎng)元。4縮略語下列縮略語適用于本文件。CU：捕獲單元(CaptureUnit)DNS：域名服務(wù)(DomainNameService)DCS：數(shù)據(jù)目錄服務(wù)(DataCatalogService)EU：終端用戶(EndUser)GTIN：全球貿(mào)易項目代碼(GlobalTradeItemNumber)IQS：信息查詢服務(wù)(InformationQueryService)IRS：標(biāo)識解析服務(wù)(IdentificationResolutionService)JSON：JS對象標(biāo)記(JavaScriptObjectNotation)RFID：射頻識別(RadioFrequencyIdentification)SP：監(jiān)管平臺(SupervisorPlatform)URL：統(tǒng)一資源定位符(UniformResourceLocator)3URN：統(tǒng)一資源名稱(UniformResourceName)XML：可擴展標(biāo)記語言(ExtensibleMarkupLanguage)5功能要求5.1系統(tǒng)架構(gòu)5.1.1總則食品安全電子追溯系統(tǒng)應(yīng)由企業(yè)平臺、監(jiān)管平臺和查詢平臺組成。企業(yè)應(yīng)確保食品鏈的可追溯性，并通過建設(shè)符合本框架規(guī)定的相關(guān)接口的企業(yè)平臺，加入食品安全電子追溯系統(tǒng)。食品安全電子追溯系統(tǒng)的系統(tǒng)架構(gòu)見圖1。圖1食品安全電子追溯系統(tǒng)結(jié)構(gòu)5.1.2網(wǎng)元要求IRS網(wǎng)元應(yīng)對外提供追溯標(biāo)識注冊和追溯標(biāo)識解析服務(wù)。DCS網(wǎng)元應(yīng)以追溯標(biāo)識為單位提供追溯路徑的建立和查詢的服務(wù)。DCS網(wǎng)元應(yīng)以追溯標(biāo)識為標(biāo)識確保物品的可追溯性。IQS網(wǎng)元應(yīng)提供追溯信息捕獲、查詢服務(wù)和數(shù)據(jù)上報服務(wù)的功能。CU網(wǎng)元應(yīng)通過條碼識讀設(shè)備和RFID讀寫器等數(shù)據(jù)采集設(shè)備實現(xiàn)采集一維碼、二維碼、RFID標(biāo)簽等信息的功能。EU網(wǎng)元功能應(yīng)信息終端設(shè)備上實現(xiàn)；EU網(wǎng)元應(yīng)向用戶提供追溯的交互式人機界面。SP網(wǎng)元應(yīng)部署在監(jiān)管部門的服務(wù)器系統(tǒng)上，SP網(wǎng)元應(yīng)實現(xiàn)支撐利用追溯數(shù)據(jù)開展對企業(yè)的監(jiān)管功能。追溯代理應(yīng)以用戶發(fā)起的追溯請求為觸發(fā)，代替用戶完成追溯系統(tǒng)的內(nèi)部業(yè)務(wù)處理。5.2基本服務(wù)功能4DB32/TXXXX—2018IRS網(wǎng)元應(yīng)提供但不限于以下功能：a)追溯標(biāo)識注冊功能；b)追溯標(biāo)識解析功能。6數(shù)據(jù)接口6.1基本要求食品安全電子追溯系統(tǒng)的各個網(wǎng)元之間應(yīng)通過Internet公共以太網(wǎng)接口互聯(lián)互通。各網(wǎng)元的物理接口上承載的協(xié)議棧應(yīng)為HTTP或HTTPS協(xié)議棧，數(shù)據(jù)接口應(yīng)使用基于HTTP/HTTPS協(xié)議的JSON格式的消息體傳輸數(shù)據(jù)。IRS網(wǎng)元和其它各個網(wǎng)元之間應(yīng)通過數(shù)據(jù)接口進行消息交互，實現(xiàn)IRS網(wǎng)元的功能。這些具體接口包括：a)IRS解析查詢接口；b)IRS標(biāo)識管理接口。6.2接口原語基于服務(wù)的方式定義數(shù)據(jù)接口的使用方法。服務(wù)響應(yīng)流程使用了“請求-Request”“指示-Indication”“響應(yīng)-Response”“確認(rèn)-Confirm”四條服務(wù)原語，原語的順序見圖2。圖2服務(wù)響應(yīng)流程IRS網(wǎng)元的服務(wù)接口分為：a)IRS標(biāo)識管理接口；b)IRS解析查詢接口。IRS標(biāo)識管理接口應(yīng)包括：a)DCS網(wǎng)元登陸接口；b)DCS網(wǎng)元注冊接口；c)IRS標(biāo)識注冊接口；5d)IRS標(biāo)識更新接口；e)IRS標(biāo)識刪除接口。IRS解析查詢接口只包括IRS標(biāo)識解析接口的一個接口。6.3數(shù)據(jù)類型IRS網(wǎng)元接口中所使用到的數(shù)據(jù)類型見表1。表1數(shù)據(jù)類型說明6.4調(diào)用方式6.4.1請求請求接口應(yīng)通過RFC1945或RFC2616中規(guī)定的HTTP請求，使用Get或者Post方法調(diào)用食品電子追溯目錄服務(wù)接口。請求接口將請求參數(shù)按照消息格式用JSON封裝后，包含在HTTP的Request消息的Body中發(fā)送給對方。6.4.2響應(yīng)請求接口調(diào)用成功或失敗以后，IRS網(wǎng)元應(yīng)以RFC4825中規(guī)定的XML或RFC4627中規(guī)定的JSON格式將處理結(jié)果放置在HTTP的Response消息的Body中，返回給調(diào)用者。HTTP的Response消息應(yīng)符合RFC1945或RFC2616中的要求。6.5參數(shù)要求6.5.1IRS標(biāo)識解析接口基本要求追溯代理網(wǎng)元應(yīng)通過IRS標(biāo)識解析接口向IRS網(wǎng)元發(fā)送需要解析的物品標(biāo)識，并從IRS網(wǎng)元獲得該被追溯產(chǎn)品歸屬的DCS網(wǎng)元的URL地址信息。該接口示例參見附錄B.1。接口參數(shù)該接口名稱為IRS_ID_Resolute。IRS標(biāo)識解析請求接口參數(shù)見表2，IRS標(biāo)識解析響應(yīng)接口參數(shù)見表3。表2IRS標(biāo)識解析請求接口參數(shù)6DB32/TXXXX—2018是是否是否否否表3IRS標(biāo)識解析響應(yīng)接口參數(shù)是是否6.5.2DCS網(wǎng)元登陸接口基本要求DCS網(wǎng)元應(yīng)先通過DCS網(wǎng)元登陸接口對DCS網(wǎng)元進行認(rèn)證，并由IRS網(wǎng)元授予DCS網(wǎng)元相應(yīng)的權(quán)限。IRS網(wǎng)元在對DCS網(wǎng)元的用戶名和密碼認(rèn)證通過以后，應(yīng)將會話ID返回給DCS，后續(xù)DCS通過會話ID與IRS網(wǎng)元進行數(shù)據(jù)交互。IRS網(wǎng)元應(yīng)刪除長期不用的空閑會話ID，空間會話ID的保留時間由IRS網(wǎng)元的管理策略決定。該接口示例參見附錄B.2。接口參數(shù)該接口名稱為IRS_DCS_Login，DCS網(wǎng)元登陸請求接口參數(shù)見表4，DCS網(wǎng)元登陸響應(yīng)接口參數(shù)見表5。表4DCS網(wǎng)元登陸請求接口參數(shù)是是是表5DCS網(wǎng)元登陸響應(yīng)接口參數(shù)是7是6.5.3DCS網(wǎng)元注冊接口接口描述DCS網(wǎng)元應(yīng)通過DCS網(wǎng)元注冊接口向IRS網(wǎng)元注冊DCS網(wǎng)元的基礎(chǔ)信息。該接口應(yīng)由DCS網(wǎng)元發(fā)起，由IRS網(wǎng)元處理并返回響應(yīng)給DCS網(wǎng)元。該接口示例參見附錄B.3。接口參數(shù)該接口名稱為IRS_DCS_Reg。DCS網(wǎng)元注冊請求接口參數(shù)見表6，DCS網(wǎng)元注冊響應(yīng)接口參數(shù)見表7。表6DCS網(wǎng)元注冊請求接口參數(shù)是是是是是表7DCS網(wǎng)元注冊響應(yīng)接口參數(shù)是6.5.4IRS標(biāo)識注冊接口接口描述DCS網(wǎng)元應(yīng)通過IRS注冊接口實現(xiàn)DCS網(wǎng)元向IRS網(wǎng)元請求標(biāo)識注冊。該接口示例參見附錄B.4。接口參數(shù)接口名稱為IRS_ID_Reg，IRS標(biāo)識注冊請求接口參數(shù)見表8，IRS標(biāo)識注冊響應(yīng)接口參數(shù)見表9。表8IRS標(biāo)識注冊請求接口參數(shù)8DB32/TXXXX—2018是是所注冊的標(biāo)識列表，可包含是是發(fā)起標(biāo)識注冊的DCS的URL是表9IRS標(biāo)識注冊響應(yīng)接口參數(shù)是6.5.5IRS標(biāo)識更新接口接口描述DCS網(wǎng)元應(yīng)通過IRS標(biāo)識更新接口向IRS網(wǎng)元發(fā)起請求標(biāo)識更新請求，修改IRS數(shù)據(jù)庫中標(biāo)識的相關(guān)信息。該接口示例參見附錄B.5。接口參數(shù)接口名稱為IRS_ID_Upd，IRS標(biāo)識更新請求接口參數(shù)見表10，IRS標(biāo)識更新響應(yīng)接口參數(shù)見表11。表10IRS標(biāo)識更新請求接口參數(shù)是是是是發(fā)起標(biāo)識更新的DCS的URL是表11IRS標(biāo)識更新響應(yīng)接口參數(shù)9是6.5.6IRS標(biāo)識刪除接口接口描述DCS網(wǎng)元與IRS網(wǎng)元之間可通過IRS標(biāo)識刪除接口，實現(xiàn)DCS網(wǎng)元向IRS網(wǎng)元發(fā)起請求刪除，刪除某個指定標(biāo)識的相關(guān)信息。該接口示例參見附錄B.6。接口參數(shù)接口名稱為IRS_ID_Del。IRS標(biāo)識刪除請求接口參數(shù)見表12,IRS標(biāo)識刪除響應(yīng)接口參數(shù)見表13。表12IRS標(biāo)識刪除請求接口參數(shù)是是是發(fā)起標(biāo)識刪除的DCS的URL是表13IRS標(biāo)識刪除響應(yīng)接口參數(shù)是DB32/TXXXX—2018（規(guī)范性附錄）特殊數(shù)據(jù)類型參數(shù)Item類型的參數(shù)見表A.1，Item類型參數(shù)的字段取值見表A.2，Status類型參數(shù)見表A.3。表A.1Item類型參數(shù)是是表A.2Item類型字段取值識表A.3Status類型參數(shù)（資料性附錄）數(shù)據(jù)接口應(yīng)用示例B.1IRS標(biāo)識解析接口應(yīng)用示例B.1.1HTTP-Request消息的JSON消息體varJSONObject={"MessageName":"IRS_ID_Resolute","ObjectCode1":"06900413431157","ObjectCode2":"201709061A23","Role":"EndUser","GTIN":"06900413431157","Structure":"GS1"}B.1.2HTTP-Response消息的JSON消息體varJSONObject={"Status":"Succ","SrvList":["DCSURL":"/service.asmx","EvtDetail":[{"ItemName":"BackupDCSURL","ItemValue":"/service.asmx"},{"ItemName":"Structure","ItemValue":"GS1"},{"ItemName":"TranslatedCode","ItemValue":"urn:gbiotroot:id:obj:201709061A23.06900413431157."}]]}B.2DCS網(wǎng)元登陸接口應(yīng)用示例B.2.1HTTP-Request消息的JSON消息體varJSONObject={"MessageName":"IRS_DCS_Login","Name":"NanJingDCS-01","Password":"Js89765"}B.2.2HTTP-Response消息的JSON消息體varJSONObject={"Status":"Succ","Seid":"20170987681"}B.3DCS網(wǎng)元注冊接口應(yīng)用示例B.3.1HTTP-Request消息的JSON消息體:varJSONObject={"MessageName":"IRS_DCS_Reg","Node":"/service.asmx","Seid":"20170987681","Structure":"GS1","SrvList":[{"ItemName":"BackupDCSURL","ItemValue":"/service.asmx"},{"ItemName":"Structure","ItemValue":"GS1"}]}B.3.2HTTP-Response消息的JSON消息體:varJSONObject={"Status":"Succ"}DB32/TXXXX—2018B.4IRS標(biāo)識注冊接口應(yīng)用示例B.4.1HTTP-Request消息的JSON消息體varJSONObject={"MessageName":"IRS_ID_Reg","codeList":[{"ID":"urn:cniotroot:id:obj:001.107346.jinshiy"},{