深圳市建筑業(yè)實(shí)名制和分賬制管理平臺(tái)與第三方實(shí)名制系統(tǒng)集

1、深圳市建筑業(yè)實(shí)名制和分賬制管理平臺(tái)與第三方實(shí)名制系統(tǒng)集成方案深圳市建筑業(yè)實(shí)名制和分賬制管理平臺(tái)與第三方實(shí)名制系統(tǒng)集成方案（V2.2.4）二一六年十二月修改控制表序號(hào)修改章節(jié)修訂類型版本修改內(nèi)容修改人修改日期審批人審批日期1首版V0.9王元元2016-12-262改進(jìn)V0.9.6郭爽2017-05-103修改V郭爽2017-6-14.43.2.2修改V2人員類型數(shù)據(jù)字典 API協(xié)議版本，apiversion可選值:1.1，取消1.0林強(qiáng)2019-1-1753.2.3修改V2.1更新考勤實(shí)時(shí)上傳林強(qiáng)2019-2-20刪除V2.2關(guān)閉工資上傳、合同上傳接口林強(qiáng)20

2、19-3-1173.2.3修改V2.2.1非“在建”工程，不能上傳考勤林強(qiáng)2019-04-0183.2.3修改V2.2.2way取值范圍：1、2、3禁用上傳安全教育記錄接口林強(qiáng)2019-07-193.1.2刪除V2.2.3關(guān)閉第3方舊的班組接口林強(qiáng)2019-8-203.2.2修改V2.2.3去掉上傳人員接口中的班組名稱字段林強(qiáng)2019-8-20V2.2.4文檔格式調(diào)整林強(qiáng)2019-9-9注： “修訂類型”為“首版”、“添加”、“刪除”和“修改”四種類型。目錄 HYPERLINK l _Toc28210_WPSOffice_Level1 1. 集成總體業(yè)務(wù)流程4 HYPERLINK l _Toc

3、31278_WPSOffice_Level2 圖 1實(shí)名分賬平臺(tái)與第三方系統(tǒng)集成關(guān)系4 HYPERLINK l _Toc11872_WPSOffice_Level2 1.2. 注冊(cè)工程信息4 HYPERLINK l _Toc4395_WPSOffice_Level2 1.3. 完善單位信息5 HYPERLINK l _Toc1239_WPSOffice_Level2 1.4. 獲取工種、人員類別等數(shù)據(jù)字典信息5 HYPERLINK l _Toc18201_WPSOffice_Level2 1.5. 上報(bào)人員實(shí)名制信息5 HYPERLINK l _Toc5166_WPSOffice_Level2

4、 1.6. 上傳考勤信息5 HYPERLINK l _Toc28240_WPSOffice_Level2 1.7. 上傳安全教育培訓(xùn)記錄5 HYPERLINK l _Toc25849_WPSOffice_Level2 1.8. 上傳工資發(fā)放記錄6 HYPERLINK l _Toc22083_WPSOffice_Level2 1.9. 人員離場(chǎng)6 HYPERLINK l _Toc31278_WPSOffice_Level1 2. API調(diào)用說(shuō)明6 HYPERLINK l _Toc5445_WPSOffice_Level2 2.1. 集成方式6 HYPERLINK l _Toc10124_WPSO

5、ffice_Level2 2.2. 調(diào)用方式說(shuō)明7 HYPERLINK l _Toc11011_WPSOffice_Level2 2.3. 調(diào)用參數(shù)7 HYPERLINK l _Toc31278_WPSOffice_Level3 系統(tǒng)參數(shù)7 HYPERLINK l _Toc11872_WPSOffice_Level3 應(yīng)用參數(shù)7 HYPERLINK l _Toc4395_WPSOffice_Level3 簽名signature7 HYPERLINK l _Toc1239_WPSOffice_Level3 注意事項(xiàng)8 HYPERLINK l _Toc14635_WPSOffice_Level2

6、2.4. 錯(cuò)誤碼一覽表8 HYPERLINK l _Toc11872_WPSOffice_Level1 3. API接口9 HYPERLINK l _Toc11960_WPSOffice_Level2 3.1. 實(shí)名分賬平臺(tái)提供的字典服務(wù)9 HYPERLINK l _Toc18201_WPSOffice_Level3 3.1.1. 調(diào)用API列表9 HYPERLINK l _Toc5166_WPSOffice_Level3 3.1.2. 人員類型數(shù)據(jù)字典 /CWRService/DictListEmpCategory9 HYPERLINK l _Toc28240_WPSOffice_Level

