附件3.全國工程質(zhì)量安全監(jiān)管信息平臺電子證照數(shù)據(jù)交換接口規(guī)范（V2.0）

附件3全國工程質(zhì)量安全監(jiān)管信息平臺電子證照數(shù)據(jù)交換接口規(guī)范（V2.0）2022年08月文檔修訂歷史序號版本修訂日期修改記錄11.02022-07全國工程質(zhì)量安全監(jiān)管信息平臺電子證照數(shù)據(jù)交換接口規(guī)范（試運(yùn)行）21.12022-08調(diào)整“業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口”返回值調(diào)整“業(yè)務(wù)數(shù)據(jù)賦碼接口”返回值31.22022-11新增安管人員“業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口”新增安管人員“業(yè)務(wù)數(shù)據(jù)賦碼接口”新增安管人員“電子證照文件歸集接口”41.32022-121、調(diào)整安管人員“證書狀態(tài)代碼表”，新增項(xiàng)：07-吊銷2、調(diào)整安管人員“業(yè)務(wù)數(shù)據(jù)賦碼接口”，添加技術(shù)職稱、文化程度的必填條件描述51.42023-011、調(diào)整“證書狀態(tài)與操作類型關(guān)系代碼表”2、特種人員“工種類別描述”字段的補(bǔ)充說明3、安管人員“證書狀態(tài)描述”字段的補(bǔ)充說明4、添加接口單次上傳上限50條的說明61.52023-02新增三本證的“數(shù)據(jù)更正接口”按照業(yè)務(wù)歸類完善整體接口內(nèi)容結(jié)構(gòu)按照業(yè)務(wù)歸類對代碼表進(jìn)行調(diào)整，增加安管人員字典表71.62023-031、調(diào)整接口參數(shù)形式分層級展示，調(diào)整請求參數(shù)和返回結(jié)果參數(shù)和對應(yīng)示例2、調(diào)整“數(shù)據(jù)更正接口”字段，增加更正字段：證書狀態(tài)81.72023-041、按照三本證電子證照標(biāo)準(zhǔn)調(diào)整接口參數(shù)的說明2、調(diào)整三本證接口返回結(jié)果參數(shù)說明3、新增特種人員、安管人員證件號碼變更接口92.02023-051、調(diào)整校驗(yàn)接口請求參數(shù)，增加必要性關(guān)鍵字段2、新增證書狀態(tài)變更接口，更新狀態(tài)使用場景說明3、根據(jù)業(yè)務(wù)場景提供三本證調(diào)用接口詳細(xì)說明，流程指南增加業(yè)務(wù)規(guī)則校驗(yàn)和接口調(diào)整內(nèi)容目錄26827一、概述 —概述1.1、目的本文檔是為全國工程質(zhì)量安全監(jiān)管信息平臺與各省、自治區(qū)、直轄市、新疆生產(chǎn)建設(shè)兵團(tuán)建筑施工電子證照審批系統(tǒng)進(jìn)行數(shù)據(jù)共享提供統(tǒng)一對接標(biāo)準(zhǔn)，均按照此接口規(guī)范進(jìn)行對接。1.2、參考資料《全國一體化政務(wù)服務(wù)平臺電子證照建筑施工企業(yè)安全生產(chǎn)許可證》《全國一體化政務(wù)服務(wù)平臺電子證照建筑施工特種作業(yè)操作資格證書》《全國一體化政務(wù)服務(wù)平臺電子證照建筑施工企業(yè)安全生產(chǎn)管理人員考核合格證書》1.3、基本術(shù)語1.3.1、資源請求方資源請求方是指需要調(diào)用服務(wù)API的對象，是數(shù)據(jù)需求方。1.3.2、資源提供方資源提供方是指擁有資源方對外提供資源數(shù)據(jù)的對象，是數(shù)據(jù)提供方。1.3.3、服務(wù)API服務(wù)API是資源提供方對外提供數(shù)據(jù)服務(wù)的實(shí)現(xiàn)形式之一。其是由信息資源共享交換平臺基于RESTAPI技術(shù)實(shí)現(xiàn)。1.3.4、服務(wù)授權(quán)服務(wù)API只有在授權(quán)權(quán)限給相應(yīng)的應(yīng)用系統(tǒng)之后，資源請求方才能調(diào)用該服務(wù)API。1.4、參數(shù)類型說明C4：表示最多4位的字符型字符串，不足4位按實(shí)際位數(shù)；C..：表示可變長度的字符型字符串；N5：表示最多5位的數(shù)字型字符串，不足5位按實(shí)際位數(shù)；N..：表示可變長度的數(shù)字型字符串；Date：表示日期類型字符串。Text：表示大文本字符串。服務(wù)申請流程平臺提供的服務(wù)API僅用于資源請求方進(jìn)行業(yè)務(wù)使用，請各部門妥善保管全國工程質(zhì)量安全監(jiān)管平臺提供的接口和相關(guān)參數(shù)。2.1、賬號開設(shè)各省（直轄市、自治區(qū)、新疆生產(chǎn)建設(shè)兵團(tuán)）通過住建部數(shù)據(jù)中心以接口形式上報(bào)質(zhì)量監(jiān)管信息數(shù)據(jù)，由部信息中心為各省（直轄市、自治區(qū)、新疆生產(chǎn)建設(shè)兵團(tuán)）對接負(fù)責(zé)人開設(shè)平臺賬號。住建部數(shù)據(jù)中心（政務(wù)外網(wǎng)）：/mohurd-data提醒：住建部數(shù)據(jù)中心部署在政務(wù)外網(wǎng)，請各?。ㄖ陛犑?、自治區(qū)、新疆生產(chǎn)建設(shè)兵團(tuán)）先確定能夠正常訪問平臺。2.2、用戶個(gè)人資料完整各?。ㄖ陛犑?、自治區(qū)、新疆生產(chǎn)建設(shè)兵團(tuán)）初次登錄平臺后，需要在用戶中心-個(gè)人資料中完善用戶信息，否則無法進(jìn)行服務(wù)使用登記授權(quán)。圖2-2-12.3、服務(wù)使用登記授權(quán)點(diǎn)擊首頁的API服務(wù)選項(xiàng)，可以查看所有注冊過的API，默認(rèn)按照API的注冊時(shí)間逆序排列。圖2-3-1在API使用登記頁面，按照要求填寫相關(guān)內(nèi)容，其中需要關(guān)聯(lián)的應(yīng)用系統(tǒng)是指在管理平臺中注冊通過的該部門下的應(yīng)用系統(tǒng)，點(diǎn)擊確認(rèn)登記按鈕提交備案申請，備案申請?zhí)峤缓笮枰こ藤|(zhì)量安全監(jiān)管司進(jìn)行審核確認(rèn)。圖2-3-2用戶可以在用戶中心-我的申請里看到該用戶使用登記的接口。圖2-3-3點(diǎn)擊接口名稱可以查看接口相關(guān)授權(quán)信息。圖2-3-4

