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

DB13/T3041—2024

法人和其他組織統(tǒng)一社會信用代碼數(shù)據(jù)

共享應(yīng)用規(guī)范

1范圍

本文件規(guī)定了京津冀統(tǒng)一社會信用代碼數(shù)據(jù)共享應(yīng)用框架、網(wǎng)絡(luò)要求、安全要求、數(shù)據(jù)應(yīng)用方

式和數(shù)據(jù)應(yīng)用調(diào)用信息。

本文件適用于政務(wù)部門通過數(shù)據(jù)共享平臺以接口方式進行的京津冀統(tǒng)一社會信用代碼數(shù)據(jù)信息

共享應(yīng)用。

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

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用

文件，僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）

適用于本文件。

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

GB/T4754國民經(jīng)濟行業(yè)分類

GB/T14733.8電信術(shù)語電話

GB32100法人和其他組織統(tǒng)一社會信用代碼編碼規(guī)則

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

請求request

接口用戶向接口發(fā)出的一次調(diào)用申請。

響應(yīng)response

接口向接口用戶返回請求的操作結(jié)果。

包體package-body

數(shù)據(jù)傳輸中的實體主體部分。

4縮略語

下列縮略語適用于本文件。

HTTPS基于安全套接字的超文本傳輸協(xié)議（HypertextTransferProtocolSecure）

XML可擴展標識語言（ExtensibleMarkupLanguage）

JSONJS對象標記（JavaScriptObjectNotation）

5數(shù)據(jù)共享應(yīng)用框架

共享應(yīng)用模型

5.1.1概述

數(shù)據(jù)共享應(yīng)用模型包括數(shù)據(jù)共享概念模型和數(shù)據(jù)共享技術(shù)架構(gòu)。數(shù)據(jù)共享技術(shù)架構(gòu)是支持數(shù)據(jù)

共享概念模型的邏輯框架。其中：

1

DB13/T3041—2024

a)數(shù)據(jù)共享概念模型：描述了信息的提供方、使用方及應(yīng)用方遵循已確定的信息共享規(guī)程，

進行數(shù)據(jù)共享的業(yè)務(wù)過程；

b)數(shù)據(jù)共享技術(shù)架構(gòu)：描述了支持數(shù)據(jù)共享實現(xiàn)的技術(shù)要求。

5.1.2數(shù)據(jù)共享概念模型

概念模型

提供方、管理方和應(yīng)用方通過數(shù)據(jù)交換行為實現(xiàn)數(shù)據(jù)共享活動，如圖1所示。

圖1數(shù)據(jù)共享概念模型

共享角色

按照數(shù)據(jù)共享業(yè)務(wù)視角對數(shù)據(jù)共享角色進行分類，包括提供方、管理方和應(yīng)用方：

a)提供方：提供共享數(shù)據(jù)的機構(gòu)；

b)管理方：管理共享數(shù)據(jù)應(yīng)用合規(guī)性的機構(gòu)；

c)應(yīng)用方：應(yīng)用數(shù)據(jù)的機構(gòu)。

共享行為

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

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

b)應(yīng)用方通過共享平臺將查詢內(nèi)容提交給管理方，管理方向應(yīng)用方提供查詢結(jié)果，并將查詢

結(jié)果反饋提供方；

c)應(yīng)用方查詢內(nèi)容涉及敏感信息的，需預(yù)先征得數(shù)據(jù)提供方同意后，方能獲取查詢結(jié)果。

5.1.3數(shù)據(jù)共享技術(shù)架構(gòu)

圍繞需要政務(wù)部門間共享的數(shù)據(jù)給出了數(shù)據(jù)共享技術(shù)架構(gòu)，如圖2所示，架構(gòu)包括以下內(nèi)容：

a)網(wǎng)絡(luò)：為數(shù)據(jù)共享提供網(wǎng)絡(luò)基礎(chǔ)設(shè)施支撐，包括互聯(lián)網(wǎng)、電子政務(wù)外網(wǎng)；

