广东省不动产登记电子证照

1、广东省不动产登记电子证照接口规范(V1.0版)广东省国土资源技术中心2019年1月修订情况修订人修订时间版本修订内容梁庆发、吉奥2019年1月16日V1.0（20190116）梁庆发2019年1月21日V1.0（20190121）1、4.2.4、4.3.4和4.7.4请求参数中的license_code和id_code改为必选。2、勘误部分文字。目录1适用范围12使用流程13公共参数13.1请求公共参数及部分参数说明13.1.1操作人信息结构表23.1.2API_ROOT地址说明23.1.3item_code目录实施码说明33.1.4事项名称和事项编码说明33.1.5印章编码seal_code

2、说明33.2返回公共参数34接口说明44.1创建制证数据44.1.1方法说明44.1.2请求方法54.1.3URL地址54.1.4请求参数54.1.5请求示例104.1.6返回示例134.2签发一张证照134.2.1方法说明134.2.2请求方法134.2.3URL地址134.2.4请求参数134.2.5请求示例144.2.6返回示例154.3注销一张证照154.3.1方法说明154.3.2请求方法154.3.3URL地址154.3.4请求参数154.3.5请求示例164.3.6返回示例174.4依职能查验用证174.4.1方法说明174.4.2请求方法174.4.3URL地址174.4.4请

3、求参数174.4.5请求示例184.4.6返回示例194.5归档电子文件204.5.1方法说明204.5.2请求方法204.5.3URL地址204.5.4请求参数214.5.5请求示例214.5.6返回示例214.6制作签发一张证照214.6.1方法说明214.6.2请求方法224.6.3URL地址224.6.4请求参数224.6.5请求示例224.6.6返回示例234.7变更一张证照234.7.1方法说明234.7.2请求方法244.7.3URL地址244.7.4请求参数244.7.5请求示例254.7.6返回示例285附录285.1广东省不动产登记电子证照通用事项281211 适用范围本接

4、口规范提出了广东省不动产登记电子证照管理的技术规范要求，适用于广东省各地不动产登记部门的登记平台与省电子证照系统进行对接，实现对不动产登记电子证照的生命周期管理。2 使用流程签发一张电子证照的流程：（1） 创建制证数据（4.1接口）（2） 签发一张证照（4.2接口）（3） 归档电子证照（4.5接口）在正式登簿环节同步签发电子证照，特别注意上下首业务间的关联关系，做好电子证照的更新工作（如生成、注销和变更等）。通过4.4接口可以查验已签发电子证照的情况。4.6接口综合了4.1和4.2接口的功能，可选择使用。3 公共参数3.1 请求公共参数及部分参数说明参数名类型范围说明operatorObjec

5、t操作人信息，参考操作人信息结构表terminal_infoString发起查询的ip，如经过多个服务，则填写源头ip 3.1.1 操作人信息结构表参数名类型范围说明divisionString区县名称roleString角色（职务）nameString姓名identity_numString证件号码service_orgString所属单位division_codeString区县代码3.1.2 API_ROOT地址说明测试环境：3:9012 正式环境：3:9010注意：请勿在正式环境进行测试！正式环境要求严格，只能

6、在正式投入生产时使用，请先在测试环境充分测试后再切换到正式环境。3.1.3 item_code目录实施码说明测试环境：item_code备注100092401440000证书100006501440000证明正式环境：item_code备注100212601440000证书100212701440000证明3.1.4 事项名称和事项编码说明制证接口统一使用service_code和service_name，用证接口统一使用service_item_code和service_item_name；service_code和service_name和item_code根据业务来填写，需严格对应，具体

7、参考附录5.1的广东省不动产登记电子证照通用事项。3.1.5 印章编码seal_code说明测试环境：参数名类型范围值seal_codeStringDZYZ006939932itWTQB正式环境： 各区县有属于自己的印章编码，具体编码待收集好各地的印章图片后再配置提供。3.2 返回公共参数参数名类型范围说明dataObject数据，参考各接口示例response_idString接口返回的唯一标识号ack_codeString接口调用是否成功SUCCESS：成功，FAILURE：失败correlation_idString关系iderrorsObject错误信息，参考错误信息结构表timest

