广州市关于进一步规范电梯无纸化维保工作的通知

安安全全

各区市场监督管理局，南沙区综合行政执法局，相关检验机构，市电梯安全运行监控中心、市特种设备行业协会，相关单位：

　　为贯彻落实《市场监管总局关于同意开展电梯智慧监管试点的批复》，加快推进广州市电梯无纸化维保工作，根据《广州市市场监督管理局关于全面推进电梯无纸化维保工作的通知》有关要求，市局现就统一全市电梯无纸化维保工作做法，通知如下。

　　一、关于维保单位信息管理

　　在广州市开展电梯维保业务的所有维保单位(含使用自有维保平台和第三方维保平台的维保单位)均须在广州市电梯智慧维保平台完成单位信息收集后，方可进行电梯无纸化维保。维保单位信息收集有关事项由市电梯安全运行监控中心指导各维保公司完成。

　　二、关于无纸化维保方式

　　各电梯维保公司可选择在广州市电梯智慧维保平台上直接进行无纸化维保，也可选择采用平台对接方式在自有维保平台或第三方维保平台开展无纸化维保，并将有关数据推送至广州市电梯智慧维保平台。各监管部门不得强制维保公司使用特定维保平台进行维保数据上传。选择在广州市电梯智慧维保平台上开展无纸化维保的，应按照《广州市市场监督管理局关于全面推进电梯无纸化维保工作的通知》的工作流程进行。市电梯智慧维保平台是公益性服务平台，不对外收取平台使用费。拟采用平台对接方式的，应及时向市电梯安全运行监控中心提交《广州市电梯无纸化维保平台对接申请表》(见附件1)，并按照《广州市电梯无纸化维保平台数据接口规范》(见附件2)要求与市电梯智慧维保平台进行系统对接，经市电梯安全运行监控中心测试符合要求后，市市场监管局将公布平台对接完成名单，完成平台对接后的维保单位方可在自有维保平台或第三方维保平台开展无纸化维保，维保记录统一汇集至市电梯智慧维保平台。

　　三、关于无纸化维保记录的认定

　　各维保公司开展电梯无纸化维保且维保数据实现有效、可靠、稳定上传后，并经市市场监管局确认，可停止使用纸质维保记录，市市场监管局将公布可停用纸质维保记录单位名单。无纸化维保记录以市电梯智慧维保平台调取、打印的为准，无纸化电梯维保记录在监察、检验、监督抽查、使用管理等过程中与纸质维保记录具有同等作用。

　　在推进电梯无纸化维保工作中，遇到问题请及时与市市场监管局机电处、市电梯安全运行监控中心联系,联系电话96333。

　　附件：1：广州市电梯维保无纸化平台对接申请表.docx

　　          2：广州市电梯无纸化维保平台数据接口规范.docx

　　广州市市场监督管理局

　　2021年5月24日

安安全全

附件1

广州市电梯无纸化维保平台对接申请表

维保单位名称
维保单位地址
维保单位 对接人		维保单位对接人联系方式
维保平台 服务商名称
维保平台 服务商地址
维保平台 对接人		维保平台对接人联系方式
本单位拟采用（£自有平台及App   £第三方平台及App）开展电梯无纸化维保，并申请与广州市电梯智慧维保平台进行系统对接，涉及相关开发测试由本单位负责，并按照《广州市市场监督管理局关于全面推进电梯无纸化维保工作的通知》、《广州市电梯无纸化维保平台数据接口规范》配合做好接口测试和维保记录上传工作。 本单位所提供无纸化电梯维保记录的格式、内容和要求满足《特种设备安全法》、《特种设备安全监察条例》、《广东省电梯使用安全条例》、《广州市电梯安全管理办法》以及《电梯维护保养规则》（TSG T5002）等相关法律法规和安全技术规范的要求。我单位保证，电梯维保数据在保存过程中不存在任何程度和任何形式的更改，并确保储存数据的公正、客观和安全，可实时进行查询；不利用平台数据发布涉及电梯安全状况等有关信息。 维保单位：（盖章）                            维保平台单位：（盖章）     年  月  日                                    年  月  日
广州市电梯运行监控中心 意见	年   月   日	广州市市场监督管理局意见	年   月   日
系统对接时间

广州市电梯维保无纸化平台对接申请表.doc

安安全全2021-7-30 08:48上传1下载1 页14.28 KB

广州市电梯维保无纸化平台对接申请表.doc

>

/ 1

<

<>

预览已结束，请登录阅读全文。

本文共1页,您只能预览前1页,下载后可全文阅读

点击登录

版权说明：本文档由用户提供并上传，收益归属内容提供方，若内容存在侵权，请点击底部进行举报或认领

广州市电梯维保无纸化平台对接申请表.doc (14.28 KB, 下载次数: 1)

2021-7-30 08:48 上传

点击文件名下载附件

