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

《DB11_T 3041-2024 法人和其他组织统一社会信用代码数据共享应用规范.docx》由会员分享，可在线阅读，更多相关《DB11_T 3041-2024 法人和其他组织统一社会信用代码数据共享应用规范.docx（23页珍藏版）》请在淘文阁 - 分享文档赚钱的网站上搜索。

1、ICS35.020CCSA20DB11北京市地方标准DB11/T30412024法人和其他组织统一社会信用代码数据共享应用规范Specificationofdatasharingandapplicationoftheunifiedsocialcreditidentifierforlegalentitiesandotherorganizations2024-01-28发布2024-02-18实施北京市市场监督管理局发布DB11/T30412024目次前言.II引言.III1范围.12规范性引用文件.13术语和定义.14缩略语.15数据共享应用框架.26网络要求.47安全要求.48数据应用方式.4

2、9数据应用调用信息.12附录A（资料性）统一社会信用代码基础数据接口调用方法示例.13附录B（资料性）统一社会信用代码变更数据接口调用方法示例.15附录C（资料性）统一社会信用代码股东数据接口调用方法示例.17参考文献.19IDB11/T30412024前言为推进京津冀协同发展战略实施，北京市市场监督管理局、天津市市场监督管理委员会、河北省市场监督管理局共同组织制定本地方标准，在京津冀区域内适用，现予发布。本文件按照GB/T1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件由北京市市场监督管理局提出并归口。本文件由北京市市场监督管理局组织实施。本文件起草单位：（

3、河北组）河北省标准化研究院。（北京组）北京市市场监督管理局风险管理中心。（天津组）天津市标准化研究院。本文件主要起草人：（河北组）李虓峰、李会、闫志强、尚晓帆、陈聪、高思瑶、王子康、董世涛、阎占辉。（北京组）胡伟、杨德富、蔡欣畅、朱海绫、张赢、王健。（天津组）张楠、由方岚、赵汉杰、徐超、董津生、张然。IIDB11/T30412024引言本文件以京津冀法人和其他组织统一社会信用代码数据库为基础，规范了统一社会信用代码数据的共享与应用，解决了数据服务动态性差、共享与应用效率低、数据存储成本高等问题，为各政务部门的不同需求，提供了个性化、差异性服务，推动了三地统一社会信用代码数据资源深度共享。III

4、DB11/T30412024法人和其他组织统一社会信用代码数据共享应用规范1范围本文件规定了京津冀统一社会信用代码数据共享应用框架、网络要求、安全要求、数据应用方式和数据应用调用信息。本文件适用于政务部门通过数据共享平台以接口方式进行的京津冀统一社会信用代码数据信息共享应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T2260中华人民共和国行政区划代码GB/T4754国民经济行业分类GB/T14733.8电信术语电话GB/T2223

5、9信息安全技术网络安全等级保护基本要求GB32100法人和其他组织统一社会信用代码编码规则3术语和定义下列术语和定义适用于本文件。3.1请求request接口用户向接口发出的一次调用申请。3.2响应response接口向接口用户返回请求的操作结果。3.3包体package-body数据传输中的实体主体部分。4缩略语下列缩略语适用于本文件。HTTPS基于安全套接字的超文本传输协议（HypertextTransferProtocolSecure）XML可扩展标识语言（ExtensibleMarkupLanguage）JSONJS对象标记（JavaScriptObjectNotation）1DB11

6、/T304120245数据共享应用框架5.1共享应用模型5.1.1概述数据共享应用模型包括数据共享概念模型和数据共享技术架构。数据共享技术架构是支持数据共享概念模型的逻辑框架。其中：a)数据共享概念模型：描述了信息的提供方、使用方及应用方遵循已确定的信息共享规程，进行数据共享的业务过程；b)数据共享技术架构：描述了支持数据共享实现的技术要求。5.1.2数据共享概念模型5.1.2.1概念模型提供方、管理方和应用方通过数据交换行为实现数据共享活动，如图1所示。图1数据共享概念模型5.1.2.2共享角色按照数据共享业务视角对数据共享角色进行分类，包括提供方、管理方和应用方：a)提供方：提供共享数据的

7、机构；b)管理方：管理共享数据应用合规性的机构；c)应用方：应用数据的机构。5.1.2.3共享行为遵照管理方批准的规程，提供方、管理方和应用方的数据共享活动通过数据交换行为实现：a)提供方将数据传输给管理方，由管理方发布到数据共享平台；b)应用方通过共享平台将查询内容提交给管理方，管理方向应用方提供查询结果，并将查询结果反馈提供方；c)应用方查询内容涉及敏感信息的，需预先征得数据提供方同意后，方能获取查询结果。5.1.3数据共享技术架构围绕需要政务部门间共享的数据给出了数据共享技术架构，如图2所示，架构包括以下内容：a)网络：为数据共享提供网络基础设施支撑，包括互联网、电子政务外网；b)数据：