7、3 3.1.3. 獲取工種/崗位數(shù)據(jù)字典 /CWRService/DictListJobTypeName11 HYPERLINK l _Toc25849_WPSOffice_Level3 3.1.4. 獲取工種名稱數(shù)據(jù)字典 /CWRService/DictListJobName12 HYPERLINK l _Toc22083_WPSOffice_Level3 3.1.5. 獲取單位（公司）類型數(shù)據(jù)字典 /CWRService/GetCompanyType13 HYPERLINK l _Toc28918_WPSOffice_Level2 3.2. 實(shí)名分賬平臺(tái)提供的服務(wù)15 HYPERLINK

8、l _Toc5445_WPSOffice_Level3 3.2.1. 調(diào)用API列表15 HYPERLINK l _Toc10124_WPSOffice_Level3 3.2.2. 上報(bào)人員實(shí)名制信息 /CWRService/RegisterEmployee15 HYPERLINK l _Toc11011_WPSOffice_Level3 3.2.3. 上傳考勤信息 /CWRService/UploadPassedLog18 HYPERLINK l _Toc14635_WPSOffice_Level3 3.2.4. 人員離場(chǎng) /CWRService/userLeaveProject19 HYP

9、ERLINK l _Toc11960_WPSOffice_Level3 3.2.5. 添加企業(yè)信息 /CWRService/AddCompany21 HYPERLINK l _Toc28918_WPSOffice_Level3 3.2.6. 項(xiàng)目下移除企業(yè)信息 /CWRService/ProjectRemoveCompany22 HYPERLINK l _Toc4395_WPSOffice_Level1 4. 聯(lián)調(diào)流程24 HYPERLINK l _Toc1239_WPSOffice_Level1 5. 技術(shù)支持24集成總體業(yè)務(wù)流程深圳市建筑業(yè)實(shí)名制與分賬制管理平臺(tái)（以下簡(jiǎn)稱“實(shí)名分賬平臺(tái)”）

10、是深圳全市推行實(shí)名制管理和分帳制管理的總體信息平臺(tái)，各參建單位自建系統(tǒng)通過(guò)與實(shí)名分賬平臺(tái)集成，獲得工種、人員類別等數(shù)據(jù)字典信息；同時(shí)將自建系統(tǒng)中的項(xiàng)目、工程、單位信息，人員實(shí)名制信息、考勤信息、安全教育培訓(xùn)記錄、工資發(fā)放記錄上報(bào)到實(shí)名分賬平臺(tái)。圖 SEQ 圖 * ARABIC 1實(shí)名分賬平臺(tái)與第三方系統(tǒng)集成關(guān)系注冊(cè)工程信息各建設(shè)項(xiàng)目的管理人員將項(xiàng)目工程信息信息在實(shí)名分賬平臺(tái)中進(jìn)行注冊(cè)。項(xiàng)目管理人員提交項(xiàng)目工程申請(qǐng)表到實(shí)名分賬平臺(tái)“賬號(hào)注冊(cè)”，并在帳號(hào)申請(qǐng)通過(guò)后，登錄系統(tǒng)創(chuàng)建參建單位。項(xiàng)目工程信息注冊(cè)申請(qǐng)表見(jiàn)平臺(tái)“賬號(hào)注冊(cè)”頁(yè)面當(dāng)中的附表下載。完善單位信息各項(xiàng)目上的管理人員登錄實(shí)名分賬平臺(tái)添加參

