廣東省建筑工人管理服務信息平臺數(shù)據(jù)接口標準（V1.3版）

1、附件1廣東省建筑工人管理服務信息平臺數(shù)據(jù)接口標準（V1.3版）發(fā)布單位：廣東省住房和城鄉(xiāng)建設廳發(fā)布時間：2022年8月目 錄 TOC o 1-3 h z u HYPERLINK l _Toc111121095 1 概述 PAGEREF _Toc111121095 h 1 HYPERLINK l _Toc111121096 1.1 簡介 PAGEREF _Toc111121096 h 1 HYPERLINK l _Toc111121097 1.2 基本術語 PAGEREF _Toc111121097 h 1 HYPERLINK l _Toc111121098 1.3 接口調(diào)用方式 PAGEREF

2、 _Toc111121098 h 1 HYPERLINK l _Toc111121099 1.4 接口響應 PAGEREF _Toc111121099 h 2 HYPERLINK l _Toc111121100 1.5 接口類型 PAGEREF _Toc111121100 h 4 HYPERLINK l _Toc111121101 1.5.1 異步處理接口 PAGEREF _Toc111121101 h 4 HYPERLINK l _Toc111121102 1.5.2 同步處理接口 PAGEREF _Toc111121102 h 4 HYPERLINK l _Toc111121103 2 接

3、口詳細信息 PAGEREF _Toc111121103 h 4 HYPERLINK l _Toc111121104 2.1 企業(yè) PAGEREF _Toc111121104 h 5 HYPERLINK l _Toc111121105 2.1.1 上傳企業(yè)基本信息 PAGEREF _Toc111121105 h 5 HYPERLINK l _Toc111121106 2.1.2 查詢企業(yè)基本信息 PAGEREF _Toc111121106 h 8 HYPERLINK l _Toc111121107 2.2 項目 PAGEREF _Toc111121107 h 10 HYPERLINK l _To

4、c111121108 2.2.1 項目基本信息 PAGEREF _Toc111121108 h 10 HYPERLINK l _Toc111121109 2.2.2 項目參建單位 PAGEREF _Toc111121109 h 20 HYPERLINK l _Toc111121110 2.2.3 項目班組 PAGEREF _Toc111121110 h 28 HYPERLINK l _Toc111121111 2.2.4 項目人員 PAGEREF _Toc111121111 h 39 HYPERLINK l _Toc111121112 2.2.5 項目人員進退場 PAGEREF _Toc111

5、121112 h 48 HYPERLINK l _Toc111121113 2.2.6 項目人員合同 PAGEREF _Toc111121113 h 51 HYPERLINK l _Toc111121114 2.2.7 項目人員考勤 PAGEREF _Toc111121114 h 56 HYPERLINK l _Toc111121115 2.2.8 項目人員工資 PAGEREF _Toc111121115 h 61 HYPERLINK l _Toc111121116 2.2.9 項目培訓 PAGEREF _Toc111121116 h 67 HYPERLINK l _Toc111121117

6、2.2.10新開工項目密鑰辦理信息 PAGEREF _Toc111121117 h 73 HYPERLINK l _Toc111121118 2.3 人員 PAGEREF _Toc111121118 h 81 HYPERLINK l _Toc111121119 2.3.1 查詢?nèi)藛T基本信息 PAGEREF _Toc111121119 h 81 HYPERLINK l _Toc111121120 2.4 異步接口調(diào)用結果查詢 PAGEREF _Toc111121120 h 83 HYPERLINK l _Toc111121121 2.4.1 接口信息說明 PAGEREF _Toc11112112

7、1 h 83 HYPERLINK l _Toc111121122 3 數(shù)據(jù)字典 PAGEREF _Toc111121122 h 85 HYPERLINK l _Toc111121123 3.1 企業(yè)登記注冊類型字典表 PAGEREF _Toc111121123 h 85 HYPERLINK l _Toc111121124 3.2 行政區(qū)劃字典表 PAGEREF _Toc111121124 h 86 HYPERLINK l _Toc111121125 3.3 人員證件類型字典表 PAGEREF _Toc111121125 h 86 HYPERLINK l _Toc111121126 3.4 幣種

8、字典表 PAGEREF _Toc111121126 h 87 HYPERLINK l _Toc111121127 3.5 企業(yè)資質(zhì)資格類型字典表 PAGEREF _Toc111121127 h 87 HYPERLINK l _Toc111121128 3.6 企業(yè)資質(zhì)資格專業(yè)類別字典表 PAGEREF _Toc111121128 h 88 HYPERLINK l _Toc111121129 3.7 企業(yè)資質(zhì)等級字典表 PAGEREF _Toc111121129 h 97 HYPERLINK l _Toc111121130 3.8 企業(yè)資質(zhì)取得方式字典表 PAGEREF _Toc11112113