安安全全

   

广州市电梯无纸化维保平台数据接口规范

（第一版）

广州市电梯安全运行监控中心

2020年5月20日

1. 概述

本开发指南主要用于指导使用自有维保平台或第三方维保管理平台的维保单位与广州市电梯智慧维保平台完成无纸化维保API的对接。主要包含申请账号、token令牌申请、数据交换等。

2 约定2.1 统一的消息返回格式

参数	类型	说明
code	Int	返回代码 200为成功，其他见错误码
message	String	返回信息
data	泛型	具体内容

2.2 关于账号

对于要接入广州市电梯智慧维保平台的平台，运维人员会给企业或第三方平台开设账号，并线下分配appKey和appSecret。

2.3 关于坐标

统一采用GCJ-02坐标系

2.4 统一请求头Header设置

Content-Type : application/json

Authorization : Bearer token

说明：token在请求 3.1获取token 后获取，除了此接口，调用其他接口都需要在请求头中设置token信息。

2.5 开发前准备

维保单位需提供维保检查项清单，清单结构见附件

3 接口定义3.1 获取token

1) 接口说明

根据线下分配的appKey和appSecret调用接口，申请新令牌时，旧令牌会过期

2) 接口地址(测试环境)：

https://域名:端口/datacenter/api/v1/platform/getToken

3) 请求方式：

post

4) 请求头：

Content-Type：application/json

5) 请求参数：

参数	描述	类型	是否允许空	说明
appKey	接入方用户唯一凭证	VARCHAR	否	线下分配
appSecret	凭证对应的秘钥	VARCHAR	否	线下分配

6) 请求示例：

{         "appKey":"6ea663736512ae887e324397893ea26f75d9a33195f6059c60028f71a8a62c8a",         "appSecret":"7sad7ags7ga7sgf7glhjs99j397893ea26f75d9a33195f6059c60028f71a8a62ca" }

7) 返回参数：

参数	描述	类型	是否允许空	说明
code	返回码	INTEGER	否
mssage	返回描述信息	VARCHAR	否
data	object

data数据结构

参数	描述	类型	是否允许空	说明
token	令牌，用于后续接口访问	VARCHAR	否
expiresTime	过期时间	INTEGER	否	单位：秒

3.2 上传图片（保养项图片、维保单位人员签名、使用单位人员签名）

1) 接口说明

维保记录中涉及的相关图片都要请求此接口上传图片，并在后续接口中用返回的图片唯一标识提交数据

2) 接口地址(测试环境)：

https://域名:端口/datacenter/api/v1/fwbg/uploadFile

3) 请求方式：

post

4) 请求头：

Content-Type：application/json

5) 请求参数：

参数	描述	类型	是否允许空	说明
file	图片	FILE	否	最大10M

6) 返回参数：

参数	描述	类型	是否允许空	说明
code	返回码	INTEGER	否
mssage	返回描述信息	VARCHAR	否
data	object

data数据结构

参数	描述	类型	是否允许空	说明
fileId	图片唯一标识	VARCHAR	否

3.3 维保记录上传

1) 接口说明

调用该接口上传维保记录，当请求失败时需要检查失败原因并修正重传，对于重传仍然失败的需要记录并联系接口人。

2) 接口地址(测试环境)：

https://域名:端口/datacenter/api/v1/fwbg/add

3) 请求方式：

post

4) 请求头：

Content-Type：application/json

5) 请求参数：

参数	描述	类型	是否允许空	说明
registerCode	注册代码	VARCHAR	否
maintenanceUnitCode	维保单位信用代码	VARCHAR	否
maintenanceUnitName	维保单位名称	VARCHAR	否
wbzqId	维保周期id（对应《检查项清单》维保周期id）	VARCHAR	否
workerList	执行此次维保工作的维保工信息列表	VARCHAR	否	至少传两条数据，即至少有两个维保工在现场维保
useUnitSign	使用单位签名图片唯一标识（调用上传图片接口返回）	VARCHAR	是	可以先提交维保记录，后补使用单位签名
signTime	维保签到时间	LONG	否	时间戳 精确到毫秒
signLon	维保签到时的经度	VARCHAR	否
signLat	维保签到时的纬度	VARCHAR	否
completeTime	维保完成时间	LONG	否	时间戳 精确到毫秒
completeLon	维保完成时的经度	VARCHAR	否
completeLat	维保完成时的纬度	VARCHAR	否
submiteTime	维保记录提交时间	LONG	否	维保工提交到企业自有维保平台的时间，时间戳精确到毫秒
bz	备注	VARCHAR	是	可以针对当次维保记录进行备注
jcmxList	检查明细	Array	否	结构见下表

workerList结构：

参数	描述	类型	是否允许空	说明
maintenanceWorkerPhone	维保工手机号	VARCHAR	否
maintenanceWorkerName	维保工姓名	VARCHAR	否
maintenanceWorkerSign	维保工签名图片唯一标识（调用上传图片接口返回）	VARCHAR	否

