附件3-全国工程质量安全监管信息平台电子证照数据交换接口规范-建筑施工起重机械使用登记证书（试运行）

附件3全国工程质量安全监管信息平台建筑起重机械使用登记证书电子证照数据交换接口规范（试运行）2023年08月文档修订历史序号版本修订日期修改记录11.02023-08全国工程质量安全监管信息平台电子证照数据交换接口规范-建筑起重机械使用登记证书（试运行）目录15262一、概述 —概述1.1、目的本文档是为全国工程质量安全监管信息平台与各省、自治区、直辖市、新疆生产建设兵团建筑起重机械使用登记证书电子证照系统进行数据共享提供统一对接标准，均按照此接口规范进行对接。1.2、参考资料《全国一体化政务服务平台电子证照建筑起重机械使用登记证书》1.3、基本术语1.3.1、资源请求方资源请求方是指需要调用服务API的对象，是数据需求方。1.3.2、资源提供方资源提供方是指拥有资源方对外提供资源数据的对象，是数据提供方。1.3.3、服务API服务API是资源提供方对外提供数据服务的实现形式之一。其是由信息资源共享交换平台基于RESTAPI技术实现。1.3.4、服务授权服务API只有在授权权限给相应的应用系统之后，资源请求方才能调用该服务API。1.4、参数类型说明C4：表示最多4位的字符型字符串，不足4位按实际位数；C..：表示可变长度的字符型字符串；N5：表示最多5位的数字型字符串，不足5位按实际位数；N..：表示可变长度的数字型字符串；Date：表示日期类型字符串。Text：表示大文本字符串。服务申请流程2.1、账号开设各省（直辖市、自治区、新疆生产建设兵团）通过住建部平台以数据接口形式上报电子证照数据，由各省（直辖市、自治区、新疆生产建设兵团）按要求填写申请表。部信息中心对接入申请进行审核，确认信息无误后予以批准，由部信息中心完成相关业务系统应用注册工作，并将应用标识（AppKey/client_id）和应用密钥（AppSecret/client_secret）等对接材料以邮件形式发放给各省（直辖市、自治区、新疆生产建设兵团）进行对接。服务调用流程请用户将该接口授权的应用key、应用密钥这两个值提供给应用开发商，应用开发商按照下面的步骤调用接口资源。3.1、步骤一、获取认证token共享平台提供基于OAuth2.0的统一身份鉴权方式。第三方应用通过申请令牌token，来完成对API的调用访问，各省份的应用标识client_id与client_secret会提前分发。其中对于所有访问用户隐私API的请求，需要提供用户授权令牌来校验该第三方调用是否是合法调用，而对于所有平台基础支撑API，需要提供客户端授权令牌来进行校验。关于OAuth2.0协议的详细介绍，可以参考W3C的官方文档。开发者可以先浏览OAuth2.0的接口文档，熟悉OAuth2的接口及参数的含义，然后我们根据用户授权认证和客户端授权认证2种场景各自说明如何使用OAuth2.0。表3-1接口信息接口地址（政务外网）http://**/epoint-soa-web/rest/oauth2/token请求方式POST参数格式请求参数Body类型：x-www-form-urlencoded接口说明获取token请求参数参数名数据类型是否必需说明client_idC...是应用标识client_secretC...是应用密码grant_typeC...是固定值：client_credentials请求参数示例返回结果参数参数名数据类型是否必需说明access_tokenC...是最终获取到的tokenrefresh_tokenC...是刷新token票据expires_inC...是token有效期返回结果示例正确示例：错误示例：{3.2、步骤二、上传资源数据根据得到的token,调用接口,上传数据。3.3、Java代码参考示例publicclassCallAPI{//客户端账号标识,请修正为实际值staticStringAppKey="eae5****-****-****-****-********58a7";//客户端账号密码,请修正为实际值staticStringAppSecret="d0c9****-****-****-****-********096c";//认证平台地址，具备token接口，只需要配置到认证平台应用系统名即可,请修正为实际值staticStringSSOUrl=":port/epoint-sso-web";//调用凭证，考虑凭证需要远程调用接口获取，需要静态化，不用每次调用重新获取staticAssertionTokenInfo;//生成调用凭证staticAssertiongetToken(booleanrefresh){//如果凭证已经生成且不需要强制更新的情况下，则只需要获取原有凭证即可，避免不必要的远程调用if(TokenInfo==null||refresh){//利用SDK方法获取调用凭证，传入客户端账号、密码和认证平台地址，采用的是客户端认证模式TokenInfo=AssertionUtil.getAssertionStateless(AppKey,AppSecret,SSOUrl);}returnTokenInfo;}//调用最终API方法publicstaticStringAPIInvoke(StringUrl,StringAccess_Token,Map<string,object="">Params){//实际需要调用的API的地址，将调用凭证token作为参数传入Url=Url+"?access_token="+Access_Token;//通过SDK的HttpClientUtil调用API，获得返回值Map<string,string="">headers=newHashMap<>();headers.put("Authorization","Bearer"+Access_Token);return(String)HttpClientUtil.post(Url,headers,Params,2);}publicstaticvoidmain(String[]args)throwsException{//实际API地址,请修正为实际值StringUrl=":port/rest/***";//调用API的参数,请修正为实际值Map<string,object="">Params=newHashMap<>();Params.put("服务器IP","");//考虑调用凭证缓存化，一定时间后调用凭证肯定会过期，当凭证过期时，引入重试机制，即凭证需要强制更新，并重新调用API接口//本示例重试最多3次，3次失败则不再继续重试。for(inti=0;i<3;i++){StringAccess_Token=getToken(i>0).getAccessToken();Stringresult=APIInvoke(Url,Access_Token,Params);If("1".equals(result)){break;}}}}此方法预期会出现3类异常情况，针对各类异常的信息和处置方法上述代码引用Jar包下载：表3-3异常解决方案"error='invalid_client',或description='非法的ClientID'"请检查AppKey值是否配置准确error='unauthorized_client',description='未验证通过的客户端身份'请检查AppSecret值是否配置准确mon.exception.OAuthSystemException:java.io.FileNotFoundException请检查AppKey值是否配置准确3.4、标准代码定义表3-4返回代码代码定义1上传成功（业务数据校验接口、电子证照文件归集接口、数据更正接口）上传成功，操作类型为01或02时返回二维码赋码（业务数据赋码接口）0上传失败，并返回具体错误原因500内部服务器错误赋码和二维码加解密4.1、赋码接口返回密文解密方法4.1.1、解密流程图图4-1-14.1.2、import引用引用如下：importjavax.crypto.Cipher;importjavax.crypto.spec.SecretKeySpec;importjavax.xml.bind.annotation.adapters.HexBinaryAdapter;importorg.apache.log4j.Logger;importcom.alibaba.fastjson.JSONObject;4.1.3、解密方法解密方法如下：/***解密**@paramencryCertid*加密后的证照的唯一标识*@paramencryKey*ras加密后的key*@paramprivateKeyString*私钥*/publicJSONObjectdecryption(StringencryCertid,StringencryKey,StringprivateKeyString){JSONObjectrtnObj=newJSONObject();try{//先将key进行ras解密StringdecryKey=RasDecrypt(encryKey,privateKeyString);//生成密钥对象,如果算法是DES，那么这个构造函数不会检查key是否为8个字节长SecretKeySpecsecretKeySpec=newSecretKeySpec(decryKey.getBytes(),"DES");//获取加解密实例Ciphercipher=Cipher.getInstance("DES/ECB/PKCS5Padding");//初始化解密模式cipher.init(Cipher.DECRYPT_MODE,secretKeySpec);//HexBinaryAdapter十六进制转换工具HexBinaryAdapterhexBinaryAdapter=newHexBinaryAdapter();//解密byte[]ecertidResult=cipher.doFinal(hexBinaryAdapter.unmarshal(encryCertid));//结果rtnObj.put("certid",newString(ecertidResult));rtnObj.put("decryKey",decryKey);}catch(Exceptione){logger.error(e.getMessage(),e);}returnrtnObj;}4.1.4、解密结果示例{"certid":"202232000001000001","decryKey":"12345678"}4.1.5、说明结果包含内容：certid：二维码赋码，通过“4.1.3解密方法”解密decryKey：8位数字，通过“4.1.3解密方法”解密以上解密方法需要的privateKeyString私钥参数值，由住房和城乡建设部全国工程质量安全监管信息平台技术支持单独提供。4.2、电子证照二维码明文加密方法4.2.1、加密流程图图4-2-14.2.2、import引用引用如下：importjavax.crypto.Cipher;importjavax.crypto.spec.SecretKeySpec;importjavax.xml.bind.annotation.adapters.HexBinaryAdapter;importorg.apache.log4j.Logger;importcom.alibaba.fastjson.JSONObject;4.2.3、加密方法加密方法如下：/***返回加密后的证照id密文和key*@paramcertid*证照的唯一标识ID赋码*@parampublicKeyString*公钥字符串（部里单独提供给省里）*@return*/publicJSONObjectencryption(Stringcertid,StringpublicKeyString){JSONObjectrtnObj=newJSONObject();try{//随机生成8个字符的字符串（以下key值只是示例，可以指定或者随机生成）Stringkey="12345678";//RandomStringUtils.randomAlphanumeric(8);//生成密钥对象,如果算法是DES，那么这个构造函数不会检查key是否为8个字节长SecretKeySpecsecretKeySpec=newSecretKeySpec(key.getBytes(),"DES");//获取加解密实例Ciphercipher=Cipher.getInstance("DES/ECB/PKCS5Padding");//初始化加密模式cipher.init(Cipher.ENCRYPT_MODE,secretKeySpec);//加密byte[]ecertidByte=cipher.doFinal(certid.getBytes());//HexBinaryAdapter十六进制转换工具,把byte数据转换成十六进制的字符串表示。HexBinaryAdapterhexBinaryAdapter=newHexBinaryAdapter();//返回的ID密文rtnObj.put("encryCertid",hexBinaryAdapter.marshal(ecertidByte));//将随机字符串用ras加密StringencryKey=RasEncrypt(key,publicKeyString);//返回的key密文rtnObj.put("encryKey",encryKey);}catch(Exceptione){logger.error(e.getMessage(),e);}returnrtnObj;}4.2.4、加密结果示例明文如下：密文如下：/fwmh/middlepage.html?ID=8B9704DDABA730072E5546FD5B8F61E4890FE52BAB2E71B8&k=XX8U+FFI3yRWEZ0UQ1qJxS+gsdth779BypvXY5MKfNRELdegoHfCoymJUNG4Q/rTco69eBZ1TYEK+rCNrCbVAg==&certype=11100000000013338W083&province=5100004.2.5、说明电子证照二维码包含内容：URL：二维码扫码查询提示页面，固定为：/fwmh/middlepage.htmlID：二维码赋码的密文，通过“4.2.3加密方法”加密k：8位随机密钥，通过“4.2.3加密方法”加密certype：电子证照类型代码。表4-2-5证照类型名称证照类型代码建筑起重机械使用登记证书11100000000013338W083province：固定值对接省份6位辖区代码以上加密方法需要的publicKeyString公钥参数值，由住房和城乡建设部全国工程质量安全监管信息平台技术支持单独提供。对接接口标准5.1、建筑起重机械使用登记证书根据业务场景提供建筑起重机械使用登记证书调用接口的详细说明，流程指南详见附录1。推送操作类型原证书状态推送的证书状态赋码调用接口顺序办理新发电子证照和既有电子证照后续业务场景办理新发电子证照/有效是①业务数据校验接口②业务数据赋码接口③相关人员信息接收接口④电子证照文件归集接口办理注销有效注销否①相关人员信息接收接口②证书状态变更接口办理注销失效注销否办理撤销有效撤销否①证书状态变更接口办理撤销失效撤销否办理失效有效失效否办理其他业务失效有效否5.1.1、业务数据校验接口使用场景说明：省级电子证照系统进行业务审批需要上报建筑起重机械使用登记证书业务数据时，提前对数据预校验，可以申请调用业务数据校验接口。表5-1-1接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_check请求方式POST返回方式JSON接口说明建筑起重机械使用登记证书业务数据校验接口；支持多条数据上传，单次上传上限10条。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注businessDataIdC36是业务数据ID，地方电子证照系统业务主键areaCodeC6是所属省、自治区、直辖市、市辖区行政区划代码，按照民政部官网《2020年中华人民共和国行政区划代码》deviceCategoryCodeC1是类别代码，使用登记证所对应的建筑起重机械的类别的代码，详见6.1-建筑起重机械类别代码表deviceModelC..200是规格型号,使用登记证所对应的建筑起重机械的规格型号factoryNumC..200是出厂编号，建筑起重机械所对应的唯一出厂编号manufactureCorpCodeC18是制造单位统一社会信用代码,建筑起重机械制造单位的统一社会信用代码operateTypeC2是操作类型，详见6.1-操作类型代码表和6.1-证书状态与操作类型关系代码表certNumC20满足条件必填证照编号，建筑起重机械使用登记证书的唯一编号，按照《全国一体化政务服务平台电子证照建筑起重机械使用登记证书》附录A.1编号规则生成，当操作类型是办理新发电子证照时，非必填，其他的操作类型要求必填请求参数示例{ "AcceptData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "areaCode":"110101", "deviceCategoryCode":"T", "deviceModel":"QTZ80(WA6010-6A)", "factoryNum":"1012T002124869", "manufactureCorpCode":"914300007121944054", "operateType":"10", "certNum":"110101T（2023）0000001" }]}返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.1-返回代码代码表ReturnMsgC..500是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据标识，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+businessDataIdC..50/业务数据ID，返回代码为1时需要+SuccessCodeC..50/成功码，返回代码为1时需要+SuccessMsgC..1000/成功信息，返回代码为1时需要WarnDataJSON/预警信息集合，返回代码为2时需要+WarnGuidC..50/预警数据标识，返回代码为2时需要+WarnCodeC..50/预警码，返回代码为2时需要+WarnMsgC..1000/预警信息，返回代码为2时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"业务数据校验成功", "ReturnData":{ "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-LEZ-XX", "SuccessMsg":"该国家标准电子证照业务数据校验成功" }] }}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"业务数据校验失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-02-LEZ-XX", "ErrorMsg":"该制造单位汉中市金志建筑机械安装租赁有限责任公司的起重机械设备（出厂编号：1012T002124868），已存在国家标准电子证照，发证地：北京市，证照编号：110101T（2023）*******！" }] }}③返回代码为2时的结果信息：{ "ReturnCode":"2", "ReturnMsg":"业务数据校验成功有预警", "ReturnData":{ "WarnData":[{ "WarnGuid":"73faca65c31a484b8f6b719c94******", "WarnCode":"E-02-LEZ-XX", "WarnMsg":"XXXX" }], "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-LEZ-XX", "SuccessMsg":"该国家标准电子证照业务数据校验成功" }] }}5.1.2、业务数据赋码接口使用场景说明：省级电子证照系统需要上报建筑起重机械使用登记证书业务数据进行归集并申请二维码赋码时，可以申请调用业务数据赋码接口。补充说明：当操作类型“办理新发电子证照”时，需要将设备基本信息作为业务信息参数进行上报。表5-1-2接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_fm请求方式POST返回方式JSON接口说明建筑起重机械使用登记证书业务数据赋码接口；支持多条数据上传，单次上传上限10条；操作类型为“办理新发电子证照”时会进行二维码赋码。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注businessDataIdC36是业务数据ID，地方电子证照系统业务主键areaCodeC6是所属省、自治区、直辖市、市辖区行政区划代码，按照民政部官网《2020年中华人民共和国行政区划代码》certNumC20是证照编号，建筑起重机械使用登记证书的唯一编号，按照《全国一体化政务服务平台电子证照建筑起重机械使用登记证书》附录A.1编号规则生成issuAuthNameC..200是发证机关，负责颁发和管理该建筑起重机械使用登记证书的县级及以上人民政府住房城乡建设主管部门名称issuAuthCodeC18是发证机关代码，证照颁发机关的统一社会信用代码issuDateDate是发证日期，该证照颁发的日期，按照公元纪年精确至日。用于照面展示时，用阿拉伯数字将年、月、日标全，月、日不标虚位deviceCategoryCodeC1是类别代码,使用登记证所对应的建筑起重机械的类别的代码，详见6.1-建筑起重机械类别代码表deviceModelC..200是规格型号,使用登记证所对应的建筑起重机械的规格型号factoryNumC..200是出厂编号,建筑起重机械所对应的唯一出厂编号recordNumC16是备案编号,由产权单位在建筑起重机械首次出租或安装前，向本单位工商注册所在地县级及以上地方人民政府建设主管部门办理的备案证明的编号manufactureCorpNameC..200是制造单位,建筑起重机械制造单位的名称manufactureCorpCodeC18是制造单位统一社会信用代码,建筑起重机械制造单位的统一社会信用代码propertyCorpNameC..200是产权单位,建筑起重机械出租单位或者自购建筑起重机械使用单位propertyCorpCodeC18是产权单位统一社会信用代码,建筑起重机械产权单位的统一社会信用代码projectNameC..200是工程名称,办理该建筑起重机械使用登记的建设工程的名称projectLocationC..200是工程项目地址,办理该建筑起重机械使用登记的建设工程所在的详细地址applyConstructionPermitC1是是否办理施工许可证,建筑起重机械使用登记的建设工程是否办理施工许可证constructionPermitNumC18满足条件必填建筑工程施工许可证编号,建筑起重机械使用登记的建设工程的施工许可证唯一标识码，已办理施工许可证时必填useCorpNameC..200是使用单位,建筑起重机械使用单位名称useCorpCodeC18是使用单位统一社会信用代码,建筑起重机械使用单位的统一社会信用代码maintenanceCorpNameC..200是维保单位,进行建筑起重机械维修保养单位的名称maintenanceCorpCodeC18是维保单位统一社会信用代码,建筑起重机械维保单位的统一社会信用代码useCorpManagerC..50是使用单位项目负责人,建筑施工起重机械使用单位的项目负责人useCorpManagerIdC..18是使用单位项目负责人身份证件号码,建筑施工起重机械使用单位的负责人有效身份证件号码installCorpNameC..200是安装单位,从事建筑起重机械安装活动的单位，安装单位应具有相关资质installCorpCodeC18是安装单位统一社会信用代码,建筑起重机械的安装单位的统一社会信用代码installDateDate是安装日期，建筑起重机械安装日期，按照公元纪年精确至日。用于照面展示时，用阿拉伯数字将年、月、日标全，月、日不标虚位installPositionC..20是安装位置，建筑起重机械安装的具体位置信息，用基于2000国家大地坐标系（CGCS2000）的经纬度坐标点表示，格式为“经度,纬度”,经纬度至少精确到小数点后第四位testCorpNameC..200是检测单位，进行建筑起重机械检测的单位名称testCorpCodeC18是检测单位统一社会信用代码，建筑起重机械检测单位的统一社会信用代码testDateDate是检测日期，建筑起重机械安装检测合格报告出具日期，按照公元纪年精确至日。用于照面展示时，用阿拉伯数字将年、月、日标全，月、日不标虚位certStatusC2是证书状态代码，详见6.1-证书状态类型代码表certStatusDescriptionC..200满足条件必填证书状态描述，证书状态为“其他”时进行的补充描述associatedCertIdC73满足条件必填关联证照标识，该证书关联的最近一个已失效建筑起重机械使用登记证书的标识，规则同表5-1-4中的“证照标识”businessInformationJSON是业务信息，按JSON串方式（第一个参数为持证主体或证照本身关联的业务类型，第二个参数为持证主体或证照本身涉及的业务信息）方式组织的对应业务类型代码的具体业务信息，参数类型详见6.1-设备基本信息业务类型代码表，需要上报设备基本信息operateTypeC2是操作类型，详见6.1-操作类型代码表和6.1-证书状态与操作类型关系代码表请求参数示例{ "AcceptData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "areaCode":"110101", "certNum":"110101T（2023）0000001", "issuAuthName":"北京市住房和城市建设委员会", "issuAuthCode":"11110000000021135M", "issuDate":"2023-05-25", "deviceCategoryCode":"T", "deviceModel":"QTZ80(WA6010-6A)", "factoryNum":"1012T002124869", "recordNum":"京AA-T-2111-03691", "manufactureCorpName":"中联重科股份有限公司", "manufactureCorpCode":"914300007121944054", "propertyCorpName":"汉中市金志建筑机械安装租赁有限责任公司", "propertyCorpCode":"9161070056714569XF", "projectName":"北京市建设工程项目", "projectLocation":"北京市北京市朝阳区建国路18号", "applyConstructionPermit":"1", "constructionPermitNum":, "useCorpName":"汉中市金志建筑机械安装租赁有限责任公司", "useCorpCode":"9161070056714569XF", "maintenanceCorpName":"中联重科股份有限公司", "maintenanceCorpCode":"914300007121944054", "useCorpManager":"张三", "useCorpManagerId":", "installCorpName":"中联重科股份有限公司", "installCorpCode":"914300007121944054", "installDate":"2023-04-25", "installPosition":"116.4937,39.9017", "testCorpName":"山东华宁设备检测有限公司", "testCorpCode":"91370100570499093L", "testDate":"2023-04-26", "certStatus":"01", "certStatusDescription":"有效", "associatedCertId":"005.2.11100000000013338W083.11110000000021135M.2023T0000001.001.G", "businessInformation":[{ "itemvalue":"1001", "itemtext":20 },{ "itemvalue":"1002", "itemtext":20 },{ "itemvalue":"1003", "itemtext":20 },{ "itemvalue":"1004", "itemtext":20 }], "operateType":"10" }]}返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.1-返回代码代码表ReturnMsgC..500是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据标识，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+businessDataIdC..50/业务数据ID，返回代码为1时需要+SuccessCodeC..50/成功码，返回代码为1时需要+encryKeyC..200/二维码赋码加密key，返回代码为1时需要+encryCertidC..200/二维码赋码加密ID，返回代码为1时需要+SuccessMsgC..1000/成功信息补充说明，返回代码为1时需要WarnDataJSON/预警信息集合，返回代码为2时需要+WarnGuidC..50/预警信息标识，返回代码为2时需要+WarnCodeC..50/预警码，返回代码为2时需要+WarnMsgC..1000/预警信息，返回代码为2时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"业务数据赋码成功", "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-03-LEZ-XX", "encryCertid":"EDBE76D9217A23212E5546FD5B8F61E4671575AD27******", "encryKey":"Th2MCBlpx2sGE69qphb0dtb3yZo4jIJ4F9nWR4kMR5vXvmQDTPm0LT+GO9V+AFXkD1ZH7vm1oHsD3H7e2b******", "SuccessMsg":"" }]}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"业务数据赋码失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-03-LEZ-XX", "ErrorMsg":

