《DB13_T 3041-2024 法人和其他组织统一社会信用代码数据共享应用规范.docx》由会员分享，可在线阅读，更多相关《DB13_T 3041-2024 法人和其他组织统一社会信用代码数据共享应用规范.docx（22页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、ICS35.020CCSA2013河北省地方标准DB13/T30412024法人和其他组织统一社会信用代码数据共享应用规范2024-01-18发布2024-02-18实施河北省市场监督管理局发布DB13/T30412024前言为推进京津冀协同发展战略实施，北京市市场监督管理局、天津市市场监督管理委员会、河北省市场监督管理局共同组织制定本地方标准，在京津冀区域内适用，现予发布。本文件按照GB/T1.1-2020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件由河北省市场监督管理局提出。本文件起草单位：（河北组）河北省标准化研究院。（北京组）北京市市场监督管理局风险管理中心。（
2、天津组）天津市标准化研究院。本文件主要起草人：（河北组）李虓峰、李会、闫志强、尚晓帆、陈聪、高思瑶、王子康、董世涛、阎占辉。（北京组）胡伟、杨德富、蔡欣畅、朱海绫、张赢、王健。（天津组）张楠、由方岚、赵汉杰、徐超、董津生、张然。IDB13/T30412024引言本文件以京津冀法人和其他组织统一社会信用代码数据库为基础，规范了统一社会信用代码数据的共享与应用，解决了数据服务动态性差、共享与应用效率低、数据存储成本高等问题，为各政务部门的不同需求，提供了个性化、差异性服务，推动了三地统一社会信用代码数据资源深度共享。IIDB13/T30412024法人和其他组织统一社会信用代码数据共享应用规范1范
3、围本文件规定了京津冀统一社会信用代码数据共享应用框架、网络要求、安全要求、数据应用方式和数据应用调用信息。本文件适用于政务部门通过数据共享平台以接口方式进行的京津冀统一社会信用代码数据信息共享应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。GB/T2260中华人民共和国行政区划代码GB/T4754国民经济行业分类GB/T14733.8电信术语电话GB32100法人和其他组织统一社会信用代码编码规则3术语和定义下列术语和定义适用于本文件。请
4、求request接口用户向接口发出的一次调用申请。响应response接口向接口用户返回请求的操作结果。包体package-body数据传输中的实体主体部分。4缩略语下列缩略语适用于本文件。HTTPS基于安全套接字的超文本传输协议（HypertextTransferProtocolSecure）XML可扩展标识语言（ExtensibleMarkupLanguage）JSONJS对象标记（JavaScriptObjectNotation）5数据共享应用框架共享应用模型5.1.1概述数据共享应用模型包括数据共享概念模型和数据共享技术架构。数据共享技术架构是支持数据共享概念模型的逻辑框架。其中：1D
5、B13/T30412024a)数据共享概念模型：描述了信息的提供方、使用方及应用方遵循已确定的信息共享规程，进行数据共享的业务过程；b)数据共享技术架构：描述了支持数据共享实现的技术要求。5.1.2数据共享概念模型5.1.2.1概念模型提供方、管理方和应用方通过数据交换行为实现数据共享活动，如图1所示。图1数据共享概念模型5.1.2.2共享角色按照数据共享业务视角对数据共享角色进行分类，包括提供方、管理方和应用方：a)提供方：提供共享数据的机构；b)管理方：管理共享数据应用合规性的机构；c)应用方：应用数据的机构。5.1.2.3共享行为遵照管理方批准的规程，提供方、管理方和应用方的数据共享活动
6、通过数据交换行为实现：a)提供方将数据传输给管理方，由管理方发布到数据共享平台；b)应用方通过共享平台将查询内容提交给管理方，管理方向应用方提供查询结果，并将查询结果反馈提供方；c)应用方查询内容涉及敏感信息的，需预先征得数据提供方同意后，方能获取查询结果。5.1.3数据共享技术架构围绕需要政务部门间共享的数据给出了数据共享技术架构，如图2所示，架构包括以下内容：a)网络：为数据共享提供网络基础设施支撑，包括互联网、电子政务外网；b)数据：数据共享过程中产生的信息，包括数据内容、数据编码、数据质量、数据表达；c)系统：数据共享过程中数据管理方和应用方进行数据共享的平台，包括目录系统和交换系统；
7、d)安全：包括安全管理和安全技术；e)管理：包括数据内容管理、数据字典管理及数据日常维护管理等方面的内容。2安全安全管理安全技术系统目录系统交换系统数据数据内容数据编码数据质量数据表达网络图2数据共享技术架构DB13/T30412024管理数据内容数据字典数据日常维护共享应用流程5.2.1流程图统一社会信用代码数据共享应用流程，如图3所示。图3数据共享应用流程5.2.2共享申请、许可和响应5.2.2.1数据应用方向数据管理方提交数据共享应用申请，申请信息包括但不限于以下内容：a)机构统一社会信用代码；b)机构名称；c)用于实现数据共享应用设备的IP地址；d)申请使用期限；e)申请使用数据项；3
8、接口分类定义说明统一社会信用代码基础数据接口StringHBtydm_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_package
9、type为返回结果数据包格式参数(见8.4.3)；5.接口返回结果见8.4.4。DB13/T30412024f)申请使用数据范围。5.2.2.2数据管理方收到申请后，生成许可信息反馈给数据应用方，许可信息包括但不限于以下内容：a)机构统一社会信用代码；b)机构名称；c)用户账号；d)用户密码；e)用于实现数据共享应用设备的IP地址；f)申请使用期限；g)数据共享平台地址。5.2.2.3数据应用方通过数据共享平台调用数据信息时，应提供被授予的许可信息。5.2.2.4数据管理方在接收到请求后，校验数据应用方许可信息中用户账号和用户密码的合法性、用于实现数据共享应用设备的IP地址和申请使用期限的有效
10、性，检验通过后，执行请求，返回响应内容。6网络要求数据共享应用网络要求如下：a)敏感数据应通过电子政务外网传输；b)其他信息可通过互联网传输。7安全要求应符合GB/T22239-2019中8的规定要求。8数据应用方式概述数据应用方通过嵌入数据共享平台中的接口调用统一社会信用代码基础数据、统一社会信用代码变更数据和统一社会信用代码股东数据。接口定义统一社会信用代码接口定义见表1。表1统一社会信用代码接口定义4接口分类定义说明统一社会信用代码基础数据接口StringBJtydm_sh_service(stringlicence,stringcond_information,stringrepl_p
11、ackagetype)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。StringTJtydm_sh_service(stringlicence,stringcond_inform
12、ation,stringrepl_packagetype)统一社会信用代码变更数据接口StringHBbgkinfo(stringlicence,stringrepl_packagetype)1.HBbgkinfo为约定的河北省统一社会信用代码变更数据接口名称；BJbgkinfo为约定的北京市统一社会信用代码变更数据接口名称；TJbgkinfo为约定的天津市统一社会信用代码变更数据接口名称；2.license为许可参数(见8.5.1)；3.repl_packagetype为返回结果数据包格式参数(见8.5.2)；4.接口返回结果见8.5.3。StringBJbgkinfo(stringlice
13、nce,stringrepl_packagetype)StringTJbgkinfo(stringlicence,stringrepl_packagetype)统一社会信用代码股东数据接口StringHBinvinfo(stringlicence,stringrepl_packagetype)1.HBinvinfo为约定的河北省统一社会信用代码股东数据接口名称；2.license为许可参数(见8.6.1)；3.repl_packagetype为返回结果数据包格式参数(见8.6.2)；4.接口返回结果见8.6.3。DB13/T30412024表1统一社会信用代码接口定义（续）基本约定8.3.1传
14、输协议采用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内容组成许可参数由一组
15、用户信息组成。5信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码jgmcnvarchar(200)机构名称appkeynvarchar(8)用户账号appsecretnvarchar(10)用户密码ipnvarchar(15)被授权应用接口设备的IP地址startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期DB13/T304120248.4.1.2包体标记及含义许可参数包体标记及含义说明见表2。表2许可参数包体标记及含义8.4.1.3包体格式说明许可参数包体采用J
16、SON格式。许可参数放置在标记之间，见示例1。示例1：tyshxydm:xxxxxxxxxxxxxxxx,jgmc:xxx,appkey:xxx,appsecret:xxx,ip:xxx,startdate:xxx,enddate:xxx8.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,v
17、alue:xxx,result:xxx之间。exp关键字为条件逻辑关系。其中“与”、或”分别用“*”、+”标识；为空时，默认为“与”；在逻辑关系中，第一个条件数据项用0表示，第二个用1表示，以此类推，第n个用n-1表示，各条件之间可以用圆括号运算符（）组合。fields关键字为条件数据项集。其中field关键字为条件数据项；operation为条件数据项的6关系运算符含义说明=等于1.字符型应按字符编码顺序进行比较；2.数值型应转换成数值进行比较；3.日期型应转换成日期进行比较；4.日期时间型应转换成时间进行比较。大于=大于或等于!=不等于like模糊匹配仅可应用于字符型的数据项，从字符串任意
18、位置进行匹配leftlike左匹配仅可应用于字符型的数据项，从字符串起始端匹配rightlike右匹配仅可应用于字符型的数据项，从字符串尾端匹配isnull空值isnotnull非空DB13/T30412024关系运算符，其表示及含义见表3；value为条件数据项的值。result关键字为返回结果中用户要求的数据项名称，各数据项间以英文“,”分隔。数据项标识应符合本文件8.4.5的规定。表3关系运算符表示及含义条件参数包体格式见示例2。示例2：exp:0*(1*2),fields:field:zcdzxzqhdm,operation:=,value:xxx,field:jgmc,operati
19、on:like,value:xxx，field:zcdz,operation:like,value:xxxresult:tyshxydm,jgmc,zcdzxzqhdm8.4.3返回结果数据包格式参数接口返回结果数据包格式参数由数据应用方根据需要设定。该参数取值可为xml或json，不能为空。8.4.4返回结果8.4.4.1内容组成7DB13/T30412024返回结果包括调用状态信息、结果数据和结果集记录数。接口调用失败时，只返回调用状态信息，见图5。调用状态信息结果数据结果集记录数结果记录数据1结果记录数据n数据项1数据项n注：返回结果记录数据过多时，默认显示前50条数据。图5返回结果8.
20、4.4.2包体格式说明8.4.4.2.1XML格式XML格式采用标准DATAPACKET2.0版本。返回结果中的调用状态和结果集记录数信息放置在标记之间,关键字status为调用状态代码，msg为调用状态描述，totalcount为结果集记录个数。调用状态代码和描述应符合第9章的规定。结果数据置于标记之间。结果数据不同记录用分隔。数据项标识应符合8.4.5的规定。返回结果包体XML格式见示例3。示例3：8.4.4.2.2JSON格式返回结果信息放置在标记respdata:status:xxx,msg:xxx,totalcount:xxx,rowdata:xxx,xxx之间。在respdata标
21、签内，关键字status为调用状态代码，msg为调用状态描述，totalcount为结果集记录个数。调用状态代码和描述应符合本文件9的规定。在rowdata标签内，每条结果数据记录放置在标记之间。数据记录中的数据项标识应符合本文件8.4.5的规定。返回结果包体JSON格式见示例4。示例4：respdata:status:0,msg:调用成功,totalcount:2，rowdata:8数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合GB32100jgmc机构名称nvarchar(200)zcdz注册地址nvarchar(400)zcdzxzqhdm注
22、册地址行政区划代码nvarchar(6)符合GB/T2260jyfw经营范围nvarchar(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.8数据项标识含义数据类型及长度说明zhgxrq最后更新日期dateD
23、B13/T30412024tyshxydm:xxxxxxxxxxxxxxxxxx,jgmc:xx省（市）xxx股份有限公司，zcdzxzqhdm:xxxxxx,tyshxydm:xxxxxxxxxxxxxxxxxx,jgmc:xx市（区）xxx股份有限公司,zcdzxzqhdm:xxxxxx8.4.5应用服务数据项统一社会信用代码基础数据接口服务提供的数据项见表4。表4统一社会信用代码基础数据接口服务数据项统一社会信用代码变更数据接口8.5.1许可参数8.5.1.1内容组成许可参数由一组用户信息组成。8.5.1.2包体标记及含义许可参数包体标记及含义说明见表5。9信息类别标记字符类型及长度含义
24、说明用户信息tyshxydmnvarchar(18)统一社会信用代码jgmcnvarchar(200)机构名称appkeynvarchar(8)用户账号appsecretnvarchar(10)用户密码ipnvarchar(15)被授权应用接口的设备的IP地址startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合GB32100bglx变更类型nvarchar(50)bgq变更前内容nvarchar(255)bgh变更后内容
25、nvarchar(255)bgsj变更日期dateDB13/T30412024表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统一社会信用代码
26、变更数据接口服务数据项统一社会信用代码股东数据接口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)使用期限结束时间授
27、权终止日期数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合GB32100tzrlx投资者类型nvarchar(2)tzrxm投资者名称nvarchar(200)tzzj认缴出资金额numeric(24,8)tzsj认缴出资日期dateDB13/T30412024表7许可参数包体标记及含义8.6.1.3包体格式说明许可参数包体采用字串格式。许可参数放置在访问地址的参数里，见示例6。示例6：https:/xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&
28、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用户密码错误DB13/T30412024表9调用状态信息12DB13/T30412024A
29、A附录A（资料性）统一社会信用代码基础数据接口调用方法示例A.1示例说明以河北省统一社会信用代码基础数据接口为例，设定统一社会信用代码接口地址为：https:/192.168.100.24:8080/dso/HBtydm_sh_service；接口用户的统一社会信用代码为：11xxxxxxxx17053009；机构名称为：xx省（市）标准化研究院；通过接口查询数据的条件是：机构名称中包含“标准”且包含“研究院”的机构；返回结果包体是：json格式；结果数据项包括：统一社会信用代码、机构名称、行政区划代码、机构地址、经营范围、经济行业代码、联系电话、注册日期、业务类型和最后更新日期。A.2示例程
30、序代码本示例以java语言实现，程序代码如下：packagetestjgdm;/包名testjgdmimport.URLEncoder;importjava.util.HashMap;importjava.util.Map;importorg.apache.http.HttpResponse;importorg.apache.http.util.EntityUtils;publicclassjgdm/定义类jgdmpublicstaticvoidmain(Stringargs)/调用统一社会信用代码基础数据接口获取符合条件数据的函数Stringstrkey1=标准;/查询关键字1Strings
31、trkey2=研究院;/查询关键字2trystrkey=URLEncoder.encode(strkey1,utf-8);/将查询关键字转换为utf-8编码strkey2=URLEncoder.encode(strkey2,utf-8);catch(Exceptione1)e1.printStackTrace();Stringhost=https:/192.168.100.24:8080;/接口地址Stringservice_path=/dso/;/接口路径Stringserivce_name=HBtydm_sh_service;/接口名称13DB13/T30412024Stringmetho
32、d=POST;/提交方式Stringappkey=NyyrcP;/许可参数中的appkeyStringappsecret=jttLM7wu;/许可参数中的appsecretStringtydm=11xxxxxxxx17053009;/许可参数中的tyshxydmStringjgmc=xx省（市）标准化研究院;/许可参数中的jgmcStringip=192.168.100.25:8080;/许可参数中的ipStringstartdate=2023-02-01;/许可参数中的startdateStringenddate=2024-01-31;/许可参数中的enddateMapheaders=new
33、HashMap();Mapquerys=newHashMap();/构建许可参数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_
34、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,);/获取反馈的数据包，并
35、在控制窗口中打印出来System.out.println(EntityUtils.toString(response.getEntity();catch(Exceptione)e.printStackTrace();14DB13/T30412024BB附录B（资料性）统一社会信用代码变更数据接口调用方法示例B.1示例说明以河北省统一社会信用代码变更数据接口为例，设定统一社会信用代码接口地址为：https:/192.168.100.24:8080/dso/HBbgkinfo；接口用户的统一社会信用代码为：11xxxxxxxx17053009；机构名称为：xx省（市）标准化研究院；通过接口查询数据
36、的条件是：统一社会信息用代码为11xxxxxxxx17053009的变更信息；返回结果包体是：json格式；结果数据项包括：统一社会信用代码、变更类型、变更前内容、变更后内容和变更日期。B.2示例程序代码本示例以java语言实现，程序代码如下：packagetestjgdm;/包名testjgdmimport.URLEncoder;importjava.util.HashMap;importjava.util.Map;importorg.apache.http.HttpResponse;importorg.apache.http.util.EntityUtils;publicclassjgdm/定义类jgdmpublicstaticvoidmain(String