ICS35.240.60 CCSL70 DB37 山东省地 方 重要产品追溯 标准 DB37/T4350-2021 食用农产品省级平台数据 接口规范 Important product traceabilitySpecification for provincial platform data interfaceofedibleagriculturalproducts2021-03-11发布 山东省市场监督管理局 发布 2021-04-11实施 前言 范围 2 规范性引用文件 术语和定义， 3 4 缩略语， 基本要求. 5 接口类型. 6 6.1省级平台与市级平台的接口类型6.2省级平台与节点系统的接口类型对接要求. 7 接口说明.. 8 8.1接口请求. 8.2接口响应 附录A（资料性） A.1 A.2 A.3 代码类型. 消息业务类型. 追系统类型 响应码. 经营类型.. A.4 A.5 A.6 A.7 流通顺序码 内部环节信息类型 检测报告类型 附录B（资料性） 参者文献 业务参数示例 目 次 DB37/T4350—2021 I 2 前言 DB37/T4350—2021 本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由山东省商务厅提出、归口并组织实施。本文件起草单位：山东省标准化研究院、浪潮软件股份有限公司。本文件主要起草人：王、梁厚广、主志恒、吴业虎、朱承鑫、陈通11 1范围 DB37/T4350—2021 重要产品追溯食用农产品省级平台数据接口规范本文件规定了食用农产品省级追溯管理平台（以下简称“省级平台”）追溯数据接口的基本要求、接口类型、对接要求、接口说明。本文件适用于省级平台与食用农产品市级追溯管理平台（以下简称“市级平台”）之间及省级平台与食用农产品追溯节点（以下简称“节点”）系统之间的对接，其他相关平台或系统的接入参照执行。2规范性引用文件 2 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件仅该日期对应的版本适用于本文件：不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T7408数据元和交换格式信息交换日期和时间表示法GB/T18391.1信息技术元数据注册系统（MDR）第1部分：框架GB/T38154一2019重要产品追溯核心元数据GB/T38155重要产品追溯追溯术语DB37/T3659—2019重要产品追溯食用农产品省市平台管理规范IETFRFC2818TLS上的HTTP（HTTPOverTLS)IETFRFC3548Basel6、Base32、Base64数据编码（TheBase16，Base32，andBase64DataEncodings) IETFRFC3629 术语和定义 3 UTF-8，IS010646转换格式（UTF-8，atransformationformatofIS010646）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 一采用符合GB/T7408规定的日期类型：DB37/T43502021 一采用符合IETFRFC3548规定的BASE64编码规则将图片文件转换为字符串；一接口请求与接口响应均采用JSON数据格式；一建立接口日志记录，能识别数据异常或追潮交换数据情况：发生错误时，接口将详细的错误信息返回至相关平台和节点系统，由各平台和节点系统对错误进行记录分析和整改。 接口类型 6 6.1省级平台与市级平台的接口类型主要包括下列类型： 一一主体备案信息类：用于市级平台上报节点主体备案信息至省级平台：一产品备案信息类：用于市级平台上报节点产品备案信息至省级平台：一一追溯业务信息类：用于市级平台上报节点追溯业务信息至省级平台，业务信息包括但不限于种植信息、养殖信息、生产加工信息、屠宰信息、批发（配送）信息、零售信息、消费信息、召回信息等。 6.2省级平台与节点系统的接口类型主要包括：追溯业务信息类，用于节点系统上报节点追溯业务信息至省级平台，该信息是用于面向消费者展示的追溯查询数据。 7对接要求 7.1接入前应按照DB37/T3659—2019中第6章的要求提出申请、取得入驻资格。对接示意图见图1。2