9、0 h 98 HYPERLINK l _Toc111121131 3.9 企業(yè)資質(zhì)狀態(tài)字典 PAGEREF _Toc111121131 h 99 HYPERLINK l _Toc111121132 3.10 項目分類字典表 PAGEREF _Toc111121132 h 99 HYPERLINK l _Toc111121133 3.11 項目狀態(tài)字典表 PAGEREF _Toc111121133 h 99 HYPERLINK l _Toc111121134 3.12 立項級別字典表 PAGEREF _Toc111121134 h 100 HYPERLINK l _Toc111121135 3.

10、13 建設規(guī)模字典表 PAGEREF _Toc111121135 h 100 HYPERLINK l _Toc111121136 3.14 建設性質(zhì)分類字典表 PAGEREF _Toc111121136 h 100 HYPERLINK l _Toc111121137 3.15 工程用途字典表 PAGEREF _Toc111121137 h 101 HYPERLINK l _Toc111121138 3.16 國籍及地區(qū)字典表 PAGEREF _Toc111121138 h 101 HYPERLINK l _Toc111121139 3.17 參建單位類型字典表 PAGEREF _Toc1111

11、21139 h 101 HYPERLINK l _Toc111121140 3.18 工人工種字典表 PAGEREF _Toc111121140 h 102 HYPERLINK l _Toc111121141 3.19 銀行代碼字典表 PAGEREF _Toc111121141 h 104 HYPERLINK l _Toc111121142 3.20 是否字典表 PAGEREF _Toc111121142 h 112 HYPERLINK l _Toc111121143 3.21 合同期限類型字典表 PAGEREF _Toc111121143 h 112 HYPERLINK l _Toc1111

12、21144 3.22 工人考勤方向字典表 PAGEREF _Toc111121144 h 112 HYPERLINK l _Toc111121145 3.23 工人進退場類型字典表 PAGEREF _Toc111121145 h 112 HYPERLINK l _Toc111121146 3.24 計量單位類型字典表 PAGEREF _Toc111121146 h 113 HYPERLINK l _Toc111121147 3.25 工人通行方式字典表 PAGEREF _Toc111121147 h 113 HYPERLINK l _Toc111121148 3.26 培訓類型字典表 PAGE

13、REF _Toc111121148 h 113 HYPERLINK l _Toc111121149 3.27 性別字典表 PAGEREF _Toc111121149 h 114 HYPERLINK l _Toc111121150 3.28 政治面貌字典表 PAGEREF _Toc111121150 h 114 HYPERLINK l _Toc111121151 3.29 文化程度字典表 PAGEREF _Toc111121151 h 114 HYPERLINK l _Toc111121152 3.30 婚姻狀況字典表 PAGEREF _Toc111121152 h 115 HYPERLINK

14、l _Toc111121153 3.31 人員證書種類字典表 PAGEREF _Toc111121153 h 115 HYPERLINK l _Toc111121154 3.32 人員證書類型：安管證書專業(yè)字典表 PAGEREF _Toc111121154 h 115 HYPERLINK l _Toc111121155 3.33 人員證書類型：崗位證書專業(yè)字典表 PAGEREF _Toc111121155 h 115 HYPERLINK l _Toc111121156 3.34 人員證書類型：執(zhí)業(yè)注冊類別字典表 PAGEREF _Toc111121156 h 116 HYPERLINK l _

15、Toc111121157 3.35 人員證書類型：執(zhí)業(yè)注冊證書專業(yè)字典表 PAGEREF _Toc111121157 h 117 HYPERLINK l _Toc111121158 3.36 人員證書類型：職業(yè)技能人員類別 PAGEREF _Toc111121158 h 118 HYPERLINK l _Toc111121159 3.37 人員資質(zhì)等級：職稱等級 PAGEREF _Toc111121159 h 124 HYPERLINK l _Toc111121160 3.38 人員資質(zhì)等級：職業(yè)技能等級 PAGEREF _Toc111121160 h 124 HYPERLINK l _Toc

16、111121161 3.39 資質(zhì)證書狀態(tài)字典表 PAGEREF _Toc111121161 h 125 HYPERLINK l _Toc111121162 3.40 企業(yè)不良行為字典表 PAGEREF _Toc111121162 h 125 HYPERLINK l _Toc111121163 3.41 認定部門級別字典表 PAGEREF _Toc111121163 h 140 HYPERLINK l _Toc111121164 3.42 市場主體類別字典表 PAGEREF _Toc111121164 h 140 HYPERLINK l _Toc111121165 3.43 人員不良行為字典表

