ICS 03.100.01 A 02 DB13 河 北 省 地 方 标 准 DB 13/T 5006—2019 商务诚信信息交换方式及接口规范 Means and interface specifications for businesstrustworthy information exchange 2019 - 07 - 04 发布 河北省市场监督管理局 2019 - 08 - 01 实施 发 布 DB13/T 5006—2019 前 言 本标准按照GB/T 1.1-2009给出的规则起草。 本标准由河北省商务厅提出。 本标准由河北省服务标准化技术委员会(SAHB/TC 264)归口。 本标准起草单位：河北省标准化研究院。 本标准主要起草人：贾迎新、安彦红、路源、冯利君、白雪、魏欢、王宇佩、崔冬立、王旭。 I DB13/T 5006—2019 商务诚信信息交换方式及接口规范 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 主体识别标识 数据提供单位提供商务诚信信息时，需要为每一条信用信息提供信息主体标识。 信息主体标识应优先使用统一社会信用代码、身份证号作为主键。 注：使用组织机构代码、工商登记号、税务登记号作为信息主体标识。 1 DB13/T 5006—2019 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 中①。报送数据起始时间、报送周期可在工作细则中约定。当数据报送交 换结点为端交换结点、数据接收交换结点为中心交换结点时，初次传输应为数据集全量传输， 之后按增量传输； 2 DB13/T 5006—2019 b) c) d) e) 数据传输：数据报送交换结点通过可靠的数据传送服务，将数据传送到数据接收交换结点， 数据传送服务应能支持断点续传，并要求记录传送成功的标志，见图 1 中②； 数据确认：当数据接收交换结点接收到数据报送交换结点传送来的数据时，应该就数据的内 容（见表 1）进行确认，见图 1 中③； 获取反馈：当数据接收交换结点对接收到的数据进行确认后，按照表 1 内容生成对账数据库 表记录，并将记录反馈到数据报送交换结点，见图 1 中④； 对账确认：当数据报送交换结点接收到数据接收交换结点传送来的对账数据库表记录时，应 该就记录内容（见表 1）进行对账确认，如确认无误则数据传输成功，如对账存在出入则数 据传输失败，需要重新传输，见图 1 中⑤。 数据确认 数据传输 3 对账数 据库表 数据 数据 2 2 4 数据生成 数据 数据 5 对账确认 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 DB13/T 5006—2019 用于交换的文件名，由接口类型标识、接入机构名称标识、信息类别标识、信用信息产生部门标 识、数据文件更新时间、数据交换序号六部分组成，各组成部分之间使用“_”连接，文件后缀为“.XML”、 “.TXT”、“.EXCEL”、“.ET”等，如图2所示。 R_XT_200401_E0600_20161205_001.XML 第 6 部分 第 5 部分 第 4 部分 第 3 部分 第 2 部分 第 1 部分 图 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) 建前置库：端交换结点在本地前置机上建立相应的源端前置库表；中心交换结点在本地前置 机上建立对应的目标端前置库表； 4 DB13/T 5006—2019 c) d) e) 数据监控：通过监控前置数据库表中数据变化的机制，完成对端交换结点推送数据的获取， 交换服务抽取前置库增量数据交换到中心前置对应库中，端交换结点通过直接访问或者桥接 方式向前置库推送交换信息； 交换策略：交换数据库方式的交换策略主要是使用资源目录库表发布订阅交换任务，并采用 时间戳方式自动交换数据； 确认机制：当中心交换结点完成了对端交换结点推送数据的获取后，以文件的方式就数据的 内容（信息种类、记录条数、文件大小、传送日期等）向端交换结点进行对账确认，如双方 确认无误则数据库对接传输数据成功，如双方对账存在出入则数据库对接传输数据失败，需 要重新进行数据库对接传输。 5.2.2.2 数据库交换接口 与文件交换方式类似，在端交换结点的前置数据库中，每条数据记录中也都