廣東省建筑工人管理服務(wù)信息平臺(tái)數(shù)據(jù)接口標(biāo)準(zhǔn)（V1.3版）

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

2、 _Toc111121098 h 1 HYPERLINK l _Toc111121099 1.4 接口響應(yīng) PAGEREF _Toc111121099 h 2 HYPERLINK l _Toc111121100 1.5 接口類(lèi)型 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、口詳細(xì)信息 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 查詢(xún)企業(yè)基本信息 PAGEREF _Toc111121106 h 8 HYPERLINK l _Toc111121107 2.2 項(xiàng)目 PAGEREF _Toc111121107 h 10 HYPERLINK l _To

4、c111121108 2.2.1 項(xiàng)目基本信息 PAGEREF _Toc111121108 h 10 HYPERLINK l _Toc111121109 2.2.2 項(xiàng)目參建單位 PAGEREF _Toc111121109 h 20 HYPERLINK l _Toc111121110 2.2.3 項(xiàng)目班組 PAGEREF _Toc111121110 h 28 HYPERLINK l _Toc111121111 2.2.4 項(xiàng)目人員 PAGEREF _Toc111121111 h 39 HYPERLINK l _Toc111121112 2.2.5 項(xiàng)目人員進(jìn)退場(chǎng) PAGEREF _Toc111

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

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

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

8、字典表 PAGEREF _Toc111121126 h 87 HYPERLINK l _Toc111121127 3.5 企業(yè)資質(zhì)資格類(lèi)型字典表 PAGEREF _Toc111121127 h 87 HYPERLINK l _Toc111121128 3.6 企業(yè)資質(zhì)資格專(zhuān)業(yè)類(lèi)別字典表 PAGEREF _Toc111121128 h 88 HYPERLINK l _Toc111121129 3.7 企業(yè)資質(zhì)等級(jí)字典表 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 項(xiàng)目分類(lèi)字典表 PAGEREF _Toc111121132 h 99 HYPERLINK l _Toc111121133 3.11 項(xiàng)目狀態(tài)字典表 PAGEREF _Toc111121133 h 99 HYPERLINK l _Toc111121134 3.12 立項(xiàng)級(jí)別字典表 PAGEREF _Toc111121134 h 100 HYPERLINK l _Toc111121135 3.

10、13 建設(shè)規(guī)模字典表 PAGEREF _Toc111121135 h 100 HYPERLINK l _Toc111121136 3.14 建設(shè)性質(zhì)分類(lèi)字典表 PAGEREF _Toc111121136 h 100 HYPERLINK l _Toc111121137 3.15 工程用途字典表 PAGEREF _Toc111121137 h 101 HYPERLINK l _Toc111121138 3.16 國(guó)籍及地區(qū)字典表 PAGEREF _Toc111121138 h 101 HYPERLINK l _Toc111121139 3.17 參建單位類(lèi)型字典表 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 合同期限類(lèi)型字典表 PAGEREF _Toc111121143 h 112 HYPERLINK l _Toc1111

12、21144 3.22 工人考勤方向字典表 PAGEREF _Toc111121144 h 112 HYPERLINK l _Toc111121145 3.23 工人進(jìn)退場(chǎng)類(lèi)型字典表 PAGEREF _Toc111121145 h 112 HYPERLINK l _Toc111121146 3.24 計(jì)量單位類(lèi)型字典表 PAGEREF _Toc111121146 h 113 HYPERLINK l _Toc111121147 3.25 工人通行方式字典表 PAGEREF _Toc111121147 h 113 HYPERLINK l _Toc111121148 3.26 培訓(xùn)類(lèi)型字典表 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 人員證書(shū)種類(lèi)字典表 PAGEREF _Toc111121153 h 115 HYPERLINK l _Toc111121154 3.32 人員證書(shū)類(lèi)型：安管證書(shū)專(zhuān)業(yè)字典表 PAGEREF _Toc111121154 h 115 HYPERLINK l _Toc111121155 3.33 人員證書(shū)類(lèi)型：崗位證書(shū)專(zhuān)業(yè)字典表 PAGEREF _Toc111121155 h 115 HYPERLINK l _Toc111121156 3.34 人員證書(shū)類(lèi)型：執(zhí)業(yè)注冊(cè)類(lèi)別字典表 PAGEREF _Toc111121156 h 116 HYPERLINK l _

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

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

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

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

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

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

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

