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

DB13/T3041—2024

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

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

1范圍

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

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

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

共享應(yīng)用。

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

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

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

適用于本文件。

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

GB/T4754國(guó)民經(jīng)濟(jì)行業(yè)分類(lèi)

GB/T14733.8電信術(shù)語(yǔ)電話(huà)

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

3術(shù)語(yǔ)和定義

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

請(qǐng)求request

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

響應(yīng)response

接口向接口用戶(hù)返回請(qǐng)求的操作結(jié)果。

包體package-body

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

4縮略語(yǔ)

下列縮略語(yǔ)適用于本文件。

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

XML可擴(kuò)展標(biāo)識(shí)語(yǔ)言（ExtensibleMarkupLanguage）

JSONJS對(duì)象標(biāo)記（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)是支持?jǐn)?shù)據(jù)

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

1

DB13/T3041—2024

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

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

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

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

概念模型

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

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

共享角色

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

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

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

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

共享行為

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

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

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

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

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

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

圍繞需要政務(wù)部門(mén)間共享的數(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ù)共享過(guò)程中產(chǎn)生的信息，包括數(shù)據(jù)內(nèi)容、數(shù)據(jù)編碼、數(shù)據(jù)質(zhì)量、數(shù)據(jù)表達(dá)；

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

統(tǒng)；

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

e)管理：包括數(shù)據(jù)內(nèi)容管理、數(shù)據(jù)字典管理及數(shù)據(jù)日常維護(hù)管理等方面的內(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ù)表達(dá)

安

全數(shù)據(jù)

技日常維護(hù)

術(shù)

網(wǎng)絡(luò)

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

共享應(yīng)用流程

5.2.1流程圖

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

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

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

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

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

b)機(jī)構(gòu)名稱(chēng)；

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

d)申請(qǐng)使用期限；

e)申請(qǐng)使用數(shù)據(jù)項(xiàng)；

3

DB13/T3041—2024

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

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

容：

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

b)機(jī)構(gòu)名稱(chēng)；

c)用戶(hù)賬號(hào)；

d)用戶(hù)密碼；

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

f)申請(qǐng)使用期限；

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

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

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

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

內(nèi)容。

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

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

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

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

7安全要求

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

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

概述

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

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

接口定義

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

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

接口分類(lèi)定義說(shuō)明

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

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

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

StringHBtydm_sh_service(

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

stringlicence,

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

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

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

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

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

string

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

repl_packagetype)

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

參數(shù)(見(jiàn)8.4.3)；

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

4

DB13/T3041—2024

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

接口分類(lèi)定義說(shuō)明

StringBJtydm_sh_service(

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

stringlicence,

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

string

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

cond_information,

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

string

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

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

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

StringTJtydm_sh_service(

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

stringlicence,

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

string

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

cond_information,

參數(shù)(見(jiàn)8.4.3)；

string

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

repl_packagetype)

StringHBbgkinfo(

stringlicence,

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

string

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

repl_packagetype)

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

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

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

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

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

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

stringlicence,參數(shù)(見(jiàn)8.5.2)；

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

repl_packagetype)

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

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

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

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

repl_packagetype)參數(shù)(見(jiàn)8.6.2)；

4.接口返回結(jié)果見(jiàn)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表示約定的接口名稱(chēng)，由數(shù)據(jù)管理方命名。

8.3.3調(diào)用方法

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

用方法示例分別見(jiàn)附錄A、附錄B和附錄C。

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

8.4.1許可參數(shù)

內(nèi)容組成

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

5

DB13/T3041—2024

包體標(biāo)記及含義

許可參數(shù)包體標(biāo)記及含義說(shuō)明見(jiàn)表2。

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

信息類(lèi)別標(biāo)記字符類(lèi)型及長(zhǎng)度含義說(shuō)明

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

jgmcnvarchar(200)機(jī)構(gòu)名稱(chēng)——

appkeynvarchar(8)用戶(hù)賬號(hào)——

appsecretnvarchar(10)用戶(hù)密碼——

用戶(hù)信息

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

