DB3701/T 11-2020 不动产抵押登记数据接口规范

ICS35.240.01

CCSL67

DB3701

济南市地方标准

DB3701/T11—2020

不动产抵押登记数据接口规范

DataInterfaceSpecificationofRealPropertyMortgageRegistration

2020-11-01发布2020-11-01实施

济南市市场监督管理局发布

DB3701/T11—2020

目次

前言II

1范围1

2规范性引用文件1

3术语和定义1

5访问方法2

6接口内容2

7接口技术要求2

8接口定义2

9网络安全要求19

附录A（资料性附录）业务流程图20

附录B（规范性附录）数据字典21

附录C（资料性附录）接口参数示例27

I

DB3701/T11—2020

前言

本文件按照GB/T1.1-2020给出的规则起草。

本文件由济南市自然资源和规划局提出、归口并组织实施。

本文件起草单位：济南市不动产登记中心、山东汇智科技发展有限公司。

本文件主要起草人：许多兵、刘公、杜建刚、董哲、刘敏、周光营、曹倩、包文超、赵晖、韩晶、

李中正。

II

DB3701/T11—2020

不动产抵押登记数据接口规范

1范围

本文件规定了不动产抵押登记数据接口的术语和定义、缩略语、访问方法、接口内容、接口技术要

求、接口定义和网络安全要求。

本文件适用于金融机构信息化系统与不动产登记系统间抵押登记业务的数据交互，其他信息化系统

可参照使用。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文

件。

GB/T37346不动产单元设定与代码编制规则

3术语和定义

下列术语和定义适用于本文件。

3.1

不动产抵押登记realpropertymortgageregistration

经不动产抵押权利人申请，不动产登记机构将不动产抵押权及其变动事项记载于不动产登记簿的行

为。

3.2

不动产单元realpropertyunit

权属界线固定封闭且具有独立使用价值的空间，由定着物单元和其所在宗地（宗海）共同组成，是

不动产登记的基本单位。

[来源：GB/T37346—2019，3.16]

3.3

不动产单元号realpropertyunitnumber

按一定的规则赋予不动产单元的唯一和可识别的标识码，也可以称为不动产单元代码。

[来源：GB/T37346—2019，3.17，有修改]

4缩略语

下列缩略语适用于本文件。

1

DB3701/T11—2020

JSON：一种轻量级的数据交换格式（JavaScriptObjectNotation）

REST：表述性状态传递（RepresentationalStateTransfer）

SOAP：简单对象访问协议(SimpleObjectAccessProtocol)

UTF-8：Unicode的可变长度字符编码(8-bitUnicodeTransformationFormat)

5访问方法

5.1访问方式

对不动产登记数据REST接口的访问对应唯一的资源标识符（URL网址），应采用RFC2616中的HTTP

协议的POST方式进行。

5.2访问步骤

5.2.1身份认证并获取授权码：通过与不动产登记机构签订不动产抵押登记业务合作协议申请相关服

务资源，经审核后获取唯一授权标志码。

5.2.2获取接口服务地址：通过不动产登记管理机构获取数据接口资源访问地址。

5.2.3接口访问：通过接口地址进行访问，获取返回结果。

6接口内容

6.1不动产抵押登记数据接口分为业务办理接口、信息查询接口及数据字典，支持实现不动产抵押登

记业务办理，业务流程图见附录A。

6.2业务办理接口用于不动产抵押登记业务的各环节流程办理中的数据交互。

6.3信息查询接口用于不动产抵押登记业务相关信息查询的数据交互。

6.4数据字典用于描述接口数据项字典值的含义，见附录B。

7接口技术要求

7.1并行性

接口应提供多用户并行访问支持。

7.2接口方式

接口应包括SOAP和REST两种方式。

7.3接口参数要求

7.3.1接口传递参数应采用UTF-8编码。REST接口应采用JSON格式封装输入输出参数。

7.3.2调用时应完全符合方法名称和参数名称的大小写、请求参数个数、请求参数顺序和请求参数类

型。

8接口定义

8.1业务办理接口

2

DB3701/T11—2020

8.1.1获取业务号接口

接口描述：调用获取不动产登记系统业务号，应用于提交业务时需使用业务号的场景（例如

打印申请表）。

接口方法名称：getYwh。

获取业务号接口的输入参数见表1。

表1获取业务号接口输入参数