17、 PAGEREF _Toc111121165 h 141 HYPERLINK l _Toc111121166 3.44 附件類型字典表 PAGEREF _Toc111121166 h 146 HYPERLINK l _Toc111121167 3.45 銀行卡業(yè)務類型字典表 PAGEREF _Toc111121167 h 146 HYPERLINK l _Toc111121168 3.46 異步處理結果狀態(tài)字典表 PAGEREF _Toc111121168 h 146 HYPERLINK l _Toc111121169 3.47 工人類型字典表 PAGEREF _Toc111121169 h

18、147 HYPERLINK l _Toc111121170 3.48 管理崗位字典表 PAGEREF _Toc111121170 h 147 HYPERLINK l _Toc111121171 3.49 民族信息 PAGEREF _Toc111121171 h 149 編 制 說 明本數(shù)據(jù)接口標準根據(jù)住房和城鄉(xiāng)建設部主編的全國建筑工人管理服務信息平臺數(shù)據(jù)對接方案（V1.2.1版本）進行編制，本接口標準將根據(jù)全國建筑工人管理服務信息平臺數(shù)據(jù)對接方案的更新情況和我省實名制管理需要，適時進行修改。本數(shù)據(jù)接口標準與全國建筑工人管理服務信息平臺數(shù)據(jù)對接方案（V1.2.1版本）相比，根據(jù)“廣東省建筑工人管

19、理服務信息平臺”的管理需要，做了如下調(diào)整：一、上傳、修改項目信息接口的輸入?yún)?shù)增加了“軟/硬件供應商名稱”；二、上傳、修改項目信息接口的輸入?yún)?shù)增加了“場所ID”；三、上傳、修改項目信息接口的輸入?yún)?shù)增加了“項目所屬部門”；四、增加“新開工項目密鑰辦理信息”接口標準（本接口僅為市級實名制管理系統(tǒng)向“廣東省建筑工人管理服務信息平臺”同步數(shù)據(jù)使用）。除以上四點外，接口調(diào)用方式、簽名算法、字段命名、接口方法命名等均與全國建筑工人管理服務信息平臺數(shù)據(jù)對接方案（V1.2.1版本）保持一致。 1 概述 1.1 簡介 本數(shù)據(jù)接口標準為廣東省“一地接入、全省通用”的統(tǒng)一標準，地市用工實名制管理系統(tǒng)應根據(jù)本數(shù)據(jù)

20、接口標準，規(guī)范本地市的用工實名制管理系統(tǒng)數(shù)據(jù)與項目實名制數(shù)據(jù)的對接接口。同時，地市用工實名制管理系統(tǒng)與廣東省建筑工人管理服務信息平臺的數(shù)據(jù)交互也將同步更新。1.2 基本術語 接口提供方(API Provider)：接口的定義和實現(xiàn)者，為接口調(diào)用方提供接口合法訪問的授權。 接口調(diào)用方(API Client)：接口的調(diào)用者，需要從接口提供方獲得所需接口合法訪問的授權。 接口端點(API Endpoint)：接口的 Http 資源入口，由一個 Http URL 所表示，代表了一個或由參數(shù)確定的多個接口的集合。 1.3 接口調(diào)用方式 POST 格式為：POST 參數(shù)列表。參數(shù)列表格式為：參數(shù)名 1參數(shù)

21、值 1&參數(shù)名 2參數(shù)值 2。 請求標準參數(shù) 參數(shù)名稱參數(shù)說明method由接口提供方指定的接口標識符。 version由接口提供方指定的接口版本。注：Endpoint+ method+version 決定了接口的語義。 appid由接口提供方分配給接口調(diào)用方的身份標識符。 format接口返回結果類型:json timestamp調(diào)用方時間戳，格式為“4 位年+2 位月+2 位日+2 位小時(24 小時制)+2 位分+2 位秒”，用于接口提供方判斷調(diào)用方的時間，通常約定調(diào)用請求的時間戳與接口提供方收到請求的時間差在約定的范圍內(nèi)。 nonce隨機數(shù)，由調(diào)用方生成，在約定的調(diào)用時差范圍內(nèi)不可重復

