DB37∕T 4701-2024 不动产登记电子证照接口调用技术导则_第1页
DB37∕T 4701-2024 不动产登记电子证照接口调用技术导则_第2页
DB37∕T 4701-2024 不动产登记电子证照接口调用技术导则_第3页
DB37∕T 4701-2024 不动产登记电子证照接口调用技术导则_第4页
DB37∕T 4701-2024 不动产登记电子证照接口调用技术导则_第5页
已阅读5页,还剩20页未读 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

ICS35.240

CCSL67

37

山东省地方标准

DB37/T4701—2024

不动产登记电子证照接口调用技术导则

Technicaldirectivesforinterfacecallofrealestateregistrationelectroniccertificate

2024-04-11发布2024-05-11实施

山东省市场监督管理局发布

DB37/T4701—2024

目次

前言.................................................................................II

1范围...............................................................................1

2规范性引用文件.....................................................................1

3术语和定义.........................................................................1

4符号和缩略语.......................................................................2

5调用流程...........................................................................2

6电子证照接口.......................................................................3

7数据安全...........................................................................4

附录A(资料性)接口调用申请表.......................................................5

附录B(资料性)不动产登记电子证照接口信息...........................................7

B.1证照制证.......................................................................7

B.2证照更新.......................................................................9

B.3证照签发......................................................................10

B.4证照注销......................................................................11

B.5证照下载......................................................................12

B.6证照核对......................................................................20

参考文献.............................................................................23

I

DB37/T4701—2024

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分:标准化文件的结构和起草规则》的规定

起草。

本文件的某些内容可能涉及专利,发布机构不承担识别专利的责任。

本文件由山东省自然资源厅(山东省林业局)提出并组织实施。

本文件由山东省自然资源标准化技术委员会归口。

II

DB37/T4701—2024

不动产登记电子证照接口调用技术导则

1范围

本文件规定了山东省不动产登记电子证照接口调用流程、电子证照接口信息及数据安全要求等内容。

本文件适用于山东省各市县不动产登记机构的登记系统与山东省不动产登记电子证照系统对接。

2规范性引用文件

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

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

文件。

GB/T22239—2019信息安全技术网络安全等级保护基本要求

GB/T39786—2021信息安全技术信息系统密码应用基本要求

3术语和定义

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

3.1

证照certificate

由机关、团体、企事业单位颁发的、能证明资格或权利等的凭证类证类文件。

注:证照包括证件和执照等。

[来源:GB/T36901—2018,3.1]

3.2

电子证照electroniccertificate

由计算机等电子设备形成、传输和存储的证照数据文件。

[来源:GB/T36901—2018,3.3]

3.3

电子证照文件electroniccertificatefile

以版式文档表示的电子证照,该文件既包含照面固定版式效果,又包含证照元数据及标识,并应用

密码技术保障这些内容的真实性和完整性。

[来源:GB/T36901—2018,3.4]

3.4

电子证照原件electroniccertificateoriginalfile

由证照颁发机构或其授权机构签署生成的电子证照文件。

[来源:GB/T36901—2018,3.5]

3.5

电子证照加注件electroniccertificatecopyfile

1

DB37/T4701—2024

为办理相关事项,在电子证照原件基础上附加用途、有效期限等声明信息并由制作人签署而产生的

电子证照文件。

[来源:GB/T36901—2018,3.6]

3.6

不动产权证书realestatepropertycertificate

由不动产登记机构颁发的、记载权利人对一个不动产单元拥有一种或者互相兼容的一组权利的证

明。

[来源:ZWFWC0203—2020,3.2]

4符号和缩略语

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

HTTPS:超文本安全传送协议(HypertextTransferProtocolSecure)

JSON:一种轻量级的数据交换格式(JavaScriptObjectNotation)

OFD:开放版式文档(OpenFixed-layoutDocument)

PDF:可移植文档格式(PortableDocumentFormat)

5调用流程

5.1省级电子证照接口包括但不限于电子证照制证接口、证照更新接口、证照签发接口、证照注销接

口、证照下载接口、证照核对接口等。

5.2市县登记机构在登簿环节调用电子证照制证接口生成电子证照模板,模板生成后调用证照签发接

口完成电子签章。

5.3需补、换不动产权电子证照时,调用证照注销接口注销原电子证照。

5.4电子证照内容发生变更时,调用电子证照更新接口。

5.5需核对电子证照真伪时,调用电子证照核对接口。接口调用申请表见附录A,电子证照接口调用

流程如图1。

2

DB37/T4701—2024

省级不动产登记业务主管部门市县级不动产登记机构

证照制证接口

更新

证照更新接口调用接口

