《不动产登记电子证照签发接口规范》

ICS35.080

CCSL70

团体标准

T/GDNBXXXX—2024

不动产登记电子证照签发

接口规范

Interfacespecificationfortheissuanceofelectroniccertificatesforealestate

regeistration

（征求意见稿）

XXXX-XX-XX发布XXXX-XX-XX实施

广东省土地学会  发布

T/GDNBXXXX—2024

不动产登记电子证照签发接口规范

1范围

本文件规定了广东省不动产登记电子证照签发的接口。

本文件适用于市县级不动产登记系统签发不动产登记电子证照。

2规范性引用文件

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

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

文件。

GB11643公民身份号码

GB/T21010土地利用现状分类

GB32100法人和其他组织统一社会信用代码编码规则

GB/T36904-2018电子证照标识规范

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

HY/T123海域使用分类

TD/T1066不动产登记数据库标准

C0203-2020全国一体化在线政务服务平台电子证照不动产权证书

C0204-2020全国一体化在线政务服务平台电子证照不动产登记证明

3术语和定义

C0203-2020和C0204-2020界定的以及下列术语和定义适用于本文件。

3.1

版式文件layoutfile

版面呈现效果固定的电子文档格式，版式文件的呈现与设备无关，在各种设备上阅读、打印或印刷

时，其版面的呈现结果都是一致的。

4缩略语

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

HTTP：超文本传送协议（HypertextTransferProtocol）

JSON：JS对象简谱（JavaScriptObjectNotation）

REST：描述性状态迁移（RepresentationalStateTransfer）

URL：统一资源定位符（UniformResourceLocator）

OFD:开放式版式文档（OpenFixed-layoutDocument）

5调用流程

1

T/GDNBXXXX—2024

图1电子证照签发流程图

签发电子证照的流程：

a)制作版式文件。调用7.1接口，生成未盖章的电子证照版式文件。

b)加盖电子印章。对接省电子印章平台盖章服务对未盖章的版式文件进行盖章。（盖章接口不

在本文件范围内）

c)发布电子证照。调用7.2接口或者7.3接口，将已盖章的电子证照文件推送至省电子证照数据

库。

d)废止电子证照。调用7.4接口，废止已经注销的不动产权利对应的电子证照。

6接口概述

接口按照REST风格设计，通过HTTP协议的POST方法提交请求。请求公共参数通过URL传递，接

口专用参数通过请求正文按照JSON格式封装传递。

7接口说明

7.1制作版式文件

7.1.1接口说明

制作未盖章的证照版式文件。

7.1.2请求参数说明

说明见表1。

表1制作版式文件接口请求参数说明表

参数名必选类型范围说明

implementCode是String证照照面编码，详见附录F章节

licenseGroup是String模板组别名称，详见附录F章节

dataFields是Object证照业务数据，详见附录E章节

fileType是String证照版式文件类型，默认为ofd

operator是Operator经办人信息，详见附录B章节

sourceSystemName是String源头业务系统名称

sourceSystemCode是String源头业务系统标识

7.1.3请求参数格式示例

示例见附录I.1。

7.1.4返回参数说明

说明见表2。

2

T/GDNBXXXX—2024

表2制作版式文件接口返回参数说明表

参数名必选类型范围说明

meta是json接口调用情况信息

code是String错误代码

message是String错误信息描述

timestamp是String时间戳

responseId否String响应体唯一ID

data是json业务数据

fileDatas是List<FileData>电子证照版式文件

fileData是String附件数据，base64字符串

fileType是String附件类型

7.1.5返回参数格式示例

示例见附录J.1。

7.2证照版式文件制证

7.2.1接口说明

在完成版式文件盖章后，用此接口提交证照结构化数据和已盖章文件至省电子证照数据库。

7.2.2请求参数说明

说明见表3。

表3证照版式文件制证请求参数说明表

参数名必选类型范围说明

itemName是String发证事项名称/事由

itemCode否String发证事项编码

bizNum否String业务流水号

operator是Operator制证经办人信息，详见附录B章节

implementCode是String证照照面编码，详见附录F章节

licenseGroup是String模板组别名称，详见附录F章节

dataFields是Object证照业务数据，详见附录E章节

attachments否List<Attachment>其他普通附件，详见附录A章节

licenseFiles是List<Attachment>证照文件

sourceSystemName是String源头业务系统名称

sourceSystemCode是String源头业务系统标识

7.2.3请求参数格式示例

示例见附录I.3。