"不符合安装日期<=检测日期<=发证日期<=当前日期" "ErrorFields":

[{"FieldName":"行政区划代码（areacode）","FieldValue":"430000","FieldDesc":""},], }] }}③返回代码为2时的结果信息：{ "ReturnCode":"2", "ReturnMsg":"业务数据赋码成功有预警", "ReturnData":{ "WarnData":[{ "WarnGuid":"73faca65c31a484b8f6b719c94******", "WarnCode":"W-03-LEZ-XX", "WarnMsg":"XXX" }], "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-03-LEZ-XX", "encryCertid":"EDBE76D9217A23212E5546FD5B8F61E4671575AD27******", "encryKey":"Th2MCBlpx2sGE69qphb0dtb3yZo4jIJ4F9nWR4kMR5vXvmQDTPm0LT+GO9V+AFXkD1ZH7vm1oHsD3H7e2b******", "SuccessMsg":"" }] }}5.1.3、证书状态变更接口使用场景说明：当对证书状态需要更新且不需要赋码时，可以申请调用建筑起重机械使用登记证书证书状态变更接口。补充说明：当操作类型“办理注销”时，需要先将拆卸相关人员信息调用相关人员信息接收接口进行上报，再调用证书状态变更接口。表5-1-3接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_update请求方式POST返回方式JSON接口说明建筑起重机械使用登记证书证书状态变更接口；支持多条数据上传，单次上传上限10条。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注businessDataIdC36是业务数据ID，地方电子证照系统业务主键certIdC73是证照标识，由省级建筑起重机械使用登记证书电子证照系统按照规则自动生成的唯一标识，按照《全国一体化政务服务平台电子证照建筑起重机械使用登记证书》标准附录A.2生成areaCodeC6是所属省、自治区、直辖市、市辖区行政区划代码，按照民政部官网《2020年中华人民共和国行政区划代码》certNumC..26是证照编号，按照《全国一体化政务服务平台电子证照建筑起重机械使用登记证书》附录A.1编号规则生成的证书唯一编号。deviceCategoryCodeC1是类别代码,使用登记证所对应的建筑起重机械的类别的代码，详见6.1-建筑起重机械类别代码表deviceModelC..200是规格型号,使用登记证所对应的建筑起重机械的规格型号factoryNumC..200是出厂编号,建筑起重机械所对应的唯一出厂编号manufactureCorpCodeC18是制造单位统一社会信用代码,建筑起重机械制造单位的统一社会信用代码useCorpCodeC18是使用单位统一社会信用代码，持该证照的使用单位的统一社会信用代码certStatusC2是证书状态代码，详见6.1-证书状态类型代码表certStatusDescriptionC..200满足条件必填证书状态描述，证书状态为“其他”时进行的补充描述operateTypeC2是操作类型，详见6.1-操作类型代码表和6.1-证书状态与操作类型关系代码表请求参数示例{ "AcceptData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "certId":"005.2.11100000000013338W083.11110000000021135M.2023T0000001.001.G", "areaCode":"110101", "certNum":"110101T（2023）0000001", "deviceCategoryCode":"T", "deviceModel":"QTZ80(WA6010-6A)", "factoryNum":"1012T002124869", "manufactureCorpCode":"914300007121944054", "useCorpCode":"9161070056714569XF", "certStatus":"02", "certStatusDescription":"撤销",//证书状态为“99”时进行的补充描述 "operateType":"30" }]}返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.1-返回代码代码表ReturnMsgC..500是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据标识，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+certNumC..26/证照编号，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+businessDataIdC..50/业务数据唯一标识，返回代码为1时需要+SuccessCodeC..50/成功码，返回代码为1时需要+certNumC..26/证照编号，返回代码为1时需要+SuccessMsgC..1000/成功信息，返回代码为1时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"证书状态更新成功", "ReturnData":{ "SuccessData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-04-LEZ-XX", "certNum":"110101T（2023）0000001", "SuccessMsg":"该国家标准电子证照证书状态更新成功" }] }}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"证书状态更新失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******","ErrorCode":"E-04-LEZ-XX", "certNum":"110101T（2023）0000001", "ErrorMsg":"XXXX" }] }}5.1.4、电子证照文件归集接口使用场景说明：省级电子证照系统需要上报建筑起重机械使用登记证书电子证照文件信息进行归集时，可以申请调用电子证照文件归集接口。表5-1-4接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_gj请求方式POST返回方式JSON接口说明建筑起重机械使用登记证书电子证照文件归集接口；支持多条数据上传，单次上传上限10条。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注fmcodeC..50是二维码赋码，业务数据归集接口汇集成功后，如符合发放电子证照要求，则会生成二维码赋码密文，通过“4.1二维码赋码密文解密方法”解密后生成二维码赋码certIdC73是证照标识，由省级建筑起重机械使用登记证书电子证照系统按照规则自动生成的唯一标识，按照《全国一体化政务服务平台电子证照建筑起重机械使用登记证书》标准附录A.2生成certPreviewUrlC..500是证照预览地址，安全生产许可电子证照预览页面URL地址，需https域名互联网访问请求参数示例{ "AcceptData":[{ "fmcode":"1100002022000000001", "certId":"005.2.11100000000013338W083.11110000000021135M.2023T0000001.001.G", "certPreviewUrl":"http://localhost:8089/szjsframegl/rest/frame/base/attach/attachAction/getContent?isCommondto=true&attachGuid=b9ec8896-68f2-499e-ac9f-c7b7c8e3ba94" }]}certPreviewUrl入参预览示例返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.1-返回代码代码表ReturnMsgC..500是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据标识，返回代码为0时需要+fmcodeC..50/二维码赋码，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+certNumC..26/证照编号，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+fmcodeC..50/二维码赋码，返回代码为1时需要+SucccessCodeC..50/成功码，返回代码为1时需要+certNumC..26/证照编号，返回代码为1时需要+SuccessMsgC..1000/成功信息，返回代码为1时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"电子证照文件归集成功", "ReturnData":{"SuccessData":[{ "fmcode":"1100002022000000001", "SuccessCode":"S-05-LEZ-XX", "certNum":"110101T（2023）0000001", "SuccessMsg":"该国家标准电子证照证照文件归集成功！" }]}}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"电子证照文件归集失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "fmcode":"1100002022000000001", "ErrorCode":"E-05-LEZ-XX", "certNum":"110101T（2023）0000001", "ErrorMsg":"fmcode错误，校验失败，请重新调整！" }] }}5.1.5、相关人员信息接收接口使用场景说明：省级电子证照系统需要上报建筑起重机械使用过程中的相关人员信息业务数据，可以申请调用相关人员信息接收接口。表5-1-5接口信息接口地址http://**/epoint-gateway/zjbzasdzzz/rest/dzzzqzjxsyjdzrest/qzjxsydjz_ryxx请求方式POST返回方式JSON接口说明建筑起重机械使用相关人员信息接收接口接口；支持多条数据上传，单次上传上限10条。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注businessDataIdC36是业务数据ID，地方电子证照系统业务主键certNumC20是证照编号，建筑起重机械使用登记证书的唯一编号，按照《全国一体化政务服务平台电子证照建筑起重机械使用登记证书》附录A.1编号规则生成certIdC73是证照标识，由省级建筑起重机械使用登记证书电子证照系统按照规则自动生成的唯一标识，按照《全国一体化政务服务平台电子证照建筑起重机械使用登记证书》标准附录A.2生成personInfoListJSON是业务信息，按JSON各式上报建筑起重机械设备涉及的相关人员业务信息集合。Json对象personinfolist相关字段名称数据类型是否必需备注personTypeC..50是人员类型，详见6.1-相关人员信息业务类型代码表nameC..50是姓名，持证人姓名，与持证人身份证件记载信息一致identityCardC..18是身份证件号码，持证人员的有效身份证件号identityCardTypeC3是身份证件号码类型代码，持证人员的有效身份证件号码类型，可取值为公民身份号码、护照号等，从GB/T36903-2018的附录A中选取dataFlagC1是数据有效标识，如果数据变为无效该字段为0，详见6.1-数据有效标识字典表dataRemarkC..500满足条件必填数据无效原因，即数据删除原因，数据有效标识为无效时必填请求参数示例{ "AcceptData":[{ "businessDataId":"73faca65c31a484b8f6b719c94******", "certNum":"110101T（2023）0000001", "certId":"005.2.11100000000013338W083.11110000000021135M.2023T0000001.001.G", "personInfoList":[{ "personType":"1001", "name":"张**", "identityCard":"4106221988010******", "identityCardType":"111", "dataF