11、建單位到項(xiàng)目下。獲取工種、人員類別等數(shù)據(jù)字典信息第三方實(shí)名制系統(tǒng)通過(guò)集成接口獲得工種、人員類別等數(shù)據(jù)字典信息，用于上報(bào)人員實(shí)名制信息。上報(bào)人員實(shí)名制信息第三方實(shí)名制系統(tǒng)通過(guò)集成接口將本系統(tǒng)中的人員實(shí)名制信息上報(bào)到實(shí)名分賬平臺(tái)中。上報(bào)的實(shí)名制信息包括：項(xiàng)目編號(hào)、身份證號(hào)碼、身份證照片、員工姓名、手機(jī)號(hào)、身份證地址、民族、通行時(shí)段、現(xiàn)場(chǎng)采集人臉照片、所屬單位、班組名稱、人員類別、人員類型、工種名稱、簽發(fā)機(jī)關(guān)、有效期限、開(kāi)戶銀行、銀行賬戶等。上傳考勤信息第三方實(shí)名制系統(tǒng)通過(guò)集成接口將本系統(tǒng)中的考勤信息上報(bào)到實(shí)名分賬平臺(tái)中，采用實(shí)時(shí)上報(bào)的方式。上傳的考勤信息包括：項(xiàng)目編號(hào)、門(mén)禁設(shè)備號(hào)、人員身份證號(hào)、人

12、員姓名、通行方向、通行方式以及現(xiàn)場(chǎng)采集的人臉照片等。上傳安全教育培訓(xùn)記錄已取消。上傳工資發(fā)放記錄已取消。人員離場(chǎng)第三方實(shí)名制系統(tǒng)通過(guò)集成接口將本系統(tǒng)中的人員離場(chǎng)信息上傳到實(shí)名分賬平臺(tái)中。離場(chǎng)信息包括：項(xiàng)目編號(hào)、離場(chǎng)人員身份證號(hào)等。API調(diào)用說(shuō)明集成方式采用Http請(qǐng)求方式，REST風(fēng)格進(jìn)行集成接口的訪問(wèn)。第三方系統(tǒng)按照接口規(guī)范拼裝一個(gè)正確的URL，通過(guò)HTTP請(qǐng)求到實(shí)名分賬平臺(tái)接口。調(diào)用原理示意圖如下。調(diào)用方式說(shuō)明URL地址/yyyyService/APIfunction?api_key=x1&api_version=x2& client_serial =x3timestamp =x4&sig

13、nature=x5EncodingUTF-8MethodPOSTBodyJSON數(shù)據(jù)返回JSON數(shù)據(jù)調(diào)用參數(shù)調(diào)用API ，必須傳入系統(tǒng)參數(shù)和應(yīng)用參數(shù)。系統(tǒng)參數(shù)api_keyStringY授權(quán)帳號(hào)api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號(hào)，“PL”+32位uuidtimestampStringY時(shí)間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘signatureStringY對(duì)API輸入?yún)?shù)進(jìn)行MD5加密獲得應(yīng)用參數(shù)應(yīng)用參數(shù)放在bod

14、y數(shù)據(jù)區(qū)簽名signature使用系統(tǒng)默認(rèn)MD5加密，因?yàn)楦髡Z(yǔ)言語(yǔ)法不一致，以下實(shí)例只體現(xiàn)邏輯。為便于說(shuō)明，假設(shè) api_key、api_secret值均為 test。body區(qū)的數(shù)據(jù)項(xiàng)對(duì)應(yīng)的json key為”body”， value為整個(gè)body原始字符串。1）所有參數(shù)為： api_key=test api_version=1.0 client_serial=facedevice_0613 timestamp=2016-06-10 09:05:03 body=client_version:2）按照參數(shù)名稱升序排列： api_key=test api_version=1.0 body=cli

15、ent_version: client_serial=facedevice_0613 timestamp=2016-06-10 09:05:03 3）連接字符串 連接參數(shù)名與參數(shù)值,并在首尾加上api_secret，如下：testapi_keytestapi_version1.0bodyclient_version:client_serialfacedevice_0613timestamp2016-06-10 09:05:03test若無(wú)應(yīng)用參數(shù)時(shí)body為如下：testapi_keytestapi_version1.0bodyclient_serialfacedevice_0613times

16、tamp2016-06-10 09:05:03test4）生成簽名： 32位大寫(xiě)MD5值-XXXXXXXXXXXXXXXXXXXX5）拼裝HTTP請(qǐng)求 將所有參數(shù)值轉(zhuǎn)換為UTF-8編碼，然后拼裝，通過(guò)瀏覽器訪問(wèn)該地址，即成功調(diào)用一次接口。注意事項(xiàng)所有的請(qǐng)求和響應(yīng)數(shù)據(jù)編碼皆為utf-8格式，url里的所有參數(shù)值請(qǐng)做urlencode編碼。錯(cuò)誤碼一覽表coderesultmessage說(shuō)明或解決方案00truesuccess（接口調(diào)用成功）11falseerror(調(diào)用接口失敗，具體信息見(jiàn)detail_message或result_data)10partial error部分失敗具體的信息見(jiàn)res