7.2.4返回参数说明

说明见表4。

3

T/GDNBXXXX—2024

表4证照版式文件制证返回参数说明表

参数名必选类型范围说明

meta是json接口调用情况信息

code是String错误代码

message是String错误信息描述

timestamp是String时间戳

responseId否String响应体唯一ID

data是json业务数据

licenseCode是String电子证照唯一标识码

licenseNumber是String证照编码

7.2.5返回参数格式示例

示例见附录J.2。

7.3批量证照版式文件制证

7.3.1接口说明

在完成文件盖章后，用此接口批量提交证照结构化数据和已盖章文件至省电子证照数据库。

7.3.2请求参数说明

说明见表5。

表5批量证照版式文件制证请求参数说明表

参数名必选类型范围说明

itemName是String发证事项名称/事由

itemCode否String发证事项编码

bizNum否String业务流水号

operator是Operator制证经办人信息，详见附录B章节

implementCode是String证照照面编码，详见附录F章节

批量制证签发数据集(证照业务数据+证照附件)，详

licenses是List<CreateData>

见附录D章节

sourceSystemName是String源头业务系统名称

sourceSystemCode是String源头业务系统标识

7.3.3请求参数格式示例

示例见附录I.1。

7.3.4返回参数说明

说明见表6。

表6批量证照版式文件制证返回参数说明表

参数名必选类型范围说明

meta是json接口调用情况信息

code是String请求状态代码

message是String请求状态描述

timestamp是String时间戳

responseId否String响应体唯一ID

4

T/GDNBXXXX—2024

参数名必选类型范围说明

data是json业务数据

licenseCode否String电子证照唯一标识码

licenseNumber否String证照编码

resultMsg是String结果信息，详见附录H章节

resultCode是String结果状态编码，详见附录H章节

errors是Object错误详细信息

7.3.5返回参数格式示例

示例见附录J.3。

7.4废止电子证照

7.4.1接口说明

对已签发的电子证照进行废止。

7.4.2请求参数说明

说明见表7。

表7废止电子证照请求参数说明表

参数名必选类型范围说明

itemName是String废止事项名称/事由

itemCode否String事项编码

operator是Operator废止经办人信息，详见附录B章节

implementCode是String证照照面编码(目录实施码)，详见附录F章节

bizNum否String业务流水号

licenseCode否String电子证照唯一标识码(和证照编码不能同时为空)

证照编码(和电子证照唯一标识码不能同时为空，当

licenseNumber否String

licenseCode不为空时，该参数无效)

持证主体代码(当licenseNumber不为空时为必填，多个

holderIdentityNum否String

时用英文逗号分割，licenseCode不为空时，该参数无效)

sourceSystemName是String源头业务系统名称

sourceSystemCode是String源头业务系统标识

7.4.3请求参数格式示例

示例见附录I.4。

7.4.4返回参数说明

说明见表8。

表8废止电子证照返回参数说明表

参数名必选类型范围说明

meta是json接口调用情况信息

code是String错误代码

message是String错误信息描述

timestamp是String时间戳

5

T/GDNBXXXX—2024

参数名必选类型范围说明

responseId否String响应体唯一ID

data是json业务数据

7.4.5返回参数格式示例

示例见附录J.4。

6

T/GDNBXXXX—2024

A

A

附录A

（规范性）

证照文件/普通附件

证照文件/普通附件见表A.1。

表A.1Attachment类

属性类型长度可空说明

fileNameString200否附件名称

fileTypeString20否附件类型,默认ofd

fileDataString无否附件数据，base64字符串

7

T/GDNBXXXX—2024

附录B

（规范性）

经办人信息

经办人信息见表B.1。

表B.1Operator类

属性类型长度可空说明

operatorAccountString100是经办人账号，标识属性。

operatorNameString100否经办人姓名

operatorIdentityNumString20否经办人身份证件号码

operatorIdentityTypeString20否经办人身份证件类型

operatorRoleString100是经办人角色。如“窗口受理人员”

operatorDivisionNameString256否经办人所属部门行政区划名称

operatorDivisionCodeString20否操作人所属部门行政区划代码

operatorAddressString2000是经办人所在地址

operatorOrgNameString200否经办人所属部门名称

operatorOrgCodeString50否经办人所属部门编码

8

T/GDNBXXXX—2024

附录C

（规范性）

版式文件

版式文件见表C.1。

表C.1FileData类

属性类型长度可空说明

fileTypeString20否文件类型(1:OFD，2:PDF)

