DB14_T 2541—2022交警罚没收入联网收款系统与代理银行接口规范-（高清正版）.pdf

ICS35.080CCS L7714山西省地方标准DB 14/T 25412022交警罚没收入联网收款系统与代理银行接口规范2022-09-02 发布2022-12-01 实施山西省市场监督管理局发 布DB 14/T 25412022I目次前言.II1范围.12规范性引用文件.13术语和定义.14基本要求.15接口组成.2参考文献.5DB 14/T 25412022II前言本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起草。本文件由山西省财政厅提出、组织实施和监督检查。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省财政标准化技术委员会(SXS/TC48)归口。本文件起草单位：山西省财政科学研究院、山西宝佳质量基础研究院、山西省检验检测中心（山西省标准计量技术研究院）。本文件主要起草人：韩慧彦、李林骏、宋毅、张理哲、梁智腾、刘煜晶。DB 14/T 254120221交警罚没收入联网收款系统与代理银行接口规范1范围本文件规定了交警罚没收入联网收款系统与代理银行接口的术语和定义、基本要求和接口组成。本文件适用于交警罚没收入联网收款系统与代理银行接口的设计、开发和应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本文件。IETF RFC 3629UTF-8,ISO 10646 转换格式（UTF-8,a transformation format of ISO 10646）3术语和定义下列术语和定义适用于本文件。3.1Socket一个通信链的句柄,用于描述 IP 地址和端口，实现不同虚拟机或不同计算机之间的通信。3.2Base64一种基于 64 个可打印 ASCII 字符对任意字节数据进行编码的算法。3.3清分文件代理银行依据已收款并销单的处罚书，按发现地属地原则，将收款数据总结、整理和分类形成的文件。4基本要求4.1接口方式接口采用 Socket 短链接进行交互,报文采用开始标识和结束标识的方法。示例：发送字符串：StartChar|函数名(Base64 的请求包格式串)|endEnd发送文件：StartFile|zip 文件|endEndDB 14/T 2541202224.2数据结构4.2.1基本数据类型接口基本数据类型见表 1。表 1基本数据类型类型名类型名类型描述类型描述类型约束类型约束String文本字符串内容为所有的有效字符List列表类型每一项均为一个子数据项，子数据项编码方式与父数据项编码方式相同Date日期类型日期表示为：yyyymmddFloat浮点数类型内容为浮点数类型字符Int整数类型内容为整型字符File文件流类型内容为对文件的操作定义Boolean布尔类型内容为 True 或 False4.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。DB 14/T 254120223表 2接口列表接口名称接口名称接口描述接口描述下载收款机构信息接口本接口用于代理银行下载收款机构信息参数表上报清分文件接口本接口用于代理银行在日终向交警罚没收入联网收款系统上报已清分数据5.2下载收款机构信息接口5.2.1数据交换格式采用加密字符串传输数据。注：字符串通过 Base64 加解码。5.2.2请求参数下载收款机构信息接口请求参数及说明见表 3。表 3下载收款机构信息接口请求参数及说明参数参数类型类型说明说明cVersionString接收数据格式的版本cBankCodeString代理银行对应交警罚没收入联网收款系统中的编码cTypeString要读取的参数类型。参数值分别为：行政区划代码表、财政机构代码表、票据种类代码表、交警机构代码表、交通违法代码表、代理银行代码表、网点机构代码表、地方非税收入专户代码表示例：StartChar|ReadParameters(cVersion,cBankCode,cType)|endEnd5.2.3返回结果下载收款机构信息接口返回结果及状态说明见表 4。表 4下载收款机构信息接口返回结果及状态说明结果结果状态说明状态说明成功StartFile|1压缩后的文件|endEnd失败StartChar|0失败原因|endEnd失败原因：0 提交数据格式的版本不能为空！0 提交数据端的银行代码不能为空！0 没有指定读取的参数类型！0 指定读取的参数类型错误！0 财政端向后台读取数据失败！DB 14/T 2541202245.3上报清分文件接口5.3.1数据交换格式采用加密文件传输数据。注：文件通过 Base64 加解码。5.3.2请求参数上报清分文件接口请求参数及说明见表 5。表 5上报清分文件接口请求参数及说明参数参数类型类型说明说明BankSendData_yyyymmdd_BankCode_BatchNo.zipzip文件名称命名规则：yyyymmdd 代表年月日 8 位；BankCode 代表银行代码；BatchNo 代表划款批次号(yyyymmdd+3 位序列号，每日从 1 开始)示例：StartFile|BankSendData_yyyymmdd_BankCode_BatchNo.zip|endEnd5.3.3返回结果上报清分文件接口返回结果及状态说明见表 6。表 6上报清分文件接口返回结果及状态说明结果结果状态说明状态说明成功StartChar|1本次数据接收成功！|endEnd失败StartChar|0失败原因|endEnd失败原因：0 提交数据端的银行代码不能为空！0 没有指定划款日期！0 指定的划款日期格式错误，日期格式为 yyyymmdd！0 划款批次号不能为空！0 解压缩文件不成功！0 接收的文件没有找到！0 上报的银行代码错误！0 财政端向后台读取数据失败！0 该划款批次中的划款明细已接收，不能重复！0 划款明细表与划款清单表的合计金额不一致，本次上报无效！0 接收数据保存失败！DB 14/T 254120225参考文献1 GB/T 2260中华人民共和国行政区划代码2 GB/T 22239信息安全技术 网络安全等级保护基本要求3 GB/T 35273信息安全技术 个人信息安全规范