DB32/T 3409-2018 食品安全电子追溯数据交换接口规范

ICS67.040

X00

备案号：DB32

江苏省地方标准

DB32/T3409—2018

食品安全电子追溯数据交换接口规范

InterfaceSpecificationsofdataexchangeforfoodsafetyelectronictraceability

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

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

DB32/T3409—2018

目  次

前言...................................................................................................................................................................III

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

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

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

4缩略语.............................................................................................................................................................3

5追溯系统.........................................................................................................................................................3

5.1系统架构.................................................................................................................................................3

5.2网元关系.................................................................................................................................................4

6数据交换.........................................................................................................................................................5

6.1数据交换流程.........................................................................................................................................5

6.2数据交换要求.........................................................................................................................................6

6.3数据交换格式.........................................................................................................................................6

6.4基本数据类型定义.................................................................................................................................7

7接口内容.........................................................................................................................................................7

7.1生产数据.................................................................................................................................................7

7.2食源性疾控数据...................................................................................................................................12

7.3检验检测数据.......................................................................................................................................13

7.4大宗农副产品追溯数据.......................................................................................................................13

附录A（规范性附录）编码规则..................................................................................................................15

附录B（规范性附录）数据结构定义..........................................................................................................16

I

DB32/T3409—2018

前  言

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

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

本标准起草单位：江苏省食品药品监督信息中心、江苏省质量和标准化研究院、东软集团股份有限

公司、江苏科佳软件开发有限公司、江苏瑞德信息产业有限公司、江苏稻源微电子有限公司。

本标准主要起草人：陆诚、刘琰、杨博、曹云、章学周、关春、刘小康、崔伟、杨烁宇、胡冶、窦

贤芳、陆会会。

II

DB32/T3409—2018

食品安全电子追溯数据交换接口规范

1范围

本标准规定了食品安全电子追溯数据交换的数据接口要求和数据接口参数。

本标准适用于食品安全电子追数据交换和接口实现。

2规范性引用文件

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

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

GB/T7027信息分类和编码的基本原则与方法

GB/T7635.1全国主要产品分类与代码第1部分:可运输产品(上、下)

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

NY/T1430农产品产地编码规则

RFC1738统一资源定位符（URL）通用语法（Uniformresourcelocators(URL)）

RFC1945超文本传输协议-HTTP/1.0（Hypertexttransferprotocol-HTTP/1.0）

RFC2616超文本传输协议-HTTP/1.1（Hypertexttransferprotocol-HTTP/1.1）

RFC4627JSON格式定义（Theapplication/JSONmediaTypeforjavascriptobjectnotation）

RFC4825可扩展标记语言配置接入协议（Theextensiblemarkuplanguage(XML)configuration

accessprotocol(XCAP)）

3术语和定义

GB/T22000、GB/T22005、GB/T25008确立的以及下列术语和定义适用于本文件。为了便于使用，

以下重复列出了GB/T22000、GB/T22005、GB/T25008中的某些术语和定义。

3.1

网元networkelement

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

3.2

IRS网元identificationresolutionservicenetworkelement

提供追溯标识注册和追溯标识解析服务的网元。

3.3

IQS网元informationqueryservicenetworkelement

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

3.4

1

DB32/T3409—2018

DCS网元datacatalogservicenetworkelement

以追溯标识为单位提供追溯路径的建立和查询服务的网元。

3.5

追溯代理traceabilityproxy

以用户发起的HTTP追溯查询请求为触发，代替追溯用户调用IRS,DCS和IQS网元的多个接口完成追溯

查询逻辑功能的网元。

3.6

EU网元endusernetworkelement

终端用户所使用的具备追溯查询能力的软件系统的统称。

3.7

CU网元captureunitnetworkelement

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

3.8

SP网元SupervisorPlatformNetworkElement

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

3.9

投入产出input-output

食品生产企业所生产的产品生产投入和使用去向的情况。

4缩略语

CU：捕获单元(CaptureUnit)

DNS：域名服务(DomainNameService)

DCS：数据目录服务(DataCatalogService)

EU：终端用户(EndUser)

GTIN：全球贸易项目代码(GlobalTradeItemNumber)

IQS：信息查询服务(InformationQueryService)

IRS：标识解析服务(IdentificationResolutionService)

JSON：JS对象标记(JavaScriptObjectNotation)

RFID：射频识别(RadioFrequencyIdentification)

SP：监管平台(SupervisorPlatform)

URI：统一资源标识符(UniformResourceIdentifier)

