最新《DB地方标准》DB53T1136.3-2022.pdf
![资源得分’ title=](/images/score_1.gif)
![资源得分’ title=](/images/score_1.gif)
![资源得分’ title=](/images/score_1.gif)
![资源得分’ title=](/images/score_1.gif)
![资源得分’ title=](/images/score_05.gif)
《最新《DB地方标准》DB53T1136.3-2022.pdf》由会员分享,可在线阅读,更多相关《最新《DB地方标准》DB53T1136.3-2022.pdf(24页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、ICS 35.240.99CCS L7853云南省地方标准DB53/T 1136.32022食品安全信息追溯基础技术规范第 3 部分:数据接口2022-10-26 发布2023-01-26 实施云南省市场监督管理局发 布DB53/T 1136.32022I前言本文件按照GB/T 1.12020标准化工作导则第1部分:标准化文件的结构和起草规则的规定起草。本文件是DB53/T 1136食品安全信息追溯基础技术规范的第3部分。DB53/T 1136一共发布以下3个部分:第 1 部分:编码方法;第 2 部分:数据元;第 3 部分:数据接口。请注意本文件的某些内容可能涉及及专利。本文件的发布机构不承担
2、识别专利的责任。本文件由云南省市场监督管理局提出并归口。本文件起草单位:云南省市场监督管理局信息中心、云南省市场监督管理局、云南省标准化研究院、中国移动通信集团云南有限公司、云南省盐业有限公司、云南鼎耀信息技术有限公司、昆明雪兰牛奶有限责任公司、云南绿A生物工程有限公司。本文件主要起草人:杨东霞、张娴、陈红丽、杨亚琦、杨增鸿、谢波、朱勋程、赵忆宁、李宁、黄典一、杨俊、韩骥、赵欣、易正禹、邹汉铮、桑月军、宋治金、李文媛、陈福波、朱宁、林男、杨志、金荣、段玉娟、荀春、余凡、左仕陆、杨康定。DB53/T 1136.32022II引言食品安全始终是关系国计民生的大事。追溯体系的建立作为保障食品安全的重
3、要管理手段一直是社会关注的重点工作。从国内外追溯体系建设和实施的成效可以看出,建立追溯体系是一种能够预防和改善食品安全问题的有效途径。在信息化技术应用于追溯体系建设过程中,追溯编码、数据元和数据接口是重要的基础性工作。科学制定标准规范有利于实现追溯数据互联互通和追溯体系的推广应用。食品安全信息追溯基础技术规范拟由三个部分构成:第 1 部分:编码方法。目的在于给出食品安全追溯体系中追溯码编码方法和表示要求;第 2 部分:数据元。目的在于给出食品安全追溯体系中基础数据元及其描述规则;第 3 部分:数据接口。目的在于给出食品安全追溯体系中生产企业数据上传信息的接口要求。DB53/T 1136.320
4、221食品安全信息追溯基础技术规范 第 3 部分:数据接口1范围本文件规定了食品安全信息追溯的数据接口技术要求、数据接口参数和接口安全。本文件适用于食品安全信息追溯的数据交换、传输和认证。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T 7408数据元和交换格式信息交换日期和时间表示法GB/T 7635.1 全国主要产品分类与代码 第1部分:可运输产品GB 12904商品条码 零售商品编码与条码表示GB/T 38155重要产品追溯 追溯
5、术语RFC 1945超文本传输协议 1.0(Hypertext transfer protocol-HTTP/1.0)RFC 2616超文本传输协议 1.1(Hypertext transfer protocol-HTTP/1.1)RFC 4627JSON格式定义(The application/JSON media type for javascript Object notation)RFC 4825可扩展标记语言配置接入协议(The extensible markup language(XML)configurationaccess protocol(XCAP)3术语和定义下列术语和定义
6、适用于本文件。数据接口 data interface一组用于数据交换的服务,包括服务的功能、位置以及通讯的协议、传输格式和认证方法。接口协议 interface protocol需要进行信息交换的接口间需要遵从的通信方式和要求。其内容包括协议约定、消息头域、消息体内容等,确定通信程序发送消息和接收消息的规则。消息头Message Header消息头包含了关于消息本身的元数据(例如,发送者和目标详细信息、消息属性、消息类型),不同传输的头包含不同类型的信息。安全认证 security certificate保证数据传输安全的加密方法和身份认证方法。“名称/值”对 name/value pairD
7、B53/T 1136.320222JSON的数据存储格式,“名称/值”对组合中的名称写在前面双引号中,值写在后面双引号中,中间用冒号隔开,“名称/值”对之间由逗号分隔。追溯码 traceability code追溯系统中对追溯单元进行唯一标识的代码。来源:GB/T 381552019,2.104缩略语下列缩略语适用于本文件。HTTPS:安全超文本传输协议(Hyper Text Transfer Protocol over Secure Socket Layer)JSON:一种轻量级的数据交换格式(JavaScript Object Notation)MD5:消息摘要算法第五版(Message-
8、Digest Algorithm 5)RESTFul:基于HTTPS协议,可以使用XML格式定义或JSON格式定义Token:是服务端生成的一串加密字符串、以作客户端进行请求的一个“令牌”URL:互联网服务程序上用于指定信息位置的表示方法(Uniform Resource Locator)UTF-8:一种可变长度字符编码(8-bit Unicode Transformation Format)XML:可扩展标记语言(Extensible Markup Language)5技术要求基本要求5.1.1接口要求接口通过服务调用实现信息交换,应符合下列要求:采用符合 GB/T 7408 规定的日期类型
9、;接口请求与接口响应均采用 JSON 数据格式;建立接口日志记录,能识别数据异常或追溯交换数据情况。5.1.2容错要求发生错误时,接口服务方将详细的错误信息返回至接口调用方,由接口调用方对错误进行记录分析和整改。接口协议接口协议方式包括:采用基于 HTTPS 传输协议的 RESTFul 接口方式;采用 JSON 格式报文打包方式。消息头基本参数5.3.1安全认证接口 Header 参数安全认证接口Header参数见表1。DB53/T 1136.320223表 1安全认证接口 Header 参数表参数名称参数描述Authorization接口授权(其余字段)采用默认值5.3.2业务交互接口 He
10、ader 参数业务交互接口Header参数见表2。表 2业务交互接口 Header 参数表参数名称参数描述Authorization接口授权Trace-Auth授权token,格式为:bearer+token例如:bearereyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9.eyJpc3MiOiJpc3N1c2VyIiwiYXVkIjoiYXVkaWVuY2UiLCJ0ZW5hbnRfaWQiOiIwMDAwMDAiLCJ1c2VyX25hbWUiOiLkupHljZfkupHpgJ_kv6Hmga_mioDmnK_mnInpmZDlhazlj7giLCJ0b2tlbl
11、90eXBlIjoiYWNjZXNzX3Rva2VuIiwicm9sZV9uYW1lIjoiZW50ZXJwcmlzZSIsInVzZXJfdHlwZSI6Im1hc3RlciIsInVzZXJfaWQiOiI5OTY0NTgzMDUxMTgxMjE4MyIsInJvbGVfaWQiOiIxNDAyNDM3NTkyMDc4NzQ5Njk3Iiwibmlja19uYW1lIjoi5LqR5Y2X5LqR6YCf5L-h5oGv5oqA5pyv5pyJ6ZmQ5YWs5Y-4IiwiZGV0YWlsIjp7InR5cGUiOiJ3ZWIifSwiZW50ZXJwcmlzZV9jb2RlIjoiOT
12、E1MzAxMDJNQTZLNEtBNTdRIiwiZGVwdF9pZCI6IjIzNyIsImFjY291bnQiOiI5MTUzMDEwMk1BNks0S0E1N1EiLCJjbGllbnRfaWQiOiJzYWJlciIsImV4cCI6MTY1NTM3MDM4MCwibmJmIjoxNjU1MzY2NzgwfQ.M8o2wrI6eKb9JovCDKLGhZVAB4k4tmwA-GmUGEGzZ71zCStoL62e0vmRlzppuniuOcvQa8cbqHyz1E_uk-MyEQ(其余字段)采用默认值基本数据类型基本数据类型说明见表3。表 3数据类型说明表类型名称类型说明String
13、字符串Integer整型File文件类型Datetime日期格式:yyyymmdd,依据 GB/T 7408Array数组类型Boolean布尔类型。真值:true;假值:falseObjectJSON 对象类型6数据接口数据接口分类DB53/T 1136.320224数据接口分类见图1所示。图 1数据接口分类基本信息接口6.2.1安全认证接口获取用户登录token信息,进行用户安全认证,相关参数见表4。表 4安全认证接口数据参数名称数据类型长度(Byte)是否必填描述userNameString32是用户名,企业统一社会信用代码passWordString45是登录密码,密码使用 MD5 加
14、密tenanIIdString12是租用号grantTypeString45是授权类型,固定填写:passwordscopeString255是权限,默认填写:all6.2.2商品类别查询接口查询追溯商品类别,参数见表5。表 5商品类别查询接口数据参数名称数据类型长度(Byte)是否必填描述goodsCatalogIdInteger64是商品类别号goodsCatalogNameString32是商品类别查询追溯商品类别,返回值见表6。DB53/T 1136.320225表 6商品类别查询返回值参数名称数据类型长度(Byte)描述goodsCataloCodeString32商品类别代码goo
15、dsCatalogNameString32商品类别parentIdInteger64上级类别号6.2.3图片文件上传接口上传食品追溯相关数据时所需提供的图片文件,参数见表7。表 7图片文件上传接口数据参数名称数据类型长度(Byte)是否必填描述fileFile5242880是图片文件。格式要求:png、jpg、jpeg大小限制:不超过 5M BytenameString32是文件名(注:已经封装过,在其它接口中使用该值作为图片文件地址)图片文件上传接口,返回值见表8。表 8返回值参数名称数据类型长度(Byte)描述codeInteger(int32)32状态码,见附录表 A.1dataObje
16、ct4096承载数据msgString64提示信息successBoolean8返回结果类型6.2.4新增食品生产经营市场主体信息备案上传新增食品生产企业、食品经营企业的基本备案信息,如:企业统一社会信用代码、企业名称等,参数见表9。表 9新增食品市场主体信息备案字段名称类型长度(Byte)是否必填描述enterpriseCodeString64是企业信用代码nameString100是企业名称enterpriseLegalPersonString12是法定代表人phoneString12是联系电话addressString100是地址provinceTypeString10是省份类型:A 云
17、南省,B 外省createByEntCodeString32是生产企业统一社会信用代码createByEntNameString100是备案企业名称DB53/T 1136.320226表9新增食品市场主体信息备案(续)字段名称类型长度(Byte)是否必填描述businessTypeString10是经营类型:1 生产企业,2 流通企业,3 餐饮企业businessLicensePicString255是营业执照图片 URL 地址xkzImageString255是许可证图片图片 URL 地址新增食品市场主体信息备案,返回值见表8所示。6.2.5新增原辅料信息备案上传新增追溯食品的原辅料基本备案
18、信息,如:类别、名称、来源等,参数见表10。表 10新增原辅料备案数据字段名称类型长度(Byte)是否必填描述materiaCatalogIdString32是原料辅类别号:01 原料,02 食品添加剂,03 食品相关产品materiaBarCodeString64是原辅料条码,食品相关产品没有条码,有条码的原辅料填写条码值。materiaNameString45是原辅料名称expireString20是保质期,食品相关产品没有spUnipString4是质保单位,食品相关产品没有specString20是规格,食品相关产品没有unitString20是规格单位producePlaceStri
19、ng60是产地produceEntCodeString32是生产企业统一社会信用代码createByEntCodeString32是生产企业统一社会信用代码originString2是来源类型:1 进口原辅料,2 国产原辅料packageTypeString10是包装类型:1 散装,2 预包装新增原辅料信息备案,返回值见表8所示。6.2.6新增生产食品信息备案上传新增生产食品备案基本信息,包括食品类别、食品名称等,参数见表11。表 11新增生产食品信息备案数据字段名称类型长度(Byte)是否必填描述additiveIdsArray256是食品添加剂标识号集合,标识号值由原辅料备案接口返回bar
20、CodeString64是条码createByEntCodeString32是生产企业统一社会信用代码goodsCatalogIdString32是商品类别号表11新增生产食品信息备案数据(续)DB53/T 1136.320227字段名称类型长度(Byte)是否必填描述goodsImgString255否外包装图片 URL 地址guaranteeUnitString10是保质期单位,D 天 M 月 Y 年materiaIdsArray256是食品原辅料标识号集合。标识号值由原辅料备案接口返回nameString100是商品名称originCountryString20是原产国originGoo
21、dsString4是食品来源类型:1 进口食品,2 国产食品originPlaceString30是国内产地packageTypeString10是包装类型:1 预包装 2 散装qualityGuaranteePeriod Integer(int32)20是保质期relatedIdsArray256是食品相关产品标识号集合,标识号值由原辅料备案接口返回resourceTypeString10是来源类型:1 生产,2 采购shopLinkString255否商城链接spUnipString4是规格单位specString20是规格新增生产食品信息备案,返回值见表8所示。6.2.7新增采购食品信息
22、备案上传新增采购食品备案基本信息,包括食品类别、食品名称等,参数见表12。表 12新增采购食品信息备案数据字段名称类型长度(Byte)是否必填描述goodsCatalogIdString32是商品类别号nameString100是食品名称barCodeString64是食品条码specString20是规格produceEntCodeString32是生产企业统一社会信用代码produceEntNameString100是生产企业名称spUnipString4是规格单位qualityGuaranteePeriodInteger20是保质期guaranteeUnitString10是保质期单位,
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- DB地方标准 最新 DB 地方 标准 DB53T1136 2022
![提示](https://www.taowenge.com/images/bang_tan.gif)
限制150内