DB35/T 1802-2018 特种设备公共数据接口规范

ICS01.040.35

L70

DB35

福建省地方标准

DB35/T1802—2018

特种设备公共数据接口规范

Specificationofpublicdatainterfaceforspecialequipment

2018-11-22发布2019-02-22实施

福建省市场监督管理局发布

DB35/T1802—2018

目次

前言..............................................................................II

1范围..............................................................................1

2规范性引用文件....................................................................1

3术语和定义........................................................................1

4数据范围..........................................................................2

5数据来源..........................................................................2

6数据元属性........................................................................2

7数据交换方式......................................................................3

8数据接口技术......................................................................3

9数据接口功能......................................................................3

10数据传输安全要求.................................................................4

附录A（资料性附录）数据传输消息格式................................................5

附录B（规范性附录）数据字典........................................................9

附录C（规范性附录）数据项取值.....................................................27

参考文献.........................................................................43

I

DB35/T1802—2018

前言

本标准按照GB/T1.1—2009给出的规则起草。

本标准由福建省信息化标准化技术委员会归口。

本标准起草单位：福建省特种设备检验研究院。

本标准主要起草人：曾远跃、潘健鸿、张莉君、朱继青、樊继春、黄春榕、张伟仁、郑志坚。

II

DB35/T1802—2018

特种设备公共数据接口规范

1范围

本标准规定了特种设备公共数据接口的术语和定义、数据范围、数据来源、数据元属性、数据交换

方式、数据接口技术、数据接口功能及数据传输安全要求。

本标准适用于特种设备生产单位、使用单位、检验机构、安全监督管理部门的特种设备应用系统之

间的锅炉、压力容器（不含气瓶）、压力管道、电梯、起重机械、场（厂）内机动车辆、大型游乐设施、

客运索道、气瓶等特种设备公共数据交换与共享。

2规范性引用文件

下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。

凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。

GB/T2260—2007中华人民共和国行政区划代码

GB/T7408数据元和交换格式信息交换日期和时间表示法

GB11643—1999公民身份号码

GB/T36107—2018法人和其他组织统一社会信用代码数据交换接口

3术语和定义

下列术语和定义适用于本文件。

3.1

特种设备基础数据basicdataforspecialequipment

需要进行统一交换与共享的特种设备制造信息、设备基本信息、单位信息、人员信息及关键参数信

息。

3.2

特种设备业务数据transactiondataforspecialequipment

需要进行统一交换与共享的特种设备施工告知信息、检验信息、使用登记信息、维保数据、设备故

障数据。

3.3

特种设备公共数据publicdataforspecialequipment

需要进行统一交换与共享的特种设备基础数据和特种设备业务数据。

3.4

数据元dataelement

用一组属性描述定义、标识、表达和允许值的数据单元。

3.5

设备识别码equipmentcode

用于唯一确定某一特种设备而赋予的字母、数字编码。

1

DB35/T1802—2018

4数据范围

本规范涉及的数据范围为锅炉、压力容器（不含气瓶）、压力管道、电梯、起重机械、场（厂）内

机动车辆、大型游乐设施、客运索道、气瓶等特种设备基础数据和特种设备业务数据。

5数据来源

5.1特种设备基础数据

特种设备基础数据来源于以下两方面：

a)特种设备制造信息、设备基本信息、设备关键技术参数信息，来源于生产单位的特种设备管理

系统或全国特种设备产品数据库；

b)特种设备单位信息、人员信息，来源于特种设备安全监督管理部门的特种设备动态监管平台或

全国特种设备许可平台。

5.2特种设备业务数据

参考TSGZ0002—2009，特种设备业务数据来源于以下五个方面：

a)特种设备（不含气瓶）施工告知信息、使用登记信息，来源于特种设备安全监督管理部门的特

种设备动态监管平台；其中压力管道基本信息数据来源于检验机构的检验平台；移动式压力容

器使用登记数据来源于全国移动式压力容器监管平台；其中气瓶的使用登记信息，来源于省气

瓶监管平台，气瓶基本信息数据来源于全国产品数据库或者充装企业站用管理系统；

b)特种设备检验信息，来源于特种设备检验机构的特种设备检验管理平台；

c)电梯故障数据，来源于特种设备安全监督管理部门的电梯应急处置服务平台；

d)电梯维保数据，来源于生产单位的电梯维保管理平台；

e)气瓶充装记录数据，来源于充装企业站用管理系统。

6数据元属性

6.1数据类型

参考GB/T18391.1—2009，数据类型取值宜符合表1的要求。

表1数据类型取值

数据类型类型代码取值方式

整数数值型I通过从“0”到“9”数字形式表达的值的类型

浮点数值型F通过从“0”到“9”数字以及一个小数点表达的值的类型

日期型D通过“YYYY-MM-DD”的格式表达的日期值的类型

通过“YYYY-MM-DDHH24:MM:SS”的格式表达的日期及时间值的类型，按照GB/T7408

日期时间型D+T

执行

6.2数据长度