URL：统一资源定位符(UniformResourceLocator)

URN：统一资源名称(UniformResourceName)

XML：可扩展标记语言(ExtensibleMarkupLanguage)

5追溯系统

2

DB32/T3409—2018

5.1系统架构

5.1.1概述

食品安全电子追溯系统应由企业平台、查询平台、监管平台组成。食品安全电子追溯系统的系统架

构见DB32/TXXXX。企业应确保食品链的可追溯性，并通过建设符合框架规定的相关接口的企业平台，

加入食品安全电子追溯系统。，食品安全电子追溯数据交换结构图见图1。

图1食品安全电子追溯数据交换结构图

5.1.2网元基本要求

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

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

能。

5.2基本功能

食品安全电子追溯数据交换主要包括IQS网元、SP网元和与SP网元进行数据交换的其他平台。其中：

a)IQS网元只进行数据上报，不进行数据获取。

b)与SP网元进行数据交换的主要为各政府监管部门及权威认证的检验检测机构，如与各市监管部门

进行食品生产数据交换、与农副产品物流中心及农业部农副产品质量安全监督平台进行大宗农副产品追

溯数据的交换。

6数据接口

6.1数据交换流程

数据交换流程见图2。

3

DB32/T3409—2018

图2食品安全电子追溯数据交换流程

交换流程为：

a)交换数据请求方向交换数据提供方发起数据交换查询请求；

b)交换数据提供方按照请求方的权限，进行权限审核，返回请求方在所属权限下可同步的数据情

况；

c)交换数据请求方发起数据交换请求；

d)交换数据提供方按照请求方的权限，返回数据交换响应结果。

6.2调用方式

6.2.1概述

数据交换内容统一采用XML的形式进行描述，每个交换XML文件中的记录数以不影响XML文件解析性

能为宜。

6.2.2请求

请求接口应通过RFC1945或RFC2616中规定的HTTP请求，使用Get或者Post方法调用数据交换权限

和数据交换请求接口。请求接口将请求参数按照消息格式用JSON封装后，包含在HTTP的Request消息的

Body中发送给对方。

6.2.3响应

请求接口调用成功或失败以后，应以RFC4825中规定的XML或RFC4627中规定的JSON格式将处理结

果放置在HTTP的Response消息的Body中，返回给调用者。HTTP的Response消息应符合RFC1945或RFC2616

中的要求。

6.3数据交换格式

数据交换的XML报文数据格式为：

4

DB32/T3409—2018

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

<entitysxmlns: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>

其中，entity应填写交换数据内容，见表1。property字段应填写交换数据内容应交换的参数，参

数名称见表3至表15，value字段应按符合交换数据内容参数类型要求，见表3至表15。

表1交换数据内容标识

交换数据内容entity对应章节号

企业基本数据registerBean7.1.1

生产数据

原料进厂数据materialFactoryBean7.1.2

原料自检数据materialSelfCheckBean7.1.3

投入产出数据inputOutPutBean7.1.4

出厂检验数据outFactoryCheckBean7.1.5

生产数据出厂销售数据outFactorySaleBean7.1.6

批次、单品信息数据batchItemBean7.1.7

产品召回事件数据productRecallEventBean7.1.8

产品召回跟踪数据productRecallTrackBean7.1.9

食品安全风险监测数据FoodDiseaseControlBean7.2

检验检测数据TestBean7.3

大宗农副产品追溯数据AgriculturalProductionBean7.4

6.4基本数据类型说明

使用的基本数据类型定义见表2，应对接口传输消息中JSON或XML格式的文本内容做限定。

表2基本数据类型定义说明

类型长度

类型名类型描述

Byte

String文本字符串，内容为所有的有效字符。1-255个文本字符

Number数字类型，由从0-9的数字字符，以+-表示符号。15个文本字符

List<>列表类型，每一项均为一个子数据项，子数据项

每项不超过305个文本字符

编码方式与整个报文编码方式相同。

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

5

DB32/T3409—2018

6.5参数要求

6.5.1生产数据参数

企业基本数据参数

主要与各市监管平台等机构进行企业基本数据交换，交换参数见表3。

表3企业基本信息数据

长度

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

Byte

orgCodeString30是统一社会信用代码

orgnameString127是企业名称

foodProductIdString150否食品生产许可证编号

foodAdditivesIdString150否食品添加剂许可证编号

原料进厂数据参数

主要与各市监管平台等机构进行原料进厂数据交换，交换参数见表4。