问题描述

  在客户使用以及现场联调时，可能出现因银行环境变更，接口文档修改，bug修复等问题需要更新补丁包，使得原本的流程阻塞，因此，使用低代码平台可以跳过更新补丁包的环节，能直接修改上述的大部分问题。

解决方法

进入方式：点击银企云->查询支付->银行电票接口管理

点开菜单栏之后会出现三个标签，分别为：银行电票接口管理，匹配规则，匹配规则集合。

其中，银行电票接口管理用来展示预置的各种银行电票接口详情，可通过左侧的标签栏来筛选具体银行的接口

菜单栏按钮介绍

新增：在左侧选中行为某个银行的电票时可新增该银行的接口

复制：选中某个银行接口，点击新增按钮中的下拉框，可出现复制按钮，可进入选中接口的复制副本中进行编辑

导出Ksql：选中银行接口后（可多选）点击该按钮，可导出预设该接口的Ksql脚本。

删除：选中银行接口后，点击该按钮，可删除选中的接口

提交，审核：新增接口保存之后接口状态处于暂存状态，暂存的接口无法被使用，需要提交审核之后才能投入使用

禁用：将已审核的接口禁用

编辑接口详情介绍

以新增接口为例，基本信息模块中，重点需要填入的有业务类型（下拉框形式），银行接口代码

业务类型：包括应付，应收，待签收票据查询等等，选择该接口对应的业务类型即可，每种业务类型在后续的请求参数中提供的银企属性不同。

银行接口代码：该字段需保证唯一性，与后端代码中的接口路由相关，一般选择与银行接口名称保持相同，如果遇到同一个银行接口要在不同的业务类型中使用时，应修改该字段内容并与后端代码中的保持一致。

录入请求参数

可通过增行，增子行来调整接口的报文结构，目前仅支持xml格式的报文，也可通过导入请求体参数来录入，在导入之前需将请求参数中的内容清空，进入导入界面后只需将报文格式输入即可，需保证输入的内容是完整的xml格式否则会报错

请求参数属性介绍

银行字段：对应银行报文中的值，也是<导入请求体参数>按钮录入的值

银行字段名称：用于解释银行字段的具体含义

报文结点：分为业务结点，结构结点，循环结点，其中业务结点代表该行录入的字段是用来传值的。结构结点代表该行字段无具体含义，只是头结点或者其他结构等。循环结点标识该行录入的结点可有多个，具体数量会根据报文中对应请求体的数量来进行判断。

银行字段取值：当报文结点取值为业务结点时，用该字段来标识用什么值来给该行的业务结点赋值。分为银企属性，匹配规则集合，固定值。标识该字段应该用后续的三列同名属性中的哪列赋值。

银企属性：分为电票元数据，前置机参数配置，账号属性，银企工具类共计四种类型，电票元数据代表从请求报文中获取相应的属性值来给该行赋值，银企工具类中包含一些随机数，系统时间，MD5值等即时生成的配置参数

匹配规则结合：用于该行内容的赋值需要通过一些简单的条件判断来完成的情况。可从中选中在匹配规则界面配置的条件集合。

固定值：该行取值无需从请求参数等来源中获取，可以直接赋值某个常量。

为空是否上送字段：该字段取值为空值的时候这个字段是否要被上送给银行。

响应参数

分为响应体，外层状态码，内层状态码三个标签

响应体：录入银行的响应报文结构，录入逻辑与请求参数录入大体相同，本处只解释部分属性列的含义

• 填入银企字段：将本行获取的字段内容塞入银企返回的字段中，该内容可选值与业务类型相关
  

• 响应字段类型：标识此行是否是响应码字段，可分为内层，外层响应码，从而在另外两个标签页配置相关逻辑

外层状态码：当响应体中存在外层响应码字段是生效，经过配置逻辑判断来返回笔业务的交易状态

    匹配规则：通过页面配置的一个简单的逻辑判断，示例如下：（配置好并审核完成即可在响应码内引用）

内层状态码：有时候银行返回的响应码字段不止一个，需要通过多个响应码来判断交易状态时就可使用内层状态码来进行逻辑处理，在外层响应码的交易状态栏可选择“中间状态，等待内层状态码校验结果”，并且响应码中有设置相应的字段为内层状态码时即可使用，逻辑配置与外层状态码一致。

匹配规则与匹配规则集合的区别

    匹配规则：匹配规则只能配置简单的逻辑判断，例子：if（A ==“A”AND B ==“C”），只能返回一个if条件中的逻辑值。

    匹配规则集合：匹配规则集合可应用匹配规则，故可以实现比较复杂的逻辑判断，例如：

        if（A ==“A”AND B ==“C”）//引用的一个匹配规则

            else if（B==“A”OR C == “B”）//引用的另一个匹配规则

                else...

适用版本

5.0.020以上版本皆可使用