非税收入银行实时服务器方案和接口标准applus

财银数据交换方案与接口标准北京用友政务软件有限公司非税收入银行实时数据交换服务器方案和接口标准第 2 页 共 33 页1 业务内容 41.1 数据实体 41.2 业务处理 4（1）输入模式 5（2）输出模式 52 数据处理过程 52.1 系统设置 52.2 正常业务处理过程 52.2.1 输入模式（输入输出模式代码为 I）： 52.2.2 输出模式（输入输出模式代码为 O）： .62.3 异常操作 72.3.1 超时 .72.3.2 红冲 .72.2 基础数据同步 73 网络连接 84 缴款数据格式 84.1 package.94.1.1 io-mode .94.1.2 process-code94.1.3 process-result 94.1.4 fiscal-code .104.1.5 bank-code104.1.6 bank-node104.1.7 operator-code 104.2 bill 104.2.1 co-code104.2.2 co-name.114.2.3 contributors .114.2.4 receiver114.2.5 item114.2.6 notify-date .124.2.7 latest-date 124.2.8 delinquency .124.2.9 bill-check-result 134.2.10 total-amount 134.2.11 remark .135基础数据格式 135.1 package.145.2 process-result .145.3 billtypeinfo.155.4 coinfo .155.5 chargeitem155.5.1 Item .15非税收入银行实时数据交换服务器方案和接口标准第 3 页 共 33 页5.6 billofco .155.6.1 billno .156 交互过程 .166.1 正常缴款交互过程图： 166.1.1 验证请求 166.1.2 验证完成 176.1.3 缴款确认请求 196.1.4 确认完成 206.2 冲红交互过程图： 226.2.1 验证请求 226.2.2 验证完成 226.2.3 冲红确认请求 236.2.4 冲红确认完成 246.3 基础数据同步 .256.3.1 请求数据同步 256.3.2 返回基础数据 xml 数据 257. http 协议格式（仅供参考） .267.1 业务数据交换 277.1.1 http 请求 .277.1.2 http 响应 .277.2 基础数据交换 .277.2.1 http 请求 .277.2.2 http 响应 .288 备注 .28财政为银行提供内容： 28非税收入银行实时数据交换服务器方案和接口标准第 4 页 共 33 页非税收入银行实时服务器方案和接口标准为加强财政预算外资金管理力度，财政对预算外资金和部分政府性基金实行“票款分离” ，其中，银行受财政委托担负收费开票的工作。为配合财政实行“票款分离”措施，银行与财政需要进行联网，保证财政实时传递/交换银行收费信息。通过对多种联网方案的研究，最后确定银行与财政联网方式：线路采用 DDN 或光纤（点对点） ，信息通过双方中间层服务器通过 HTTP+XML 方式交换数据；数据采用 xml格式；数据编码方式 gb2312。1 业务内容“票款分离”措施的主要特点是：“部门执行、银行收款、财政统管” 。 “部门执行”是指由各行政事业单位执行收费职能，原则上不经手钱款，只开具“一般缴款书” ；“银行收费”是指银行受财政部门委托收取资金，同时在一般缴款书上加盖收讫章；“财政统管”是指资金统一划入财政专户，由财政统一核算和管理。1.1 数据实体一般缴款书是银行收费的原始依据，由单位开具，并由缴款人交至银行。其格式（简式）如下：非税收入一般缴款书执收单位： 年 月 日 缴款书号码： 缴款人 收款人账号 账号开户银行 开户银行金额人民币（大写）： 小写：执行码 收费项目名称 项目代码及票据种类 计量单位 计费数量 计费标准 金额录入人： 审核人： 作废人： 校验码：1.2 业务处理根据银行当前选择的数据交换模式不同，银行对此业务处理过程如下：非税收入银行实时数据交换服务器方案和接口标准第 5 页 共 33 页（1）输入模式 输入模式指缴款书明细信息由银行详细输入，然后向财政进行验证和传送的模式。银行处理以一般缴款书为输入原始单据，输入内容：缴款书号、单位编码、缴款方式、缴款人（汉字） 、项目代码、单位、数量、金额等。其中：项目代码、单位、数量、金额为明细栏，最多有 5 行。（2）输出模式输出模式指缴款书详细信息已经由执收单位输入财政，银行处理以一般缴款书为输入原始单据，输入缴款书号码，从财政验证并调用输出的模式。2 数据处理过程2.1 系统设置在开始正常的业务前，建议银行端进行系统设置，用于设置本财政部门的标识代码和相关业务数据。具体如下：（1）财政局代码：默认为 4,由财政部门统一设定（区分不同财政地址） ；（2）票据版本号：同类票据可能有不同的版本号。默认为本年度票据版本号。本年度具体使用的票据版本号由财政设置。（3）票据类型：默认值为一般缴款通知书。（4）财政实时服务器地址和端口号；以上字段的内容由财政提供。建议银行端对以上内容可进行设置，以满足内容变化。2.2 正常业务处理过程2.2.1 输入模式（输入输出模式代码为 I）：1、 银行端输入一般缴款书输入内容包括：（1）缴款书号码：前几位为“0”时必须输入，如：“00001000”输入“00001000” ；（2）单位编码：前几位为“0”也要求输入，如“00101”输入“00101” ；（3）财政专户帐号：前几位为“0”也要求输入，如“00101”输入“00101” ；（4）缴款人：最长 15 个汉字，30 字节；以下为项目明细栏，最多 5 行（5）项目代码：指各执收单位的执行码，前几位为“0”也要求输入；（6）计费数量；（7）金额：12 个数字（如有角、分，带小数点） 。非税收入银行实时数据交换服务器方案和接口标准第 6 页 共 33 页（8）开票日期：一般缴款书填写的缴款日期。输入完成，组装成为 xml 数据包（处理码为 1） （见数据接口）发送录入内容，银行终端禁止修改，等待财政验证信息返回。在规定时间内未有应答，进入错误处理；发送信息除输入内容外，银行网点号、操作员号等信息，项目明细栏最多 5 行，按实际行数打包。2、财政端验证财政端接收到银行录入内容，开始验证数据：核对财政帐号、单位编码、项目编码等是否正确，金额是否合理。验证完成，修改 xml 数据包内容（加入校验信息）向银行发送（处理码为 6） 。3、 银行端接收到验证信息如“不正确” ，则提示错误内容，进入修改状态，返回到操作 1；如“正确” ，操作员检查返回内容是否与缴款书相同，不同返回到操作 1，进入修改状态。如内容相同，银行端请求一次连接，发送“完成请求” （处理码为 2） ；4、 财政端接收完成信息，保存成功，发出返回信息（处理码为 7） 。5、 银行端接收到返回信息,确认完成一笔业务；关闭连接。2.2.2 输出模式（输入输出模式代码为 O）：1、 银行端输入一般缴款书的票据类型，票据版本号和缴款书号码所录入内容的长度不能超过财政部门设定的代码长度：（1） 缴款书号码：前几位为“0”时必须输入，如：“00001000”不能输入“1000” 。输入完成，发送录入内容（处理码为 1） ，银行终端禁止修改，等待财政验证信息返回。在规定时间内未有应答，进入错误处理；（注：银行端可以根据 http 协议包内容判断是否是网络问题或者财政端服务问题）发送信息除输入内容外，另加包长、财政局代码、处理码等信息；数据格式详见数据接口。2、 财政端验证财政端接收到银行录入内容(处理码为 1)，开始验证数据：核对该缴款书号码对应的收费信息是否存在。验证完成，组合 xml 数据包，向银行发送 （处理码为 6） ，包括验证信息和缴款书收费明细信息；数据格式详见数据接口。3、 银行端接收到验证信息（处理码为 6）如“缴款书号不存在” ，则提示错误，银行操作员对缴款书号确认修改，返回到操作1，或终止操作；如“正确” ，操作员检查返回内容是否与缴款书相同，不同则终止操作。如内容相同则按照返回信息收款，在缴款书上加盖收讫章，发送“缴款确认请求” （处理码为 2） ；4、 财政端接收完成信息（处理码为 2） ，保存后，发出确认返回信息（处理码为 7） 。5、 银行端接收到返回信息,如果处理码为 7，表示完成一笔业务，保存数据，并关闭连接。如果财政端保存失败，银行端可以再次发送“缴款确认请求” 。以上描述包括其业务流程。财政与银行间的数据交互过程实际上分为三个独立的过程： 非税收入银行实时数据交换服务器方案和接口标准第 7 页 共 33 页1.验证请求过程；2.缴款完成请求过程；3.冲红过程；也就是说并不一定是一个完整的会话，所以票据信息在前两个过程中必须传递完整的业务数据。注：银行必须先验证票据然后再进行缴款确认。2.3 异常操作2.3.1 超时每一端发送信息完成，在 20 秒内没有得到应答，进入异常处理，视为一笔业务失败，双方断开连接。此参数要求可以设置（1060 秒）2.3.2 红冲1、只允许对当日未记帐的缴款信息进行冲红。2、采用与输出模式相似的处理方式，当银行需要冲红时，输入要冲红的票据号，提交请求到财政服务器，在财政端必须进行如下验证：（1）银行的请求红冲的信息是否为当日信息，如果不是则返回“非当日信息，不允许红冲”；（2）验证当前的银行和操作员是否与要红冲的缴款信息一致,如不一致则不允许执行红冲的操作;（3）再检查此张单据财政是否已经生成记帐凭证，如果已经生成凭证，则返回单据已财政记帐，不能冲红信息 ，不允许冲红此张单据；（4） 检查要红冲的票据的缴款信息状态是否未收款，如果未收款，则不允许进行红冲的操作。（5） 检查要红冲的票据的缴款信息是否在财政系统中审核过，如果已经被审核，则不允许进行红冲的操作。验证请求成功则返回此票据的具体信息。3、银行柜台操作员确认返回的票据信息为要红冲的票据，向财政服务器提交冲红请求。4、财政端接到冲红信息后，根据是否是执收单位开具的票据来执行相应的操作，如果是执收单位开具的票据，则不删除开票信息，只是更新票据的状态为未收款，如果是银行代收的票据，则删除开票信息，然后将红冲的票据信息记录在数据库中,以便以后查询。非税收入银行实时数据交换服务器方案和接口标准第 8 页 共 33 页2.2 基础数据同步基础信息包括：1、 单位与收费项目对应信息单位与收费项目对应信息包括：单位代码、单位名称，与单位对应的收费项目代码、收费项目名称、收费项目对应的资金形式以及与此收费项目对应的预算科目和预算科目名称。利用上述信息，银行可以在柜台端验证单位信息、收费项目信息并验证他们之间的对应关系。2、 单位的票据号码信息单位的票据号码信息包括：单位代码、票据类型、票据版本、票据号码。其中票据号码信息可能是若干连续的号码段。3、 票据类型信息当前有效的票据类型信息包括：票据类型代码、票据类型名称、票据版本代码、票据版本名称基础数据采用银行定期向财政服务器端定期发送请求，然后财政端返回基础数据的xml 格式数据，由银行端对返回的 xml 数据进行解析，更新银行端的基础数据。(注：单位的票据号码信息验证可能出现的问题，如果执收单位在财政领取了票据，财政系统中已经做了登记，并在银行未和财政同步数据时使用时，会出现银行端验证通不过，但是在财政系统中其实已经有此信息的情况)3 网络连接1、银行内部终端，连接到银行实时服务器，由银行实时服务器收发包；2、银行与财政之间，由银行实时服务器和财政应用服务器之间通过路由器连接，由银行实时服务器向财政实时服务器发送 http 请求。3、财政端由财政应用服务器与数据库服务器连接。4 缴款数据格式银行与财政之间，以 xml 格式交换数据。银行端向财政发送 http 请求，财政端根据 处理码和 输入输出模式 判断处理并返回相应的数据；银行端再根据财政端返回的数据执行相应的操作。下面这个例子是在输入模式下银行发送的内容：I1非税收入银行实时数据交换服务器方案和接口标准第 9 页 共 33 页04gs3021100100100110102006-11-162006-11-2150035000.50暂存款备注信息 04.1 package这个节点有一个可选属性 version，表示协议的版本号。4.1.1 io-mode输入输出模式。其内容为：I 表示输入（INPUT）模式；O 表示输出（OUTPUT）模式;C表示当日红冲操作（CANCEL）.4.1.2 process-code处理码。表示本次请求要做何种操作。银行端和财政端接均根据处理码和输入输出模式判Comment U1: 银行代码为财政系统里面维护银行标示，需财政通知银行此代码的值非税收入银行实时数据交换服务器方案和接口标准第 10页 共 33页断执行什么操作并返回相应结果。有以下几种处理码内容：1-表示验证请求； 6-表示财政验证完成； 2-表示确认缴款请求；7-表示财政完成确认缴款；21-表示红冲验证请求；26- 表示财政红冲验证完成； 24-表示红冲确认请求；29-表示财政红冲确认完成4.1.3 process-result处理结果，表示财政对银行请求的处理结果或者协议数据格式的正确性。由财政端返回。内容：0 表示财政端处理成功；1 表示财政端出现异常或者处理失败；2 表示输入输出模式代码无效；3 表示处理码无效。4.1.4 fiscal-code财政局代码。默认值为 4。代理行为多个财政局服务时，用以区分不同的财政局。4.1.5 bank-code银行代码。用于区分不同的代理银行。 （最大长度为 30字节）如果存在此节点，则会检查票据上账号和银行代码的关系，如果不一致，则业务校验不会通过，校验结果为 102，标示缴款书是其他代理银行才可以收费的票据，如果没有此节点则不做校验。 （建议：最好发送此信息，防止票据缴错。 ）4.1.6 bank-node银行网点代码。（最大长度为 30字节）4.1.7 operator-code银行操作员代码。4.2 bill票据信息，财银间每次交换的数据必须包含且仅包含一个票据信息。001001非税收入银行实时数据交换服务器方案和接口标准第 11 页 共 33 页(1)type：票据类型编码。默认为非税收入一般缴款书；（最大长度为 30 字节）(2)bill-version：票据版本号码。默认本年度所使用票据的版本号码；（最大长度为 30 字节）(2) bill-no：票据号码；（最大长度为 30 字节）4.2.1 co-code执收单位代码。银行必须输入。 （最大长度为 30 字节）4.2.2 co-name执收单位名称。由财政返回。 （最大长度为 60 字节）4.2.3 contributors缴款人信息。（1）name：缴款人名称；必须。输入模式，由银行输入；输出模式，由财政返回。 （最大长度为 60 字节）（2）account：缴款人帐号；输入模式，由银行输入；输出模式，由财政返回。 （最大长度为 30 字节）（3）bank：缴款人开户行；输入模式，由银行输入；输出模式，由财政返回。 （最大长度为 60 字节）4.2.4 receiver收款人信息。（1）name：收款人名称；输入模式，由银行输入；输出模式，由财政返回。 （最大长度为60 字节）（2）account：收款人帐号；输入模式，由银行输入；输出模式，由财政返回。 （最大长度非税收入银行实时数据交换服务器方案和接口标准第 12 页 共 33 页为 30 字节）（3）bank：收款人开户行；输入模式，由银行输入；输出模式，由财政返回。 （最大长度为 30 字节）4.2.5 item收费项目信息。一般每张票据的收费项目不超过 5 个。 （注：在长春市财政局具体业务中，要求每张缴款通知书只录入一条收费项目）0校验结果（1）code：收费项目代码，输入模式下，银行端必须输入收费项目代码。 （最大长度为 30字节）（2）name：收费项目名称；财政服务端校验票据后，返回收费项目名称，以便银行操作员核对收费项目。 （最大长度为 60 字节）（3）units ：计量单位。收费项目的计量单位，比如“本 ”“个”等等。 （最大长度为 30 字节）（4）count：数量。大于 0 整数；输入模式下，银行端输入。（5）standard：可选项；收费标准。由财政端返回，（6）amount ：收费金额。注：在输出模式下，银行发送“验证请求”时可以不包含 item 信息。 management-forms 资金管理形式。0 表示预算内，1 表示预算外。 item-check-result收费项目校验结果。其内容由财政端校验后返回。值：0正确，1编码错，2金额错非税收入银行实时数据交换服务器方案和接口标准第 13 页 共 33 页4.2.6 notify-date通知日期，即开票日期。输入模式下，银行输入。日期格式：yyyy-MM-dd4.2.7 latest-date可选项；最后缴款日期。当财政启动滞纳金管理时使用。日期格式：yyyy-MM-dd4.2.8 delinquency可选项。滞纳金信息。当财政启动滞纳金管理时使用。（1）ratio ：滞纳金比例。 （最大长度为 3 字节）（2）overdays：逾期天数。4.2.9 bill-check-result票据校验结果。表明票据是否有效，是否属于该执收单位，或者系统出错等信息。内容：0正确，1缴款书号错误（票据类型，票据版本，票据号码），2单位编码错，3项目编码错，4金额错，5无缴款人，6帐号错，7-通知书日期格式不对等，8异常错误，9-缴款书（号码）已经使用，101-缴款书被冻结，102-缴款书是其他代理银行才可以收费的票据 ；104 被集中汇集缴的通知书不能冲 和银行行缴款；票据红冲的校验结果：103 集中汇缴通知书不能冲； 201通知书已经审核；202财政已经生成凭证；203通知书未收款；204银行收银员不同；205不是当日缴款票据；其它值不能预知的错误。4.2.10 total-amount总金额。总金额=各个收费项目金额之和+滞纳金；输入模式和输出模式均由财政端返回。（银行端不需要计算总金额）4.2.11 remark备注信息。输入模式下，由银行输入；输出模式下，由财政端返回。最大字段长度为 180 字节。非税收入银行实时数据交换服务器方案和接口标准第 14 页 共 33 页5基础数据格式银行与财政之间，以 xml 格式交换数据。银行端向财政发送 http 请求，财政端根据 处理码和 输入输出模式 判断处理并返回相应的数据；银行端再根据财政端返回的数据执行相应的操作。下面是基础数据格式的例子：0.非税收入银行实时数据交换服务器方案和接口标准第 15 页 共 33 页.5.1 package这个节点有一个可选属性 version，表示协议的版本号。5.2 process-result处理结果，表示财政对银行请求的处理结果。由财政端返回。内容：0 表示财政端处理成功；1 表示财政端出现异常或者处理失败。5.3 billtypeinfo当前有效的票据类型信息，包含四个属性：1、billtypecode 表示票据类型代码2、billtypename 表示票据类型名称3、billvercode 表示票据版本代码4、billvername 表示票据版本名称5.4 coinfo单位信息，这个节点有两个属性，co_code 表示执收单位代码， co_name 表示执收单位名称5.5 chargeitem收费项目，这个节点无属性，其子节点是单位所属的收费项目信息5.5.1 Item非税收入银行实时数据交换服务器方案和接口标准第 16 页 共 33 页具体收费项目信息，这个节点有三个属性，code 表示收费项目编码， name 表示收费项目名称，management-forms 表示资金管理形式。0 表示预算内，1 表示预算外,b_acc_code 表示此收费项目对应的预算科目，b_acc_name 表示预算科目名称。5.6 billofco单位票据信息，这个节点无属性，其子节点为单位的可用票据号码段。5.6.1 billno票据号码信息，这个节点有两个属性，startno 表示票据号码段开始号码，endno 表示票据号码段截止号码。6 交互过程输入模式与输出模式的交互过程与步骤相同。但两种模式的在每一个交互步骤中传递的数据有所不同。下图是缴款与冲红处理的交互步骤，并对每一步骤给出相应的数据示例。非税收入银行实时数据交换服务器方案和接口标准第 17 页 共 33 页6.1 正常缴款交互过程图：: 银行银行: 财政局财政局1: 验证请求（处理码 1）2: 验证完成（处理码 6）3: 缴款确认请求（处理码 2）4: 确认完成（处理码 7）6.1.1 验证请求输入与输出两种模式下，银行端发送验证请求的数据包不同，下面是示例： 输入模式：I14gs30211001001001非税收入银行实时数据交换服务器方案和接口标准第 18 页 共 33 页2006-11-16暂存款备注信息 输出模式：O14gs302110010010016.1.2 验证完成验证完成的数据包由财政发送给银行端。输入、输出两种模式下的数据包内容相同。示例如下： 输入模式：I604gs30211001001001101非税收入银行实时数据交换服务器方案和接口标准第 19 页 共 33 页02006-11-162006-11-2150035000.500 输出模式：O604gs3021100100100110102006-11-162006-11-2150035000.500非税收入银行实时数据交换服务器方案和接口标准第 20 页 共 33 页6.1.3 缴款确认请求银行端发送给财政端的缴款确认请求包括完整的缴款信息；示例如下： 输入模式：I24gs30211001001001112006-11-1650035000.50 输出模式：O24gs30211001001001非税收入银行实时数据交换服务器方案和接口标准第 21 页 共 33 页112006-11-1650035000.506.1.4 确认完成 输入模式：I704gs3021100100100110102006-11-162006-11-21非税收入银行实时数据交换服务器方案和接口标准第 22 页 共 33 页50035000.500 输出模式：O704gs3021100100100110102006-11-162006-11-2150035000.500非税收入银行实时数据交换服务器方案和接口标准第 23 页 共 33 页6.2 冲红交互过程图：: 银行银行 : 财政局财政局1: 验证请求（处理码 21）2: 验证完成（处理码 26）3: 冲红请求（处理码 24）4: 冲红完成（处理码 29）6.2.1 验证请求银行端发送验证请求的数据包：C214gs302110010010016.2.2 验证完成验证完成的数据包由财政发送给银行端，返回要冲红的缴款通知书数据。C2604gs非税收入银行实时数据交换服务器方案和接口标准第 24 页 共 33 页3021100100100110102006-11-162006-11-2150035000.5006.2.3 冲红确认请求银行端发送给财政端的冲红确认请求包括修改后完整的票据缴款信息；示例如下：C244gs302110010010011非税收入银行实时数据交换服务器方案和接口标准第 25 页 共 33 页12006-11-1650035000.506.2.4 冲红确认完成C2904gs3021100100100110102006-11-1