附件3.全国工程质量安全监管信息平台电子证照数据交换接口规范（V2.0）

附件3全国工程质量安全监管信息平台电子证照数据交换接口规范（V2.0）2022年08月文档修订历史序号版本修订日期修改记录11.02022-07全国工程质量安全监管信息平台电子证照数据交换接口规范（试运行）21.12022-08调整“业务数据校验接口”返回值调整“业务数据赋码接口”返回值31.22022-11新增安管人员“业务数据校验接口”新增安管人员“业务数据赋码接口”新增安管人员“电子证照文件归集接口”41.32022-121、调整安管人员“证书状态代码表”，新增项：07-吊销2、调整安管人员“业务数据赋码接口”，添加技术职称、文化程度的必填条件描述51.42023-011、调整“证书状态与操作类型关系代码表”2、特种人员“工种类别描述”字段的补充说明3、安管人员“证书状态描述”字段的补充说明4、添加接口单次上传上限50条的说明61.52023-02新增三本证的“数据更正接口”按照业务归类完善整体接口内容结构按照业务归类对代码表进行调整，增加安管人员字典表71.62023-031、调整接口参数形式分层级展示，调整请求参数和返回结果参数和对应示例2、调整“数据更正接口”字段，增加更正字段：证书状态81.72023-041、按照三本证电子证照标准调整接口参数的说明2、调整三本证接口返回结果参数说明3、新增特种人员、安管人员证件号码变更接口92.02023-051、调整校验接口请求参数，增加必要性关键字段2、新增证书状态变更接口，更新状态使用场景说明3、根据业务场景提供三本证调用接口详细说明，流程指南增加业务规则校验和接口调整内容目录26827一、概述 —概述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：表示大文本字符串。服务申请流程平台提供的服务API仅用于资源请求方进行业务使用，请各部门妥善保管全国工程质量安全监管平台提供的接口和相关参数。2.1、账号开设各省（直辖市、自治区、新疆生产建设兵团）通过住建部数据中心以接口形式上报质量监管信息数据，由部信息中心为各省（直辖市、自治区、新疆生产建设兵团）对接负责人开设平台账号。住建部数据中心（政务外网）：/mohurd-data提醒：住建部数据中心部署在政务外网，请各省（直辖市、自治区、新疆生产建设兵团）先确定能够正常访问平台。2.2、用户个人资料完整各省（直辖市、自治区、新疆生产建设兵团）初次登录平台后，需要在用户中心-个人资料中完善用户信息，否则无法进行服务使用登记授权。图2-2-12.3、服务使用登记授权点击首页的API服务选项，可以查看所有注册过的API，默认按照API的注册时间逆序排列。图2-3-1在API使用登记页面，按照要求填写相关内容，其中需要关联的应用系统是指在管理平台中注册通过的该部门下的应用系统，点击确认登记按钮提交备案申请，备案申请提交后需要工程质量安全监管司进行审核确认。图2-3-2用户可以在用户中心-我的申请里看到该用户使用登记的接口。图2-3-3点击接口名称可以查看接口相关授权信息。图2-3-4

