不动产登记电子证照接口调用技术导则-地方标准.docx
ICS35.240CCSL6711B37山东省地方标准DB37TXXXX-2021不动产登记电子证照接口调用技术导则Technicaldirectivesforinterfacecallofrealestateregistrationelectroniccertificate2023 -XX-XX 发布20XX-XX-XX实施山东省市场监督管理局发布目次前言II1范围12规范性引用文件13术语和定义14符号和缩略语25调用流程26电子证照接口37数据安全4附录A(资料性)接口调用申请表5附录B(资料性)不动产登记电子证照接口信息71.1 1证照制证71.2 证照更新91.3 证照签发101.4 证照注销111.5 证照下载121.6 证照核对20参考文献23本文件按照GB/T1.1-2020标准化工作导则第1部分:标准化文件的结构和起草规则的规定起草。本文件的某些内容可能涉及专利,发布机构不承担识别专利的责任。本文件由山东省自然资源厅(山东省林业局)提出并组织实施。本文件由山东省自然资源标准化技术委员会归口。不动产登记电子证照接口调用技术导则1范围本文件规定了山东省不动产登记电子证照接口调用流程、电子证照接口信息及数据安全要求等内容。本文件适用于山东省各市县不动产登记机构的登记系统与山东省不动产登记电子证照系统对接。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T22239-2019信息安全技术网络安全等级保护基本要求GB/T397862021信息安全技术信息系统密码应用基本要求3术语和定义下列术语和定义适用于本文件。?1证照certificate由机关、团体、企事业单位颁发的、能证明资格或权利等的凭证类证类文件。注:证照包括证件和执照等。来源:GB/T369012018,3.1a,电子证照electroniccertificate由计算机等电子设备形成、传输和存储的证照数据文件。来源:GB/T369012018,3.3电子证照文件electroniccertificatefile以版式文档表示的电子证照,该文件既包含照面固定版式效果,又包含证照元数据及标识,并应用密码技术保障这些内容的真实性和完整性。来源:GB/T369012018,3.4电子证照原件electroniccertificateoriginalfile由证照颁发机构或其授权机构签署生成的电子证照文件。来源:GB/T369012018,3.5电子证照加注件electroniccertificatecopyfile为办理相关事项,在电子证照原件基础上附加用途、有效期限等声明信息并由制作人签署而产生的电子证照文件。来源:GB/T369012018,3.6不动产权证书reaIestatepropertycertificate由不动产登记机构颁发的、记载权利人对一个不动产单元拥有一种或者互相兼容的一-组权利的证明。来源:ZWFWC02032020,3.24符号和缩略语下列缩略语适用于本文件。HTTPS:超文本安全传送协议(HypertextTransferProtocolSecure)JSON:一种轻量级的数据交换格式(JavaScriptObjectNotation)OFD:开放版式文档(OpenFixed-layoutDocument)PDF:可移植文档格式(POrtableDocumentFormat)5调用流程51省级电子证照接口包括但不限于电子证照制证接口、证照更新接口、证照签发接口、证照注销接口、证照下载接口、证照核对接口等。45市县登记机构在登簿环节调用电子证照制证接口生成电子证照模板,模板生成后调用证照签发接口完成电子签章。勺1需补、换不动产权电子证照时,调用证照注销接口注销原电子证照。耳4电子证照内容发生变更时,调用电子证照更新接口。KK需核对电子证照真伪时,调用电子证照核对接口。接口调用申请表见附录A,电子证照接口调用流程如图U"市县级不动产矍记机构M,铲部门图1电子证照接口调用流程图6电子证照接口不动产登记电子证照接口实现证照制证、证照更新、证照签发、证照注销、证照下载和证照核对等功能,电子证照接口目录见表1。接口方式、请求方法、请求参数、返回结果、接口示例等信息见附录B。表1电子证照接口目录序号接口名称接11描述1证照制证生成未加盖电子签章的OFD格式不动产登记电子证照文件。2证照更新更新己制证的OFD格式不动产登记电子证照文件。表1电子证照接口目录(续)序号接口名称接口描述3证照签发签发不动产登记电子证照文件,实现电子证照文件签章。该接口返回完整版OFD电子证照文件,可统一存储在全省电子证照数据库中,若市县需要本地存储,本地电子证照库应及时增加、更新和注销。4证照注销注销已生成的不动产登记电子证照。5证照下载通过证照标识获取下载地址:根据电子证照标识、事由、有效期等信息生成电子证照加注件并返回下载地址,下载文件格式为OFD。6通过证照标识获取下载OFD证照文件。7通过证照标识获取证照信息。8根据提供的电子证照原件或加注件,验证电子证照文件真实性、完整性及有效性。9通过证照持有主体代码获取证照信息。10证照核对查询特定人员或证书相关联的不动产登记信息,用于省市县电子证照数据核对校验及全省不动产登记信息精准核查。7数据安全不动产登记电子证照相关接口数据安全应遵循GB/T222392019、GB/T397862021的要求并满足但不限于:a)数据加密:采用符合相关要求的国密算法对重要数据进行加密,密钥由省级不动产登记业务主管部门统一生成;b)数据保护:通过接口调用获得的信息仅可用于生成不动产登记电子证照,不应以任何形式提供给第三方,也不应用于任何其他目的;c)数据备份与恢复:1)应具备重要数据实时备份与恢复功能;2)备份机制应完整有效,具备异地备份功能且对备份数据进行保护。附录A(资料性)接口调用申请表接口调用申请表见表A.1。表A.1接口调用申请表部门登记系统基本信息部门名称系统名称系统简要说明系统访问地址系统运行网络联系人信息业务联系人业务联系人电话技术联系人技术联系人电话经办人(签字):申请接入单位(盖章):附录B(资料性)不动产登记电子证照接口信息B.1证照制证B.1.1接口方式该接口采用UTTPS+JS0N的接口方式。B.1.2请求方法该接口请求方法为POST请求。B.1.3请求参数电子证照制证接口请求参数见表B.l,表B.1电子证照制证接口请求参数参数名称类型描述信息channelIdString机构ID,各市县不动产登记机构的唯一标识,由省级不动产登记业务主管部门电子证照系统生成dataString加密数据包B.1.4返回结果电子证照制证接口返回结果见表B.2o表B.2电子证照制证接口返回结果参数名称类型描述信息messageString返回结果说明errorint错误码;0.成功;T失败data,certidentifierString电子证照唯一标识,其值遵循GB/T369042018B1.5接口示例"channelId":"渠道ID*,"data":“orgld":“证照颁发机构的统一社会信用代码”,“timestamp":"访问本接口时间戳(10位数字)”,"CertTypeCode":"证照类型代码”,"ownersfzhm":"所属者/法人的身份证号码”,"facelmg":"证照头像,base64格式”,info:t“qxd:"行政区划代码”,"ywh":"办件业务号”,"zzhmz":"证照号码(字)”,"zzhmnfT”证照号码(年份)","zzhmdqjc":"证照号码(市县全称)”,"zzhmh":"证照号码(号)","zzr":"制证人”,"sjlx":"数据类型","sxdm":"关联事项代码”,"djkdm":"登记类型代码”,"qllxdm":"权利类型代码”,"qlxzdm":"权利性质代码”,"gyJ共有人(多个以分隔)”,“gyrzjh":"共有人证件号(多个以“八"分隔)”,"gybl":"共有比例(多个以分隔)”,“yqlrgx":"与权利人关系","fbczbs":"分别持证标识”,"ytdm":"用途代码”,"dymj":"不动产单元面积”,*mjdw*:"面积单位",*mjdwdm*:"面积单位代码”,“ftmcl":"附图名称1”,“ftmc2":"附图名称2”,"ftmc3":"附图名称3”,ftjzd(":"界址点1经度”,"wd":"界址点1纬度”,(":"界址点2经度”,"wd":"界址点2纬度”),"certno":"不动产权证书号”,"yzbh":"编号(省级不动产登记业务主管部门生成,赋值)”,“qlrmc":"权利人名称(多个以分隔)”,“qlrzjhn:“权利人证件号码(多个以分隔)”,"qlrzjlx":"权利人证件类型(多个以分隔)","gyqk":"共有情况”,"zl":"坐落","bdcdyh":"不动产单元号”,"qllx":"权利类型(照面值,名称按照国标匹配)”,"qlxz"权利性质(照面值,名称按照国标匹配)”,"yt":"用途(照面值)","mj":"面积(照面值)”,“qlqtzk":"权利其他状况(多行情况下,使用换行符'&#XOoOA;'换行”,"门":"附记(多行情况下,使用换行符'&#XoOoA;'换行)”,""1":"附图05664编码值)”,"ft2":"附图(base64编码值)”,"ft3":"附图(base64编码值)”,"zzbfrq":"证照颁发日期”,"zzyxqqsrq":"使用期限起“,)"zzyxqjzrq":"使用期限止“B.2证照更新B.2.1接口方式该接口采用HTTS+JS0N的接口方式。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.失败8. 2.5接口示例请求参数(“orgld":"jnsbdcdjzx”,“timestamp":"1569748316”,"certldentifier*1.2.156.3005.2.11100000000013338W002.1132048201413*,“info":不动产电子证书JSON数据或不动产电子证明JSON数据返回结果(“message":"成功","error":0B.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.成功;-L失败data,certidentifierString电子证照唯一标识,其值遵循GB/T369042018data,dataString己经签章的base64编码OFD文件B.3.5接口示例请求参数(orgld:Jnsbdcdjzx,*timestamp*/1569748316”,"qfr":"张三",*certldentifier*1.2.156.3005.2.11100000000013338W002.1132048201413*,"yzh":"印章编号"返回结果("message":"成功",“error”:。,"data":*certidentifier*1.2.156.3005.2.11100000000013338W002.11320482014*,"data":"已经签章的base64编码OFD文件”)B.4证照注销B.4.1接口方式该接口采用HTTS+JSON的接口方式。B.4.2请求方法该接口请求方法为POST请求。B.4.3请求参数电子证照注销接口请求参数见表B.7o表B.7电子证照注销接口请求参数参数名称类型描述信息ChannelIdString机构D,各市县不动产登记机构的唯标识,由省级不动产登记业务主管部门电子证照系统生成dataString加密数据包B.4.4返回结果电子证照注销接口返回结果见表B.8o表B.8电子证照注销接口返回结果参数名称类型描述信息messageString返回结果说明errorint错误码;0.成功;T.失败8. 4.5接口示例请求参数(“orgld":"jnsbdcdjzx”,“timestamp":"1569748316”,ZZr:张二,*certldentifier*1.2.156.3005.2.11100000000013338W002.1132048201413*z,返回结果(“message":"成功","error":0B.5证照下载B.5.1证照标识获取下载地址B.5.1.1接口方式该接口采用HTTPS+JSON的接口方式。B.5.1.2请求方法该接口请求方法为POST请求。B.5.1.3请求参数电子证照标识获取下载地址接口请求参数见表B.9。表B.9电子证照标识获取下载地址接口请求参数参数名称类型必填描述信息head.accessldString是访问标识,由省级不动产登记业务主管部门电子证照系统生成并告知各接口调用单位head.accessTokenString是应用认证信息,由省级不动产登记业务主管部门电子证照系统生成并告知各接II调用单位授权码(机构ID)head.accessUserString是请求查询人员head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等data.useCauseString是申请事由,不超过200字data.expiryTimeString是电子证照加注件有效期截止时间YYYY-删-DDdata.UseScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等B.5.1.4返回结果电子证照标识获取下载地址接口返问结果见表B.10.表BJO电子证照标识获取下载地址接口返回结果参数名称类型描述信息head,statusint错误码;0.成功;其他.失败head,messageString返回结果说明data.ContentTypeString编码类型为base64data,certidentifierString电子证照标识,其值遵循GB/T369042018data.contentString证件文件下载地址,下载后的文件是符合GB/T36904-2018的要求B.5.1.5接口示例请求参数("head":*accessld*JappId”,*accessToken*G19kClWo8GVl*,HI.*Jl/»«"accessUser:张二,*accessMode*:"40”),"data":"certidentifier":"L2.156.3005.2.*,“C2H«*UseScenario:10,"useCause":"事由*","expiryTime":"过期时间*")返回结果("head":“status”:。,"message":"接口调用成功”,"data"04D4FB95943B9E0419390A37B48A6F2805F9091)8. 5.2证照标识获取下载OFD证照文件9. 5.2.1接口方式该接口采用HTTS+JSON的接口方式。10. 5.2.2请求方法该接口请求方法为POST请求。B.5.2.3请求参数电子证照标识获取下载OFD证照文件接口请求参数见表B.Ilo表B.11电子证照标识获取下载OFD证照文件接口请求参数参数名称类型必填描述信息head,accessldString是访问标识,由省级不动产登记业务主管部门电子证照系统生成并告知各接口调用单位head.accessTokenString是应用认证信息,由省级不动产登记业务主管部门电子证照系统生成并告知各接口调用单位授权码机构IDhead.accessUserString是请求查询人员head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等data.useCauseString是申请事由,不超过200字data.expiryTimeString是电子证照加注件有效期截止时间YYYY-MM-DDdata.UseScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等B.5.2.4返回结果电子证照标识获取下载PDF证照文件接口返回结果见表B.12o表B.12电子证照标识获取下载OFD证照文件接口返回结果参数名称类型描述信息head,statusint错误码:0成功;其他.失败ad.messageString返回结果说明dataStringbase64编码的证照文件内容(OFD格式)B.5.2.5接口示例/请求参数(“head":“accessld":"appld”,“accessToken”:*G19kClWo8GVI*“accessUser":"张三",*accessMode*:"40","data":"certIdCntifier":"1.2.156.3005.2.*,UseScenario:10,"useCause":"事由*","expiryTimc":"过期时间*返回结果“status”:。,"message":"接口调用成功”),"data"04D4FB95943B9E041939037B486F2805F9091”)B.5.3证照标识获取证照信息B.5.3.1接口方式该接口采用HTTS+JSON的接口方式。B.5.3.2请求方法该接口请求方法为POST请求。B.5.3.3请求参数电子证照标识获取证照信息接口请求参数见表B.13o表B.13电子证照标识获取下证照信息接口请求参数参数名称类型必填描述信息head,accessldString是访问标识,由省级不动产登记业务主管部门电子证照系统生成并告知各接口调用单位head.accessTokenString是应用认证信息,由省级不动产登记业务主管部门电子证照系统生成并告知各接口调用单位head.accessUserString是请求查询人员head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等data.certidentifierString是电子证照标识,其值应符合GB/T36904-2018的要求data.useCauseString是申请事由,不超过200字data.UseScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等B.5.3.4返回结果电子证照标识获取证照信息接口返回结果见表BJ4。表B.14电子证照标识获取下证照信息接口返回结果参数名称类型描述信息head,statusint错误码;0.成功;其他.失败head,messageString返回结果说明参数名称类型描述信息data.CertDataString加密后的电子证照照面信息8. 5.3.5接口示例请求参数("head":*accessld*:“appld”,*accessToken*:*356YD07xXyb08mlbrTdk7UuFrMoLtzZx0BBtg=z,“accessUser":"张三",*accessMode*:"40”,*data*:"certidentifier":"1.2.156.3005.2.1110000137D001.xxxx.xxx.xx.x”,UseScenario:10,"useCause":"事由*")返回结果“head":“status”:。,"message":"接口调用成功”,*data*:*certData*:*04D4FB95943B9E0419390A37B48A6F2805F9091”B.5.4证照文件有效性验证B.5.4.1接口方式该接口采用UTTPS+JSON的接口方式。B.5.4.2请求方法该接口请求方法为POST请求。B.5.4.3请求参数电子证照文件有效性验证接口请求参数见表BJ5。表B.15电子证照文件有效性验证接口请求参数参数名称类型必填描述信息head,accessldString是访问标识,由省级不动产登记业务主管部门电子证照系统生成并告知各接【I调用单位head.accessTokenString是应用认证信息,由省级不动产登记业务主管部门电子证照系统生成并告知各接口调用单位表B.15电子证照文件有效性验证接口请求参数(续)参数名称类型必填描述信息head.accessUserString是请求查询人员head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等data.CertTypeCodeString是证照类型代码data.ContentTypeString是编码类型为base64data,contentString是Base64字符串,解码后的内容应符合GB/T369052018的要求data.useCauseString是申请事由,不超过200字data.UseScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等B.5.4.4返回结果电子证照文件有效性验证接口返回结果见表BJ6。表B.16电子证照文件有效性验证接口返回结果参数名称类型描述信息head,statusint错误码:0成功;其他.失败head,messageString返回结果说明data,resultString校验结果,返回0表示验证通过,其他值表示失败data,messageString校验结果说明,与校验结果代码对应的文字说明,如:“0”:“验证通过";T”:“签章校验失败“2”:“文件校验失败”;“3”:”证照未激活”;“4”:“证照暂时失效”;“5”:”证照已失效”B.5.4.5接口示例请求参数("head":accessld:apple,"acceSSTOkerr:"356YDO7xbO8mlbrTdk7Uuln.eU7EyJAAm8SxOBBtg=*accessUser*:“张三”,“accessMode":"40","data":*certTypeCode*:*11100000000013127D001*l*contentType*:*base64*,*content*:*base64内容”,*useScenario*:“10",*useCause*:"事由*")返回结果("head":“status”:。,"message":"接口调用成功”,"data”:*04D4IB95943B9E0419390A37B486F2805F9091”B.5.5证照持有主体代码获取证照信息B.5.5.1接口方式该接口采用HTTPS+JSON的接口方式。B.5.5.2请求方法该接口请求方法为POST请求。B.5.5.3请求参数电子证照持有主体代码获取证照信息接口请求参数见表B.17o表B.17电子证照持有主体代码获取证照信息接口请求参数参数名称类型必填描述信息head,accessIdString是访问标识,由省级不动产登记业务主管部门电子证照系统生成并告知各接口调用单位head.accessTokenString是应用认证信息,由省级不动产登记业务主管部门电子证照系统生成并告知各接Il调用单位head.accessUserString是请求查询人员head.accessModeString是查询方式,包括移动APP、微信号、PC网页、业务应用等data,hoIderCodeString是持证主体代码,如:身份证中的身份证号码data.KolderTypeCodeString是持证主体代码类型代码data.CertTypeCodeString是证照类型代码data.certNoString是证照编号参数名称类型必填描述信息data.UseCauseString是申请事由,不超过200字data.UseScenarioString是申请使用场景,包括移动APP、微信号、PC网页、业务应用等B.5.5.4返回结果电子证照持有主体代码获取证照信息接口返回结果见表B.18o表B.18电子证照持有主体代码获取证照信息接口返回结果参数名称类型描述信息head,statusint错误码:0.成功;其他.失败head,messageString返回结果说明data.CertDataString加密后的电子证照照面信息B.5.5.5接口示例请求参数"head":*accessld*:*appld*,*accessToken*356YD07xXyb08mlbrCD0cNV4GsJAA8Sx0BBtg=*,*accessUser*:“张三”,*accessMode*:"40”),"data":*holderCode*:"370452*248024”,*holderTypeCode*:*l11*.*certTypeCodez':"IIlOOOOOMBO3271699001”,"certNo”<T201202120001”,*useScenario*:*10*.*useCause*:"事由*)返回结果("head":“status”:。,*message*:"接口调用成功”,"data":*certData*:a,04D4FB95943B9E0419390A37B48A6F2805F9091”)B.6证照核对B.6.1接口方式该接口采用HTTPS+JSON的接口方式。B.6.2请求方法该接口请求方法为POST请求。B.6.3请求参数电子证照核对接口请求参数见表B.19。参数名称类型必填描述信息orgldString是固定值:403eea4b05b54b2b89a9d30d3f3227f8timestampLong是访问本接口时间戳(10位数字)paramList是查询条件,加密数据8. 6.4返回结果电子证照核对接口返回结果见表B.20o表B.20电子证照核对接口返回结果参数名称类型描述信息statusint状态码:0.成功;其他.失败messageString返回结果说明dataString加密后的查询结果数据9. 6.5接口示例请求参数("orgld":"403eea4b05b54b2b89a9d30d3f3227f8”,“timestamp":"",*param*:("taskID":"o23019kdka0odowkk",qlrmc:张二,*zjzrnr,*zjh*:"370452*248024”,“qszt"<”,("taskID"wu0238kd-203493*,“qlrmc":"李四",*zjzrll,"zjh":"370203*2281928”,qszt:1,("taskID""02389d82jklj3k40”,为(2了:”鲁(2018)*市不动产权第XXX7217号”,qszt:1),*taskID*02389d82jklj3k40*,*bdcdyh*37XXXX007000GB00067F00010196*,qszt:1返回结果'message":"成功",status*:0,data"加密后的结果数据”参考文献TJTJUIJ12345LLLLPLGB/T369012018GB/T369042018GB/T369052018ZWFWC02032020ZWFWC02042020电子证照总体技术架构电子证照标识规范电子证照文件技术要求全国一体化在线政务服务平台电子证照全国一体化在线政务服务平台电子证照不动产权证书不动产登记证明