DB21/T 3840-2023 辽宁省冷链食品安全追溯平台数据交换接口规范

ICS91.140.90

CCSQ78

21

辽宁省地方标准

DB21/T3840—2023

辽宁省冷链食品安全追溯

平台数据交换接口规范

InterfacestandardspecificationofLiaoningcoldchainfoodsafetytraceability

platform

2023-09-30发布2023-10-30实施

辽宁省市场监督管理局发布

DB21/T3840-2023

目次

前言............................................................................Ⅱ

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

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

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

4数据交换体系..................................................................2

4.1总体框架..................................................................2

4.2数据交换模型..............................................................3

5数据交换类型..................................................................4

5.1数据交换类型分类..........................................................4

5.2文件交换..................................................................4

5.3数据库对接................................................................4

5.4服务调用..................................................................4

6数据交换模式..................................................................4

6.1数据交换模式分类..........................................................4

6.2数据上报..................................................................4

6.3数据共享..................................................................6

7数据交换审计.................................................................10

8数据交换安全.................................................................10

附录A（资料性）数据格式标准...................................................12

附录B（资料性）XML数据包包头放置数据资源描述信息.............................20

参考文献........................................................................22

I

DB21/T3840-2023

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》给出的规

则起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由辽宁省市场监督管理局提出并归口。

本文件起草单位：辽宁省食品安全协会。

本文件主要起草人：张效东、洪达文、刘洪旺、刘艳华、赵香华。

本文件发布实施后，任何单位和个人如有问题和意见建议，均可以通过来电和来函等方式进行反馈，

我们将及时答复并认真处理，根据实际情况依法进行评估及复审。

归口管理部门通讯地址：辽宁省市场监督管理局，辽宁省沈阳市皇姑区崇山中路55号，联系电话：

96315-1-2903。

文件起草单位通讯地址：辽宁省食品安全协会，辽宁省沈阳市皇姑区太白山路110-3号，联系电话：

024-23898046。

II

DB21/T3840-2023

辽宁省冷链食品安全追溯平台数据交换接口规范

1范围

本文件规定了辽宁省冷链食品安全追溯平台的数据交换体系、数据交换类型、数据交换模式、数据交

换审计和数据交换安全。

本文件适用于辽宁省冷链食品安全追溯平台数据与相关政府部门在政务外网的数据交换。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文

件。

GB/T2260中华人民共和国行政区划代码

GB/T4657中央党政机关、人民团体及其他机构代码

GB/T21062.1-2007政务信息资源交换体系第1部分：总体框架

GB/T22239-2019信息安全技术网络安全等级保护基本要求

3术语和定义

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

3.1

交换节点exchangenode

辽宁省冷链食品安全追溯平台下不同的业务系统中实现信息资源传送和处理的系统单元。

3.2

中心交换节点centralexchangenode

辽宁省冷链食品安全追溯平台，也称省级交换节点。

3.3

端交换节点endexchangenode

直接与辽宁省冷链食品安全追溯平台进行信息交换的辽宁省政府数据共享中心、辽宁省新冠肺炎疫情

防控指挥部及相关政府部门。

3.4

1

DB21/T3840-2023

交换域exchangedomain

由中心交换节点以及与其直接交换的端交换节点组成，可供“辽宁省冷链食品安全追溯平台”进行信

息交换、共享等各类专属业务的交换环境。

3.5

交换服务exchangeservice

端交换节点和企业平台共享数据信息，或检索“辽宁省冷链食品安全追溯平台”中相关数据信息的服

务。

4数据交换体系

4.1总体框架

依据GB/T21062.1-2007，在国家电子政务外网公共数据交换平台框架下，本文件规范了辽宁省冷链食

品安全追溯平台交换体系总体框架，见图1。

图1交换体系总体框架图

2

DB21/T3840-2023

4.2数据交换模型

4.2.1数据交换模型组成与功能

辽宁省冷链食品安全追溯数据交换模型由交换信息、交换关系及共享信息库组成。可通过共享信息库