登记业务

证照签发接口

证照注销接口

调用接口

证照应用及其他

证照下载接口

业务

调用接口

证照核对证照核对接口

图1电子证照接口调用流程图

6电子证照接口

不动产登记电子证照接口实现证照制证、证照更新、证照签发、证照注销、证照下载和证照核对等

功能,电子证照接口目录见表1。接口方式、请求方法、请求参数、返回结果、接口示例等信息见附录B。

表1电子证照接口目录

序号接口名称接口描述

1证照制证生成未加盖电子签章的OFD格式不动产登记电子证照文件。

2证照更新更新已制证的OFD格式不动产登记电子证照文件。

3

DB37/T4701—2024

表1电子证照接口目录(续)

序号接口名称接口描述

签发不动产登记电子证照文件,实现电子证照文件签章。

3证照签发该接口返回完整版OFD电子证照文件,可统一存储在全省电子证照数据库中,若

市县需要本地存储,本地电子证照库应及时增加、更新和注销。

4证照注销注销已生成的不动产登记电子证照。

通过证照标识获取下载地址:根据电子证照标识、事由、有效期等信息生成电

5

子证照加注件并返回下载地址,下载文件格式为OFD。

6通过证照标识获取下载OFD证照文件。

7证照下载通过证照标识获取证照信息。

根据提供的电子证照原件或加注件,验证电子证照文件真实性、完整性及有效

8

性。

9通过证照持有主体代码获取证照信息。

查询特定人员或证书相关联的不动产登记信息,用于省市县电子证照数据核对

10证照核对

校验及全省不动产登记信息精准核查。

7数据安全

不动产登记电子证照相关接口数据安全应遵循GB/T22239—2019、GB/T39786—2021的要求并满足

但不限于:

a)数据加密:采用符合相关要求的国密算法对重要数据进行加密,密钥由省级不动产登记业务主

管部门统一生成;

b)数据保护:通过接口调用获得的信息仅可用于生成不动产登记电子证照,不应以任何形式提供

给第三方,也不应用于任何其他目的;

c)数据备份与恢复:

1)应具备重要数据实时备份与恢复功能;

2)备份机制应完整有效,具备异地备份功能且对备份数据进行保护。

4

DB37/T4701—2024

附录A

(资料性)

接口调用申请表

接口调用申请表见表A.1。

表A.1接口调用申请表

部门登记系统基本信息

部门名称

系统名称

系统简要说明

系统访问地址

系统运行网络

联系人信息

业务联系人

业务联系人电话

技术联系人

技术联系人电话

经办人(签字):申请接入单位(盖章):

5

DB37/T4701—2024

附录B

(资料性)

不动产登记电子证照接口信息

B.1证照制证

B.1.1接口方式

该接口采用HTTPS+JSON的接口方式。

B.1.2请求方法

该接口请求方法为POST请求。

B.1.3请求参数

电子证照制证接口请求参数见表B.1。

表B.1电子证照制证接口请求参数

参数名称类型描述信息

channel

String机构ID,各市县不动产登记机构的唯一标识,由省级不动产登记业务主管部门电子证照系统生成

Id

dataString加密数据包

B.1.4返回结果

电子证照制证接口返回结果见表B.2。

表B.2电子证照制证接口返回结果

参数名称类型描述信息

messageString返回结果说明

errorint错误码;0.成功;-1.失败

data.certIdentifierString电子证照唯一标识,其值遵循GB∕T36904—2018

B.1.5接口示例