规定各具体数据项的数据长度。

2

DB35/T1802—2018

6.3是否必填

Y表示必填，N表示非必填。

6.4消息格式

数据交换过程中数据元的具体格式，参见附录A。

6.5数据字典

数据交换过程中需要传输的数据项的集合，并对具体数据项进行定义和描述，见附录B。

6.6数据项取值

对基本数据项中的具体数据对象或者项目描述的集合。列出所有可能预先定义的数值，以及提供简

单的文字性描述。本标准中分通用数据项取值和具体业务数据项对应的数据项取值，见附录C。

7数据交换方式

特种设备数据交换与共享采用以下三种方式的一种：

a)网页在线录入方式：适用于没有信息化系统支撑的、少量的数据；

b)Excel模板数据导入方式：适用于没有信息化系统支撑的、大批量的数据；

c)跨语言和平台的数据接口方式：适用于有信息化系统支撑的系统相互之间的数据交换与共享。

8数据接口技术

数据交换与共享宜采用跨语言和跨平台的WebService技术，采用HTTPS协议为通讯协议，采用JSON

或XML格式为数据组织格式；数据编码方式统一采用UTF-8进行编码。

9数据接口功能

9.1接口基本功能

数据接口提供的功能包含数据调用、更新、删除及数据查询：

a)数据调用：按接口数据元中的主键、时间戳增量上传；

b)数据更新：按接口数据元中的主键，进行数据更新操作；

c)数据删除：按接口数据元的主键，进行数据删除操作；

d)数据查询：按接口数据元中的主键、设备所属区域等进行数据获取。

9.2数据校验功能

数据接口具备以下的数据校验功能：

a)校验接口账户权限功能，能校验相应数据调用、更新、删除、查询等数据操作权限；

b)数据完整性检查功能。

9.3接口监控功能

提供系统的监控机制，实时监控接口的运行情况，及时发现错误及排除故障。

3

DB35/T1802—2018

10数据传输安全要求

10.1访问控制

传输数据头文件中增加身份认证消息报文，以实现对调用方的安全认证；采用网页录入或者导入方

式的，则通过授予帐号登录的方式，以确保数据的安全性；密码宜采用MD5等加密方式进行加密，密码

校验失败超过3次的，加上数据校验失败标记，24h后再重新校验传输。

10.2数据授权控制

数据获取由系统管理员进行授权访问。

10.3数据交互量控制

在数据接口交换时，由数据交换系统双方根据系统性能进行数据交互量限制。

10.4数据重传响应机制

数据传输失败3次，进行标记，按一定的时间频度重传。

4

DB35/T1802—2018

AA

附录A

（资料性附录）

数据传输消息格式

A.1请求消息

A.1.1消息格式说明

请求消息包含JSON和XML消息格式说明、元素说明、属性说明。

A.1.1.1请求消息的JSON格式为：

｛

loginName:"用户名",

passWord："MD5密码",

charset:"UTF-8",

postInfo:{

"reqType":"请求类型",

"action":"动作代码",

"eqpType":"设备类型"

},

dataInfo:[

{

field1:"值",

field2:"值",

field3:"值",

...

},

{

field1:"值",

field2:"值",

field3:"值",

...

}

...

]

｝

5

DB35/T1802—2018

A.1.1.2请求消息的XML格式为：

<?xmlversion="1.0"encoding="UTF-8"?>

<Request>

<loginInfo>

<loginName><![CDATA[用户名]]></loginName>

<passWord><![CDATA[密码]]></passWord>

</loginInfo>

<postInfo>

<reqType><![CDATA[请求类型]]></reqType>

<action><![CDATA[动作代码]]></action>

<eqpType><![CDATA[设备类型]]></eqpType>

</postInfo>

<dataInfos>

<dataInfo>

<field1><![CDATA[值]]></field1>

......

<fieldn><![CDATA[值]]></fieldn>

</dataInfo>

......

<dataInfo>

<field1><![CDATA[值]]></field1>

......

<fieldn><![CDATA[值]]></fieldn>

</dataInfo>

</dataInfos>

</Request>

A.1.2元素说明

元素说明参见表A.1。

表A.1元素说明

元素名称元素说明

loginName用户名

passWordMD5密码

dataInfo标明本次请求业务数据信息

reqType请求类型（参见表A.2）

action动作代码（参见表A.3）

eqpType特种设备目录内标准名称

A.1.3请求类型

请求类型参见表A.2。

6

DB35/T1802—2018

表A.2请求类型

请求类型类型说明

01制造信息

02基本信息+关键技术参数

03使用登记信息

04施工告知信息

05检验信息

06故障信息

07维保信息

08单位信息

09人员信息

A.1.4动作代码

动作代码参见表A.3。

表A.3动作代码

动作代码类型说明

add数据调用

update数据更新

delete数据删除

query数据查询

A.2响应消息

A.2.1响应消息格式说明

响应消息包括JSON和XML消息格式说明、属性说明、响应代码说明。当消息响应不成功时，并作相