17、ult_data99false請(qǐng)求數(shù)據(jù)異常請(qǐng)查看詳細(xì)錯(cuò)誤信息26false禁止訪問(wèn)接口該用戶沒(méi)有權(quán)限訪問(wèn)，包括（1）根據(jù)API_KEY檢測(cè)賬號(hào)是否授權(quán)；（2）接收到的API_KEY與根據(jù)設(shè)備序號(hào)在后端查詢到的API_KEY不一致時(shí)報(bào)此錯(cuò)誤40false缺少必要參數(shù)請(qǐng)檢查參數(shù)41false非法的參數(shù)請(qǐng)檢查參數(shù)格式47falseERROR:未找到數(shù)據(jù)根據(jù)參數(shù)沒(méi)有查詢到數(shù)據(jù)，請(qǐng)檢查參數(shù)值的正確性48false數(shù)據(jù)重復(fù)同一條數(shù)據(jù)重復(fù)發(fā)送API接口測(cè)試環(huán)境登陸地址：5:7013 測(cè)試接口地址： HYPERLINK 5:7040 5:7040 正式環(huán)境登陸地址： 正式接口地址： 實(shí)名分賬平臺(tái)提供的字典服務(wù)

18、調(diào)用API列表API接口名稱API描述/CWRService/DictListEmpCategory人員類型數(shù)據(jù)字典/CWRService/DictListJobTypeName人員類別數(shù)據(jù)字典/CWRService/DictListJobName工種名稱數(shù)據(jù)字典/CWRService/GetCompanyType單位類型數(shù)據(jù)字典人員類型數(shù)據(jù)字典 /CWRService/DictListEmpCategory應(yīng)用場(chǎng)景 獲取人員類型信息，建筑工人、正式人員、勞務(wù)派遣人員或?qū)＜业?。與項(xiàng)目無(wú)關(guān)，推送整個(gè)數(shù)據(jù)字典（上報(bào)人員實(shí)名制信息接口1.0版本的人員類型參數(shù)使用的是人員類型名稱，1.1版本使用的是人

19、員類型編碼）。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號(hào)api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號(hào)timestampStringY時(shí)間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘signatureStringY對(duì)API輸入?yún)?shù)進(jìn)行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述無(wú)請(qǐng)求url示例5:7040/CWRService/DictListEmpCategory?api_version=1.0&t

20、imestamp=2017-05-16 18:10:22&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=D8F8149A7FC6533D848E3BF9F1E29347&api_key=DCD851F41C384EB3AE9326AD26EC667D返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應(yīng)用程序錯(cuò)誤碼，詳見(jiàn)錯(cuò)誤碼一覽表messageStringN錯(cuò)誤信息detai

21、l_messageStringN詳細(xì)錯(cuò)誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述dict_listObject ArrayY字典列表（下方三個(gè)屬性為字典列表內(nèi)容）ordersStringY編碼valueStringY名稱flagStringY默認(rèn)項(xiàng)標(biāo)識(shí)。“Y”-默認(rèn)項(xiàng)，”N”-非默認(rèn)項(xiàng)失敗返回的result_data結(jié)果集名稱類型是否必須描述無(wú)返回示例示例名稱示例說(shuō)明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案獲取工種/崗位數(shù)據(jù)字典 /CWRService/DictListJobTypeName應(yīng)用場(chǎng)景 獲取人

22、員類別信息，比如一般作業(yè)工種、特種作業(yè)工種等。與項(xiàng)目無(wú)關(guān)，推送整個(gè)數(shù)據(jù)字典（上報(bào)人員實(shí)名制信息接口1.0版本（1.0版本已刪除，請(qǐng)不要使用）的人員類別參數(shù)使用的是人員類別名稱，1.1版本使用的是人員類別編碼）。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號(hào)api_versionStringYAPI協(xié)議版本，可選值:1.1client_serialStringY第三方平臺(tái)序列號(hào)timestampStringY時(shí)間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘signatureStringY對(duì)A

