法人和其他組織統一社會信用代碼數據共享應用規范creditidentifierforlega2024-01-28發布2024-02-18實施北京市市場監督管理局發布I 引言 12規范性引用文件 13術語和定義 1 15數據共享應用框架 26網絡要求 47安全要求 48數據應用方式 49數據應用調用信息 附錄A(資料性)統一社會信用代碼基礎數據接口調用方法示例 附錄B(資料性)統一社會信用代碼變更數據接口調用方法示例 附錄C(資料性)統一社會信用代碼股東數據接口調用方法示例 參考文獻 為推進京津冀協同發展戰略實施，北京市市場監督管理局、天津市市場監督管理委員會、河北省市場監督管理局共同組織制定本地方標準，在京津冀區域內適用，現予發布。本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結構和起草規則》的規定本文件由北京市市場監督管理局提出并歸口。本文件由北京市市場監督管理局組織實施。本文件起草單位：(河北組)河北省標準化研究院。(北京組)北京市市場監督管理局風險管理中心。(天津組)天津市標準化研究院。本文件主要起草人：(河北組)李峰、李會、閆志強、尚曉帆、陳聰、高思瑤、王子康、董世濤、閻占輝。(北京組)胡偉、楊德富、蔡欣暢、朱海綾、張贏、王健。(天津組)張楠、由方嵐、趙漢杰、徐超、董津生、張然。DH1/T3041—2024本文件以京津冀法人和其他組織統一社會信用代碼數據庫為基礎，規范了統一社會信用代碼數據的共享與應用，解決了數據服務動態性差、共享與應用效率低、數據存儲成本高等問題，為各政務部門的不同需求，提供了個性化、差異性服務，推動了三地統一社會信用代碼數據資源深度共享。1法人和其他組織統一社會信用代碼數據共享應用規范1范圍本文件規定了京津冀統一社會信用代碼數據共享應用框架、網絡要求、安全要求、數據應用方式和數據應用調用信息。本文件適用于政務部門通過數據共享平臺以接口方式進行的京津冀統一社會信用代碼數據信息共2規范性引用文件下列文件中的內容通過文中的規范性引用而構成本文件必不可少的條款。其中，注日期的引用文件，僅該日期對應的版本適用于本文件；不注日期的引用文件，其最新版本(包括所有的修改單)適用于本文件。GB/T2260中華人民共和國行政區劃代碼GB/T4754國民經濟行業分類GB/T14733.8電信術語電話GB/T22239信息安全技術網絡安全等級保護基本要求GB32100法人和其他組織統一社會信用代碼編碼規則3術語和定義下列術語和定義適用于本文件。接口用戶向接口發出的一次調用申請。響應response接口向接口用戶返回請求的操作結果。包體packagebody數據傳輸中的實體主體部分。4縮略語下列縮略語適用于本文件。HTTPS基于安全套接字的超文本傳輸協議(HypertextTransferProtocolSecure)JSONJS對象標記(JavaScriptObjectNotation)25數據共享應用框架5.1共享應用模型數據共享應用模型包括數據共享概念模型和數據共享技術架構。數據共享技術架構是支持數據共享概念模型的邏輯框架。其中：a)數據共享概念模型：描述了信息的提供方、使用方及應用方遵循已確定的信息共享規程，進行數據共享的業務過程；b)數據共享技術架構：描述了支持數據共享實現的技術要求。5.1.2數據共享概念模型提供方、管理方和應用方通過數據交換行為實現數據共享活動，如圖1所示。圖1數據共享概念模型共享角色按照數據共享業務視角對數據共享角色進行分類，包括提供方、管理方和應用方：a)提供方：提供共享數據的機構；b)管理方：管理共享數據應用合規性的機構；c)應用方：應用數據的機構。共享行為遵照管理方批準的規程，提供方、管理方和應用方的數據共享活動通過數據交換行為實現：a)提供方將數據傳輸給管理方，由管理方發布到數據共享平臺；b)應用方通過共享平臺將查詢內容提交給管理方，管理方向應用方提供查詢結果，并將查詢結果反饋提供方；c)應用方查詢內容涉及敏感信息的，需預先征得數據提供方同意后，方能獲取查詢結果。5.1.3數據共享技術架構圍繞需要政務部門間共享的數據給出了數據共享技術架構，如圖2所示，架構包括以下內容：a)網絡：為數據共享提供網絡基礎設施支撐，包括互聯網、電子政務外網；b)數據：數據共享過程中產生的信息，包括數據內容、數據編碼、數據質量、數據表達；c)系統：數據共享過程中數據管理方和應用方進行數據共享的平臺，包括目錄系統和交換系統；d)安全：包括安全管理和安全技術；e)管理：包括數據內容管理、數據字典管理及數據日常維護管理等方面的內容。3吐發平真術吐發平真術目只系統據向安士代近又換雜說望據京安傘配置數據共享內容)結束45.22共享申請、許可和響應5.22.1數據應用方向數據管理方提交數據共享應用申請，申請信息包括但不限于以下內容：a)機構統一社會信用代碼；b)機構名稱；c)用于實現數據共享應用設備的IP地址；e)申請使用數據項；f)申請使用數據范圍。5.22.2數據管理方收到申請后，生成許可信息反饋給數據應用方，許可信息包括但不限于以下內容：a)機構統一社會信用代碼；b)機構名稱；c)用戶賬號；d)用戶密碼；e)用于實現數據共享應用設備的IP地址；g)數據共享平臺地址。5.22.3數據應用方通過數據共享平臺調用數據信息時，應提供被授予的許可信息。5.22.4數據管理方在接收到請求后，校驗數據應用方許可信息中用戶賬號和用戶密碼的合法性、用于實現數據共享應用設備的IP地址和申請使用期限的有效性，檢驗通過后，執行請求，返回響應內容。6網絡要求數據共享應用網絡要求如下：a)敏感數據應通過電子政務外網傳輸；b)其他信息可通過互聯網傳輸。7安全要求應符合GB/T22239的相關要求。8數據應用方式81概述數據應用方通過嵌入到數據共享平臺中的接口調用統一社會信用代碼基礎數據、統一社會信用代碼變更數據和統一社會信用代碼股東數據。82接口定義統一社會信用代碼接口定義見表1。5表1統一社會信用代碼接口定義定義說明統一社會信用代碼基礎數據接口信用代碼基礎數據接口名稱；用代碼基礎數據接口名稱；用代碼基礎數據接口名稱；統一社會信用代碼變更數據接口變更數據接口名稱；更數據接口名稱；更數據接口名稱；統一社會信用代碼股東數據接口股東數據接口名稱；8.3基本約定8.3.1傳輸協議8.3.2地址格式接口地址由數據管理方提供，格式為：https://xxx.xxx.xxx.xxx/servicespath/servicename。其中，xxx.xxx.xxx.xxx表示接口所在服務器的有效地址；services_path表示接口的發布路徑，由數據管理方命名；service_name表示約定的接口名稱，由數據管理方命名。8.3.3調用方法統一社會信用代碼基礎數據、統一社會信用代碼變更數據、統一社會信用代碼股東數據接口調用方法示例分別見附錄A、附錄B和附錄C。684統一社會信用代碼基礎信息接口841許可參數841.1內容組成許可參數由一組用戶信息組成。841.2包體標記及含義許可參數包體標記及含義說明見表2。表2許可參數包體標記及含義說明統一社會信用代碼 使用期限開始時間使用期限結束時間841.3包體格式說明許可參數包體采用JSON格式。許可參數放置在標記{…}之間，見示例1。示例1:{}842條件參數包體842.1內容組成條件參數由條件邏輯關系、條件數據項集、返回結果數據項名稱組成，如圖4所示。圖4條件參數78.4.22條件參數包體格式說明條件參數包體采用JSON格式。條件參數放置在標記{"exp":"xxx","fields":[{"field":"xxx","operation":"xxx","value":"xxx"},…,{"field":"xxexp關鍵字為條件邏輯關系。其中“與”、“或”分別用“*”、“+”標識；為空時，默認為“與”;在邏輯關系中，第一個條件數據項用[0]表示，第二個用[1]表示，以此類推，第n個用[n-1]表示，各fields關鍵字為條件數據項集。其中field關鍵字為條件數據項；operation為條件數據項的關系運算符，其表示及含義見表3;value為條件數據項的值。result關鍵字為返回結果中用戶要求的數據項名稱，各數據項間以英文“,”分隔。數據項標識應符合本文件8.4.5的規定。表3關系運算符表示及含義說明1.字符型按字符編碼順序進行比較；2.數值型應轉換成數值進行比較；3.日期型應轉換成日期進行比較；小于小于或等于不等于 條件參數包體格式見示例2。示例2:{{{{8IR1/T3041—2024}resut":"tyshxydm,jJgmc,}8.43返回結果數據包格式參數接口返回結果數據包格式參數由數據應用方根據需要設定。該參數取值可為xml或json,不能為8.4.4返回結果內容組成返回結果包括調用狀態信息、結果數據和結果集記錄數。接口調用失敗時，只返回調用狀態信息，見圖5。調用狀態信息結果數據結果記錄數據1數據項1…數據項n結果集記錄數結果記錄數據n圖5返回結果包體格式說明XM格式返回結果中的調用狀態和結果集記錄數信息放置在標記status為調用狀態代碼，Isg為調用狀態描述，totalcount為結果集記錄個數。調用狀態代碼和描述應符合第9章的規定。數據項標識應符合8.4.5的規定。返回結果包體XML格式見示例3。示例3:<DATAPACKETVersion="2.9在respdata標簽內，關鍵字status為調用狀態代碼，msg為調用狀態描述，totalcount為結果集記錄個數。調用狀態代碼和描述應符合本文件9的規定。在rowdata標簽內，每條結果數據記錄放置在標記{…}之間。數據記錄中的數據項標識應符合本文件8.4.5的規定。返回結果包體JSON格式見示例4。示例4:{{"jgmc":"xx省(市)xxx股份有限公司",{]}8.4.5應用服務數據項統一社會信用代碼基礎信息接口服務提供的數據項見表4。表4統一社會信用代碼基礎信息接口服務數據項說明統一社會信用代碼 經營范圍 成立日期 登記業務類型1:"正常"(存續、在營、開業、注冊、設立)2:"吊銷，未注銷";3:"吊銷，已注銷”;4:“注銷”;5:"撤銷”;6:"遷IR1/T3041—2024表4統一社會信用代碼基礎信息接口服務數據項(續)說明最后更新日期 8.5統一社會信用代碼變更信息接口8.5.1許可參數內容組成許可參數由一組用戶信息組成。包體標記及含義許可參數包體標記及含義說明見表5。表5許可參數包體標記及含義說明統一社會信用代碼 使用期限開始時間使用期限結束時間包體格式說明許可參數包體采用字串格式。許可參數放置在訪問地址的參數中，見示例5。https://xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xx&rtype=1&ip8.5.2返回結果數據包格式參數參照本文件8.4.3。8.5.3返回結果參照本文件8.4.4。8.5.4應用服務數據項統一社會信用代碼變更信息接口服務提供的數據項見表6。表6統一社會信用代碼變更信息接口服務數據項說明統一社會信用代碼 8.6統一社會信用代碼股東信息接口8.6.1許可參數內容組成許可參數由一組用戶信息組成。包體標記及含義許可參數包體標記及含義說明見表7。表7許可參數包體標記及含義說明統一社會信用代碼 使用期限開始時間使用期限結束時間包體格式說明許可參數包體采用字串格式。許可參數放置在訪問地址的參數里，見示例6。8.6.2返回結果數據包格式參數參照本文件8.4.3。參照本文件8.4.4。統一社會信用代碼股東信息接口服務提供的數據項見表8。說明統一社會信用代碼投資者類型 調用狀態信息包括接口狀態代碼及接口狀態描述，如表9所示。調用成功(資料性)統一社會信用代碼基礎數據接口調用方法示例A.1示例說明以河北省統一社會信用代碼基礎數據接口為例，設定統一社會信用代碼接口地址為：https://11xxxxxxxx17053009,機構名稱為：xx省(市)標準化研究院；通過接口查詢數據的條件是：機構名稱中包含“標準”且包含“研究院”的機構；返回結果包體是：json格式，結果數據項包括：統一社會信用代碼、機構名稱、行政區劃代碼、機構地址、經營范圍、經濟行業代碼、聯系電話、注冊日期、業務類型和最后更新日期。A.2示例程序代碼本示例以java語言實現，程序代碼如下：packagetestjgdm;//包名testjgdmimport.URLEncoder;importorg.apache.importorg.apache.http.util.Epublicclassjgdm{//定義類jgdmpublicstaticvoidmain(String[]args)//調用統一社會信用代碼基礎數據接口獲取符合條件數據的函數{Stringstrkey2="研究院";//查詢關鍵字2strkey=URLEncoder.encode(strkey1,"utf-8");//將查詢關鍵字轉換為utf-8編碼strkey2=URLEncoder.encode(strkey2,{}Stringjgmc="xx省(市)標準化研究院";//許可參數中的jgmcStringip="5:8080";//許可參數中的ip//構建許可參數licencequerys.put("licence","{\"tyshxydm\":\""+tyshxydm+"\",\"jgmc\":\""ey\":\""+appkey+"\",\"appsecret\":\""+appsecret+"\",\"ip\":\""+\":\""+startdate+"\",\"enddate\":\""+enddate//構建返回結果格式參數repl_packagetypequerys.put("repl_packagetype","json");//返回結果數據包為json格式//構建條件參數cond_informationquerys.put("cond_information","{\"exp\":\"[0]*[1]\",\"result\":\fddbrxm,zcdzxzqhdm,zcdz,jyfw,jjhydm,Ixdh,clrq,djywlx,zhgxrq\",\"fields\"d\":\"jgmc\",\"operation\":\"like\",\"value\":\""+strkey1+\"jgmc\",\"operation\":\"like\",\"value\":\""+strkey2+"HttpResponseresponse=HttpUtils.doPost(host+service_path,//獲取反饋的數據包，并在控制窗口中打印出來System.out.printIn(EntityUtils.toString(respons{}(資料性)統一社會信用代碼變更數據接口調用方法示例B1示例說明以河北省統一社會信用代碼變更數據接口為例，設定統一社會信用代碼接口地址為：https://4:8080/dso/HBbgkinfo;接口用戶的統一社會信用代碼為：11xxxxxxxx17053009,機構11xxxxxxxx17053009的變更信息；返回結果包體是：json格式，結果數據項包括：統一社會信用代碼、變更類型、變更前內容、變更后內容和變更日期。R2示例程序代碼本示例以java語言實現，程序代碼如下：packagetestjgdm;//包名testjgdmimport.URLEncoimportjava.util.Map;importorgimportorg.apublicstaticvoidmain(String[]args)//調用變更數據接口獲取符合條件數據的函數{Stringstrkey="xxxxxxXXXXxXXxxxxx";//查詢關鍵字strkey=URLEncoder.encode(strkey,"utf-8");//將查詢關鍵字轉換為utf-8編碼{}Stringhost="https://4:8080";//接口地址Stringmethod="POST";//提交方式Stringappkey="NyyrcP";//許可參數中的appkeyStringappsecret="jttLM7wu";//許可參數中的appsecretStringtydm="11xxxxxxxx17053009";//許可參數中的tydmStringjgmc="xx省(市)標準化研究院";//許可參數中的jgmcStringip="5:8080";//許可參數中的ipStringstartdate="2023-02-01";//許可參數中的startdateStringenddate="2024-01-31";//許可參數中的enddate//構建許可參數licenceStringurl=host+service_path+serivce_name+"?appkey="+appkey+"&aappsecret+"&rtype=1&ip="+ip+"&tyshxytry{//向接口提交請求HttpResponseresponse=HttpUtils.doPost(url,"",method,hea//獲取反饋的數據包，并在控制窗口中打印出來System.out.printIn(EntityUtils.toString(response{(資料性)統一社會信用代碼股東數據接口調用方法示例C.1示例說明以河北省統一社會信用代碼股東數據接口為例，設定統一社會信用代碼接口地址為：https://4:8080/dso/HBinvinfo;接口用戶的機構統一社會信用代碼為：11xxxxxxxx17053009,機構名稱為：xx省(市)標準化研究院；通過接口查詢數據的條件是：統一社會信息用代碼為11xxxxxxxx17053009的股東信息；返回結果包體是：json格式，結果數據項包括：統一社會信用代碼、投資者類型、投資者名稱、認繳出資金額和認繳出資日期。C.2示例程序代碼本示例以java語言實現，程序代碼如下：packagetestjgdm;//包名testjgdmimport.URLEncoimportjava.util.HashNaimportjava.util.Map;importorg.apache.http.HttpResponse;publicclassjgd