进行信息交换，也可通过中心交换节点进行信息交换。

4.2.2交换信息

交换信息是端交换节点存储的、与“辽宁省冷链食品安全追溯平台”交换的信息资源。

4.2.3交换关系

辽宁省冷链食品安全追溯平台作为中心交换节点，管理交换域内端交换节点信息交互服务，提供点到

点、一点到多点的信息路由和信息可靠传输等功能，并根据需求形成辽宁省冷链食品安全追溯信息基础数

据库。

各部门系统作为交换域的端交换节点，负责接收、汇聚相关部门的信息，完成业务信息与交换信息转

换操作，并通过交换服务实现信息的传送和处理。

4.2.4共享信息库

共享信息库可以为多个端交换节点提供一致的冷链食品安全追溯信息共享数据。

5数据交换类型

5.1数据交换类型分类

数据交换类型分为文件交换、数据库对接和服务调用。

5.2文件交换

在数据交换信息中，汉字使用中文半角，英文字母、数字和符号使用英文半角，交换数据应采用UTF-8

编码格式。

5.3数据库对接

数据提供单位需为每条交换数据记录增加设置两个数据项：记录ID(GUID)、记录入库时间。其中：记

录ID为数据记录指纹，由记录原始生成单位赋值，采用GUID机制，以标识记录的全局唯一性，是每一条

冷链食品安全追溯信息的信息主键。对于文件交换方式，记录入库时间指数据传送文件生成的时间；对于

数据库对接方式，记录入库时间指数据加载到端交换节点前置机数据库的时间。

5.4服务调用

通过WebService传递参数，参数按照XML数据交换格式定义。

6数据交换模式

3

DB21/T3840-2023

6.1数据交换模式分类

辽宁省冷链食品安全追溯平台数据交换模式分为数据上报和数据共享。

6.2数据上报

6.2.1数据上报流程

数据上报流程包括数据生成、数据传输、数据确认、获取反馈及对账确认等，见图2。

图2数据上报流程图

6.2.2数据生成

根据约定的报送周期，数据报送交换节点按本文件要求，将报送信息生成需要传送的数据，见图2中

①。报送数据起始时间、报送周期可在工作细则中约定。当数据报送交换节点为端交换节点、数据接收交

换节点为中心交换节点时，初次传输应为数据集全量传输，之后按增量传输。

6.2.3数据传输

数据报送交换节点通过可靠的数据传送服务，将数据传送到数据接收交换节点，数据传送服务应能支

持断点续传，并要求记录传送成功的标志，见图2中②。

6.2.4数据确认

当数据接收交换节点接收到数据报送交换节点传送来的数据时，应该就数据的内容（具体内容参见表1）

进行确认，见图2中③。

6.2.5获取反馈

4

DB21/T3840-2023

当数据接收交换节点对接收到的数据进行确认后，按照表1内容生成对账数据库表记录，并将记录反

馈到数据报送交换节点，见图2中④。

6.2.6对账确认

当数据报送交换节点接收到数据接收交换节点传送来的对账数据库表记录时，应该就记录内容（具体

内容参见表1）进行对账确认，如确认无误则数据传输成功，如对账存在出入则数据传输失败，需要重新传

输，见图2中⑤。

6.3数据共享

6.3.1共享数据

辽宁省冷链食品安全追溯平台生成的数据作为业务部门的共享数据，共享数据见表1。

表1共享数据

字段名称数据类型中文注释说明

FILE_NAMEVARCHAR(64)交换文件名称

REV_TIMEDATETIME(16)接收时间

仅用于文件交换方式

FILE_SIZEVARCHAR(16)交换文件大小

FILE_NUMNUMBER(16)交换文件数量

FILE_TYPEVARCHAR(32)交换文件格式

TABLE_NAMEVARCHAR(32)数据库表名称

INSERT_TIMEDATETIME(16)入库时间仅用于数据库对接方式

DATA_SUMNUMBER(16)入库记录数量

SOURCEVARCHAR(16)交换数据来源文件交换方式和数据库对接