22、。 sign簽名，按照簽名生成算法計算得來。 data具體的接口方法中的參數(shù)實體信息（對象需要轉(zhuǎn)換成 JSON String） 敏感信息（銀行卡號，證件號碼等）需要加密傳輸，請使用 AES 加密,算法說明: 算法密鑰=接入密鑰 KEY, 編碼=UTF8，加密模式(CipherMode)=CBC，填充模式(PaddingMode)=PKCS7, 數(shù)據(jù)塊大小(BlockSize)=128， 算法的初始化向量(IV)= 接入密鑰 KEY 的前 16 位字符，加密后的字節(jié)數(shù)組轉(zhuǎn)為 Base64 字符串，需要加密的字段會在字段備注中添加AES標記。算法：密文=Base64(AES(info, KEY)。

23、 例如: RequestBody: method=employee.create&format=json&version=1.0&appid=appcode123&tim estamp=20160614133300&nonce=321431&sign=23697537dc822216fdded329361f4311ea9f&data=phone: 12345678,87654321,name: zhangsan,age: 100,address: country: china,province: chengdu,married: false 1.4 接口響應 統(tǒng)一返回參數(shù)結構 參數(shù)名稱 參數(shù)說

24、明 code 處理結果編碼（參考下面的“標準錯誤代碼定義”） message 處理結果消息 data 接口處理完畢返回的數(shù)據(jù)（請參見具體接口的返回信息）。 返回的 Json 格式: code:0,message:,data: phone:12345678,87654321,name: zhangsan 標準 Code 代碼定義 0: 正確 -1: 請求參數(shù)錯誤 -2: 簽名校驗錯誤 -3: 無 API 訪問權限 -4: IP 校驗錯誤 -5: 訪問超過限制 注：標準錯誤碼小于 0，大于 0 的錯誤碼由各接口根據(jù)接口語義自行定義 接口參數(shù)簽名方法（1）第一步：拼接參數(shù)字符串 將除 sign 以外

25、的請求參數(shù)（包括標準參數(shù)，除非有特別說明）按照參數(shù)名稱的字典升序排列，然后按此順序，將“參數(shù)名參數(shù)值”用“&”符號連接。示例： appid=appcode123&data=phone:12345678,87654321,name: zhangsan,age:30,address:country:china,province:chengdu,married:f alse&format=json&method=employee.create&nonce=11223344×tamp=20160614133300&version=2.0 注意事項： data 參數(shù)必須轉(zhuǎn)換為 JSON 格式的

26、字符串。 僅對接口定義中聲明且請求參數(shù)列表中包含的參數(shù)（包括空值）進行簽名。 參數(shù)值不作去除空格。（2）第二步：在拼接參數(shù)字符串后再拼接&appsecret，如&appsecret=df23hlir85353；appsecret 即密鑰，由廣東省建筑工人管理服務信息平臺技術支持人員提供。 示例： appid=appcode123&data=phone:12345678,87654321,name: zhangsan,age:100,address:country:china,province:chengdu,married:false&format=json&method=employee.c

27、reate&nonce=11223344×tamp=20160614133300&version=2.0&appsecret=df23hlir85353gfgd86775jjdh6322 （3）第三步：將上一步的獲得的字符串全部轉(zhuǎn)換為小寫。再進行 SHA256 加密（SHA256 64 位），生成的字符串就是驗簽數(shù)據(jù) sign。注意：SHA256 加密哈希值請轉(zhuǎn)換為 16 進制表示。 OpenAPI 對驗簽數(shù)據(jù) sign 進行校驗時不區(qū)分大小寫。 訪問頻率限制 OpenAPI 對訪問過于頻繁等情況做了屏蔽處理，針對同一調(diào)用方(API Client) 訪問同一方法這一級別可以做如下限制

28、: 訪問時間間隔不能少于 1 秒，且不允許并發(fā)（即上一次訪問還沒有返回結果就開始下一次訪問）；具體訪問限制參數(shù)可配置，會根據(jù)上線后實際業(yè)務數(shù)據(jù)量和訪問頻率做優(yōu)化調(diào)整。 1.5 接口類型 1.5.1 異步處理接口 異步處理接口是指調(diào)用之后不會立即返回處理結果，而是返回響應體字段 requestSerialCode供后續(xù)查詢使用?？赏ㄟ^異步接口調(diào)用結果查詢進行結果查詢，其返回內(nèi)容可參考每一接口的異步處理結果響應體字段部分， 若異步處理結果響應體字段部分沒有任何內(nèi)容，則表明該異步處理不返回任何額外信息，僅需關注異步處理狀態(tài)即可；上傳/修改接口都是異步處理接口。 1.5.2 同步處理接口 同步處理接口

29、是指調(diào)用之后立即返回處理結果，查詢接口都是同步處理口；返回的內(nèi)容在每一查詢接口的響應體字段中進行描述。 2 接口詳細信息 圖片及附件支持 Base64上傳2.1 企業(yè) 2.1.1 上傳企業(yè)基本信息 接口信息 Endpoint http:/host/webapi/v2.0Method Corp.Upload Version 2.0 返回方式 響應體(JSON) 接口說明 上傳企業(yè)基本信息 輸入?yún)?shù) 名稱類型是否必需備注 corpCodeString是企業(yè)統(tǒng)一社會信用代碼或者組織機構代碼 corpNameString是企業(yè)名稱 corpTypeString否單位性質(zhì)。參考企業(yè)登記注冊類型字典表 l

