全國建筑工人管理服務(wù)信息平臺標(biāo)準(zhǔn)化服務(wù)接口平臺操作手冊

一、 平臺接入介紹

政府對接：

　　政府對接是指各地政府監(jiān)管部門自建的實(shí)名制平臺與“全國建筑工人管理服務(wù)信息平臺”進(jìn)行數(shù)對接，對接步驟為：自建平臺的軟件承建公司在本平臺注冊，并進(jìn)行數(shù)據(jù)對接測試，測試通過后，在本平臺發(fā)起正式對接申請，由上一級監(jiān)管部門審核，審核通過即可進(jìn)行正式數(shù)據(jù)對接。

　　企業(yè)對接：企業(yè)對接是指軟、硬件企業(yè)將自建的實(shí)名制管理系統(tǒng)和實(shí)名制相關(guān)硬件設(shè)備與“全國建筑工人管理服務(wù)信息平臺”做數(shù)據(jù)對接。

對接步驟

1. 軟件企業(yè)自建實(shí)名制系統(tǒng)對接:

　　企業(yè)在本平臺注冊，并進(jìn)行數(shù)據(jù)對接測試，測試通過后，使用實(shí)名制管理系統(tǒng)的建筑施工項(xiàng)目可聯(lián)系當(dāng)?shù)乇O(jiān)管部門在“全國建筑工人管理服務(wù)信息平臺”創(chuàng)建項(xiàng)目，項(xiàng)目創(chuàng)建成功后，系統(tǒng)自動將項(xiàng)目秘鑰發(fā)送到申請者郵箱，交與系統(tǒng)建設(shè)企業(yè)。

2. 硬件企業(yè)設(shè)備對接:

　　企業(yè)在平臺發(fā)起硬件接入申請,填寫企業(yè)相關(guān)資料,待平臺審核通過后，企業(yè)可在平臺添加產(chǎn)品，獲取測試 AppID 和SecretKey, 根據(jù)接口文檔測試通過后，可獲得正式環(huán)境的 ApplD和 SecretKey。

二、 平臺登入

　　平臺提供了兩種注冊方式，分別為政府單位和企業(yè)。在平臺首頁點(diǎn)擊“注冊”按鈕可進(jìn)入注冊界面;如下圖：

　　政府單位注冊圖

　　企業(yè)注冊圖

　　打*號的信息都是必填項(xiàng)，填寫完信息點(diǎn)擊注冊即可。

　　注：政府單位注冊需由監(jiān)管部門相關(guān)人員來完成;企業(yè)注冊需由需要對接的軟、硬件系統(tǒng)公司來完成。

　　注冊完畢可進(jìn)行登入操作，登錄進(jìn)入展示頁面如下：

三、 平臺操作 政府單位對接

　　首先登入之后需要添加測試對接賬號，點(diǎn)擊頁面左邊的“對接管理”如下圖所示：

　　添加時需要選擇對接環(huán)境;首先選擇測試環(huán)境添加賬號，先測試數(shù)據(jù)是否能夠正常上傳至平臺;同時，添加之后會立即生成賬號和秘鑰。

　　其次，使用測試賬號能夠成功對接數(shù)據(jù)之后，重新來進(jìn)行正式環(huán)境賬號的申請。

　　添加完成之后就會進(jìn)行審核流程，審核完成后，對接賬號以及秘鑰就會顯示在下圖所示區(qū)域：

　　注：該賬號審核是由該監(jiān)管單位的上級單位來審核;例：創(chuàng)建政府單位賬號的是區(qū)縣級單位，審核就需要區(qū)縣級以上的單位工作人員來審核。

　　測試賬號和正式賬號進(jìn)行數(shù)據(jù)對接，需點(diǎn)擊頁面左邊的“接口調(diào)試”，接口調(diào)試涉及相關(guān)代碼，需要貴監(jiān)管部門或者企業(yè)的技術(shù)人員來進(jìn)行。調(diào)試成功之后，數(shù)據(jù)就可以上傳至“全國建筑工人管理服務(wù)信息平臺”。

企業(yè)對接（軟件企業(yè)）

　　由于企業(yè)對接只能添加測試賬號，因此登入之后點(diǎn)擊頁面左邊的“對接管理”如下圖所示：

　　圖中包含的信息都需要進(jìn)行填寫，填寫完成之后就可以創(chuàng)建測試賬號，創(chuàng)建完成之后就會在下方顯示賬號以及秘鑰。

　　注：該測試賬號可以申請多個，可以用于不同項(xiàng)目的測試對接。

　　軟件公司在進(jìn)行測試環(huán)境對接數(shù)據(jù)期間，項(xiàng)目總包方就可以進(jìn)行正式環(huán)境賬號申請;由于企業(yè)對接沒有添加正式環(huán)境對接賬號的選項(xiàng);同時為了保證項(xiàng)目數(shù)據(jù)的真實(shí)性，應(yīng)住建部要求，企業(yè)在對接正式項(xiàng)目數(shù)據(jù)之前，需要項(xiàng)目總包方聯(lián)系當(dāng)?shù)刈〗ň止ぷ魅藛T在全國建筑工人管理服務(wù)信息平臺上創(chuàng)建正式項(xiàng)目;創(chuàng)建之后，正式環(huán)境的賬號以及秘鑰會發(fā)送至項(xiàng)目負(fù)責(zé)人的郵箱中。