22、。 sign簽名，按照簽名生成算法計(jì)算得來(lái)。 data具體的接口方法中的參數(shù)實(shí)體信息（對(duì)象需要轉(zhuǎn)換成 JSON String） 敏感信息（銀行卡號(hào)，證件號(hào)碼等）需要加密傳輸，請(qǐng)使用 AES 加密,算法說(shuō)明: 算法密鑰=接入密鑰 KEY, 編碼=UTF8，加密模式(CipherMode)=CBC，填充模式(PaddingMode)=PKCS7, 數(shù)據(jù)塊大小(BlockSize)=128， 算法的初始化向量(IV)= 接入密鑰 KEY 的前 16 位字符，加密后的字節(jié)數(shù)組轉(zhuǎn)為 Base64 字符串，需要加密的字段會(huì)在字段備注中添加AES標(biāo)記。算法：密文=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 接口響應(yīng) 統(tǒng)一返回參數(shù)結(jié)構(gòu) 參數(shù)名稱(chēng) 參數(shù)說(shuō)

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

25、的請(qǐng)求參數(shù)（包括標(biāo)準(zhǔn)參數(shù)，除非有特別說(shuō)明）按照參數(shù)名稱(chēng)的字典升序排列，然后按此順序，將“參數(shù)名參數(shù)值”用“&”符號(hào)連接。示例： 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 注意事項(xiàng)： data 參數(shù)必須轉(zhuǎn)換為 JSON 格式的

26、字符串。 僅對(duì)接口定義中聲明且請(qǐng)求參數(shù)列表中包含的參數(shù)（包括空值）進(jìn)行簽名。 參數(shù)值不作去除空格。（2）第二步：在拼接參數(shù)字符串后再拼接&appsecret，如&appsecret=df23hlir85353；appsecret 即密鑰，由廣東省建筑工人管理服務(wù)信息平臺(tái)技術(shù)支持人員提供。 示例： 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)換為小寫(xiě)。再進(jìn)行 SHA256 加密（SHA256 64 位），生成的字符串就是驗(yàn)簽數(shù)據(jù) sign。注意：SHA256 加密哈希值請(qǐng)轉(zhuǎn)換為 16 進(jìn)制表示。 OpenAPI 對(duì)驗(yàn)簽數(shù)據(jù) sign 進(jìn)行校驗(yàn)時(shí)不區(qū)分大小寫(xiě)。 訪(fǎng)問(wèn)頻率限制 OpenAPI 對(duì)訪(fǎng)問(wèn)過(guò)于頻繁等情況做了屏蔽處理，針對(duì)同一調(diào)用方(API Client) 訪(fǎng)問(wèn)同一方法這一級(jí)別可以做如下限制

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

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

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

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

32、必需備注requestSerialCodeString是請(qǐng)求序列編碼 異步處理結(jié)果響應(yīng)體字段 名稱(chēng)名稱(chēng)名稱(chēng)名稱(chēng) 請(qǐng)求體格式示例 requestSerialCode:20180914009893, registerDate: 2017-09-04, corpCode: 91350100315*147, corpName: 0810-勞務(wù)分包 01, corpType: 100, licenseNum: , areaCode: 350423, address: *縣*花園*幢*室, zipCode: , legalMan: 張三, legalManDuty: 董事長(zhǎng), 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: 備注 響應(yīng)體格式示例 data: r

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

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

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

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

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

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

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