序号参数名称说明类型长度是否必填项备注

1khdxtywh客户端系统业务号字符型20是

2khdxtmc客户端系统名称字符型100是

3sqm加密授权码字符型500是应为加密后的授权码

获取业务号接口的输出参数见表2。

表2获取业务号接口输出参数

序号参数名称说明类型长度备注

1bj标记字符型4标记代码见附录B.1

2sm说明字符型100标记代码为1002的说明

3ywh业务号字符型20

8.1.2获取不动产信息接口

接口描述：通过不动产登记证书号/不动产登记证明号/合同号提取房屋、权利人等信息。

接口方法名称：queryBdcxx。

获取不动产信息接口的输入参数见表3。

表3获取不动产信息接口输入参数

序号参数名称说明类型长度是否必填项备注

不动产权证书号/不动

1bdcqzh字符型20是/表示为或

产登记证明号/合同号

2qlrmc权利人名称字符型50是

3jzmj建筑面积浮点型15,2否

4khdxtmc客户端系统名称字符型100是

5sqm授权码字符型500是应为加密后的授权码

获取不动产信息接口的输出参数见表4。

表4获取不动产信息接口输出参数

序号参数名称说明类型长度备注

1bj标记字符型4标记代码见附录B.1

2sm说明字符型100标记代码为1002的说明

3qsqdfs权属取得方式字符型50

不动产权证书号/不动

4bdcqzh字符型20

产登记证明号/合同号

3

DB3701/T11—2020

表4获取不动产信息接口输出参数（续）

序号参数名称说明类型长度备注

5djsj登记时间日期时间型-yyyy-MM-ddHH:mm:ss

6cxsj查询时间日期时间型-yyyy-MM-ddHH:mm:ss

7qszt权属状态字符型1权属状态见附录B.2

8gyqk共有情况字符型1共有情况见附录B.3

9qlrxxList权利人信息对象数组-定义见表5

10fwxxList房屋信息对象数组-定义见表6

11dyxx抵押信息对象-定义见表7

12xzq行政区字符型10

13zcs总层数字符型10

14szcs所在层数字符型10

16jznd建筑年代字符型10

16fwxz房屋性质字符型10

表5权利人信息（Qlrxx）

序号参数名称说明类型长度备注

1qlrmc权利人名称字符型50

2zjlx证件类型字符型3证件类型见附录B.4

3zjhm证件号码字符型50

4lx申请人类型字符型2申请人类型见附录B.5

表6房屋信息（Fwxx）

序号参数名称说明类型长度备注

1hbsm户标识码整型10

2zl坐落字符型100

3jzmj建筑面积浮点型15,2

4fwyt房屋用途字符型20

5tdyt土地用途字符型100

6tdsynx土地使用年限字符型50

7ywdy有无抵押字符型1有无抵押见附录B.6

8ywcf有无查封字符型1有无查封见附录B.6

9ywyy有无异议字符型1有无异议见附录B.6

10bdcdyh不动产单元号字符型50

表7抵押信息（Dyxx）

序号参数名称说明类型长度备注

1dyfw抵押范围字符型200

2bdbzzqse被担保主债权数额浮点型15,2

3zgzqse最高债权数额浮点型15,2

4zwlxqssj债务履行起始时间日期型-yyyy-MM-dd

5zwlxjssj债务履行结束时间日期型-yyyy-MM-dd

4

DB3701/T11—2020

表7抵押信息（Dyxx）（续）

序号参数名称说明类型长度备注

6dyjz抵押价值浮点型15,2

7jkhth借款合同号字符型50

8.1.3获取不动产限制信息接口

接口描述：根据户标识码查询详细限制信息。

接口方法名称：queryXzxx。

获取不动产限制信息接口的输入参数见表8。

表8获取不动产限制信息接口输入参数

序号参数名称说明类型长度是否必填项备注

1hbsm户标识码整型10是

2khdxtmc客户端系统名称字符型100是

3sqm授权码字符型500是应为加密后的授权码

获取不动产限制信息接口的输出参数见表9。

表9获取不动产限制信息接口输出参数

序号参数名称说明类型长度备注

1bj标记字符型4标记代码见附录B.1

2sm说明字符型100标记代码为1002的说明

3xzsmList限制信息对象数组-定义见表10

表10限制信息（Xzsm）

序号参数名称说明类型长度备注