b)數(shù)據(jù)：數(shù)據(jù)共享過程中產(chǎn)生的信息，包括數(shù)據(jù)內(nèi)容、數(shù)據(jù)編碼、數(shù)據(jù)質(zhì)量、數(shù)據(jù)表達；

c)系統(tǒng)：數(shù)據(jù)共享過程中數(shù)據(jù)管理方和應(yīng)用方進行數(shù)據(jù)共享的平臺，包括目錄系統(tǒng)和交換系

統(tǒng)；

d)安全：包括安全管理和安全技術(shù)；

e)管理：包括數(shù)據(jù)內(nèi)容管理、數(shù)據(jù)字典管理及數(shù)據(jù)日常維護管理等方面的內(nèi)容。

2

DB13/T3041—2024

系統(tǒng)

安全管理

目錄系統(tǒng)交換系統(tǒng)數(shù)據(jù)

安內(nèi)容

全

管

數(shù)據(jù)

理

數(shù)據(jù)

數(shù)據(jù)內(nèi)容數(shù)據(jù)編碼

字典

數(shù)據(jù)質(zhì)量數(shù)據(jù)表達

安

全數(shù)據(jù)

技日常維護

術(shù)

網(wǎng)絡(luò)

圖2數(shù)據(jù)共享技術(shù)架構(gòu)

共享應(yīng)用流程

5.2.1流程圖

統(tǒng)一社會信用代碼數(shù)據(jù)共享應(yīng)用流程，如圖3所示。

圖3數(shù)據(jù)共享應(yīng)用流程

5.2.2共享申請、許可和響應(yīng)

數(shù)據(jù)應(yīng)用方向數(shù)據(jù)管理方提交數(shù)據(jù)共享應(yīng)用申請，申請信息包括但不限于以下內(nèi)容：

a)機構(gòu)統(tǒng)一社會信用代碼；

b)機構(gòu)名稱；

c)用于實現(xiàn)數(shù)據(jù)共享應(yīng)用設(shè)備的IP地址；

d)申請使用期限；

e)申請使用數(shù)據(jù)項；

3

DB13/T3041—2024

f)申請使用數(shù)據(jù)范圍。

數(shù)據(jù)管理方收到申請后，生成許可信息反饋給數(shù)據(jù)應(yīng)用方，許可信息包括但不限于以下內(nèi)

容：

a)機構(gòu)統(tǒng)一社會信用代碼；

b)機構(gòu)名稱；

c)用戶賬號；

d)用戶密碼；

e)用于實現(xiàn)數(shù)據(jù)共享應(yīng)用設(shè)備的IP地址；

f)申請使用期限；

g)數(shù)據(jù)共享平臺地址。

數(shù)據(jù)應(yīng)用方通過數(shù)據(jù)共享平臺調(diào)用數(shù)據(jù)信息時，應(yīng)提供被授予的許可信息。

數(shù)據(jù)管理方在接收到請求后，校驗數(shù)據(jù)應(yīng)用方許可信息中用戶賬號和用戶密碼的合法性、

用于實現(xiàn)數(shù)據(jù)共享應(yīng)用設(shè)備的IP地址和申請使用期限的有效性，檢驗通過后，執(zhí)行請求，返回響應(yīng)

內(nèi)容。

6網(wǎng)絡(luò)要求

數(shù)據(jù)共享應(yīng)用網(wǎng)絡(luò)要求如下：

a)敏感數(shù)據(jù)應(yīng)通過電子政務(wù)外網(wǎng)傳輸；

b)其他信息可通過互聯(lián)網(wǎng)傳輸。

7安全要求

應(yīng)符合GB/T22239-2019中8的規(guī)定要求。

8數(shù)據(jù)應(yīng)用方式

概述

數(shù)據(jù)應(yīng)用方通過嵌入數(shù)據(jù)共享平臺中的接口調(diào)用統(tǒng)一社會信用代碼基礎(chǔ)數(shù)據(jù)、統(tǒng)一社會信用代

碼變更數(shù)據(jù)和統(tǒng)一社會信用代碼股東數(shù)據(jù)。

