不動(dòng)產(chǎn)登記統(tǒng)一監(jiān)管服務(wù)接口規(guī)范（征求意見稿）

4T/GDNBXXX—2024不動(dòng)產(chǎn)登記統(tǒng)一監(jiān)管服務(wù)接口規(guī)范本文件規(guī)定了不動(dòng)產(chǎn)登記統(tǒng)一監(jiān)管服務(wù)的接入要求、接口規(guī)范和數(shù)據(jù)質(zhì)量要求。本文件適用于不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)對接與調(diào)用統(tǒng)一監(jiān)管服務(wù)。2規(guī)范性引用文件下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本文件。GB/T37346-2019不動(dòng)產(chǎn)單元設(shè)定與代碼編制規(guī)則TD/T1066不動(dòng)產(chǎn)登記數(shù)據(jù)庫標(biāo)準(zhǔn)TD/T1079-2023不動(dòng)產(chǎn)登記信息管理基礎(chǔ)平臺(tái)接入技術(shù)規(guī)范3術(shù)語和定義下列術(shù)語和定義適用于本文件。3.1報(bào)文message報(bào)文是網(wǎng)絡(luò)中交換與傳輸?shù)臄?shù)據(jù)單元，即站點(diǎn)一次性要發(fā)送的數(shù)據(jù)塊。3.2業(yè)務(wù)報(bào)文businessmessage傳輸業(yè)務(wù)數(shù)據(jù)信息的報(bào)文，主要由業(yè)務(wù)數(shù)據(jù)和業(yè)務(wù)報(bào)文頭組成。3.3不動(dòng)產(chǎn)登記realestateregistration不動(dòng)產(chǎn)登記機(jī)構(gòu)依法將不動(dòng)產(chǎn)權(quán)利歸屬和其他法定事項(xiàng)記載于不動(dòng)產(chǎn)登記簿的行為。3.4不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)realestateregistrationplatform市縣級自然資源主管部門會(huì)同有關(guān)部門建立統(tǒng)一的不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)。3.5不動(dòng)產(chǎn)登記統(tǒng)一監(jiān)管服務(wù)unifiedsupervisionserviceforrealestateregistration校驗(yàn)不動(dòng)產(chǎn)登記數(shù)據(jù)質(zhì)量的接口服務(wù)，校驗(yàn)內(nèi)容包括必填性、規(guī)范性、邏輯性一致性和圖形拓?fù)錅?zhǔn)確性等方面，供不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)調(diào)用。3.6單業(yè)務(wù)singlebusiness單筆不動(dòng)產(chǎn)登記業(yè)務(wù)。3.75T/GDNBXXX—2024組合業(yè)務(wù)combinationbusiness兩筆或兩筆以上的單業(yè)務(wù)組合受理，形成組合業(yè)務(wù)。4縮略語下列縮略語適用于本文件。HTTP：超文本傳送協(xié)議（HypertextTransferProtocol）JSON：JS對象簡譜（JavaScriptObjectNotation）REST：描述性狀態(tài)遷移（RepresentationalStateTransfer）VPN：虛擬專用網(wǎng)絡(luò)（VirtualPrivateNetwork）5接入要求5.1接入準(zhǔn)備5.1.1準(zhǔn)備網(wǎng)絡(luò)環(huán)境統(tǒng)一監(jiān)管服務(wù)部署在省級不動(dòng)產(chǎn)登記VPN環(huán)境下，同時(shí)提供政務(wù)外網(wǎng)環(huán)境作為備用網(wǎng)絡(luò)環(huán)境，在VPN環(huán)境出現(xiàn)故障時(shí)可使用政務(wù)外網(wǎng)環(huán)境的統(tǒng)一監(jiān)管服務(wù)。當(dāng)VPN故障修復(fù)后，應(yīng)及時(shí)切換回VPN環(huán)境使用。不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)應(yīng)提前做好VPN環(huán)境和政務(wù)外網(wǎng)環(huán)境的網(wǎng)絡(luò)連通調(diào)試，保證不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)能夠正常訪問統(tǒng)一監(jiān)管服務(wù)。5.1.2登記系統(tǒng)改造不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)的正式登簿環(huán)節(jié)之前，預(yù)生成報(bào)文并調(diào)用統(tǒng)一監(jiān)管服務(wù)對報(bào)文數(shù)據(jù)進(jìn)行校驗(yàn)，校驗(yàn)反饋結(jié)果應(yīng)通過不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)界面展示。5.1.3聯(lián)調(diào)測試完成不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)改造后，開展聯(lián)調(diào)測試工作。5.1.4上線運(yùn)行不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)在辦理登記業(yè)務(wù)時(shí)，必須成功通過統(tǒng)一監(jiān)管服務(wù)校驗(yàn)后才能正式登簿。5.2接入流程不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)在登簿前，應(yīng)按照《不動(dòng)產(chǎn)登記信息管理基礎(chǔ)平臺(tái)接入技術(shù)規(guī)范》預(yù)生成業(yè)務(wù)報(bào)文，對接調(diào)用統(tǒng)一監(jiān)管服務(wù)對業(yè)務(wù)報(bào)文進(jìn)行校驗(yàn)。通過校驗(yàn)的可直接登簿；未通過校驗(yàn)的，應(yīng)立即分析統(tǒng)一監(jiān)管服務(wù)反饋的校驗(yàn)問題并進(jìn)行整改，完成整改后更新業(yè)務(wù)報(bào)文進(jìn)行二次校驗(yàn)，直至通過方可登簿。統(tǒng)一監(jiān)管服務(wù)接入流程見圖1。圖1統(tǒng)一監(jiān)管服務(wù)接入流程圖6T/GDNBXXX—20246接口規(guī)范統(tǒng)一監(jiān)管服務(wù)接口分為單業(yè)務(wù)接口和組合業(yè)務(wù)接口。6.1接口約定統(tǒng)一監(jiān)管服務(wù)接口采用HTTP協(xié)議，遵循REST設(shè)計(jì)風(fēng)格，請求方法采用Post方式，數(shù)據(jù)采用JSON格式。6.2單業(yè)務(wù)接口6.2.1接口說明單業(yè)務(wù)接口用于不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)單筆業(yè)務(wù)的校驗(yàn)。根據(jù)區(qū)縣代碼、報(bào)文ID、流程環(huán)節(jié)、檢查文件校驗(yàn)單業(yè)務(wù)的登記業(yè)務(wù)規(guī)范性及報(bào)文數(shù)據(jù)質(zhì)量，返回校驗(yàn)信息。6.2.2接口請求參數(shù)及示例根據(jù)不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)發(fā)送的單業(yè)務(wù)報(bào)文進(jìn)行校驗(yàn)，接口請求參數(shù)應(yīng)符合附錄A中A.1要求。6.2.3接口返回參數(shù)及示例完成單業(yè)務(wù)報(bào)文校驗(yàn)后反饋統(tǒng)一監(jiān)管服務(wù)校驗(yàn)信息，接口返回參數(shù)應(yīng)符合附錄B中B.1要求。6.3組合業(yè)務(wù)接口6.3.1接口說明組合業(yè)務(wù)接口用于不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)組合業(yè)務(wù)的校驗(yàn)。根據(jù)區(qū)縣代碼、報(bào)文ID、流程環(huán)節(jié)、檢查文件校驗(yàn)組合的登記業(yè)務(wù)規(guī)范性及報(bào)文數(shù)據(jù)質(zhì)量，返回校驗(yàn)信息。6.3.2調(diào)用業(yè)務(wù)場景組合業(yè)務(wù)接口主要用于組合業(yè)務(wù)的業(yè)務(wù)規(guī)范性及報(bào)文數(shù)據(jù)質(zhì)量，主要用于以下業(yè)務(wù)場景：權(quán)利的變更及轉(zhuǎn)移組合辦理業(yè)務(wù)、產(chǎn)權(quán)的變更/轉(zhuǎn)移及抵押組合辦理業(yè)務(wù)、預(yù)告預(yù)抵押業(yè)務(wù)轉(zhuǎn)現(xiàn)房抵押組合辦理業(yè)務(wù)等。6.3.3調(diào)用方式及校驗(yàn)流程統(tǒng)一監(jiān)管服務(wù)組合業(yè)務(wù)接口基于市縣一次調(diào)用，組合業(yè)務(wù)報(bào)文打包上傳校驗(yàn)的思路進(jìn)行接口調(diào)用。調(diào)用方式如下：a)不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)辦理組合業(yè)務(wù)時(shí)，在登簿環(huán)節(jié)前預(yù)生成業(yè)務(wù)報(bào)文，并自行按業(yè)務(wù)邏輯的先后順序?qū)?bào)文進(jìn)行排序；b)調(diào)用組合業(yè)務(wù)接口，將所有報(bào)文按照正確順序一次性打包上傳。統(tǒng)一監(jiān)管服務(wù)接收到報(bào)文后，按照接口內(nèi)部報(bào)文順序逐條進(jìn)行校驗(yàn)，判斷組合業(yè)務(wù)間上下手關(guān)聯(lián)關(guān)系，提高組合業(yè)務(wù)校驗(yàn)效率。具體調(diào)用方式及校驗(yàn)流程見圖2：圖2組合業(yè)務(wù)接口調(diào)用流程圖6.3.4接口請求參數(shù)及示例7T/GDNBXXX—2024組合業(yè)務(wù)接口入?yún)⒌臉I(yè)務(wù)報(bào)文有多個(gè)，請求參數(shù)的報(bào)文ID需與接口內(nèi)傳輸?shù)牡谝粋€(gè)報(bào)文文件的報(bào)文ID一致。根據(jù)不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)發(fā)送的組合業(yè)務(wù)報(bào)文進(jìn)行校驗(yàn)，接口請求參數(shù)應(yīng)符合附錄A中A.2要求。6.3.5接口返回參數(shù)及示例完成組合業(yè)務(wù)報(bào)文校驗(yàn)后反饋統(tǒng)一監(jiān)管服務(wù)校驗(yàn)信息，接口返回參數(shù)應(yīng)符合附錄B中B.2要求。7報(bào)文質(zhì)量要求不動(dòng)產(chǎn)登記業(yè)務(wù)系統(tǒng)通過統(tǒng)一監(jiān)管服務(wù)接口對上傳的業(yè)務(wù)報(bào)文進(jìn)行校驗(yàn)，包括必填項(xiàng)、邏輯性、圖形和規(guī)范性校驗(yàn)共四項(xiàng)。7.1必填項(xiàng)要求說明必填項(xiàng)校驗(yàn)包括核心字段、共享字段及重點(diǎn)字段。a)核心字段：指不動(dòng)產(chǎn)單元號、權(quán)利類型、宗地（宗海）代碼、區(qū)縣代碼、業(yè)務(wù)號、權(quán)屬狀態(tài)、狀態(tài)等字段。b)共享字段：指權(quán)利人名稱、證件號、不動(dòng)產(chǎn)權(quán)證號、坐落、房屋用途、房屋性質(zhì)、建筑面積等字段。c)重點(diǎn)字段：指不動(dòng)產(chǎn)登記證明號、權(quán)利人類型、證件種類、登記類型、權(quán)利性質(zhì)、土地用途、土地使用期限、房地產(chǎn)交易價(jià)格、取得價(jià)格、抵押方式、抵押不動(dòng)產(chǎn)類型、被擔(dān)保主債權(quán)數(shù)額、宗地面積、使用權(quán)面積、建筑面積、宗海面積、用島面積、土地使用起始時(shí)間、土地使用結(jié)束時(shí)間、債務(wù)履行起始時(shí)間、債務(wù)履行結(jié)束時(shí)間、查封起始時(shí)間、查封結(jié)束時(shí)間、登記時(shí)間等字段。7.2邏輯性要求說明邏輯性校驗(yàn)應(yīng)包括以下字段：a)核心字段在不同表間的一致性；b)上下手業(yè)務(wù)關(guān)聯(lián)；c)上下手產(chǎn)權(quán)權(quán)利類型一致性；d)不動(dòng)產(chǎn)單元號規(guī)則；e)權(quán)利類型與宗地特征碼、定著物特征碼、抵押不動(dòng)產(chǎn)類型匹配性；f)權(quán)利性質(zhì)與權(quán)利類型匹配性；g)證書號/證明號規(guī)則；h)土地用途、房屋用途、房屋性質(zhì)、房屋類型與字典表符合性。7.3圖形要求說明圖形要求包括圖形無法構(gòu)面、自相交、坐標(biāo)點(diǎn)間隔過小校驗(yàn)以及圖形存在性校驗(yàn)等。7.4報(bào)文規(guī)范性要求說明報(bào)文規(guī)范性要求包括報(bào)文ID校驗(yàn)、報(bào)文重復(fù)性校驗(yàn)、報(bào)文頭存在性校驗(yàn)、坐標(biāo)系校驗(yàn)等。8T/GDNBXXX—2024接口請求示例A.1單業(yè)務(wù)接口請求規(guī)范單業(yè)務(wù)接口請求參數(shù)說明見表A.1。表A.1單業(yè)務(wù)接口請求參數(shù)1234bizId:441302200820161Content-Type:multipart/form-data;charset=utf-8file:Biz4413022008201A.2組合業(yè)務(wù)接口請求示例組合業(yè)務(wù)接口請求參數(shù)見表A.2。表A.2組合業(yè)務(wù)接口請求參數(shù)1234示例2：bizId:4413022206200Content-Type:multipart/form-data;charset=utf-8file:Biz441302220620000001.zipBiz441302220620000002.zipBiz44130222062009T/GDNBXXX—2024接口返回示例B.1單業(yè)務(wù)接口返回規(guī)范單業(yè)務(wù)接口返回參數(shù)說明見表B.1。表B.1單業(yè)務(wù)接口返回參數(shù)123示例1："data":"JG-2021042114320}"msg":"[DJF_DJ_SH]時(shí)間填寫不符合邏輯。[DJF_DJ_SH]時(shí)間填寫不符合邏輯。[KTT_FW_ZRZ]狀態(tài)有誤。}",B.2組合業(yè)務(wù)接口返回示例組合業(yè)務(wù)接口返回參數(shù)說明見表B.2。表B.2組