DB32T 3410-2018 食品安全电子追溯数据录服务数据接口规范

ICS67.040X00备案号：60246-2018DB32江苏省地方标准DB32/T3410—2018食品安全电子追溯数据目录服务数据接口规范Interfacespecificationsofdatacatalogserviceforfoodsafetyelectronictraceability2018-6-25发布2018-7-10实施江苏省质量技术监督局发布DB32/T3410—2018I目次前言...............................................................................III1范围..............................................................................12规范性引用文件....................................................................13术语和定义........................................................................14缩略语............................................................................25功能要求..........................................................................25.1网元交互......................................................................25.2基本服务功能..................................................................36数据接口..........................................................................36.1基本要求......................................................................36.2接口原语......................................................................46.3数据类型......................................................................46.4调用方式......................................................................56.5参数要求......................................................................56.5.1DCS标识注册接口...........................................................56.5.2DCS标识更新接口...........................................................66.5.3DCS标识删除接口...........................................................66.5.4DCS主数据登记接口.........................................................76.5.5DCS事件登记接口...........................................................86.5.6DCS追溯信息查询接口.......................................................8附录A（规范性附录）Item类型参数..................................................10附录B（资料性附录）数据接口应用示例...............................................11DB32/T3410—2018II前言本标准按照GB/T1.1-2009给出的规则起草。本标准由江苏省食品药品监督管理局提出并归口。本标准起草单位：江苏省质量和标准化研究院、江苏省食品药品监督信息中心、中科院计算机网络中心、复旦大学无锡研究院、江苏瑞德信息产业有限公司、无锡捷玛物联科技有限公司。本标准主要起草人：杨博、刘佳、吴双力、田野、胡冶、曹云、刘毅、周广军、王理、王俊宇、钱侃、刘小康。DB32/T3410—20181食品安全电子追溯数据目录服务数据接口规范1范围本标准规定了食品安全电子追溯数据目录服务的功能要求、数据接口。本标准适用于食品安全电子追溯数据目录服务的接口实现。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB12904商品条码零售商品编码与条码表示DB32/TXXXX-2018食品安全电子追溯标识解析服务数据接口规范RFC2616超文本传输协议1.1(Hypertexttransferprotocol--HTTP/1.1)RFC4627JSON格式定义(Theapplication/JSONmediatypeforjavascriptobjectnotation)RFC4825可扩展标记语言配置接入协议(Theextensiblemarkuplanguage(XML)configurationaccessprotocol(XCAP))3术语和定义下列术语和定义适用于本文件。3.1数据目录服务datacatalogservice以物品的追溯标识为索引建立物品所流经的信息查询服务器URL地址列表的过程。3.2网元networkelement由软硬件共同组成的能实现网络中的一种或多种逻辑功能的逻辑单元。3.3IRS网元identificationresolutionservicenetworkelement提供追溯标识注册和追溯标识解析服务的网元。3.4IQS网元informationqueryservicenetworkelement提供可视化追溯信息查询服务的网元。3.5DB32/T3410—20182DCS网元datacatalogservicenetworkelement以追溯标识为单位提供追溯路径的建立和查询服务的网元。3.6追溯代理traceabilityproxy以用户发起的HTTP追溯查询请求为触发，代替追溯用户调用IRS,DCS和IQS网元的多个接口完成追溯查询逻辑功能的网元。3.7EU网元endusernetworkelement终端用户所使用的具备追溯查询能力的软件系统的统称。3.8CU网元captureunitnetworkelement负责采集主数据、交易数据和事件数据并提交到IQS网元，完成数据采集功能的网元。3.9SP网元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)URN：统一资源名称(UniformResourceName)XML：可扩展标记语言(ExtensibleMarkupLanguage)5功能要求5.1网元交互5.1.1总则DB32/T3410—20183食品安全电子追溯系统应由企业平台、监管平台和查询平台组成。食品安全电子追溯系统的系统架构见DB32/TXXXX。DCS网元应按归属地管理的原则进行业务管理，部署在归属地生产企业的IQS网元应向负责管理归属地业务的DCS网元发起标识注册和事件登记。DCS网元应将本地区IQS网元注册的物品追溯标识同步向IRS网元发起注册。DCS网元归属地管理架构图见图1。EU网元追溯代理IRS网元DCS网元(归属地)IRS标识管理接口IRS解析查询接口Web/APP/微信服务查询平台DCS查询接口DCS网元IRS标识管理接口IQS网元(生产企业)DCS标识管理接口DCS事件登记接口图1DCS网元归属地管理架构图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基本服务功能DCS网元应提供但不限于以下功能：a)追溯标识注册功能；b)追溯事件登记功能；c)追溯信息查询服务。6数据接口6.1基本要求DB32/T3410—20184食品安全电子追溯系统的各个网元之间应通过Internet公共以太网接口互联互通。各网元的物理接口上承载的协议栈应为HTTP或HTTPS协议栈，数据接口应使用基于HTTP/HTTPS协议的JSON格式的消息体传输数据。DCS网元和其它各个网元之间应通过本标准规定的数据接口进行消息交互，实现DCS网元的功能。这些数据接口包括：a)DCS标识管理接口；b)DCS事件登记接口；c)DCS查询接口。6.2接口原语基于服务的方式定义数据接口的使用方法。服务响应流程使用了“请求-Request”“指示-Indication”“响应-Response”“确认-Confirm”四条服务原语，原语的顺序见图2。客户端服务器HTTPRequest消息请求-Request指示-IndicationHTTPResponse消息响应-Response确认-Confirm图2服务响应流程DCS标识管理接口应包括：a)DCS标识注册接口；b)DCS标识更新接口；c)DCS标识删除接口。DCS事件登记接口应包括：a)DCS主数据登记接口；b)DCS事件登记接口。DCS查询接口只包括DCS追溯信息查询接口的一个接口。6.3数据类型DCS网元接口中所使用到的数据类型见表1。DB32/T3410—20185表1数据类型说明类型名类型描述类型说明String文本字符串内容为所有的有效字符Number数字类型内容由从0-9的数字字符，和+-字符组成List列表类型每一项均为一个子数据项，