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 I 目次 前言 ................................ ................................ ................. 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 DB44/T 2601.4 —2025 II 前言 本文件按照 GB/T 1.1 —2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 本文件是 DB44/T 2601《冷链食品追溯》的第 4部分。DB44/T 2601已经发布了以下部分： ——第1部分：电子追溯凭证参考格式； ——第2部分：集中仓管理要求； ——第3部分：交换数据集； ——第4部分：数据共享与交换接口规范； ——第5部分：信息分类与编码规则； ——第6部分：统计指标。 请注意本文件的某些内容可能涉及专利，本文件的发布机构不承担识别专利的责任。 本文件由广东省市场监督管理局（食品经营安全监管）提出、归口，并组织实施。 本文件起草单位：广州软件应用技术研究院、广州中科易德科技有限公司。 本文件主要起草人：袁敏夫、李引、董雯雯、林淑英、廖娟、钟百川、谭教珠、杨世峰、何川、何 维、王一龙、肖景贤、刘东成、孙微微、郑翔蔚。 DB44/T 2601.4 —2025 1 冷链食品追溯 第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 接口协议 DB44/T 2601.4 —2025 2 通讯协议 数据通信基于 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。 DB44/T 2601.4 —2025 3 表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.