应标识，请求方重新发送数据。

A.2.1.1响应消息的JSON格式

｛

returnCode:"响应消息代码",

returnValue:"响应消息描述",

｝

A.2.1.2响应消息的XML格式

<?xmlversion="1.0"encoding="UTF-8"?>

<Response>

<returnCode><![CDATA[响应消息代码]]></returnCode>

<returnValue><![CDATA[响应消息描述]]></returnValue>

</Response>

7

DB35/T1802—2018

A.2.2响应属性说明

响应属性说明参见表A.4。

表A.4属性说明

属性名称属性说明

returnCode响应消息代码：标明本次响应消息成功或失败代码

returnValue响应消息说明：标明本次响应消息成功或失败描述

A.2.3响应代码说明

响应代码说明参见表A.5。

表A.5响应代码说明

响应代码代码描述

00数据传输成功

01数据请求失败

02权限校验失败

03数据重复

04数据质量校验不成功

05交互数据量超过设置最大记录条数

06数据重传

99未知错误

8

DB35/T1802—2018

BB

附录B

（规范性附录）

数据字典

B.1制造信息

B.1.1基本数据项

制造信息见表B.1。

表B.1制造信息

字段名字段描述数据类型数据长度是否必填信息说明

EQP_ID设备IDC20Y制造设备ID，序列自动递增

EQP_TYPE设备种类C60Y特种设备目录内标准名称

EQP_SORT设备类别C60N特种设备目录内标准名称

EQP_VART设备品种C60N特种设备目录内标准名称

EQP_NAME设备名称C120N

EQP_MOD设备型号C60Y

FACTORY_COD出厂编号C60Y

MAKE_DATE制造日期DN特种设备制造完成日期

MAKE_NAME制造单位名称C300Y制造单位名称

制造单位按照GB/T36107—2018执

MAKE_ORG_CODC20Y

社会信用代码行

B.1.2主键

制造信息主键为：设备种类、设备型号、出厂编号、制造单位名称。

B.2设备基本信息

B.2.1基本数据项

设备基本信息见表B.2。

表B.2设备基本信息

字段名字段描述数据类型数据长度是否必填信息说明

监察设备识别码：支持数

OIDNO设备识别码C20Y

字、字母

9

DB35/T1802—2018

表B.2（续）

字段名字段描述数据类型数据长度是否必填信息说明

按照GB/T2260—2007执

AREA_COD设备所在区域C8Y

行

EQP_REG_COD使用登记代码C40Y设备使用登记代码

特种设备目录内标准名

EQP_TYPE设备种类C60Y

称

特种设备目录内标准名

EQP_SORT设备类别C60N

称

特种设备目录内标准名

EQP_VART设备品种C60N

称

EQP_MOD设备型号C60N

EQP_LEVEL设备级别C30N

FACTORY_COD出厂编号C60N

数据项取值:见C.1.1设

USE_STA设备使用状态I6N

备使用状态

EQP_USECERT_COD使用登记证编号C60N

MAKE_NAME制造单位名称C300N制造单位的名称

按照GB/T36107—2018

MAKE_ORG_COD制造单位社会信用代码C20N

执行

PROP_UNT_NAME产权单位C300N产权单位名称

按照GB/T36107—2018

PROP_ORG_COD产权单位社会信用代码C20N

执行

DESIGN_UNT_NAME设计单位名称C300N

按照GB/T36107—2018

DESIGN_ORG_COD设计单位社会信用代码C20N

执行

USE_UNT_NAME使用单位名称C300N使用单位的名称

按照GB/T36107—2018

USE_ORG_COD使用单位社会信用代码C20N

执行

SEC_NAME分支机构名称C300N

FIRSTUSE_DATE投用日期DN

数据项取值:见C.1.2设

EQP_USE_OCCA设备使用场所I6N

备使用场所

EQP_USE_ADDR设备使用地点C300N

B.2.2主键

设备基本信息主键为：设备识别码、设备所在区域。

B.3使用登记信息

10

DB35/T1802—2018

B.3.1基本数据项

使用登记信息见表B.3。

表B.3使用登记信息

字段名字段描述数据类型数据长度是否必填信息说明

OIDNO设备识别码C20Y支持数字、字母

按照GB/T2260—2007执

AREA_COD设备所在区域C8Y

行

REG_COD使用登记代码C40N使用登记时生成

数据项取值：见C.1.3使

REG_STA使用登记状态I6N

用登记状态

REG_ORG使用登记机构C300N注册机构全称

REG_DATE使用登记日期DN为YYYY-MM-DD格式

EQP_USECERT_COD使用登记证编号C60N

数据项取值：见C.1.1设

USE_STA设备使用状态I6N

备使用状态

SAFE_LEV安全状况等级C10N

数据项取值：见C.1.2设

EQP_USE_PLACE设备使用场所I6N

备使用场所

EQP_MOD设备型号C60N

FACTORY_COD出厂编号C60N

INST_NAME安装/改造修理单位名称