1xzlx限制类型字符型1限制类型见附录B.7

2xzsm限制说明字符型500

8.1.4提交业务接口

接口描述：提交受理完成的抵押业务至不动产登记系统。

接口方法名称：submitYwxx。

提交业务接口的输入参数见表11。

表11提交业务接口输入参数

序号参数名称说明类型长度是否必填项备注

1ywxx业务信息对象-是定义见表12

2khdxtmc客户端系统名称字符型100是

3sqm授权码字符型500是应为加密后的授权码

5

DB3701/T11—2020

表12业务信息（Ywxx）

序号参数名称说明类型长度是否必填项备注

1khdxtywh客户端系统业务号字符型20是

2dylb抵押类别字符型1是抵押类别见附录B.8

3dyzl抵押子类字符型4是抵押子类见附录B.9

日期时间

4slsj受理时间-是yyyy-MM-ddHH:mm:ss

型

5dyxx抵押信息对象-是定义见表13

6sqrxxList申请人信息对象数组-是定义见表14

7bdcqzh不动产权证书号字符型50是

8hbsmList房屋信息整型数组-否户标识码

9szdaList数字档案对象数组-是定义见表15

10htwbList合同文本对象数组-是定义见表16

11fj附记字符型500否

12dyyy抵押因由字符型1是抵押因由见附录B.10

13dkfs贷款方式字符型1是贷款方式见附录B.11

14zdyzx自动预转现字符型1是是否代码见附录B.12

15djbj登记标记字符型1是登记标记见附录B.13

16qrfs确认方式字符型1是确认方式见附录B.14

表13抵押信息（Dyxx）

序号参数名称说明类型长度是否必填项备注

1dyfw抵押范围字符型200否

2bdbzzqse被担保主债权数额浮点型15,2是

3zgzqse最高债权数额浮点型15,2否

4zwlxqssj债务履行起始时间日期型-是yyyy-MM-dd

5zwlxjssj债务履行结束时间日期型-是yyyy-MM-dd

6dyjz抵押价值浮点型15,2是单位元

7jkhth借款合同号字符型50否

8zxyy注销原因字符型100否

表14申请人信息（Sqrxx）

序号参数名称说明类型长度是否必填项备注

1sqrlx申请人类型字符型2是申请人类型见附录B.5

2ztlx主体类型字符型1是主体类型见附录B.15

3sqrmc申请人名称字符型50是

4zjlx证件类型字符型3是证件类型见附录B.4

5zjhm证件号码字符型50是

6lxdh联系电话字符型50是

7tp图片字节数组-否现场拍照

8tpdz图片地址字符型100否现场拍照

9xgrxxList相关人信息对象数组-否定义见表14

6

DB3701/T11—2020

表14申请人信息（Sqrxx）（续）

序号参数名称说明类型长度是否必填项备注

10xsd相似度字符型10否

11sfhtjc是否活体检测字符型1是是否代码见附录B.12

表15数字档案（Szdaxx）

序号参数名称说明类型长度是否必填项备注

1tjclmc提交材料名称字符型20是

2ym页码整型-是

3wj文件字节数组-否

4wjdz文件地址字符型100否

6lx类型字符型1是0:jpg1:pdf

表16合同文本（Htwb）

序号参数名称说明类型长度是否必填项备注

1htlx合同类型字符型1是合同类型见附录B.16

2wb合同文本字符型可变长度是支持html、xml、json

3wblx合同文本类型字符型10是支持html、xml、json

4wzht完整合同字节数组-否合同

5wzhtlx完整合同类型字符型10否支持doc、pdf

提交业务接口的输出参数见表17。

表17提交业务接口输出参数

序号参数名称说明类型长度备注

1bj标记字符型4标记代码见附录B.1

2sm说明字符型100标记代码为1002的说明

3ywh业务号字符型20

8.1.5提交组合业务接口

接口描述：提交抵押注销和抵押设立组合业务。

接口方法名称：submitZhYwxx。

提交组合业务接口的输入参数见表18。

表18提交组合业务接口输入参数

序号参数名称说明类型长度是否必填项备注

1ywxxList业务信息对象数组-是定义见表12

2khdxtmc客户端系统名称字符型100是

3sqm授权码字符型500是应为加密后的授权码

提交组合业务接口的输出参数见表17（与8.1.4提交业务接口相同）。