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

ICS67.040X00备案号：60243-2018DB32江苏省地方标准DB32/T3407—2018食品安全电子追溯标识解析服务数据接口规范Interfacespecificationofidentificationresolutionserviceforfoodsafetyelectronictraceability2018-06-25发布2018-07-10实施江苏省质量技术监督局发布DB32/T3407—2018I目次前言...............................................................................III1范围..............................................................................12规范性引用文件....................................................................13术语和定义........................................................................14缩略语............................................................................25功能要求..........................................................................35.1系统架构......................................................................35.2基本服务功能..................................................................46数据接口..........................................................................46.1基本要求......................................................................46.2接口原语......................................................................46.3数据类型......................................................................56.4调用方式......................................................................56.5参数要求......................................................................56.5.1IRS标识解析接口...........................................................56.5.2DCS网元登陆接口...........................................................66.5.3DCS网元注册接口...........................................................76.5.4IRS标识注册接口...........................................................76.5.5IRS标识更新接口...........................................................86.5.6IRS标识删除接口...........................................................9附录A（规范性附录）特殊数据类型定义...............................................10附录B（资料性附录）数据接口应用示例...............................................11DB32/T3407—2018II前言本标准按照GB/T1.1-2009给出的规则起草。本标准由江苏省食品药品监督管理局提出并归口。本标准起草单位：江苏省质量和标准化研究院、江苏省食品药品监督信息中心、中科院计算机网络中心、复旦大学无锡研究院、无锡捷玛物联科技有限公司。本标准主要起草人：章学周、杨博、刘佳、吴双力、胡冶、刘毅、田野、王瑜、周广军、曹云、钱侃、王俊宇、关春。DB32/T3407—20181食品安全电子追溯标识解析服务数据接口规范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.5DB32/T3407—20182IRS网元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)DB32/T3407—20183URN：统一资源名称(UniformResourceName)XML：可扩展标记语言(ExtensibleMarkupLanguage)5功能要求5.1系统架构5.1.1总则食品安全电子追溯系统应由企业平台、监管平台和查询平台组成。企业应确保食品链的可追溯性，并通过建设符合本框架规定的相关接口的企业平台，加入食品安全电子追溯系统。食品安全电子追溯系统的系统架构见图1。EU网元追溯代理IRS网元DCS网元IQS网元CU网元食品质量安全监管平台各市监管平台……SP网元IRS标识管理接口DCS标识管理接口DCS事件登记接口IRS解析查询接口IQS查询接口Web/APP/微信服务数据交换接口数据上报接口IQS数据传输接口查询平台监管平台企业平台DCS查询接口图1食品安全电子追溯系统结构5.1.2网元要求5.1.2.1IRS网元应对外提供追溯标识注册和追溯标识解析服务。5.1.2.2DCS网元应以追溯标识为单位提供追溯路径的建立和查询的服务。DCS网元应以追溯标识为标识确保物品的可追溯性。5.1.2.3IQS网元应提供追溯信息捕获、查询服务和数据上报服务的功能。5.1.2.4CU网元应通过条码识读设备和RFID读写器等数据采集设备实现采集一维码、二维码、RFID标签等信息的功能。5.1.2.5EU网元功能应信息终端设备上实现；EU网元应向用户提供追溯的交互式人机界面。5.1.2.6SP网元应部署在监管部门的服务器系统上，SP网元应实现支撑利用追溯数据开展对企业的监管功能。5.1.2.7追溯代理应以用户发起的追溯请求为触发，代替用户完成追溯系统的内部业务处理。5.2基本服务功能DB32/T3407—20184IRS网元应提供但不限于以下功能：a)追溯标识注册功能；b)追溯标识解析功能。6数据接口6.1基本要求食品安全电子追溯系统的各个网元之间应通过Internet公共以太网接口互联互通。各网元的物理接口上承载的协议栈应为HTTP或HTTPS协议栈，数据接口应使用基于HTTP/HTTPS协议的JSON格式的消息体传输数据。IRS网元和其它各个网元之间应通过数据接口进行消息交互，实现IRS网元的功能。这些具体接口包括：a)IRS解析查询接口；b)IRS标识管理接口。6.2接口原语基于服务的方式定义数据接口的使用方法。服务响应流程使用了“请求-Request”“指示-Indication”“响应-Response”“确认-Confirm”四条服务原语，原语的顺序见图2。客户端服务器HTTPRequest消息请求-Request指示-IndicationHTTPResponse消息响应-Response确认-Confirm图2服务响应流程IRS网元的服务接口分为：a)IRS标识管理接口；b)IRS解析查询接口。IRS标识管理接口应包括：a)DCS网元登陆接口；b)DCS网元注册接口；c)IRS标识注册接口；DB32/T3407—20185d)IRS标识更新接口；e)IRS标识删除接口。IRS解析查询接口只包括IRS标识解析接口