DB13∕T 5006-2019 商务诚信信息交换方式及接口规范(河北省).pdf

ICS 03.100.01 A 02 DB13 河北省地方标准 DB 13/T 50062019 商务诚信信息交换方式及接口规范 Means and interface specifications for businesstrustworthy information exchange 2019 - 07 - 04 发布 2019 - 08 - 01 实施 河北省市场监督管理局 发 布 DB13/T 50062019 I 前 言 本标准按照GB/T 1.1-2009给出的规则起草。 本标准由河北省商务厅提出。 本标准由河北省服务标准化技术委员会(SAHB/TC 264)归口。 本标准起草单位：河北省标准化研究院。 本标准主要起草人：贾迎新、安彦红、路源、冯利君、白雪、魏欢、王宇佩、崔冬立、王旭。 DB13/T 50062019 1 商务诚信信息交换方式及接口规范 1 范围 本标准规定了商务诚信信息交换方式要求、接口定义要求、交换审计和考核要求。 本标准适用于河北商务诚信公共服务平台与各部门、各地方公共、事业单位信用信息交换和共享系统的建设和运维管理。 2 规范性引用文件 下列文件对于本文件的应用是必不可少的。凡是注日期的引用文件，仅注日期的版本适用于本文件。凡是不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。 GB/T 22117 信用 基本术语 DB13/T 2509 公共信用信息资源目录编码规范 DB13/T 5005 商务诚信信息分类与编码 3 术语和定义 GB/T 22117中界定的术语和定义适用于本文件。 4 交换方式及要求 4.1 交换方式 交换方式包括以下三种： a) 文件交换方式：通过可靠文件传送服务，进行数据文件的传送。本标准约定的文件有 XML 文件、EXCEL 文件、TXT 文件、ET 文件。适用于大量数据记录传送。要求数据提供结点给出文件格式及数据资源描述； b) 数据库对接方式：库到库的数据交换，各端交换结点将交换信息放入交换前置库中，中心交换结点根据端结点提供建表脚本，建立同等结构的表，利用传送服务实现库到库的交换。要求端结点给出数据库服务 IP、数据库实例名、用户名、密码、建库脚本； c) 服务调用方式：通过 WebService 服务接口访问、传送信用信息目录、数据记录。适用于实时少量数据访问传送。 4.2 通用要求 4.2.1 主体识别标识 数据提供单位提供商务诚信信息时，需要为每一条信用信息提供信息主体标识。 信息主体标识应优先使用统一社会信用代码、身份证号作为主键。 注：使用组织机构代码、工商登记号、税务登记号作为信息主体标识。 DB13/T 50062019 2 4.2.2 交换记录项 无论是采用文件方式和数据库方式，每条数据记录在交换时需要增加设置记录ID(GUID)、记录入库时间、记录出库时间这三个用于交换的数据项。其中，记录ID为数据记录指纹，应由数据生成单位赋值，采用GUID机制，以标识记录的全局唯一性。 对于文件方式，记录入库时间指数据被传送到端交换结点的时间，记录出库时间指数据被传送到中心交换结点的时间；对于数据库方式，记录入库时间指数据转移到交换前置库的时间，记录出库时间指记录被提取出前置交换库的时间。 4.2.3 交换数据 在数据交换中，汉字使用中文半角，英文字母、数字和符号使用英文半角。除正式交换数据外，不要在任何其他位置输入其他文字。交换数据应采用UTF-8编码格式。 5 交换接口及要求 5.1 交换接口 商务诚信信息交换接口分为以下三类： a) 数据传送类：河北商务诚信公共服务平台从各地方信用信息平台、各部门信用信息系统、各公共事业单位信用信息平台、商业协会、商务主体交易平台采集、汇聚信用信息数据； b) 数据共享类：河北省各地方信用信息平台、各部门信用信息系统、各公共事业单位信用信息平台、商业协会、商务主体交易平台共享、检索河北省商务诚信公共服务平台或其他地方信用信息平台、其他部门信用信息系统、其他公共事业单位信用信息平台中的信用信息数据； c) 信息目录及元数据类：河北省各地方信用信息平台、各部门信用信息系统、各公共事业单位信用信息平台构建各自的信用信息目录及其元数据，商业协会信用信息目录及其元数据、商务主体交易信用信息目录及其元数据，供其他相关各方通过目录及其元数据来发现和检索所需要的信用信息。 5.2 交换接口要求 5.2.1 文件方式接口要求 5.2.1.1 文件交换格式 对于结构化数据，本标准约定支持四种文件交换格式，分别为XML格式、EXCEL格式、TXT格式、ET格式；对于非结构化数据，无交换格式限制，采用常用格式即可；对于压缩文件，宜采用ZIP或RAR交换格式。 注:具体数据项及数据项顺序，见DB13/T 5004-2019商务诚信基础数据元目录。 5.2.1.2 文件交换机制 数据报送交换结点向数据接收交换结点报送数据主要流程包括（如图1所示）： a) 数据生成：根据约定的报送周期，数据报送交换结点按本标准要求，将报送信息生成需要传送的数据，见图 1 中。报送数据起始时间、报送周期可在工作细则中约定。当数据报送交换结点为端交换结点、 数据接收交换结点为中心交换结点时， 初次传输应为数据集全量传输，之后按增量传输； DB13/T 50062019 3 b) 数据传输：数据报送交换结点通过可靠的数据传送服务，将数据传送到数据接收交换结点，数据传送服务应能支持断点续传，并要求记录传送成功的标志，见图 1 中； c) 数据确认：当数据接收交换结点接收到数据报送交换结点传送来的数据时，应该就数据的内容（见表 1）进行确认，见图 1 中； d) 获取反馈：当数据接收交换结点对接收到的数据进行确认后，按照表 1 内容生成对账数据库表记录，并将记录反馈到数据报送交换结点，见图 1 中； e) 对账确认：当数据报送交换结点接收到数据接收交换结点传送来的对账数据库表记录时，应该就记录内容（见表 1）进行对账确认，如确认无误则数据传输成功，如对账存在出入则数据传输失败，需要重新传输，见图 1 中。 图 1 端交换结点报送数据交换机制 表1 反馈数据库表 字段名称 数据类型 中文注释 说明 FILE_NAME VARCHAR(64) 交换文件名称 仅用于文件交换方式 REV_TIME DATETIME 接收时间 FILE_SIZE NUMBER（32） 交换文件大小 FILE_NUM NUMBER(16) 交换文件数量 FILE_TYPE VARCHAR(32) 交换文件格式 TABLE_NAME VARCHAR(32) 数据库表名称 仅用于数据库对接方式 INSERT_TIME DATETIME 入库时间 DATA_SUM NUMBER(16) 入库记录数量 SOURCE VARCHAR(16) 交换数据来源 文件交换方式和数据库对接方式复用 FEEDBACK_TIME DATETIME 时间戳 5.2.1.3 文件命名规范 数据确认 获取反馈 数据生成 3 数据传输 2 2 数据 数据 数据 数据 1 对账确认 5 对账数 据库表 4 DB13/T 50062019 4 用于交换的文件名，由接口类型标识、接入机构名称标识、信息类别标识、信用信息产生部门标识、 数据文件更新时间、 数据交换序号六部分组成， 各组成部分之间使用 “_” 连接， 文件后缀为 “.XML” 、“.TXT”、“.EXCEL”、“.ET”等，如图2所示。 图 2 交换数据文件名结构图 交换数据文件名结构图说明如下： a) 第 1 部分：接口类型标识由 1 位大写英文字母表示，“R”代表传送数据接口，“S”代表共享数据接口，“M”代表信用信息目录及元数据接口，可扩展； b) 第 2 部分：交换结点行政区划标识由 2 位或 3 位市（县、区）汉语拼音大写首字母缩写表示，“XT”代表邢台市商务诚信公共服务平台； c) 第 3 部分：信息类别标识由 6 位数字表示，“200401”代表法人和其他组织司法信息的司法判决信息，见 DB13/T 5005-2019商务诚信信息分类与编码； d) 第 4 部分：信息产生部门标识由 1 位大写英文字母和 4 位数字表示， “E2400”代表河北省商务厅，见 DB13/T 2509； e) 第 5 部分：数据文件生成日期由 8 位数字表示，格式为“yyyymmdd”； f) 第 6 部分： 数据文件交换序号由 3 位数字表示， 由数据提供方生成， 为十进制表示的小于 999的数字，起始值为 001，防止一次交换数据量过大，可由多个文件分卷传输。 5.2.1.4 文件打包规范 当交换文件包含有多个XML、EXCEL、TXT或ET文件时，可以对交换文件进行打包处理，每个压缩文件大小不应超过1G，可由多个压缩文件构成（压缩文件卷号由3位数字表示，由数据提供方生成，为十进制表示的小于999的数字，起始值为001）。 压缩文件的命名为“文件名”+“_卷号”+“.ZIP/RAR”。 5.2.2 数据库对接交换接口要求 5.2.2.1 数据库对接机制 数据库对接包括以下机制： a) 表资源发布：端交换结点将需要交换的数据库表注册为表资源，并将此表资源进行发布；中心交换结点对数据端交换结点表资源进行资源订阅； b) 建前置库：端交换结点在本地前置机上建立相应的源端前置库表；中心交换结点在本地前置机上建立对应的目标端前置库表； R_XT_200401_E0600_20161205_001.XML 第 6 部分 第 5 部分 第 4 部分 第 3 部分 第 2 部分 第 1 部分 DB13/T 50062019 5 c) 数据监控：通过监控前置数据库表中数据变化的机制，完成对端交换结点推送数据的获取，交换服务抽取前置库增量数据交换到中心前置对应库中，端交换结点通过直接访问或者桥接方式向前置库推送交换信息； d) 交换策略：交换数据库方式的交换策略主要是使用资源目录库表发布订阅交换任务，并采用时间戳方式自动交换数据； e) 确认机制：当中心交换结点完成了对端交换结点推送数据的获取后，以文件的方式就数据的内容（信息种类、记录条数、文件大小、传送日期等）向端交换结点进行对账确认，如双方确认无误则数据库对接传输数据成功，如双方对账存在出入则数据库对接传输数据失败，需要重新进行数据库对接传输。 5.2.2.2 数据库交换接口 与文件交换方式类似，在端交换结点的前置数据库中，每条数据记录中也都需要设置记录ID(GUID)、记录入库时间、记录出库时间这三个用于交换的数据项。数据库对接交换方式中，记录入库时间指记录转移到前置库的时间， 由前置库提供； 记录出库时间指记录被提取出前置交换库的时间，由前置库提供。 端交换结点需提供前置数据库配置参数：数据库IP地址、数据库实例名、端口、数据库版本、数据库字符集、对接用户名、对接密码。 5.2.3 服务方式交换接口要求 5.2.3.1 服务调用机制 服务方式实现数据交换，主要是指WebService交换方式。以WebService方式进行发布，采用HTTP通讯协议进行同步通讯，实现数据交换。 5.2.3.2 服务交换接口 服务交换接口包括以下两种方式： a) 报文规范：报文为报文头和报文体两部分；从交互方式，报文分为请求报文和响应报文两类，即输入和输出。 报文以 XML 标签形式封装， 数据对象及字段英文名即为 XML 报文中的标签名； b) 报文约定：各字段若无特别说明均为 char 型；日期字段默认格式为“yyyymmdd”，例如2013-04-15，报文内容为 20130415；时间字段默认格式为“hhmmss”，例如 16:25:26，报文内容为 162526；返回包报文头流水号，与请求包报文头流水号保持一致；报文头信息具有默认结构，允许自定义报文头。在具体实现时，WebService 传递的数据可参照 XML 数据交换格式。 6 交换审计和考核 交换审计是保证商务诚信信息交换过程的安全、质量和时效。主要包括交换接入审计、信息溯源审计、信息异议审计。 交换考核是各交换结点通过传输服务管理机制，进行交换考核，包括交换信息统计以及数据质量考核，并完成工作统计报告和自查报告。统计考核项目包括：每周期更新信息分类统计、错误信息分类统计、重复报送信息率。 DB13/T 50062019 6 参 考 文 献 1 政务信息资源共享管理暂行办法. 2 国务院办公厅关于运用大数据加强对市场主体服务和监管的若干意见 （国办发 2015 51号） . 3 国务院关于批转发展改革委等部门法人和其他组织统一社会信用代码制度建设总体方案的通知（国发201533号）. 4 社会信用体系建设规划纲要（2014-2020年）. 5 GB/T 21062.1-2007 政务信息资源交换体系 第1部分：总体框架 6 GB/T 21062.2-2007 政务信息资源交换体系 第2部分：分布式应用间信息交换技术要求 7 GB/T 21062.3-2007 政务信息资源交换体系 第3部分：异构数据库接口规范 8 GB/T 21062.4-2007 政务信息资源交换体系 第4部分：技术管理要求 9 GB/T 26819-2011 信用主体标识规范 10 GB/T 22118 企业信用信息采集、处理和提供规范 11 GB/T 22120 企业信用数据项规范 _