{

"channelId":"渠道ID",

"data":{

"orgId":"证照颁发机构的统一社会信用代码",

"timestamp":"访问本接口时间戳(10位数字)",

"certTypeCode":"证照类型代码",

"ownersfzhm":"所属者/法人的身份证号码",

"faceImg":"证照头像,base64格式",

"info":{

"base":{

7

DB37/T4701—2024

"qxdm":"行政区划代码",

"ywh":"办件业务号",

"zzhmz":"证照号码(字)",

"zzhmnf":"证照号码(年份)",

"zzhmdqjc":"证照号码(市县全称)",

"zzhmh":"证照号码(号)",

"zzr":"制证人",

"sjlx":"数据类型",

"sxdm":"关联事项代码",

"djlxdm":"登记类型代码",

"qllxdm":"权利类型代码",

"qlxzdm":"权利性质代码",

"gyr":"共有人(多个以“^”分隔)",

"gyrzjh":"共有人证件号(多个以“^”分隔)",

"gybl":"共有比例(多个以“^”分隔)",

"yqlrgx":"与权利人关系",

"fbczbs":"分别持证标识",

"ytdm":"用途代码",

"dymj":"不动产单元面积",

"mjdw":"面积单位",

"mjdwdm":"面积单位代码",

"ftmc1":"附图名称1",

"ftmc2":"附图名称2",

"ftmc3":"附图名称3",

"ftjzd":[

{

"jd":"界址点1经度",

"wd":"界址点1纬度"

},

{

"jd":"界址点2经度",

"wd":"界址点2纬度"

}

]

},

"certno":"不动产权证书号",

"yzbh":"编号(省级不动产登记业务主管部门生成,赋值)",

"qlrmc":"权利人名称(多个以“^”分隔)",

"qlrzjhm":"权利人证件号码(多个以“^”分隔)",

"qlrzjlx":"权利人证件类型(多个以“^”分隔)",

"gyqk":"共有情况",

8

DB37/T4701—2024

"zl":"坐落",

"bdcdyh":"不动产单元号",

"qllx":"权利类型(照面值,名称按照国标匹配)",

"qlxz":"权利性质(照面值,名称按照国标匹配)",

"yt":"用途(照面值)",

"mj":"面积(照面值)",

"qlqtzk":"权利其他状况(多行情况下,使用换行符‘ ’换行)",

"fj":"附记(多行情况下,使用换行符‘ ’换行)",

"ft1":"附图(base64编码值)",

"ft2":"附图(base64编码值)",

"ft3":"附图(base64编码值)",

"zzbfrq":"证照颁发日期",

"zzyxqqsrq":"使用期限起",

"zzyxqjzrq":"使用期限止"

}

}

}

B.2证照更新

B.2.1接口方式

该接口采用HTTPS+JSON的接口方式。

B.2.2请求方法

该接口请求方法为POST请求。

B.2.3请求参数

电子证照更新接口请求参数见表B.3。

表B.3电子证照更新接口请求参数

参数名称类型描述信息

channelIdString机构ID,各市县不动产登记机构的唯一标识,由省级不动产登记业务主管部门电子证照系统生成

dataString加密数据包

B.2.4返回结果

电子证照更新接口返回结果见表B.4。

表B.4电子证照更新接口返回结果

参数名称类型描述信息

messageString返回结果说明

errorint错误码;0.成功;-1.失败

9

DB37/T4701—2024

B.2.5接口示例

//请求参数

{

"orgId":"jnsbdcdjzx",

"timestamp":"1569748316",

"certIdentifier":"005.2.11100000000013338W002.1132048201413*****",

"info":{不动产电子证书JSON数据或不动产电子证明JSON数据}

}

//返回结果

{

"message":"成功",

"error":0

}

B.3证照签发

B.3.1接口方式

该接口采用HTTPS+JSON的接口方式。

B.3.2请求方法

该接口请求方法为POST请求。

B.3.3请求参数

电子证照签发接口请求参数见表B.5。

表B.5电子证照签发接口请求参数

参数名称类型描述信息

channelIdString机构ID,各市县不动产登记机构的唯一标识,由省级不动产登记业务主管部门电子证照系统生成

dataString加密数据包

B.3.4返回结果

电子证照签发接口返回结果见表B.6。

表B.6电子证照签发接口返回结果

参数名称类型描述信息

messageString返回结果说明

errorint错误码;0.成功;-1.失败

data.certIdentifierString电子证照唯一标识,其值遵循GB∕T36904—2018

data.dataString已经签章的base64编码OFD文件

B.3.5接口示例

10

DB37/T4701—2024

//请求参数

{

"orgId":"jnsbdcdjzx",

"timestamp":"1569748316",

"qfr":"张三",

"certIdentifier":"005.2.11100000000013338W002.1132048201413*****",

"yzh":"印章编号"

}

//返回结果

{

"message":"成功",

"error":0,

"data":{

"certidentifier":"005.2.11100000000013338W002.11320482014***",

"data":"已经签章的base64编码OFD文件"

}

}

B.4证照注销

B.4.1接口方式

该接口采用HTTPS+JSON的接口方式。

B.4.2请求方法

该接口请求方法为POST请求。

B.4.3请求参数

电子证照注销接口请求参数见表B.7。

表B.7电子证照注销接口请求参数

参数名称类型描述信息

channelIdString机构ID,各市县不动产登记机构的唯一标识,由省级不动产登记业务主管部门电子证照系统生成

dataString加密数据包

B.4.4返回结果

电子证照注销接口返回结果见表B.8。

表B.8电子证照注销接口返回结果

参数名称类型描述信息

messageString返回结果说明

errorint错误码;0.成功;-1.失败

11

DB37/T4701—2024

B.4.5接口示例

//请求参数

