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

ICS35.020CCSICS35.020CCSA20天 津 市 地 方 标 准DB12/T3041—2024法人和其他组织统一社会信用代码数据共享应用规范SpecificationofdatasharingandapplicationoftheunifiedsocialcreditidentifierSpecificationofdatasharingandapplicationoftheunifiedsocialcreditidentifierforlegalentitiesandotherorganizations2024011820240218天津市市场监督管理委员会发布DB12/T3041DB12/T3041—2024DB12/T3041DB12/T3041—2024目 次前言 II引言 III1范引文件 1语定义 1略语 1据享用架 1络求 4全求 4据用式 4据用用息 12附录A（料）统社会用码础据口调方示例 13附录附录B（料）统社会用码更据口调方示例 15附录C（料）统社会用码东据口调方示例 17参考献 19I前 言本文件按照GB/T1.1-2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件由天津市市场监督管理委员会提出并归口。本文件起草单位：（河北组）河北省标准化研究院。（北京组）北京市市场监督管理局风险管理中心。（天津组）天津市标准化研究院。本文件主要起草人：（河北组）李虓峰、李会、于潇、陈聪、尚晓帆、高思瑶、王子康、董世涛、阎占辉。（（IIII引 言IIIIIIDB12/T3041DB12/T3041—2024DB12/T3041DB12/T3041—2024法人和其他组织统一社会信用代码数据共享应用规范范围本文件适用于政务部门通过数据共享平台以接口方式进行的京津冀统一社会信用代码数据信息共享应用。（GB/T2260中华人民共和国行政区划代码GB/T4754国民经济行业分类GB/T14733.8电信术语电话GB32100法人和其他组织统一社会信用代码编码规则3术语和定义3术语和定义下列术语和定义适用于本文件。3.1请求request接口用户向接口发出的一次调用申请。3.2响应response接口向接口用户返回请求的操作结果。3.3包体package-body数据传输中的实体主体部分。4缩略语下列缩略语适用于本文件：HTTPS：基于安全套接字的超文本传输协议（HypertextTransferProtocolSecure）XML：可扩展标识语言（ExtensibleMarkupLanguage）JSON：JS对象标记（JavaScriptObjectNotation）5数据共享应用框架5.1共享应用模型1概述数据共享概念模型：描述了信息的提供方、使用方及应用方遵循已确定的信息共享规程，进提供方、管理方和应用方通过数据交换行为实现数据共享活动，如图1所示。图1数据共享概念模型按照数据共享业务视角对数据共享角色进行分类，包括提供方、管理方和应用方：遵照管理方批准的规程，提供方、管理方和应用方的数据共享活动通过数据交换行为实现：应用方通过共享平台将查询内容提交给管理方，管理方向应用方提供查询结果，并将查询结果果。围绕需要政务部门间共享的数据给出了数据共享技术架构，如图2所示，架构包括以下内容：2系统系统交换系统目录系统数据数据表达数据质量数据编码数据内容数据数据表达数据质量数据编码数据内容管理数据日常维护数据字典数据内容安全安全技术安全管理网络流程图不通过调用配置数据共享内容不通过调用配置数据共享内容申请审批提出数据配置数据应用方许可信息接收许可信息调用共享数据发送数据共享请求核查不符合数据应用终止符合共享应用结束数据共享平台数据管理方数据应用方数据共享平台数据管理方数据应用方图1数据共享应用流程图1数据共享应用流程5.2.2共享申请、许可和响应3IPIPIP6网络要求数据共享应用网络要求如下：数据共享应用网络要求如下：7安全要求应符合GB/T22239-2019中8的规定要求。8数据应用方式概述统一社会信用代码接口定义见表1。表1统一社会信用代码接口定义4采用HTTPS作为传输协议。接口地址由数据管理方提供，格式为：https://xxx.xxx.xxx.xxx/services_path/service_name。其中，xxx.xxx.xxx.xxx表示接口所在服务器的有效地址；services_path表示接口的发布路径，由数据管理方命名；service_name表示约定的接口名称，由数据管理方命名。BC。5接口分类定义说明统一社会信用代码基础数据接口StringHBtydm_sh_service(stringlicence,stringcond_information,stringrepl_packagetype)HBtydm_sh_serviceBJtydm_sh_serviceTJtydm_sh_servicelicense为许可参数(见8.4.1)；3.cond_information8.4.2)；4.repl_packagetype为返回结果数据包格式参数(见8.4.3)；5.接口返回结果见8.4.4。StringBJtydm_sh_service(stringlicence,stringcond_information,stringrepl_packagetype)StringTJtydm_sh_service(stringlicence,stringcond_information,stringrepl_packagetype)统一社会信用代码变更数据接口StringHBbgkinfo(stringlicence,stringrepl_packagetype)HBbgkinfo变更数据接口名称；BJbgkinfo更数据接口名称；TJbgkinfo更数据接口名称；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_packagetype)HBinvinfo股东数据接口名称；license为许可参数(见8.6.1)；3.repl_packagetype为返回结果数据包格式参数(见8.6.2)；4.接口返回结果见8.6.3。许可参数由一组用户信息组成。许可参数包体标记及含义说明见表2。表2许可参数包体标记及含义信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码——jgmcnvarchar(200)机构名称——appkeynvarchar(8)用户账号——appsecretnvarchar(10)用户密码——ipnvarchar(15)被授权应用接口设备的IP地址——startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期„„„„„„„„包体格式说明包体格式说明JSON…}之间。示例：{"tyshxydm":"xxxxxxxxxxxxxxxx","jgmc":"xxx","appkey":"xxx","appsecret":"xxx","ip":"xxx","startdate":"xxx","enddate":"xxx"}条件参数由条件逻辑关系、条件数据项集、返回结果数据项名称组成，如图4所示。图2条件参数条件参数包体格式说明6条件参数包体采用JSON格式。条件参数放置在标记{"exp":"xxx","fields":[{"field":"xxx","operation":"xxx","value":"xxx"}fiexxx"opertio":"xx""va":"x"rsul":"x"}exp[01n[n-1]（）fieldsfield3；valueresult关键字为返回结果中用户要求的数据项名称，各数据项间以英文“,”分隔。数据项标识应符合本文件8.4.5的规定。表3关系运算符表示及含义关系运算符含义说明=等于<小于>大于<=小于或等于>=大于或等于!=不等于like模糊匹配仅可应用于字符型的数据项，从字符串任意位置进行匹配leftlike左匹配仅可应用于字符型的数据项，从字符串起始端匹配rightlike右匹配仅可应用于字符型的数据项，从字符串尾端匹配isnull空值——isnotnull非空——„„„„„„条件参数包体格式见示例。条件参数包体格式见示例。示例："exp":"[0]*([1]*[2])","fields":[{"field":"zcdzxzqhdm","operation":"=","value":"xxx"},{"field":"jgmc","operation":"like","value":"xxx"}，{"field":"zcdz","operation":"like","value":"xxx"}]7"result":"tyshxydm,jgmc,zcdzxzqhdm"}x或js结果记录数据1„„结果记录数据n结果记录数据1„„结果记录数据n数据项1„数据项n调用状态信息结果数据结果集记录数注：返回结果记录数据过多时，默认显示前50条数据。图3返回结果XMLXML格式采用标准DATAPACKET2.0版本。返回结果中的调用状态和结果集记录数信息放置在标记<RESPDATA>„</RESPDATA>之间,关键字status为调用状态代码，msg为调用状态描述，totalcount为结果集记录个数。调用状态代码和描述应符合第9章的规定。结果数据置于标记<ROWDATA>„</ROWDATA>之间。结果数据不同记录用<ROW…/>„<ROW…/>分隔。数据项标识应符合8.4.5的规定。返回结果包体XML格式见示例。示例：<?xmlversion="1.0"encoding="UTF-8"?><DATAPACKETVersion="2.0"><RESPDATA><RESPstatus="0"msg="调用成功"totalcount="2"/></RESPDATA><ROWDATA><ROWtyshxydm="xxxxxxxxxxxxxxxxxxjgmc="xx（）xxxzcdzxzqhdm="xxxxxx"/><ROWtyshxydm="xxxxxxxxxxxxxxxxxxjgmc="xx（）xxxzcdzxzqhdm="xxxxxx"/></ROWDATA></DATAPACKET>JSON返回结果信息放置在标记{"respdata":{"status":"xxx","msg":"xxx","totalcount":"xxx"},"rowdata":[{xxx},…,{xxx}]}之间。8在respdata标签内，关键字status为调用状态代码，msg为调用状态描述，totalcount为结果集记录个数。调用状态代码和描述应符合本文件9的规定。在rowdata标签内，每条结果数据记录放置在标记{…}之间。数据记录中的数据项标识应符合本文件8.4.5的规定。返回结果包体JSON格式见示例。示例：{"respdata":{"status":"0","msg":"调用成功","totalcount":"2"}，"rowdata":[{"tyshxydm":"xxxxxxxxxxxxxxxxxx","jgmc":"xx省（市）xxx股份有限公司"，"zcdzxzqhdm":"xxxxxx"},{"tyshxydm":"xxxxxxxxxxxxxxxxxx","jgmcxx（区）xxxxxxxxx"}]8.4.5应用服务数据项统一社会信用代码基础数据接口服务提供的数据项见表4。表4统一社会信用代码基础数据接口服务数据项8.4.5应用服务数据项统一社会信用代码基础数据接口服务提供的数据项见表4。表4统一社会信用代码基础数据接口服务数据项表4统一社会信用代码基础数据接口服务数据项（续）9数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合GB32100jgmc机构名称nvarchar(200)——zcdz注册地址nvarchar(400)——zcdzxzqhdm注册地址行政区划代码nvarchar(6)符合GB/T2260jyfw经营范围nvarchar(2000)——clrq成立日期date——djywlx登记业务类型nvarchar(2)0（设立1注销；9：其他jyzt经营状态nvarchar(2)1（存续、在营、开234569数据项标识含义数据类型及长度说明jjhydm经济行业代码nvarchar(6)符合GB/T4754lxdh联系电话nvarchar(18)符合GB/T14733.8zhgxrq最后更新日期date——„„„„„„„„许可参数由一组用户信息组成。许可参数包体标记及含义说明见表5。包体格式说明许可参数包体采用字串格式。许可参数放置在访问地址的参数中。包体格式说明许可参数包体采用字串格式。许可参数放置在访问地址的参数中。示例：https://xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshxydm=xxx参照本文件8.4.3。参照本文件8.4.4。10信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码——jgmcnvarchar(200)机构名称——appkeynvarchar(8)用户账号——appsecretnvarchar(10)用户密码——ipnvarchar(15)被授权应用接口的设备的IP地址——startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期„„„„„„„„统一社会信用代码变更数据接口服务提供的数据项见表6。表6统一社会信用代码变更数据接口服务数据项数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合GB32100bglx变更类型nvarchar(50)——bgq变更前内容nvarchar(255)——bgh变更后内容nvarchar(255)——bgsj变更日期date——„„„„„„„„许可参数由一组用户信息组成。许可参数包体标记及含义说明见表7。表7许可参数包体标记及含义包体格式说明许可参数包体标记及含义说明见表7。表7许可参数包体标记及含义包体格式说明许可参数包体采用字串格式。许可参数放置在访问地址的参数里。示例：https://xxx.xxx.xxx.xxx/services_path/service_name?appkey=xxx&appsecret=xxx&rtype=1&ip=xxx&tyshxydm=xxx8.6.2返回结果数据包格式参数11信息类别标记字符类型及长度含义说明用户信息tyshxydmnvarchar(18)统一社会信用代码——jgmcnvarchar(200)机构名称——appkeynvarchar(8)用户账号——appsecretnvarchar(10)用户密码——ipnvarchar(15)被授权应用接口的设备的IP地址——startdatenvarchar(10)使用期限开始时间授权起始日期enddatenvarchar(10)使用期限结束时间授权终止日期„„„„„„„„参照本文件8.4.3。参照本文件8.4.4。统一社会信用代码股东数据接口服务提供的数据项见表8。表8统一社会信用代码股东数据接口服务数据项数据项标识含义数据类型及长度说明tyshxydm统一社会信用代码nvarchar(18)符合GB32100tzrlx投资者类型nvarchar(2)——tzrxm投资者名称nvarchar(200)——tzzj认缴出资金额numeric(24,8)——tzsj认缴出资日期date——„„„„„„„„调用状态信息包括接口状态代码及接口状态描述，如表9所示。表9调用状态信息12调用状态信息包括接口状态代码及接口状态描述，如表9所示。表9调用状态信息12接口状态代码接口状态描述0调用成功1调用失败-100被授权应用接口设备IP地址错误-130条件参数错误-160返回结果数据包格式参数错误-200数据库错误-300用户账号错误-400用户密码错误„„„„附录A（资料性）统一社会信用代码基础数据接口调用方法示例以河北省统一社会信用代码基础数据接口为例，设定统一社会信用代码接口地址为：https://:800/dHBtym_s_sevic1xxxxxx17030；（本示例以java语言实现，程序代码如下：packagetestjgdm;//包名testjgdmimport.URLEncoder;importjava.util.HashMap;importjava.util.Map;importorg.apache.http.HttpResponse;importorg.apache.http.util.EntityUtils;publicclassjgdm{//定义类jgdmpublicstaticvoidmain(Stringargs)//{Stringstrkey1="标准";//查询关键字1Stringstrkey2="研究院";//查询关键字2try{strkey=URLEncoder.encode(strkey1,"utf-8");utf-8utf-8");}catch(Exceptione1){e1.printStackTrace();}Stringhost="4:8080";//接口地址Stringservice_path="/dso/";//接口路径Stringserivce_name="HBtydm_sh_service";//接口名称Stringmethod="POST";//提交方式Stringappkey="NyyrcP";//许可参数中的appkeyStringappsecret="jttLM7wu";//appsecretStringtydm="11xxxxxxxx17053009";//tyshxydmStringjgmc="xx）";//jgmcStringip="5:8080";//ipStringstartdate="2023-02-01";//startdateStringenddate="2024-01-31";//enddateMapheaders=newHashMap();Mapquerys=newHashMap();13//构建许可参数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{//向接口提交请求HttpResponseresponse=HttpUtils.doPost(host+service_path,serivce_name,method,headers,querys,"");//获取反馈的数据包，并在控制窗口中打印出来System.out.println(EntityUtils.toString(response.getEntity()));}catch(Exceptione){e.printStackTrace();}}}1414附录B（资料性）统一社会信用代码变更数据接口调用方法示例以河北省统一社会信用代码变更数据接口为例，设定统一社会信用代码接口地址为：https://4:8080/dso/HBbgkinfo；接口用户的统一社会信用代码为：11xxxxxxxx17053009；机构名称为：xx省（市）标准化研究院；通过接口查询数据的条件是：统一社会信息用代码为11xxxxxxxx17053009的变更信息；返回结果包体是：json格式；结果数据项包括：统一社会信用代码、变更类型、变更前内容、变更后内容和变更日期。本示例以java语言实现，程序代码如下：packagetestjgdm;//包名testjgdmimport.URLEncoder;importjava.util.HashMap;importjava.util.Map;importorg.apache.http.HttpResponse;importorg.apache.http.util.EntityUtils;publicclassjgdm{//定义类jgdmpublicstaticvoidmain(String[]args)//调用变更数据接口获取符合条件数据的函数{Stringstrkey="xxxxxxxxxxxxxxxxxx";//查询关键字try{strkey=URLEncoder.encode(strkey,"utf-8");//将查询关键字转换为utf-8编码}catch(Exceptione1){e1.printStackTrace();}Stringhost="4:8080";//接口地址Stringservice_path="/dso/";//接口路径Stringserivce_name="HBbgkinfo";//接口名称Stringmethod="POST";//提交方式Stringappkey="NyyrcP";//许可参数中的appkeyStringappsecret="jttLM7wu";//appsecretStringtydm="11xxxxxxxx17053009";//tydmStringjgmc="xx（）";//jgmcStringip="5:8080";//ipStringstartdate="2023-02-01";//startdateStringenddate="2024-01-31";//enddateMapheaders=newHashMap();Mapquerys=newHashMap();//构建许可参数licenceStringurl=host+service_path+serivce_name+"?appkey="+appkey+"&appsecret="+appsecret+"&rtype=1&ip="+ip+"&tyshxydm="+strkey;15try{//向接口提交请求HttpResponseresponse=HttpUtils.doPost(url,"",method,headers,querys,"");//获取反馈的数据包，并在控制窗口中打印出来System.out.println(EntityUtils.toString(response.getEntity()));}catch(Exceptione){e.printStackTrace();}}}1616附录C（资料性）统一社会信用代码股东数据接口调用方法示例以河北省统一社会信用代码股东数据接口为例，设定统一社会信用代码接口地址为：https://4:8080/dso/HBinvinfo；接口用户的机构统一社会信用代码为：11xxxxxxxx17053009；机构名称为：xx省（市）标准化研究院；通过接口查询数据的条件是：统一社会信息用代码为11xxxxxxxx17053009的股东信息；返回结果包体是：json格式；结果数据项包括：统一社会信用代码、投资者类型、投资者名称、认缴出资金额和认缴出资日期。本示例以java语言实现，程序代码如下：packagetestjgdm;//包名