23、PI輸入?yún)?shù)進(jìn)行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述無(wú)請(qǐng)求url示例5:7040/CWRService/DictListJobTypeName?api_version=1.0×tamp=2017-05-16 18:13:08&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=C9A8510420812F6340B53B415682F836&api_key=DCD851F41C384EB3AE9326AD26EC667D返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。t

24、rue表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應(yīng)用程序錯(cuò)誤碼，詳見(jiàn)錯(cuò)誤碼一覽表messageStringN錯(cuò)誤信息detail_messageStringN詳細(xì)錯(cuò)誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述dict_listObject ArrayY字典列表（下方三個(gè)屬性為字典列表內(nèi)容）ordersStringY編碼valueStringY名稱flagStringY默認(rèn)項(xiàng)標(biāo)識(shí)?！癥”-默認(rèn)項(xiàng)，”N”-非默認(rèn)項(xiàng)失敗返回的result_data結(jié)果集名稱類型是

25、否必須描述無(wú)返回示例示例名稱示例說(shuō)明失敗1失敗2失敗3成功獲取工種名稱數(shù)據(jù)字典 /CWRService/DictListJobName應(yīng)用場(chǎng)景 獲取所有工種信息，如木工、混凝土工、機(jī)械操作工，等通過(guò)驗(yàn)證后獲得系統(tǒng)所有班組名稱及工種名稱對(duì)應(yīng)的工種編碼（上報(bào)人員實(shí)名制信息接口1.0版本的工種參數(shù)使用的是工種名稱（已作廢），1.1版本使用的是工種編碼）。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號(hào)api_versionStringYAPI協(xié)議版本，可選值:1.1client_serialStringY第三方系統(tǒng)編號(hào)timestampStringY時(shí)間戳，格式為yyyy-MM-dd

26、 hh:mm:ss，例如：2016-06-06 13:52:03。signatureStringY對(duì)API輸入?yún)?shù)進(jìn)行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述無(wú)請(qǐng)求url示例5:7040/CWRService/DictListJobName?api_version=1.0×tamp=2017-05-16 18:14:14&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=F467F7D16D16867264C511E3A643E4BC&api_key=DCD851F41C384EB3AE9326AD2

27、6EC667D返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應(yīng)用程序錯(cuò)誤碼，詳見(jiàn)錯(cuò)誤碼一覽表messageStringN錯(cuò)誤信息detail_messageStringN詳細(xì)錯(cuò)誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述dict_listObject ArrayY字典列表（下方三個(gè)屬性為字典列表內(nèi)容）ordersStringY編碼valueStringY名稱flagString

28、Y默認(rèn)項(xiàng)標(biāo)識(shí)?！癥”-默認(rèn)項(xiàng)，”N”-非默認(rèn)項(xiàng)失敗返回的result_data結(jié)果集名稱類型是否必須描述無(wú)返回示例示例名稱示例說(shuō)明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案獲取單位（公司）類型數(shù)據(jù)字典 /CWRService/GetCompanyType應(yīng)用場(chǎng)景 獲取所有單位類型，如監(jiān)理單位、設(shè)計(jì)單位等，通過(guò)驗(yàn)證后獲得系統(tǒng)所有班組名稱及工種名稱對(duì)應(yīng)的工種編碼，保存單位信息時(shí)獲取的是單位類型的編碼值。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號(hào)api_versionStringYAPI協(xié)議版本，可選值:1.1client_serialStringY第三方系統(tǒng)

29、編號(hào)timestampStringY時(shí)間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。signatureStringY對(duì)API輸入?yún)?shù)進(jìn)行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述無(wú)請(qǐng)求url示例5:7040/CWRService/GetCompanyType?api_version=1.0×tamp=2017-05-16 18:25:46&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=36F8D3B2D5DF63C655ED0EE011082D5B

30、&api_key=DCD851F41C384EB3AE9326AD26EC667D返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應(yīng)用程序錯(cuò)誤碼，詳見(jiàn)錯(cuò)誤碼一覽表messageStringN錯(cuò)誤信息detail_messageStringN詳細(xì)錯(cuò)誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述dict_listObject ArrayY字典列表（下方三個(gè)屬性為字典列表內(nèi)容）order

