ICS 35.240.01 CCS L 78 深 DB4403 圳 市 地 方 标 准 DB4403/T 249—2022 进口冷链食品追溯数据接口规范 Data interface specification of imported cold-chain food traceability 2022-07-29 发布 深圳市市场监督管理局 2022-08-01 实施 发 布 DB4403/T 249—2022 目 次 前言.....................................................................................................................................................................II 1 范围.................................................................................................................................................................1 2 规范性引用文件............................................................................................................................................ 1 3 术语和定义.................................................................................................................................................... 1 4 缩略语.............................................................................................................................................................1 5 基本要求........................................................................................................................................................ 2 6 接口类型........................................................................................................................................................ 2 7 接口关系........................................................................................................................................................ 2 8 接口描述........................................................................................................................................................ 2 附录 A（资料性） 接口响应码说明............................................................................................................. 11 附录 B（资料性） 追溯数据对接实例......................................................................................................... 12 附录 C（资料性） 企业类型及编码说明..................................................................................................... 13 附录 D（资料性） 资质证照类型及编码..................................................................................................... 14 附录 E（资料性） 产品分类及编码............................................................................................................. 15 参考文献.............................................................................................................................................................17 I DB4403/T 249—2022 前 言 本文件按照 GB/T 1.1—2020《标准化工作导则 第 1 部分：标准化文件的结构和起草规则》的规 定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由深圳市市场监督管理局提出并归口。 本文件起草单位：深圳市市场监督管理局、深圳市标准技术研究院。 本文件主要起草人：李颖、徐立峰、练晓、吕恺文、王恒、苏巍、陈瑜、周哲、陈炜霖、陈利平、 施伟、林智明。 II DB4403/T 249—2022 进口冷链食品追溯数据接口规范 1 范围 本文件规定了进口冷链食品追溯系统数据接口的基本要求、接口类型、接口关系、接口描述。 本文件适用于企业、技术机构、监管部门在进口冷链食品追溯系统间的数据对接。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法 GB 12904 商品条码 零售商品编码与条码表示 GB 32100 法人和其他组织统一社会信用代码编码规则 DB4403/T 191—2021 食用农产品追溯码编码技术规范 IETF RFC 2818 TLS 上的 HTTP（HTTP over TLS） IETF RFC 3548 Base16，Base32，Base64 数据编码（The Base16，Base32，and Base64 data encodings） IETF RFC 3629 UTF-8，ISO 10646 转换格式（UTF-8，a transformation format of ISO 10646） 3 术语和定义 下列术语和定义适用于本文件。 3.1 冷链食品 cold-chain food 通过冷链实现物流过程运输的果蔬类、水产类、肉制品类、禽蛋类、乳制品、粮食类等易腐食品及 其加工制品等食品。 注：包括冷冻食品和冷藏食品。 3.2 追溯系统 traceability system 基于追溯码、文件记录、相关软硬件设备和通信网络，实现现代信息化管理并可获取产品追溯过程 中相关数据的集成。 [来源：GB/T 38155—2019，2.6] 3.3 集中监管仓 centralized supervision warehouse 具备进口冷链食品（3.1）相关疫情集中排查、集中管控、集中处置和产品外包装预防性消毒功能 的场所。 4 缩略语 下列缩略语适用于本文件。 GS1：国际物品编码协会（Global Standards 1） HTTPS：以安全为目标的HTTP通道（HyperText Transfer Protocol over Secure Socket Layer） JSON：一种轻量级的数据交换格式（JavaScript Object Notation） UTF-8：一种可变长度字符编码（8-bit Unicode Transformation Format） 1 DB4403/T 249—2022 5 基本要求 接口通过服务调用实现信息交换，应符合下列要求： ——采用IETF RFC 2818规定的HTTPS协议作为底层承载协议； ——采用IETF RFC 3629规定的UTF-8字符集； ——采用GB/T 7408规定的日期类型； ——采用IETF RFC 3548规定的Base64编码规则将图片文件转换为字符串； ——接口请求与接口响应均采用JSON数据格式； ——建立接口日志记录，能识别数据异常或追溯交换数据情况； ——发生错误时，通过接口将详细的错误信息返回至相关平台和节点系统，由相应平台和节点系 统对错误进行记录分析和整改。 6 接口类型 进口冷链食品追溯系统数据接口主要包括下列类型： ——主体信息类，包括但不限于主体信息类参数； ——产品信息类，包括但不限于产品品类信息、产品批次信息、入境货物检验检疫证明信息、海 关进口货物报关单信息、消毒证明信息、核酸检测证明信息、集中监管仓出库证明信息； ——冷库信息类，包括但不限于冷库信息类参数； ——追溯信息类，包括但不限于集中监管仓信息、收发货信息、出入库信息、运输信息。 7 接口关系 进口冷链食品追溯系统数据接口关系如图1所示。 图1 8 接口描述 8.1 2 接口请求 数据接口关系 DB4403/T 249—2022 接口请求参数说明见表1。 表1 头部参数 含义 接口请求参数 类型 说明 appid 调用编码 字符型 接 口 调 用