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

ICS67.040

X00

备案号：DB32

江苏省地方标准

DB32/T3408—2018

食品安全电子追溯生产企业数据上报接口

规范

Interfacespecificationsofproductionenterprisedatareportingforfoodsafety

electronictraceability

2018-6-25发布2018-7-10实施

江苏省质量技术监督局发布

DB32/T3408—2018

目  次

前言.....................................................................................................................................................................II

1范围.................................................................................................................................................................1

2规范性引用文件.............................................................................................................................................1

3术语和定义.....................................................................................................................................................1

4缩略语.............................................................................................................................................................2

5功能要求.........................................................................................................................................................2

5.1网元交互.................................................................................................................................................2

6接口.................................................................................................................................................................3

6.1接口协议.................................................................................................................................................3

6.2安全性设置.............................................................................................................................................3

6.3基本数据类型.........................................................................................................................................3

6.4接口定义.................................................................................................................................................3

6.5报文格式定义与编写方法.....................................................................................................................4

6.6接口约束.................................................................................................................................................4

6.7接口分类.................................................................................................................................................4

7数据上传接口.................................................................................................................................................5

7.1企业基本信息上传接口.........................................................................................................................5

7.2原料进厂信息上传接口.........................................................................................................................5

7.3原料自检信息上传接口.........................................................................................................................7

7.4原料自检明细信息.................................................................................................................................7

7.5投入产出信息上传接口.........................................................................................................................8

7.6投放明细信息.........................................................................................................................................8

7.7出厂检验信息上传接口.........................................................................................................................9

7.8出厂检验明细信息.................................................................................................................................9

7.9出厂销售信息上传接口.......................................................................................................................10

7.10批次、单品对应信息上传接口.........................................................................................................10

7.11不合格产品处理信息上传接口.........................................................................................................11

7.12产品召回事件信息上传接口.............................................................................................................11

7.13产品召回跟踪信息上传接口.............................................................................................................11

附录A（规范性附录）上传数据错误码列表.............................................................................................13

附录B（规范性附录）编码表......................................................................................................................14

附录C（资料性附录）XML报文示例...........................................................................................................15

I

DB32/T3408—2018

前  言

本标准按照GB/T1.1-2009给出的规则起草。

本标准由江苏省食品药品监督管理局提出并归口。

本标准起草单位：江苏省食品药品监督信息中心、江苏省质量和标准化研究院、南京农业大学、苏

果超市有限公司、江苏雨润集团有限公司、南京卫岗乳业有限公司、江苏今世缘酒业股份有限公司、江

苏洋河酒厂股份有限公司、江苏瑞德信息产业有限公司、江苏稻源微电子有限公司。

本标准主要起草人：曹云、李睿、杨博、陆诚、章学周、胡冶、崔兆明、王瑜、关春、刘小康、上

官金标、陆会会。

II

DB32/T3408—2018

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

1范围

本标准规定了食品安全电子追溯生产企业数据上报接口的功能要求和上传信息。

本标准适用于食品安全电子追溯生产企业数据上报接口的开发和应用。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T7635.1-2002全国主要产品分类与代码第1部分：可运输产品

GB12904商品条码零售商品编码与条码表示

GB/T16830商品条码储运包装商品编码与条码表示

CFDAB/T0401-2014食品药品监管数据共享与交换接口规范

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

3术语和定义

下列术语和定义适用于本文件。

3.1

网元networkelement

由软硬件共同组成的能实现网络中的一定的逻辑功能的逻辑单元。

3.2

CU网元captureunitnetworkelement

负责采集主数据、交易数据和事件数据并提交到IQS网元，完成数据采集功能的网元。

3.3

IQS网元informationqueryservicenetworkelement

提供可视化追溯信息查询服务的网元。

3.4

SP网元SupervisorPlatformNetworkElement

接收IQS网元上报的追溯数据，支撑政府监管人员利用追溯数据开展对企业监管的网元。

4缩略语

1

DB32/T3408—2018

下列缩略语适用于本文件。

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。

图1生产企业数据上报系统架构

5.1.2网元要求

CU网元应通过条码识读设备和RFID读写器等数据采集设备采集一维码、二维码、RFID标签等

信息的功能。

IQS网元应提供追溯信息捕获、查询服务和数据上报服务的功能。

