DB11!T 3041-2024法人和其他組織統(tǒng)一社會信用代碼數(shù)據(jù)共享應用規(guī)范

ICS35.020CCSA20

DB11北 京 市 地 方 標 準DB11/T3041—2024法人和其他組織統(tǒng)一社會信用代碼數(shù)據(jù)共享應用規(guī)范Specificationofdatasharingandapplicationoftheunifiedsocialcreditidentifierforlegalentitiesandotherorganizations2024-01-28發(fā)布 2024-02-18實施北京市市場監(jiān)督管理局 發(fā)布DB11/T3041—2024目 次前言 II引言 III1范引文件 1語定義 1略語 1據(jù)享用2絡4全4據(jù)用4據(jù)用用12附錄A（料）統(tǒng)社會用碼礎據(jù)口調(diào)方示例 13附錄B（料）統(tǒng)社會用碼更據(jù)口調(diào)方示例 15附錄C（料）統(tǒng)社會用碼東據(jù)口調(diào)方示例 17參考19IDB11/T3041—2024前 言本文件按照GB/T1.1—2020《標準化工作導則第1部分：標準化文件的結(jié)構(gòu)和起草規(guī)則》的規(guī)定起草。（河北組）河北省標準化研究院。（北京組）北京市市場監(jiān)督管理局風險管理中心。（天津組）天津市標準化研究院。本文件主要起草人：（河北組）李虓峰、李會、閆志強、尚曉帆、陳聰、高思瑤、王子康、董世濤、閻占輝。（（IIDB11/T3041—2024引 言IIIDB11/T3041—2024法人和其他組織統(tǒng)一社會信用代碼數(shù)據(jù)共享應用規(guī)范本文件適用于政務部門通過數(shù)據(jù)共享平臺以接口方式進行的京津冀統(tǒng)一社會信用代碼數(shù)據(jù)信息共享應用。（GB/T2260中華人民共和國行政區(qū)劃代碼GB/T4754GB/T14733.8GB/T22239信息安全技術網(wǎng)絡安全等級保護基本要求GB32100法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則下列術語和定義適用于本文件。3.1請求request接口用戶向接口發(fā)出的一次調(diào)用申請。3.2響應response接口向接口用戶返回請求的操作結(jié)果。3.3包體package-body數(shù)據(jù)傳輸中的實體主體部分。下列縮略語適用于本文件。HTTPS基于安全套接字的超文本傳輸協(xié)議（HypertextTransferProtocolSecure）XML可擴展標識語言（ExtensibleMarkupLanguage）JSONJS（JavaScriptObjectNotation）1DB11/T3041—2024數(shù)據(jù)共享應用模型包括數(shù)據(jù)共享概念模型和數(shù)據(jù)共享技術架構(gòu)。數(shù)據(jù)共享技術架構(gòu)是支持數(shù)據(jù)共享概念模型的邏輯框架。其中：數(shù)據(jù)提供方、管理方和應用方通過數(shù)據(jù)交換行為實現(xiàn)數(shù)據(jù)共享活動，如圖1所示。圖1數(shù)據(jù)共享概念模型按照數(shù)據(jù)共享業(yè)務視角對數(shù)據(jù)共享角色進行分類，包括提供方、管理方和應用方：遵照管理方批準的規(guī)程，提供方、管理方和應用方的數(shù)據(jù)共享活動通過數(shù)據(jù)交換行為實現(xiàn)：應用反饋提供方；果。圍繞需要政務部門間共享的數(shù)據(jù)給出了數(shù)據(jù)共享技術架構(gòu)，如圖2所示，架構(gòu)包括以下內(nèi)容：2DB11/T3041—2024圖2數(shù)據(jù)共享技術架構(gòu)統(tǒng)一社會信用代碼數(shù)據(jù)共享應用流程，如圖3所示。不通過不通過調(diào)用配置數(shù)據(jù)共享內(nèi)容申請審批提出數(shù)據(jù)配置數(shù)據(jù)應用方許可信息接收許可信息調(diào)用共享數(shù)據(jù)發(fā)送數(shù)據(jù)共享請求核查不符合數(shù)據(jù)應用終止符合完成數(shù)據(jù)共享應用結(jié)束數(shù)據(jù)應用方數(shù)據(jù)管理方數(shù)據(jù)共享平臺圖3數(shù)據(jù)共享應用流程3DB11/T3041—2024IPIP于實現(xiàn)數(shù)據(jù)共享應用設備的IP地址和申請使用期限的有效性，檢驗通過后，執(zhí)行請求，返回響應內(nèi)容。數(shù)據(jù)共享應用網(wǎng)絡要求如下：應符合GB/T22239的相關要求。概述統(tǒng)一社會信用代碼接口定義見表1。4DB11/T3041—2024表1統(tǒng)一社會信用代碼接口定義接口分類定義說明統(tǒng)一社會信用代碼基礎數(shù)據(jù)接口StringHBtydm_sh_service(stringlicence,stringcond_information,stringrepl_packagetype)HBtydm_sh_serviceBJtydm_sh_serviceTJtydm_sh_servicelicense為許可參數(shù)(見8.4.1)；3.cond_information8.4.2)；4.repl_packagetype為返回結(jié)果數(shù)據(jù)包格式參數(shù)(見8.4.3)；5.接口返回結(jié)果見8.4.4。StringBJtydm_sh_service(stringlicence,stringcond_information,stringrepl_packagetype)StringTJtydm_sh_service(stringlicence,stringcond_information,stringrepl_packagetype)統(tǒng)一社會信用代碼變更數(shù)據(jù)接口StringHBbgkinfo(stringlicence,stringrepl_packagetype)HBbgkinfo變更數(shù)據(jù)接口名稱；BJbgkinfo更數(shù)據(jù)接口名稱；TJbgkinfo更數(shù)據(jù)接口名稱；license為許可參數(shù)(見8.5.1)；3.repl_packagetype為返回結(jié)果數(shù)據(jù)包格式參數(shù)(見8.5.2)；4.接口返回結(jié)果見8.5.3。StringBJbgkinfo(stringlicence,stringrepl_packagetype)StringTJbgkinfo(stringlicence,stringrepl_packagetype)統(tǒng)一社會信用代碼股東數(shù)據(jù)接口StringHBinvinfo(stringlicence,stringrepl_packagetype)HBinvinfo股東數(shù)據(jù)接口名稱；license為許可參數(shù)(見8.6.1)；3.repl_packagetype為返回結(jié)果數(shù)據(jù)包格式參數(shù)(見8.6.2)；4.接口返回結(jié)果見8.6.3。采用HTTPS作為傳輸協(xié)議。接口地址由數(shù)據(jù)管理方提供，格式為：https://xxx.xxx.xxx.xxx/services_path/service_name。其中，xxx.xxx.xxx.xxx表示接口所在服務器的有效地址；services_path表示接口的發(fā)布路徑，由數(shù)據(jù)管理方命名；service_name表示約定的接口名稱，由數(shù)據(jù)管理方命名。BC。5DB11/T3041—2024許可參數(shù)由一組用戶信息組成。許可參數(shù)包體標記及含義說明見表2。表2許可參數(shù)包體標記及含義信息類別標記字符類型及長度含義說明用戶信息tyshxydmnvarchar(18)統(tǒng)一社會信用代碼——jgmcnvarchar(200)機構(gòu)名稱——appkeynvarchar(8)用戶賬號——appsecretnvarchar(10)用戶密碼——ipnvarchar(15)被授權應用接口設備的IP地址——startdatenvarchar(10)使用期限開始時間授權起始日期enddatenvarchar(10)使用期限結(jié)束時間授權終止日期……許可參數(shù)包體采用JSON格式。許可參數(shù)放置在標記{…}之間，見示例1。示例1：{"tyshxydm":"xxxxxxxxxxxxxxxx","jgmc":"xxx","appkey":"xxx","appsecret":"xxx","ip":"xxx","startdate":"xxx","enddate":"xxx"}條件參數(shù)由條件邏輯關系、條件數(shù)據(jù)項集、返回結(jié)果數(shù)據(jù)項名稱組成，如圖4所示。圖4條件參數(shù)6DB11/T3041—2024條件參數(shù)包體采用JSON格式。條件參數(shù)放置在標記{"exp":"xxx","fields":[{"field":"xxx","operation":"xxx","value":"xxx"},…,{"field":"xxx","operation":"xxx","value":"xxx"}],"result":"xxx"}之間。exp[01nn-1（）fields關鍵字為條件數(shù)據(jù)項集。其中field關鍵字為條件數(shù)據(jù)項；operation為條件數(shù)據(jù)項的關系運算符，其表示及含義見表3；value為條件數(shù)據(jù)項的值。result關鍵字為返回結(jié)果中用戶要求的數(shù)據(jù)項名稱，各數(shù)據(jù)項間以英文“,”分隔。數(shù)據(jù)項標識應符合本文件8.4.5的規(guī)定。表3關系運算符表示及含義關系運算符含義說明=等于<小于>大于<=小于或等于>=大于或等于!=不等于like模糊匹配僅可應用于字符型的數(shù)據(jù)項，從字符串任意位置進行匹配leftlike左匹配僅可應用于字符型的數(shù)據(jù)項，從字符串起始端匹配rightlike右匹配僅可應用于字符型的數(shù)據(jù)項，從字符串尾端匹配isnull空值——isnotnull非空——………………條件參數(shù)包體格式見示例2。示例2：{"exp":"[0]*([1]*[2])","fields":[{"field":"zcdzxzqhdm","operation":"=","value":"xxx"},{"field":"jgmc","operation":"like","value":"xxx"}，{"field":"zcdz","operation":"like","value":"xxx"7DB11/T3041—2024}]"result":"tyshxydm,jgmc,zcdzxzqhdm"}接口返回結(jié)果數(shù)據(jù)包格式參數(shù)由數(shù)據(jù)應用方根據(jù)需要設定。該參數(shù)取值可為xml或json，不能為空。返回結(jié)果包括調(diào)用狀態(tài)信息、結(jié)果數(shù)據(jù)和結(jié)果集記錄數(shù)。接口調(diào)用失敗時，只返回調(diào)用狀態(tài)信息，見圖5。數(shù)據(jù)項1…數(shù)據(jù)項n數(shù)據(jù)項1…數(shù)據(jù)項n結(jié)果記錄數(shù)據(jù)n……結(jié)果記錄數(shù)據(jù)1結(jié)果集記錄數(shù)結(jié)果數(shù)據(jù)調(diào)用狀態(tài)信息注：返回結(jié)果記錄數(shù)據(jù)過多時，默認顯示前50條數(shù)據(jù)。圖5返回結(jié)果XML格式XML格式采用標準DATAPACKET2.0版本。返回結(jié)果中的調(diào)用狀態(tài)和結(jié)果集記錄數(shù)信息放置在標記<RESPDATA>…</RESPDATA>之間,關鍵字statusmsgtotalcount9結(jié)果數(shù)據(jù)置于標記<ROWDATA>…</ROWDATA>之間。結(jié)果數(shù)據(jù)不同記錄用<ROW…/>…<ROW…/>分隔。數(shù)據(jù)項標識應符合8.4.5的規(guī)定。返回結(jié)果包體XML格式見示例3。示例3：<?xmlversion="1.0"encoding="UTF-8"?><DATAPACKETVersion="2.0"><RESPDATA><RESPstatus="0"msg="調(diào)用成功"totalcount="2"/></RESPDATA><ROWDATA><ROWtyshxydm="xxxxxxxxxxxxxxxxxxjgmc="xx（）xxxzcdzxzqhdm="xxxxxx"/><ROWtyshxydm="xxxxxxxxxxxxxxxxxxjgmc="xx（）xxxzcdzxzqhdm="xxxxxx"/></ROWDATA></DATAPACKET>JSON返回結(jié)果信息放置在標記{"respdata":{"status":"xxx","msg":"xxx","totalcount":"xxx"},"rowdata":[{xxx},…,{xxx}]}之間。8DB11/T3041—2024respdatastatus記錄個數(shù)。調(diào)用狀態(tài)代碼和描述應符合本文件9的規(guī)定。rowdata8.4.5返回結(jié)果包體JSON格式見示例4。示例4：{"respdata":{"status":"0","msg":"調(diào)用成功","totalcount":"2"}，"rowdata":[{"tyshxydm":"xxxxxxxxxxxxxxxxxx","jgmc"xx（市）xxxxxxxxx"},{"tyshxydm":"xxxxxxxxxxxxxxxxxx","jgmc"xx（市）xx（區(qū)）xxxxxxxxx"}]}統(tǒng)一社會信用代碼基礎信息接口服務提供的數(shù)據(jù)項見表4。表4統(tǒng)一社會信用代碼基礎信息接口服務數(shù)據(jù)項數(shù)據(jù)項標識含義數(shù)據(jù)類型及長度說明tyshxydm統(tǒng)一社會信用代碼nvarchar(18)符合GB32100jgmc機構(gòu)名稱nvarchar(200)——zcdz注冊地址nvarchar(400)——zcdzxzqhdm注冊地址行政區(qū)劃代碼nvarchar(6)符合GB/T2260jyfw經(jīng)營范圍nvarchar(2000)——clrq成立日期date——djywlx登記業(yè)務類型nvarchar(2)0：注冊（設立）；1：變更；2：注銷；9：其他jyzt經(jīng)營狀態(tài)nvarchar(2)注冊、設立）,2jjhydm經(jīng)濟行業(yè)代碼nvarchar(6)符合GB/T4754lxdh聯(lián)系電話nvarchar(18)符合GB/T14733.89DB11/T3041—2024表4統(tǒng)一社會信用代碼基礎信息接口服務數(shù)據(jù)項（續(xù)）數(shù)據(jù)項標識含義數(shù)據(jù)類型及長度說明zhgxrq最后更新日期date——……許可參數(shù)由一組用戶信息組成。許可參數(shù)包體標記及含義說明見表5。表5許可參數(shù)包體標記及含義信息類別標記字符類型及長度含義說明用戶信息tyshxydmnvarchar(18)統(tǒng)一社會信用代碼——jgmcnvarchar(200)機構(gòu)名稱——appkeynvarchar(8)用戶賬號——appsecretnvarchar(10)用戶密碼——ipnvarchar(15)被授權應用接口的設備的IP地址——startdatenvarchar(10)使用期限開始時間授權起始日期enddatenvarchar(10)使用期限結(jié)束時間授權終止日期……許可參數(shù)包體采用字串格式。許可參數(shù)放置在訪問地址的參數(shù)中，見示例5。示例5：https://xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshxydm=xxx參照本文件8.4.3。參照本文件8.4.4。統(tǒng)一社會信用代碼變更信息接口服務提供的數(shù)據(jù)項見表6。10DB11/T3041—2024表6統(tǒng)一社會信用代碼變更信息接口服務數(shù)據(jù)項數(shù)據(jù)項標識含義數(shù)據(jù)類型及長度說明tyshxydm統(tǒng)一社會信用代碼nvarchar(18)符合GB32100bglx變更類型nvarchar(50)——bgq變更前內(nèi)容nvarchar(255)——bgh變更后內(nèi)容nvarchar(255)——bgsj變更日期date——……許可參數(shù)由一組用戶信息組成。許可參數(shù)包體標記及含義說明見表7。表7許可參數(shù)包體標記及含義信息類別標記字符類型及長度含義說明用戶信息tyshxydmnvarchar(18)統(tǒng)一社會信用代碼——jgmcnvarchar(200)機構(gòu)名稱——appkeynvarchar(8)用戶賬號——appsecretnvarchar(10)用戶密碼——ipnvarchar(15)被授權應用接口的設備的IP地址——startdatenvarchar(10)使用期限開始時間授權起始日期enddatenvarchar(10)使用期限結(jié)束時間授權終止日期……許可參數(shù)包體采用字串格式。許可參數(shù)放置在訪問地址的參數(shù)里，見示例6。示例6：https://xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshxydm=xxx參照本文件8.4.3。11DB11/T3041—2024參照本文件8.4.4。統(tǒng)一社會信用代碼股東信息接口服務提供的數(shù)據(jù)項見表8。表8統(tǒng)一社會信用代碼股東信息接口服務數(shù)據(jù)項數(shù)據(jù)項標識含義數(shù)據(jù)類型及長度說明tyshxydm統(tǒng)一社會信用代碼nvarchar(18)符合GB32100tzrlx投資者類型nvarchar(2)——tzrxm投資者名稱nvarchar(200)——tzzj認繳出資金額numeric(24,8)——tzsj認繳出資日期date——……調(diào)用狀態(tài)信息包括接口狀態(tài)代碼及接口狀態(tài)描述，如表9所示。表9調(diào)用狀態(tài)信息接口狀態(tài)代碼接口狀態(tài)描述0調(diào)用成功1調(diào)用失敗-100被授權應用接口設備IP地址錯誤-130條件參數(shù)錯誤-160返回結(jié)果數(shù)據(jù)包格式參數(shù)錯誤-200數(shù)據(jù)庫錯誤-300用戶賬號錯誤-400用戶密碼錯誤…………12DB11/T3041—2024附錄A（資料性）統(tǒng)一社會信用代碼基礎數(shù)據(jù)接口調(diào)用方法示例以河北省統(tǒng)一社會信用代碼基礎數(shù)據(jù)接口為例，設定統(tǒng)一社會信用代碼接口地址為：https://4:8080/dso/HBtydm_sh_service；接口用戶的統(tǒng)一社會信用代碼為：11xxxxxxxx17053009xx省市）jsonjavapackagetestjgdm;//testjgdmimport.URLEncoder;importjava.util.HashMap;importjava.util.Map;importorg.apache.http.HttpResponse;importorg.apache.http.util.EntityUtils;publicclassjgdm{//定義類jgdmpublicstaticvoidmain(Stringargs)//{Stringstrkey1="標準";//查詢關鍵字1Stringstrkey2="研究院";//查詢關鍵字2try{strkey=URLEncoder.encode(strkey1,"utf-8");//將查詢關鍵字轉(zhuǎn)換為utf-8編碼strkey2=URLEncoder.encode(strkey2,"utf-8");}catch(Exceptione1){e1.printStackTrace();}Stringhost="4:8080";//接口地址Stringservice_path="/dso/";//接口路徑Stringserivce_name="HBtydm_sh_service";//接口名稱Stringmethod="POST";//提交方式Stringappkey="NyyrcP";//許可參數(shù)中的appkeyStringappsecret="jttLM7wu";//appsecretStringtydm="11xxxxxxxx17053009";//tyshxydmStringjgmc="xx）";//jgmcStringip="5:8080";//ipStringstartdate="2023-02-01";//startdateStringenddate="2024-01-31";//enddateMapheaders=newHashMap();Mapquerys=newHashMap();13DB11/T3041—2024//構(gòu)建許可參數(shù)licencequerys.put("licence","{\"tyshxydm\":\""+tyshxydm+"\",\"jgmc\":\""+jgmc+"\",\"appkey\":\""+appkey+"\",\"appsecret\":\""+appsecret+"\",\"ip\":\""+ip+"\",\"startdate\":\""+startdate+"\",\"enddate\":\""+enddate+"\"}");//repl_packagetypequerys.put("repl_packagetype","json");//json//構(gòu)建條件參數(shù)cond_informationquerys.put("cond_information","{\"exp\":\"[0]*[1]\",\"result\":\"tyshxydm,jgmc,fddbrxm,zcdzxzqhdm,zcdz,jyfw,jjhydm,lxdh,clrq,djywlx,zhgxrq\",\"fields\":[{\"field\":\"jgmc\",\"operation\":\"like\",\"value\":\""+strkey1+"\"},{\"field\":\"jgmc\",\"operation\":\"like\",\"value\":\""+strkey2+"\"}]}");try{//向接口提交請求HttpResponseresponse=HttpUtils.doPost(host+service_path,serivce_name,method,headers,querys,"");//獲取反饋的數(shù)據(jù)包，并在控制窗口中打印出來System.out.println(EntityUtils.toString(response.getEntity()));}catch(Exceptione){e.printStackTrace();}}}14DB11/T3041—2024附錄B（資料性）統(tǒng)一社會信用代碼變更數(shù)據(jù)接口調(diào)用方法示例以河北省統(tǒng)一社會信用代碼變更數(shù)據(jù)接口為例，設定統(tǒng)一社會信用代碼接口地址為：https://4:8080/dso/HBbgkinfo11xxxxxxxx17053009，名稱為：xx省（市）標準化研究院；通過接口查詢數(shù)據(jù)的條件是：統(tǒng)一社會信息用代碼為11xxxxxxxx17053009javapackagetestjgdm;//testjgdmimport.URLEncoder;importjava.util.HashMap;importjava.util.Map;importorg.apache.http.HttpResponse;importorg.apache.http.util.EntityUtils;publicclassjgdm{//定義類jgdmpublicstaticvoidmain(String[]args)//調(diào)用變更數(shù)據(jù)接口獲取符合條件數(shù)據(jù)的函數(shù){Stringstrkey="xxxxxxxxxxxxxxxxxx";//查詢關鍵字try{strkey=URLEncoder.encode(strkey,"utf-8");//將查詢關鍵字轉(zhuǎn)換為utf-8編碼}catch(Exceptione1){e1.printStackTrace();}Stringhost="4:8080";//接口地址Stringservice_path="/dso/";//接口路徑Stringserivce_name="HBbgkinfo";//接口名稱Stringmethod="POST";//提交方式Stringappkey="NyyrcP";//許可參數(shù)中的appkeyStringappsecret="jttLM7wu";//appsecretStringtydm="11xxxxxxxx17053009";//tydmStringjgmc="xx（）";//jgmcStringip="5:8080";//ipStringstartdate="2023-02-01";//Stringenddate="2024-01-31";//enddateMapheaders=newHashMap();Mapquerys=newHashMap();//構(gòu)建許可參數(shù)licenceStringurl=host+service_path+serivce_name+"?appkey="+appkey+"&appsecret="+appsecret+"&rtype=1&ip="+ip+"&tyshxydm="+strkey;try{//向接口提交請求15DB11/T3041—2024HttpResponseresponse=HttpUtils.doPost(url,"",method,headers,querys,"");//獲取反饋的數(shù)據(jù)包，并在控制窗口中打印出來System.out.println(EntityUtils.toString(response.getEntity()));}catch(Exceptione){e.printStackTrace();}}}16DB11/T3041—2024附錄C（資料性）統(tǒng)一社會信用代碼股東數(shù)據(jù)接口調(diào)用方法示例以河北省統(tǒng)一社會信用代碼股東數(shù)據(jù)接口為例，設定統(tǒng)一社會信用代碼接口地址為：https://4:8080/dso/HBinvinfo：11xxxxxxxx17053009，機構(gòu)名稱為：xx?。ㄊ校藴驶芯吭海煌ㄟ^接口查詢數(shù)據(jù)的條件是：統(tǒng)一社會信息用代碼為11xxxxxxxx17053009javapackagetestjgdm;//testjgdmimport.URLEncoder;importjava.uti