8、数据共享过程中产生的信息，包括数据内容、数据编码、数据质量、数据表达；c)系统：数据共享过程中数据管理方和应用方进行数据共享的平台，包括目录系统和交换系统；d)安全：包括安全管理和安全技术；e)管理：包括数据内容管理、数据字典管理及数据日常维护管理等方面的内容。2DB11/T30412024图2数据共享技术架构5.2共享应用流程5.2.1流程图统一社会信用代码数据共享应用流程，如图3所示。数据共享平台数据管理方数据应用方不通过调用配置数据共享内容申请审批配置数据应用方许可信息调用共享数据提出数据共享应用申请接收许可信息发送数据共享请求核查许可信息不符合符合图3数据共享应用流程数据应用终止完成数

9、据共享应用结束3DB11/T304120245.2.2共享申请、许可和响应5.2.2.1数据应用方向数据管理方提交数据共享应用申请，申请信息包括但不限于以下内容：a)机构统一社会信用代码；b)机构名称；c)用于实现数据共享应用设备的IP地址；d)申请使用期限；e)申请使用数据项；f)申请使用数据范围。5.2.2.2数据管理方收到申请后，生成许可信息反馈给数据应用方，许可信息包括但不限于以下内容：a)机构统一社会信用代码；b)机构名称；c)用户账号；d)用户密码；e)用于实现数据共享应用设备的IP地址；f)申请使用期限；g)数据共享平台地址。5.2.2.3数据应用方通过数据共享平台调用数据信息时

10、，应提供被授予的许可信息。5.2.2.4数据管理方在接收到请求后，校验数据应用方许可信息中用户账号和用户密码的合法性、用于实现数据共享应用设备的IP地址和申请使用期限的有效性，检验通过后，执行请求，返回响应内容。6网络要求数据共享应用网络要求如下：a)敏感数据应通过电子政务外网传输；b)其他信息可通过互联网传输。7安全要求应符合GB/T22239的相关要求。8数据应用方式8.1概述数据应用方通过嵌入到数据共享平台中的接口调用统一社会信用代码基础数据、统一社会信用代码变更数据和统一社会信用代码股东数据。8.2接口定义统一社会信用代码接口定义见表1。4接口分类定义说明统一社会信用代码基础数据接口S

11、tringHBtydm_sh_service(stringlicence,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

12、)；5.接口返回结果见8.4.4。StringBJtydm_sh_service(stringlicence,stringcond_information,stringrepl_packagetype)StringTJtydm_sh_service(stringlicence,stringcond_information,stringrepl_packagetype)统一社会信用代码变更数据接口StringHBbgkinfo(stringlicence,stringrepl_packagetype)1.HBbgkinfo为约定的河北省统一社会信用代码变更数据接口名称；BJbgkinfo为约定的

13、北京市统一社会信用代码变更数据接口名称；TJbgkinfo为约定的天津市统一社会信用代码变更数据接口名称；2.license为许可参数(见8.5.1)；3.repl_packagetype为返回结果数据包格式参数(见8.5.2)；4.接口返回结果见8.5.3。StringBJbgkinfo(stringlicence,stringrepl_packagetype)StringTJbgkinfo(stringlicence,stringrepl_packagetype)统一社会信用代码股东数据接口StringHBinvinfo(stringlicence,stringrepl_packagety

14、pe)1.HBinvinfo为约定的河北省统一社会信用代码股东数据接口名称；2.license为许可参数(见8.6.1)；3.repl_packagetype为返回结果数据包格式参数(见8.6.2)；4.接口返回结果见8.6.3。DB11/T30412024表1统一社会信用代码接口定义8.3基本约定8.3.1传输协议采用HTTPS作为传输协议。8.3.2地址格式接口地址由数据管理方提供，格式为：https:/xxx.xxx.xxx.xxx/services_path/service_name。其中，xxx.xxx.xxx.xxx表示接口所在服务器的有效地址；services_path表示接口的

15、发布路径，由数据管理方命名；service_name表示约定的接口名称，由数据管理方命名。8.3.3调用方法统一社会信用代码基础数据、统一社会信用代码变更数据、统一社会信用代码股东数据接口调用方法示例分别见附录A、附录B和附录C。5信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码jgmcnvarchar(200)机构名称appkeynvarchar(8)用户账号appsecretnvarchar(10)用户密码ipnvarchar(15)被授权应用接口设备的IP地址startdatenvarchar(10)使用期限开始时间授权起始日期endda