30、icenseNumString否工商營業(yè)執(zhí)照注冊號 areaCodeString是企業(yè)注冊地區(qū)編碼。參考行政區(qū)劃字典表 addressString否企業(yè)營業(yè)地址 zipCodeString否郵政編碼 legalManString否法定代表人姓名 legalManDutyString否法定代表人職務 legaManProTitleString否法定代表人職稱 legalManIDCardT ypeString否法定代表人證件類型。參考人員證件類型字典表 legalManIDCardNumberString否法定代表人證件號碼。AES regCapitaldecimal否注冊資本（萬元） fact

31、RegCapitaldecimal否實收資本(萬元) capitalCurrencyTy peString否注冊資本幣種。參考幣種字典表 registerDateString是注冊日期，格式 yyyy-MM-dd establishDateString否成立日期，格式 yyyy-MM-dd officePhoneString否辦公電話 faxNumberString否傳真號碼 linkmanString否聯(lián)系人姓名 linkTelString否聯(lián)系人辦公電話 emailString否企業(yè)聯(lián)系郵箱 websiteString否企業(yè)網(wǎng)址 remarkString否企業(yè)備注 響應體字段 名稱類型是否

32、必需備注requestSerialCodeString是請求序列編碼 異步處理結果響應體字段 名稱名稱名稱名稱 請求體格式示例 requestSerialCode:20180914009893, registerDate: 2017-09-04, corpCode: 91350100315*147, corpName: 0810-勞務分包 01, corpType: 100, licenseNum: , areaCode: 350423, address: *縣*花園*幢*室, zipCode: , legalMan: 張三, legalManDuty: 董事長, legaManProTitl

33、e: 教授, legalManIDCardType: 01, legalManIDCardNumber: MiJ2Z/CxijInCyQf8MRMuo6ComKGao4eW/GMbSnseds=, regCapital: 1.9, factRegCapital: 1.9, capitalCurrencyType: , establishDate: 2017-08-01, officePhone: 028-*, faxNumber: , linkMan: 張三, linkPhone: 1589098*, email: , webSite: , remark: 備注 響應體格式示例 data: r

34、equestSerialCode: null , code: 0, message: 調(diào)用成功 2.1.2 查詢企業(yè)基本信息 接口信息 Endpoint http:/host/webapi/v2.0Method Corp.Query Version 2.0 返回方式 響應體(JSON) 接口說明 查詢企業(yè)信息 輸入?yún)?shù) 名稱類型是否必需備注pageIndexint是指定頁號，以 0 為起始數(shù)字，表示第 1 頁 pageSizeint是每頁記錄數(shù)，最多不能超過100 corpNamestring否企業(yè)名稱，與統(tǒng)一社會代碼必傳一個 corpCodestring否統(tǒng)一社會代碼,如果無統(tǒng)一社會信用代碼

35、，則用組織機構代碼，與企業(yè)名稱必傳一個 響應體字段 名稱類型是否必需備注totalCountint是記錄總數(shù) pageIndexint是指定頁號，以 0 為起始數(shù)字，表示第 1 頁 pageSizeint是每頁記錄數(shù)，最多不能超過100 rowsarray是記錄集合。JSON 數(shù)組rows 數(shù)組內(nèi)對象字段 名稱 類型 是否必需 備注 corpCode string是 企業(yè)統(tǒng)一社會信用代碼或者組織機構代碼 corpName string是 企業(yè)名稱 corpType string否 單位性質(zhì)。參考企業(yè)登記注冊類型字典表 licenseNum string否 工商營業(yè)執(zhí)照注冊號 areaCode

36、string是 企業(yè)注冊地區(qū)編碼。參考行政區(qū)劃字典表 address string否 企業(yè)營業(yè)地址 zipCode string否 郵政編碼 legalMan string否 法定代表人姓名 legalManDuty string 否 法定代表人職務 legaManProTitle string否 法定代表人職稱 legalManIDCa rdType string否 法定代表人證件類型。參考人員證件類型字典表 legalManIDCa rdNumber string否 法定代表人證件號碼。AES regCapital decimal 否 注冊資本（萬元） factRegCapital dec

