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

35.020CCS

A

2012 DB12/T

3041—2024法人和其他組織統(tǒng)一社會信用代碼數據共享應用規(guī)范Specification

of

data

of

the

legal

organizations 天津市市場監(jiān)督管理委員會發(fā)

布DB12/T

3041—2024 前言

.................................................................................

II引言

................................................................................

III1

...............................................................................

12 規(guī)范性引用文件

.....................................................................

13 術語和定義

.........................................................................

14 縮略語

.............................................................................

15 數據共享應用框架

...................................................................

16 網絡要求

...........................................................................

47 安全要求

...........................................................................

48 數據應用方式

.......................................................................

49 數據應用調用信息

..................................................................

12附錄

A（資料性） 統(tǒng)一社會信用代碼基礎數據接口調用方法示例............................

13附錄

B（資料性） 統(tǒng)一社會信用代碼變更數據接口調用方法示例............................

15附錄

C（資料性） 統(tǒng)一社會信用代碼股東數據接口調用方法示例............................

17參考文獻

.............................................................................

19DB12/T

3041—2024 場監(jiān)督管理局共同組織制定本地方標準，在京津冀區(qū)域內適用，現(xiàn)予發(fā)布。本文件按照GB/T

1.1-2020《標準化工作導則

第1部分：標準化文件的結構和起草規(guī)則》的規(guī)定起草。本文件由天津市市場監(jiān)督管理委員會提出并歸口。本文件起草單位：（河北組）河北省標準化研究院。（北京組）北京市市場監(jiān)督管理局風險管理中心。（天津組）天津市標準化研究院。本文件主要起草人：（河北組）李虓峰、李會、于瀟、陳聰、尚曉帆、高思瑤、王子康、董世濤、閻占輝。（北京組）胡偉、楊德富、蔡欣暢、朱海綾、張贏、王健。（天津組）張楠、由方嵐、趙漢杰、徐超、董津生、張然。IIDB12/T

3041—2024不同需求，提供了個性化、差異性服務，推動了三地統(tǒng)一社會信用代碼數據資源深度共享。IIIDB12/T

3041—20241 范圍數據應用調用信息。本文件適用于政務部門通過數據共享平臺以接口方式進行的京津冀統(tǒng)一社會信用代碼數據信息共享應用。2規(guī)范性引用文件文件。GB/T

2260中華人民共和國行政區(qū)劃代碼GB/T

4754 國民經濟行業(yè)分類GB/T

電信術語

電話GB

32100 法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則3 術語和定義下列術語和定義適用于本文件。3.1請求 request接口用戶向接口發(fā)出的一次調用申請。3.2響應 response接口向接口用戶返回請求的操作結果。3.3包體 package-body數據傳輸中的實體主體部分。4 縮略語下列縮略語適用于本文件：HTTPS：基于安全套接字的超文本傳輸協(xié)議（

Transfer

Protocol

）XML：可擴展標識語言（

）JSON：JS

對象標記（JavaScript

Object

Notation）5 數據共享應用框架5.1 共享應用模型DB12/T

3041—20245.1.1 概述概念模型的邏輯框架。其中：a)

數據共享概念模型：描述了信息的提供方、使用方及應用方遵循已確定的信息共享規(guī)程，進行數據共享的業(yè)務過程；b)

數據共享技術架構：描述了支持數據共享實現(xiàn)的技術要求。5.1.2 數據共享概念模型 概念模型提供方、管理方和應用方通過數據交換行為實現(xiàn)數據共享活動，如圖1所示。圖1 數據共享概念模型 共享角色按照數據共享業(yè)務視角對數據共享角色進行分類，包括提供方、管理方和應用方：a)

提供方：提供共享數據的機構；b)

管理方：管理共享數據應用合規(guī)性的機構；c)

應用方：應用數據的機構。 共享行為遵照管理方批準的規(guī)程，提供方、管理方和應用方的數據共享活動通過數據交換行為實現(xiàn)：a)

提供方將數據傳輸給管理方，由管理方發(fā)布到數據共享平臺；b)

應用方通過共享平臺將查詢內容提交給管理方，管理方向應用方提供查詢結果，并將查詢結果反饋提供方；c)

