DB32T 3408-2018 食品安全电子追溯生产企业数据上报接口规范

ICS67.040X00备案号：60244-2018DB32江苏省地方标准DB32/T3408—2018食品安全电子追溯生产企业数据上报接口规范Interfacespecificationsofproductionenterprisedatareportingforfoodsafetyelectronictraceability2018-06-25发布2018-07-10实施江苏省质量技术监督局发布DB32/T3408—2018I目次前言................................................................................II1范围..............................................................................12规范性引用文件....................................................................13术语和定义........................................................................14缩略语............................................................................25功能要求..........................................................................25.1网元交互......................................................................26接口..............................................................................36.1接口协议......................................................................36.2安全性设置....................................................................36.3基本数据类型..................................................................36.4接口定义......................................................................36.5报文格式定义与编写方法........................................................46.6接口约束......................................................................46.7接口分类......................................................................47数据上传接口......................................................................57.1企业基本信息上传接口..........................................................57.2原料进厂信息上传接口..........................................................57.3原料自检信息上传接口..........................................................77.4原料自检明细信息..............................................................77.5投入产出信息上传接口..........................................................87.6投放明细信息..................................................................87.7出厂检验信息上传接口..........................................................97.8出厂检验明细信息..............................................................97.9出厂销售信息上传接口.........................................................107.10批次、单品对应信息上传接口..................................................107.11不合格产品处理信息上传接口..................................................117.12产品召回事件信息上传接口....................................................117.13产品召回跟踪信息上传接口....................................................11附录A（规范性附录）上传数据错误码列表.............................................13附录B（规范性附录）编码表.........................................................14附录C（资料性附录）XML报文示例...................................................15DB32/T3408—2018II前言本标准按照GB/T1.1-2009给出的规则起草。本标准由江苏省食品药品监督管理局提出并归口。本标准起草单位：江苏省食品药品监督信息中心、江苏省质量和标准化研究院、南京农业大学、苏果超市有限公司、江苏雨润集团有限公司、南京卫岗乳业有限公司、江苏今世缘酒业股份有限公司、江苏洋河酒厂股份有限公司、江苏瑞德信息产业有限公司、江苏稻源微电子有限公司。本标准主要起草人：曹云、李睿、杨博、陆诚、章学周、胡冶、崔兆明、王瑜、关春、刘小康、上官金标、陆会会。DB32/T3408—20181食品安全电子追溯生产企业数据上报接口规范1范围本标准规定了食品安全电子追溯生产企业数据上报接口的功能要求和上传信息。本标准适用于食品安全电子追溯生产企业数据上报接口的开发和应用。2规范性引用文件下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T7635.1-2002全国主要产品分类与代码第1部分：可运输产品GB12904商品条码零售商品编码与条码表示GB/T16830商品条码储运包装商品编码与条码表示CFDAB/T0401-2014食品药品监管数据共享与交换接口规范DB32/TXXXX-2018食品安全电子追溯标识解析服务数据接口规范3术语和定义下列术语和定义适用于本文件。3.1网元networkelement由软硬件共同组成的能实现网络中的一定的逻辑功能的逻辑单元。3.2CU网元captureunitnetworkelement负责采集主数据、交易数据和事件数据并提交到IQS网元，完成数据采集功能的网元。3.3IQS网元informationqueryservicenetworkelement提供可视化追溯信息查询服务的网元。3.4SP网元SupervisorPlatformNetworkElement接收IQS网元上报的追溯数据，支撑政府监管人员利用追溯数据开展对企业监管的网元。4缩略语DB32/T3408—20182下列缩略语适用于本文件。HTTPS：安全超文本传输协议（HyperTextTransferProtocoloverSecureSocketLayer）IQS：信息查询服务（InformationQueryService）MD5：消息摘要算法第五版（Message-DigestAlgorithm5）SOAP：简单对象访问协议（SimpleObjectAccessProtocal）WSDL：Web服务定义语言（WebServicesDescriptionLanguage）XML：可扩展标记语言（ExtensibleMarkupLanguage）5功能要求5.1网元交互5.1.1总则食品安全电子追溯系统应由企业平台、监管平台、查询平台组成。食品安全电子追溯系统的系统架构见DB32/TXXXX。生产企业使用CU网元将采集到的数据上传至IQS网元，由IQS网元向SP网元进行数据上报。本标准仅规范由企业平台IQS网元上传至监管平台SP网元的数据上报接口，生产企业数据上报系统架构见图1。SP网元IQS网元CU网元IQS网元CU网元IQS网元CU网元监管平台A企业平台B企业平台C企业平台IQS数据传输接口IQS数据传输接口IQS数据传输接口数据上报接口数据上报接口数据上报接口图1生产企业数据上报系统架构5.1.2网元要求5.1.2.1CU网元应通过条码识读设备和RFID读写器等数据采集设备采集一维码、二维码、RFID标签等信息的功能。5.1.2.2IQS网元应提供追溯信息捕获、查询服务和数据上报服务的功能。5.1.2.3SP网元应部署在监管部门的服务器系统上，SP网元应实现支撑利用追溯数据开展对企业的监管功能。6接口DB32/T3408—201836.1接口协议接口采用Webservice方式。数据上报接口协议栈涉及到服务传输层、服务消息层和服务描述层，服务传输层使用HTTPS协议，以提高数据传输的安全性。服务消息层协议为SOAP，服务描述层描述语言为WSDL。6.2安全性设置客户端和服务器端通信采用数字证书认证，数据传输通过MD5来验证完整性，见CFDAB/T0401-2014。数字证书由食品安全电子追溯系统监管平台服务器端经审核后在线发放或发放硬件装载的数字证书。6.3基本数据类型食品生产企业电子追溯系统提供的数据上报共享接口所使用到的基本数据类型定义见表1。表1基本数据类型类型名类型描述类型说明string文本字符串内容为所有的有效字符date日期类型固定格式字符串，格式为YYYY-MM-DDint数字类型内容由从0-9的数字字符，和+-字符组成6.4接口定义Webservice名称：ProductTraceService，上传数据方法名称：intuploadData（StringdataType,StringdataXml,StringdataMD5），输入参数见表2。表2输入参数参数名称类型是否必填参数说明dataTypestring是数据类型dataXmlstring是上传数据的XML数据dataMD5string是dataXml数据的MD5码数据上传完毕，服务器端响应参数见表3。表3响应参数响应参数类型参数说明statusint返回值，用于表示状态：若返回值为1，表示上传数据成功、若返回值为0，表示上传的XML与上传数据中dataXml的MD5码不匹配响应参数类型参数说明errorCodeint上传失败的返回值：为uploadData函数调用返回的错误码DB32/T3408—20184错误信息获得方法名称：StringgetUploadErr