DB37/T 4350-2021 重要产品追溯 食用农产品省级平台数据接口规范

ICS35.240.60

CCSL70

37

山东省地方标准

DB37/T4350—2021

重要产品追溯食用农产品省级平台数据

接口规范

Importantproducttraceability—Specificationforprovincialplatformdatainterface

ofedibleagriculturalproducts

2021-03-11发布2021-04-11实施

山东省市场监督管理局发布

DB37/T4350—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消息业务类型...................................................................6

A.2追溯系统类型...................................................................6

A.3响应码.........................................................................6

A.4经营类型.......................................................................7

A.5流通顺序码.....................................................................7

A.6内部环节信息类型...............................................................8

A.7检测报告类型...................................................................8

附录B（资料性）业务参数示例.........................................................9

参考文献.............................................................................12

I

DB37/T4350—2021

前言

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

起草。

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

本文件由山东省商务厅提出、归口并组织实施。

本文件起草单位：山东省标准化研究院、浪潮软件股份有限公司。

本文件主要起草人：王玎、梁厚广、王志恒、吴业虎、朱承鑫、陈通。

II

DB37/T4350—2021

重要产品追溯食用农产品省级平台数据接口规范

1范围

本文件规定了食用农产品省级追溯管理平台（以下简称“省级平台”）追溯数据接口的基本要求、

接口类型、对接要求、接口说明。

本文件适用于省级平台与食用农产品市级追溯管理平台（以下简称“市级平台”）之间及省级平台

与食用农产品追溯节点（以下简称“节点”）系统之间的对接，其他相关平台或系统的接入参照执行。

2规范性引用文件

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

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

文件。

GB/T7408数据元和交换格式信息交换日期和时间表示法

GB/T18391.1信息技术元数据注册系统（MDR）第1部分：框架

GB/T38154—2019重要产品追溯核心元数据

GB/T38155重要产品追溯追溯术语

DB37/T3659—2019重要产品追溯食用农产品省市平台管理规范

IETFRFC2818TLS上的HTTP（HTTPOverTLS）

IETFRFC3548Basel6、Base32、Base64数据编码（TheBasel6,Base32,andBase64Data

Encodings）

IETFRFC3629UTF—8，ISO10646转换格式（UTF-8,atransformationformatofISO10646）

3术语和定义

GB/T18391.1、GB/T38155、DB37/T3659界定的术语和定义适用于本文件。

4缩略语

下列缩略语适用于本文件。

HTTPS：以安全为目标的HTTP通道（HyperTextTransferProtocoloverSecureSocketLayer）

JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）

SHA-256：安全杂凑算法（SecureHashAlgorithm），摘要输出长度为32字节

UTF-8：一种可变长度字符编码（8-bitUnicodeTransformationFormat）

5基本要求

接口通过服务调用实现信息交换，应符合下列要求：

——采用符合IETFRFC2818的HTTPS协议作为底层承载协议；

——采用符合IETFRFC3629规定的UTF-8字符集；

1

DB37/T4350—2021

——采用符合GB/T7408规定的日期类型；

——采用符合IETFRFC3548规定的BASE64编码规则将图片文件转换为字符串；

——接口请求与接口响应均采用JSON数据格式；

——建立接口日志记录，能识别数据异常或追溯交换数据情况；

——发生错误时，接口将详细的错误信息返回至相关平台和节点系统，由各平台和节点系统对错

误进行记录分析和整改。

6接口类型

6.1省级平台与市级平台的接口类型

主要包括下列类型：

——主体备案信息类：用于市级平台上报节点主体备案信息至省级平台；

——产品备案信息类：用于市级平台上报节点产品备案信息至省级平台；

——追溯业务信息类：用于市级平台上报节点追溯业务信息至省级平台，业务信息包括但不限于

种植信息、养殖信息、生产加工信息、屠宰信息、批发（配送）信息、零售信息、消费信息、

召回信息等。

6.2省级平台与节点系统的接口类型

主要包括：追溯业务信息类，用于节点系统上报节点追溯业务信息至省级平台，该信息是用于面向

消费者展示的追溯查询数据。

7对接要求

7.1接入前应按照DB37/T3659—2019中第6章的要求提出申请、取得入驻资格。对接示意图见图1。

2

DB37/T4350—2021

省级平台

主体产品

备案备案追溯业务

信息信息信息接口

接口接口

市级平台

追溯

在线在线业务主体产品追溯

填报填报信息

备案备案业务种植养殖生产加屠宰批发零售消费召回

接口信息信息工信息信息信息信息信息信息

信息信息信息

节点系统

主体产品追溯

备案备案业务种植养殖生产加屠宰批发零售消费召回

信息信息工信息信息信息信息信息信息

信息信息信息

注：节点系统的主体备案信息、产品备案信息不通过接口传输，直接从省级平台在线填报，省级平台审核通过后，

该节点系统追溯业务信息接口方可使用。

图1对接示意图

7.2应采用省级平台分配的授权密匙，以SHA-256摘要算法生成签名数据，采用post提交方法（Method）

及application/json内容类型（Content-Type）上传数据。

7.3节点系统应向省级平台申请追溯码，省级平台接收请求数据，审核校验成功后生成正式的追溯码，

并按申请数量反馈消息至节点系统；节点系统接收响应数据，将上报批次产品数据与省级平台返回的追

溯码及追溯网址绑定，生成二维码标识。

8接口说明

8.1接口请求

8.1.1公共请求

请求参数表见表1。