本文讨论了业务系统在下载电子回单或电票时遇到的银企业务请求接口异常问题,指出了微服务实现类未找到的可能原因。文中建议通过升级紧急补丁或采用openapi方式解决,并详细介绍了通过openapi方式在银企云上新增第三方应用及维护银企连接配置的具体步骤。
关键词:银企直联、银企云、微服务、openapi
参考文档:
更新日志:
20230205V1.0.0:初稿
1.问题描述
问题现象、报错信息
当在业务系统下载电子回单/电票操作时,发现在下载时报错,银企业务请求接口异常,如何处理?
一般可以到银企互联模块的日志中查看具体报错日志,
如:
银企业务请求接口异常:银企云receiptService接口对应的微服务实现类未找到(电子回单微服务)
银企业务请求接口异常:银企云noteService接口对应的微服务实现类未找到(电票微服务)
2.原因分析
分析问题出现的可能原因(视情况而定)
业务系统都是通过银企互联模块与银企云之间进行交互的,而这之间,有两种方式可以进行交互:
微服务(适合银企互联模块和银企云在同一个、最新版本5.0.011+紧急补丁或者最新版本)
openapi方式(通用,不仅适合银企互联模块和银企云在同一个系统中,也适合不在同一个系统内)
如图类型报错,需要进入银企互联的微服务内进行调整,保障微服务正常才能和银企交互进行回单下载。
目前总部提供的解决办法都为通过升级紧急补丁解决,故如何通过openapi方式实现银企互联与银企云的交互是解决该问题的办法之一。
3.解决方法
解决思路/操作步骤
3.1新增银企云专用第三方应用
注意:是在银企云所在的苍穹星瀚中操作。
操作路径:开发服务云→开放平台→安全策略→第三方应用
新增注意点:
注意系统编码设置、AccessToken认证密码(认证密码要求密码复杂性(大小写及数字、特殊符号混合)及长度要求(16~50位字符))
注意API授权
注意限定IP(一定要限定允许访问这些银企接口的IP,如果银企互联和银企云在同一个苍穹上,就要限定服务器IP)
3.2维护银企连接配置
保存后显示连接成功即可。
4.应用小结
注意事项;补充说明(视情况而定)
无
推荐阅读