31、sStringY編碼valueStringY名稱flagStringY默認(rèn)項(xiàng)標(biāo)識(shí)?！癥”-默認(rèn)項(xiàng)，”N”-非默認(rèn)項(xiàng)失敗返回的result_data結(jié)果集名稱類型是否必須描述無(wú)返回示例示例名稱示例說(shuō)明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案實(shí)名分賬平臺(tái)提供的服務(wù)調(diào)用API列表API接口名稱API描述/CWRService/RegisterEmployee上報(bào)人員實(shí)名制信息/CWRService/UploadPassedLog上傳考勤信息/CWRService/UploadSafetyEducation上傳安全教育記錄/CWRService/UploadPayroll上傳工資發(fā)

32、放記錄/CWRService/userLeaveProject人員離場(chǎng) /CWRService/AddCompany添加單位信息/CWRService/ProjectRemoveCompany項(xiàng)目下移除單位上報(bào)人員實(shí)名制信息 /CWRService/RegisterEmployee應(yīng)用場(chǎng)景 第三方系統(tǒng)將人員實(shí)名制信息上傳到實(shí)名分賬平臺(tái)，同一個(gè)身份證號(hào)碼第一次上傳為新增，第二次及以上上傳則更新之前的人員信息。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號(hào)api_versionStringYAPI協(xié)議版本，可選值:1.1client_serialStringY第三方系統(tǒng)編號(hào)tim

33、estampStringY時(shí)間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘signatureStringY對(duì)API輸入?yún)?shù)進(jìn)行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述Project_IDStringY同步編號(hào)id_codeStringY身份證號(hào)碼id_photoStringY身份證相片，Base64編碼emp_nameStringY員工姓名emp_phoneStringY手機(jī)號(hào)emp_nativeplaceStringY身份證地址emp_nationStringY民族(如：漢、苗、土家、維吾

34、爾等)pass_periodStringY通行時(shí)段，格式y(tǒng)yyy-MM-dd:yyyy-MM-dd如“2017-05-02:2017-12-31”，結(jié)束日期不確定時(shí)可為“2017-05-02:”值通行時(shí)段開(kāi)始日期小于等于上傳日期，結(jié)束日期大于等于開(kāi)始日期match_flagStringY匹配標(biāo)識(shí)。 Y人證匹配，N不匹配，3次采集比對(duì)都沒(méi)通過(guò)facephotoStringY工地現(xiàn)場(chǎng)采集的人臉照片，Base64編碼emp_companyStringY所屬單位（填寫(xiě)單位的全稱，以實(shí)名制系統(tǒng)錄入的為準(zhǔn)）。emp_categoryStringY人員類型，參考人員類型字典3.1.3。1.0版本取消，不再支

35、持；1.1版本取字典對(duì)應(yīng)的編碼（orders） (00: 勞務(wù)工人,01: 建設(shè)單位管理人員,02: 監(jiān)理單位管理人員,03: 施工單位管理人員,05: 其它參建單位管理人員) ，注意：人員類型上傳后不允許變更emp_deptStringN所屬部門(mén)(人員所在單位下的部門(mén)名稱)。job_typenameStringY工種/崗位。工種/崗位字典3.1.4。1.0版取消，不再支持；1.1版本取字典對(duì)應(yīng)的編碼（orders）（1：一般作業(yè)工種，2：特種作業(yè)工種，3：項(xiàng)目管理崗位，4：其它工種）job_nameStringY工種名稱，參考工種數(shù)據(jù)字典3.1.5。1.0版本過(guò)時(shí)，取消；1.1版本取班組字典

36、對(duì)應(yīng)的編碼（orders）contract_statusStringY合同辦理。1是，0否。id_agencyStringY簽發(fā)機(jī)關(guān)。id_validdateStringY有效期限。按身份證上顯示格式。emp_banknameStringN開(kāi)戶行emp_cardnumStringN銀行賬號(hào)job_deptStringN現(xiàn)工作部門(mén)。(人員所在單位下的部門(mén)名稱)。idphoto_scanStringY身份證掃描件正面，Base64編碼idphoto_scan2StringY身份證掃描件反面，Base64編碼請(qǐng)求url示例5:7040/CWRService/RegisterEmployee?api_