{

"orgId":"jnsbdcdjzx",

"timestamp":"1569748316",

"zzr":"张三",

"certIdentifier":"005.2.11100000000013338W002.1132048201413****"

}

//返回结果

{

"message":"成功",

"error":0

}

B.5证照下载

B.5.1证照标识获取下载地址

B.5.1.1接口方式

该接口采用HTTPS+JSON的接口方式。

B.5.1.2请求方法

该接口请求方法为POST请求。

B.5.1.3请求参数

电子证照标识获取下载地址接口请求参数见表B.9。

表B.9电子证照标识获取下载地址接口请求参数

参数名称类型必填描述信息

访问标识,由省级不动产登记业务主管部门电子证照系统生成并告知

head.accessIdString是

各接口调用单位

应用认证信息,由省级不动产登记业务主管部门电子证照系统生成并

head.accessTokenString是

告知各接口调用单位授权码(机构ID)

head.accessUserString是请求查询人员

head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等

data.useCauseString是申请事由,不超过200字

data.expiryTimeString是电子证照加注件有效期截止时间YYYY-MM-DD

data.useScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等

B.5.1.4返回结果

电子证照标识获取下载地址接口返回结果见表B.10。

12

DB37/T4701—2024

表B.10电子证照标识获取下载地址接口返回结果

参数名称类型描述信息

head.statusint错误码;0.成功;其他.失败

head.messageString返回结果说明

data.contentTypeString编码类型为base64

data.certIdentifierString电子证照标识,其值遵循GB∕T36904—2018

data.contentString证件文件下载地址,下载后的文件是符合GB∕T36904—2018的要求

B.5.1.5接口示例

//请求参数

{

"head":{

"accessId":"appId",

"accessToken":"Gl9kClWo8GVI***",

"accessUser":"张三",

"accessMode":"40"

},

"data":{

"certIdentifier":"005.2.***",

"useScenario":"10",

"useCause":"事由***",

"expiryTime":"过期时间***"

}

}

//返回结果

{

"head":{

"status":0,

"message":"接口调用成功"

},

"data":"04D4FB95943B9E0419390A37B48A6F2805F9091……"

}

B.5.2证照标识获取下载OFD证照文件

B.5.2.1接口方式

该接口采用HTTPS+JSON的接口方式。

B.5.2.2请求方法

该接口请求方法为POST请求。

13

DB37/T4701—2024

B.5.2.3请求参数

电子证照标识获取下载OFD证照文件接口请求参数见表B.11。

表B.11电子证照标识获取下载OFD证照文件接口请求参数

参数名称类型必填描述信息

访问标识,由省级不动产登记业务主管部门电子证照系统生成并

head.accessIdString是

告知各接口调用单位

应用认证信息,由省级不动产登记业务主管部门电子证照系统生

head.accessTokenString是

成并告知各接口调用单位授权码机构ID

head.accessUserString是请求查询人员

head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等

data.useCauseString是申请事由,不超过200字

data.expiryTimeString是电子证照加注件有效期截止时间YYYY-MM-DD

data.useScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等

B.5.2.4返回结果

电子证照标识获取下载PDF证照文件接口返回结果见表B.12。

表B.12电子证照标识获取下载OFD证照文件接口返回结果

参数名称类型描述信息

head.statusint错误码;0.成功;其他.失败

ad.messageString返回结果说明

dataStringbase64编码的证照文件内容(OFD格式)

B.5.2.5接口示例

//请求参数

{

"head":{

"accessId":"appId",

"accessToken":"Gl9kClWo8GVI***",

"accessUser":"张三",

"accessMode":"40"

},

"data":{

"certIdentifier":"005.2.***",

"useScenario":"10",

"useCause":"事由***",

"expiryTime":"过期时间***"

}

14

DB37/T4701—2024

}

//返回结果

{

"head":{

"status":0,

"message":"接口调用成功"

},

"data":"04D4FB95943B9E0419390A37B48A6F2805F9091……"

}

B.5.3证照标识获取证照信息

B.5.3.1接口方式

该接口采用HTTPS+JSON的接口方式。

B.5.3.2请求方法

该接口请求方法为POST请求。

B.5.3.3请求参数

电子证照标识获取证照信息接口请求参数见表B.13。

表B.13电子证照标识获取下证照信息接口请求参数

参数名称类型必填描述信息

访问标识,由省级不动产登记业务主管部门电子证照系统生成并告知各接口调

head.accessIdString是

用单位

应用认证信息,由省级不动产登记业务主管部门电子证照系统生成并告知各接

head.accessTokenString是

口调用单位

head.accessUserString是请求查询人员

head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等