SP网元应部署在监管部门的服务器系统上，SP网元应实现支撑利用追溯数据开展对企业的监

管功能。

6接口

2

DB32/T3408—2018

6.1接口协议

接口采用Webservice方式。数据上报接口协议栈涉及到服务传输层、服务消息层和服务描述层，

服务传输层使用HTTPS协议，以提高数据传输的安全性。服务消息层协议为SOAP，服务描述层描述语言

为WSDL。

6.2安全性设置

客户端和服务器端通信采用数字证书认证，数据传输通过MD5来验证完整性，见CFDAB/T0401-2014。

数字证书由食品安全电子追溯系统监管平台服务器端经审核后在线发放或发放硬件装载的数字证书。

6.3基本数据类型

食品生产企业电子追溯系统提供的数据上报共享接口所使用到的基本数据类型定义见表1。

表1基本数据类型

类型名类型描述类型说明

string文本字符串内容为所有的有效字符

date日期类型固定格式字符串，格式为YYYY-MM-DD

int数字类型内容由从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码不匹配

表3响应参数（续）

响应参数类型参数说明

3

DB32/T3408—2018

errorCodeint上传失败的返回值：为uploadData函

数调用返回的错误码

错误信息获得方法名称：StringgetUploadError（interrorCode）

输入值为errorCode，是数据上传完毕后服务器端的响应参数的返回值，见表3。

返回值为上传数据错误详细信息，见附录A。

6.5报文格式定义与编写方法

报文编写格式为：

<?xmlversion="1.0"encoding="UTF-8"?>

<entitys

xmlns:xsi="/2001/XMLSchema-instance"

xmlns:xsd="/2001/XMLSchema"Version="3.0">

<entity>

<property>value</property>

<property>value</property>

</entity>

<entity>

<property>value</property>

<property>value</property>

</entity>

</entitys>

其中各字段对应填写内容见表4，XML报文编写示例参见附录C，编码格式为UTF-8。

注：原料自检明细信息、投放明细信息、出厂检验明细信息分别通过原料自检信息上传接口（参见附录C.1.3）、

投入产出信息上传接口上传（参见附录C.1.4）和出厂检验信息上传接口（参见附录C.1.5）。

表4字段填写内容

字段名对应填写内容

entity见表5中上传接口名称

property见7章各上传接口信息表中的参数名称

value对应参数名称填写的信息

6.6接口约束

使用增量上传方式，仅对新增和修改的数据上传。

6.7接口分类

接口分类见表5。

4

DB32/T3408—2018

表5接口分类

对应本标准章节号上传接口名称接口说明

7.1registerBean企业基本信息上传接口

7.2materialFactoryBean原料进厂信息上传接口

7.3materialSelfCheckBean原料自检信息上传接口

7.4materialSelfCheckDetailsBean原料自检明细信息

7.5inputOutPutBean投入产出信息上传接口

7.6inputOutPutDetailsBean投放明细信息

7.7outFactoryCheckBean出厂检验信息上传接口

7.8outFactoryCheckDetailsBean出厂检验明细信息

7.9outFactorySaleBean出厂销售信息上传接口

7.10batchItemBean批次、单品信息上传接口

7.11unQualifiedProductsProcessBean不合格产品处理信息上传接口

7.12productRecallEventBean产品召回事件信息上传接口

7.13productRecallTrackBean产品召回跟踪信息上传接口

7数据上传接口

7.1企业基本信息上传接口

通过企业基本信息上传接口上传的信息见表6。

表6企业基本信息上传接口信息

长度

参数名称类型是否必填描述

Byte

orgCodestring30是统一社会信用代码

orgNamestring127是企业名称

食品生产许可证编号,如多个

编号，各编号间使用“/”分

foodProductIdstring150否

隔，输入完毕以“.”作结束

符

食品添加剂许可证编号,如多

个编号，各编号间使用“/”

foodAdditivesIdstring150否

分隔，输入完毕以“.”作结

束符

uploadDatedate20否上传日期

7.2原料进厂信息上传接口

通过原料进厂信息上传接口上传的信息见表7。

5

DB32/T3408—2018

表7原料进厂信息上传接口信息

长度

参数名称类型是否必填描述

Byte

原料进货批次码，此字段为企

materialBatchidstring20是业上传的原料进厂数据的唯

一标识位

原料产品分类编码，编