37、version=1.0×tamp=2017-03-07 10:19:29&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=88FD1C1DDA91ACEB6ECC17255BCBDCBA&api_key=DCD851F41C384EB3AE9326AD26EC667DPOST的JSON數(shù)據(jù)示例Project_ID:1000001,id_code:3708021992110112,id_photo:/9j/4AAQSk,emp_name:張三,emp_phone:1888888888,emp_nativeplace:

38、陜西省石泉縣城關(guān)鎮(zhèn)東街片七組173號(hào),emp_nation:漢,pass_period:2017-01-01:2018-01-01,match_flag:Y,facephoto:wxHvRXgZcqeKKOVCuz/9k=,emp_company:中車(chē)信息技術(shù)有限公司,work_typename:0,emp_category:1,cwr_iskeypsn:1,emp_dept:技術(shù)部1,job_typename:00,job_name:EEF22645FEE411E68E5A089E016627F6,contract_status:1,id_agency:陜西省石泉縣城關(guān)鎮(zhèn)東街片七組173號(hào),

39、id_validdate:2008.02.14-2028.02.14,emp_native_province:陜西,emp_bankname:建設(shè)銀行,emp_cardnum:6217002710000684874,job_dept:技術(shù)部,idphoto_scan:JAHGJ123,idphoto_scan2:JAHGJ1JKK/1223返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應(yīng)用程序錯(cuò)誤碼，詳見(jiàn)錯(cuò)誤碼一覽表messageString

40、N錯(cuò)誤信息detail_messageStringN詳細(xì)錯(cuò)誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須長(zhǎng)度描述emp_idStringY32員工工號(hào)pass_periodStringY32通行時(shí)段，格式y(tǒng)yyy-MM-dd:yyyy-MM-ddmodify_timeStringY32修改時(shí)間,”yyyy-MM-dd hh:mm:ss.zzz”失敗返回的result_data結(jié)果集名稱類型是否必須描述無(wú)返回示例示例名稱示例說(shuō)明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案上傳考勤信息 /CWRService/Upload

41、PassedLog應(yīng)用場(chǎng)景 第三方系統(tǒng)向?qū)嵜仲~平臺(tái)發(fā)送通行日志。按照住建局實(shí)名制規(guī)定實(shí)時(shí)上傳考勤數(shù)據(jù)，實(shí)時(shí)誤差范圍(上傳時(shí)間減去考勤通過(guò)時(shí)間)以住建局通知為準(zhǔn)，目前誤差范圍為2 小時(shí)。工程狀態(tài)非“在建”，不允許上傳。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號(hào)api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號(hào)timestampStringY時(shí)間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘signatureString

42、Y對(duì)API輸入?yún)?shù)進(jìn)行MD5加密獲得POST的JSON數(shù)據(jù)： 名稱類型是否必須描述Project_IDStringY同步編號(hào)Device_IDStringY門(mén)禁設(shè)備序列號(hào)passedlog_listObject ArrayY通行日志數(shù)組(下方所有屬性為通行日志數(shù)組內(nèi)容)person_typeStringY人員類型。0臨時(shí)人員（訪客），1員工person_idStringY人員編號(hào)（上報(bào)人員實(shí)名制信息接口返回的員工編號(hào)）或身份證號(hào)person_nameStringY人員姓名passed_timeStringY通過(guò)時(shí)間 ”yyyy-MM-dd hh:mm:ss”directionStringY通行

43、方向 in進(jìn)，out出wayStringY通行方式 1人臉識(shí)別，2虹膜識(shí)別，3指紋識(shí)別site_photoStringN工地人臉照片數(shù)據(jù)，Base64編碼，圖像底部帶過(guò)閘時(shí)間水印，黑底白字longitudeStringN經(jīng)度latitudeStringN緯度addressStringN位置（打考勤時(shí)所在的詳細(xì)地址）無(wú)請(qǐng)求url示例5:7040/CWRService/UploadPassedLog?api_version=1.0×tamp=2017-03-07 10:21:32&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signa

44、ture=B6876A3560308EE8D3CF2B4469AA0C09&api_key=DCD851F41C384EB3AE9326AD26EC667DPOST的JSON數(shù)據(jù)示例Project_ID:440300201500303,Device_ID:1,passedlog_list:person_type:1,person_id:1,person_name:fh,passed_time:2017-03-29 12:12:12,direction:in,way:1,site_photo:xVmxVbXVVaGN2emswdUJiT0QxU1dienArNFozVi9URn,person_t

