1、 ICS 29.CCS K 0贵2022-020 09 州Quality-05-31发州气瓶第 and saf发布 贵省瓶质量第 2 部fety tracPart 贵州省市场地 量安全部分：ceabilit2：Data 场监督管理方全追溯数据y systeminterfac理局 发方DB52溯系统接口 m for gasce 发 布 52标2/T 1669统 s cylind2022-02 准.22022er 09-01实准 2 实施DB52/T 1669.2 2022 I 目 次 前言.II 引言.III 1 范围.1 2 规范性引 用文件.1 3 术语和定 义.1 4 缩略语.1 5 总体
2、要求.2 6 接口消息 格式.2 7 接口基本 功能和参数.3 参考文献.11 DB52/T 1669.22022 II 前言 本文件按照GB/T 1.12020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。本文件是DB52/T 1669气瓶质量安全追溯系统的第2部分。DB52/T 1669已经发布了以下部分：第 1 部分：通用要求；第 2 部分：数据接口；第 3 部分：气瓶信息化标签；第 4 部分：充装读写控制设备。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由贵州省市场监督管理局提出并归口。本文件起草单位：贵州省特种设备检验检测院、贵州
3、省市场监督管理局、贵州由你想信息科技有限公司、贵州省市场监管局大数据中心、六盘水市特种设备检验所、云南中石化燃气有限公司、贵州四维燃气有限公司、遵义市特种设备检验所、贵州省标准化院。本文件主要起草人：刘志鹏、张书辉、符文迪、马祥、吴恒、王勃、刘安路、梁志、黄康、杨鹏、关志华、朱云乐、刘朝琴、陈江博、王泽西、王玲、潘胜荣、李炜、罗凌、徐超、吕根源、陈星源、聂印、文富聪、陈贵堂、游远飞、潘昌亮、贾福波、韩霜、杭洪。DB52/T 1669.2 2022 III 引 言 气瓶与人民群众日常生活密切相关，直接关系到人民群众的生命安全与生活质量。随着贵州经济社会高质量发展，气瓶数量急速增长，气瓶泄漏或爆炸
4、事件时有发生，对人民群众生命财产安全造成了较大的潜在威胁，传统的气 瓶安全监管方式已不适应气瓶安全监管工作的需要。为加强气瓶质量安全监管，构建以信息化为手段的气瓶安全监管方式，实现气瓶质量安全的全生命周期信息化管理、质量安全控制和追溯，保 障气瓶安全 使用。DB52/T 1669 旨在确立气瓶质 量安全追溯 系统的相关 要求，由四 个部分组成。第 1 部分：通用要求。目的在于确定气瓶质量安全追溯系统的系统架构、监管平台、企业平台、数据体系、安全体系及管理体系的要求。第 2 部分：数据接口。目的在于确定气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基本功能和参数的要求。第 3 部分：
5、气瓶信息化标签。目的在于确定气瓶质量安全追溯系统气瓶信息化标签的功能要求、防伪特性、数据要求、安装要求和使用要求。第 4 部分：充装读写控制设备。目的在于确定气瓶质量安全追溯系统气瓶充装读写控制设备的要求。DB52/T 1669.2 2022 1 气瓶质 量安全 追溯系 统 第 2 部分：数据接 口 1 范围 本文件规定了气瓶质量安全追溯系统数据接口的总体要求、接口消息格式、接口基 本 功 能 和 参 数。本文件适用于液化石油气气瓶和液化二甲醚气瓶的气瓶质量安全追溯系统的数据接口。2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日
6、期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 13000 信息技术 通用多八位编码字符集（UCS）RFC 2616 超文本传输协议1.1（Hypertext Transfer Protocol HTTP/1.1）RFC 4627 JSON 应 用 与 媒 体 类 型The application/json Media Type for JavaScript Object Notation(JSON)3 术语和定义 下列术语和定义适用于本文件。3.1 气瓶信息化标签 实现气瓶生命周期中充装验证和追溯的信息化媒介。3.2 编码字符集 一组明确的
7、规则，它建立字符集和该字符集内的字符与其位组之间一一对应的关系。来源：GB/T 1988-1998，4.6 4 缩略语 下列缩略语适用于本文件。GTM：格林威 治时间（Greenwich Mean Time）HTML：超文 本置标语言（Hyper Text Markup Language）HTTP：超文 本传输协议（Hyper Text Transfer Protocol）HTTPS：超 文 本 传 输 安 全 协 议（Hyper Text Transfer Protocol over Secure Socket Layer 或 Hypertext Transfer Protocol Secu
8、re）ID：标识符（Identifier）JSON：轻量 级的数据交换格式（JavaScript Object Notation）MIME：多用 途互联网邮件扩展（Multipurpose Internet Mail Extensions）DB52/T 1669.2 2022 2 5 总体要求 5.1 通信协议 应采用符合RFC 2616的HTTP 或HTTPS。5.2 接口描述 宜使用 标准化的或比较通用的文本描述语言，如JSON（RFC4627）。5.3 编码字符集 应符合GB/T 13000的要求。5.4 数据类型 气瓶质量安全追溯系统数据接口应覆盖所能支持数据类型，包括：字符串型（St
9、ring）；数字型（Number）；时间型（DateTime）；对象型（Object）；数组型（Array）；布尔型（Boolean）；空（NULL）。注：对“时间”类信息，以“1970年1月1日，00:00:00（GTM时间）”作为基准起始时间。6 接口消息格式 6.1 请求消息格式 6.1.1 消息格式 请求消息由请求头 和请求参数组成。应使用HTTP规定的POST 请求方法。6.1.2 请求头 不同接口具有统一请求头，请求头的名称及其含义描述应符合表1 的规 定。表1 请求头 名称 描述 必选/可选 Host 指定请求的服务器的域名和端口号 必选 Connection 表示是否需要持久连
10、接 必选 Accept 表示接受所接收的内容类型 必选 Content-Type 请求的与实体对应的MIME信息 必选 Content-Lentgh 请求的内容长度 必选 DB52/T 1669.2 2022 3 表 1（续）名称 描述 必选/可选 Cookie HTTP请求发送时，会把保存在该请求域名下的所有cookie值一起发送给网站服务器 可选 User-Agent 内容包含发出请求的用户信息 可选 Token 访问连接的密钥信息 可选 6.1.3 请求参数 请求参数格式见示例列表形式，根据不同接口功能，其请求参数不同。示例：参数名 数据类型 必选/可选 描述 给出该字段所代表的参数名
11、用于描述数据的数据类型 描述该参数是否为必选 对参数的描述及补充说明-6.2 响应消息格式 6.2.1 消息格式 响应消息由响应头和响应消息参数组成。应使用HTTP 规定 的POST 请求 方法。6.2.2 响应头 不同接口具有同一响应头，响应头的名称及其含义描述应符合表2 的规 定。表2 响应头 名称 描述 必选/可选 Content-Type 请求的与实体对应的MIME信息 必选 Content-Length 请求的内容长度 必选 Date 服务器消息发出的时间 可选 Server 服务器软件名称 可选 6.2.3 响应参数 响应消息参数格式见示例列表形式，根据不同接口功能，其响应消息参数
12、不同。示例：参数名 数据类型 必选/可选 描述 给出该字段所代表的参数名 用于描述数据的数据类型 描述该参数是否为必选 对参数的描述及补充 说明-7 接口基本功能和参数 7.1 接口流程 企业平台向监管平台上报数据或请求数据的接口流程应符合图1，接口 的流程如下：a)企业平台发出请求，上报数据或请求数据；b)监管平台对该次请求进行处理；DB52/T 1669.2 2022 4 c)处理后由监管平台向企业平台返回处理结果。图1 接口流程 7.2 初始化连通接口 7.2.1 功能 用于企业平台和监管平台间建立初始化连通。7.2.2 请求参数 初始化连通请求参数应符合表3 的规 定。表3 初始化连通
13、请求参数 参数名 数据类型 必选/可选 描述 app_id String 必选 接入方ID app_key String 必选 接入方功能板块信息 app_secret String 必选 接入方密钥 7.2.3 响应消息参数 初始化连通响应消息参数应符合表4 的规定。表4 初始化连通响应消息参数 参数名 数据类型 必选/可选 描述 status Number 必选 本次请求处理状态码 msg String 必选 本次请求处理结果描述 access_token String 必选 接入获取到的密钥 expries Number 必选 密钥过期时间 DB52/T 1669.2 2022 5 7.
14、3 请求类接口 7.3.1 请求类接口列表 请求类接口列表应符合表5 的规定。表5 请求类接口列表 中文名称 英文名称 必选/可选 气瓶基本信息 product 必选 气瓶充装信息 fill 必选 气瓶检验信息 check 可选 气瓶信息化标签信息 tag 可选 7.3.2 请求类接口基本功能和参数 7.3.2.1 气瓶基本信息 7.3.2.1.1 功能 用于企业平台查询监管平台内气瓶基本信息。7.3.2.1.2 请求参数 气瓶基本信息请求参数应符合表6 的 规定。表6 气瓶基本信息请求参数 参数名 数据类型 必选/可选 描述 inner_code String 必选 查询气瓶的单位内编码 7
15、.3.2.1.3 响应消息参数 气瓶基本信息响应信息参数应符合表7 的规定。表7 气瓶基本信息响应消息参数 名称 数据类型 必选/可选 描述 pro_variety String 必选 设备品种 pro_name String 必选 产品名称 pro_no String 必选 气瓶生产编号 fill_media Number 必选 充装介质：0 液化石油气，1 二甲醚，2 氧气，3 二氧化碳，4 溶解乙炔 make_unit String 必选 制造单位 make_time DateTime 必选 生产日期 work_pressure Number 必选 公称工作压（MPa）volume Nu
16、mber 必选 容积（L）check_time DateTime 必选 最近 次检验 日期（新瓶 该值填写出厂日期）DB52/T 1669.2 2022 6 表7（续）名称 数据类型 必选/可选 描述 next_check_time DateTime 必选 下次检验日期（液化石油气瓶顺延4 年气瓶 下一次需要送检验站检验的日期）regist_code String 可选 气瓶使 登记代码 change_event String 可选 变更情况（主要记录产权过户日志）memo String 可选 备注 inner_code String 必选 单位内编号 stamp_make_unit Stri
17、ng 可选 气瓶钢印制造单位名称 pro_uuid String 必选 产品唯一性编码 chip_id String 可选 芯片id（每一个批次生成的登记证编号）location String 可选 归属地（客户、门店、气站、检测机构）：0001 门店，0002 气站，0003 企业，0004 检验机构，005 移动库，006 客户 status String 必选 气瓶状态在用（已检测）、停用（待检测）、报废：submit 新瓶提交，using 在用(已检测)，stop 停用(待检测)，scrapped 报废 check_organization String 可选 检测机构 empty_b
18、ottle Boolean 必选 是否空瓶：0 是，1 不是 product_id String 可选 产品类型ID uid String 可选 高频编码 tid String 可选 超高频编码 chip_status Boolean 必选 是否改造：0 未改造，1 已改造 location_source_id String 可选 当前归属机构ID is_lose Boolean 必选 是否丢失：0 丢失，1 未丢失 old_bottle Boolean 必选 是否旧瓶 design_thickness Number 必选 设计壁厚 result_code String 可选 检测结果 aud
19、it_remark String 可选 审批备注 deadline_time DateTime 必选 使用年限 check_in_time DateTime 必选 录入日期 scrap_time DateTime 可选 报废日期 analysis_status String 必选 统计状态值：inform 已提交待审批，using 在用，scrapped 报废 check_status Boolean 必选 1 已证，0 未证 operation_id String 必选 操作人id operation_time DateTime 必选 操作时间 safe_evaluate Boolean 必
20、选 安全评定 7.3.2.2 气瓶充装信息 7.3.2.2.1 功能 用于企业平台查询监管平台内气瓶最新一条充装信息。DB52/T 1669.2 2022 7 7.3.2.2.2 请求参数 气瓶充装信息请求参数应符合表8 的 规定。表8 气瓶充装信息请求参数 参数名 数据类型 必选/可选 描述 inner_code String 必选 查询气瓶的单位内编码 7.3.2.2.3 响应消息参数 气瓶充装信息响应消息参数应符合表9 的规定。表9 气瓶充装信息响应消息参数 名称 数据类型 必选/可选 说明 gun_code String 必选 充装枪编号 station_id String 必选 充装
21、气站ID company_id String 必选 充装企业ID area String 必选 所在区 city String 必选 所在市 person_code String 必选 充装人员编码 user_id String 必选 充装人员id inner_code String 必选 单位内编号 chip_uid String 必选 高频编码 pro_uuid String 必选 气瓶uuid product_id Number 必选 产品类型id product_media_id Number 必选 充装介质编码 fill_time DateTime 必选 充装时间 create_ti
22、me DateTime 必选 创建时间 7.3.2.3 气瓶定期检验信息 7.3.2.3.1 功能 用于企业平台查询监管平台内气瓶最新检验信息。7.3.2.3.2 请求参数 气瓶定期检验信息请求参数应符合表10 的规定。表10 气瓶定期检验信息请求参数 参数名 数据类型 必选/可选 描述 order_no String 必选 气瓶检验订单编号 inner_code String 可选 查询气瓶的单位内编码 7.3.2.3.3 响应消息参数 气瓶定期检验信息响应消息参数应符合表11 的 规定，气瓶定期检验明细应符合表12 的规定。DB52/T 1669.2 2022 8 表11 气瓶定期检验信息
23、响应消息参数 名称 数据类型 必选/可选 说明 security_person String 必选 安全管理员 unit_phone String 必选 单位固定电话 pro_use_address String 必选 设备使用单位地点 pro_num Number 必选 设备数量 use_unit_address String 必选 使用单位地址 use_unit String 必选 使用单位名称 use_unit_fill_person String 必选 使用单位填表人员 unit_social_code String 必选 单位统一社会信用代码 use_unit_fill_date D
24、ateTime 必选 填表日期 use_unit_phone String 必选 移动电话 pro_list Array 必选 气瓶定期检验明细 表12 气瓶定期检验明细 名称 数据类型 必选/可选 说明 batch_no String 必选 登记编号 ori_bottle_status String 必选 原气瓶状态 check_status Number 必选 检验状态：0 送检，1 待绑定 铭牌，2 待绑定 芯片，3 已绑定芯片，4 报废，5 气瓶 退回，6 气瓶丢失 deal_flag Boolean 必选 是否完成检验：0 未完成，1 已完成 is_safe_evaluate Boo
25、lean 必选 是否安全评定 next_check_time DateTime 可选 下次检验日期 scrap_type String 可选 报废处理方式 create_time DateTime 必选 创建时间 check_time DateTime 必选 检验时间 7.3.2.4 气瓶信息化标签信息 7.3.2.4.1 功能 用于企业平台查询监管平台内气瓶信息化标签信息。7.3.2.4.2 请求参数 气瓶信息化标签信息请求参数应符合表13的规 定。表13 气瓶信息化标签信息请求参数 参数名 数据类型 必选/可选 描述 inner_code String 必选 查询气瓶的单位内编码 DB52
26、/T 1669.2 2022 9 7.3.2.4.3 响应消息参数 气瓶信息化标签信息响应消息参数应符合表14 的规定。表14 气瓶信息化标签信息响应消息参数 名称 数据类型 必选/可选 说明 uid String 可选 高频编码 high_data String 可选 高频芯片块数据 tid String 可选 超高频编码 ultra_high_data String 可选 超高频块数据 union_id String 必选 关联id qr_id String 可选 二维码id chip_key String 可选 秘钥 status_id Boolean 必选 绑定状态：0 未绑定，1 已
27、绑定 company_id String 可选 生产厂家 create_time DateTime 必选 入库时间 7.4 上报类接口 7.4.1 上报类接口列表 应符合表15 的规定。表15 上报类接口列表 中文名称 英文名称 必选/可选 气瓶流转信息 circulation 必选 7.4.2 上报类接口基本功能和参数 7.4.2.1 气瓶流转信息 7.4.2.1.1 功能 用于企业平台向监管平台上报气瓶信流转过程的信息，包 括气瓶运输信息、气瓶仓储信息、气瓶配送信息。7.4.2.1.2 请求参数 气瓶流转信息请求参数应符合表16 的规定。表16 气瓶流转信息请求参数 名称 数据类型 必选/
28、可选 说明 pro_uuid String 必选 气瓶uuid DB52/T 1669.2 2022 10 表 16（续）名称 数据类型 必选/可选 说明 inner_code String 可选 气瓶单位内编码 opt_type String 必选 气瓶操作类型：重瓶装车，重瓶卸车，重瓶入库，重瓶出库，重瓶配送，空瓶回收，空瓶入库，空瓶装车，空瓶卸车 memo String 可选 气瓶操作 说明 opt_time DateTime 必选 操作时间 opt_user String 必选 操作人编号 opt_user_name String 必选 操作人员名称 recv_org_id Objec
29、t 必选 交接单位 recv_user_id Object 必选 交接人员 recv_rname_info Object 必选 交接人员实名信息 7.4.2.1.3 响应消息参数 气瓶流转信息响应消息参数应符合表17 的规定。表17 气瓶流转信息响应消息参数 参数名 数据类型 必选/可选 描述 status Number 必选 本次请求处理状态码 msg String 必选 本次请求处理结果描述 pro_uuid String 必选 气瓶uuid inner_code Number 必选 气瓶单位内编码 DB52/T 1669.2 2022 11 参考文 献 1 GB/T 1988 1998 信息技术 信息交换用七位编码字符集 DB52/T 1669.2-2022
