ICS 35.240.60 CCS L 70 37 山 东 省 地 方 标 准 DB 37/T 4350—2021 重要产品追溯 食用农产品省级平台数据 接口规范 Important product traceability—Specification for provincial platform data interface of edible agricultural products 2021 - 03 - 11 发布 2021 - 04 - 11 实施 山东省市场监督管理局 发 布 DB 37/T 4350—2021 目 次 前言 ................................................................................. II 1 范围 ............................................................................... 1 2 规范性引用文件 ..................................................................... 1 3 术语和定义 ......................................................................... 1 4 缩略语 ............................................................................. 1 5 基本要求 ........................................................................... 1 6 接口类型 ........................................................................... 2 6.1 省级平台与市级平台的接口类型 ................................................... 2 6.2 省级平台与节点系统的接口类型 ................................................... 2 7 对接要求 ........................................................................... 2 8 接口说明 ........................................................................... 3 8.1 接口请求 ....................................................................... 3 8.2 接口响应 ....................................................................... 4 附录 A（资料性） 代码类型 ............................................................. 6 A.1 A.2 A.3 A.4 A.5 A.6 A.7 消息业务类型 ................................................................... 追溯系统类型 ................................................................... 响应码 ......................................................................... 经营类型 ....................................................................... 流通顺序码 ..................................................................... 内部环节信息类型 ............................................................... 检测报告类型 ................................................................... 6 6 6 7 7 8 8 附录 B（资料性） 业务参数示例 ......................................................... 9 参考文献 ............................................................................. 12 I DB 37/T 4350—2021 前 言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由山东省商务厅提出、归口并组织实施。 本文件起草单位：山东省标准化研究院、浪潮软件股份有限公司。 本文件主要起草人：王玎、梁厚广、王志恒、吴业虎、朱承鑫、陈通。 II DB 37/T 4350—2021 重要产品追溯 食用农产品省级平台数据接口规范 1 范围 本文件规定了食用农产品省级追溯管理平台（以下简称“省级平台”）追溯数据接口的基本要求、 接口类型、对接要求、接口说明。 本文件适用于省级平台与食用农产品市级追溯管理平台（以下简称“市级平台”）之间及省级平台 与食用农产品追溯节点（以下简称“节点”）系统之间的对接，其他相关平台或系统的接入参照执行。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法 GB/T 18391.1 信息技术 元数据注册系统（MDR） 第1部分：框架 GB/T 38154—2019 重要产品追溯 核心元数据 GB/T 38155 重要产品追溯 追溯术语 DB37/T 3659—2019 重要产品追溯 食用农产品省市平台管理规范 IETF RFC 2818 TLS上的HTTP（HTTP Over TLS） IETF RFC 3548 Basel6、Base32、Base64 数据编码（The Basel6, Base32, and Base64 Data Encodings） IETF RFC 3629 UTF—8，ISO 10646转换格式（UTF-8, a transformation format of ISO 10646） 3 术语和定义 GB/T 18391.1、GB/T 38155、DB37/T 3659界定的术语和定义适用于本文件。 4 缩略语 下列缩略语适用于本文件。 HTTPS：以安全为目标的HTTP通道（HyperText Transfer Protocol over Secure Socket Layer） JSON：一种轻量级的数据交换格式（JavaScript Object Notation） SHA-256：安全杂凑算法（Secure Hash Algorithm），摘要输出长度为32字节 UTF-8：一种可变长度字符编码（8-bit Unicode Transformation Format） 5 基本要求 接口通过服务调用实现信息交换，应符合下列要求： ——采用符合 IETF RFC 2818 的 HTTPS 协议作为底层承载协议； ——采用符合 IETF RFC 3629 规定的 UTF-8 字符集； 1 DB 37/T 4350—2021 ——采用符合 GB/T 7408 规定的日期类型； ——采用符合 IETF RFC 3548 规定的 BASE64 编码规则将图片文件转换为字符串； ——接口请求与接口响应均采用 JSON 数据格式； ——建立接口日志记录，能识别数据异常或追溯交换数据情况； ——发生错误时，接口将详细的错误信息返回至相关平台和节点系统，由各平台和节点系统对错 误进行记录分析和整改。 6 接口类型 6.1 省级平台与市级平台的接口类型 主要包括下列类型： ——主体备案信息类：用于市级平台上报节点主体备案信息至省级平台； ——产品备案信息类：用于市级平台上报节点产品备案信息至省级平台； ——追溯业务信息类：用于市级平台上报节点追溯业务信息至省级平台，业务信息包括但不限于 种植信息、养殖信息、生产加工信息、屠宰信息、批发（配送）信息、零售信息、消费信息、 召回信息等。 6.2 省级平台与节点系统的接口类型 主要包括：追溯业务信息类，用于节点系统上报节点追溯业务信息至省级平台，该信息是用于面向 消费者展示的追溯查询数据。 7 对接要求 7.1 接入前应按照 DB37/T 3659—2019 中第 6 章的要求提出申请、取得入驻资格。对接示意图见图 1。 2 DB 37/T 4350—2021 省级平台 主体 备案 信息 接口 产品 备案 信息 接口 追溯业务 信息接口 市级平台 在线 填报 追溯 业务 信息 接口 在线 填报 主体 备案 信息 产品 备案 信息 追溯 业务 信息 种植 信息 养殖 信息 生产加 工信息 批发 信息 零售 信息 屠宰 信息 批发 信息 零售 信息 消费 信息 召回 信息 节点系统 主体 备案 信息 产品 备案 信息 追溯 业务 信息 种植 信息 养殖 信息 生产加 工信息 屠宰 信息 消费 信息 召回 信息 注： 节点系统的主体备案信息、产品备案信息不通过接口传输，直接从省级平台在线填报，省级平台审核通过后， 该节点系统追溯业务信息接口方可使用。 图1 对接示意图 7.2 应采用省级平台分配的授权密匙， 以 SHA-256 摘要算法生成签名数据，采用 post 提交方法 （Method） 及 application/json 内容类型（Content-Type）上传数据。 7.3 节点系统应