DB45T-不动产登记云平台房屋和土地金融服务接口规范.docx

ICS35.240.01CCSL67H45广西壮族自治区地方标准DB45TXXXXX-XXXX不动产登记云平台房屋和土地金融服务接口规范SpecificationforreaIestateregiStrationcIoudplatformhousingandIandfinanciaIserviceiinterface（征求意见稿）在提交反馈意见时，请将您知道的相关专利连同支持性文件一并附上。XXXX -XX-XX 发布XXXX-XX-XX实施广西壮族自治区市场监督管理局发布本文件按照GB/T1.1-2020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由广西壮族自治区自然资源厅提出、归口并宣贯。本文件起草单位：广西壮族自治区自然资源信息中心、北京超图软件股份有限公司。本文件主要起草人：朱剑、郑智华、毛莹莹、宾元菲、马愉富、吴发兴、草桂练、杨翔、罗晓梅、汪剑章、杜波、黄琼秀、黄丽英、吴柱、韦祎、李衍君、唐长增。不动产登记云平台房屋和土地金融服务接口规范1范围本文件界定了不动产登记云平台房屋和土地金融服务接口涉及的的术语和定义，规定了缩略语、访问方法、接口内容、接口技术要求、接口定义和网络安全等要求O本文件适用于广西壮族自治区行政区域内金融机构信息化系统与不动产登记系统间房屋和土地金融服务业务的数据交互。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件。GB/T37346不动产单元设定与代码编制规则3术语和定义GB/T37346界定的以及下列术语和定义适用于本文件。不动产登记云平台realestateregistrationcloudplatform依托物联网、云计算、大数据、微服务、人工智能、GIS等新一代信息技术，以政务云、自然资源云为基础，建成平台架构统一、数据标准统一、业务逻辑统一、共享交换统一的广西全区“省级大集中+全业务上云”的平台。4缩略语下列缩略语适用于本文件：JSON：一种轻量级的数据交换格式(JaVaSCriPtObjectNotation)；REST：表述性状态传递(RePrCSCntationalStateTransfer)；SOAP：简单对象访问协议(SinIPleObjectAccessProtocol)；UTF-8：UniCOde的可变长度字符编码(8-bitUnicodeTransformationFormat)05接口调用说明接口调用说明流程见图1。图1接口调用说明流程6接口内容A1获取会话授权信息接口主要用于接口调用授权的获取。6 ,不动产业务查询服务包含个人查档信息共享接口、进度查询接口、证书/证明列表查询接口、不动产登记证书查询接口、不动产登记证明查询接口、证书证明打印状态回写接口、不动产登记收费信息查询接口、不动产登记收费确认接口。A不动产业务办理服务依据登记类型划分为抵押登记业务办理服务接口和抵押权注销业务办理服务接口。包含现房抵押登记办理接口、期房抵押登记办理接口、土地抵押登记办理接口、现房抵押权注销登记办理接口、期房抵押权注销登记办理接口、土地抵押权注销登记办理接口、附件文件上传接口等。主要是用于不动产登记业务的申报。7接口服务设计7 1接口通用说明接口通用说明如下：a）传输方式：http；b）请求编码：utf-8；c） 请求内容格式：-三,w-for-ur!encoded（表单方式）+json;d） 响应编码：utf-8；e）响应内容格式：json；f）请求说明：请求每个请求需要在Url加入授权令牌（token）如下：http:/host:port/xxx/xxx/xx?token=令牌tokeng）数据传递格式为josn,响应内容分公共部分和主体部分，公共部分见表1；表1公共部分"requestcode":"请求代码（必须）”,"requestseq":"请求流水号”，"data":“request。/:"请求参数1”,"request002":"请求参数2"h）响应说明：数据响应格式为json,响应内容分公共部分和主体部分，公共部分见表2。表2公共部分*code*:0,"msg":"成功"，"requestcode”:*1000*l*requestseq*:*yyyymmddhhmmssffffff*,"data":"state":"00",result:）,"extra":"扩展的自定义信息”79加密方式说明对接口返回结果均采用SM2加密技术进行加密处理，加密示例及秘钥实际对接时提供。参数加密示例见附录B。8接口定义1获取会话授权信息接口8.1.1 接口地址http:/ip:portxxxxxxxapplicationToken<>请求方式：POSt请求。8.1.2 请求参数说明见表3。表3获取会话授权信息请求参数说明序号参数属性参数名称字段类型是否必须说明1username用户名字符是2password密码字符是3XZqdnI行政区代码字符是8.1.3 1.3请求报文格式见表4。表4请求报文格式wrequestcode*:*1000*,wrequestseq*:*yyyymmddhhmmssffffff*,*data*:wusername*:*zhangsan*,*password*:*12345678*,wzqdm*:*450020*)8.1.4 返回参数说明见表5。表5获取会话授权信息返回参数说明序号参数属性参数名称字段类型1timeouttoken有效时间，单位ms长整型2token授权令牌字符8.1.5 接口返回格式见表6。表6返回报文格式"code”:0,"msg":"成功"，"requestcode":"1000”,wrequestseq*:yyyynunddhhmmssffffff*,"data":"timeout”:500000,"token”:*efddki83iedbald09d023344566*,“*"t1。extra:nullA5业务查询服务8.2.1个人查档信息共享接口8.2.1.1接口说明该接口为不动产登记数据对需求部门及单位的个人数据查档共享接口,根据姓名和证件号码查询个人名下的权属信息，包括产权，抵押等权利信息，房屋基本信息。8.2.1.2接口地址http:/IP:PORT/xxxx/xxxx/xxxx/queryInfo?token=o请求方式：POST请求，body传值。8.2.1.3接口请求参数说明见表7。表7个人查档信息共享接口请求参数说明序号参数属性参数名称字段类型是否必须说明1cxrxm查询人字符是查询人的姓名2Cxjgmc查询机构名称字符是查询机构名称3bcxrxm被查询人姓名字符是被查询人姓名（权利人）4zjhm被查询人证件号字符是被查询人证件号5ywlsh业务流水号字符否办理业务时的业务流水号6XZqdn)行政区代码字符是行政区代码8.2.1.4请求报文格式见表8。表8请求报文格式查询请求报文“requestcode":"1001","requestseq":"202008121040000001*,"data":"cxrxm":“查询人姓名”，"cxjgmc":"查询机构名称“，"bcxrxm":"被查询人姓名“，"zjh:“被查询人证件号“，"ywlsh":"业务流水号”,"xzqdm":"行政区代码”8.2.1.5接口返回参数说明见表9。表9个人查档信息共享返回参数说明序号参数属性参数名称字段类型备注1dybm单元编码字符2zl坐落字符3Zdmj宗地面积字符IInjdW面积单位字符5yt用途字符6qlxz权利性质字符7bdcqzh不动产权证号字符Sdjjg登记机构字符9syqmj使用权面积字符10SyqqSSj使用权起始时间字符11syqjssj使用权结束时间字符12jzmj建筑面积字符13ghyt规划用途字符14yhwzsm用海位置说明字符15hdwz海岛位置字符16hdmc海岛名称字符17hdyt海岛用途字符18gjzwghyt构（建）筑物规划用途字符19gjz三j构（建）筑物面积字符20dybdclx抵押不动产类型字符21Idsyqssj林地使用权起始时间字符22Idsyjssj林地使用权结束时间字符仔号参数属性参数名称字段类型23dybm单元编码字符24zl坐落字符25Zdmj宗地面积字符26mjdw面积单位字符27yt用途字符28qlxz权利性质字符29bdcqzh不动产权证号字符30djjg登记机构字符31syqmj使用权面积字符32syqqssj使用权起始时间字符33syqjssj使用权结束时间字符34jzmj建筑面积字符35ghyt规划用途字符36yhwzsm用海位置说明字符37hdwz海岛位置字符hdmc海岛名称字符39hdyt海岛用途字符；。gjzwghyt构（建）筑物规划用途字符41gjzwnj构（建）筑物面积字符42dybdclx抵押不动产类型字符43Idsyqssj林地使用权起始时间字符44Idsyjssj林地使用权结束时间字符45dyaq抵押登记对象查现房，也要查对应期房的抵押46dyr抵押人字符47dyfs抵押方式字符48bdbzzqse被担保债权数额字符49ygdjzl预告登记种类字符50xh查封序号字符51cfdj查封登记对象查现房，也要把期房的查封查出来52cfjg查封机构字符53cflx查封类型字符54cfwh查封文号字符55cfqssj查封起始时间字符56cfjssj查封结束时间字符57fwxz房屋性质字符58Jgsj竣工时间字符59tdsyqssj土地使用权起始时间字符60tdsyjssj土地使用权结束时间字符61yydjlist异议登记集合集合序号参数属性参数名称字段类型备注62yysqr异议中清人字符63yysqsj异议申请时间字符8.2.1.6接口返回格式见表10。表10接口返回格式"code”:0,msg:成功，“requestcode”:*1001*,"requestseq”:*202008121040000001”,"data":*bdcfklist*:*tdsyqlist*:"dybm":"45138100410556677”,"zl":"a市C区d村”，“zdmj":"92943.66",ff.Iff"c"mjdw:2,"yt":"3","qlxz":"200”,"bdcqzh":"冀(2016)a市不动产权第OoOOoO1号”，“djjg":a市不动产登记中心”，查询结果报文"bdcdylx":"02",*qlrlist*:qlrmc:张二,*zjh*:*450722199320152015*,Zjzl:1,*jsydsyqlist*:”dyb:*45138100410556678*,"zl":"a市b区体育北大街10号”，"yt":"084”,*syqqssj*:*2016/5/20*,*syqjssj*:*2066/5/20*,"qlxz":"101”,"bdcqzh":"冀(2016)a市不动产权第OOOOOo2号”，"djjg":"a市不动产登记中心”，查询结果报文“bdcdylx":"02",*qlrlist*:“qlrmc":"张三"，"zjh":"450722199320152015”,ZjZl:1I,*fdcqlist*:*dybm*:*45138100410556679*,"zl":"a市b区C小区e6-3-202”,JZlnJ:50.64,"ghyt":"071”,IWxz:O,“jgsj":"2016/3/20",“tdsyqssj":"2015/5/20”,"tdsyjssj*:“2085/5/20",“bdcqzh":“冀(2016)a市不动产权第OoOoOO3号”，"djjg":"a市不动产登记中心”，*bdcdylx*:*031*,"rQlrlist*:qlrmc:张二，"zjh”:*450722199320152015",Zjzl:1,“hysyqlist”:"dybm”:*45138100410556680*,“syqqssj":"2015/9/24”,"syqjssj":"2025/9/1”,“bdcqzh":"冀(2016)a市不动产权第OoooOo4号”，"djjg":"a市不动产登记中心”，"bdcdylx":"04",*qlrlist*:qlrmc:张二，zjh":"450722199320152015",Zjzl:1,“gjzwsyqlist”:"dybm”:*45138100410556680*,"zl":"坐落"，"gjzwmj":"100.00","syqssj":"2015/9/27","syjssj":"2055/9/27","bdcqzh":"冀(2016)a市不动产权第OoOOOo4号”，"a市不动产登记中心"，*bdcdylx*:*06*,*qlrlist*:qlrmc:张二，"zjh":"450722199320152015”,zjzl:11."IqlisE"dybm”:*45138100410556680*,"syqmj":"15062.0000”,"Idsyqssj":"2015/1/24”,"Idsyjssj":"2025/1/24","bdcqzh":"国林证字第O(H号"，"a市不动产登记中心“，"bdcdylx":"02",wqlrlist*:qlrmc:张二,"zjh":"450722199320152015。Zjzl:1),*dyaqlist*:"dybm”:*45138100410556680*,"dybdclx":"2","zl":"a市b区C小区e6-3-202”,"dyr":"张三","dyfs":"1",*qlqssj*:*2015/1/24*,*qljssj*:*2017/1/24*,*djsj*:*2016/1/24*,“bdcqzh":"不动产证明号”，"djjg":"a市不动产登记中心”，"bdcdylx":"031”,“zqdbse":"2500000","rQlrlist*:qlrmc:张二，"zjh”:*450722199320152015",ZjZl:1,*ygdjlist*:"dybm”:*45138100410556680*,ygdjzl:1,"jzmj":"100.00",“bdcqzh":"x(2016)a市不动产证明第OoOOOO2号”，“djjg":"a市不动产登记中心”，“bdcdylx":"032",*qlrlist*:“qlrmc":"张三"，"zjh":"450722199320152015”,F.yHF1FZjzl:1,yrcfdjlist*:*dybm*:*45138100410556680*,“xh":丁，"zl":"a市b区C小区e6-3-202”,"cfjg":"a市中级人民法院”，"cflx":"1","cfwh":"查封文号”，“cfqssj":"2016/1/24”,“cfjssj":"2017/1/24",*djsj*:“2017/1/24","djjg":"a市不动产登记中心”),"yydjlist”:"dybm":"45138100410556680”,“yysqr”:*,"djyy":"a市b区C小区e6-3-202”,"zl":"a市中级人民法院”，*yysqsj*:*2016/1/24*,*djsj*:*2016/1/24*,"a市不动产登记中心”）,“extra":；8. 2.2进度查询接口8.2. 2.1接口说明为需求部门及单位提供不动产登记业务进度查询共享接口，根据业务受理编号查询对应的业务进度、环节信息。8.2.2.2接口地址httpIP:PORT/xxxx/xxxx/xxxx/queryTnfo?token=o请求方式：PoST请求，body传值8.2.2.3接口请求参数说明见表11。表11进度查询接口请求参数说明序号参数属性参数名称字段类型是否必须说明1cxrxm查询人字符是查询人的姓名2cxjgmc查询机构名称字符是查询机构名称3ywlsh业务流水号字符是办理业务时的业务流水号4XZqdm行政区代码字符是行政区代码8.2.2.4请求报文格式见表12。表12请求报文格式查询请求报文("requestcode":"1002”,*requestseq*:*20200812104000000,*data*:"cxrxm":"查询人姓名”，"cxjgmc":"查询机构名称”，"ywlsh":"业务流水号”，"xzqdm":"行政区代码”8.2.2.5接口返回参数说明见表13。表13进度查询接口返回参数说明参数属性参数名称字段类型1actdef_name进度环节名称字符2actinsttype进度环节类型字符3blry办理人员字符1actinst_start进度环节开始时间字符5actinstend进度环节结束时间字符6sxh顺序号字符7xmmc项目名称字符8.2.2.6接口返回格式见表14。表14接口返回格式查询结果报文("code”:0,"msg":"成功",wrequestcode*:*1002*,wrequestseqz,:*20200812104000000,*data*:“jdxx”:*actdefname*:"申请受理”，*actinsttype*:"3”,“blry":"转移开发商”,“actinst_Start”:*2018-12-1411:17:13*,*actinst_end*:*2018-12-1411:30:38*,sxh:1查询结果报文,("actdef_name":"信息录入"，*actinsttype*:"3”,“blry":"转移开发商“，*actinst_start*:"2018-12-1411:30:38”,*actinst_end*:“2018-12-1411:30:56”,"sxh":"3",(*actdef_name*:"初审”，*actinsttype*:"3”,“blry":"张三"，*actinst_start*:"2018-12-1411:30:56”,"actinst_end":"2018-12-2611:44:38”,sxh:4,(*actdef_name*:“核定”，*actinsttype*:"3”,"blry":"李四"，*actinst_start*:“2018-12-2611:44:38”,"actinst_end":"2018-12-2614:26:31”,SXh:5,(*actdef_name*:"登簿"，*actinsttype*:*1*,"blry":"王五"，*actinst_start*:“2018-12-2614:26:31”,sxh:6),(*actdefname*:"发证”，*actinsttype*:"2”,SXh:7,(*actdefname*:"归档"，表14接口返回格式（续）actnsttype:2,"sxh":"8"),“extra":8.2.3证明证书列表查询8.2.3.1接口说明通过权利人或代理人信息，查询到该人名下可打印的证明、证书列表。支持只传入权利人名称，查询该权利人的证书列表。8.2.3.2接口地址http:/IP:PORT/xxxx/xxxx/xxxx/queryInfo?token=o请求方式：PoST请求，body传值8.2.3.3接口请求参数说明见表15。表15证明证书列表查询请求参数说明序号参数属性参数名称字段类型是否必须说明1cxrxm查询人字符是查询人的姓名2Zjh证件号字符是查询人证件号（授权人可选填）3searchtype查询类型字符是1：银行授权人查询（银行授权人由调用平台（自助机）转换为银行名称，也就是权利人）；2：权利人查询：3：代理人查询：1pageindex当前页字符否分页查询中第几页,默认第一页5pagesize每页记录数字符否分页查询中的页数大小，仅限输入1至100如不输入默认30。6xzqdm行政区代码字符是行政区代码7ywlsh业务流水号字符否办理业务时的业务流水号8zslb证书类别字符否1：证书：2：证明；（不传默认查询所有）8.2.3.4请求报文格式见表16。表16请求报文格式查询请求报文“requestcode":"1004","requestseq”:*20200812104000000K,*data*:"cxrxm":“查询人姓名”，"zjh":"证件号"，"searchtype":"查询类型"，"xzqdm":"行政区代码”)8.2.3.5接口返回参数说明见表17。表17证明证书列表查询返回参数说明序号参数属性参数名称字段类型备注1zsid证书id字符2bdcqzh不动产权证号字符3qlrmc权利人名称字符1zl坐落字符5ywlsh业务流水号字符6ywr义务人字符7xmbh项目编号字符8ispay缴费状态字符O-未缴，1-已缴9zslx证书类型字符I-产权证书，2-抵押证明，3-预告证明，4-其它证明10pagecount记录总数字符8.2.3.6接口返回格式见表18。表18接口返回格式查询结果报文"code”:0,"msg":"成功"，*requestcode*:"1004”,“requestseq":"202008121040000001”,"data":*pagecount*:*1*zslist*:“1TH-*Tzsid:证书Id,表18接口返回格式（续）“bdcqzh":"不动产权证号”，"qlrmc":"权利人名称"，"zl":"坐落"，“ywlsh":"业务流水号”，"ywr":"义务人名称“，查询结果报文"xmbh":"项目编号"，“ispay":"缴费状态"，"zslx":"证书类型",“extra":8.2.4不动产登记证书查询接口8.2.4.1接口说明为不动产登记数据对需求部门及单位的证书查询共享接口，根据被查询人证件号和业务流水号查询对应未打证的证书信息。8.2.4.2接口方法名称http:/IP:PORT/xxxx/xxxx/xxxx/queryInfo?token=o请求方式：PoST请求，body传值。8.2.4.3接口请求参数说明见表19。表19证书查询共享接口请求参数说明序号参数属性参数名称字段类型是否必须说明1cxrxm查询人字符是查询人的姓名2Cxjgmc查询机构名称字符是查询机构名称3cxlsh查询流水号字符否查询请求的流水号，由查询单位自定义规则传入1bcxrxm被查询人姓名字符是被查询人姓名（权利人）5zjhm被查询人证件号字符是被查询人证件号6bdcqzh产权证号字符是产权证号7xzqdm行政区代码字符是行政区代码8.2.4.4请求报文格式见表20。表20请求报文格式查询请求报文“requestcode":"1102”,"requestseq”:*20200812104000000,"data":"cxrxm":"查询人姓名”，"cxjgmc":"查询机构名称“，"ywlsh":"业务流水号”，"bcxrxm":"被查询人姓名“，”zjh:“被查询人证件号”，"bdcqzh":"产权证号"，"xzqdm":"451202"8.2.4.5接口返回参数说明见表21。表21证书查询共享接口返回参数说明序号参数属性参数名称字段类型1qllx权利类型字符2bdcdyh不动产单元号字符3qhmc区划名称字符1yt用途字符5mj面积字符6qhc省份字符7qlxz权利性质字符8zl坐落字符9bdcqzh不动产权证号字符10Qlr权利人字符11syqx使用期限字符12gyqk共有情况字符13fj附记字符14year年份字符15month月份字符16day日字符17nd年度字符18qlqtzk其他权利状况字符19zsid证书id字符20qrcode二维码字符8.2.4.6接口返回格式见表22。表22接口返回格式查询结果报文("code”:0,"msg":"成功"，“requestcode":"1102”,“requestseq":"202008121040000001*,"data":"qllx":"4","bdcdyh”:*130105006001gb00002f0001000,“qhmc":"南宁市"，"yt":"10","mj":"123”,q11jc:桂，“qlxz":"100”,"zl":"a市b区C小区e6-3-202",“bdcqzh":“桂(2016)a市不动产证明第OoOOoo2号”，"qlr":"张三"，“syqx":"1994年03月24日起2064年03月24日止”，RI“F.Fgyqk:1,"门"："业务编号：201xxx*,“month":"05","year":"2019”,"day":"29","nd":"2019”,“qlqtzk":"专有建筑面积：7311T,分摊建筑面积：1611,"zsid”:*jfJkljdfaklsjdfkl*,“qrcode”:"bdcqzh=桂(2016)2市不动产证明第0000002号&251(1打门。1£3内5上£1£内”,“extra":8.2.5不动产登记证明查询接口8.2.5.1接口说明不动产登记数据对需求部门及单位的证明查询共享接口，根据被查询证件号和业务流水号查询对应未打证的证明信息。8.2.5.2接口方法名称http:/IP:PORT/xxxx/xxxx/xxxx/queryInfo?token=o请求方式：POST请求，body传值。8.2.5.3接口请求参数说明见表23。表23不动产登记证明查询请求参数接口序号参数属性参数名称字段类型是否必须说明1cxrxm查询人字符是查询人的姓名2Cxjgmc查询机构名称字符是查询机构名称3cxlsh查询流水号字符否查询请求的流水号，由查询单位自定义规则传入4bcxrxm被查询人姓名字符是被查询人姓名（权利人）5zjhm被查询人证件号字符是被查询人证件号6bdcqzh产权证号字符是产权证号7xzqdm行政区代码字符是行政区代码8.2.5.4请求报文格式见表24。表24请求报文格式查询请求报文(*requestcode*:“1103*,"requestseq”:*202008121040000001","data":"cxrxm":"查询人姓名”，"cxjgmc":"查询机构名称“，“ywlsh":"业务流水号”，"bcxrxm":"被查询人姓名“，"zjh:“被查询人证件号”，"bdcqzh":"产权证号"，"xzqdm":"451202"8.2.5.5接口返回参数说明见表25。表25不动产登记证明查询返回参数接口序号参数属性参数名称字段类型1b(Icdyh不动产单元号字符2qhmc区划名称字符3Qhjc区划简称字符4zl坐落字符5bdcqzh不动产权证号字符6qlr权利人字符7fj附记字符8ywr义务人字符9zmqlhsx证明权利或事项字符10qt其他信息字符11year年份字符12month月份字符13day日字符14nd年度字符15zsid证书id字符16qrcode二维码字符8.2.5.6接口返回格式见表26。表26接口返回格式("code”:0,"msg":"成功"，*requestcode*:*1103*,*requestseq*:*202008121040000001”,"data":"qhmc":"南宁市"，qhjc:桂，"zl":"a市b区C小区e6-3-202”,皆询结果报文"bdcqzh":"不动产权证号”，"qlr":"张三","ywr":"李四。"bdcdyh”:*130105006001gb00002f00010001”,"zmqlhsx":"预告登记”，"fj":"业务编号：201xxx*,"qt"："预告登记的种类：预售商品房买卖预告登记"，*sxh*:*012xxx*,"month":"05","year":"2019”,表26接口返回格式（续）查询结果报文“day":"29","nd":"2019","zsid”:*jfJkljdfaklsjdfkl*,“qrcode”:"bdcqzh二桂(2016)a市不动产证明第OOOOOO2号&zsid=jfjkljdfaklsjdfkl",*extra*:8.2.6证书证明打印状态回写接口8.2.6.1接口说明为不动产证书证明成功打印之后，回传打印状态。记录该证书已打证状态。8.2.6.2接口地址http:/IP:P0RTxxxxxxxxxxxxqucryInfo7tokcn=o请求方式：PoST请求，body传值。8.2.6.3接口请求参数说明见表27。表27证书证明打印状态回写接口请求参数说明序号参数属性参数名称字段类型是否必须说明1XZQD