服务调用流程请用户将该接口授权的应用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接口信息接口地址（政务外网）******请求方式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、加密方法加密方法如下：/***返回加密后的证照及企业和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=11100000000013338W050&province=5100004.2.5、说明二维码赋码包含内容：URL：二维码扫码查询提示页面，固定为：/fwmh/middlepage.htmlID：二维码赋码的密文，通过“4.2.3加密方法”加密k：8位随机密钥，通过“4.2.3加密方法”加密certype：电子证照类型代码。表4-2-5证照类型名称证照类型代码建筑施工企业安全生产许可证11100000000013338W050建筑施工特种作业人员操作资格证书11100000000013338W032安全生产管理人员安全生产考核合格证书11100000000013338W011province：固定值对接省份6位辖区代码以上加密方法需要的publicKeyString公钥参数值，由住房和城乡建设部全国工程质量安全监管信息平台技术支持单独提供。对接接口标准5.1、建筑施工企业安全生产许可证根据业务场景提供安许证调用接口的详细说明，流程指南详见附录1。推送操作类型原证书状态推送的证书状态是否赋码调用接口顺序1、办理新发电子证照和既有电子证照后续业务场景办理新发电子证照/有效是①业务数据校验接口②业务数据赋码接口③电子证照文件归集接口办理延续有效有效是办理延续失效有效是办理延续其他有效是办理变更有效有效是办理暂扣有效暂扣否证书状态变更接口办理暂扣其他暂扣否办理暂扣发还暂扣有效否办理暂扣发还暂扣失效否办理过期失效有效失效否办理注销（撤销、吊销）有效注销否办理注销（撤销、吊销）有效吊销否办理注销（撤销、吊销）有效撤销否办理注销（撤销、吊销）失效注销否办理注销（撤销、吊销）暂扣吊销否办理注销（撤销、吊销）其他吊销否办理注销（撤销、吊销）其他撤销否办理其他业务有效其他否办理其他业务其他有效否办理其他业务其他失效否办理其他业务其他其他否2、办理存量证书换发电子证照场景办理新发电子证照/有效是①业务数据校验接口②业务数据赋码接口③电子证照文件归集接口办理新发电子证照/暂扣是办理新发电子证照/其他是5.1.1、业务数据校验接口使用场景说明：省级电子证照系统进行业务审批需要上报建筑施工企业安全生产许可证业务数据时，提前对数据预校验，可以申请调用业务数据校验接口。表5-1-1接口信息接口地址******请求方式POST返回方式JSON接口说明建筑施工企业安全生产许可证业务数据校验接口；支持多条数据上传，单次上传上限50条。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注eCertIDC..50是业务数据IDprovinceNumC6是所属省份，按照民政部官网《2020年中华人民共和国行政区划代码》creditCodeC18是统一社会信用代码，持该证照的建筑施工企业的统一社会信用代码operateTypeC2是操作类型，详见6.1-操作类型代码表和6.1-证书状态与操作类型关系代码表certNumC..26满足条件必填证照编号，建筑施工企业安全生产许可证的唯一编号，按照《全国一体化政务服务平台电子证照建筑企业安全生产许可证》附录A.1编号规则生成，当操作类型是办理延续、办理变更时，需要必填请求参数示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "provinceNum":"360000", "creditCode":"91361003MA7A******", "operateType":"02","certNum":"（赣）JZ安许证字[2021]******" }]}返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.1-返回代码代码表ReturnMsgC..1000是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据ID，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+creditCodeC18/统一社会信用代码，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+eCertIDC..50/业务数据唯一标识，返回代码为1时需要+SuccessCodeC..50/成功码，返回代码为1时需要+creditCodeC18/统一社会信用代码，返回代码为1时需要+SuccessMsgC..1000/成功信息，返回代码为1时需要WarnDataJSON/预警信息集合，返回代码为2时需要+WarnGuidC..50/预警数据ID，返回代码为2时需要+WarnCodeC..50/预警码，返回代码为2时需要+creditCodeC18/统一社会信用代码，返回代码为2时需要+WarnMsgC..1000/预警信息，返回代码为2时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"业务数据校验成功", "ReturnData":{ "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-AXZ-01", "creditCode":"91361003MA7A******", "SuccessMsg":"该国家标准电子证照业务数据校验成功" }] }}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"业务数据校验失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-02-AXZ-12", "creditCode":"91361003MA7A******", "ErrorMsg":"该企业已存在国家标准电子证照，发证地：湖北省，证照编号：(鄂)JZ安许证字[2019]******" }] }}③返回代码为2时的结果信息：{ "ReturnCode":"2", "ReturnMsg":"业务数据校验成功有预警", "ReturnData":{ "WarnData":[{ "WarnGuid":"73faca65c31a484b8f6b719c94******", "WarnCode":"E-02-AXZ-13", "creditCode":"91361003MA7A******", "WarnMsg":"该企业已存在非标准电子证照，发证地：湖北省，证照编号：(鄂)JZ安许证字[2019]******" }], "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-AXZ-01", "creditCode":"91361003MA7A******", "SuccessMsg":"该国家标准电子证照业务数据校验成功" }] }}5.1.2、业务数据赋码接口使用场景说明：省级电子证照系统需要上报建筑施工企业安全生产许可证业务数据进行归集并申请二维码赋码时，可以申请调用业务数据赋码接口。表5-1-2接口信息接口地址******请求方式POST返回方式JSON接口说明建筑施工企业安全生产许可证业务数据赋码接口；支持多条数据上传，单次上传上限50条；操作类型为“01”或“02”时会进行二维码赋码。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注eCertIDC..50是业务数据IDprovinceNumC6是所属省份，按照民政部官网《2020年中华人民共和国行政区划代码》certNumC..26是证照编号，建筑施工企业安全生产许可证的唯一编号，按照《全国一体化政务服务平台电子证照建筑企业安全生产许可证》附录A.1编号规则生成issuAuthC..200是发证机关，负责颁发和管理该建筑施工企业安全生产许可证的省、自治区、直辖市人民政府住房城乡建设主管部门名称issuAuthCodeC18是发证机关代码，发证机关的统一社会信用代码issuDateDate是发证日期，该证照颁发的日期，按照公元纪年精确至日companyNameC..100是企业名称，持该证照的建筑施工企业名称，应与企业营业执照中的“企业名称”一致creditCodeC18是统一社会信用代码，持该证照的建筑施工企业的统一社会信用代码companyAddressC..200是单位地址，持该证照的建筑施工企业的单位地址，应与企业营业执照中的“住所”内容一致responsiblePersonC..50是法定代表人，持该证照的建筑施工企业的法定代表人，应与企业营业执照中的“法定代表人”内容一致responsiblePersonIDC..18是法定代表人身份证件号码，法定代表人的有效身份证件号码responsiblePersonIDTypeC3是法定代表人身份证件号码类型，法定代表人的有效身份证件号码类型，可取值为公民身份号码、护照号等，从GB/T36903-2018的附录A中选取economicTypeC..100是经济类型，持该证照的建筑施工企业的经济类型，应与企业营业执照中的“经济性质”内容一致licenseScopeC..8是许可范围，建筑施工企业进行安全生产的许可范围，固定为“建筑施工”effectiveDateDate是有效期起始日期，该证照有效期的起始日期，按照公元纪年精确至日expiringDateDate是有效期结束日期，该证照有效期的结束日期，按照公元纪年精确至日firstIssuDateDate是初次领证日期，该证书首次签发时证书上的发证日期certStateC2是证书状态，证书状态代码，详见6.1-证书状态类型代码表certStatusDescriptionC..200满足条件必填证书状态描述，证书状态为“其他”时进行的补充描述associatedZzeCertIDC74满足条件必填关联证照标识，该证书关联的最近一个已失效建筑施工企业安全生产许可的电子证照标识，规则同表5-1-4中的“证照标识”,当操作类型是办理延续、办理变更时，需要必填businessInformationJSON否业务信息，按JSON串方式（第一个参数为持证主体或证照本身关联的业务类型，第二个参数为持证主体或证照本身涉及的业务信息）方式组织的对应业务类型代码的具体业务信息，参数类型详见6.1-扩展信息类型代码表operateTypeC2是操作类型，详见6.1-操作类型代码表和6.1-证书状态与操作类型关系代码表请求参数示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "provinceNum":"360000", "certNum":"（赣）JZ安许证字[2021]******", "issuAuth":"江西省住房和城乡建设厅", "issuAuthCode":"113600000145******", "issuDate":"2023-02-25", "companyName":"******建设工程有限公司", "creditCode":"91361003MA7A******", "companyAddress":"江西省抚州市抚州高新技术产业开发区******", "responsiblePerson":"许**", "responsiblePersonID":"3625281983******12", "responsiblePersonIDType":"111", "economicType":"有限责任公司(自然人投资或控股)", "licenseScope":"建筑施工", "effectiveDate":"2021-11-15", "expiringDate":"2024-11-15", "firstIssuDate":"2021-11-15", "certState":"02", "certStatusDescription":"有效",//证书状态为“99”时进行的补充描述 "associatedZzeCertID":"005.2.11100000000013338W050.11360000014501199J.2021030019.002.Y", "businessInformation":[{ "itemvalue":"01", "itemtext":"持证企业的资质信息" },{ "itemvalue":"02", "itemtext":"证书处罚处置信息" }], "operateType":"01" }]}返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.1-返回代码代码表ReturnMsgC..1000是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据ID，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+eCertIDC..50/业务数据唯一标识，返回代码为1时需要+SuccessCodeC..50/成功码，返回代码为1时需要+encryKeyC..200/二维码赋码加密key，返回代码为1时需要+encryCertidC..200/二维码赋码加密公钥，返回代码为1时需要+ReturnMsgC..1000/成功信息补充说明，返回代码为1时需要WarnDataJSON/预警信息集合，返回代码为2时需要+WarnGuidC..50/预警信息标识，返回代码为2时需要+WarnCodeC..50/预警码，返回代码为2时需要+WarnMsgC..1000/预警信息，返回代码为2时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"业务数据赋码成功", "ReturnData":{ "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-03-AXZ-02", "encryCertid":"EDBE76D9217A23212E5546FD5B8F61E4671575AD27******", "encryKey":"Th2MCBlpx2sGE69qphb0dtb3yZo4jIJ4F9nWR4kMR5vXvmQDTPm0LT+GO9V+AFXkD1ZH7vm1oHsD3H7e2b******", "ReturnMsg":"" }] }}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"业务数据赋码失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-03-AXZ-04", "ErrorMsg":

"推送的接口参数中的省份湖北省，和当前调用方省份江西省不一致，校验失败，请重新调整！" "ErrorFields":

[{"FieldName":"所属省份（provinceNum）","FieldValue":"430000","FieldDesc":""},], }] }}③返回代码为2时的结果信息：{ "ReturnCode":"2", "ReturnMsg":"业务数据赋码成功有预警", "ReturnData":{ "WarnData":[{ "WarnGuid":"73faca65c31a484b8f6b719c94******", "WarnCode":"W-03-AXZ-02", "WarnMsg":"该企业******建设工程有限公司已存在非标准电子证照，发证地：湖北省,证照编号：(鄂)JZ安许证字[2019]******" }], "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-03-AXZ-02", "encryCertid":"EDBE76D9217A23212E5546FD5B8F61E4671575AD27******", "encryKey":"Th2MCBlpx2sGE69qphb0dtb3yZo4jIJ4F9nWR4kMR5vXvmQDTPm0LT+GO9V+AFXkD1ZH7vm1oHsD3H7e2b******", "ReturnMsg":"" }] }}5.1.3、证书状态变更接口使用场景说明：当对证书状态需要更新且不需要赋码时，可以申请调用建筑施工企业安全生产许可证证书状态变更接口。表5-1-3接口信息接口地址******请求方式POST返回方式JSON接口说明建筑施工企业安全生产许可证证书状态变更接口；支持多条数据上传，单次上传上限50条。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注eCertIDC..50是业务数据IDzzeCertIDC74是证照标识，由省级建筑施工企业安全生产许可证电子证照系统按照规则自动生成的唯一标识，按照《全国一体化政务服务平台电子证照建筑施工企业安全生产许可证》标准附录A.2生成provinceNumC6是所属省份，按照民政部官网《2020年中华人民共和国行政区划代码》certNumC..26是证照编号，按照《全国一体化政务服务平台电子证照建筑企业安全生产许可证》附录A.1编号规则生成的证书唯一编号。creditCodeC18是统一社会信用代码，持该证照的建筑施工企业的统一社会信用代码certStateC2是证书状态，证书状态代码，详见6.1-证书状态类型代码表certStatusDescriptionC..200满足条件必填证书状态描述，证书状态为“其他”时进行的补充描述operateTypeC2是操作类型，详见6.1-操作类型代码表和6.1-证书状态与操作类型关系代码表请求参数示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "zzeCertID":"005.2.11100000000013338W050.11360000014501199J.2021030019.002.Y", "provinceNum":"360000", "certNum":"（赣）JZ安许证字[2021]******", "creditCode":"91361003MA7A******", "certState":"01", "certStatusDescription":"",//证书状态为“99”时进行的补充描述 "operateType":"03" }]}返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.1-返回代码代码表ReturnMsgC..1000是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据ID，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+certNumC..26/证照编号，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+eCertIDC..50/业务数据唯一标识，返回代码为1时需要+SuccessCodeC..50/成功码，返回代码为1时需要+certNumC..26/证照编号，返回代码为1时需要+SuccessMsgC..1000/成功信息，返回代码为1时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"证书状态更新成功", "ReturnData":{ "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-04-AXZ-02", "certNum":"（赣）JZ安许证字[2021]******", "SuccessMsg":"该国家标准电子证照证书状态更新成功" }] }}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"证书状态更新失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******","ErrorCode":"E-04-AXZ-12", "certNum":"（赣）JZ安许证字[2021]******", "ErrorMsg":"该企业XX已存在电子证照，发证地江西省，证书编号：（赣）JZ安许证字[2023]133813" }] }}5.1.4、电子证照文件归集接口使用场景说明：省级电子证照系统需要上报建筑施工企业安全生产许可证电子证照文件信息进行归集时，可以申请调用电子证照文件归集接口。表5-1-4接口信息接口地址******请求方式POST返回方式JSON接口说明建筑施工企业安全生产许可证电子证照文件归集接口；支持多条数据上传，单次上传上限50条。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注IDC..50是二维码赋码，业务数据归集接口汇集成功后，如符合发放电子证照要求，则会生成二维码赋码密文，通过“4.1二维码赋码密文解密方法”解密后生成二维码赋码zzeCertIDC74是证照标识，由省级建筑施工企业安全生产许可证电子证照系统按照规则自动生成的唯一标识，按照《全国一体化政务服务平台电子证照建筑施工企业安全生产许可证》标准附录A.2生成urlC..200是证照预览地址，安全生产许可电子证照预览页面URL地址，需https域名互联网访问请求参数示例{ "AcceptData":[{ "ID":"1100002022000000001", "zzeCertID":"005.2.11100000000013338W050.11360000014501199J.2021030019.002.Y", "url":"http://localhost:8089/szjsframegl/rest/frame/base/attach/attachAction/getContent?isCommondto=true&attachGuid=b9ec8896-68f2-499e-ac9f-c7b7c8e3ba94" }]}返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.1-返回代码代码表ReturnMsgC..1000是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据ID，返回代码为0时需要+IDC..50/二维码赋码，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+certNumC..26/证照编号，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+IDC..50/二维码赋码，返回代码为1时需要+SucccessCodeC..50/成功码，返回代码为1时需要+certNumC..26/证照编号，返回代码为1时需要+SuccessMsgC..1000/成功信息，返回代码为1时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"电子证照文件归集成功", "ReturnData":{"SuccessData":[{ "ID":"1100002022000000001", "SuccessCode":"S-XX-XXX-XX", "certNum":"（赣）JZ安许证字[2021]******", "SuccessMsg":"该国家标准电子证照证照文件归集成功！" }]}}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"电子证照文件归集失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ID":"1100002022000000001", "ErrorCode":"E-XX-XXX-XX", "certNum":"（赣）JZ安许证字[2021]******", "ErrorMsg":"赋码已使用" }] }}5.1.5、数据更正接口使用场景说明：仅当数据推送错误需要更正数据时，可以申请调用建筑施工企业安全生产许可证数据更正接口。该接口按需开放使用。表5-1-5接口信息接口地址******请求方式POST返回方式JSON接口说明建筑施工企业安全生产许可证数据更正接口；支持多条数据上传，单次上传上限50条；业务数据ID、证照标识、所属省份、证照编号以及统一社会信用代码关键字段不允许更正。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注eCertIDC..50是业务数据ID，待更正的原证照业务数据ID，不可更正zzeCertIDC74是证照标识，由省级建筑施工企业安全生产许可证电子证照系统按照规则自动生成的唯一标识，按照《全国一体化政务服务平台电子证照建筑施工企业安全生产许可证》标准附录A.2生成，不可更正provinceNumC6是所属省份，按照民政部官网《2020年中华人民共和国行政区划代码》，不可更正certNumC..26是证照编号，建筑施工企业安全生产许可证的唯一编号，按照《全国一体化政务服务平台电子证照建筑企业安全生产许可证》附录A.1编号规则生成的证书唯一编号，不可更正creditCodeC18是统一社会信用代码，持该证照的建筑施工企业的统一社会信用代码，不可更正issuAuthC..200否发证机关，负责颁发和管理该建筑施工企业安全生产许可证的省、自治区、直辖市人民政府住房城乡建设主管部门名称，可更正issuAuthCodeC18否发证机关代码，发证机关的统一社会信用代码，可更正issuDateDate否发证日期，该证照颁发的日期，按照公元纪年精确至日，可更正companyNameC..100否企业名称，持该证照的建筑施工企业名称，应与企业营业执照中的“企业名称”一致，可更正companyAddressC..200否单位地址，持该证照的建筑施工企业的单位地址，应与企业营业执照中的“住所”内容一致，可更正responsiblePersonC..50否法定代表人，持该证照的建筑施工企业的法定代表人，应与企业营业执照中的“法定代表人”内容一致，可更正responsiblePersonIDC..18否法定代表人身份证件号码，法定代表人的有效身份证件号码，可更正responsiblePersonIDTypeC3否法定代表人身份证件号码类型，法定代表人的有效身份证件号码类型，可取值为公民身份号码、护照号等，从GB/T36903-2018的附录A中选取，可更正economicTypeC..100否经济类型，持该证照的建筑施工企业的经济类型，应与企业营业执照中的“经济性质”内容一致，可更正licenseScopeC..8否许可范围，建筑施工企业进行安全生产的许可范围，固定为“建筑施工”，可更正effectiveDateDate否有效期起始日期，该证照有效期的起始日期，按照公元纪年精确至日，可更正expiringDateDate否有效期结束日期，该证照有效期的结束日期，按照公元纪年精确至日，可更正firstIssuDateDate否初次领证日期，该证书首次签发时证书上的发证日期，可更正certStateC2否证书状态，证书状态代码，详见6.1-证书状态类型代码表，可更正certStatusDescriptionC..200否证书状态描述，证书状态为“其他”时进行的补充描述，可更正associatedZzeCertIDC74否关联证照标识，该证书关联的最近一个已失效建筑施工企业安全生产许可的电子证照标识，规则同表5-1-4中的“证照标识”，可更正businessInformationJSON否业务信息，按JSON串方式（第一个参数为持证主体或证照本身关联的业务类型，第二个参数为持证主体或证照本身涉及的业务信息）方式组织的对应业务类型代码的具体业务信息，参数类型详见6.1-扩展信息类型代码表，可更正operateTypeC2否操作类型，详见6.1-操作类型代码表和6.1-证书状态与操作类型关系代码表，更正证书状态时必填urlC..200否证照预览地址，安全生产许可电子证照预览页面URL地址，需https域名互联网访问，可更正请求参数示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "zzeCertID":"005.2.11100000000013338W050.11360000014501199J.2021030019.002.Y", "provinceNum":"360000", "certNum":"（赣）JZ安许证字[2021]******", "creditCode":"91361003MA7A******", "issuAuth":"江西省住房和城乡建设厅", "issuAuthCode":"113600000145******", "issuDate":"2023-02-25", "companyName":"******建设工程有限公司", "companyAddress":"江西省抚州市抚州高新技术产业开发区******", "responsiblePerson":"许**", "responsiblePersonID":"3625281983******12", "responsiblePersonIDType":"111", "economicType":"有限责任公司(自然人投资或控股)", "licenseScope":"建筑施工", "effectiveDate":"2021-11-15", "expiringDate":"2024-11-15", "firstIssuDate":"2021-11-15", "certState":"01", "certStatusDescription":"有效", "associatedZzeCertID":"005.2.11100000000013338W050.11360000014501199J.2021030019.001.0", "businessInformation":[{ "itemvalue":"01", "itemtext":"持证企业的资质信息" },{ "itemvalue":"02", "itemtext":"证书处罚处置信息" }], "operateType":"01", "url":"http://localhost:8089/szjsframegl/rest/frame/base/attach/attachAction/getContent?isCommondto=true&attachGuid=b9ec8896-68f2-499e-ac9f-c7b7c8e3ba94" }]}url入参预览示例返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.1-返回代码代码表ReturnMsgC..1000是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据ID，返回代码为0时需要+certNumC..26/证照编号，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+certNumC..26/证照编号，返回代码为1时需要+SuccessCodeC..50/成功码，返回代码为1时需要+SuccessMsgC..1000/成功信息，返回代码为1时需要+ReturnMsgC..1000/成功信息补充说明，返回代码为1时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"数据更正上传成功", "ReturnData":{ "SuccessData":[{ "certNum":"（赣）JZ安许证字[2021]******", "SuccessCode":"S-05-AXZ-01", "SuccessMsg":"国家标准电子证照数据更正上传成功", "ReturnMsg":"" }] }}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"数据更正上传失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "certNum":"（赣）JZ安许证字[2021]******","ErrorCode":"E-05-AXZ-01", "ErrorMsg":"未查到相关证书，请核查！" }] }}5.2、建筑施工特种作业操作资格证书根据业务场景提供建筑施工特种作业操作资格证书调用接口的详细说明，流程指南详见附录2。推送操作类型原证书状态推送的证书状态是否赋码调用接口顺序1、办理新发电子证照和既有电子证照后续业务场景办理新发电子证照/有效是①业务数据校验接口②业务数据赋码接口③电子证照文件归集接口办理延续有效有效是办理延续失效有效是办理延续其他有效是办理变更有效有效是办理暂扣有效暂扣否证书状态变更接口办理暂扣其他暂扣否办理暂扣发还暂扣有效否办理暂扣发还暂扣失效否办理过期失效有效失效否办理注销（撤销、吊销）有效注销否办理注销（撤销、吊销）有效吊销否办理注销（撤销、吊销）有效撤销否办理注销（撤销、吊销）失效注销否办理注销（撤销、吊销）暂扣吊销否办理注销（撤销、吊销）其他吊销否办理注销（撤销、吊销）其他撤销否办理其他业务有效其他否办理其他业务其他有效否办理其他业务其他失效否办理其他业务其他其他否2、办理存量证书换发电子证照场景办理新发电子证照/有效是①业务数据校验接口②业务数据赋码接口③电子证照文件归集接口办理新发电子证照/暂扣是办理新发电子证照/其他是5.2.1、业务数据校验接口使用场景说明：省级电子证照系统进行业务审批需要上报建筑施工特种作业操作资格证书业务数据时，提前对数据预校验，可以申请调用业务数据校验接口。表5-2-1接口信息接口地址******请求方式POST返回方式JSON接口说明建筑施工特种作业操作资格证书业务数据校验接口；支持多条数据上传，单次上传上限50条。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注eCertIDC..50是业务数据IDprovinceNumC6是所属省份，按照民政部官网《2020年中华人民共和国行政区划代码》identityCardC..18是身份证件号码，持证人员的有效身份证件号operationCategoryC2是工种类别，建筑施工特种作业人员操作类别的代码，详见6.2-工种类别代码表categoryDescriptionC..100满足条件必填工种类别描述，当操作类别为经省级以上住房和城乡建设主管部门认定的其他工种类别时，应对具体操作类别进行的补充描述，固定格式为：“经省级以上住房和城乡建设主管部门认定的其他工种类别（XXX）”operateTypeC2是操作类型，详见6.2-操作类型代码表，6.2-证书状态与操作类型关系代码表certNumC..15满足条件必填证照编号，建筑施工特种作业操作资格证书的唯一编号，按照《全国一体化政务服务平台电子证照建筑施工特种作业操作资格证书》附录A.1编号规则生成，当操作类型是办理延续、办理变更时，需要必填请求参数示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "provinceNum":"370000", "identityCard":"3708831985******18", "operationCategory":"02", "categoryDescription":"",//工种类别为“99”时进行的补充描述 "operateType":"01", "certNum":"鲁H992014******" }]}返回结果参数名称数据类型是否必需备注ReturnCodeC1是返回代码，详见6.2-返回代码代码表ReturnMsgC..1000是返回信息ReturnDataJSON是返回数据结果集Json对象ReturnData相关字段名称数据类型是否必需备注ErrorDataJSON/错误信息集合，返回代码为0时需要+ErrorGuidC..50/错误数据ID，返回代码为0时需要+ErrorCodeC..50/错误码，返回代码为0时需要+identityCardC..18/身份证件号码，返回代码为0时需要+ErrorMsgC..1000/错误信息，返回代码为0时需要SuccessDataJSON/成功数据集合，返回代码为1时需要+eCertIDC..50/业务数据唯一标识，返回代码为1时需要+SuccessCodeC..50/成功码，返回代码为1时需要+identityCardC..18/身份证件号码，返回代码为1时需要+SuccessMsgC..1000/成功信息，返回代码为1时需要WarnDataJSON/预警信息集合，返回代码为2时需要+WarnGuidC..50/预警数据ID，返回代码为2时需要+WarnCodeC..50/预警码，返回代码为2时需要+identityCardC..18/身份证件号码，返回代码为2时需要+WarnMsgC..1000/预警信息，返回代码为2时需要返回结果示例①返回代码为1时的结果信息：{ "ReturnCode":"1", "ReturnMsg":"业务数据校验成功", "ReturnData":{ "SuccessData":[{ "eCertID":"b5b630c1-7c43-4ede-847a-5305e2******","SuccessCode":"S-XX-XXX-XX", "identityCard":"3708831985******18", "SuccessMsg":"该国家标准电子证照业务数据校验成功" }] }}②返回代码为0时的结果信息：{ "ReturnCode":"0", "ReturnMsg":"业务数据校验失败", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"b5b630c1-7c43-4ede-847a-5305e2******","ErrorCode":"E-XX-XXX-XX", "identityCard":"3708831985******18", "ErrorMsg":"该人员已存在工种类别（建筑电工）的国家标准电子证照，发证地：湖北省，证照编号：鲁H992014******" }] }}③返回代码为2时的结果信息：{ "ReturnCode":"2", "ReturnMsg":"业务数据校验成功有预警", "ReturnData":{ "WarnData":[{ "WarnGuid":"b5b630c1-7c43-4ede-847a-5305e2******","WarnCode":"W-XX-XXX-XX", "identityCard":"3708831985******18", "WarnMsg":"该人员已存在工种类别（建筑电工）的非标准电子证照，发证地：湖北省，证照编号：鲁H992014******" }], "SuccessData":[{ "eCertID":"b5b630c1-7c43-4ede-847a-5305e2******","SuccessCode":"S-XX-XXX-XX", "identityCard":"3708831985******18", "SuccessMsg":"该国家标准电子证照业务数据校验成功" }] }}5.2.2、业务数据赋码接口使用场景说明：省级电子证照系统需要上报建筑施工特种作业操作资格证书业务数据进行归集并申请二维码赋码时，可以申请调用业务数据赋码接口。表5-2-2接口信息接口地址******请求方式POST返回方式JSON接口说明建筑施工特种作业操作资格证书业务数据赋码接口；支持多条数据上传，单次上传上限50条；操作类型为“01”或“02”时会进行二维码赋码。请求参数名称数据类型是否必需备注AcceptDataJSON是记录集合。Json对象AcceptData相关字段名称数据类型是否必需备注eCertIDC..50是业务数据IDprovinceNumC6是所属省份，按照民政部官网《2020年中华人民共和国行政区划代码》certNumC..15是证照编号，建筑施工特种作业操作资格证书的唯一编号，按照《全国一体化政务服务平台电子证照建筑施工特种作业操作资格证书》附录A.1编号规则生成issuAuthC..200是发证机关，负责颁发和管理该建筑施工特种作业操作资格证书的省、自治区、直辖市人民政府住房城乡建设主管部门名称issuAuthCodeC18是发证机关代码，证照颁发机构的统一社会信用代码issuedDateDate是初次领证日期，持证人第一次领取该证照的日期，按照公元纪年精确至日issuDateDate是发证日期，该证照的颁发日期，如首次发证，则发证日期等于初次领证日期，如证书复核延续，发证日期为延续后新证书的颁发日期，按照公元纪年精确至日effectiveDateDate是有效期起始日期，该证照有效期的起始日期，按照公元纪年精确至日expiringDateDate是有效期结束日期，该证照有效期的结束日期，按照公元纪年精确至日nameC..50是姓名，持证人姓名，应与持证人身份证件记载信息一致genderC1是性别，持证人的性别代码，应与持证人身份证件记载信息一致。1表示男，2表示女，详见6.2-性别代码表identityCard