data.certIdentifierString是电子证照标识,其值应符合GB∕T36904—2018的要求

data.useCauseString是申请事由,不超过200字

data.useScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等

B.5.3.4返回结果

电子证照标识获取证照信息接口返回结果见表B.14。

表B.14电子证照标识获取下证照信息接口返回结果

参数名称类型描述信息

head.statusint错误码;0.成功;其他.失败

head.messageString返回结果说明

15

DB37/T4701—2024

参数名称类型描述信息

data.certDataString加密后的电子证照照面信息

B.5.3.5接口示例

//请求参数

{

"head":{

"accessId":"appId",

"accessToken":"356YDO7xXyb08mlbr/Tdk7UuFrMoLtzZx0BBtg==",

"accessUser":"张三",

"accessMode":"40"

},

"data":{

"certIdentifier":"005.2.1110000137D001.xxxx.xxx.xx.x",

"useScenario":"10",

"useCause":"事由***"

}

}

//返回结果

{

"head":{

"status":0,

"message":"接口调用成功"

},

"data":{

"certData":"04D4FB95943B9E0419390A37B48A6F2805F9091……"

}

}

B.5.4证照文件有效性验证

B.5.4.1接口方式

该接口采用HTTPS+JSON的接口方式。

B.5.4.2请求方法

该接口请求方法为POST请求。

B.5.4.3请求参数

电子证照文件有效性验证接口请求参数见表B.15。

表B.15电子证照文件有效性验证接口请求参数

16

DB37/T4701—2024

参数名称类型必填描述信息

访问标识,由省级不动产登记业务主管部门电子证照系统生成并告知各

head.accessIdString是

接口调用单位

应用认证信息,由省级不动产登记业务主管部门电子证照系统生成并告

head.accessTokenString是

知各接口调用单位

表B.15电子证照文件有效性验证接口请求参数(续)

参数名称类型必填描述信息

head.accessUserString是请求查询人员

head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等

data.certTypeCodeString是证照类型代码

data.contentTypeString是编码类型为base64

data.contentString是Base64字符串,解码后的内容应符合GB/T36905—2018的要求

data.useCauseString是申请事由,不超过200字

data.useScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等

B.5.4.4返回结果

电子证照文件有效性验证接口返回结果见表B.16。

表B.16电子证照文件有效性验证接口返回结果

参数名称类型描述信息

head.statusint错误码;0.成功;其他.失败

head.messageString返回结果说明

data.resultString校验结果,返回0表示验证通过,其他值表示失败

校验结果说明,与校验结果代码对应的文字说明,如:

“0”:“验证通过”;“1”:“签章校验失败”;

data.messageString

“2”:“文件校验失败”;“3”:“证照未激活”;

“4”:“证照暂时失效”;“5”:“证照已失效”

B.5.4.5接口示例

//请求参数

{

"head":{

"accessId":"apple",

"accessToken":"356YDO7xb08mlbr/Tdk7Uuln...eU7EyJAAm8Sx0BBtg==",

"accessUser":"张三",

"accessMode":"40"

},

"data":{

17

DB37/T4701—2024

"certTypeCode":"11100000000013127D001",

"contentType":"base64",

"content":"base64内容",

"useScenario":"10",

"useCause":"事由***"

}

}

//返回结果

{

"head":{

"status":0,

"message":"接口调用成功"

},

"data":"04D4FB95943B9E0419390A37B48A6F2805F9091……"

}

B.5.5证照持有主体代码获取证照信息

B.5.5.1接口方式

该接口采用HTTPS+JSON的接口方式。

B.5.5.2请求方法

该接口请求方法为POST请求。

B.5.5.3请求参数

电子证照持有主体代码获取证照信息接口请求参数见表B.17。

表B.17电子证照持有主体代码获取证照信息接口请求参数

参数名称类型必填描述信息

访问标识,由省级不动产登记业务主管部门电子证照系统生成并告

head.accessIdString是

知各接口调用单位

应用认证信息,由省级不动产登记业务主管部门电子证照系统生成

head.accessTokenString是

并告知各接口调用单位

head.accessUserString是请求查询人员

head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等

data.holderCodeString是持证主体代码,如:身份证中的身份证号码

data.holderTypeCodeString是持证主体代码类型代码

data.certTypeCodeString是证照类型代码

data.certNoString是证照编号

18

DB37/T4701—2024

参数名称类型必填描述信息

data.useCauseString是申请事由,不超过200字

data.useScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等

B.5.5.4返回结果

电子证照持有主体代码获取证照信息接口返回结果见表B.18。

表B.18电子证照持有主体代码获取证照信息接口返回结果

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论