DB13_T 3041-2024 法人和其他组织统一社会信用代码数据共享应用规范.docx

ICS 35.020CCS A 2013河北省地方标准DB 13/T 30412024法人和其他组织统一社会信用代码数据共享应用规范2024 - 01 - 18 发布2024 - 02 - 18 实施河北省市场监督管理局发 布DB 13/T 30412024前言为推进京津冀协同发展战略实施，北京市市场监督管理局、天津市市场监督管理委员会、河北省市场监督管理局共同组织制定本地方标准，在京津冀区域内适用，现予发布。本文件按照GB/T 1.1-2020标准化工作导则 第1部分：标准化文件的结构和起草规则的规定起草。本文件由河北省市场监督管理局提出。本文件起草单位：（河北组）河北省标准化研究院。（北京组）北京市市场监督管理局风险管理中心。（天津组）天津市标准化研究院。本文件主要起草人：（河北组）李虓峰、李会、闫志强、尚晓帆、陈聪、高思瑶、王子康、董世涛、阎占辉。（北京组）胡伟、杨德富、蔡欣畅、朱海绫、张赢、王健。（天津组）张楠、由方岚、赵汉杰、徐超、董津生、张然。IDB 13/T 30412024引言本文件以京津冀法人和其他组织统一社会信用代码数据库为基础，规范了统一社会信用代码数据的共享与应用，解决了数据服务动态性差、共享与应用效率低、数据存储成本高等问题，为各政务部门的不同需求，提供了个性化、差异性服务，推动了三地统一社会信用代码数据资源深度共享。IIDB 13/T 30412024法人和其他组织统一社会信用代码数据共享应用规范1范围本文件规定了京津冀统一社会信用代码数据共享应用框架、网络要求、安全要求、数据应用方式和数据应用调用信息。本文件适用于政务部门通过数据共享平台以接口方式进行的京津冀统一社会信用代码数据信息共享应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T 2260中华人民共和国行政区划代码GB/T 4754国民经济行业分类GB/T 14733.8电信术语 电话GB 32100法人和其他组织统一社会信用代码编码规则3术语和定义下列术语和定义适用于本文件。请求request接口用户向接口发出的一次调用申请。响应response接口向接口用户返回请求的操作结果。包体package-body数据传输中的实体主体部分。4缩略语下列缩略语适用于本文件。HTTPS基于安全套接字的超文本传输协议（Hypertext Transfer Protocol Secure）XML可扩展标识语言（Extensible Markup Language）JSONJS对象标记（JavaScript Object Notation）5数据共享应用框架共享应用模型5.1.1概述数据共享应用模型包括数据共享概念模型和数据共享技术架构。数据共享技术架构是支持数据共享概念模型的逻辑框架。其中：1DB 13/T 30412024a)  数据共享概念模型：描述了信息的提供方、使用方及应用方遵循已确定的信息共享规程，进行数据共享的业务过程；b)  数据共享技术架构：描述了支持数据共享实现的技术要求。5.1.2数据共享概念模型5.1.2.1概念模型提供方、管理方和应用方通过数据交换行为实现数据共享活动，如图1所示。图 1数据共享概念模型5.1.2.2共享角色按照数据共享业务视角对数据共享角色进行分类，包括提供方、管理方和应用方：a)提供方：提供共享数据的机构；b)管理方：管理共享数据应用合规性的机构；c)应用方：应用数据的机构。5.1.2.3共享行为遵照管理方批准的规程，提供方、管理方和应用方的数据共享活动通过数据交换行为实现：a)提供方将数据传输给管理方，由管理方发布到数据共享平台；b)应用方通过共享平台将查询内容提交给管理方，管理方向应用方提供查询结果，并将查询结果反馈提供方；c)应用方查询内容涉及敏感信息的，需预先征得数据提供方同意后，方能获取查询结果。5.1.3数据共享技术架构围绕需要政务部门间共享的数据给出了数据共享技术架构，如图2所示，架构包括以下内容：a)网络：为数据共享提供网络基础设施支撑，包括互联网、电子政务外网；b)数据：数据共享过程中产生的信息，包括数据内容、数据编码、数据质量、数据表达；c)系统：数据共享过程中数据管理方和应用方进行数据共享的平台，包括目录系统和交换系统；d)安全：包括安全管理和安全技术；e)管理：包括数据内容管理、数据字典管理及数据日常维护管理等方面的内容。2安全安全管理安全技术系统目录系统               交换系统数据数据内容               数据编码数据质量数据表达网络图 2 数据共享技术架构DB 13/T 30412024管理数据内容数据字典数据日常维护共享应用流程5.2.1流程图统一社会信用代码数据共享应用流程，如图3所示。图 3数据共享应用流程5.2.2共享申请、许可和响应5.2.2.1数据应用方向数据管理方提交数据共享应用申请，申请信息包括但不限于以下内容：a)机构统一社会信用代码；b)机构名称；c)用于实现数据共享应用设备的 IP 地址；d)申请使用期限；e)申请使用数据项；3接口分类定义说明统一社会信用代码基础数据接口String HBtydm_sh_service (string licence,stringcond_information,stringrepl_packagetype)1.HBtydm_sh_service 为约定的河北省统一社会信用代码基础数据接口名称；BJtydm_sh_service 为约定的北京市统一社会信用代码基础数据接口名称；TJtydm_sh_service 为约定的天津市统一社会信用代码基础数据接口名称；2.license 为许可参数(见 8.4.1)；3.cond_information 为条件参数(见 8.4.2)；4.repl_packagetype 为返回结果数据包格式参数(见 8.4.3)；5.接口返回结果见 8.4.4。DB 13/T 30412024f)申请使用数据范围。5.2.2.2数据管理方收到申请后，生成许可信息反馈给数据应用方，许可信息包括但不限于以下内容：a)机构统一社会信用代码；b)机构名称；c)用户账号；d)用户密码；e)用于实现数据共享应用设备的 IP 地址；f)申请使用期限；g)数据共享平台地址。5.2.2.3数据应用方通过数据共享平台调用数据信息时，应提供被授予的许可信息。5.2.2.4数据管理方在接收到请求后，校验数据应用方许可信息中用户账号和用户密码的合法性、用于实现数据共享应用设备的 IP 地址和申请使用期限的有效性，检验通过后，执行请求，返回响应内容。6网络要求数据共享应用网络要求如下：a)敏感数据应通过电子政务外网传输；b)其他信息可通过互联网传输。7安全要求应符合GB/T 22239-2019中8的规定要求。8数据应用方式概述数据应用方通过嵌入数据共享平台中的接口调用统一社会信用代码基础数据、统一社会信用代码变更数据和统一社会信用代码股东数据。接口定义统一社会信用代码接口定义见表1。表 1统一社会信用代码接口定义4接口分类定义说明统一社会信用代码基础数据接口String BJtydm_sh_service (string licence,stringcond_information,stringrepl_packagetype)1.HBtydm_sh_service 为约定的河北省统一社会信用代码基础数据接口名称；BJtydm_sh_service 为约定的北京市统一社会信用代码基础数据接口名称；TJtydm_sh_service 为约定的天津市统一社会信用代码基础数据接口名称；2.license 为许可参数(见 8.4.1)；3.cond_information 为条件参数(见 8.4.2)；4.repl_packagetype 为返回结果数据包格式参数(见 8.4.3)；5.接口返回结果见 8.4.4。String TJtydm_sh_service (string licence,stringcond_information,stringrepl_packagetype)统一社会信用代码变更数据接口String HBbgkinfo (string licence,stringrepl_packagetype)1.HBbgkinfo 为约定的河北省统一社会信用代码变更数据接口名称；BJbgkinfo 为约定的北京市统一社会信用代码变更数据接口名称；TJbgkinfo 为约定的天津市统一社会信用代码变更数据接口名称；2.license 为许可参数(见 8.5.1)；3.repl_packagetype 为返回结果数据包格式参数(见 8.5.2)；4.接口返回结果见 8.5.3。String BJbgkinfo (string licence,stringrepl_packagetype)String TJbgkinfo (string licence,stringrepl_packagetype)统一社会信用代码股东数据接口String HBinvinfo (string licence,stringrepl_packagetype)1.HBinvinfo 为约定的河北省统一社会信用代码股东数据接口名称；2.license 为许可参数(见 8.6.1)；3.repl_packagetype 为返回结果数据包格式参数(见 8.6.2)；4.接口返回结果见 8.6.3。DB 13/T 30412024表 1统一社会信用代码接口定义（续）基本约定8.3.1传输协议采用HTTPS作为传输协议。8.3.2地址格式接口地址由数据管理方提供，格式为：https:/xxx.xxx.xxx.xxx/services_path/service_name。其中，xxx.xxx.xxx.xxx表示接口所在服务器的有效地址；services_path表示接口的发布路径，由数据管理方命名；service_name表示约定的接口名称，由数据管理方命名。8.3.3调用方法统一社会信用代码基础数据、统一社会信用代码变更数据、统一社会信用代码股东数据接口调用方法示例分别见附录A、附录B和附录C。统一社会信用代码基础数据接口8.4.1许可参数8.4.1.1内容组成许可参数由一组用户信息组成。5信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码jgmcnvarchar(200)机构名称appkeynvarchar(8)用户账号appsecretnvarchar(10)用户密码ipnvarchar(15)被授权应用接口设备的 IP 地址startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期DB 13/T 304120248.4.1.2包体标记及含义许可参数包体标记及含义说明见表 2。表 2许可参数包体标记及含义8.4.1.3包体格式说明许可参数包体采用 JSON 格式。许可参数放置在标记之间，见示例 1。示例 1："tyshxydm":"xxxxxxxxxxxxxxxx","jgmc":"xxx","appkey":"xxx","appsecret":"xxx","ip":"xxx","startdate":"xxx","enddate":"xxx"8.4.2条件参数包体8.4.2.1内容组成条件参数由条件逻辑关系、条件数据项集、返回结果数据项名称组成，如图 4 所示。图 4条件参数8.4.2.2条件参数包体格式说明条件参数包体采用 JSON 格式。条 件 参 数 放 置 在 标 记 "exp":"xxx","fields":"field":"xxx","operation":"xxx","value":"x“xx","field":"xxx","operation":"xxx","value":"xxx","result":"xxx"之间。exp 关键字为条件逻辑关系。其中“与”、 或”分别用“*”、 +”标识；为空时，默认为“与”；在逻辑关系中，第一个条件数据项用0表示，第二个用1表示，以此类推，第 n 个用n-1表示，各条件之间可以用圆括号运算符（）组合。fields 关键字为条件数据项集。其中 field 关键字为条件数据项；operation 为条件数据项的6关系运算符含义说明=等于1.字符型应按字符编码顺序进行比较；2.数值型应转换成数值进行比较；3.日期型应转换成日期进行比较；4.日期时间型应转换成时间进行比较。<小于>大于<=小于或等于>=大于或等于!=不等于like模糊匹配仅可应用于字符型的数据项，从字符串任意位置进行匹配left like左匹配仅可应用于字符型的数据项，从字符串起始端匹配right like右匹配仅可应用于字符型的数据项，从字符串尾端匹配is null空值is not null非空DB 13/T 30412024关系运算符，其表示及含义见表 3；value 为条件数据项的值。result 关键字为返回结果中用户要求的数据项名称，各数据项间以英文“,”分隔。数据项标识应符合本文件 8.4.5 的规定。表 3关系运算符表示及含义条件参数包体格式见示例 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返回结果数据包格式参数接口返回结果数据包格式参数由数据应用方根据需要设定。该参数取值可为 xml 或 json，不能为空。8.4.4返回结果8.4.4.1内容组成7DB 13/T 30412024返回结果包括调用状态信息、结果数据和结果集记录数。接口调用失败时，只返回调用状态信息，见图 5。调用状态信息结果数据结果集记录数结果记录数据1结果记录数据n数据项1数据项n注：返回结果记录数据过多时，默认显示前 50 条数据。图 5返回结果8.4.4.2包体格式说明8.4.4.2.1XML格式XML 格式采用标准 DATAPACKET 2.0 版本。返回结果中的调用状态和结果集记录数信息放置在标记<RESPDATA></RESPDATA>之间,关键字status 为调用状态代码，msg 为调用状态描述，totalcount 为结果集记录个数。调用状态代码和描述应符合第 9 章的规定。结果数据置于标记<ROWDATA></ROWDATA>之间。结果数据不同记录用<ROW/><ROW/>分隔。数据项标识应符合 8.4.5 的规定。返回结果包体 XML 格式见示例 3。示例 3：<?xml version="1.0" encoding="UTF-8"?><DATAPACKET Version="2.0"><RESPDATA><RESP status="0" msg="调用成功" totalcount="2" /></RESPDATA><ROWDATA><ROW tyshxydm="xxxxxxxxxxxxxxxxxx" jgmc="xx 省（市）xxx 股份有限公司" zcdzxzqhdm="xxxxxx"/><ROW tyshxydm="xxxxxxxxxxxxxxxxxx" jgmc="xx 市（区）xxx 股份有限公司" zcdzxzqhdm="xxxxxx"/></ROWDATA></DATAPACKET>8.4.4.2.2JSON格式返回结果信息放置在标记"respdata":"status":"xxx","msg":"xxx","totalcount":"xxx","rowdata":xxx,xxx之间。在 respdata 标签内，关键字 status 为调用状态代码，msg 为调用状态描述，totalcount 为结果集记录个数。调用状态代码和描述应符合本文件 9 的规定。在 rowdata 标签内，每条结果数据记录放置在标记之间。数据记录中的数据项标识应符合本文件 8.4.5 的规定。返回结果包体 JSON 格式见示例 4。示例 4："respdata": "status": "0","msg": "调用成功","totalcount": "2"，"rowdata": 8数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合 GB 32100jgmc机构名称nvarchar(200)zcdz注册地址nvarchar(400)zcdzxzqhdm注册地址行政区划代码nvarchar(6)符合 GB/T 2260jyfw经营范围nvarchar(2000)clrq成立日期datedjywlx登记业务类型nvarchar(2)0：注册（设立）；1：变更；2：注销；9：其他jyzt经营状态nvarchar(2)1：“正常”（存续、在营、开业、注册、设立）；2：“吊销，未注销”；3：“吊销，已注销”；4：“注销”；5：“撤销”；6：“迁出”；9：“其他”jjhydm经济行业代码nvarchar(6)符合 GB/T 4754lxdh联系电话nvarchar(18)符合 GB/T 14733.8数据项标识含义数据类型及长度说明zhgxrq最后更新日期dateDB 13/T 30412024"tyshxydm": "xxxxxxxxxxxxxxxxxx","jgmc": "xx 省（市）xxx 股份有限公司"，"zcdzxzqhdm": "xxxxxx","tyshxydm": "xxxxxxxxxxxxxxxxxx","jgmc": " xx 市（区）xxx 股份有限公司","zcdzxzqhdm": "xxxxxx"8.4.5应用服务数据项统一社会信用代码基础数据接口服务提供的数据项见表 4。表 4统一社会信用代码基础数据接口服务数据项统一社会信用代码变更数据接口8.5.1许可参数8.5.1.1内容组成许可参数由一组用户信息组成。8.5.1.2包体标记及含义许可参数包体标记及含义说明见表 5。9信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码jgmcnvarchar(200)机构名称appkeynvarchar(8)用户账号appsecretnvarchar(10)用户密码ipnvarchar(15)被授权应用接口的设备的 IP 地址startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合 GB 32100bglx变更类型nvarchar(50)bgq变更前内容nvarchar(255)bgh变更后内容nvarchar(255)bgsj变更日期dateDB 13/T 30412024表 5许可参数包体标记及含义8.5.1.3包体格式说明许可参数包体采用字串格式。许可参数放置在访问地址的参数中，见示例 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应用服务数据项统一社会信用代码变更数据接口服务提供的数据项见表 6。表 6统一社会信用代码变更数据接口服务数据项统一社会信用代码股东数据接口8.6.1许可参数8.6.1.1内容组成许可参数由一组用户信息组成。8.6.1.2包体标记及含义许可参数包体标记及含义说明见表 7。10信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码jgmcnvarchar(200)机构名称appkeynvarchar(8)用户账号appsecretnvarchar(10)用户密码ipnvarchar(15)被授权应用接口的设备的 IP 地址startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合 GB 32100tzrlx投资者类型nvarchar(2)tzrxm投资者名称nvarchar(200)tzzj认缴出资金额numeric(24,8)tzsj认缴出资日期dateDB 13/T 30412024表 7许可参数包体标记及含义8.6.1.3包体格式说明许可参数包体采用字串格式。许可参数放置在访问地址的参数里，见示例 6。示例 6：https:/xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshxydm=xxx8.6.2返回结果数据包格式参数参照本文件 8.4.3。8.6.3返回结果参照本文件 8.4.4。8.6.4应用服务数据项统一社会信用代码股东数据接口服务提供的数据项见表 8。表 8统一社会信用代码股东数据接口服务数据项9数据应用调用信息调用状态信息包括接口状态代码及接口状态描述，如表 9 所示。11接口状态代码接口状态描述0调用成功1调用失败-100被授权应用接口设备 IP 地址错误-130条件参数错误-160返回结果数据包格式参数错误-200数据库错误-300用户账号错误-400用户密码错误DB 13/T 30412024表 9调用状态信息12DB 13/T 30412024A                    A附录A（资料性）统一社会信用代码基础数据接口调用方法示例A.1示例说明以河北省统一社会信用代码基础数据接口为例，设定统一社会信用代码接口地址为：https:/192.168.100.24:8080/dso/HBtydm_sh_service ； 接 口 用 户 的 统 一 社 会 信 用 代 码 为 ：11xxxxxxxx17053009；机构名称为：xx省（市）标准化研究院；通过接口查询数据的条件是：机构名称中包含“标准”且包含“研究院”的机构；返回结果包体是：json格式；结果数据项包括：统一社会信用代码、机构名称、行政区划代码、机构地址、经营范围、经济行业代码、联系电话、注册日期、业务类型和最后更新日期。A.2示例程序代码本示例以 java 语言实现，程序代码如下：package testjgdm;/包名 testjgdmimport .URLEncoder;import java.util.HashMap;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 strkey1="标准"/查询关键字 1String strkey2="研究院"/查询关键字 2try strkey=URLEncoder.encode(strkey1, "utf-8"); /将查询关键字转换为 utf-8 编码strkey2=URLEncoder.encode(strkey2, "utf-8"); catch (Exception e1)e1.printStackTrace();String host="https:/192.168.100.24:8080"/接口地址String service_path="/dso/"/接口路径String serivce_name="HBtydm_sh_service"/接口名称13DB 13/T 30412024String method="POST"/提交方式String appkey="NyyrcP"/许可参数中的 appkeyString appsecret="jttLM7wu"/许可参数中的 appsecretString tydm="11xxxxxxxx17053009"/许可参数中的 tyshxydmString jgmc="xx 省（市）标准化研究院"/许可参数中的 jgmcString ip="192.168.100.25:8080"/许可参数中的 ipString startdate="2023-02-01"/许可参数中的 startdateString enddate="2024-01-31"/许可参数中的 enddateMap headers=new HashMap();Map querys=new HashMap();/构建许可参数 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": "like","value": ""+strkey1+"","field":"jgmc","operation": "like","value": ""+strkey2+""");try /向接口提交请求HttpResponse response= HttpUtils.doPost(host+service_path, serivce_name, method,headers, querys,"");/获取反馈的数据包，并在控制窗口中打印出来System.out.println(EntityUtils.toString(response.getEntity(); catch (Exception e)e.printStackTrace();14DB 13/T 30412024B                    B附录B（资料性）统一社会信用代码变更数据接口调用方法示例B.1示例说明以河北省统一社会信用代码变更数据接口为例，设定统一社会信用代码接口地址为：https:/192.168.100.24:8080/dso/HBbgkinfo；接口用户的统一社会信用代码为：11xxxxxxxx17053009；机构名称为：xx省（市）标准化研究院；通过接口查询数据的条件是：统一社会信息用代码为11xxxxxxxx17053009的变更信息；返回结果包体是：json格式；结果数据项包括：统一社会信用代码、变更类型、变更前内容、变更后内容和变更日期。B.2示例程序代码本示例以 java 语言实现，程序代码如下：package testjgdm;/包名 testjgdmimport .URLEncoder;import java.util.HashMap;import java.util.Map;import org.apache.http.HttpResponse;import org.apache.http.util.EntityUtils;public class jgdm /定义类 jgdmpublic static void main(String