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

ICS35.08014CCSL7714山 西 省 地 方 标 准DB14/T2541—2022交警罚没收入联网收款系统与代理银行接口规范20222022090220221201山西省市场监督管理局  发布DB14/T2541DB14/T2541—2022DB14/T2541DB14/T2541—2022目 次前言 II范围 1规范性引用文件 1术语和定义 1基本要求 1接口组成 2参考文献 5II前 言本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定起草。本文件由山西省财政厅提出、组织实施和监督检查。本文件由山西省市场监督管理局对标准的组织实施情况进行监督检查。本文件由山西省财政标准化技术委员会(SXS/TC48)归口。（山西省标准计量技术研究院）。本文件主要起草人：韩慧彦、李林骏、宋毅、张理哲、梁智腾、刘煜晶。IIII交警罚没收入联网收款系统与代理银行接口规范范围本文件规定了交警罚没收入联网收款系统与代理银行接口的术语和定义、基本要求和接口组成。本文件适用于交警罚没收入联网收款系统与代理银行接口的设计、开发和应用。规范性引用文件（包括所有的修改单适用于本文件。IETFRFC3629UTF-8,ISO10646（UTF-8,atransformationformatofISO10646）术语和定义下列术语和定义适用于本文件。SocketIPSocketIP3.2Base6464ASCII3.3清分文件件。4基本要求4.1接口方式Socket示例：1发送字符串：[Start]Char|函数名(Base64的请求包格式串)|end[End]发送文件：[Start]File|zip文件|end[End]发送字符串：[Start]Char|函数名(Base64的请求包格式串)|end[End]发送文件：[Start]File|zip文件|end[End]数据结构基本数据类型接口基本数据类型见表1。表1基本数据类型类型名类型描述类型约束String文本字符串内容为所有的有效字符List<>列表类型每一项均为一个子数据项，子数据项编码方式与父数据项编码方式相同Date日期类型日期表示为：yyyymmddFloat浮点数类型内容为浮点数类型字符Int整数类型内容为整型字符File文件流类型内容为对文件的操作定义Boolean布尔类型内容为True或False数据编码方式应符合IETFRFC3629的规定。接口调用地址应向交警罚没收入联网收款系统获取接口调用地址及端口号。安全策略在交警罚没收入联网收款系统与代理银行互联过程中，应采取必要的通信安全措施，采用TLS.IPBase64SHA3、SM3验证和授权通过以下两种方式进行：——确保相互访问的地址是可信任的，相关证书通过数字签名进行验证；——IPIPIPIPIP交警罚没收入联网收款系统应通过请求频率和请求配额对单一请求方进行限制。应通过数字签名校验保证数据不被篡改。接口组成接口列表交警罚没收入联网收款系统与代理银行交互应支持的接口见表2。2示例：示例：5.2.3返回结果下载收款机构信息接口返回结果及状态说明见表4。表4下载收款机构信息接口返回结果及状态说明3表2接口列表接口名称接口描述下载收款机构信息接口本接口用于代理银行下载收款机构信息参数表上报清分文件接口本接口用于代理银行在日终向交警罚没收入联网收款系统上报已清分数据下载收款机构信息接口数据交换格式采用加密字符串传输数据。注：字符串通过Base64加解码。请求参数下载收款机构信息接口请求参数及说明见表3。表3下载收款机构信息接口请求参数及说明参数类型说明cVersionString接收数据格式的版本cBankCodeString代理银行对应交警罚没收入联网收款系统中的编码cTypeString要读取的参数类型。参数值分别为：行政区划代码表、财政机构代码表、票据种类代码表、交警机构代码表、交通违法代码表、代理银行代码表、网点机构代码表、地方非税收入专户代码表[Start]Char|ReadParameters(cVersion,cBankCode,cType)|end[End][Start]Char|ReadParameters(cVersion,cBankCode,cType)|end[End]结果状态说明成功[Start]File|1压缩后的文件|end[End]失败[Start]Char|0失败原因|end[End]失败原因：0提交数据格式的版本不能为空！0提交数据端的银行代码不能为空！000财政端向后台读取数据失败！上报清分文件接口数据交换格式采用加密文件传输数据。注：文件通过Base64加解码。请求参数上报清分文件接口请求参数及说明见表5。表5上报清分文件接口请求参数及说明参数类型说明BankSendData_yyyymmdd_BankCode_BatchNo.zipzip文件名称命名规则：yyyymmdd代表年月日8位；BankCode代表银行代码；BatchNo代表划款批次号(yyyymmdd+3位序列号，每日从1开始)[Start]File|BankSendData_yyyymmdd_BankCode_BatchNo.zip|end[End]示例：[Start]File|BankSendData_yyyymmdd_BankCode_BatchNo.zip|end[End]上报清分文件接口返回结果及状态说明见表6。表6上报清分文件接口返回结果及状态说明4返回结果上报清分文件接口返回结果及状态说明见表6。表6上报清分文件接口返回结果及状态说明4结果状态说明成功[Start]Char|1本次数据接收成功！|end[End]失败[Start]Char|0失败原因|end[End]失败原因：0提交数据端的银行代码不能为空！0没有指定划款日期！0指定的划款日期格式错误，日期格式为yyyymmdd！0划款批次号不能为空！0解压缩文件不成功！000财政端向后台读取数据失败！0该划款批次中的划款明细已接收