8、ampDate接口响应的服务端时间 错误信息结构表参数名类型范围说明code String错误代码name String错误名称severity String错误级别message String错误信息描述inner_code String内部代码4 接口说明4.1 创建制证数据4.1.1 方法说明创建电子证照制证数据4.1.2 请求方法POST4.1.3 URL地址API_ROOT/electLicense/createAccreditationData4.1.4 请求参数参数名必选类型范围说明data_fields是Object证照数据内容，分为电子证明和电子证书两套，参考电子证明数据结构

9、表和电子证书数据结构表。operator是Object制证操作人信息service _name是String事项名称service _code是String事项编码biz_num否String对应办件的业务流水号seal_code是String印章编码（由地方提供印章图片后配置生成）license_group是String默认值：“组别1”terminal_info是String发起查询的ip，如经过多个服务，则填写源头ipitem_code是String实施目录码attachments否List<Attachment>证照附件信息 电子证明数据结构表参数名必选类型范围说明ZZMC

10、是String默认值：“不动产权电子证明”ZZHM是String证照号码CYRMC是String权利人（申请人）CYRSFZJLX是String持有人身份证件类型CYRSFZJHM是String持有人身份证件号码FZJGMC是String发证机构名称FZJGZZJGDM是String发证机构组织机构代码(支持输入“无”)FZJGSSXZQHDM是String发证机构所属行政区划代码FZRQ是String发证日期(yyyy-mm-dd)YXQJSRQ否String有效期结束日期(格式yyyy-mm-dd,如长期有效，则默认为空)ZZHM1是String证照号码（字）ZZHM2是String证照号

11、码（年份）ZZHM3是String证照号码（地区名称）ZZHM4是String证照号码（号）ZMQLHSX是String证明权利或事项YWR是String义务人ZL是String坐落BDCDYH是String不动产单位元号QT否String其他FJ否String附记 电子证书数据结构表参数名必选类型范围说明ZZMC是String默认值：“不动产权电子证书”ZZHM是String证照号码CYRMC是String权利人名称CYRSFZJLX是String持有人身份证件类型（10|身份证,11|军官证,12|士兵证,13|警官证,14|港澳居民来往内地通行证,15|台湾居民来往大陆通行证,16|香港

12、身份证,17|澳门身份证,18|台湾身份证,20|护照,40|其他有效个人身份证件,50|组织机构代码证,51|营业执照,52|事业单位登记证书,53|社团登记证书,54|民办非企业单位登记证书,55|工会法人资格证书,60|税务登记证,70|统一社会信用代码,80|其他有效机构身份证件）CYRSFZJHM是String持有人身份证件号码FZJGMC是String发证机构名称FZJGZZJGDM是String发证机构唯一标识FZJGSSXZQHDM是String发证机构所属行政区划代码FZRQ是String发证日期(yyyy-mm-dd)YXQJSRQ否String有效期结束日期ZZHM1是S

13、tring证照号码（字）ZZHM2是String证照号码（年份）ZZHM3是String证照号码（地区简称）ZZHM4是String证照号码（号）GYQK是String共有情况BDCDYH是String不动产单元号QLLX是String权利类型QLXZ是String权利性质YT是String用途MJ是String面积SYQX是String使用期限QLQTZK是String权利其他状况FJ否String附记ZL是String坐落EWM1否Object链接产权的限制状态信息（如抵押、查封等信息，需要各地在互联网发布服务，确保扫二维码后能查到信息），参考二维码数据结构表EWM2否Object链接图形