37、imal 否 實收資本(萬元) capitalCurrenc yType string否 注冊資本幣種。參考幣種字典表 registerDate string是 注冊日期，格式 yyyy-MM-dd establishDate string否 成立日期，格式 yyyy-MM-dd officePhone string否 辦公電話 faxNumber string否 傳真號碼 linkman string否 聯(lián)系人姓名 linkTel string否 聯(lián)系人辦公電話 email string否 企業(yè)聯(lián)系郵箱 website string否 企業(yè)網(wǎng)址 remark string否 企業(yè)備注 請求體

38、格式示例 響應體格式示例 2.2 項目 2.2.1 項目基本信息 上傳項目信息 接口信息 Endpoint http:/host/webapi/v2.0Method Project.Add Version 2.0 返回方式 響應體(JSON) 接口說明 上傳項目信息(地市自建平臺) 輸入?yún)?shù) 名稱 類型 是否必需 備注 contractorCorpCode string 是 總承包單位統(tǒng)一社會信用代碼，如果無統(tǒng)一社會信用代碼，則填寫組織機構代碼 contractorCorpName string 是 總承包單位名稱 name string 是 項目名稱 description string 否

39、 項目簡介 category string 是 項目分類。參見項目分類字典表 buildCorpName string 否 建設單位名稱 buildCorpCode string 否 建設單位統(tǒng)一社會信用代碼，如果無統(tǒng)一社會信用代碼，則填寫組織機構代碼 builderLicenses array 是 施工許可證。JSON 數(shù)組 buildPlanNum string 否 建設用地規(guī)劃許可證編號。AES prjPlanNum string 否 建設工程規(guī)劃許可證編號。AES areaCode string 是 項目所在地。參考行政區(qū)劃字典表 invest decimal 否 總投資，單位：（萬元

40、） buildingArea decimal 否 總面積，單位：平方米 buildingLength decimal 否 總長度，單位：米 startDate string 否 開工日期，精確到天，格式： yyyy-MM-dd completeDate string 否 竣工日期，精確到天，格式： yyyy-MM-dd linkMan string 否 聯(lián)系人姓名 linkPhone string 否 聯(lián)系人辦公電話 prjStatus string 是 項目狀態(tài)。參考項目狀態(tài)字典表 lat decimal 否 WGS84 緯度 lng decimal 否 WGS84 經(jīng)度 address s

41、tring 否 項目地點 approvalNum string 否 立項文號 approvalLevelNum string 否 立項級別。參考立項級別字典表 prjSize string 否 建設規(guī)模。參考建設規(guī)模字典表 propertyNum string 否 建設性質(zhì)。參考建設性質(zhì)分類字典表 functionNum string 否 工程用途。參考工程用途字典表 nationNum string 否 國籍或地區(qū)。參考國籍及地區(qū)字典表 supplierNamestring是軟/硬件供應商名稱placeIdstring是場所IDprojectDepartmentstring否項目所屬部門co

42、ntractAmount decimal是合同金額。單位：（萬元）builderLicenses 數(shù)組內(nèi)對象字段 名稱 類型 是否必需 備注 prjName string 是 工程名稱 builderLicenseNum string 是 施工許可證編號。AES 響應體字段 名稱 類型 是否必需 備注 requestSerialCode string 是 請求序列編碼 異步處理結果響應體字段 名稱 類型 是否必需 備注 projectCode string 是 項目編碼 請求體格式示例 響應體格式示例 修改項目信息 接口信息 Endpoint http:/host/webapi/v2.0Met

43、hod Project.Update Version 2.0 返回方式 響應體(JSON) 接口說明 修改項目信息 輸入?yún)?shù) 名稱類型是否必需備注projectCode string 是 項目編碼 name string 是 項目名稱 description string 否 項目簡介 category string 是 項目分類。參見項目分類字典表 buildCorpName string 否 建設單位名稱 buildCorpCode string 否 建設單位統(tǒng)一社會信用代碼，如果無統(tǒng)一社會信用代碼，則填寫組織機構代碼 builderLicenses array 是 施工許可證。JSON

44、數(shù)組 buildPlanNum string 否 建設用地規(guī)劃許可證編號。AES prjPlanNum string 否 建設工程規(guī)劃許可證編號。AES areaCode string 是 項目所在地。參考行政區(qū)劃字典表 invest decimal 否 總投資，單位：（萬元） buildingArea decimal 否 總面積，單位：平方米 buildingLength decimal 否 總長度，單位：米 startDate string 否 開工日期，精確到天，格式 yyyy-MM-dd completeDate string 否 竣工日期，精確到天，格式 yyyy-MM-dd lin