startdatenvarchar(10)使用期限開(kāi)始時(shí)間授權(quán)起始日期

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

……

包體格式說(shuō)明

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

許可參數(shù)放置在標(biāo)記{…}之間，見(jiàn)示例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ù)項(xiàng)集、返回結(jié)果數(shù)據(jù)項(xiàng)名稱(chēng)組成，如圖4所示。

圖4條件參數(shù)

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

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

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

"value":"x

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

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

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

各條件之間可以用圓括號(hào)運(yùn)算符（）組合。

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

6

DB13/T3041—2024

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

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

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

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

關(guān)系運(yùn)算符含義說(shuō)明

=等于

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

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

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

>=大于或等于

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

!=不等于

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

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

rightlike右匹配僅可應(yīng)用于字符型的數(shù)據(jù)項(xiàng)，從字符串尾端匹配

isnull空值——

isnotnull非空——

………………

條件參數(shù)包體格式見(jiàn)示例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)用失敗時(shí)，只返回調(diào)用狀態(tài)信

息，見(jiàn)圖5。

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

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

數(shù)據(jù)項(xiàng)1…數(shù)據(jù)項(xiàng)n

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

圖5返回結(jié)果

包體格式說(shuō)明

.1XML格式

XML格式采用標(biāo)準(zhǔn)DATAPACKET2.0版本。

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

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

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

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

數(shù)據(jù)項(xiàng)標(biāo)識(shí)應(yīng)符合8.4.5的規(guī)定。

返回結(jié)果包體XML格式見(jiàn)示例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é)果信息放置在標(biāo)記{"respdata":{"status":"xxx","msg":"xxx","totalcount":"xxx"},

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

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

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

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

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

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

示例4：

{

"respdata":{

"status":"0",

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

"totalcount":"2"

}，

"rowdata":[

{

8

DB13/T3041—2024

"tyshxydm":"xxxxxxxxxxxxxxxxxx",

"jgmc":"xx?。ㄊ校﹛xx股份有限公司"，

"zcdzxzqhdm":"xxxxxx"

},

{

"tyshxydm":"xxxxxxxxxxxxxxxxxx",

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

"zcdzxzqhdm":"xxxxxx"

}

]

}

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

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

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

數(shù)據(jù)項(xiàng)標(biāo)識(shí)含義數(shù)據(jù)類(lèi)型及長(zhǎng)度說(shuō)明

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

jgmc機(jī)構(gòu)名稱(chēng)nvarchar(200)——

zcdz注冊(cè)地址nvarchar(400)——

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

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

clrq成立日期date——

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

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

2：注銷(xiāo)；9：其他

1：“正?！保ù胬m(xù)、在營(yíng)、開(kāi)

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

銷(xiāo)，未注銷(xiāo)”；3：“吊銷(xiāo)，已

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

注銷(xiāo)”；4：“注銷(xiāo)”；5：“撤

銷(xiāo)”；6：“遷出”；9：“其

他”

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

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

數(shù)據(jù)項(xiàng)標(biāo)識(shí)含義數(shù)據(jù)類(lèi)型及長(zhǎng)度說(shuō)明

zhgxrq最后更新日期date——

……

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

8.5.1許可參數(shù)

內(nèi)容組成

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

包體標(biāo)記及含義

許可參數(shù)包體標(biāo)記及含義說(shuō)明見(jiàn)表5。

9

DB13/T3041—2024

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

信息類(lèi)別標(biāo)記字符類(lèi)型及長(zhǎng)度含義說(shuō)明

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

jgmcnvarchar(200)機(jī)構(gòu)名稱(chēng)——

appkeynvarchar(8)用戶(hù)賬號(hào)——

appsecretnvarchar(10)用戶(hù)密碼——

用戶(hù)信息

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

startdatenvarchar(10)使用期限開(kāi)始時(shí)間授權(quán)起始日期

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

……

包體格式說(shuō)明

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

許可參數(shù)放置在訪問(wèn)地址的參數(shù)中，見(jiàn)示例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ù)項(xiàng)

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

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