16、tenvarchar(10)使用期限结束时间授权终止日期DB11/T304120248.4统一社会信用代码基础信息接口8.4.1许可参数8.4.1.1内容组成许可参数由一组用户信息组成。8.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:xxx8.4.2条件参数包体8.4.2.1内容组成

17、条件参数由条件逻辑关系、条件数据项集、返回结果数据项名称组成，如图4所示。图4条件参数6关系运算符含义说明=等于1.字符型按字符编码顺序进行比较；2.数值型应转换成数值进行比较；3.日期型应转换成日期进行比较；4.日期时间型应转换成时间进行比较。大于=大于或等于!=不等于like模糊匹配仅可应用于字符型的数据项，从字符串任意位置进行匹配leftlike左匹配仅可应用于字符型的数据项，从字符串起始端匹配rightlike右匹配仅可应用于字符型的数据项，从字符串尾端匹配isnull空值isnotnull非空DB11/T304120248.4.2.2条件参数包体格式说明条件参数包体采用JSON格式。

18、条件参数放置在标记exp:xxx,fields:field:xxx,operation:xxx,value:xxx,field:xxx,operation:xxx,value:xxx,result:xxx之间。exp关键字为条件逻辑关系。其中“与”、“或”分别用“*”、“+”标识；为空时，默认为“与”；在逻辑关系中，第一个条件数据项用0表示，第二个用1表示，以此类推，第n个用n-1表示，各条件之间可以用圆括号运算符（）组合。fields关键字为条件数据项集。其中field关键字为条件数据项；operation为条件数据项的关系运算符，其表示及含义见表3；value为条件数据项的值。result

19、关键字为返回结果中用户要求的数据项名称，各数据项间以英文“,”分隔。数据项标识应符合本文件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:xxx7DB11/T30412024result:tyshxydm,jgmc,zcdzxzqhdm8.4.3返回结果数据包格式参数接口返回结果数据包格式参数由数据应用方根据需要设定。

20、该参数取值可为xml或json，不能为空。8.4.4返回结果8.4.4.1内容组成返回结果包括调用状态信息、结果数据和结果集记录数。接口调用失败时，只返回调用状态信息，见图5。调用状态信息结果数据结果集记录数结果记录数据1结果记录数据n数据项1数据项n注：返回结果记录数据过多时，默认显示前50条数据。图5返回结果8.4.4.2包体格式说明8.4.4.2.1XML格式XML格式采用标准DATAPACKET2.0版本。返回结果中的调用状态和结果集记录数信息放置在标记之间,关键字status为调用状态代码，msg为调用状态描述，totalcount为结果集记录个数。调用状态代码和描述应符合第9章的规

21、定。结果数据置于标记之间。结果数据不同记录用分隔。数据项标识应符合8.4.5的规定。返回结果包体XML格式见示例3。示例3：8.4.4.2.2JSON格式返回结果信息放置在标记respdata:status:xxx,msg:xxx,totalcount:xxx,rowdata:xxx,xxx之间。8数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合GB32100jgmc机构名称nvarchar(200)zcdz注册地址nvarchar(400)zcdzxzqhdm注册地址行政区划代码nvarchar(6)符合GB/T2260jyfw经营范围nvarch

22、ar(2000)clrq成立日期datedjywlx登记业务类型nvarchar(2)0：注册（设立）；1：变更；2：注销；9：其他jyzt经营状态nvarchar(2)1：“正常”（存续、在营、开业、注册、设立）,2：“吊销，未注销”；3：“吊销，已注销”；4：“注销”；5：“撤销”；6：“迁出”；9：“其他”jjhydm经济行业代码nvarchar(6)符合GB/T4754lxdh联系电话nvarchar(18)符合GB/T14733.8DB11/T30412024在respdata标签内，关键字status为调用状态代码，msg为调用状态描述，totalcount为结果集记录个数。调用状

23、态代码和描述应符合本文件9的规定。在rowdata标签内，每条结果数据记录放置在标记之间。数据记录中的数据项标识应符合本文件8.4.5的规定。返回结果包体JSON格式见示例4。示例4：respdata:status:0,msg:调用成功,totalcount:2，rowdata:tyshxydm:xxxxxxxxxxxxxxxxxx,jgmc:xx省（市）xxx股份有限公司，zcdzxzqhdm:xxxxxx,tyshxydm:xxxxxxxxxxxxxxxxxx,jgmc:xx省（市）xx市（区）xxx股份有限公司,zcdzxzqhdm:xxxxxx8.4.5应用服务数据项统一社会信用代码基