jcmxList结构：

参数	描述	类型	是否允许空	说明
syjgDm	维保项结果代码	VARCHAR	否	见数据字典
bz	备注	VARCHAR	是
wjids	检查明细对应的图片唯一标识（调用上传图片接口返回）	VARCHAR	是	多个图片时用英文逗号隔开
wbzqmxId	维保项明细id（对应《检查项清单》维保项明细id）	VARCHAR	否

6) 请求示例：

{         "registerCode": "32104401162013050013",         "maintenanceUnitCode": "维保单位名称",         "maintenanceUnitName": "维保单位信用代码",         "submitter": "张三",         "submitterPhone": "18900000000",         "maintenanceWorkerSign1": "15499c6f-819b-11e7-b046-7cd30abeb162",         "maintenanceWorkerSign2": "9303a5ba-819b-11e7-b046-7cd30abeb162",         "useUnitSign": "9303a5ba-819b-11e7-b046-7cd30abeb162",         "signTime": 1568184940623,         "signLon": "113.260209",         "signLat": "23.126868",         "completeTime": 1568184940623,         "completeLon":"113.260209",         "completeLat": "23.126868",         "submiteTime": 1568184940623,         "jcmxList": [{                         "syjgDm": "1",                         "bz": "",                         "wjids": "9303a5ba-819b-11e7-b046-7cd30abeb162,9303a5ba-819b-11e7-b046-7cd30abeb162",                         "wbzqmxId": "92f570ac-819b-11e7-b046-7cd30abeb162"                 },                 {                         "syjgDm": "1",                         "bz": "",                         "wjids": "9303a5ba-819b-11e7-b046-7cd30abeb162,9303a5ba-819b-11e7-b046-7cd30abeb162",                         "wbzqmxId": "92f570ac-819b-11e7-b046-7cd30abeb162"                 } }

7) 返回参数：

参数	描述	类型	是否允许空	说明
code	返回码	INTEGER	否
mssage	返回描述信息	VARCHAR	否
data	object

data数据结构

参数	描述	类型	是否允许空	说明
fwbgId	维保记录ID	VARCHAR	否	标识这条维保记录，后续修改维保记录或者上传使用单位签字需用到

3.4 使用单位签字上传

1) 接口说明

可以先提交维保记录，后补使用单位签字。使用单位补充签字后调用该接口上传签名图片

2) 接口地址(测试环境)：

https://域名:端口/datacenter/api/v1/fwbg/useUnitSign

3) 请求方式：

post

4) 请求头：

Content-Type：application/json

5) 请求参数：

参数	描述	类型	是否允许空	说明
fwbgId	维保记录Id	VARCHAR	否
useUnitSign	使用单位签字图片标识	VARCHAR	否

6) 请求示例：

{         "fwbgId": "15499c6f-819b-11e7-b046-7cd30abeb162",         "useUnitSign": "15499c6f-819b-11e7-b046-7cd30abeb162" }

7) 返回参数：

参数	描述	类型	是否允许空	说明
code	返回码	INTEGER	否
mssage	返回描述信息	VARCHAR	否
data	object

3.5 平台心跳接口

1) 接口说明

该接口定义用于对接方自查平台间的链路是否畅通，当请求能正常返回时表明链路正常，出现问题时需要及时处理

2) 接口地址(测试环境)：

https://域名:端口/datacenter/api/v1/platform/heart

3) 请求方式：

post

4) 请求头：

Content-Type：application/json

5) 请求参数：

无

6) 请求示例：

7) 返回参数：

参数	描述	类型	是否允许空	说明
code	返回码	INTEGER	否
mssage	返回描述信息	VARCHAR	否
data	object

4 字典项

维保项结果数据字典：

维保项结果代码	维保项结果代码描述
1	正常
2	异常
3	已修复
4	无此项

5 错误码

错误码	错误描述
701	参数错误
702	没有传token
703	凭证非法或已经作废
1000	电梯注册代码不存在
1001	维保单位信用代码不匹配
1002	该电梯不属于当前维保单位
1003	维保记录不存在
1004	图片不存在
2000	其他错误

广州市电梯无纸化维保平台数据接口规范.doc

安安全全2021-7-30 08:49上传1下载10 页71.38 KB

广州市电梯无纸化维保平台数据接口规范.doc

>

/ 10

<

<>

预览已结束，请登录阅读全文。

本文共10页,您只能预览前3页,下载后可全文阅读

点击登录

版权说明：本文档由用户提供并上传，收益归属内容提供方，若内容存在侵权，请点击底部进行举报或认领

广州市电梯无纸化维保平台数据接口规范.doc (71.38 KB, 下载次数: 1)

2021-7-30 08:49 上传

点击文件名下载附件