14、信息（宗地图、分层分户图，需要各地在互联网发布服务，确保扫二维码后能查到信息），参考二维码数据结构表二维码数据结构表：参数名必选类型范围说明file_suffix是String文件格式(如：.jpg) file_data是String二维码文件数据 4.1.5 请求示例电子证明：POST 7:9010/electLicense/createAccreditationDataContent-Type: application/json"data": "data_fields": "QT": "

15、;不动产登记电子证明","FJ": "","FZJGSSXZQHDM": "440103","CYRMC": "张三","FZJGMC": "测试机构","ZZHM": "1212199","BDCDYH": "quot;,"ZZHM3": "2019","ZMQLHSX

16、": "9527","ZZHM4": "广州市","FZRQ": "2018-12-12","ZZHM1": "张三","ZL": "苦境中州","CYRSFZJHM": "44058*","ZZHM2": "粤","YWR": "李四","FZJGZZJGDM": &

17、quot;006939932","YXQJSRQ": "2019-12-12","ZZMC": "不动产登记电子证明","CYRSFZJLX": "10","operator": "division": "广州市","role": "市计生局 xx 科室科员","identity_num": "440583*","na

18、me": "张三","account": "gz_rjj ","service_org": "市计生局","division_code": "440100","service_name": "不动产登记电子证明生成","service_code": "07120021","biz_num": "业务流水号","seal

19、_code": "DZYZ006939932itWTQB","license_group": "组别1","terminal_info": "7","item_code":"100006501440000"电子证书：POST 7:9010/electLicense/createAccreditationDataContent-Type: application/json "da

20、ta": "service_code": "07120011", "service_name": "不动产登记电子证书生成", "biz_num": "201702200084", "license_group": "组别1", "seal_code": "DZYZ006939932itWTQB", "data_fields": "ZZMC": &

21、quot;不动产权电子证书", "ZZHM": "粤（2017）肇庆市高要区不动产权第0001994号", "CYRSFZJLX": "10", "CYRSFZJHM": "quot;, "FZJGMC": "肇庆市高要区不动产登记中心", "FZJGZZJGDM": "006939932", "YXQJSRQ": ""

22、, "FZRQ": "2019-01-08", "ZZHM1": "粤", "ZZHM2": "2017", "ZZHM3": "肇庆高要", "ZZHM4": "0001994", "CYRMC": "王大宝", "GYQK": "单独所有", "ZL": "肇庆市高要区南岸湖西一路9号

23、美汇园C幢505房", "BDCDYH": "441283001202GB99807F00030024", "QLLX": "国有建设用地使用权/房屋所有权", "QLXZ": "出让 / 市场化商品房", "YT": "城镇住宅用地 / 住宅", "MJ": "宗地面积 13367.5 / 房屋建筑面积 108.16", "SYQX": "国有建设用地使用

24、权 r2010年09月28日 起 2080年09月27日 止", "QLQTZK": "1、土地使用权面积：25.37 （其中分摊土地面积：25.37）r2、房屋结构： 钢筋混凝土结构r3、建筑面积： 108.16 （其中专有建筑面积： 92.99 ；分摊建筑面积：15.17）r4、总层数： 11层,所在层：5层r5、竣工时间： 2015-05-01", "FJ": "", "FZJGSSXZQHDM": "441283", "EWM1": &q

