1 功能介绍

   渣打银行明细获取目前支持三套文件格式

• CSV格式文件   最老的版本
  

• MT940/MT942
  

• XML格式文件

  查询余额一般默认都是获取明细文件中对应的余额字段值，余额获取不及时，不准确。且不存在明细时，无法获取对应的 余额

  针对上述问题新增余额接口查询余额，支持在星瀚上配置切换使用新余额接口。支持当日余额，历史余额查询（历史余额 暂未发布）

 XML格式文件版本代理程序暂时不支持新余额接口查询，目前CSV格式文件和MT940/MT942格式两套均已兼容余额接口查询

2 配置指南

2.1星瀚配置

在星瀚银企云--》银行参数配置找到余额查询接口选择配置切换即可

2.2代理程序配置

• 获取最新的含有余额接口查询的代理程序jar包并在代理程序安装路径下lib目录替换原jar包并重启

• 配置余额文件请求和返回的文件路径。注意该路径不得和其他明细文件，付款文件重合。请银行提供具体的路径，银行那边返回的文件路径时可以配置的
  

• 是否使用18位账户 大部分客户可以忽略使用默认项。该配置针对存在6个0+12位账户的特殊账户，该账户银行返回余额中账户默认去掉了前面的0，因此我们查询匹配时需要打开配置补0

• 余额查询接口只支持csv格式，MT940/942版本也是对接的csv格式的余额文件，需提醒银行配置余额接口返回文件格式时使用csv格式
  

2 其他

• 渣打银行余额接口查询并不是严格意义上的实时查询，本质还是异步查询，其余额仍然存在一定滞后性。据银行反馈通常情况几分钟即可返回余额文件。极端情况，不会超过半个小时

• 当天首次查询余额时。代理程序会返回 record not exist 。我们会向前置机发送请求文件，待银行响应返回文件时，再次查询即可获取

• 余额数据在代理程序不会进行持久化，存储在内存中，过期时间为24个小时。当天重复查询同一账号余额，返回的是上一次查询余额的缓存，余额数据中有具体的时间，可以根据该时间判断是否余额对应的时间节点

• 重启代理程序数据被清除，再次查询银行，银行返回的数据重写写入内存

• 历史余额查询范围不得超过90天