持票查询日志分析

1、 什么是持票查询

持票查询是指查询客户账号下面所有票据。业务端发起查询请求，返回的数据持票账号都为发起查询的账号。

2、 持票查询请求字段

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

"pageNum":"查询页码"，

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

"grdBag":"票据分包流转允许标志"

"draftType": "票据类型"

"grdBag":"票据分包流转允许标志"

以上字段必输，但银企云不一定使用，用来屏蔽不同银行差异，结果以银企云返回数据为准。

3、 持票查询分页

分页是由业务端完成的，主要原因是持票数据量大，银企分页会导致超时。

接口中请求字段pageNum来体现。

4、 持票查询强制频率限制

持票查询比较耗时，为了保证银企云前置机资源，目前同一个账号同一个页码10分钟内只能查询一次。超过频率会报错。

5、 持票查询流程图

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

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

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

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

然后比对账号是否正确，页码等信息

7、 精确定位日志

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

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

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

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

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

8、 常见问题分析

1. 某张票据查不回来

先去网银确定票据是否在客户名下，如果不在客户名下是不能返回的。

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

如果是同一个账号，则需要在银行日志搜票号，看银行是否返回，这里因为是分页的，所以要在多个日志里面搜索。

2. 查询报错不支持持票查询或者找不到hold实现类

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

3. 其他查询报错

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

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

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