24、础信息接口服务提供的数据项见表4。表4统一社会信用代码基础信息接口服务数据项9信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码jgmcnvarchar(200)机构名称appkeynvarchar(8)用户账号appsecretnvarchar(10)用户密码ipnvarchar(15)被授权应用接口的设备的IP地址startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期数据项标识含义数据类型及长度说明zhgxrq最后更新日期dateDB11/T30412024表4

25、统一社会信用代码基础信息接口服务数据项（续）8.5统一社会信用代码变更信息接口8.5.1许可参数8.5.1.1内容组成许可参数由一组用户信息组成。8.5.1.2包体标记及含义许可参数包体标记及含义说明见表5。表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

26、.3返回结果参照本文件8.4.4。8.5.4应用服务数据项统一社会信用代码变更信息接口服务提供的数据项见表6。10信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码jgmcnvarchar(200)机构名称appkeynvarchar(8)用户账号appsecretnvarchar(10)用户密码ipnvarchar(15)被授权应用接口的设备的IP地址startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期数据项标识含义数据类型及长度说明tyshxydm统一社会信用

27、代码nvarchar(18)符合GB32100bglx变更类型nvarchar(50)bgq变更前内容nvarchar(255)bgh变更后内容nvarchar(255)bgsj变更日期dateDB11/T30412024表6统一社会信用代码变更信息接口服务数据项8.6统一社会信用代码股东信息接口8.6.1许可参数8.6.1.1内容组成许可参数由一组用户信息组成。8.6.1.2包体标记及含义许可参数包体标记及含义说明见表7。表7许可参数包体标记及含义8.6.1.3包体格式说明许可参数包体采用字串格式。许可参数放置在访问地址的参数里，见示例6。示例6：https:/xxx.xxx.xxx.xxx

28、/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshxydm=xxx8.6.2返回结果数据包格式参数参照本文件8.4.3。11接口状态代码接口状态描述0调用成功1调用失败-100被授权应用接口设备IP地址错误-130条件参数错误-160返回结果数据包格式参数错误-200数据库错误-300用户账号错误-400用户密码错误数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合GB32100tzrlx投资者类型nvarchar(2)tzrxm投资者名称nvarchar(2

29、00)tzzj认缴出资金额numeric(24,8)tzsj认缴出资日期dateDB11/T304120248.6.3返回结果参照本文件8.4.4。8.6.4应用服务数据项统一社会信用代码股东信息接口服务提供的数据项见表8。表8统一社会信用代码股东信息接口服务数据项9数据应用调用信息调用状态信息包括接口状态代码及接口状态描述，如表9所示。表9调用状态信息12DB11/T30412024附录A（资料性）统一社会信用代码基础数据接口调用方法示例A.1示例说明以河北省统一社会信用代码基础数据接口为例，设定统一社会信用代码接口地址为：https:/192.168.100.24:8080/dso/HBt

30、ydm_sh_service；接口用户的统一社会信用代码为：11xxxxxxxx17053009，机构名称为：xx省（市）标准化研究院；通过接口查询数据的条件是：机构名称中包含“标准”且包含“研究院”的机构；返回结果包体是：json格式，结果数据项包括：统一社会信用代码、机构名称、行政区划代码、机构地址、经营范围、经济行业代码、联系电话、注册日期、业务类型和最后更新日期。A.2示例程序代码本示例以java语言实现，程序代码如下：packagetestjgdm;/包名testjgdmimport.URLEncoder;importjava.util.HashMap;importjava.util

31、.Map;importorg.apache.http.HttpResponse;importorg.apache.http.util.EntityUtils;publicclassjgdm/定义类jgdmpublicstaticvoidmain(Stringargs)/调用统一社会信用代码基础数据接口获取符合条件数据的函数Stringstrkey1=标准;/查询关键字1Stringstrkey2=研究院;/查询关键字2trystrkey=URLEncoder.encode(strkey1,utf-8);/将查询关键字转换为utf-8编码strkey2=URLEncoder.encode(str

32、key2,utf-8);catch(Exceptione1)e1.printStackTrace();Stringhost=https:/192.168.100.24:8080;/接口地址Stringservice_path=/dso/;/接口路径Stringserivce_name=HBtydm_sh_service;/接口名称Stringmethod=POST;/提交方式Stringappkey=NyyrcP;/许可参数中的appkeyStringappsecret=jttLM7wu;/许可参数中的appsecretStringtydm=11xxxxxxxx17053009;/许可参数中的

33、tyshxydmStringjgmc=xx省（市）标准化研究院;/许可参数中的jgmcStringip=192.168.100.25:8080;/许可参数中的ipStringstartdate=2023-02-01;/许可参数中的startdateStringenddate=2024-01-31;/许可参数中的enddateMapheaders=newHashMap();Mapquerys=newHashMap();13DB11/T30412024/构建许可参数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,fddbrxm,zcdzxzqhd