數(shù)據(jù)項(xiàng)標(biāo)識(shí)含義數(shù)據(jù)類(lèi)型及長(zhǎng)度說(shuō)明

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

bglx變更類(lèi)型nvarchar(50)——

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

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

bgsj變更日期date——

……

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

8.6.1許可參數(shù)

內(nèi)容組成

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

包體標(biāo)記及含義

許可參數(shù)包體標(biāo)記及含義說(shuō)明見(jiàn)表7。

10

DB13/T3041—2024

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

信息類(lèi)別標(biāo)記字符類(lèi)型及長(zhǎng)度含義說(shuō)明

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

jgmcnvarchar(200)機(jī)構(gòu)名稱(chēng)——

appkeynvarchar(8)用戶(hù)賬號(hào)——

appsecretnvarchar(10)用戶(hù)密碼——

用戶(hù)信息

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

startdatenvarchar(10)使用期限開(kāi)始時(shí)間授權(quán)起始日期

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

……

包體格式說(shuō)明

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

許可參數(shù)放置在訪問(wèn)地址的參數(shù)里，見(jiàn)示例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ù)項(xiàng)

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

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

數(shù)據(jù)項(xiàng)標(biāo)識(shí)含義數(shù)據(jù)類(lèi)型及長(zhǎng)度說(shuō)明

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

tzrlx投資者類(lèi)型nvarchar(2)——

tzrxm投資者名稱(chēng)nvarchar(200)——

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

tzsj認(rèn)繳出資日期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地址錯(cuò)誤

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

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

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

-300用戶(hù)賬號(hào)錯(cuò)誤

-400用戶(hù)密碼錯(cuò)誤

…………

12

DB13/T3041—2024

A

A

附錄A

（資料性）

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

A.1示例說(shuō)明

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

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

11xxxxxxxx17053009；機(jī)構(gòu)名稱(chēng)為：xx?。ㄊ校?biāo)準(zhǔn)化研究院；通過(guò)接口查詢(xún)數(shù)據(jù)的條件是：機(jī)構(gòu)名

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

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

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

A.2示例程序代碼

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

packagetestjgdm;//包名testjgdm

import.URLEncoder;

importjava.util.HashMap;

importjava.util.Map;

importorg.apache.http.HttpResponse;

importorg.apache.http.util.EntityUtils;

publicclassjgdm{//定義類(lèi)jgdm

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

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

{

Stringstrkey1="標(biāo)準(zhǔn)";//查詢(xún)關(guān)鍵字1

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

try{

strkey=URLEncoder.encode(strkey1,"utf-8");//將查詢(xún)關(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";//接口名稱(chēng)

13

DB13/T3041—2024

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

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

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

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

Stringjgmc="xx?。ㄊ校?biāo)準(zhǔn)化研究院";//許可參數(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{//向接口提交請(qǐng)求

HttpResponseresponse=HttpUtils.doPost(host+service_path,serivce_name,method,

headers,querys,"");

//獲取反饋的數(shù)據(jù)包，并在控制窗口中打印出來(lái)

System.out.println(EntityUtils.toString(response.getEntity()));

}catch(Exceptione)

{

e.printStackTrace();

14

DB13/T3041—2024

B

B

附錄B

（資料性）

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

B.1示例說(shuō)明

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

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

構(gòu)名稱(chēng)為：xx?。ㄊ校?biāo)準(zhǔn)化研究院；通過(guò)接口查詢(xún)數(shù)據(jù)的條件是：統(tǒng)一社會(huì)信息用代碼為

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

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

B.2示例程序代碼

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

packagetestjgdm;//包名testjgdm

import.URLEncoder;

importjava.util.HashMap;

importjava.util.Map;

importorg.apache.http.HttpResponse;

importorg.apache.http.util.EntityUtils;

publicclassjgdm{//定義類(lèi)jgdm

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

{

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

try{

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

}catch(Exceptione1)

{

e1.printStackTrace();

}

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

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

Stringserivce_name="HBbgkinfo";//接口名稱(chēng)

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

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

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

15

DB13/T3041—2024

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

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

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