接口定義

統(tǒng)一社會信用代碼接口定義見表1。

表1統(tǒng)一社會信用代碼接口定義

接口分類定義說明

1.HBtydm_sh_service為約定的河北省統(tǒng)一

社會信用代碼基礎(chǔ)數(shù)據(jù)接口名稱；

BJtydm_sh_service為約定的北京市統(tǒng)一社

StringHBtydm_sh_service(

會信用代碼基礎(chǔ)數(shù)據(jù)接口名稱；

stringlicence,

TJtydm_sh_service為約定的天津市統(tǒng)一社

統(tǒng)一社會信用代碼string

會信用代碼基礎(chǔ)數(shù)據(jù)接口名稱；

基礎(chǔ)數(shù)據(jù)接口cond_information,

2.license為許可參數(shù)(見8.4.1)；

string

3.cond_information為條件參數(shù)(見8.4.2)；

repl_packagetype)

4.repl_packagetype為返回結(jié)果數(shù)據(jù)包格式

參數(shù)(見8.4.3)；

5.接口返回結(jié)果見8.4.4。

4

DB13/T3041—2024

表1統(tǒng)一社會信用代碼接口定義（續(xù)）

接口分類定義說明

StringBJtydm_sh_service(

1.HBtydm_sh_service為約定的河北省統(tǒng)一

stringlicence,

社會信用代碼基礎(chǔ)數(shù)據(jù)接口名稱；

string

BJtydm_sh_service為約定的北京市統(tǒng)一社

cond_information,

會信用代碼基礎(chǔ)數(shù)據(jù)接口名稱；

string

TJtydm_sh_service為約定的天津市統(tǒng)一社

統(tǒng)一社會信用代碼repl_packagetype)

會信用代碼基礎(chǔ)數(shù)據(jù)接口名稱；

StringTJtydm_sh_service(

基礎(chǔ)數(shù)據(jù)接口2.license為許可參數(shù)(見8.4.1)；

stringlicence,

3.cond_information為條件參數(shù)(見8.4.2)；

string

4.repl_packagetype為返回結(jié)果數(shù)據(jù)包格式

cond_information,

參數(shù)(見8.4.3)；

string

5.接口返回結(jié)果見8.4.4。

repl_packagetype)

StringHBbgkinfo(

stringlicence,

1.HBbgkinfo為約定的河北省統(tǒng)一社會信用

string

代碼變更數(shù)據(jù)接口名稱；

repl_packagetype)

BJbgkinfo為約定的北京市統(tǒng)一社會信用代

StringBJbgkinfo(碼變更數(shù)據(jù)接口名稱；

統(tǒng)一社會信用代碼stringlicence,TJbgkinfo為約定的天津市統(tǒng)一社會信用代

變更數(shù)據(jù)接口string碼變更數(shù)據(jù)接口名稱；

repl_packagetype)2.license為許可參數(shù)(見8.5.1)；

StringTJbgkinfo(3.repl_packagetype為返回結(jié)果數(shù)據(jù)包格式

stringlicence,參數(shù)(見8.5.2)；

string4.接口返回結(jié)果見8.5.3。

repl_packagetype)

1.HBinvinfo為約定的河北省統(tǒng)一社會信用

StringHBinvinfo(代碼股東數(shù)據(jù)接口名稱；

統(tǒng)一社會信用代碼stringlicence,2.license為許可參數(shù)(見8.6.1)；

股東數(shù)據(jù)接口string3.repl_packagetype為返回結(jié)果數(shù)據(jù)包格式

repl_packagetype)參數(shù)(見8.6.2)；

4.接口返回結(jié)果見8.6.3。

基本約定

8.3.1傳輸協(xié)議

采用HTTPS作為傳輸協(xié)議。

8.3.2地址格式

接口地址由數(shù)據(jù)管理方提供，格式為：https://xxx.xxx.xxx.xxx/services_path/service_name。

其中，xxx.xxx.xxx.xxx表示接口所在服務(wù)器的有效地址；services_path表示接口的發(fā)布路徑，