fileDataString无否文件数据，base64字符串

9

T/GDNBXXXX—2024

附录D

（规范性）

Licenses数据集

Licenses数据集见表D.1。

表D.1License数据集

参数名必选类型范围说明

licenseGroup是String模板组别名称

dataFields是Object证照业务数据

attachments否List<Attachment>其他普通附件

licenseFile是List<Attachment>证照文件

10

T/GDNBXXXX—2024

附录E

（规范性）

证照业务数据

不动产权电子证书（土地承包经营权）证照版式见图E.1。

不动产权电子证书（土地承包经营权）结构化数据见表E.1。

不动产权电子证书证照版式民法典版本见图E.2。

不动产权电子证书证照版式物权法版本见图E.3。

不动产权电子证书结构化数据见表E.2。

不动产登记电子证明证照版式民法典版本见图E.4。

不动产登记电子证明证照版式物权法版本见图E.5。

不动产登记电子证明结构化数据见表E.3。

不动产登记结果信息表（产权）证照版式见图E.6。

不动产登记结果信息表（产权）结构化数据见表E.4。

不动产登记结果信息表（他项权）证照版式见图E.7。

不动产登记结果信息表（他项权）结构化数据见表E.5。

图E.1不动产权电子证书（土地承包经营权）版式

表E.1结构化数据参数表

序号数据名称参数名可空类型范围说明

1持证主体代码CZZTDM否String—

2证照名称ZZMC否String—

3证照编号ZZBH否String即“不动产权证号”

4持证主体CZZT否String即“权利人”

11

T/GDNBXXXX—2024

序号数据名称参数名可空类型范围说明

5持证主体代码类型CZZTDMLX否String详见附录G

6持证主体代码类型代码CZZTDMLXDM否String详见附录G

7证照有效期起始日期ZZYXQQSRQ否Date—

8证照有效期截止日期ZZYXQJZRQ是Date—

9证照颁发日期ZZBFRQ否Date即“登记时间”

10证照颁发机构ZZBFJG否String—

11证照颁发机构行政区划代码ZZBFJGXZQHDM否String—

12证照颁发机构代码ZZBFJGDM否String使用“统一社会信用代码”

13发证机构名称KZ_FZJGMC否String—

14登记时间KZ_DJSJ否Date—

扫码打开的页面应包含地

二维码是

15KZ_EWMLOB块信息和附图

16证照号码KZ_ZZHM否String—

17证照号码（字）KZ_ZZHMZ否String—

18证照号码（年份）KZ_ZZHMNF否String—

19证照号码（地区名称）KZ_ZZHMDQMC否String—

20证照号码（号）KZ_ZZHMH否String—

21发包方全称KZ_FBFQC否String—

22承包方代表KZ_CBFDB否String—

23身份证号码KZ_SFZHM否String—

24承包方式KZ_CBFS否String—

25合同代码KZ_HTDM否String—

26承包期限KZ_CBQX否String—

27承包地确权总面积（亩）KZ_CBDQQZMJM否String—

28承包地块总数（块）KZ_CBDKZSK否String—

29家庭成员姓名1KZ_XM1否String详见注1

30与承包方代表关系1KZ_YCBFDBGX1否String详见注1

31家庭成员备注1KZ_BZ1是String详见注1

32家庭成员姓名2KZ_XM2否String详见注1

33与承包方代表关系2KZ_YCBFDBGX2否String详见注1

34家庭成员备注2KZ_BZ2是String详见注1

35附记KZ_FJ是String详见注1

注1：注1：KZ_XM1、KZ_YCBFDBGX1、KZ_BZ1与KZ_XM2、KZ_YCBFDBGX2、KZ_BZ2字段均为家庭成员情况信息，对

应证照模板中6列描述家庭成员情况的表格。每个字段均为数组，最大可传5组信息，超出5组则无法展示。

当家庭成员超过10人时，请将第10个位置的“姓名”改为“其他家庭成员信息请见登记簿”。

注2：注2：因实际业务问题或历史原因而缺乏的必填信息，填写反斜杠“\”作为缺省值，待数据完善后更新电

子证照。

12

T/GDNBXXXX—2024

图E.2不动产权电子证书证照版式民法典版本

图E.3不动产权电子证书证照版式物权法版本

表E.2结构化数据参数表

序号数据名称参数名可空类型范围说明

13

T/GDNBXXXX—2024

序号数据名称参数名可空类型范围说明

