您当前的位置:首页>行业标准>DB44/T 2601.4-2025 冷链食品追溯 第4部分:数据共享与交换接口规范

DB44/T 2601.4-2025 冷链食品追溯 第4部分:数据共享与交换接口规范

资料类别:行业标准

文档格式:PDF电子版

文件大小:495.23 KB

资料语言:中文

更新时间:2025-08-13 10:34:01



相关搜索: 规范 接口 部分 交换 追溯

内容简介

DB44/T 2601.4-2025 冷链食品追溯 第4部分:数据共享与交换接口规范 ICS 35.240.99
CCS L 67 44
广
东 省 地 方 标 准
DB44/T 2601.4—2025
冷链食品追溯 第 4 部分:数据共享与交换
接口规范
Cold chain food traceability— Part4:Data sharing and exchange interface
specification
2025 - 01 - 13 发布
2025 - 04 - 13 实施
广东省市场监督管理局 发 布
DB44/T 2601.4—2025


前言 ................................................................................. II
1 范围 ............................................................................... 1
2 规范性引用文件 ..................................................................... 1
3 术语和定义 ......................................................................... 1
4 缩略语 ............................................................................. 1
5 基本要求 ........................................................................... 1
6 接口协议 ........................................................................... 1
7 数据共享和交换要求 ................................................................. 3
附录 A(资料性) 数据交换共享请求 JSON 示例 ............................................ 5
附录 B(资料性) 数据交换成功返回 JSON 示例 ........................................... 6
附录 C(资料性) 数据交换失败返回 JSON 示例 ........................................... 7
参考文献 .............................................................................. 8
I
DB44/T 2601.4—2025


本文件按照GB/T 1.1—2020《标准化工作导则 第1部分:标准化文件的结构和起草规则》的规定
起草。
本文件是DB44/T 2601《冷链食品追溯》的第4部分。DB44/T 2601已经发布了以下部分:
——第1部分:电子追溯凭证参考格式;
——第2部分:集中仓管理要求;
——第3部分:交换数据集;
——第4部分:数据共享与交换接口规范;
——第5部分:信息分类与编码规则;
——第6部分:统计指标。
请注意本文件的某些内容可能涉及专利,本文件的发布机构不承担识别专利的责任。
本文件由广东省市场监督管理局(食品经营安全监管)提出、归口,并组织实施。
本文件起草单位:广州软件应用技术研究院、广州中科易德科技有限公司。
本文件主要起草人:袁敏夫、李引、董雯雯、林淑英、廖娟、钟百川、谭教珠、杨世峰、何川、何
维、王一龙、肖景贤、刘东成、孙微微、郑翔蔚。
II
DB44/T 2601.4—2025
冷链食品追溯 第 4 部分:数据共享与交换接口规范
1 范围
本文件规定了冷链食品追溯中数据接口协议以及数据共享与交换的要求。
本文件适用于企业系统、地市监管系统与广东省冷链食品追溯系统之间数据的对接与传输。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,
仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本
文件。
GB/T 11457 信息技术 软件工程术语
GB/T 35295 信息技术 大数据 术语
GB/T 36345 信息技术 通用数据导入接口
GB/T 38672 信息技术 大数据 接口基本要求
GB/T 43195 进口冷链食品追溯 追溯系统开发指南
3 术语和定义
GB/T 11457、GB/T 35295界定的术语和定义适用于本文件。
4 缩略语
下列缩略语适用于本文件。
JSON:JS 对象标记(JavaScript Object Notation)
HTTPS:安全超文本传输协议(HyperText Transfer Protocol Secure)
5 基本要求
数据安全性
数据传输和认证过程中应采用可靠加密方案,宜使用国密系列算法。
数据可靠性
传输过程应通过有效的校验机制验证数据包的完整性和正确性。
数据可拓展性
接口设计应具备灵活性,能够适应数据量与业务需求的增长,支持横向扩展及兼容未来技术升级。
6 接口协议
1
DB44/T 2601.4—2025
通讯协议
数据通信基于 TCP/IP 协议和 HTTPS 协议,并符合 GB/T 36345 的要求。包括以下情况:
a) 建立连接:采用 HTTPS 通信方式,进行端口监听,准备接收连接请求,并根据业务需求进行
数据传输,传输结束后断开网络;
b) 超时重发:一条指令发出后,在规定时间内未收到回应,则认为超时;超时后应重发,重发 3
次后,仍未收到回应,则认为通讯失败,应自动重建连接。超时时间可根据具体情况自行设定;
c) 通信周期:支持被动传输和主动定时传输两种数据传输模式,主动定时传输周期可从 5 min
到 24 h 灵活配置。
接口协议数据结构
6.2.1 数据包组成
接口协议数据包的组成应符合图 1 的规定。其中实体数据为经过加密的 JSON 格式数据,加密后
以 ASCII 码的格式进行传输,其他数据明码传输。
图1 数据包的组成
6.2.2 数据包的结构
数据包的结构见表 1。
表1 数据包的结构
项目 类型 长度 说明
包头 十六进制 4字节 固定为0x68 0x68 0x16 0x16
实体数据总长度 十六进制 4字节 代表当前数据包中的实体数据长度
实体数据 字符 N字节(M+4) 实体数据为数据包的实体内容。M含义见表3
校验 十六进制 2字节 对实体数据进行循环冗余校验
包尾 十六进制 4字节 固定为0x55 0xAA 0x55 0xAA
6.2.3 实体数据的结构
实体数据的结构见表 2。
2
DB44/T 2601.4—2025
表2 实体数据的结构
项目 类型 长度 说明
数据序列 十六进制 4字节 标识了发送者的数据序号,应答时,本项内容应 按照发送者提供的数据序号进行填充。
数据内容 字符 M字节 根据数据序号,内容不同,数据内容是经过加密 的 JSON 格式数据,加密后以 ASCII 码的格式进 行传输。
7 数据共享和交换要求
数据共享要求
数据共享应符合以下要求:
a) 数据共享以 WEB 服务等方式提供,参照 GB/T 36345 和 GB/T 38672 的要求进行;
b) 数据共享服务的设计、封装、开发参照 GB/T 43195 的要求进行。
数据交换方式
数据交换参照GB/T 43195的要求进行,分为以下三个阶段:
a) 数据使用方通过 HTTPS 向数据提供方发起数据交换请求;
b) 数据提供方收到数据交换请求,解析数据报文,进行校验后对合法数据进行发送,非法数据则
发送错误代码;
c) 数据使用方接收数据并存储,返回一个数据报文,数据提供方根据返回数据报文判断本次数据
交换是否成功。
数据交换与内容格式
数据交换的内容采用 JSON 作为数据交换的媒介。
数据交换请求
7.4.1 数据交换请求 JSON 格式
数据交换请求JSON格式应包含以下参数:
a) accessToken:调用接口的令牌。登陆成功后,返回一个 32 位的 Hash 字符串;
b) timestamp:接口使用方发出请求的客户端时间(采用东八区系统时间 UTC/GMT+08:00);
c) totalNum:表示数据交换所携带的记录数量;
d) data:为 JSON 数组,存放交换数据。
7.4.2 数据交换请求示例可参见附录 A。
数据交换返回
7.5.1 数据交换返回 JSON 格式
数据交换返回JSON格式包括以下信息:
a) errorCode:为错误代码,表明数据交换失败的原因。当数据交换成功时,该参数为 0;当数
据交换失败时,该参数为自定义的错误代码;
3
DB44/T 2601.4—2025
b) errorMessage:为返回结果信息,描述数据交换出错的具体情况。当数据交换成功时,该参数
为空值;当数据交换失败时,该参数为自定义的错误原因;
c) success:标志此次数据交换是否成功。成功为 true,失败为 false;
d) data:当数据交换成功时,则 data 参数为空值;当数据交换失败时,data 参数存放交换失
败的数据。
7.5.2 数据交换返回示例可参见附录 B 和附录 C 。
4
DB44/T 2601.4—2025
附 A A A

