ICS 35.080 CCS L 77 山 14 西 省 地 方 标 准 DB 14/T 2541—2022 交警罚没收入联网收款系统与代理银行 接口规范 2022 - 09 - 02 发布 2022 - 12 - 01 实施 山西省市场监督管理局  发 布 DB 14/T 2541—2022 目 次 前言 .................................................................................. II 1 范围 ................................................................................ 1 2 规范性引用文件 ...................................................................... 1 3 术语和定义 .......................................................................... 1 4 基本要求 ............................................................................ 1 5 接口组成 ............................................................................ 2 参考文献 ............................................................................... 5 I DB 14/T 2541—2022 前 言 本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定 起草。 本文件由山西省财政厅提出、组织实施和监督检查。 本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。 本文件由山西省财政标准化技术委员会(SXS/TC48)归口。 本文件起草单位：山西省财政科学研究院、山西宝佳质量基础研究院、山西省检验检测中心（山西 省标准计量技术研究院）。 本文件主要起草人：韩慧彦、李林骏、宋毅、张理哲、梁智腾、刘煜晶。 II DB 14/T 2541—2022 交警罚没收入联网收款系统与代理银行接口规范 1 范围 本文件规定了交警罚没收入联网收款系统与代理银行接口的术语和定义、基本要求和接口组成。 本文件适用于交警罚没收入联网收款系统与代理银行接口的设计、开发和应用。 2 规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 IETF RFC 3629 UTF-8,ISO 10646 转换格式（UTF-8,a transformation format of ISO 10646） 3 术语和定义 下列术语和定义适用于本文件。 3.1 Socket 一个通信链的句柄,用于描述 IP 地址和端口，实现不同虚拟机或不同计算机之间的通信。 3.2 Base64 一种基于 64 个可打印 ASCII 字符对任意字节数据进行编码的算法。 3.3 清分文件 代理银行依据已收款并销单的处罚书，按发现地属地原则，将收款数据总结、整理和分类形成的文 件。 4 基本要求 4.1 接口方式 接口采用 Socket 短链接进行交互,报文采用开始标识和结束标识的方法。 示例： 发送字符串：[Start]Char|函数名(Base64 的请求包格式串)|end[End] 发送文件：[Start]File|zip 文件|end[End] 1 DB 14/T 2541—2022 4.2 数据结构 4.2.1 基本数据类型 接口基本数据类型见表 1。 表1 类型名 基本数据类型 类型描述 类型约束 String 文本字符串 内容为所有的有效字符 List<> 列表类型 每一项均为一个子数据项，子数据项编码方式与父数据项编码方式相同 Date 日期类型 日期表示为： yyyymmdd Float 浮点数类型 内容为浮点数类型字符 Int 整数类型 内容为整型字符 File 文件流类型 内容为对文件的操作定义 Boolean 布尔类型 内容为 True 或 False 4.2.2 数据编码方式 应符合 IETF RFC 3629 的规定。 4.3 接口调用地址 应向交警罚没收入联网收款系统获取接口调用地址及端口号。 4.4 安全策略 4.4.1 在交警罚没收入联网收款系统与代理银行互联过程中，应采取必要的通信安全措施，采用 TLS.IP 验证、数字签名、用户身份验证等方法。 4.4.2 应采用 Base64 加密解密保证数据在传输过程中的机密性。 4.4.3 宜使用 SHA3、SM3 及以上算法，保证数据在传输过程中的完整性。 4.4.4 验证和授权通过以下两种方式进行： ——确保相互访问的地址是可信任的，相关证书通过数字签名进行验证； ——IP 验证仅为初步验证请求来源的合法性方法。应收集代理银行的 IP，创建代理银行 IP 列表， 在收到请求时，将请求的 IP 与代理银行 IP 列表进行对比，确认请求源的合法性。 4.4.5 交警罚没收入联网收款系统应通过请求频率和请求配额对单一请求方进行限制。 4.4.6 应通过数字签名校验保证数据不被篡改。 5 接口组成 5.1 接口列表 交警罚没收入联网收款系统与代理银行交互应支持的接口见表 2。 2 DB 14/T 2541—2022 表2 接口列表 接口名称 接口描述 下载收款机构信息接口 本接口用于代理银行下载收款机构信息参数表 上报清分文件接口 本接口用于代理银行在日终向交警罚没收入联网收款系统上报已清分数据 5.2 下载收款机构信息接口 5.2.1 数据交换格式 采用加密字符串传输数据。 注：字符串通过 Base64 加解码。 5.2.2 请求参数 下载收款机构信息接口请求参数及说明见表 3。 表3 参数 下载收款机构信息接口请求参数及说明 类型 说明 cVersion String 接收数据格式的版本 cBankCode String 代理银行对应交警罚没收入联网收款系统中的编码 要读取的参数类型。参数值分别为：行政区划代码表、财政机构代码表、票据种类 cType String 代码表、交警机构代码表、交通违法代码表、代理银行代码表、网点机构代码表、 地方非税收入专户代码表 示例： [Start]Char|ReadParameters(cVersion,cBankCode,cType)|end[End] 5.2.3 返回结果 下载收款机构信息接口返回结果及状态说明见表 4。 表4 下载收款机构信息接口返回结果及状态说明 结果 成功 状态说明 [Start]File|1压缩后的文件|end[End] [Start]Char|0失败原因|end[End] 失败原因： 0 提交数据格式的版本不能为空！ 失败 0 提交数据端的银行代码不能为空！ 0 没有指定读取的参数类型！ 0 指定读取的参数类型错误！ 0 财政端向后台读取数据失败！ 3 DB 14/T 2541—2022 5.3 上报清分文件接口 5.3.1 数据交换格式 采用加密文件传输数据。 注：文件通过 Base64 加解码。 5.3.2 请求参数 上报清分文件接口请求参数及说明见表 5。 表5 上报清分文件接口请求参数及说明 参数 类型 说明 文 件 名 称 命 名 规 则 ： yyyymmdd 代 表 年 月 日 8 位 ； BankSendData_yyyymmdd_BankCode_BatchNo.zip zip BankCode 代 表 银 行 代 码 ； BatchNo 代 表 划 款 批 次 号 (yyyymmdd+3 位序列号，每日从 1 开始) 示例： [Start]File|BankSendData_yyyymmdd_BankCode_BatchNo.zip|end[End] 5.3.3 返回结果 上报清分文件接口返回结果及状态说明见表 6。 表6 上报清分文件接口返回结果及状态说明 结果 成功 状态说明 [Start]Char|1本次数据接收成功！|end[End] [Start]Char|0失败原因|end[End] 失败原因： 0 提交数据端的银行代码不能为空！ 0 没有指定划款日期！ 0 指定的划款日期格式错误，日期格式为 yyyymmdd！ 0 划款批次号不能为空！ 失败 0 解压缩文件不成功！ 0 接收的文件没有找到！ 0 上报的银行代码错误！ 0 财政端向后台读取数据失败！ 0 该划款批次中的划款明细已接收，不能重复！ 0 划款明细表与划款清单表的合计金额不一致，本次上报无效！ 0 接收数据保存失败！ 4 DB 14/T 2541—2022 参 考 文 献 [1] GB/T 2260 中华人民共和国行政区划代码 [2] GB/T 22239 信息安全技术 网络安全等级保护基本要求 [3] GB/T 35273 信息安全技术 个人信息安全规范 5