食品安全电子追溯标识解析服务数据接口规范

1食品安全电子追溯标识解析服务数据接口规范本标准规定了食品安全电子追溯标识解析服务的功能要求和数据接口。本标准适用于食品安全电子追溯标识解析服务的接口实现。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB12904商品条码零售商品编码与条码表示RFC1945超文本传输协议1.0(Hypertexttransferprotocol--HTTP/1.0)RFC2616超文本传输协议1.1(Hypertexttransferprotocol--HTTP/1.1)RFC4627JSON格式定义(Theapplication/JSONmediatypeforjavascriptobjectnotation)RFC4825可扩展标记语言配置接入协议(Theextensiblemarkuplanguage(XML)configurationaccessprotocol(XCAP))3术语和定义下列术语和定义适用于本文件。3.1标识解析服务identificationresolutionservice将物品的追溯标识翻译成物品所归属的数据目录服务器URL地址的过程。3.2数据目录服务datacatalogservice以物品的追溯标识为索引建立物品所流经的信息查询服务器URL地址列表的过程。3.3信息查询服务informationqueryservice向数据目录服务器注册追溯标识，并以格式化的数据结构向追溯代理提供追溯信息查询的过程。3.4网元networkelement由软硬件共同组成的能实现网络中的一种或多种逻辑功能的逻辑单元。3.52DB32/TXXXX—2018IRS网元identificationresolutionservicenetworkelement提供追溯标识注册和追溯标识解析服务的网元。3.6IQS网元informationqueryservicenetworkelement提供可视化追溯信息查询服务的网元。3.7DCS网元datacatalogservicenetworkelement以追溯标识为单位提供追溯路径的建立和查询服务的网元。3.8追溯代理traceabilityproxy以用户发起的HTTP追溯查询请求为触发，代替追溯用户调用IRS,DCS和IQS网元的多个接口完成追溯查询逻辑功能的网元。3.9EU网元endusernetworkelement终端用户所使用的具备追溯查询能力的软件系统的统称。3.10CU网元captureunitnetworkelement负责采集主数据、交易数据和事件数据并提交到IQS网元，完成数据采集功能的网元。3.11SP网元SupervisorPlatformNetworkElement接收IQS网元上报的追溯数据，支撑政府监管人员利用追溯数据开展对企业监管的网元。4缩略语下列缩略语适用于本文件。CU：捕获单元(CaptureUnit)DNS：域名服务(DomainNameService)DCS：数据目录服务(DataCatalogService)EU：终端用户(EndUser)GTIN：全球贸易项目代码(GlobalTradeItemNumber)IQS：信息查询服务(InformationQueryService)IRS：标识解析服务(IdentificationResolutionService)JSON：JS对象标记(JavaScriptObjectNotation)RFID：射频识别(RadioFrequencyIdentification)SP：监管平台(SupervisorPlatform)URL：统一资源定位符(UniformResourceLocator)3URN：统一资源名称(UniformResourceName)XML：可扩展标记语言(ExtensibleMarkupLanguage)5功能要求5.1系统架构5.1.1总则食品安全电子追溯系统应由企业平台、监管平台和查询平台组成。企业应确保食品链的可追溯性，并通过建设符合本框架规定的相关接口的企业平台，加入食品安全电子追溯系统。食品安全电子追溯系统的系统架构见图1。图1食品安全电子追溯系统结构5.1.2网元要求IRS网元应对外提供追溯标识注册和追溯标识解析服务。DCS网元应以追溯标识为单位提供追溯路径的建立和查询的服务。DCS网元应以追溯标识为标识确保物品的可追溯性。IQS网元应提供追溯信息捕获、查询服务和数据上报服务的功能。CU网元应通过条码识读设备和RFID读写器等数据采集设备实现采集一维码、二维码、RFID标签等信息的功能。EU网元功能应信息终端设备上实现；EU网元应向用户提供追溯的交互式人机界面。SP网元应部署在监管部门的服务器系统上，SP网元应实现支撑利用追溯数据开展对企业的监管功能。追溯代理应以用户发起的追溯请求为触发，代替用户完成追溯系统的内部业务处理。5.2基本服务功能4DB32/TXXXX—2018IRS网元应提供但不限于以下功能：a)追溯标识注册功能；b)追溯标识解析功能。6数据接口6.1基本要求食品安全电子追溯系统的各个网元之间应通过Internet公共以太网接口互联互通。各网元的物理接口上承载的协议栈应为HTTP或HTTPS协议栈，数据接口应使用基于HTTP/HTTPS协议的JSON格式的消息体传输数据。IRS网元和其它各个网元之间应通过数据接口进行消息交互，实现IRS网元的功能。这些具体接口包括：a)IRS解析查询接口；b)IRS标识管理接口。6.2接口原语基于服务的方式定义数据接口的使用方法。服务响应流程使用了“请求-Request”“指示-Indication”“响应-Response”“确认-Confirm”四条服务原语，原语的顺序见图2。图2服务响应流程IRS网元的服务接口分为：a)IRS标识管理接口；b)IRS解析查询接口。IRS标识管理接口应包括：a)DCS网元登陆接口；b)DCS网元注册接口；c)IRS标识注册接口；5d)IRS标识更新接口；e)IRS标识删除接口。IRS解析查询接口只包括IRS标识解析接口的一个接口。6.3数据类型IRS网元接口中所使用到的数据类型见表1。表1数据类型说明6.4调用方式6.4.1请求请求接口应通过RFC1945或RFC2616中规定的HTTP请求，使用Get或者Post方法调用食品电子追溯目录服务接口。请求接口将请求参数按照消息格式用JSON封装后，包含在HTTP的Request消息的Body中发送给对方。6.4.2响应请求接口调用成功或失败以后，IRS网元应以RFC4825中规定的XML或RFC4627中规定的JSON格式将处理结果放置在HTTP的Response消息的Body中，返回给调用者。HTTP的Response消息应符合RFC1945或RFC2616中的要求。6.5参数要求6.5.1IRS标识解析接口基本要求追溯代理网元应通过IRS标识解析接口向IRS网元发送需要解析的物品标识，并从IRS网元获得该被追溯产品归属的DCS网元的URL地址信息。该接口示例参见附录B.1。接口参数该接口名称为IRS_ID_Resolute。IRS标识解析请求接口参数见表2，IRS标识解析响应接口参数见表3。表2IRS标识解析请求接口参数6DB32/TXXXX—2018是是否是否否否表3IRS标识解析响应接口参数是是否6.5.2DCS网元登陆接口基本要求DCS网元应先通过DCS网元登陆接口对DCS网元进行认证，并由IRS网元授予DCS网元相应的权限。IRS网元在对DCS网元的用户名和密码认证通过以后，应将会话ID返回给DCS，后续DCS通过会话ID与IRS网元进行数据交互。IRS网元应删除长期不用的空闲会话ID，空间会话ID的保留时间由IRS网元的管理策略决定。该接口示例参见附录B.2。接口参数该接口名称为IRS_DCS_Login，DCS网元登陆请求接口参数见表4，DCS网元登陆响应接口参数见表5。表4DCS网元登陆请求接口参数是是是表5DCS网元登陆响应接口参数是7是6.5.3DCS网元注册接口接口描述DCS网元应通过DCS网元注册接口向IRS网元注册DCS网元的基础信息。该接口应由DCS网元发起，由IRS网元处理并返回响应给DCS网元。该接口示例参见附录B.3。接口参数该接口名称为IRS_DCS_Reg。DCS网元注册请求接口参数见表6，DCS网元注册响应接口参数见表7。表6DCS网元注册请求接口参数是是是是是表7DCS网元注册响应接口参数是6.5.4IRS标识注册接口接口描述DCS网元应通过IRS注册接口实现DCS网元向IRS网元请求标识注册。该接口示例参见附录B.4。接口参数接口名称为IRS_ID_Reg，IRS标识注册请求接口参数见表8，IRS标识注册响应接口参数见表9。表8IRS标识注册请求接口参数8DB32/TXXXX—2018是是所注册的标识列表，可包含是是发起标识注册的DCS的URL是表9IRS标识注册响应接口参数是6.5.5IRS标识更新接口接口描述DCS网元应通过IRS标识更新接口向IRS网元发起请求标识更新请求，修改IRS数据库中标识的相关信息。该接口示例参见附录B.5。接口参数接口名称为IRS_ID_Upd，IRS标识更新请求接口参数见表10，IRS标识更新响应接口参数见表11。表10IRS标识更新请求接口参数是是是是发起标识更新的DCS的URL是表11IRS标识更新响应接口参数9是6.5.6IRS标识删除接口接口描述DCS网元与IRS网元之间可通过IRS标识删除接口，实现DCS网元向IRS网元发起请求删除，删除某个指定标识的相关信息。该接口示例参见附录B.6。接口参数接口名称为IRS_ID_Del。IRS标识删除请求接口参数见表12,IRS标识删除响应接口参数见表13。表12IRS标识删除请求接口参数是是是发起标识删除的DCS的URL是表13IRS标识删除响应接口参数是DB32/TXXXX—2018（规范性附录）特殊数据类型参数Item类型的参数见表A.1，Item类型参数的字段取值见表A.2，Status类型参数见表A.3。表A.1Item类型参数是是表A.2Item类型字段取值识表A.3Status类型参数（资料性附录）数据接口应用示例B.1IRS标识解析接口应用示例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网元登陆接口应用示例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网元注册接口应用示例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标识注册接口应用示例B.4.1HTTP-Request消息的JSON消息体varJSONObject={"MessageName":"IRS_ID_Reg","codeList":[{"ID":"urn:cniotroot:id:obj:001.107346.jinshiy"},{