服務(wù)調(diào)用流程請用戶將該接口授權(quán)的應(yīng)用key、應(yīng)用密鑰這兩個(gè)值提供給應(yīng)用開發(fā)商，應(yīng)用開發(fā)商按照下面的步驟調(diào)用接口資源。3.1、步驟一、獲取認(rèn)證token共享平臺提供基于OAuth2.0的統(tǒng)一身份鑒權(quán)方式。第三方應(yīng)用通過申請令牌token，來完成對API的調(diào)用訪問，各省份的應(yīng)用標(biāo)識client_id與client_secret會提前分發(fā)。其中對于所有訪問用戶隱私API的請求，需要提供用戶授權(quán)令牌來校驗(yàn)該第三方調(diào)用是否是合法調(diào)用，而對于所有平臺基礎(chǔ)支撐API，需要提供客戶端授權(quán)令牌來進(jìn)行校驗(yàn)。關(guān)于OAuth2.0協(xié)議的詳細(xì)介紹，可以參考W3C的官方文檔。開發(fā)者可以先瀏覽OAuth2.0的接口文檔，熟悉OAuth2的接口及參數(shù)的含義，然后我們根據(jù)用戶授權(quán)認(rèn)證和客戶端授權(quán)認(rèn)證2種場景各自說明如何使用OAuth2.0。表3-1接口信息接口地址（政務(wù)外網(wǎng)）******請求方式POST參數(shù)格式請求參數(shù)Body類型：x-www-form-urlencoded接口說明獲取token請求參數(shù)參數(shù)名數(shù)據(jù)類型是否必須說明client_idC..是應(yīng)用標(biāo)識client_secretC..是應(yīng)用密碼grant_typeC..是固定值：client_credentials請求參數(shù)示例返回結(jié)果參數(shù)參數(shù)名數(shù)據(jù)類型是否必須說明access_tokenC..是最終獲取到的tokenrefresh_tokenC..是刷新token票據(jù)expires_inC..是token有效期返回結(jié)果示例正確示例：錯(cuò)誤示例：{3.2、步驟二、上傳資源數(shù)據(jù)根據(jù)得到的token,調(diào)用接口,上傳數(shù)據(jù)。3.3、Java代碼參考示例publicclassCallAPI{//客戶端賬號標(biāo)識,請修正為實(shí)際值staticStringAppKey="eae5****-****-****-****-********58a7";//客戶端賬號密碼,請修正為實(shí)際值staticStringAppSecret="d0c9****-****-****-****-********096c";//認(rèn)證平臺地址，具備token接口，只需要配置到認(rèn)證平臺應(yīng)用系統(tǒng)名即可,請修正為實(shí)際值staticStringSSOUrl=":port/epoint-sso-web";//調(diào)用憑證，考慮憑證需要遠(yuǎn)程調(diào)用接口獲取，需要靜態(tài)化，不用每次調(diào)用重新獲取staticAssertionTokenInfo;//生成調(diào)用憑證staticAssertiongetToken(booleanrefresh){//如果憑證已經(jīng)生成且不需要強(qiáng)制更新的情況下，則只需要獲取原有憑證即可，避免不必要的遠(yuǎn)程調(diào)用if(TokenInfo==null||refresh){//利用SDK方法獲取調(diào)用憑證，傳入客戶端賬號、密碼和認(rèn)證平臺地址，采用的是客戶端認(rèn)證模式TokenInfo=AssertionUtil.getAssertionStateless(AppKey,AppSecret,SSOUrl);}returnTokenInfo;}//調(diào)用最終API方法publicstaticStringAPIInvoke(StringUrl,StringAccess_Token,Map<string,object="">Params){//實(shí)際需要調(diào)用的API的地址，將調(diào)用憑證token作為參數(shù)傳入U(xiǎn)rl=Url+"?access_token="+Access_Token;//通過SDK的HttpClientUtil調(diào)用API，獲得返回值Map<string,string="">headers=newHashMap<>();headers.put("Authorization","Bearer"+Access_Token);return(String)HttpClientUtil.post(Url,headers,Params,2);}publicstaticvoidmain(String[]args)throwsException{//實(shí)際API地址,請修正為實(shí)際值StringUrl=":port/rest/***";//調(diào)用API的參數(shù),請修正為實(shí)際值Map<string,object="">Params=newHashMap<>();Params.put("服務(wù)器IP","");//考慮調(diào)用憑證緩存化，一定時(shí)間后調(diào)用憑證肯定會過期，當(dāng)憑證過期時(shí)，引入重試機(jī)制，即憑證需要強(qiáng)制更新，并重新調(diào)用API接口//本示例重試最多3次，3次失敗則不再繼續(xù)重試。for(inti=0;i<3;i++){StringAccess_Token=getToken(i>0).getAccessToken();Stringresult=APIInvoke(Url,Access_Token,Params);If("1".equals(result)){break;}}}}此方法預(yù)期會出現(xiàn)3類異常情況，針對各類異常的信息和處置方法上述代碼引用Jar包下載：表3-3異常解決方案"error='invalid_client',或description='非法的ClientID'"請檢查AppKey值是否配置準(zhǔn)確error='unauthorized_client',description='未驗(yàn)證通過的客戶端身份'請檢查AppSecret值是否配置準(zhǔn)確mon.exception.OAuthSystemException:java.io.FileNotFoundException請檢查AppKey值是否配置準(zhǔn)確3.4、標(biāo)準(zhǔn)代碼定義表3-4返回代碼代碼定義1上傳成功（業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口、證書狀態(tài)變更接口、電子證照文件歸集接口、數(shù)據(jù)更正接口）上傳成功，操作類型為01或02時(shí)返回二維碼賦碼（業(yè)務(wù)數(shù)據(jù)賦碼接口）0上傳失敗，并返回具體錯(cuò)誤原因500內(nèi)部服務(wù)器錯(cuò)誤二維碼賦碼加解密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*加密后的證照的唯一標(biāo)識*@paramencryKey*ras加密后的key*@paramprivateKeyString*私鑰*/publicJSONObjectdecryption(StringencryCertid,StringencryKey,StringprivateKeyString){JSONObjectrtnObj=newJSONObject();try{//先將key進(jìn)行ras解密StringdecryKey=RasDecrypt(encryKey,privateKeyString);//生成密鑰對象,如果算法是DES，那么這個(gè)構(gòu)造函數(shù)不會檢查key是否為8個(gè)字節(jié)長SecretKeySpecsecretKeySpec=newSecretKeySpec(decryKey.getBytes(),"DES");//獲取加解密實(shí)例Ciphercipher=Cipher.getInstance("DES/ECB/PKCS5Padding");//初始化解密模式cipher.init(Cipher.DECRYPT_MODE,secretKeySpec);//HexBinaryAdapter十六進(jìn)制轉(zhuǎn)換工具HexBinaryAdapterhexBinaryAdapter=newHexBinaryAdapter();//解密byte[]ecertidResult=cipher.doFinal(hexBinaryAdapter.unmarshal(encryCertid));//結(jié)果rtnObj.put("certid",newString(ecertidResult));rtnObj.put("decryKey",decryKey);}catch(Exceptione){logger.error(e.getMessage(),e);}returnrtnObj;}4.1.4、解密結(jié)果示例{"certid":"202232000001000001","decryKey":"12345678"}4.1.5、說明結(jié)果包含內(nèi)容：certid：二維碼賦碼，通過“4.1.3解密方法”解密decryKey：8位數(shù)字，通過“4.1.3解密方法”解密以上解密方法需要的privateKeyString私鑰參數(shù)值，由住房和城鄉(xiāng)建設(shè)部全國工程質(zhì)量安全監(jiān)管信息平臺技術(shù)支持單獨(dú)提供。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、加密方法加密方法如下：/***返回加密后的證照及企業(yè)和key*@paramcertid*證照的唯一標(biāo)識ID賦碼*@parampublicKeyString*公鑰字符串（部里單獨(dú)提供給省里）*@return*/publicJSONObjectencryption(Stringcertid,StringpublicKeyString){JSONObjectrtnObj=newJSONObject();try{//隨機(jī)生成8個(gè)字符的字符串（以下key值只是示例，可以指定或者隨機(jī)生成）Stringkey="12345678";//RandomStringUtils.randomAlphanumeric(8);//生成密鑰對象,如果算法是DES，那么這個(gè)構(gòu)造函數(shù)不會檢查key是否為8個(gè)字節(jié)長SecretKeySpecsecretKeySpec=newSecretKeySpec(key.getBytes(),"DES");//獲取加解密實(shí)例Ciphercipher=Cipher.getInstance("DES/ECB/PKCS5Padding");//初始化加密模式cipher.init(Cipher.ENCRYPT_MODE,secretKeySpec);//加密byte[]ecertidByte=cipher.doFinal(certid.getBytes());//HexBinaryAdapter十六進(jìn)制轉(zhuǎn)換工具,把byte數(shù)據(jù)轉(zhuǎn)換成十六進(jìn)制的字符串表示。HexBinaryAdapterhexBinaryAdapter=newHexBinaryAdapter();//返回的ID密文rtnObj.put("encryCertid",hexBinaryAdapter.marshal(ecertidByte));//將隨機(jī)字符串用ras加密StringencryKey=RasEncrypt(key,publicKeyString);//返回的key密文rtnObj.put("encryKey",encryKey);}catch(Exceptione){logger.error(e.getMessage(),e);}returnrtnObj;}4.2.4、加密結(jié)果示例明文如下：密文如下：/fwmh/middlepage.html?ID=8B9704DDABA730072E5546FD5B8F61E4890FE52BAB2E71B8&k=XX8U+FFI3yRWEZ0UQ1qJxS+gsdth779BypvXY5MKfNRELdegoHfCoymJUNG4Q/rTco69eBZ1TYEK+rCNrCbVAg==&certype=11100000000013338W050&province=5100004.2.5、說明二維碼賦碼包含內(nèi)容：URL：二維碼掃碼查詢提示頁面，固定為：/fwmh/middlepage.htmlID：二維碼賦碼的密文，通過“4.2.3加密方法”加密k：8位隨機(jī)密鑰，通過“4.2.3加密方法”加密certype：電子證照類型代碼。表4-2-5證照類型名稱證照類型代碼建筑施工企業(yè)安全生產(chǎn)許可證11100000000013338W050建筑施工特種作業(yè)人員操作資格證書11100000000013338W032安全生產(chǎn)管理人員安全生產(chǎn)考核合格證書11100000000013338W011province：固定值對接省份6位轄區(qū)代碼以上加密方法需要的publicKeyString公鑰參數(shù)值，由住房和城鄉(xiāng)建設(shè)部全國工程質(zhì)量安全監(jiān)管信息平臺技術(shù)支持單獨(dú)提供。對接接口標(biāo)準(zhǔn)5.1、建筑施工企業(yè)安全生產(chǎn)許可證根據(jù)業(yè)務(wù)場景提供安許證調(diào)用接口的詳細(xì)說明，流程指南詳見附錄1。推送操作類型原證書狀態(tài)推送的證書狀態(tài)是否賦碼調(diào)用接口順序1、辦理新發(fā)電子證照和既有電子證照后續(xù)業(yè)務(wù)場景辦理新發(fā)電子證照/有效是①業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口②業(yè)務(wù)數(shù)據(jù)賦碼接口③電子證照文件歸集接口辦理延續(xù)有效有效是辦理延續(xù)失效有效是辦理延續(xù)其他有效是辦理變更有效有效是辦理暫扣有效暫扣否證書狀態(tài)變更接口辦理暫扣其他暫扣否辦理暫扣發(fā)還暫扣有效否辦理暫扣發(fā)還暫扣失效否辦理過期失效有效失效否辦理注銷（撤銷、吊銷）有效注銷否辦理注銷（撤銷、吊銷）有效吊銷否辦理注銷（撤銷、吊銷）有效撤銷否辦理注銷（撤銷、吊銷）失效注銷否辦理注銷（撤銷、吊銷）暫扣吊銷否辦理注銷（撤銷、吊銷）其他吊銷否辦理注銷（撤銷、吊銷）其他撤銷否辦理其他業(yè)務(wù)有效其他否辦理其他業(yè)務(wù)其他有效否辦理其他業(yè)務(wù)其他失效否辦理其他業(yè)務(wù)其他其他否2、辦理存量證書換發(fā)電子證照場景辦理新發(fā)電子證照/有效是①業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口②業(yè)務(wù)數(shù)據(jù)賦碼接口③電子證照文件歸集接口辦理新發(fā)電子證照/暫扣是辦理新發(fā)電子證照/其他是5.1.1、業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口使用場景說明：省級電子證照系統(tǒng)進(jìn)行業(yè)務(wù)審批需要上報(bào)建筑施工企業(yè)安全生產(chǎn)許可證業(yè)務(wù)數(shù)據(jù)時(shí)，提前對數(shù)據(jù)預(yù)校驗(yàn)，可以申請調(diào)用業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口。表5-1-1接口信息接口地址******請求方式POST返回方式JSON接口說明建筑施工企業(yè)安全生產(chǎn)許可證業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口；支持多條數(shù)據(jù)上傳，單次上傳上限50條。請求參數(shù)名稱數(shù)據(jù)類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注eCertIDC..50是業(yè)務(wù)數(shù)據(jù)IDprovinceNumC6是所屬省份，按照民政部官網(wǎng)《2020年中華人民共和國行政區(qū)劃代碼》creditCodeC18是統(tǒng)一社會信用代碼，持該證照的建筑施工企業(yè)的統(tǒng)一社會信用代碼operateTypeC2是操作類型，詳見6.1-操作類型代碼表和6.1-證書狀態(tài)與操作類型關(guān)系代碼表certNumC..26滿足條件必填證照編號，建筑施工企業(yè)安全生產(chǎn)許可證的唯一編號，按照《全國一體化政務(wù)服務(wù)平臺電子證照建筑企業(yè)安全生產(chǎn)許可證》附錄A.1編號規(guī)則生成，當(dāng)操作類型是辦理延續(xù)、辦理變更時(shí)，需要必填請求參數(shù)示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "provinceNum":"360000", "creditCode":"91361003MA7A******", "operateType":"02","certNum":"（贛）JZ安許證字[2021]******" }]}返回結(jié)果參數(shù)名稱數(shù)據(jù)類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..1000是返回信息ReturnDataJSON是返回?cái)?shù)據(jù)結(jié)果集Json對象ReturnData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注ErrorDataJSON/錯(cuò)誤信息集合，返回代碼為0時(shí)需要+ErrorGuidC..50/錯(cuò)誤數(shù)據(jù)ID，返回代碼為0時(shí)需要+ErrorCodeC..50/錯(cuò)誤碼，返回代碼為0時(shí)需要+creditCodeC18/統(tǒng)一社會信用代碼，返回代碼為0時(shí)需要+ErrorMsgC..1000/錯(cuò)誤信息，返回代碼為0時(shí)需要SuccessDataJSON/成功數(shù)據(jù)集合，返回代碼為1時(shí)需要+eCertIDC..50/業(yè)務(wù)數(shù)據(jù)唯一標(biāo)識，返回代碼為1時(shí)需要+SuccessCodeC..50/成功碼，返回代碼為1時(shí)需要+creditCodeC18/統(tǒng)一社會信用代碼，返回代碼為1時(shí)需要+SuccessMsgC..1000/成功信息，返回代碼為1時(shí)需要WarnDataJSON/預(yù)警信息集合，返回代碼為2時(shí)需要+WarnGuidC..50/預(yù)警數(shù)據(jù)ID，返回代碼為2時(shí)需要+WarnCodeC..50/預(yù)警碼，返回代碼為2時(shí)需要+creditCodeC18/統(tǒng)一社會信用代碼，返回代碼為2時(shí)需要+WarnMsgC..1000/預(yù)警信息，返回代碼為2時(shí)需要返回結(jié)果示例①返回代碼為1時(shí)的結(jié)果信息：{ "ReturnCode":"1", "ReturnMsg":"業(yè)務(wù)數(shù)據(jù)校驗(yàn)成功", "ReturnData":{ "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-AXZ-01", "creditCode":"91361003MA7A******", "SuccessMsg":"該國家標(biāo)準(zhǔn)電子證照業(yè)務(wù)數(shù)據(jù)校驗(yàn)成功" }] }}②返回代碼為0時(shí)的結(jié)果信息：{ "ReturnCode":"0", "ReturnMsg":"業(yè)務(wù)數(shù)據(jù)校驗(yàn)失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-02-AXZ-12", "creditCode":"91361003MA7A******", "ErrorMsg":"該企業(yè)已存在國家標(biāo)準(zhǔn)電子證照，發(fā)證地：湖北省，證照編號：(鄂)JZ安許證字[2019]******" }] }}③返回代碼為2時(shí)的結(jié)果信息：{ "ReturnCode":"2", "ReturnMsg":"業(yè)務(wù)數(shù)據(jù)校驗(yàn)成功有預(yù)警", "ReturnData":{ "WarnData":[{ "WarnGuid":"73faca65c31a484b8f6b719c94******", "WarnCode":"E-02-AXZ-13", "creditCode":"91361003MA7A******", "WarnMsg":"該企業(yè)已存在非標(biāo)準(zhǔn)電子證照，發(fā)證地：湖北省，證照編號：(鄂)JZ安許證字[2019]******" }], "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "SuccessCode":"S-02-AXZ-01", "creditCode":"91361003MA7A******", "SuccessMsg":"該國家標(biāo)準(zhǔn)電子證照業(yè)務(wù)數(shù)據(jù)校驗(yàn)成功" }] }}5.1.2、業(yè)務(wù)數(shù)據(jù)賦碼接口使用場景說明：省級電子證照系統(tǒng)需要上報(bào)建筑施工企業(yè)安全生產(chǎn)許可證業(yè)務(wù)數(shù)據(jù)進(jìn)行歸集并申請二維碼賦碼時(shí)，可以申請調(diào)用業(yè)務(wù)數(shù)據(jù)賦碼接口。表5-1-2接口信息接口地址******請求方式POST返回方式JSON接口說明建筑施工企業(yè)安全生產(chǎn)許可證業(yè)務(wù)數(shù)據(jù)賦碼接口；支持多條數(shù)據(jù)上傳，單次上傳上限50條；操作類型為“01”或“02”時(shí)會進(jìn)行二維碼賦碼。請求參數(shù)名稱數(shù)據(jù)類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注eCertIDC..50是業(yè)務(wù)數(shù)據(jù)IDprovinceNumC6是所屬省份，按照民政部官網(wǎng)《2020年中華人民共和國行政區(qū)劃代碼》certNumC..26是證照編號，建筑施工企業(yè)安全生產(chǎn)許可證的唯一編號，按照《全國一體化政務(wù)服務(wù)平臺電子證照建筑企業(yè)安全生產(chǎn)許可證》附錄A.1編號規(guī)則生成issuAuthC..200是發(fā)證機(jī)關(guān)，負(fù)責(zé)頒發(fā)和管理該建筑施工企業(yè)安全生產(chǎn)許可證的省、自治區(qū)、直轄市人民政府住房城鄉(xiāng)建設(shè)主管部門名稱issuAuthCodeC18是發(fā)證機(jī)關(guān)代碼，發(fā)證機(jī)關(guān)的統(tǒng)一社會信用代碼issuDateDate是發(fā)證日期，該證照頒發(fā)的日期，按照公元紀(jì)年精確至日companyNameC..100是企業(yè)名稱，持該證照的建筑施工企業(yè)名稱，應(yīng)與企業(yè)營業(yè)執(zhí)照中的“企業(yè)名稱”一致creditCodeC18是統(tǒng)一社會信用代碼，持該證照的建筑施工企業(yè)的統(tǒng)一社會信用代碼companyAddressC..200是單位地址，持該證照的建筑施工企業(yè)的單位地址，應(yīng)與企業(yè)營業(yè)執(zhí)照中的“住所”內(nèi)容一致responsiblePersonC..50是法定代表人，持該證照的建筑施工企業(yè)的法定代表人，應(yīng)與企業(yè)營業(yè)執(zhí)照中的“法定代表人”內(nèi)容一致responsiblePersonIDC..18是法定代表人身份證件號碼，法定代表人的有效身份證件號碼responsiblePersonIDTypeC3是法定代表人身份證件號碼類型，法定代表人的有效身份證件號碼類型，可取值為公民身份號碼、護(hù)照號等，從GB/T36903-2018的附錄A中選取economicTypeC..100是經(jīng)濟(jì)類型，持該證照的建筑施工企業(yè)的經(jīng)濟(jì)類型，應(yīng)與企業(yè)營業(yè)執(zhí)照中的“經(jīng)濟(jì)性質(zhì)”內(nèi)容一致licenseScopeC..8是許可范圍，建筑施工企業(yè)進(jìn)行安全生產(chǎn)的許可范圍，固定為“建筑施工”effectiveDateDate是有效期起始日期，該證照有效期的起始日期，按照公元紀(jì)年精確至日expiringDateDate是有效期結(jié)束日期，該證照有效期的結(jié)束日期，按照公元紀(jì)年精確至日firstIssuDateDate是初次領(lǐng)證日期，該證書首次簽發(fā)時(shí)證書上的發(fā)證日期certStateC2是證書狀態(tài)，證書狀態(tài)代碼，詳見6.1-證書狀態(tài)類型代碼表certStatusDescriptionC..200滿足條件必填證書狀態(tài)描述，證書狀態(tài)為“其他”時(shí)進(jìn)行的補(bǔ)充描述associatedZzeCertIDC74滿足條件必填關(guān)聯(lián)證照標(biāo)識，該證書關(guān)聯(lián)的最近一個(gè)已失效建筑施工企業(yè)安全生產(chǎn)許可的電子證照標(biāo)識，規(guī)則同表5-1-4中的“證照標(biāo)識”,當(dāng)操作類型是辦理延續(xù)、辦理變更時(shí)，需要必填businessInformationJSON否業(yè)務(wù)信息，按JSON串方式（第一個(gè)參數(shù)為持證主體或證照本身關(guān)聯(lián)的業(yè)務(wù)類型，第二個(gè)參數(shù)為持證主體或證照本身涉及的業(yè)務(wù)信息）方式組織的對應(yīng)業(yè)務(wù)類型代碼的具體業(yè)務(wù)信息，參數(shù)類型詳見6.1-擴(kuò)展信息類型代碼表operateTypeC2是操作類型，詳見6.1-操作類型代碼表和6.1-證書狀態(tài)與操作類型關(guān)系代碼表請求參數(shù)示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "provinceNum":"360000", "certNum":"（贛）JZ安許證字[2021]******", "issuAuth":"江西省住房和城鄉(xiāng)建設(shè)廳", "issuAuthCode":"113600000145******", "issuDate":"2023-02-25", "companyName":"******建設(shè)工程有限公司", "creditCode":"91361003MA7A******", "companyAddress":"江西省撫州市撫州高新技術(shù)產(chǎn)業(yè)開發(fā)區(qū)******", "responsiblePerson":"許**", "responsiblePersonID":"3625281983******12", "responsiblePersonIDType":"111", "economicType":"有限責(zé)任公司(自然人投資或控股)", "licenseScope":"建筑施工", "effectiveDate":"2021-11-15", "expiringDate":"2024-11-15", "firstIssuDate":"2021-11-15", "certState":"02", "certStatusDescription":"有效",//證書狀態(tài)為“99”時(shí)進(jìn)行的補(bǔ)充描述 "associatedZzeCertID":"005.2.11100000000013338W050.11360000014501199J.2021030019.002.Y", "businessInformation":[{ "itemvalue":"01", "itemtext":"持證企業(yè)的資質(zhì)信息" },{ "itemvalue":"02", "itemtext":"證書處罰處置信息" }], "operateType":"01" }]}返回結(jié)果參數(shù)名稱數(shù)據(jù)類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..1000是返回信息ReturnDataJSON是返回?cái)?shù)據(jù)結(jié)果集Json對象ReturnData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注ErrorDataJSON/錯(cuò)誤信息集合，返回代碼為0時(shí)需要+ErrorGuidC..50/錯(cuò)誤數(shù)據(jù)ID，返回代碼為0時(shí)需要+ErrorCodeC..50/錯(cuò)誤碼，返回代碼為0時(shí)需要+ErrorMsgC..1000/錯(cuò)誤信息，返回代碼為0時(shí)需要SuccessDataJSON/成功數(shù)據(jù)集合，返回代碼為1時(shí)需要+eCertIDC..50/業(yè)務(wù)數(shù)據(jù)唯一標(biāo)識，返回代碼為1時(shí)需要+SuccessCodeC..50/成功碼，返回代碼為1時(shí)需要+encryKeyC..200/二維碼賦碼加密key，返回代碼為1時(shí)需要+encryCertidC..200/二維碼賦碼加密公鑰，返回代碼為1時(shí)需要+ReturnMsgC..1000/成功信息補(bǔ)充說明，返回代碼為1時(shí)需要WarnDataJSON/預(yù)警信息集合，返回代碼為2時(shí)需要+WarnGuidC..50/預(yù)警信息標(biāo)識，返回代碼為2時(shí)需要+WarnCodeC..50/預(yù)警碼，返回代碼為2時(shí)需要+WarnMsgC..1000/預(yù)警信息，返回代碼為2時(shí)需要返回結(jié)果示例①返回代碼為1時(shí)的結(jié)果信息：{ "ReturnCode":"1", "ReturnMsg":"業(yè)務(wù)數(shù)據(jù)賦碼成功", "ReturnData":{ "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-03-AXZ-02", "encryCertid":"EDBE76D9217A23212E5546FD5B8F61E4671575AD27******", "encryKey":"Th2MCBlpx2sGE69qphb0dtb3yZo4jIJ4F9nWR4kMR5vXvmQDTPm0LT+GO9V+AFXkD1ZH7vm1oHsD3H7e2b******", "ReturnMsg":"" }] }}②返回代碼為0時(shí)的結(jié)果信息：{ "ReturnCode":"0", "ReturnMsg":"業(yè)務(wù)數(shù)據(jù)賦碼失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ErrorCode":"E-03-AXZ-04", "ErrorMsg":

"推送的接口參數(shù)中的省份湖北省，和當(dāng)前調(diào)用方省份江西省不一致，校驗(yàn)失敗，請重新調(diào)整！" "ErrorFields":

[{"FieldName":"所屬省份（provinceNum）","FieldValue":"430000","FieldDesc":""},], }] }}③返回代碼為2時(shí)的結(jié)果信息：{ "ReturnCode":"2", "ReturnMsg":"業(yè)務(wù)數(shù)據(jù)賦碼成功有預(yù)警", "ReturnData":{ "WarnData":[{ "WarnGuid":"73faca65c31a484b8f6b719c94******", "WarnCode":"W-03-AXZ-02", "WarnMsg":"該企業(yè)******建設(shè)工程有限公司已存在非標(biāo)準(zhǔn)電子證照，發(fā)證地：湖北省,證照編號：(鄂)JZ安許證字[2019]******" }], "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-03-AXZ-02", "encryCertid":"EDBE76D9217A23212E5546FD5B8F61E4671575AD27******", "encryKey":"Th2MCBlpx2sGE69qphb0dtb3yZo4jIJ4F9nWR4kMR5vXvmQDTPm0LT+GO9V+AFXkD1ZH7vm1oHsD3H7e2b******", "ReturnMsg":"" }] }}5.1.3、證書狀態(tài)變更接口使用場景說明：當(dāng)對證書狀態(tài)需要更新且不需要賦碼時(shí)，可以申請調(diào)用建筑施工企業(yè)安全生產(chǎn)許可證證書狀態(tài)變更接口。表5-1-3接口信息接口地址******請求方式POST返回方式JSON接口說明建筑施工企業(yè)安全生產(chǎn)許可證證書狀態(tài)變更接口；支持多條數(shù)據(jù)上傳，單次上傳上限50條。請求參數(shù)名稱數(shù)據(jù)類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注eCertIDC..50是業(yè)務(wù)數(shù)據(jù)IDzzeCertIDC74是證照標(biāo)識，由省級建筑施工企業(yè)安全生產(chǎn)許可證電子證照系統(tǒng)按照規(guī)則自動生成的唯一標(biāo)識，按照《全國一體化政務(wù)服務(wù)平臺電子證照建筑施工企業(yè)安全生產(chǎn)許可證》標(biāo)準(zhǔn)附錄A.2生成provinceNumC6是所屬省份，按照民政部官網(wǎng)《2020年中華人民共和國行政區(qū)劃代碼》certNumC..26是證照編號，按照《全國一體化政務(wù)服務(wù)平臺電子證照建筑企業(yè)安全生產(chǎn)許可證》附錄A.1編號規(guī)則生成的證書唯一編號。creditCodeC18是統(tǒng)一社會信用代碼，持該證照的建筑施工企業(yè)的統(tǒng)一社會信用代碼certStateC2是證書狀態(tài)，證書狀態(tài)代碼，詳見6.1-證書狀態(tài)類型代碼表certStatusDescriptionC..200滿足條件必填證書狀態(tài)描述，證書狀態(tài)為“其他”時(shí)進(jìn)行的補(bǔ)充描述operateTypeC2是操作類型，詳見6.1-操作類型代碼表和6.1-證書狀態(tài)與操作類型關(guān)系代碼表請求參數(shù)示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "zzeCertID":"005.2.11100000000013338W050.11360000014501199J.2021030019.002.Y", "provinceNum":"360000", "certNum":"（贛）JZ安許證字[2021]******", "creditCode":"91361003MA7A******", "certState":"01", "certStatusDescription":"",//證書狀態(tài)為“99”時(shí)進(jìn)行的補(bǔ)充描述 "operateType":"03" }]}返回結(jié)果參數(shù)名稱數(shù)據(jù)類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..1000是返回信息ReturnDataJSON是返回?cái)?shù)據(jù)結(jié)果集Json對象ReturnData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注ErrorDataJSON/錯(cuò)誤信息集合，返回代碼為0時(shí)需要+ErrorGuidC..50/錯(cuò)誤數(shù)據(jù)ID，返回代碼為0時(shí)需要+ErrorCodeC..50/錯(cuò)誤碼，返回代碼為0時(shí)需要+certNumC..26/證照編號，返回代碼為0時(shí)需要+ErrorMsgC..1000/錯(cuò)誤信息，返回代碼為0時(shí)需要SuccessDataJSON/成功數(shù)據(jù)集合，返回代碼為1時(shí)需要+eCertIDC..50/業(yè)務(wù)數(shù)據(jù)唯一標(biāo)識，返回代碼為1時(shí)需要+SuccessCodeC..50/成功碼，返回代碼為1時(shí)需要+certNumC..26/證照編號，返回代碼為1時(shí)需要+SuccessMsgC..1000/成功信息，返回代碼為1時(shí)需要返回結(jié)果示例①返回代碼為1時(shí)的結(jié)果信息：{ "ReturnCode":"1", "ReturnMsg":"證書狀態(tài)更新成功", "ReturnData":{ "SuccessData":[{ "eCertID":"73faca65c31a484b8f6b719c94******","SuccessCode":"S-04-AXZ-02", "certNum":"（贛）JZ安許證字[2021]******", "SuccessMsg":"該國家標(biāo)準(zhǔn)電子證照證書狀態(tài)更新成功" }] }}②返回代碼為0時(shí)的結(jié)果信息：{ "ReturnCode":"0", "ReturnMsg":"證書狀態(tài)更新失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******","ErrorCode":"E-04-AXZ-12", "certNum":"（贛）JZ安許證字[2021]******", "ErrorMsg":"該企業(yè)XX已存在電子證照，發(fā)證地江西省，證書編號：（贛）JZ安許證字[2023]133813" }] }}5.1.4、電子證照文件歸集接口使用場景說明：省級電子證照系統(tǒng)需要上報(bào)建筑施工企業(yè)安全生產(chǎn)許可證電子證照文件信息進(jìn)行歸集時(shí)，可以申請調(diào)用電子證照文件歸集接口。表5-1-4接口信息接口地址******請求方式POST返回方式JSON接口說明建筑施工企業(yè)安全生產(chǎn)許可證電子證照文件歸集接口；支持多條數(shù)據(jù)上傳，單次上傳上限50條。請求參數(shù)名稱數(shù)據(jù)類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注IDC..50是二維碼賦碼，業(yè)務(wù)數(shù)據(jù)歸集接口匯集成功后，如符合發(fā)放電子證照要求，則會生成二維碼賦碼密文，通過“4.1二維碼賦碼密文解密方法”解密后生成二維碼賦碼zzeCertIDC74是證照標(biāo)識，由省級建筑施工企業(yè)安全生產(chǎn)許可證電子證照系統(tǒng)按照規(guī)則自動生成的唯一標(biāo)識，按照《全國一體化政務(wù)服務(wù)平臺電子證照建筑施工企業(yè)安全生產(chǎn)許可證》標(biāo)準(zhǔn)附錄A.2生成urlC..200是證照預(yù)覽地址，安全生產(chǎn)許可電子證照預(yù)覽頁面URL地址，需https域名互聯(lián)網(wǎng)訪問請求參數(shù)示例{ "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" }]}返回結(jié)果參數(shù)名稱數(shù)據(jù)類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..1000是返回信息ReturnDataJSON是返回?cái)?shù)據(jù)結(jié)果集Json對象ReturnData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注ErrorDataJSON/錯(cuò)誤信息集合，返回代碼為0時(shí)需要+ErrorGuidC..50/錯(cuò)誤數(shù)據(jù)ID，返回代碼為0時(shí)需要+IDC..50/二維碼賦碼，返回代碼為0時(shí)需要+ErrorCodeC..50/錯(cuò)誤碼，返回代碼為0時(shí)需要+certNumC..26/證照編號，返回代碼為0時(shí)需要+ErrorMsgC..1000/錯(cuò)誤信息，返回代碼為0時(shí)需要SuccessDataJSON/成功數(shù)據(jù)集合，返回代碼為1時(shí)需要+IDC..50/二維碼賦碼，返回代碼為1時(shí)需要+SucccessCodeC..50/成功碼，返回代碼為1時(shí)需要+certNumC..26/證照編號，返回代碼為1時(shí)需要+SuccessMsgC..1000/成功信息，返回代碼為1時(shí)需要返回結(jié)果示例①返回代碼為1時(shí)的結(jié)果信息：{ "ReturnCode":"1", "ReturnMsg":"電子證照文件歸集成功", "ReturnData":{"SuccessData":[{ "ID":"1100002022000000001", "SuccessCode":"S-XX-XXX-XX", "certNum":"（贛）JZ安許證字[2021]******", "SuccessMsg":"該國家標(biāo)準(zhǔn)電子證照證照文件歸集成功！" }]}}②返回代碼為0時(shí)的結(jié)果信息：{ "ReturnCode":"0", "ReturnMsg":"電子證照文件歸集失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "ID":"1100002022000000001", "ErrorCode":"E-XX-XXX-XX", "certNum":"（贛）JZ安許證字[2021]******", "ErrorMsg":"賦碼已使用" }] }}5.1.5、數(shù)據(jù)更正接口使用場景說明：僅當(dāng)數(shù)據(jù)推送錯(cuò)誤需要更正數(shù)據(jù)時(shí)，可以申請調(diào)用建筑施工企業(yè)安全生產(chǎn)許可證數(shù)據(jù)更正接口。該接口按需開放使用。表5-1-5接口信息接口地址******請求方式POST返回方式JSON接口說明建筑施工企業(yè)安全生產(chǎn)許可證數(shù)據(jù)更正接口；支持多條數(shù)據(jù)上傳，單次上傳上限50條；業(yè)務(wù)數(shù)據(jù)ID、證照標(biāo)識、所屬省份、證照編號以及統(tǒng)一社會信用代碼關(guān)鍵字段不允許更正。請求參數(shù)名稱數(shù)據(jù)類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注eCertIDC..50是業(yè)務(wù)數(shù)據(jù)ID，待更正的原證照業(yè)務(wù)數(shù)據(jù)ID，不可更正zzeCertIDC74是證照標(biāo)識，由省級建筑施工企業(yè)安全生產(chǎn)許可證電子證照系統(tǒng)按照規(guī)則自動生成的唯一標(biāo)識，按照《全國一體化政務(wù)服務(wù)平臺電子證照建筑施工企業(yè)安全生產(chǎn)許可證》標(biāo)準(zhǔn)附錄A.2生成，不可更正provinceNumC6是所屬省份，按照民政部官網(wǎng)《2020年中華人民共和國行政區(qū)劃代碼》，不可更正certNumC..26是證照編號，建筑施工企業(yè)安全生產(chǎn)許可證的唯一編號，按照《全國一體化政務(wù)服務(wù)平臺電子證照建筑企業(yè)安全生產(chǎn)許可證》附錄A.1編號規(guī)則生成的證書唯一編號，不可更正creditCodeC18是統(tǒng)一社會信用代碼，持該證照的建筑施工企業(yè)的統(tǒng)一社會信用代碼，不可更正issuAuthC..200否發(fā)證機(jī)關(guān)，負(fù)責(zé)頒發(fā)和管理該建筑施工企業(yè)安全生產(chǎn)許可證的省、自治區(qū)、直轄市人民政府住房城鄉(xiāng)建設(shè)主管部門名稱，可更正issuAuthCodeC18否發(fā)證機(jī)關(guān)代碼，發(fā)證機(jī)關(guān)的統(tǒng)一社會信用代碼，可更正issuDateDate否發(fā)證日期，該證照頒發(fā)的日期，按照公元紀(jì)年精確至日，可更正companyNameC..100否企業(yè)名稱，持該證照的建筑施工企業(yè)名稱，應(yīng)與企業(yè)營業(yè)執(zhí)照中的“企業(yè)名稱”一致，可更正companyAddressC..200否單位地址，持該證照的建筑施工企業(yè)的單位地址，應(yīng)與企業(yè)營業(yè)執(zhí)照中的“住所”內(nèi)容一致，可更正responsiblePersonC..50否法定代表人，持該證照的建筑施工企業(yè)的法定代表人，應(yīng)與企業(yè)營業(yè)執(zhí)照中的“法定代表人”內(nèi)容一致，可更正responsiblePersonIDC..18否法定代表人身份證件號碼，法定代表人的有效身份證件號碼，可更正responsiblePersonIDTypeC3否法定代表人身份證件號碼類型，法定代表人的有效身份證件號碼類型，可取值為公民身份號碼、護(hù)照號等，從GB/T36903-2018的附錄A中選取，可更正economicTypeC..100否經(jīng)濟(jì)類型，持該證照的建筑施工企業(yè)的經(jīng)濟(jì)類型，應(yīng)與企業(yè)營業(yè)執(zhí)照中的“經(jīng)濟(jì)性質(zhì)”內(nèi)容一致，可更正licenseScopeC..8否許可范圍，建筑施工企業(yè)進(jìn)行安全生產(chǎn)的許可范圍，固定為“建筑施工”，可更正effectiveDateDate否有效期起始日期，該證照有效期的起始日期，按照公元紀(jì)年精確至日，可更正expiringDateDate否有效期結(jié)束日期，該證照有效期的結(jié)束日期，按照公元紀(jì)年精確至日，可更正firstIssuDateDate否初次領(lǐng)證日期，該證書首次簽發(fā)時(shí)證書上的發(fā)證日期，可更正certStateC2否證書狀態(tài)，證書狀態(tài)代碼，詳見6.1-證書狀態(tài)類型代碼表，可更正certStatusDescriptionC..200否證書狀態(tài)描述，證書狀態(tài)為“其他”時(shí)進(jìn)行的補(bǔ)充描述，可更正associatedZzeCertIDC74否關(guān)聯(lián)證照標(biāo)識，該證書關(guān)聯(lián)的最近一個(gè)已失效建筑施工企業(yè)安全生產(chǎn)許可的電子證照標(biāo)識，規(guī)則同表5-1-4中的“證照標(biāo)識”，可更正businessInformationJSON否業(yè)務(wù)信息，按JSON串方式（第一個(gè)參數(shù)為持證主體或證照本身關(guān)聯(lián)的業(yè)務(wù)類型，第二個(gè)參數(shù)為持證主體或證照本身涉及的業(yè)務(wù)信息）方式組織的對應(yīng)業(yè)務(wù)類型代碼的具體業(yè)務(wù)信息，參數(shù)類型詳見6.1-擴(kuò)展信息類型代碼表，可更正operateTypeC2否操作類型，詳見6.1-操作類型代碼表和6.1-證書狀態(tài)與操作類型關(guān)系代碼表，更正證書狀態(tài)時(shí)必填urlC..200否證照預(yù)覽地址，安全生產(chǎn)許可電子證照預(yù)覽頁面URL地址，需https域名互聯(lián)網(wǎng)訪問，可更正請求參數(shù)示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "zzeCertID":"005.2.11100000000013338W050.11360000014501199J.2021030019.002.Y", "provinceNum":"360000", "certNum":"（贛）JZ安許證字[2021]******", "creditCode":"91361003MA7A******", "issuAuth":"江西省住房和城鄉(xiāng)建設(shè)廳", "issuAuthCode":"113600000145******", "issuDate":"2023-02-25", "companyName":"******建設(shè)工程有限公司", "companyAddress":"江西省撫州市撫州高新技術(shù)產(chǎn)業(yè)開發(fā)區(qū)******", "responsiblePerson":"許**", "responsiblePersonID":"3625281983******12", "responsiblePersonIDType":"111", "economicType":"有限責(zé)任公司(自然人投資或控股)", "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":"持證企業(yè)的資質(zhì)信息" },{ "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入?yún)㈩A(yù)覽示例返回結(jié)果參數(shù)名稱數(shù)據(jù)類型是否必需備注ReturnCodeC1是返回代碼，詳見6.1-返回代碼代碼表ReturnMsgC..1000是返回信息ReturnDataJSON是返回?cái)?shù)據(jù)結(jié)果集Json對象ReturnData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注ErrorDataJSON/錯(cuò)誤信息集合，返回代碼為0時(shí)需要+ErrorGuidC..50/錯(cuò)誤數(shù)據(jù)ID，返回代碼為0時(shí)需要+certNumC..26/證照編號，返回代碼為0時(shí)需要+ErrorCodeC..50/錯(cuò)誤碼，返回代碼為0時(shí)需要+ErrorMsgC..1000/錯(cuò)誤信息，返回代碼為0時(shí)需要SuccessDataJSON/成功數(shù)據(jù)集合，返回代碼為1時(shí)需要+certNumC..26/證照編號，返回代碼為1時(shí)需要+SuccessCodeC..50/成功碼，返回代碼為1時(shí)需要+SuccessMsgC..1000/成功信息，返回代碼為1時(shí)需要+ReturnMsgC..1000/成功信息補(bǔ)充說明，返回代碼為1時(shí)需要返回結(jié)果示例①返回代碼為1時(shí)的結(jié)果信息：{ "ReturnCode":"1", "ReturnMsg":"數(shù)據(jù)更正上傳成功", "ReturnData":{ "SuccessData":[{ "certNum":"（贛）JZ安許證字[2021]******", "SuccessCode":"S-05-AXZ-01", "SuccessMsg":"國家標(biāo)準(zhǔn)電子證照數(shù)據(jù)更正上傳成功", "ReturnMsg":"" }] }}②返回代碼為0時(shí)的結(jié)果信息：{ "ReturnCode":"0", "ReturnMsg":"數(shù)據(jù)更正上傳失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"73faca65c31a484b8f6b719c94******", "certNum":"（贛）JZ安許證字[2021]******","ErrorCode":"E-05-AXZ-01", "ErrorMsg":"未查到相關(guān)證書，請核查！" }] }}5.2、建筑施工特種作業(yè)操作資格證書根據(jù)業(yè)務(wù)場景提供建筑施工特種作業(yè)操作資格證書調(diào)用接口的詳細(xì)說明，流程指南詳見附錄2。推送操作類型原證書狀態(tài)推送的證書狀態(tài)是否賦碼調(diào)用接口順序1、辦理新發(fā)電子證照和既有電子證照后續(xù)業(yè)務(wù)場景辦理新發(fā)電子證照/有效是①業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口②業(yè)務(wù)數(shù)據(jù)賦碼接口③電子證照文件歸集接口辦理延續(xù)有效有效是辦理延續(xù)失效有效是辦理延續(xù)其他有效是辦理變更有效有效是辦理暫扣有效暫扣否證書狀態(tài)變更接口辦理暫扣其他暫扣否辦理暫扣發(fā)還暫扣有效否辦理暫扣發(fā)還暫扣失效否辦理過期失效有效失效否辦理注銷（撤銷、吊銷）有效注銷否辦理注銷（撤銷、吊銷）有效吊銷否辦理注銷（撤銷、吊銷）有效撤銷否辦理注銷（撤銷、吊銷）失效注銷否辦理注銷（撤銷、吊銷）暫扣吊銷否辦理注銷（撤銷、吊銷）其他吊銷否辦理注銷（撤銷、吊銷）其他撤銷否辦理其他業(yè)務(wù)有效其他否辦理其他業(yè)務(wù)其他有效否辦理其他業(yè)務(wù)其他失效否辦理其他業(yè)務(wù)其他其他否2、辦理存量證書換發(fā)電子證照場景辦理新發(fā)電子證照/有效是①業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口②業(yè)務(wù)數(shù)據(jù)賦碼接口③電子證照文件歸集接口辦理新發(fā)電子證照/暫扣是辦理新發(fā)電子證照/其他是5.2.1、業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口使用場景說明：省級電子證照系統(tǒng)進(jìn)行業(yè)務(wù)審批需要上報(bào)建筑施工特種作業(yè)操作資格證書業(yè)務(wù)數(shù)據(jù)時(shí)，提前對數(shù)據(jù)預(yù)校驗(yàn)，可以申請調(diào)用業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口。表5-2-1接口信息接口地址******請求方式POST返回方式JSON接口說明建筑施工特種作業(yè)操作資格證書業(yè)務(wù)數(shù)據(jù)校驗(yàn)接口；支持多條數(shù)據(jù)上傳，單次上傳上限50條。請求參數(shù)名稱數(shù)據(jù)類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注eCertIDC..50是業(yè)務(wù)數(shù)據(jù)IDprovinceNumC6是所屬省份，按照民政部官網(wǎng)《2020年中華人民共和國行政區(qū)劃代碼》identityCardC..18是身份證件號碼，持證人員的有效身份證件號operationCategoryC2是工種類別，建筑施工特種作業(yè)人員操作類別的代碼，詳見6.2-工種類別代碼表categoryDescriptionC..100滿足條件必填工種類別描述，當(dāng)操作類別為經(jīng)省級以上住房和城鄉(xiāng)建設(shè)主管部門認(rèn)定的其他工種類別時(shí)，應(yīng)對具體操作類別進(jìn)行的補(bǔ)充描述，固定格式為：“經(jīng)省級以上住房和城鄉(xiāng)建設(shè)主管部門認(rèn)定的其他工種類別（XXX）”operateTypeC2是操作類型，詳見6.2-操作類型代碼表，6.2-證書狀態(tài)與操作類型關(guān)系代碼表certNumC..15滿足條件必填證照編號，建筑施工特種作業(yè)操作資格證書的唯一編號，按照《全國一體化政務(wù)服務(wù)平臺電子證照建筑施工特種作業(yè)操作資格證書》附錄A.1編號規(guī)則生成，當(dāng)操作類型是辦理延續(xù)、辦理變更時(shí)，需要必填請求參數(shù)示例{ "AcceptData":[{ "eCertID":"73faca65c31a484b8f6b719c94******", "provinceNum":"370000", "identityCard":"3708831985******18", "operationCategory":"02", "categoryDescription":"",//工種類別為“99”時(shí)進(jìn)行的補(bǔ)充描述 "operateType":"01", "certNum":"魯H992014******" }]}返回結(jié)果參數(shù)名稱數(shù)據(jù)類型是否必需備注ReturnCodeC1是返回代碼，詳見6.2-返回代碼代碼表ReturnMsgC..1000是返回信息ReturnDataJSON是返回?cái)?shù)據(jù)結(jié)果集Json對象ReturnData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注ErrorDataJSON/錯(cuò)誤信息集合，返回代碼為0時(shí)需要+ErrorGuidC..50/錯(cuò)誤數(shù)據(jù)ID，返回代碼為0時(shí)需要+ErrorCodeC..50/錯(cuò)誤碼，返回代碼為0時(shí)需要+identityCardC..18/身份證件號碼，返回代碼為0時(shí)需要+ErrorMsgC..1000/錯(cuò)誤信息，返回代碼為0時(shí)需要SuccessDataJSON/成功數(shù)據(jù)集合，返回代碼為1時(shí)需要+eCertIDC..50/業(yè)務(wù)數(shù)據(jù)唯一標(biāo)識，返回代碼為1時(shí)需要+SuccessCodeC..50/成功碼，返回代碼為1時(shí)需要+identityCardC..18/身份證件號碼，返回代碼為1時(shí)需要+SuccessMsgC..1000/成功信息，返回代碼為1時(shí)需要WarnDataJSON/預(yù)警信息集合，返回代碼為2時(shí)需要+WarnGuidC..50/預(yù)警數(shù)據(jù)ID，返回代碼為2時(shí)需要+WarnCodeC..50/預(yù)警碼，返回代碼為2時(shí)需要+identityCardC..18/身份證件號碼，返回代碼為2時(shí)需要+WarnMsgC..1000/預(yù)警信息，返回代碼為2時(shí)需要返回結(jié)果示例①返回代碼為1時(shí)的結(jié)果信息：{ "ReturnCode":"1", "ReturnMsg":"業(yè)務(wù)數(shù)據(jù)校驗(yàn)成功", "ReturnData":{ "SuccessData":[{ "eCertID":"b5b630c1-7c43-4ede-847a-5305e2******","SuccessCode":"S-XX-XXX-XX", "identityCard":"3708831985******18", "SuccessMsg":"該國家標(biāo)準(zhǔn)電子證照業(yè)務(wù)數(shù)據(jù)校驗(yàn)成功" }] }}②返回代碼為0時(shí)的結(jié)果信息：{ "ReturnCode":"0", "ReturnMsg":"業(yè)務(wù)數(shù)據(jù)校驗(yàn)失敗", "ReturnData":{ "ErrorData":[{ "ErrorGuid":"b5b630c1-7c43-4ede-847a-5305e2******","ErrorCode":"E-XX-XXX-XX", "identityCard":"3708831985******18", "ErrorMsg":"該人員已存在工種類別（建筑電工）的國家標(biāo)準(zhǔn)電子證照，發(fā)證地：湖北省，證照編號：魯H992014******" }] }}③返回代碼為2時(shí)的結(jié)果信息：{ "ReturnCode":"2", "ReturnMsg":"業(yè)務(wù)數(shù)據(jù)校驗(yàn)成功有預(yù)警", "ReturnData":{ "WarnData":[{ "WarnGuid":"b5b630c1-7c43-4ede-847a-5305e2******","WarnCode":"W-XX-XXX-XX", "identityCard":"3708831985******18", "WarnMsg":"該人員已存在工種類別（建筑電工）的非標(biāo)準(zhǔn)電子證照，發(fā)證地：湖北省，證照編號：魯H992014******" }], "SuccessData":[{ "eCertID":"b5b630c1-7c43-4ede-847a-5305e2******","SuccessCode":"S-XX-XXX-XX", "identityCard":"3708831985******18", "SuccessMsg":"該國家標(biāo)準(zhǔn)電子證照業(yè)務(wù)數(shù)據(jù)校驗(yàn)成功" }] }}5.2.2、業(yè)務(wù)數(shù)據(jù)賦碼接口使用場景說明：省級電子證照系統(tǒng)需要上報(bào)建筑施工特種作業(yè)操作資格證書業(yè)務(wù)數(shù)據(jù)進(jìn)行歸集并申請二維碼賦碼時(shí)，可以申請調(diào)用業(yè)務(wù)數(shù)據(jù)賦碼接口。表5-2-2接口信息接口地址******請求方式POST返回方式JSON接口說明建筑施工特種作業(yè)操作資格證書業(yè)務(wù)數(shù)據(jù)賦碼接口；支持多條數(shù)據(jù)上傳，單次上傳上限50條；操作類型為“01”或“02”時(shí)會進(jìn)行二維碼賦碼。請求參數(shù)名稱數(shù)據(jù)類型是否必需備注AcceptDataJSON是記錄集合。Json對象AcceptData相關(guān)字段名稱數(shù)據(jù)類型是否必需備注eCertIDC..50是業(yè)務(wù)數(shù)據(jù)IDprovinceNumC6是所屬省份，按照民政部官網(wǎng)《2020年中華人民共和國行政區(qū)劃代碼》certNumC..15是證照編號，建筑施工特種作業(yè)操作資格證書的唯一編號，按照《全國一體化政務(wù)服務(wù)平臺電子證照建筑施工特種作業(yè)操作資格證書》附錄A.1編號規(guī)則生成issuAuthC..200是發(fā)證機(jī)關(guān)，負(fù)責(zé)頒發(fā)和管理該建筑施工特種作業(yè)操作資格證書的省、自治區(qū)、直轄市人民政府住房城鄉(xiāng)建設(shè)主管部門名稱issuAuthCodeC18是發(fā)證機(jī)關(guān)代碼，證照頒發(fā)機(jī)構(gòu)的統(tǒng)一社會信用代碼issuedDateDate是初次領(lǐng)證日期，持證人第一次領(lǐng)取該證照的日期，按照公元紀(jì)年精確至日issuDateDate是發(fā)證日期，該證照的頒發(fā)日期，如首次發(fā)證，則發(fā)證日期等于初次領(lǐng)證日期，如證書復(fù)核延續(xù)，發(fā)證日期為延續(xù)后新證書的頒發(fā)日期，按照公元紀(jì)年精確至日effectiveDateDate是有效期起始日期，該證照有效期的起始日期，按照公元紀(jì)年精確至日expiringDateDate是有效期結(jié)束日期，該證照有效期的結(jié)束日期，按照公元紀(jì)年精確至日nameC..50是姓名，持證人姓名，應(yīng)與持證人身份證件記載信息一致genderC1是性別，持證人的性別代碼，應(yīng)與持證人身份證件記載信息一致。1表示男，2表示女，詳見6.2-性別代碼表identityCard