45、kman string 否 聯(lián)系人姓名 linkPhone string 否 聯(lián)系人辦公電話 prjStatus string 是 項目狀態(tài)。參考項目狀態(tài)字典表 lat decimal 否 WGS84 緯度 lng decimal 否 WGS84 經(jīng)度 address string 否 項目地點 approvalNumstring 否 立項文號approvalLevelNumstring 否 立項級別。參考立項級別字典表prjSizestring 否 建設規(guī)模。參考建設規(guī)模字典表propertyNumstring 否 建設性質(zhì)。參考建設性質(zhì)分類字典表functionNumstring 否 工程

46、用途。參考工程用途字典表nationNumInt否國籍或地區(qū)。參考國籍及地區(qū)字典表supplierNamestring是軟/硬件供應商名稱placeIdstring是場所IDprojectDepartmentstring否項目所屬部門contractAmount decimal是合同金額。單位：（萬元）builder Licenses數(shù)組內(nèi)對象字段名稱類型是否必需備注prjNamestring是工程名稱builderLicenseNumstring是施工許可證編號：AES 響應體字段名稱類型是否必需備注requestSerialCodestring是請求序列編碼異步處理結果響應體字段請求體格式

47、示例響應體格式示例 按區(qū)域查詢項目 接口信息 Endpoint http:/host/webapi/v2.0Method Project.GovQueryVersion 2.0 返回方式 響應體(JSON) 接口說明 按區(qū)域查詢項目請求體字段 名稱 類型 是否必需 備注 pageIndex int 是 指定頁號，以 0 為起始數(shù)字，表示第 1 頁pageSize int 是 每頁記錄數(shù)，最多不能超過 100 projectCode string 否項目編碼，精確匹配projectNamestring 否 項目名稱，模糊匹配areaCodestring 是項目區(qū)域編碼，自建平臺只能查詢自己轄區(qū)的

48、區(qū)域編碼響應體字段 totalCount int 記錄總數(shù)pageIndexint 指定頁號，以 0 為起始數(shù)字，表示第 1 頁pageSizeint 每頁記錄數(shù)，最多不能超過 100rows array 記錄集合。JSON 數(shù)組rows 數(shù)組內(nèi)對象字段 名稱 類型 是否必需 備注 projectCode string 是 項目編碼 contractorCorpCodestring 是 總承包單位統(tǒng)一社會信用代碼，如果無統(tǒng)一社會信用代碼，則填寫組織機構代碼contractorCorpName string 是 總承包單位名稱 name string 是 項目名稱 description str

49、ing 否 項目簡介 category string 是 項目分類。參見項目分類字典表 buildCorpName string 否 建設單位名稱 buildCorpCode string 否 建設單位統(tǒng)一社會信用代碼，如果無統(tǒng)一社會信用代碼，則填寫組織機構代碼 builderLicenses array 是 施工許可證。JSON 數(shù)組 buildPlanNum string 否 建設用地規(guī)劃許可證編號。AES prjPlanNum string 否 建設工程規(guī)劃許可證編號。AES areaCode string 是 項目所在地。參考行政區(qū)劃字典表 Invest decimal 否 總投資，單

50、位：（萬元） buildingArea decimal 否 總面積，單位：平方米 buildingLength decimal 否 總長度，單位：米 startDate string 否 開工日期，精確到天，格式 yyyy-MM-dd completeDate string 否 竣工日期，精確到天，格式 yyyy-MM-dd linkman string 否 聯(lián)系人姓名 linkPhone string 否 聯(lián)系人辦公電話 prjStatus string 是 項目狀態(tài)。參考項目狀態(tài)字典表 lat decimal 否 WGS84 緯度 lng decimal 否 WGS84 經(jīng)度 Addres

51、s string 否 項目地點 approvalNum string 否 立項文號 approvalLevelNum string 否 立項級別。參考立項級別字典表 prjSize string 否 建設規(guī)模。參考建設規(guī)模字典表 propertyNum string 否 建設性質(zhì)。參考建設性質(zhì)分類字典表 functionNum string 否 工程用途。參考工程用途字典表 nationNumint否國籍或地區(qū)。參考國籍及地區(qū)字典表responsiblePersonNamestring否項目實名制負責人名稱responsiblePersonPhonestring否項目實名制負責人電話respo