應用方查詢內容涉及敏感信息的，需預先征得數據提供方同意后，方能獲取查詢結果。5.1.3 數據共享技術架構圍繞需要政務部門間共享的數據給出了數據共享技術架構，如圖2所示，架構包括以下內容：a)

網絡：為數據共享提供網絡基礎設施支撐，包括互聯(lián)網、電子政務外網；b)

數據：數據共享過程中產生的信息，包括數據內容、數據編碼、數據質量、數據表達；c)

d)

安全：包括安全管理和安全技術；e)

管理：包括數據內容管理、數據字典管理及數據日常維護管理等方面的內容。安全安全管理安全技術

系統(tǒng)目錄系統(tǒng)

交換系統(tǒng)數據數據內容

數據編碼數據質量數據表達網絡圖2

數據共享技術架構

DB12/T

3041—2024管理數據內容數據字典數據日常維護5.2 共享應用流程5.2.1 流程圖統(tǒng)一社會信用代碼數據共享應用流程，如圖3所示。數據共享平臺 數據管理方數據應用方不通過

調用配置數據共享內容 申請審批配置數據應用方許可信息調用共享數據

提出數據共享應用申請接收許可信息發(fā)送數據共享請求核查許可信息5.2.2 共享申請、許可和響應

不符合符合圖1

數據共享應用流程

數據應用終止完成數據共享應用結束DB12/T

3041—20數據應用方向數據管理方提交數據共享應用申請，申請信息包括但不限于以下內容：a)

機構統(tǒng)一社會信用代碼；b)

機構名稱；c)

用于實現(xiàn)數據共享應用設備的

地址；d)

申請使用期限；e)

申請使用數據項；f)

申請使用數據范圍。 a)

機構統(tǒng)一社會信用代碼；b)

機構名稱；c)

用戶賬號；d)

用戶密碼；e)

用于實現(xiàn)數據共享應用設備的

地址；f)

申請使用期限；g)

數據共享平臺地址。 數據應用方通過數據共享平臺調用數據信息時，應提供被授予的許可信息。 數據管理方在接收到請求后，校驗數據應用方許可信息中用戶賬號和用戶密碼的合法性、用于實現(xiàn)數據共享應用設備的

IP

6 網絡要求數據共享應用網絡要求如下：a)

敏感數據應通過電子政務外網傳輸；b)

其他信息可通過互聯(lián)網傳輸。7 安全要求應符合GB/T

22239-2019中8的規(guī)定要求。8 數據應用方式8.1 概述更數據和統(tǒng)一社會信用代碼股東數據。8.2 接口定義統(tǒng)一社會信用代碼接口定義見表1。表1 統(tǒng)一社會信用代碼接口定義String

string

licence,string

cond_information,string

1.HBtydm_sh_service

BJtydm_sh_service

TJtydm_sh_service

8.4.1)

4.repl_packagetype

為返回結果數據包格式參

5.

String

string

licence,string

cond_information,string

String

string

licence,string

cond_information,string

String

string

licence,string

1.HBbgkinfo

BJbgkinfo

TJbgkinfo

8.5.1)3.repl_packagetype

為返回結果數據包格式參

4.

String

string

licence,string

String

www.bzfstringstring

licence,String

string

licence,string

1.HBinvinfo

8.6.1)3.repl_packagetype

為返回結果數據包格式參

4.

DB12/T

3041—20248.3 基本約定8.3.1 傳輸協(xié)議采用HTTPS作為傳輸協(xié)議。8.3.2 地址格式接口地址由數據管理方提供，格式為：https://xxx.xxx.xxx.xxx/services_path/service_name。其中，表示接口所在服務器的有效地址；services_path數據管理方命名；service_name表示約定的接口名稱，由數據管理方命名。8.3.3調用方法法示例分別見附錄A、附錄B和附錄C。8.4 統(tǒng)一社會信用代碼基礎數據接口tyshxydmnvarchar(18)jgmcnvarchar(200)appkeynvarchar(8)appsecretnvarchar(10)ipnvarchar(15)

IP

startdatenvarchar(10)enddatenvarchar(10)????????DB12/T