　　注：獲取正式賬號以及秘鑰之后，需交由軟件公司研發(fā)人員進(jìn)行正式環(huán)境數(shù)據(jù)對接調(diào)用。

　　企業(yè)對接(硬件企業(yè))

　　未進(jìn)行硬件對接的企業(yè)首先點(diǎn)擊左側(cè)的“硬件接入”并仔細(xì)查看硬件接入說明，如下圖所示：

　　查看之后點(diǎn)擊開始對接，進(jìn)行硬件企業(yè)相關(guān)信息的填寫與上傳，帶*號的信息為必填項(xiàng)，信息的填寫必須要真實(shí)，準(zhǔn)確，填寫之后是無法進(jìn)行修改的。所有信息填寫完畢后點(diǎn)擊“提交申請”，電商會在 1-2 個工作日內(nèi)對信息進(jìn)行審核。

　　硬件接入審核通過之后，再次登錄測試平臺并點(diǎn)擊硬件接入會出現(xiàn)“產(chǎn)品管理”、“測試工人”、“測試設(shè)備”三個菜單欄。

產(chǎn)品管理

　　首先點(diǎn)開產(chǎn)品管理進(jìn)行產(chǎn)品添加操作，輸入產(chǎn)品名稱和產(chǎn)品描述保存之后會生成測試環(huán)境的 ApplD 和 SecretKey。點(diǎn)擊“編輯”可以進(jìn)行產(chǎn)品名稱和產(chǎn)品描述修改，點(diǎn)擊“刪除”可以刪掉此產(chǎn)品信息。

　　測試工人 在獲取到測試環(huán)境的相關(guān)信息之后，點(diǎn)擊“測試工人”進(jìn)行工人的添加，添加之后就可以對工人進(jìn)行各種場景的測試。

測試設(shè)備

　　在此頁面進(jìn)行設(shè)備添加，填寫好設(shè)備名稱以及 SN 號之后進(jìn)行保存。設(shè)備狀態(tài)啟用/禁用，啟用表示設(shè)備可以進(jìn)行考勤上傳，禁用表示設(shè)備禁止上傳考勤。

　　企業(yè)將上述三部分都完成后，可以在產(chǎn)品管理進(jìn)行正式環(huán)境 AppID 的生成，點(diǎn)擊“生成正式環(huán)境 AppID”可以查看生成說明。

將上述步驟全部驗(yàn)證通過之后，即可生成正式環(huán)境信息。

　　平臺“資料下載”模塊包含了全國建筑工人管理服務(wù)信息平臺的數(shù)據(jù)接口標(biāo)準(zhǔn)和接口文檔，可下載查看。

F A Q

1. 注冊賬號是誰來注冊？填寫誰的信息？

　　答：政府單位賬號注冊由監(jiān)管部門工作人員來完成;企業(yè)注冊需由需要對接的軟件系統(tǒng)公司來完成。

2. 政府單位對接的正式賬號添加之后，審核是誰來審核？是否可以越級審核？

　　答：正式賬號添加之后，由該監(jiān)管單位的上級單位來審核;區(qū)縣級賬號由市級工作人員來審;市級賬號由省級工作人員來審;省級賬號由勞務(wù)協(xié)會來審;

　　可以越級審核，省級領(lǐng)導(dǎo)可以審核區(qū)縣級正式賬號，但是勞務(wù)協(xié)會無法審核除了省級以外的賬號。

3. 怎樣檢查數(shù)據(jù)是否已經(jīng)上傳成功？怎樣檢查是否上報了多少了？

　　答：在網(wǎng)站登錄界面有一個初步的調(diào)試統(tǒng)計。

政府單位對接

① 測試賬號

　　未開始：還未申請測試賬號;

　　測試中：數(shù)據(jù)對接調(diào)試中;測試通過:正式賬號申請并審核通過;

②正式賬號

　　未開始：還未申請正式賬號;

　　等待審核：成功提交審核，但上級監(jiān)管人員還未審核;

　　審核通過：已審核，并下發(fā)正式賬號和秘鑰;

　　對接中：正式數(shù)據(jù)成功傳輸中;

企業(yè)對接

　　未開始：還未申請測試賬號;

　　測試中：軟件公司研發(fā)人員對接測試數(shù)據(jù)中;

　　同時，關(guān)于上傳進(jìn)度，網(wǎng)站首頁有一個初步的上傳統(tǒng)計，統(tǒng)計上傳成功次數(shù)以及上傳失敗次數(shù)。具體上傳內(nèi)容還是以全國建筑工人管理服務(wù)信息平臺數(shù)據(jù)為準(zhǔn)。