25、uot;file_suffix":".jpg","file_data":"/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRofHh0aHBwgJC4nICIsIxwcKDcpLDAxNDQ0Hyc5PTgyPC4zNDL/*" , "EWM2": "file_suffix":".jpg","file_data":"/9j/4AAQSkZJRgAB

26、AQEAYABgAAD/2wBDAAgGBgcGBQgHBwcJCQgK *" , "operator": "account": "gd_gtt_bdc", "name": "工作人员", "identity_num": "", "role": "受理", "service_org": "肇庆市高要区不动产登记中心", "division": &q

27、uot;肇庆高要", "division_code": "441283" , "terminal_info": "7", "item_code":"100092401440000"4.1.6 返回示例 "data": "license_code": "4400002019000000YH", "auth_code": "20190107103432473

28、AA0216280" , "response_id": "f659004f-c3f1-4138-9c07-82d22d45c5df", "ack_code": "SUCCESS", "correlation_id": "e6b7b361-c167-4412-9ee9-dceee04faba5", "errors": , "timestamp": null说明：license_code：电子证照标识码；auth_code：电子证

29、照查验码。4.2 签发一张证照4.2.1 方法说明正式签发一张电子证照4.2.2 请求方法POST4.2.3 URL地址API_ROOT/electLicense/signALicense4.2.4 请求参数参数名必选类型范围说明terminal_info是String发起查询的ip，如经过多个服务，则填写源头ipitem_code是String电子证照实施码license_code是String电子证照标识码id_code_是String证照号码service _code是String事项编码service _name是String事项名称biz_num否String对应办件的业务流水号op

30、erator是Object签发操作人信息4.2.5 请求示例POST 7:9010/electLicense/signALicenseContent-Type: application/json"terminal_info":"7","item_code":"100006501440000","data":"license_code":"440000*","id_code":&

31、quot;1212199","service_code":"07120021","service_name":"不动产登记电子证明生成","biz_num":"业务流水号","operator": "account":"gz_rjj ","name":"张三","identity_num":"quot

32、;,"role":"市计生局 xx 科室科员","service_org":"市计生局","division":"广州市","division_code":"440100" 4.2.6 返回示例 "data": null, "response_id": "bd5ee414-d0c6-41ab-a06d-9cec82f6845b", "ack_code": &

33、quot;SUCCESS", "correlation_id": "9d654171-62e9-4f01-a8e7-78171ab6bb2a", "errors": , "timestamp": null4.3 注销一张证照4.3.1 方法说明注销一张电子证照4.3.2 请求方法POST4.3.3 URL地址API_ROOT/electLicense/cancelALicense4.3.4 请求参数参数名必选类型范围说明terminal_info是String发起查询的ip，如经过多个服务，则填写源头ip

34、item_code是String电子证照实施码license_code是String电子证照标识码id_code是String证照号码service _code是String事项编码service _name是String事项名称biz_num否String对应办件的业务流水号operator是Object注销操作人信息4.3.5 请求示例POST http:/ 7:9010/electLicense/cancelALicenseContent-Type: application/json"terminal_info":"172.16.10

35、5.37","item_code":"100006501440000","data":"license_code":"4400002019000000SH","service_code":"07120022","service_name":"不动产登记电子证明注销","biz_num":"业务流水号号","operator": "acco

36、unt":"gz_rjj ","name":"张三","identity_num":"quot;,"role":"市计生局 xx 科室科员","service_org":"市计生局","division":"广州市","division_code":"440100"4.3.6 返回示例 "d

37、ata": null, "response_id": "4b2051bb-6d44-4800-be68-ce519c77541e", "ack_code": "SUCCESS", "correlation_id": "67e2407d-b6fe-429c-a768-3f9f8f440928", "errors": , "timestamp": null4.4 依职能查验用证4.4.1 方法说明依职能查验用证。根据事项编码以及办

38、事人身份证件号，列举出该办事人在该事项所需要使用的证照，同时对结果清单每一项生成用证码。该接口主要在部门业务审批办理系统使用。4.4.2 请求方法POST4.4.3 URL地址API_ROOT/electLicense/checkAuth4.4.4 请求参数参数名必选类型范围说明terminal_info是String发起查询的源头ipservice_item_code是String事项编码service_item_name是String事项名称service_item_org是String事项所属单位biz_num否String对应办件的业务流水号operator是Object发起此次用证的

39、业务人员信息。用于记录审计日志。page_index否Integer返回第几页数据。默认值 1page_size否Integer返回数据的每页大小。默认值 10，最大值150identity_number是String证件号码。 多个时用逗号（,）分隔identity_type是String证件类型。 多个时用逗号（,）分隔4.4.5 请求示例POST 7:9010/electLicense/checkAuthContent-Type: application/json"terminal_info":"7

40、","service_item_code":"07120021","service_item_name":"不动产登记电子证明生成","service_item_org":"广东省国土资源厅","biz_num":"业务流水号","operator": "account":"js_abc ","name":"张三","

41、identity_num":"quot;,"role":"省计生局 xx 科室科员","service_org":"市计生局","division":"广州市","division_code":"440100","identity_number":"440583*","identity_type":"10&qu

42、ot;4.4.6 返回示例 "auth_codes": "20190107172422539NC0272577_4400002019000000YE" , "data": "creation_time": "2019-01-07 10:03:38", "public_key": null, "begin_date": null, "trust_level": "A", "remark": null

43、, "doc_keyword": null, "s_sign_cert": null, "issuer": null, "division": "", "abolisher": null, "holder_identity_type": "10", "issue_org_code": "006939932", "issue_date": "2018-12-12 00:

44、00:00", "attachment_fields": null, "last_modificator": "*SYSADM*", "doc_name": null, "holder_identity_num": "quot;, "data_fields": null, "license_item_code": "100006501", "algorithm"

45、;: null, "holder_name": "张三", "division_code": "440103", "creator": null, "abolish_reason": null, "doc_summary": null, "license_type": null, "expiry_date": "2019-12-12 00:00:00", "abolish_time&qu

46、ot;: null, "biz_num": null, "id_code": "1212131", "license_status": "ISSUED", "issue_org_name": "测试机构", "extend_props": null, "s_sign_data": null, "name": "不动产登记电子证明", "correlative_lice

47、nse": null, "issue_time": null, "license_code": "4400002019000000YE", "last_modification_time": "2019-01-07 15:58:18" , "response_id": "d8f531ff-0a01-4c78-b90d-fefa56d9ae61", "total_count": 2, "ack_code":

48、"SUCCESS", "correlation_id": "d3797313-4128-45c3-b1ee-1e9f76ccf566", "errors": , "timestamp": null4.5 归档电子文件4.5.1 方法说明依职能查验用证。根据事项编码以及办事人身份证件号，列举出该办事人在该事项所需要使用的证照，同时对结果清单每一项生成用证码。该接口主要在部门业务审批办理系统使用。4.5.2 请求方法POST4.5.3 URL地址API_ROOT/electLicense/archi

49、veElectDoc4.5.4 请求参数参数名必选类型范围说明auth_code是String电子证照用证码file_type否String电子文件类型，默认为 PDF。4.5.5 请求示例POST 7:9010/electLicense/archiveElectDocContent-Type: application/textauth_code=*&file_type=*4.5.6 返回示例"ack_code":"SUCCESS","errors":,"data":&q

50、uot; file_name ":" 44000016D000020.pdf"," file_data ":"BDAAUDBAQE/Z", "response_id": "18f8ad0c-4905-4b12-9f39-842d05227800", "sign": null, "sign_method": null, "ack_code": "SUCCESS", "correlation_id&q

51、uot;: "f6729363-c51b-4fe8-b175-a8195fdd32be", "errors": , "timestamp": null4.6 制作签发一张证照4.6.1 方法说明根据提交证照数据生成制证签发证照。本接口集成了3.1和3.2的功能，可根据需要选择使用。4.6.2 请求方法POST4.6.3 URL地址API_ROOT/electLicense/issueALicense4.6.4 请求参数参数同本文档4.1接口创建制证数据接口，制证签发一步完成。4.6.5 请求示例POST http:/172.16.10

52、5.37:9010/electLicense/issueALicenseContent-Type: application/json"data": "data_fields": "QT": "不动产登记电子证明","FJ": "","FZJGSSXZQHDM": "440103","CYRMC": "张三","FZJGMC": "测试机构","ZZ

53、HM": "1212199","BDCDYH": "quot;,"ZZHM3": "2019","ZMQLHSX": "9527","ZZHM4": "广州市","FZRQ": "2018-12-12","ZZHM1": "张三","ZL": "苦境中州",&q

54、uot;CYRSFZJHM": "44058*","ZZHM2": "粤","YWR": "李四","FZJGZZJGDM": "006939932","YXQJSRQ": "2019-12-12","ZZMC": "不动产登记电子证明","CYRSFZJLX": "10","operator": "

55、;division": "广州市","role": "市计生局 xx 科室科员","identity_num": "440583*","name": "张三","account": "gz_rjj ","service_org": "市计生局","division_code": "440100","service_na

56、me": "不动产登记电子证明生成","service_code": "07120021","biz_num": "业务流水号","seal_code": "DZYZ006939932EgUnGE","license_group": "组别1","terminal_info": "7","item_code":"1

57、00006501440000"4.6.6 返回示例 "data": "license_code": "4400002019000001BU", "auth_code": "20190108093512290AA0227033" , "response_id": "fcb47611-50db-40d1-a0da-db6b4a563f18", "ack_code": "SUCCESS", "corre

58、lation_id": null, "errors": , "timestamp": null4.7 变更一张证照4.7.1 方法说明变更一张证照4.7.2 请求方法POST4.7.3 URL地址API_ROOT/electLicense/changeALicense4.7.4 请求参数参数名必选类型范围说明license_code是String原电子证照标识码，已签发的证照才能生效id_code是String原证照号码data_fields是Object变更后的证照数据内容,同4.1接口的制证数据标准，ZZHM与原ZZHM需对应operato

59、r是Object变更操作人信息service _code是String事项编码service _name是String事项名称biz_num否String对应办件的业务流水号seal_code是String印章编码(支持多个，以逗号隔开)license_group是String照面模版组别名称(支持多个，以逗号隔开)terminal_info是String发起查询的ip，如经过多个服务，则填写源头ipitem_code是String实施目录码attachments否List<Attachment>证照附件信息4.7.5 请求示例变更电子证明:POST http:/172.16.10

60、5.37:9010/electLicense/changeALicenseContent-Type: application/json"data": "license_code":"4400002019000001XH","data_fields": "QT": "不动产登记电子证明","FJ": "","FZJGSSXZQHDM": "440103","CYRMC": &qu

61、ot;李四","FZJGMC": "广东省国土资源厅","ZZHM": "1212131","BDCDYH": "quot;,"ZZHM3": "2019","ZMQLHSX": "9527","ZZHM4": "广州市","FZRQ": "2018-12-12","ZZ

62、HM1": "张三","ZL": "苦境中州","CYRSFZJHM": "quot;,"ZZHM2": "粤","YWR": "李四","FZJGZZJGDM": "006939932","YXQJSRQ": "2019-12-12","ZZMC": "不动产登记电子证

63、明","CYRSFZJLX": "10","operator": "division": "广州市","role": "市计生局 xx 科室科员","identity_num": "quot;,"name": "张三","account": "gz_rjj ","service_org&qu

64、ot;: "市计生局","division_code": "440100","service_name": "不动产登记电子证明生成","service_code": "07120021","biz_num": "业务流水号","seal_code": "DZYZ006939932itWTQB","license_group": "组别1"

65、;,"terminal_info": "7", "item_code":"100006501440000"变更电子证书：POST 7:9010/electLicense/changeALicenseContent-Type: application/json"data": "license_code":"44000020190000024T","data_fields": &q

66、uot;ZZMC": "不动产权电子证书", "ZZHM": "粤（2017）肇庆市高要区不动产权第0001996号", "CYRSFZJLX": "10", "CYRSFZJHM": "quot;, "FZJGMC": "肇庆市高要区不动产登记中心", "FZJGZZJGDM": "006939932", "YXQJSRQ": "", "FZRQ": "2019-01-08", "ZZHM1": "粤", "ZZHM2": "2017", "ZZHM3": "肇庆高要", "ZZHM4": "0001994", "CYRMC": "王测试", "GYQK": "共同所有",