方式复用

FEEDBACK_TIMEDATETIME(16)时间戳

6.3.2文件交换

文件交换格式

对于结构化数据，应支持三种文件交换格式，分别为XML格式、EXCEL格式、TXT格式；对于非结构

化数据，无交换格式限制；对于压缩文件，采用ZIP交换格式，支持国产软件压缩格式。

XML文件交换格式

XML交换数据文件应符合XML1.0规范。声明部分应使用XML语言表述，数据包包头放置数据资源描述

信息应由数据资源名称、单位代码、单位名称、交换时间、加载标志（全量加载、增量加载）、更新频率、

交换数据量、共享范围、主体类别、数据资源描述项（数据包包头）组成，见附录B.1。

5

DB21/T3840-2023

XML格式限定文件大小，单个XML格式文件不应超过150M，如超出，需要拆分成多个XML文件；采用

XML文件进行文件交换的节点，应提供符合约定的Schema文件，以定义交换数据语义上的限制；XML中共

有&、<、>、“、’这5个特殊的字符，当XML数据内容中存有这些特殊字符时，需对XML文件做特殊处理，

将特殊字符按照表2中内容转换为转义字符，生成标准XML文件。

表2XML特殊字符与对应的转义字符

特殊字符&<>“’

转义字符&<>""

EXCEL文件交换格式

.1交换格式基本要求

EXCEL文件交换格式应满足以下基本要求：

1）第一行为数据资源描述信息，包括：数据资源描述项及描述内容，数据资源描述项及

描述内容之间的分隔符为“:”，数据资源描述项之间的描述分隔符为“|”；

2）第二行为数据项名称；

3）第三行开始为数据记录信息；

4）EXCEL数据资源描述信息格式示例见表3。

表3EXCEL数据资源描述信息格式示例

法人名称统一社会信用组织机构....记录ID记录入库时间

代码代码.

XXXX有限公司913702027875XX210043....337C7F2B-7A34-4F50-9141-BAB9E64202110101258

60XXXX-3.78CC830

XXXX公司913204817550XX275833....38BDDF48-F43C-4858-8E0D-78761EA202110101258

71XXXX-5.A1CE640

.2遵循的其他约定

EXCEL文件交换格式还应遵循以下约定：

1)EXCEL格式应为EXCEL2007及以上版本；

2)数据名称信息（列名）只占一行，每个数据项只占一个单元格，禁止合并单元格；

3)单个EXCEL格式文件不应超过150M，如超出，应拆分成多个EXCEL文件；

4)仅支持单SHEET页，后续更新数据应与之前保持一致；

5)对于12位及以上的数字（如身份证号码），应将要输入的单元格设置成文本格式，避免科学计数

法的出现。

6

DB21/T3840-2023

TXT文件交换格式

.1交换格式基本要求

TXT文件交换格式应满足以下基本要求：

1）第一行为数据资源描述信息，包括数据资源描述项及描述内容。数据资源描述项及描述内容之间

的分隔符为“:”，数据资源描述项之间的描述分隔符为“|”；

2）第二行为数据项名称，之间的分隔符为“|”，换行标识符为“\r\n”，封闭符为“^”；

3）第三行为数据记录，之间的分隔符为“|”,换行标志符为“\r\n”，封闭符为“^”；

4）TXT数据资源描述信息格式示例如表4所示。

表4TXT数据资源描述信息格式示例

SJZYMC:冷库信息|DWDM:0800|DWMC:沈阳关区|JHSJ:20211010|JZBZ:0|GXPL:月|SJL:50|GXFW:1|ZTLB:1

^法人名称|统一社会信用代码^|^组织机构代码^|^......^|^记录ID^|^记录入库时间^\r\n

^XXXX公司^|^91370202787560XXXX^|^XX210043-3^|^......^|^

337C7F2B-7A34-4F50-9141-BAB9E6478CC8^|^20211010125830^\r\n

^XXXX公司^|^223456789012345678^|^223456789^|^......^|^