52、nsiblePersonEmailstring否項目實名制負責人郵箱mohurdProjectNumstring否項目在四庫一平臺的項目編碼builderLicenses 數(shù)組內(nèi)對象字段名稱類型是否必需備注prjNamestring是工程名稱builderLicenseNumstring是施工許可證編號。AES請求體格式示例 pageIndex: 0, pageSize: 10, projectCode: , projectName: , areaCode: 510101響應體格式示例 data: totalCount: 1, pageIndex: 0, pageSize: 1, rows:

53、projectCode: , contractorCorpCode: , contractorCorpName: , responsiblePersonName: null, responsiblePersonPhone: null, responsiblePersonEmail: null, mohurdProjectNum: null, name: , description: null, category: , buildCorpName: null, buildCorpCode: null, buildPlanNum: null, prjPlanNum: null, areaCode:

54、 , invest: null, buildingArea: null, buildingLength: null, startDate: , completeDate: , linkMan: null, linkPhone: null, prjStatus: , lng: null, lat: null, address: null, approvalNum: null, approvalLevelNum: null, prjSize: null, propertyNum: null, functionNum: null, nationNum: null, responsiblePerson

55、Name: , responsiblePersonPhone: , responsiblePersonEmail: , mohurdProjectNum: , builderLicenses: prjName: , builderLicenseNum: , code: 0, message: 調(diào)用成功 2.2.2 項目參建單位 上傳參建單位 所有管理人員納入?yún)⒔▎挝幌碌摹卷椖抗芾聿俊恐羞M行管理，系統(tǒng)已為現(xiàn)有的參建單位初始化了【項目管理部】。 對新上傳參建單位時，系統(tǒng)為該參建單位創(chuàng)建【項目管理部】，并返回項目管理部的編號。所有管理人員相關信息上傳時都需要【項目管理部】的編號。 注：【項目管理部】

56、可以理解為特殊類型的班組。 接口信息 Endpoint http:/host/webapi/v2.0Method ProjectSubContractor.Add Version 2.0 返回方式 響應體(JSON) 接口說明 上傳項目參建單位 輸入?yún)?shù) 名稱 類型 是否必需 備注 projectCode string 是 項目編碼 corpCode string 是 統(tǒng)一社會信用代碼，如果無統(tǒng)一社會信用代碼，則填寫組織機構代碼 corpType string 是 參建類型。參考參建單位類型字典表 entryTime string 否 進場時間。格式 yyyy-MM-dd HH:mm:ss e

57、xitTime string 否 退場時間。格式 yyyy-MM-dd HH:mm:ss bankInfos array 否 發(fā)放工資的銀行。JSON 數(shù)組 pmName string 否 項目經(jīng)理名稱 pmIDCardType string 否 項目經(jīng)理證件類型。參考人員證件類型字典表 pmIDCardNumber string 否 項目經(jīng)理證件號碼。AES pmPhone string 否 項目經(jīng)理電話 bankInfos 數(shù)組對象相關字段 bankCode string 是 銀行代碼。參考銀行代碼字典表 bankName string 是 銀行支行名稱 bankNumber string

58、 是 銀行卡號。AES bankLinkNumber string 是 銀行聯(lián)號 響應體字段 名稱 類型 是否必需 備注 requestSerialCode string 是 請求序列編碼 異步處理結果響應體字段 data: requestSerialCode: subcontractor-add-20200927170402-5-0002, result: pmCode:121764692,memo:項目管理部代碼，上傳管理人員及管理人員考勤時使用!, status: 20 , code: 0, message: 調(diào)用成功 請求體格式示例 projectCode: 4419002018*6,

59、 corpCode: 12510823FHFA*57, corpType: 006, entryTime: 2018-08-21 12:13:14, exitTime: 2018-08-31 05:16:17, bankInfos: bankCode: 103, bankName: 綠色*, bankNumber: QUcYKc9j9di5Whmrlgq30zRk32nw5u434DEtcx5gOUw=, bankLinkNumber: 4532* , pmName: 張三, pmIDCardType: 01, pmIDCardNumber: UQIJxmqlHruG7haaaIs99Avx/

60、iaLczTEODMnsAXeUQk=, pmPhone: 1398175* 響應體格式示例 requestSerialCode: projectsubcontractor-add-2018082917-0001 2.2.2 修改項目參建單位信息 接口信息 Endpoint http:/host/webapi/v2.0Method ProjectSubContractor.UpdateVersion 2.0 返回方式 響應體(JSON) 接口說明 修改項目參建單位信息 輸入?yún)?shù) 名稱 類型 是否必需 備注 projectCode string 是 項目編碼 corpCode string 是