3041—20248.4.1許可參數內容組成許可參數由一組用戶信息組成。 包體標記及含義許可參數包體標記及含義說明見表2。表2 許可參數包體標記及含義表2 許可參數包體標記及含義許可參數包體采用JSON格式。許可參數放置在標記{…}之間。"tyshxydm":"xxxxxxxxxxxxxxxx","jgmc":"xxx","appkey":"xxx","appsecret":"xxx","ip":"xxx","startdate":"xxx","enddate":"xxx"8.4.2 條件參數包體 內容組成條件參數由條件邏輯關系、條件數據項集、返回結果數據項名稱組成，如圖4所示。圖2 條件參數 條件參數包體格式說明.<=>=!=likeleft

likeright

is

nullis

null??????DB12/T

3041—2024條件參數包體采用JSON格式。條件參數放置在標記{"exp":"xxx","fields":[{"field":"xxx","operation":"xxx",

"value":"xxx"},?之間。exp*”、“+[0]n[n-1]件之間可以用圓括號運算符（）組合。fieldsfield關鍵字為條件數據項；operation為條件數據項的關系運算符，其表示及含義見表3；valueresult關鍵字為返回結果中用戶要求的數據項名稱，各數據項間以英文“,”分隔。數據項標識應符合本文件8.4.5的規(guī)定。表3 表3 關系運算符表示及含義條件參數包體格式見示例。"exp":"[0]*([1]*[2])",

"field":"zcdzxzqhdm","value":"xxx"},"field":"jgmc","operation":"like","value":"xxx""field":"zcdz","operation":"like","value":"xxx"DB12/T

3041—20248.4.3 返回結果數據包格式參數或json8.4.4返回結果內容組成返回結果包括調用狀態(tài)信息、結果數據和結果集記錄數。接口調用失敗時，只返回調用狀態(tài)信息，見圖3。 結果記錄數據1?? 結果記錄數據n?數據50條數據。圖3 返回結果 包體格式說明.1 XML

XML格式采用標準

2.0版本。返回結果中的調用狀態(tài)和結果集記錄數信息放置在標記<RESPDATA>?之間,關鍵字status為調用狀態(tài)代碼，為調用狀態(tài)描述，totalcount為結果集記錄個數。調用狀態(tài)代碼和描述應符合第9章的規(guī)定。結果數據置于標記?</ROWDATA>之間。結果數據不同記錄用<ROW…?<ROW…/>分隔。數據項標識應符合8.4.5的規(guī)定。返回結果包體格式見示例。<?xml

encoding="UTF-8"?><DATAPACKET

<RESP

/>

tyshxydm="xxxxxxxxxxxxxxxxxx"

tyshxydm="xxxxxxxxxxxxxxxxxx"

</DATAPACKET>.2 JSON

格式返回結果信息放置在標記{"respdata":{"status":"xxx","msg":"xxx","totalcount":"xxx"},"rowdata":[{xxx},…,{xxx}]}之間。tyshxydmnvarchar(18)

GB

jgmcnvarchar(200)zcdznvarchar(400)zcdzxzqhdmnvarchar(6)

GB/T

jyfwnvarchar(2000)clrqdatedjywlxnvarchar(2)jyztnvarchar(2)注銷”；撤銷”；出”；DB12/T

3041—2024在respdata標簽內，關鍵字status為調用狀態(tài)代碼，msg為調用狀態(tài)描述，為結果集記錄個數。調用狀態(tài)代碼和描述應符合本文件9的規(guī)定。在rowdata標簽內，每條結果數據記錄放置在標記{…}之間。數據記錄中的數據項標識應符合本文件8.4.5的規(guī)定。返回結果包體JSON格式見示例。

"0",

",

"zcdzxzqhdm":

"xxxxxx"8.4.5 應用服務數據項統(tǒng)一社會信用代碼基礎數據接口服務提供的數據項見表4。表4表4統(tǒng)一社會信用代碼基礎數據接口服務數據項表

4 統(tǒng)一社會信用代碼基礎數據接口服務數據項（續(xù)）tyshxydmnvarchar(18)jgmcnvarchar(200)appkeynvarchar(8)appsecretnvarchar(10)ipnvarchar(15)

IP

startdatenvarchar(10)enddatenvarchar(10)????????jjhydmnvarchar(6)

GB/T

lxdhnvarchar(18)

GB/T

zhgxrqdate????????DB12/T

3041—20248.5 統(tǒng)一社會信用代碼變更數據接口8.5.1許可參數 內容組成許可參數由一組用戶信息組成。包體標記及含義許可參數包體標記及含義說明見表5。表5 許可參數包體標記及含義表5 許可參數包體標記及含義許可參數包體采用字串格式。許可參數放置在訪問地址的參數中。https://xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshxydm=xxx8.5.2 返回結果數據包格式參數參照本文件8.4.3。8.5.3返回結果參照本文件8.4.4。8.5.4 應用服務數據項10tyshxydmnvarchar(18)jgmcnvarchar(200)appkeynvarchar(8)appsecretnvarchar(10)ipnvarchar(15)

IP

startdatenvarchar(10)enddatenvarchar(10)????????tyshxydmnvarchar(18)

GB

bglxnvarchar(50)bgqnvarchar(255)bghnvarchar(255)bgsjdate????????DB12/T

3041—2024統(tǒng)一社會信用代碼變更數據接口服務提供的數據項見表6。表6統(tǒng)一社會信用代碼變更數據接口服務數據項8.6表6統(tǒng)一社會信用代碼變更數據接口服務數據項8.6.1 許可參數 內容組成許可參數由一組用戶信息組成。 包體標記及含義許可參數包體標記及含義說明見表7。表7許可參數包體標記及含義表7許可參數包體標記及含義許可參數包體采用字串格式。許可參數放置在訪問地址的參數里。https://xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshxydm=xxx8.6.2 返回結果數據包格式參數11-100

IP

-130-160-200-300-400????tyshxydmnvarchar(18)

GB

tzrlxnvarchar(2)tzrxmnvarchar(200)tzzjnumeric(24,8)tzsjdate????????DB12/T

3041—2024參照本文件8.4.3。8.6.3 返回結果參照本文件8.4.4。8.6.4 應用服務數據項統(tǒng)一社會信用代碼股東數據接口服務提供的數據項見表8。表8 統(tǒng)一社會信用代碼股東數據接口服務數據項9表8 統(tǒng)一社會信用代碼股東數據接口服務數據項調用狀態(tài)信息包括接口狀態(tài)代碼及接口狀態(tài)描述，如表9所示。表9表9調用狀態(tài)信息DB12/T

3041—2024

附 錄 A（資料性）統(tǒng)一社會信用代碼基礎數據接口調用方法示例A.1 示例說明以河北省統(tǒng)一社會信用代碼基礎數據接口為例，設定統(tǒng)一社會信用代碼接口地址為：4:8080/dso/HBtydm_sh_service11xxxxxxxx17053009；機構名稱為：xxjson政區(qū)劃代碼、機構地址、經營范圍、經濟行業(yè)代碼、聯(lián)系電話、注冊日期、業(yè)務類型和最后更新日期。A.2 示例程序代碼本示例以java語言實現(xiàn)，程序代碼如下：package

testjgdmimport

.URLEncoder;import

import

java.util.Map;import

org.apache.http.HttpResponse;import

org.apache.http.util.EntityUtils;public

class

jgdm

{//定義類

jgdmpublic

static

void

main(String[]

args)//調用統(tǒng)一社會信用代碼基礎數據接口獲取符合條件數據的函數{String

strkey1="查詢關鍵字

1String

strkey2="研究院";//查詢關鍵字

2try

{strkey=URLEncoder.encode(strkey1,

"utf-8");

將查詢關鍵字轉換為

編碼strkey2=URLEncoder.encode(strkey2,

"utf-8");}

catch

e1){e1.printStackTrace();}String

host="4:8080";//接口地址String

接口路徑String

serivce_name="HBtydm_sh_service";//接口名稱String

提交方式String

許可參數中的

appkeyString

appsecret="jttLM7wu";//許可參數中的

String

tydm="11xxxxxxxx17053009";//許可參數中的

tyshxydmString

jgmc="xx

省（市）標準化研究院";//許可參數中的

jgmcString

ip="5:8080";//許可參數中的

ipString

startdate="2023-02-01";//許可參數中的

startdateString

許可參數中的

Map

Map

13DB12/T

3041—2024//構建許可參數

licencequerys.put("licence","{\"tyshxydm\":\""+tyshxydm+"\",\"jgmc\":\""+jgmc+"\",\"appkey\":\""+appkey+"\",\"appsecret\":\""+appsecret+"\",\"ip\":\""+ip+"\",\"startdate\":\""+startdate+"\",\"enddate\":\""+enddate+"\"}");//構建返回結果格式參數

repl_packagetypequerys.put("repl_packagetype","json");//返回結果數據包為

json

//構建條件參數

cond_informationquerys.put("cond_information","{\"exp\":\"[0]*[1]\",\"result\":\"tyshxydm,jgmc,zcdzxzqhdm,zcdz,jyfw,jjhydm,lxdh,clrq,djywlx,zhgxrq\",\"fields\":[{\"field\":\"jgmc\",\"operation\":

\""+strkey1+"\"},{\"field\":\"jgmc\",\"operation\":

\"like\",\"value\":

HttpResponse

response=

HttpUtils.doPost(host+service_path,

serivce_name,

method,headers,

//獲取反饋的數據包，并在控制窗口中打印出來System.out.println(EntityUtils.toString(response.getEntity()));}

catch

{}}}14DB12/T

3041—2024

附 錄 B（資料性）統(tǒng)一社會信用代碼變更數據接口調用方法示例B.1示例說明以河北省統(tǒng)一社會信用代碼變更數據接口為例，設定統(tǒng)一社會信用代碼接口地址為：4:8080/dso/HBbgkinfo；接口用戶的統(tǒng)一社會信用代碼為：；機構名稱為：?。ㄊ校藴驶芯吭海煌ㄟ^接口查詢數據的條件是：統(tǒng)一社會信息用代碼為11xxxxxxxx17053009的變更信息；返回結果包體是：json格式；結果數據項包括：統(tǒng)一社會信用代碼、變更類型、變更前內容、變更后內容和變更日期。B.2 示例程序代碼本示例以java語言實現(xiàn)，程序代碼如下：package

testjgdmimport

.URLEncoder;import

import

java.util.Map;import

org.apache.http.HttpResponse;import

org.apache.http.util.EntityUtils;public

class

jgdm

{//定義類

jgdmpublic

static

void

main(String[]

args)//調用變更數據接口獲取符合條件數據的函數{String

strkey="xxxxxxxxxxxxxxxxxx";//查詢關鍵字try

{strkey

=

將查詢關鍵字轉換為

編碼}

catch

(Exception

e1){e1.printStackTrace();}String

host="4:8080";//接口地址String

接口路徑String

接口名稱String

method="POST";//提交方式String

許可參數中的

appkeyString

許可參數中的

appsecretString

tydm="11xxxxxxxx17053009";//許可參數中的

tydmString

jgmc="xx

?。ㄊ校藴驶芯吭?;//許可參數中的

jgmcString

許可參數中的

ipString

startdate="2023-02-01";//許可參數中的

startdateString

許可參數中的

enddateMap

Map

querys=new

//構建許可參數

licenceString

url=host+service_path+serivce_name

+"?appkey="+appkey+"&appsecret="+appsecret+"&rtype=1&ip="+ip+"&tyshxydm="+strkey;15DB12/T

3041—2024try

向接口提交請求HttpResponse

//獲取反饋的數據包，并在控制窗口中打印出來System.out.println(EntityUtils.toString(response.getEntity()));}

catch

(Exception

e){e.printStackTrace();}}}16DB12/T

3041—2024

附 錄 C（資料性）統(tǒng)一社會信用代碼股東數據接口調用方法示例C.1 示例說明以河北省統(tǒng)一社會信用代碼股東數據接口為例，設定統(tǒng)一社會信用代碼接口地址為：4:8080/dso/HBinvinfo；接口用戶的機構統(tǒng)一社會信用代碼為：11xxxxxxxx17053009；機構名稱為：xx?。ㄊ校藴驶芯吭?；通過接口查詢數據的條件是：統(tǒng)一社會