全国建筑工人管理服务信息平台标准化服务接口平台操作手册
一、 平台接入介绍
*** 对接:
*** 对接是指各地 *** 监管部门自建的实名制平台与“全国建筑工人管理服务信息平台”进行数对接,对接步骤为:自建平台的软件承建公司在本平台注册,并进行数据对接测试,测试通过后,在本平台发起正式对接申请,由上一级监管部门审核,审核通过即可进行正式数据对接。
添加微信好友, 获取更多信息
复制微信号
企业对接:企业对接是指软、硬件企业将自建的实名制管理系统和实名制相关硬件设备与“全国建筑工人管理服务信息平台”做数据对接。
对接步骤
1. 软件企业自建实名制系统对接:
企业在本平台注册,并进行数据对接测试,测试通过后,使用实名制管理系统的建筑施工项目可联系当地监管部门在“全国建筑工人管理服务信息平台”创建项目,项目创建成功后,系统自动将项目秘钥发送到申请者邮箱,交与系统建设企业。
2. 硬件企业设备对接:
企业在平台发起硬件接入申请,填写企业相关资料,待平台审核通过后,企业可在平台添加产品,获取测试 AppID 和SecretKey, 根据接口文档测试通过后,可获得正式环境的 ApplD和 SecretKey。
二、 平台登入
平台提供了两种注册方式,分别为 *** 单位和企业。在平台首页点击“注册”按钮可进入注册界面;如下图:
*** 单位注册图
企业注册图
打*号的信息都是必填项,填写完信息点击注册即可。
注: *** 单位注册需由监管部门相关人员来完成;企业注册需由需要对接的软、硬件系统公司来完成。
注册完毕可进行登入操作,登录进入展示页面如下:
三、 平台操作 *** 单位对接
首先登入之后需要添加测试对接账号,点击页面左边的“对接管理”如下图所示:
添加时需要选择对接环境;首先选择测试环境添加账号,先测试数据是否能够正常上传至平台;同时,添加之后会立即生成账号和秘钥。
其次,使用测试账号能够成功对接数据之后,重新来进行正式环境账号的申请。
添加完成之后就会进行审核流程,审核完成后,对接账号以及秘钥就会显示在下图所示区域:
注:该账号审核是由该监管单位的上级单位来审核;例:创建 *** 单位账号的是区县级单位,审核就需要区县级以上的单位工作人员来审核。
测试账号和正式账号进行数据对接,需点击页面左边的“接口调试”,接口调试涉及相关代码,需要贵监管部门或者企业的技术人员来进行。调试成功之后,数据就可以上传至“全国建筑工人管理服务信息平台”。
企业对接(软件企业)
由于企业对接只能添加测试账号,因此登入之后点击页面左边的“对接管理”如下图所示:
图中包含的信息都需要进行填写,填写完成之后就可以创建测试账号,创建完成之后就会在下方显示账号以及秘钥。
注:该测试账号可以申请多个,可以用于不同项目的测试对接。
软件公司在进行测试环境对接数据期间,项目总包方就可以进行正式环境账号申请;由于企业对接没有添加正式环境对接账号的选项;同时为了保证项目数据的真实性,应住建部要求,企业在对接正式项目数据之前,需要项目总包方联系当地住建局工作人员在全国建筑工人管理服务信息平台上创建正式项目;创建之后,正式环境的账号以及秘钥会发送至项目负责人的邮箱中。
注:获取正式账号以及秘钥之后,需交由软件公司研发人员进行正式环境数据对接调用。
企业对接(硬件企业)
未进行硬件对接的企业首先点击左侧的“硬件接入”并仔细查看硬件接入说明,如下图所示:
查看之后点击开始对接,进行硬件企业相关信息的填写与上传,带*号的信息为必填项,信息的填写必须要真实,准确,填写之后是无法进行修改的。所有信息填写完毕后点击“提交申请”,电商会在 1-2 个工作日内对信息进行审核。
硬件接入审核通过之后,再次登录测试平台并点击硬件接入会出现“产品管理”、“测试工人”、“测试设备”三个菜单栏。
产品管理
首先点开产品管理进行产品添加操作,输入产品名称和产品描述保存之后会生成测试环境的 ApplD 和 SecretKey。点击“编辑”可以进行产品名称和产品描述修改,点击“删除”可以删掉此产品信息。
测试工人 在获取到测试环境的相关信息之后,点击“测试工人”进行工人的添加,添加之后就可以对工人进行各种场景的测试。
测试设备
在此页面进行设备添加,填写好设备名称以及 SN 号之后进行保存。设备状态启用/禁用,启用表示设备可以进行考勤上传,禁用表示设备禁止上传考勤。
企业将上述三部分都完成后,可以在产品管理进行正式环境 AppID 的生成,点击“生成正式环境 AppID”可以查看生成说明。
将上述步骤全部验证通过之后,即可生成正式环境信息。
平台“资料下载”模块包含了全国建筑工人管理服务信息平台的数据接口标准和接口文档,可下载查看。
F A Q
1. 注册账号是谁来注册?填写谁的信息?
答: *** 单位账号注册由监管部门工作人员来完成;企业注册需由需要对接的软件系统公司来完成。
2. *** 单位对接的正式账号添加之后,审核是谁来审核?是否可以越级审核?
答:正式账号添加之后,由该监管单位的上级单位来审核;区县级账号由市级工作人员来审;市级账号由省级工作人员来审;省级账号由劳务协会来审;
可以越级审核,省级领导可以审核区县级正式账号,但是劳务协会无法审核除了省级以外的账号。
3. 怎样检查数据是否已经上传成功?怎样检查是否上报了多少了?
答:在网站登录界面有一个初步的调试统计。
*** 单位对接
① 测试账号
未开始:还未申请测试账号;
测试中:数据对接调试中;测试通过:正式账号申请并审核通过;
②正式账号
未开始:还未申请正式账号;
等待审核:成功提交审核,但上级监管人员还未审核;
审核通过:已审核,并下发正式账号和秘钥;
对接中:正式数据成功传输中;
企业对接
未开始:还未申请测试账号;
测试中:软件公司研发人员对接测试数据中;
同时,关于上传进度,网站首页有一个初步的上传统计,统计上传成功次数以及上传失败次数。具体上传内容还是以全国建筑工人管理服务信息平台数据为准。