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

ICS35.240.60CCSL7037山东省地方标准DB37/T4350—2021重要产品追溯食用农产品省级平台数据接口规范Importantproducttraceability—Specificationforprovincialplatformdatainterfaceofedibleagriculturalproducts2021-03-11发布2021-04-11实施山东省市场监督管理局发布DB37/T4350—2021I目次前言.................................................................................II1范围...............................................................................12规范性引用文件.....................................................................13术语和定义.........................................................................14缩略语.............................................................................15基本要求...........................................................................16接口类型...........................................................................2省级平台与市级平台的接口类型...................................................26.1省级平台与节点系统的接口类型...................................................26.27对接要求...........................................................................28接口说明...........................................................................3接口请求.......................................................................38.1接口响应.......................................................................48.2附录A（资料性）代码类型.............................................................6A.1消息业务类型...................................................................6A.2追溯系统类型...................................................................6A.3响应码.........................................................................6A.4经营类型.......................................................................7A.5流通顺序码.....................................................................7A.6内部环节信息类型...............................................................8A.7检测报告类型...................................................................8附录B（资料性）业务参数示例.........................................................9参考文献.............................................................................12DB37/T4350—2021II前言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由山东省商务厅提出、归口并组织实施。本文件起草单位：山东省标准化研究院、浪潮软件股份有限公司。本文件主要起草人：王玎、梁厚广、王志恒、吴业虎、朱承鑫、陈通。DB37/T4350—20211重要产品追溯食用农产品省级平台数据接口规范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,andBase64DataEncodings）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字符集；DB37/T4350—20212——采用符合GB/T7408规定的日期类型；——采用符合IETFRFC3548规定的BASE64编码规则将图片文件转换为字符串；——接口请求与接口响应均采用JSON数据格式；——建立接口日志记录，能识别数据异常或追溯交换数据情况；——发生错误时，接口将详细的错误信息返回至相关平台和节点系统，由各平台和节点系统对错误进行记录分析和整改。6接口类型省级平台与市级平台的接口类型6.1主要包括下列类型：——主体备案信息类：用于市级平台上报节点主体备案信息至省级平台；——产品备案信息类：用于市级平台上报节点产品备案信息至省级平台；——追溯业务信息类：用于市级平台上报节点追溯业务信息至省级平台，业务信息包括但不限于种植信息、养殖信息、生产加工信息、屠宰信息、批发（配送）信息、零售信息、消费信息、召回信息等。省级平台与节点系统的接口类型6.2主要包括：追溯业务信息类，用于节点系统上报节点追溯业务信息至省级平台，该信息是用于面向消费者展示的追溯查询数据。7对接要求接入前应按照DB37/T3659—2019中第6章的要求提出申请、取得入驻资格。对接示意图见图1。7.1DB37/T4350—20213省级平台主体备案信息接口产品备案信息接口追溯业务信息接口在线填报在线填报追溯业务信息接口市级平台主体备案信息产品备案信息追溯业务信息种植信息养殖信息生产加工信息屠宰信息批发信息零售信息消费信息召回信息节点系统主体备案信息产品备案信息追溯业务信息种植信息养殖信息生产加工信息屠宰信息批发信息零售信息消费信息召回信息注：节点系统的主体备案信息、产品备案信息不通过接口传输，直接从省级平台在线填报，省级平台审核通过后，该节点系统追溯业务信息接口方可使用。图1对接示意图应采用省级平台分配的授权密匙，以SHA-256摘要算法生成签名数据，采用post提交方法（Method）7.2及application/json内容类型（Content-Type）上传数据。节点系统应向省级平台申请追溯码，省级平台接收请求数据，审核校验成功后生成正式的追溯码，7.3并按申请数量反馈消息至节点系统；节点系统接收响应数据，将上报批次产品数据与省级平台返回的追溯码及追溯网址绑定，生成二维码标识。8接口说明接口请求8.18.1.1公共请求请求参数表见表1。表1公共请求参数名称含义类型是否可空说明BIZ_TYPE业务消息类型字符串否见附录A中的表A.1REQ_TIME请求时间日期时间型否yyyy-MM-ddHH:mm:ssREQ_ID请求编码字符串否yyyyMMddHHmmss+6位字母数字组合随机码AUTH_ID认证编码字符串否省级平台提供的授权密匙，SHA-265加密PARAM业务请求参数字符串否见8.1.2，JSON子节点，自由文本DB37/T4350—20214请求格式示例见表2。表2请求格式{BIZ_TYPE:traceDataRequest,REQ_TIME:2020-01-1000:00:00,REQ_ID:20200721084654qJJ2Jb,AUTH_ID:20200609153209831756,PARAM:{}}8.1.2业务请求业务请求参数应根据接口类型的不同做相应调整，具体参数见对应接口的WSDL（Web服务描述语言，WebServicesDescriptionLanguage）文件，应符合GB/T38154—2019中的相关规定。追溯业务信息参数示例见附录B。接口响应8.28.2.1公共响应公共响应参数见表3。表3公共响应参数名称含义类型是否可空说明BIZ_TYPE业务类型字符串否见附录A中的表A.1RESP_TIME响应时间日期时间型否yyyy-MM-ddHH:mm:ssRESP_ID响应编码字符串否响应方产生的唯一编码REQ_ID请求编码字符串否请求方的唯一编码RESULT响应数据参数字符串否JSON子节点，自由文本响应格式示例见表4。表4响应格式{BIZ_TYPE:traceDataRequest,RESP_TIME:2020-01-1000:00:00,RESP_ID:20200721084836BSoICl,REQ_ID:20200721084654qJJ2Jb,RESULT:{}}8.2.2业务响应业务响应结果信息见表5。DB37/T4350—20215表5业务响应参