41、tring 否 項(xiàng)目地點(diǎn) approvalNum string 否 立項(xiàng)文號(hào) approvalLevelNum string 否 立項(xiàng)級(jí)別。參考立項(xiàng)級(jí)別字典表 prjSize string 否 建設(shè)規(guī)模。參考建設(shè)規(guī)模字典表 propertyNum string 否 建設(shè)性質(zhì)。參考建設(shè)性質(zhì)分類(lèi)字典表 functionNum string 否 工程用途。參考工程用途字典表 nationNum string 否 國(guó)籍或地區(qū)。參考國(guó)籍及地區(qū)字典表 supplierNamestring是軟/硬件供應(yīng)商名稱(chēng)placeIdstring是場(chǎng)所IDprojectDepartmentstring否項(xiàng)目所屬部門(mén)co

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

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

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

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

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

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

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

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

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

51、s string 否 項(xiàng)目地點(diǎn) approvalNum string 否 立項(xiàng)文號(hào) approvalLevelNum string 否 立項(xiàng)級(jí)別。參考立項(xiàng)級(jí)別字典表 prjSize string 否 建設(shè)規(guī)模。參考建設(shè)規(guī)模字典表 propertyNum string 否 建設(shè)性質(zhì)。參考建設(shè)性質(zhì)分類(lèi)字典表 functionNum string 否 工程用途。參考工程用途字典表 nationNumint否國(guó)籍或地區(qū)。參考國(guó)籍及地區(qū)字典表responsiblePersonNamestring否項(xiàng)目實(shí)名制負(fù)責(zé)人名稱(chēng)responsiblePersonPhonestring否項(xiàng)目實(shí)名制負(fù)責(zé)人電話(huà)respo

52、nsiblePersonEmailstring否項(xiàng)目實(shí)名制負(fù)責(zé)人郵箱mohurdProjectNumstring否項(xiàng)目在四庫(kù)一平臺(tái)的項(xiàng)目編碼builderLicenses 數(shù)組內(nèi)對(duì)象字段名稱(chēng)類(lèi)型是否必需備注prjNamestring是工程名稱(chēng)builderLicenseNumstring是施工許可證編號(hào)。AES請(qǐng)求體格式示例 pageIndex: 0, pageSize: 10, projectCode: , projectName: , areaCode: 510101響應(yīng)體格式示例 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 項(xiàng)目參建單位 上傳參建單位 所有管理人員納入?yún)⒔▎挝幌碌摹卷?xiàng)目管理部】中進(jìn)行管理，系統(tǒng)已為現(xiàn)有的參建單位初始化了【項(xiàng)目管理部】。 對(duì)新上傳參建單位時(shí)，系統(tǒng)為該參建單位創(chuàng)建【項(xiàng)目管理部】，并返回項(xiàng)目管理部的編號(hào)。所有管理人員相關(guān)信息上傳時(shí)都需要【項(xiàng)目管理部】的編號(hào)。 注：【項(xiàng)目管理部】

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

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

58、 是 銀行卡號(hào)。AES bankLinkNumber string 是 銀行聯(lián)號(hào) 響應(yīng)體字段 名稱(chēng) 類(lèi)型 是否必需 備注 requestSerialCode string 是 請(qǐng)求序列編碼 異步處理結(jié)果響應(yīng)體字段 data: requestSerialCode: subcontractor-add-20200927170402-5-0002, result: pmCode:121764692,memo:項(xiàng)目管理部代碼，上傳管理人員及管理人員考勤時(shí)使用!, status: 20 , code: 0, message: 調(diào)用成功 請(qǐng)求體格式示例 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* 響應(yīng)體格式示例 requestSerialCode: projectsubcontractor-add-2018082917-0001 2.2.2 修改項(xiàng)目參建單位信息 接口信息 Endpoint http:/host/webapi/v2.0Method ProjectSubContractor.UpdateVersion 2.0 返回方式 響應(yīng)體(JSON) 接口說(shuō)明 修改項(xiàng)目參建單位信息 輸入?yún)?shù) 名稱(chēng) 類(lèi)型 是否必需 備注 projectCode string 是 項(xiàng)目編碼 corpCode string 是