(资料性)
数据交换共享请求 JSON 示例
下面给出数据交换共享请求的JSON示列,见图A.1。
示例:
https://{SERVER_IP}/{SYTSTEM_NAME}/? accessToken=C7ABF9DAD2F94BB1907ADE0AFE3F4EC1&resourceCode=0104001×tamp=20171109153905 Content-Type: application/json { "totalNum": 1, "data": [{ "P_OPERATION": "ADD", "ENT_CREDIT_CODE": "5CFC5CABA549CA9DE050A8C0DD01357A", "ENT-NAME": “广州市XX食品有限公司”, "ENT_LEGAL": "张XX", "ENT_ADD": "广州市XX区XX路XX号", "ENT_AREA_CODE": "440106", "ENT-TYPE": "1", "ENT_REMARK": null, …… }] }
图A.1 数据交换请求 JSON 示例
5
DB44/T 2601.4—2025
附 B B B

(资料性)
数据交换成功返回 JSON 示例
下面给出数据交换成功返回 JSON 示例,见图B.1。
示例:
{ "errorCode": "0", "errorMessage": "", "success": "true", "data": [] }
图B.1 数据交换成功返回 JSON 示例
6
DB44/T 2601.4—2025
附 C C C

(资料性)
数据交换失败返回 JSON 示例
下面给出数据交换失败返回 JSON 示例,见图C.1。
示例:
{ "errorCode": "00000003", "errorMessage": "JSON数据验证失败", "success": "false", "data": [{"P_ID":"JY14406040114403"}, {"ZTYT":"40001001"}] }
图C.1 数据交换失败返回 JSON 示例
7
DB44/T 2601.4—2025
参 考 文 献
[1] GB/T 43195—2023 进口冷链食品追溯 追溯系统开发指南
[2] GB/T 43268—2023 进口冷链食品追溯 追溯体系通则
[3] GB/T 36088—2018 冷链物流信息管理要求
[4] DB4403/T 249—2022 进口冷链食品追溯数据接口规范
[5] DB13/T 5864—2023 冷链食品协同追溯技术规范
8
DB44/T 2601.4—2025

广 东 省 地 方 标 准 冷链食品追溯 第 4 部分:数据共享与 交换接口规范 DB44/T 2601.4—2025 * 广东省标准化研究院组织印刷 广州市海珠区南田路 563 号 1304 室 邮政编码:510220 电话:020-84250337 9
DB44/T 2601.4—2025
上一章:DB5113/T 47-2024 文物保护组织消防安全管理规范 下一章:DB44/T 2601.3-2025 冷链食品追溯 第3部分:交换数据集

相关文章

DB44/T 2601.3-2025 冷链食品追溯 第3部分:交换数据集 DB4403/T 249-2022 进口冷链食品追溯数据接口规范 DB44/T 2601.1-2025 冷链食品追溯 第1部分:电子追溯凭证参考格式 GB/T 36478.4-2019 物联网信息交换和共享第4部分:数据接口 GB/T 36478.4-2019 物联网 信息交换和共享 第4部分:数据接口 DB44/T 2601.6-2025 冷链食品追溯 第6部分:统计指标 DB45/T 2932.4-2024 视频共享交换平台 第4部分:应用接口规范 CFDAB/T 0401-2014 食品药品监管数据共享与交换接口规范