DB37∕T 4350—2021 重要产品追溯 食用农产品省级平台数据接口规范(山东省).pdf
《DB37∕T 4350—2021 重要产品追溯 食用农产品省级平台数据接口规范(山东省).pdf》由会员分享,可在线阅读,更多相关《DB37∕T 4350—2021 重要产品追溯 食用农产品省级平台数据接口规范(山东省).pdf(15页珍藏版)》请在咨信网上搜索。
1、 ICS 35.240.60 CCS L 70 37 山东省地方标准 DB 37/T 43502021 重要产品追溯 食用农产品省级平台数据接口规范 Important product traceabilitySpecification for provincial platform data interface of edible agricultural products 2021 - 03 - 11 发布 2021 - 04 - 11 实施 山东省市场监督管理局 发 布 DB 37/T 43502021 I 目次 前言 . II 1 范围 . 1 2 规范性引用文件 . 1 3 术语和定
2、义 . 1 4 缩略语 . 1 5 基本要求 . 1 6 接口类型 . 2 省级平台与市级平台的接口类型 . 2 6.1 省级平台与节点系统的接口类型 . 2 6.2 7 对接要求 . 2 8 接口说明 . 3 接口请求 . 3 8.1 接口响应 . 4 8.2 附录 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 DB 37/T 43502021
3、II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分:标准化文件的结构和起草规则的规定起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由山东省商务厅提出、归口并组织实施。 本文件起草单位:山东省标准化研究院、浪潮软件股份有限公司。 本文件主要起草人:王玎、梁厚广、王志恒、吴业虎、朱承鑫、陈通。 DB 37/T 43502021 1 重要产品追溯 食用农产品省级平台数据接口规范 1 范围 本文件规定了食用农产品省级追溯管理平台(以下简称“省级平台”)追溯数据接口的基本要求、接口类型、对接要求、接口说明。 本文件适用于省级平台与食用农产品
4、市级追溯管理平台(以下简称“市级平台”)之间及省级平台与食用农产品追溯节点(以下简称“节点”)系统之间的对接,其他相关平台或系统的接入参照执行。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。 其中, 注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。 GB/T 7408 数据元和交换格式 信息交换 日期和时间表示法 GB/T 18391.1 信息技术 元数据注册系统(MDR) 第1部分:框架 GB/T 381542019 重要产品追溯 核心元数据 GB/T 38155 重要产品追溯 追溯术语
5、 DB37/T 36592019 重要产品追溯 食用农产品省市平台管理规范 IETF RFC 2818 TLS上的HTTP(HTTP Over TLS) IETF RFC 3548 Basel6、Base32、Base64 数据编码(The Basel6, Base32, and Base64 Data Encodings) IETF RFC 3629 UTF8,ISO 10646转换格式(UTF-8, a transformation format of ISO 10646) 3 术语和定义 GB/T 18391.1、GB/T 38155、DB37/T 3659界定的术语和定义适用于本文件。
6、 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 的 HTTP
7、S 协议作为底层承载协议; 采用符合 IETF RFC 3629 规定的 UTF-8 字符集; DB 37/T 43502021 2 采用符合 GB/T 7408 规定的日期类型; 采用符合 IETF RFC 3548 规定的 BASE64 编码规则将图片文件转换为字符串; 接口请求与接口响应均采用 JSON 数据格式; 建立接口日志记录,能识别数据异常或追溯交换数据情况; 发生错误时,接口将详细的错误信息返回至相关平台和节点系统,由各平台和节点系统对错误进行记录分析和整改。 6 接口类型 省级平台与市级平台的接口类型 6.1 主要包括下列类型: 主体备案信息类:用于市级平台上报节点主体备案信
8、息至省级平台; 产品备案信息类:用于市级平台上报节点产品备案信息至省级平台; 追溯业务信息类:用于市级平台上报节点追溯业务信息至省级平台,业务信息包括但不限于种植信息、养殖信息、生产加工信息、屠宰信息、批发(配送)信息、零售信息、消费信息、召回信息等。 省级平台与节点系统的接口类型 6.2 主要包括:追溯业务信息类,用于节点系统上报节点追溯业务信息至省级平台,该信息是用于面向消费者展示的追溯查询数据。 7 对接要求 接入前应按照 DB37/T 36592019 中第 6 章的要求提出申请、 取得入驻资格。 对接示意图见图 1。 7.1 DB 37/T 43502021 3 省级平台省级平台主体
9、主体备案备案信息信息接口接口产品产品备案备案信息信息接口接口追溯业务追溯业务信息接口信息接口在线填报在线填报追溯追溯业务业务信息信息接口接口市级平台市级平台主体备案信息产品备案信息追溯业务信息种植信息养殖信息生产加工信息屠宰信息批发信息零售信息消费信息召回信息节点系统节点系统主体备案信息产品备案信息追溯业务信息种植信息养殖信息生产加工信息屠宰信息批发信息零售信息消费信息召回信息 注: 节点系统的主体备案信息、产品备案信息不通过接口传输,直接从省级平台在线填报,省级平台审核通过后,该节点系统追溯业务信息接口方可使用。 图1 对接示意图 应采用省级平台分配的授权密匙, 以SHA-256摘要算法生成
10、签名数据, 采用post提交方法 (Method)7.2 及 application/json 内容类型(Content-Type)上传数据。 节点系统应向省级平台申请追溯码, 省级平台接收请求数据, 审核校验成功后生成正式的追溯码,7.3 并按申请数量反馈消息至节点系统; 节点系统接收响应数据, 将上报批次产品数据与省级平台返回的追溯码及追溯网址绑定,生成二维码标识。 8 接口说明 接口请求 8.1 8.1.1 公共请求 请求参数表见表1。 表1 公共请求参数 名称 含义 类型 是否可空 说明 BIZ_TYPE 业务消息类型 字符串 否 见附录 A 中的表 A.1 REQ_TIME 请求时间
11、 日期时间型 否 yyyy-MM-dd HH:mm:ss REQ_ID 请求编码 字符串 否 yyyyMMddHHmmss+6 位字母数字组合随机码 AUTH_ID 认证编码 字符串 否 省级平台提供的授权密匙,SHA-265 加密 PARAM 业务请求参数 字符串 否 见 8.1.2,JSON 子节点,自由文本 DB 37/T 43502021 4 请求格式示例见表2。 表2 请求格式 BIZ_TYPE:traceDataRequest, REQ_TIME:2020-01-10 00:00:00, REQ_ID:20200721084654qJJ2Jb, AUTH_ID:2020060915
12、3209831756, PARAM: 8.1.2 业务请求 业务请求参数应根据接口类型的不同做相应调整, 具体参数见对应接口的WSDL (Web服务描述语言,Web Services Description Language)文件,应符合GB/T 381542019中的相关规定。追溯业务信息参数示例见附录B。 接口响应 8.2 8.2.1 公共响应 公共响应参数见表3。 表3 公共响应参数 名称 含义 类型 是否可空 说明 BIZ_TYPE 业务类型 字符串 否 见附录 A 中的表 A.1 RESP_TIME 响应时间 日期时间型 否 yyyy-MM-dd HH:mm:ss RESP_ID 响
13、应编码 字符串 否 响应方产生的唯一编码 REQ_ID 请求编码 字符串 否 请求方的唯一编码 RESULT 响应数据参数 字符串 否 JSON 子节点,自由文本 响应格式示例见表4。 表4 响应格式 BIZ_TYPE: traceDataRequest, RESP_TIME: 2020-01-10 00:00:00, RESP_ID: 20200721084836BSoICl, REQ_ID: 20200721084654qJJ2Jb, RESULT: 8.2.2 业务响应 业务响应结果信息见表5。 DB 37/T 43502021 5 表5 业务响应参数 名称 含义 类型 是否可空 说明
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB37T 43502021 重要产品追溯食用农产品省级平台数据接口规范山东省 DB37 4350 2021 重要 产品 追溯 食用 农产品 省级 平台 数据 接口 规范 山东省
1、咨信平台为文档C2C交易模式,即用户上传的文档直接被用户下载,收益归上传人(含作者)所有;本站仅是提供信息存储空间和展示预览,仅对用户上传内容的表现方式做保护处理,对上载内容不做任何修改或编辑。所展示的作品文档包括内容和图片全部来源于网络用户和作者上传投稿,我们不确定上传用户享有完全著作权,根据《信息网络传播权保护条例》,如果侵犯了您的版权、权益或隐私,请联系我们,核实后会尽快下架及时删除,并可随时和客服了解处理情况,尊重保护知识产权我们共同努力。
2、文档的总页数、文档格式和文档大小以系统显示为准(内容中显示的页数不一定正确),网站客服只以系统显示的页数、文件格式、文档大小作为仲裁依据,平台无法对文档的真实性、完整性、权威性、准确性、专业性及其观点立场做任何保证或承诺,下载前须认真查看,确认无误后再购买,务必慎重购买;若有违法违纪将进行移交司法处理,若涉侵权平台将进行基本处罚并下架。
3、本站所有内容均由用户上传,付费前请自行鉴别,如您付费,意味着您已接受本站规则且自行承担风险,本站不进行额外附加服务,虚拟产品一经售出概不退款(未进行购买下载可退充值款),文档一经付费(服务费)、不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
4、如你看到网页展示的文档有www.zixin.com.cn水印,是因预览和防盗链等技术需要对页面进行转换压缩成图而已,我们并不对上传的文档进行任何编辑或修改,文档下载后都不会有水印标识(原文档上传前个别存留的除外),下载后原文更清晰;试题试卷类文档,如果标题没有明确说明有答案则都视为没有答案,请知晓;PPT和DOC文档可被视为“模板”,允许上传人保留章节、目录结构的情况下删减部份的内容;PDF文档不管是原文档转换或图片扫描而得,本站不作要求视为允许,下载前自行私信或留言给上传者【曲****】。
5、本文档所展示的图片、画像、字体、音乐的版权可能需版权方额外授权,请谨慎使用;网站提供的党政主题相关内容(国旗、国徽、党徽--等)目的在于配合国家政策宣传,仅限个人学习分享使用,禁止用于任何广告和商用目的。
6、文档遇到问题,请及时私信或留言给本站上传会员【曲****】,需本站解决可联系【 微信客服】、【 QQ客服】,若有其他问题请点击或扫码反馈【 服务填表】;文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“【 版权申诉】”(推荐),意见反馈和侵权处理邮箱:1219186828@qq.com;也可以拔打客服电话:4008-655-100;投诉/维权电话:4009-655-100。