票面信息查询日志分析

1、 什么是票面信息查询

票面信息查询是指查询客户名下某一张票号的具体信息，业务端通过票号、子票区间，新票标识等字段，获取银行最新的票面信息、背面信息。

2、 持票查询请求字段

业务端发起查询，调用queryNoteDetail接口，subBizType=info。

"isNewECDS":"新系统出票标志"

"noteNo": "票据号码"

"subRange":子票区间（非必输，不输则查询票据号码下所有子区间）可拆分票据格式    为：12位起始区间-12位结束区间；不可拆分票据格式为固定：0

注意事项：该交易为同步交易，实时查询银行数据返回

subRange+noteNo全都输入，则精确查询该子票区间的票据信息。

只输入noteNo，则查询客户名下该票号（包号）的所有子票区间。

3、 持票查询分页

该接口没有分页，一次返回给业务端。

4、 查询流程图

5、 粗略查找持票查询日志

1. 打开银企云日志菜单，筛选业务类型为：待签收票据查询

2. 根据账号、账号所属银行版本、记录时间等粗略定位日志

定位后点击查看日志，看业务请求日志里面的subBizType=info，则该日志为票面信息查询日志，否则不是票面信息查询日志，需要继续定位其他日志。

然后比对账号是否正确，票号信息

6、 精确定位日志

1. 在银企互联找到该次请求日志

找到loggerBatchNo，后面的数字即为业务日志号

2. 在银企云日志菜单过滤

输入loggerBatchNo，即可找到该次请求的日志

3. 点击查看日志，即可看到业务端请求日志，银企云返回给业务端的日志，以及银行日志

7、 常见问题分析

1. 某张票据查询报错或者返回为空

先去网银确定票据是否在客户名下，如果不在客户名下可能无法返回，每个银行对接口的权限校验不一样，大部分银行认为票据不在你名下你是没有权限查询的。

如果在客户名下，则确认票据所属账号跟发起查询的账号是否是同一个。

如果是同一个账号，则需要在银行日志搜票号，看银行是否返回，如果银行未返回直接拿日志咨询银行。

2. 查询报错不支持票面信息查询或者找不到info实现类

该银行插件目前不支持票面信息查询，可以提需求单处理

3. 其他查询报错

可以打开银行日志是否是连不上银行前置机报错，看银行返回日志是否是银行端报错。

如果连不上前置机，请检查前置机服务是否正常，可以重启前置机等。

如果银行返回报错信息，则需要拿日志咨询银行。