1证照名称ZZMC否String固定为“中华人民共和国不动产权证书”

不动产权证号，由不动产权证登记机构按照规

证照编号否

2ZZBHString则赋予该证的业务编号。

不动产权利人的姓名或名称。共有不动产，发

一本证书的，权利人填写全部共有人的姓名或

名称，用“^”号分隔，在“权利其他状况”

栏记载持证人；共有人分别持证的，权利人填

写持证人，其余共有人在“权利其他状况”栏

3持证主体CZZT否String记载。

权利人为自然人时，应填写有效身份证件上的

姓名；权利人是法人或其他组织时，应使用营

业执照、社会组织法人证书、事业单位法人证

书等上的规范名称。用于照面呈现时，将“^”

替换为空格。

不动产权利人的证件号码。权利人为自然人

的，使用其有效身份证件号码；权利人为法人

持证主体代

否或其他组织的，使用规定的统一社

4码CZZTDMStringGB32100

会信用代码。多个权利人证件号用“^”号分

隔。

持证主体代不动产权利人代码的类型，证件种类，详见附

5CZZTDMLX否String

码类型录G。

持证主体代

是详见附录

6码类型代码CZZTDMLXDMStringG

不动产权利使用期限的终止日，按公元纪年精

确至日。涉及地上房屋、构筑物的，填写土地

使用权的终止日期；涉及海上构（建）筑物的，

证照有效期填写海域使用权的终止日期；土地承包经营权

是

7截止日期ZZYXQJZRQDate填写土地承包合同终止日期。土地所有权以及

未明确权利期限的可以不填，默认为长期有

效。用于照面或登记表单展示时用阿拉伯数字

将年、月、日标全，月、日不标虚位。

不动产权利使用期限的起始日，按公元纪年精

确至日。涉及地上房屋、构筑物的，填写土地

使用权的起始日期；涉及海上构（建）筑物的，

填写海域使用权的起始日期；土地承包经营权

证照有效期

是填写土地承包合同起始日期。土地所有权以及

8起始日期ZZYXQQSRQDate

未明确权利期限的可以不填，默认为初始登记

取得该证书的时间。用于照面或登记表单展示

时用阿拉伯数字将年、月、日标全，月、日不

标虚位。

即登簿时间，按公元纪年精确至日。用于照面

证照颁发日

否或登记表单展示时，用阿拉伯数字将年、月、

9期ZZBFRQDate

日标全，月、日不标虚位。

证照颁发机

否县级以上自然资源主管部门

10构ZZBFJGString

证照颁发机

否登记机构的统一社会信用代码

11构代码ZZBFJGDMString

证照颁发机

12构行政区划ZZBFJGXZQHDM否String即区县代码

代码

不动产权证

否—

13号（字）KZ_BDCQZHZString

不动产权证

否—

14号（年份）KZ_BDCQZHNFString

15不动产权证KZ_BDCQZHDS否String—

14

T/GDNBXXXX—2024

序号数据名称参数名可空类型范围说明

号（地市）

不动产权证

否—

16号（号）KZ_BDCQZHHString

工程标准证

否详见注

17照标识码KZ_GCBZZZBSMString1

18权利人类型KZ_QLRLX否String—

19共有人KZ_GYR是String—

共有人证件

是—

20号KZ_GYRZJHString

不动产共有情况，可填写“单独所有”，或“共

21共有情况KZ_GYQK否String同共有”，或“按份共有”。涉及房屋、构筑

物的，填写房屋、构筑物的共有情况。

当共有情况为“按份共有”时，当前共有人享

22共有比例KZ_GYBL是String

有不动产权利的份额比例(百分比、分数)

与权利人关

23KZ_YQLRGX是String—

系

分别持证标

是—

24识KZ_FBCZBSString

不动产单元

否—

25号KZ_BDCDYHString

宗地、宗海所在地的地理位置名称。涉及地上

26坐落KZ_ZL否String房屋的，一般包括街道名称、门牌号、幢号、

房号等

宗地、宗海、海岛、房屋和构筑物的规划用途。

不动产涉及宗地的，填写GB/T21010的二级

分类；不动产涉及宗海的，填写的

用途是HY/T123

27KZ_YTString二级分类；涉及房屋或构筑物的，填写其规划

用途；涉及两种或以上用途的，用“^”分隔，

用于照面呈现时，将“^”替换为“/”

土地按GB/T21010-2017填写二级分类对应的

代码；海域按填写二级分类对应的

用途代码