由數(shù)據(jù)管理方命名；service_name表示約定的接口名稱，由數(shù)據(jù)管理方命名。

8.3.3調(diào)用方法

統(tǒng)一社會信用代碼基礎(chǔ)數(shù)據(jù)、統(tǒng)一社會信用代碼變更數(shù)據(jù)、統(tǒng)一社會信用代碼股東數(shù)據(jù)接口調(diào)

用方法示例分別見附錄A、附錄B和附錄C。

統(tǒng)一社會信用代碼基礎(chǔ)數(shù)據(jù)接口

8.4.1許可參數(shù)

內(nèi)容組成

許可參數(shù)由一組用戶信息組成。

5

DB13/T3041—2024

包體標記及含義

許可參數(shù)包體標記及含義說明見表2。

表2許可參數(shù)包體標記及含義

信息類別標記字符類型及長度含義說明

tyshxydmnvarchar(18)統(tǒng)一社會信用代碼——

jgmcnvarchar(200)機構(gòu)名稱——

appkeynvarchar(8)用戶賬號——

appsecretnvarchar(10)用戶密碼——

用戶信息

ipnvarchar(15)被授權(quán)應(yīng)用接口設(shè)備的IP地址——

startdatenvarchar(10)使用期限開始時間授權(quán)起始日期

enddatenvarchar(10)使用期限結(jié)束時間授權(quán)終止日期

……

包體格式說明

許可參數(shù)包體采用JSON格式。

許可參數(shù)放置在標記{…}之間，見示例1。

示例1：

{

"tyshxydm":"xxxxxxxxxxxxxxxx",

"jgmc":"xxx",

"appkey":"xxx",

"appsecret":"xxx",

"ip":"xxx",

"startdate":"xxx",

"enddate":"xxx"

}

8.4.2條件參數(shù)包體

內(nèi)容組成

條件參數(shù)由條件邏輯關(guān)系、條件數(shù)據(jù)項集、返回結(jié)果數(shù)據(jù)項名稱組成，如圖4所示。

圖4條件參數(shù)

條件參數(shù)包體格式說明

條件參數(shù)包體采用JSON格式。