38BDDF48-F43C-4858-8E0D-78761EAA1CE6^|^20211010125840^\r\n

.2遵循的其他约定

TXT文件交换格式还应遵循以下约定：

1）若数据项没有内容时，分隔符“|”不能省略，需保证完整性；

2）TXT格式限定文件大小，单个TXT格式文件不超过150M，如超出，需要拆分成多个TXT

文件；

3）若数据中出现分隔符“|”或封闭符“^”，应对其进行转义处理，“|”的转义符号为

“\”，“^”的转义符号为“\\”。

文件名规范

信息交换数据文件名应由信用接口类型标识、接入机构名称标识、信息类别标识、数据文件更新时间、

数据交换序号等五部分组成，各组成部分之间使用“_”连接，文件后缀为“.XML”、“.TXT”、“.EXCEL”

等，如图3所示。

7

DB21/T3840-2023

R_320000_C0301_20150101_001.XML

第5部分

第4部分

第3部分

第2部分

第1部分

图3文件名组成

各部分的具体要求如下：

1）第1部分：接口类型标识由1位大写英文字母表示，“R”代表上报数据接口，“S”代

表共享数据接口，“M”代表冷链食品安全追溯信息目录及元数据接口，可扩展；

2）第2部分：当交换节点为部门信息系统时，交换节点机构名称标识由3位数字表示，参

照GB/T4657中央党政机关、人民团体及其他机构代码；

3）第3部分：信息类别标识由1位大写英文字母和4位数字表示，“C0301”代表“区域

代码”；

4）第4部分：数据文件生成日期由8位数字表示，格式为“yyyymmdd”；

5）第5部分：数据文件交换序号由3位数字表示，由数据提供方生成，为十进制表示的小

于999的数字，起始值为001，主要是防止一次交换数据量过大（一次交换数据量不要超过2G），

可由多个文件构成。

文件打包规范

文件打包应满足以下要求：

1）当交换文件包含有多个XML、EXCEL或TXT文件时，可以对交换文件进行打包处理，每

个压缩文件大小不应超过2G，交换文件包可由多个压缩文件构成（压缩文件卷号由3位数字表示，

由数据提供方生成，为十进制表示的小于999的数字，起始值为001）；

2）压缩文件的命名格式为为“文件名”+“_卷号”+“.ZIP”。

6.3.3数据库对接接口

数据库对接接口应满足以下要求：

1）建前置机数据库：端交换节点在本地前置机上建立相应的源端前置机数据库表；中心交

换节点在本地前置机上建立对应的目标端前置机数据库表；

2）表资源发布：端交换节点将需要交换的数据库表注册为表资源，并将此表资源进行发布；

中心交换节点对数据端交换节点表资源进行资源订阅；

3）数据监控：通过监控前置数据库表中数据的变化,包括但不限于时间戳、标识位、触发

器方式，触发信息交换；

8

DB21/T3840-2023

4）交换策略：数据报送交换节点将需要交换的信息推送到数据报送交换节点的前置机数据

库表中，通过数据监控，数据接收交换节点前置机数据库从数据传输交换节点的前置机数据库表

中抽取数据到数据接收前置对应库中；

5）确认机制：当数据接收交换节点完成了对数据传输交换节点推送数据的获取后，以数据库表的方

式就数据的内容（交换文件名称、接收时间、交换文件大小、交换文件数量、交换文件格式、数

据库表名称、入库时间、入库记录数量、交换数据来源、时间戳）向数据报送交换节点进行对账

确认，如双方确认无误则数据库对接传输数据成功，如双方对账存在出入则数据库对接传输数据

失败，需要重新进行数据库对接传输。

6.3.4服务方式与服务交换接口

服务方式

服务方式实现数据交换，主要是指WebService交换方式。以WebService方式进行发布，采用HTTP通

讯协议进行同步通讯，实现数据交换。

服务交换接口

服务交换接口应满足以下要求：

1）报文规范：报文以XML标签形式封装，为报文头和报文体两部分；从交互方式，报文

分为请求报文