45、ype:1,person_id:1,person_name:fh,passed_time:2017-03-29 16:12:12,direction:out,way:1,site_photo:xVmxVbXVVaGN2emswdUJiT0QxU1dienArNFozVi9URn返回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應(yīng)用程序錯(cuò)誤碼，詳見(jiàn)錯(cuò)誤碼一覽表messageStringN錯(cuò)誤信息detail_messageStringN詳細(xì)錯(cuò)誤信息

46、result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須描述無(wú)失敗返回的result_data結(jié)果集名稱類型是否必須描述無(wú)返回示例示例名稱示例說(shuō)明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案人員離場(chǎng) /CWRService/userLeaveProject應(yīng)用場(chǎng)景 第三方人員離場(chǎng)時(shí)需要同步修改實(shí)名制平臺(tái)對(duì)應(yīng)的人員狀態(tài)。輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號(hào)api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號(hào)timestampStringY時(shí)間

47、戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘signatureStringY對(duì)API輸入?yún)?shù)進(jìn)行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述Project_IDStringY同步編號(hào)userLeaveProject_listObject ArrayY用戶離場(chǎng)數(shù)組(下方所有屬性為人員數(shù)組內(nèi)容)id_codeStringY身份證號(hào)碼請(qǐng)求url示例5:7040/CWRService/ userLeaveProject?api_version=1.0×tamp=2017-03-07 10:19

48、:29&client_serial=PL2C9528C3C8D84206AC5B324DBE9DF92C&signature=88FD1C1DDA91ACEB6ECC17255BCBDCBA&api_key=DCD851F41C384EB3AE9326AD26EC667DPOST的JSON數(shù)據(jù)示例Project_ID:440300201500303, userLeaveProject_list :id_codeid_code回的JSON數(shù)據(jù)名稱類型是否必須描述resultStringY接口調(diào)用結(jié)果。true表示接口

49、調(diào)用成功，false表示接口調(diào)用失敗。statusIntegerYhttp協(xié)議狀態(tài)值codeStringY應(yīng)用程序錯(cuò)誤碼，詳見(jiàn)錯(cuò)誤碼一覽表messageStringN錯(cuò)誤信息detail_messageStringN詳細(xì)錯(cuò)誤信息result_dataObjectY返回結(jié)果集成功返回的result_data結(jié)果集名稱類型是否必須長(zhǎng)度描述無(wú)失敗返回的result_data結(jié)果集名稱類型是否必須描述無(wú)返回示例示例名稱示例說(shuō)明失敗1失敗2失敗3成功返回狀態(tài)碼狀態(tài)碼返回狀態(tài)碼描述解決方案添加企業(yè)信息 /CWRService/AddCompany說(shuō)明：如果添加企業(yè)的數(shù)據(jù)有誤，可以直接修改數(shù)據(jù)重新上傳，系統(tǒng)

50、會(huì)更新數(shù)據(jù)，即新增和修改接口一致。應(yīng)用場(chǎng)景 用于在項(xiàng)目下注冊(cè)企業(yè)信息輸入?yún)?shù)名稱類型是否必須描述api_keyStringY授權(quán)帳號(hào)api_versionStringYAPI協(xié)議版本，可選值:1.0client_serialStringY第三方系統(tǒng)編號(hào)timestampStringY時(shí)間戳，格式為yyyy-MM-dd hh:mm:ss，例如：2016-06-06 13:52:03。服務(wù)端允許客戶端請(qǐng)求時(shí)間誤差為6分鐘signatureStringY對(duì)API輸入?yún)?shù)進(jìn)行MD5加密獲得POST的JSON數(shù)據(jù)名稱類型是否必須描述Project_IDStringY同步編號(hào)Company_NameStringY企業(yè)名稱Short_NameStringN企業(yè)簡(jiǎn)稱CapitalStringN注冊(cè)資金(單位:萬(wàn)元)Legal_PersonStringY法定代表人SUIDStringY社會(huì)統(tǒng)一信用代碼（組織機(jī)構(gòu)代碼）Bank_OpenStringN基本賬戶開(kāi)戶銀行Bank_NumStringN基本賬戶銀行賬號(hào)AddressStringN單位詳細(xì)地址ContactsStringN單位聯(lián)系人