條件參數(shù)放置在標記{"exp":"xxx","fields":[{"field":"xxx","operation":"xxx",

"value":"x

xx"},…,{"field":"xxx","operation":"xxx","value":"xxx"}],"result":"xxx"}之間。

exp關(guān)鍵字為條件邏輯關(guān)系。其中“與”、“或”分別用“*”、“+”標識；為空時，默認為“與”；

在邏輯關(guān)系中，第一個條件數(shù)據(jù)項用[0]表示，第二個用[1]表示，以此類推，第n個用[n-1]表示，

各條件之間可以用圓括號運算符（）組合。

fields關(guān)鍵字為條件數(shù)據(jù)項集。其中field關(guān)鍵字為條件數(shù)據(jù)項；operation為條件數(shù)據(jù)項的

6

DB13/T3041—2024

關(guān)系運算符，其表示及含義見表3；value為條件數(shù)據(jù)項的值。

result關(guān)鍵字為返回結(jié)果中用戶要求的數(shù)據(jù)項名稱，各數(shù)據(jù)項間以英文“,”分隔。

數(shù)據(jù)項標識應(yīng)符合本文件8.4.5的規(guī)定。

表3關(guān)系運算符表示及含義

關(guān)系運算符含義說明

=等于

<小于1.字符型應(yīng)按字符編碼順序進行比較；

>大于2.數(shù)值型應(yīng)轉(zhuǎn)換成數(shù)值進行比較；

<=小于或等于3.日期型應(yīng)轉(zhuǎn)換成日期進行比較；

>=大于或等于

4.日期時間型應(yīng)轉(zhuǎn)換成時間進行比較。

!=不等于

like模糊匹配僅可應(yīng)用于字符型的數(shù)據(jù)項，從字符串任意位置進行匹配

leftlike左匹配僅可應(yīng)用于字符型的數(shù)據(jù)項，從字符串起始端匹配

rightlike右匹配僅可應(yīng)用于字符型的數(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"

}

]

"result":"tyshxydm,jgmc,zcdzxzqhdm"

}

8.4.3返回結(jié)果數(shù)據(jù)包格式參數(shù)

接口返回結(jié)果數(shù)據(jù)包格式參數(shù)由數(shù)據(jù)應(yīng)用方根據(jù)需要設(shè)定。該參數(shù)取值可為xml或json，不能

為空。

8.4.4返回結(jié)果

內(nèi)容組成

7

DB13/T3041—2024

返回結(jié)果包括調(diào)用狀態(tài)信息、結(jié)果數(shù)據(jù)和結(jié)果集記錄數(shù)。接口調(diào)用失敗時，只返回調(diào)用狀態(tài)信

息，見圖5。

調(diào)用狀態(tài)信息結(jié)果數(shù)據(jù)結(jié)果集記錄數(shù)

結(jié)果記錄數(shù)據(jù)1……結(jié)果記錄數(shù)據(jù)n

數(shù)據(jù)項1…數(shù)據(jù)項n

注：返回結(jié)果記錄數(shù)據(jù)過多時，默認顯示前50條數(shù)據(jù)。

圖5返回結(jié)果

包體格式說明

.1XML格式

XML格式采用標準DATAPACKET2.0版本。

返回結(jié)果中的調(diào)用狀態(tài)和結(jié)果集記錄數(shù)信息放置在標記<RESPDATA>…</RESPDATA>之間,關(guān)鍵字

status為調(diào)用狀態(tài)代碼，msg為調(diào)用狀態(tài)描述，totalcount為結(jié)果集記錄個數(shù)。調(diào)用狀態(tài)代碼和描

述應(yīng)符合第9章的規(guī)定。

結(jié)果數(shù)據(jù)置于標記<ROWDATA>…</ROWDATA>之間。結(jié)果數(shù)據(jù)不同記錄用<ROW…/>…<ROW…/>分隔。

數(shù)據(jù)項標識應(yīng)符合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="xxxxxxxxxxxxxxxxxx"jgmc="xx?。ㄊ校﹛xx股份有限公司"zcdzxzqhdm="xxxxxx"/>

<ROWtyshxydm="xxxxxxxxxxxxxxxxxx"jgmc="xx市（區(qū)）xxx股份有限公司"zcdzxzqhdm="xxxxxx"/>

</ROWDATA>

</DATAPACKET>

.2JSON格式

返回結(jié)果信息放置在標記{"respdata":{"status":"xxx","msg":"xxx","totalcount":"xxx"},

"rowdata":[{xxx},…,{xxx}]}之間。

在respdata標簽內(nèi)，關(guān)鍵字status為調(diào)用狀態(tài)代碼，msg為調(diào)用狀態(tài)描述，totalcount為結(jié)

果集記錄個數(shù)。調(diào)用狀態(tài)代碼和描述應(yīng)符合本文件9的規(guī)定。

在rowdata標簽內(nèi)，每條結(jié)果數(shù)據(jù)記錄放置在標記{…}之間。數(shù)據(jù)記錄中的數(shù)據(jù)項標識應(yīng)符合

本文件8.4.5的規(guī)定。

返回結(jié)果包體JSON格式見示例4。

示例4：

{

"respdata":{

"status":"0",

"msg":"調(diào)用成功",

"totalcount":"2"

}，

"rowdata":[

{

8

DB13/T3041—2024

"tyshxydm":"xxxxxxxxxxxxxxxxxx",

"jgmc":"xx省（市）xxx股份有限公司"，

"zcdzxzqhdm":"xxxxxx"

},

{

"tyshxydm":"xxxxxxxxxxxxxxxxxx",

"jgmc":"xx市（區(qū)）xxx股份有限公司",

"zcdzxzqhdm":"xxxxxx"

}

]

}

8.4.5應(yīng)用服務(wù)數(shù)據(jù)項

統(tǒng)一社會信用代碼基礎(chǔ)數(shù)據(jù)接口服務(wù)提供的數(shù)據(jù)項見表4。

表4統(tǒng)一社會信用代碼基礎(chǔ)數(shù)據(jù)接口服務(wù)數(shù)據(jù)項

數(shù)據(jù)項標識含義數(shù)據(jù)類型及長度說明

tyshxydm統(tǒng)一社會信用代碼nvarchar(18)符合GB32100

jgmc機構(gòu)名稱nvarchar(200)——

zcdz注冊地址nvarchar(400)——

zcdzxzqhdm注冊地址行政區(qū)劃代碼nvarchar(6)符合GB/T2260

jyfw經(jīng)營范圍nvarchar(2000)——

clrq成立日期date——

0：注冊（設(shè)立）；1：變更；

djywlx登記業(yè)務(wù)類型nvarchar(2)

2：注銷；9：其他

1：“正?！保ù胬m(xù)、在營、開

業(yè)、注冊、設(shè)立）；2：“吊

銷，未注銷”；3：“吊銷，已

jyzt經(jīng)營狀態(tài)nvarchar(2)

注銷”；4：“注銷”；5：“撤

銷”；6：“遷出”；9：“其

他”

jjhydm經(jīng)濟行業(yè)代碼nvarchar(6)符合GB/T4754

lxdh聯(lián)系電話nvarchar(18)符合GB/T14733.8

數(shù)據(jù)項標識含義數(shù)據(jù)類型及長度說明

zhgxrq最后更新日期date——

……

統(tǒng)一社會信用代碼變更數(shù)據(jù)接口

8.5.1許可參數(shù)

內(nèi)容組成

許可參數(shù)由一組用戶信息組成。

包體標記及含義

許可參數(shù)包體標記及含義說明見表5。

9

DB13/T3041—2024

表5許可參數(shù)包體標記及含義

信息類別標記字符類型及長度含義說明

tyshxydmnvarchar(18)統(tǒng)一社會信用代碼——

jgmcnvarchar(200)機構(gòu)名稱——

appkeynvarchar(8)用戶賬號——

appsecretnvarchar(10)用戶密碼——

用戶信息

ipnvarchar(15)被授權(quán)應(yīng)用接口的設(shè)備的IP地址——

startdatenvarchar(10)使用期限開始時間授權(quán)起始日期

enddatenvarchar(10)使用期限結(jié)束時間授權(quán)終止日期

……

包體格式說明

許可參數(shù)包體采用字串格式。

許可參數(shù)放置在訪問地址的參數(shù)中，見示例5。

示例5：

https://xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshx

ydm=xxx

8.5.2返回結(jié)果數(shù)據(jù)包格式參數(shù)

參照本文件8.4.3。

8.5.3返回結(jié)果

參照本文件8.4.4。

8.5.4應(yīng)用服務(wù)數(shù)據(jù)項

統(tǒng)一社會信用代碼變更數(shù)據(jù)接口服務(wù)提供的數(shù)據(jù)項見表6。

表6統(tǒng)一社會信用代碼變更數(shù)據(jù)接口服務(wù)數(shù)據(jù)項

數(shù)據(jù)項標識含義數(shù)據(jù)類型及長度說明

tyshxydm統(tǒng)一社會信用代碼nvarchar(18)符合GB32100

bglx變更類型nvarchar(50)——

bgq變更前內(nèi)容nvarchar(255)——

bgh變更后內(nèi)容nvarchar(255)——

bgsj變更日期date——

……

統(tǒng)一社會信用代碼股東數(shù)據(jù)接口

8.6.1許可參數(shù)

內(nèi)容組成

許可參數(shù)由一組用戶信息組成。

包體標記及含義

許可參數(shù)包體標記及含義說明見表7。

10

DB13/T3041—2024

表7許可參數(shù)包體標記及含義

信息類別標記字符類型及長度含義說明

tyshxydmnvarchar(18)統(tǒng)一社會信用代碼——

jgmcnvarchar(200)機構(gòu)名稱——

appkeynvarchar(8)用戶賬號——

appsecretnvarchar(10)用戶密碼——

用戶信息

ipnvarchar(15)被授權(quán)應(yīng)用接口的設(shè)備的IP地址——

startdatenvarchar(10)使用期限開始時間授權(quán)起始日期

enddatenvarchar(10)使用期限結(jié)束時間授權(quán)終止日期

……

包體格式說明

許可參數(shù)包體采用字串格式。

許可參數(shù)放置在訪問地址的參數(shù)里，見示例6。

示例6：

https://xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshx

ydm=xxx

8.6.2返回結(jié)果數(shù)據(jù)包格式參數(shù)

參照本文件8.4.3。

8.6.3返回結(jié)果

參照本文件8.4.4。

8.6.4應(yīng)用服務(wù)數(shù)據(jù)項

統(tǒng)一社會信用代碼股東數(shù)據(jù)接口服務(wù)提供的數(shù)據(jù)項見表8。

表8統(tǒng)一社會信用代碼股東數(shù)據(jù)接口服務(wù)數(shù)據(jù)項

數(shù)據(jù)項標識含義數(shù)據(jù)類型及長度說明

tyshxydm統(tǒng)一社會信用代碼nvarchar(18)符合GB32100

tzrlx投資者類型nvarchar(2)——

tzrxm投資者名稱nvarchar(200)——

tzzj認繳出資金額numeric(24,8)——

tzsj認繳出資日期date——

……

9數(shù)據(jù)應(yīng)用調(diào)用信息

調(diào)用狀態(tài)信息包括接口狀態(tài)代碼及接口狀態(tài)描述，如表9所示。

11

DB13/T3041—2024

表9調(diào)用狀態(tài)信息

接口狀態(tài)代碼接口狀態(tài)描述

0調(diào)用成功

1調(diào)用失敗

-100被授權(quán)應(yīng)用接口設(shè)備IP地址錯誤

-130條件參數(shù)錯誤

-160返回結(jié)果數(shù)據(jù)包格式參數(shù)錯誤

-200數(shù)據(jù)庫錯誤

-300用戶賬號錯誤

-400用戶密碼錯誤

…………

12

DB13/T3041—2024

A

A

附錄A

（資料性）

統(tǒng)一社會信用代碼基礎(chǔ)數(shù)據(jù)接口調(diào)用方法示例

A.1示例說明

以河北省統(tǒng)一社會信用代碼基礎(chǔ)數(shù)據(jù)接口為例，設(shè)定統(tǒng)一社會信用代碼接口地址為：https://

4:8080/dso/HBtydm_sh_service；接口用戶的統(tǒng)一社會信用代碼為：

11xxxxxxxx17053009；機構(gòu)名稱為：xx?。ㄊ校藴驶芯吭?；通過接口查詢數(shù)據(jù)的條件是：機構(gòu)名

稱中包含“標準”且包含“研究院”的機構(gòu)；返回結(jié)果包體是：json格式；結(jié)果數(shù)據(jù)項包括：統(tǒng)一社

會信用代碼、機構(gòu)名稱、行政區(qū)劃代碼、機構(gòu)地址、經(jīng)營范圍、經(jīng)濟行業(yè)代碼、聯(lián)系電話、注冊日

期、業(yè)務(wù)類型和最后更新日期。

A.2示例程序代碼

本示例以java語言實現(xiàn)，程序代碼如下：

packagetestjgdm;//包名testjgdm

import.URLEncoder;

importjava.util.HashMap;

importjava.util.Map;

importorg.apache.http.HttpResponse;

importorg.apache.http.util.EntityUtils;

publicclassjgdm{//定義類jgdm

publicstaticvoidmain(String[]args)//調(diào)用統(tǒng)一社會信用代碼基礎(chǔ)數(shù)據(jù)接口獲取符合條

件數(shù)據(jù)的函數(shù)

{

Stringstrkey1="標準";//查詢關(guān)鍵字1

Stringstrkey2="研究院";//查詢關(guān)鍵字2

try{

strkey=URLEncoder.encode(strkey1,"utf-8");//將查詢關(guān)鍵字轉(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";//接口名稱

13

DB13/T3041—2024

Stringmethod="POST";//提交方式

Stringappkey="NyyrcP";//許可參數(shù)中的appkey

Stringappsecret="jttLM7wu";//許可參數(shù)中的appsecret

Stringtydm="11xxxxxxxx17053009";//許可參數(shù)中的tyshxydm

Stringjgmc="xx省（市）標準化研究院";//許可參數(shù)中的jgmc

Stringip="5:8080";//許可參數(shù)中的ip

Stringstartdate="2023-02-01";//許可參數(shù)中的startdate

Stringenddate="2024-01-31";//許可參數(shù)中的enddate

Mapheaders=newHashMap();

Mapquerys=newHashMap();

//構(gòu)建許可參數(shù)licence

querys.put("licence","{\"tyshxydm\":\""+tyshxydm+"\",\"jgmc\":\""+jgmc+"\",\"a

ppkey\":\""+appkey+"\",\"appsecret\":\""+appsecret+"\",\"ip\":\""+ip+"\",\"sta

rtdate\":\""+startdate+"\",\"enddate\":\""+enddate+"\"}");

//構(gòu)建返回結(jié)果格式參數(shù)repl_packagetype

querys.put("repl_packagetype","json");//返回結(jié)果數(shù)據(jù)包為json格式

//構(gòu)建條件參數(shù)cond_information

querys.put("cond_information","{\"exp\":\"[0]*[1]\",\"result\":\"tyshxydm,jgmc

,

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();

14

DB13/T3041—2024

B

B

附錄B

（資料性）

統(tǒng)一社會信用代碼變更數(shù)據(jù)接口調(diào)用方法示例

B.1示例說明

以河北省統(tǒng)一社會信用代碼變更數(shù)據(jù)接口為例，設(shè)定統(tǒng)一社會信用代碼接口地址為：https://

4:8080/dso/HBbgkinfo；接口用戶的統(tǒng)一社會信用代碼為：11xxxxxxxx17053009；機

構(gòu)名稱為：xx?。ㄊ校藴驶芯吭海煌ㄟ^接口查詢數(shù)據(jù)的條件是：統(tǒng)一社會信息用代碼為

11xxxxxxxx17053009的變更信息；返回結(jié)果包體是：json格式；結(jié)果數(shù)據(jù)項包括：統(tǒng)一社會信用代

碼、變更類型、變更前內(nèi)容、變更后內(nèi)容和變更日期。

B.2示例程序代碼

本示例以java語言實現(xiàn)，程序代碼如下：

packagetestjgdm;//包名testjgdm

import.URLEncoder;

importjava.util.HashMap;

importjava.util.Map;

importorg.apache.http.HttpResponse;

importorg.apache.http.util.EntityUtils;

publicclassjgdm{//定義類jgdm

publicstaticvoidmain(String[]args)//調(diào)用變更數(shù)據(jù)接口獲取符合條件數(shù)據(jù)的函數(shù)

{

Stringstrkey="xxxxxxxxxxxxxxxxxx";//查詢關(guān)鍵字

try{

strkey=URLEncoder.encode(strkey,"utf-8");//將查詢關(guān)鍵字轉(zhuǎn)換為utf-8編碼

}catch(Exceptione1)

{

e1.printStackTrace();

}

Stringhost="4:8080";//接口地址

Stringservice_path="/dso/";//接口路徑

Stringserivce_name="HBbgkinfo";//接口名稱

Stringmethod="POST";//提交方式

Stringappkey="NyyrcP";//許可參數(shù)中的appkey

Stringappsecret="jttLM7wu";//許可參數(shù)中的appsecret

15

DB13/T3041—2024

Stringtydm="11xxxxxxxx17053009";//許可參數(shù)中的tydm

Stringjgmc="xx?。ㄊ校藴驶芯吭?;//許可參數(shù)中的jgmc

Stringip="5:8080";//許可參數(shù)中的