#常见问题#【熊说银企FAQ】招商银行：旧版银企直联切换云直联有前置机版本

关键词：银企直联、招商银行、云直联

参考文档：

无

更新日志：

20230402V1.0.0：初稿

1.问题描述

问题现象、报错信息

1.1招商银行采取银企直连方式区分

（1）传统银企直联（金蝶内部前置机版本为CMB_DC）：仅有前置机版本（如下图所示的前置机模式）

（2）云直联模式（金蝶内部前置机版本为CMB_CMP）：

SaaS模式：非国密方式、SM国密方式（目前使用国密方式）

免前置机模式：非国密方式、SM国密方式（目前使用国密方式）

有前置机模式（此处之所以没有区分国密还是非国密，主要看KEY是国密的还是非国密的）

1.2银行要求对接新对接接口需走云直联方式

2.原因分析（由旧版银企直联切换至新版云直联原因）

分析问题出现的可能原因（视情况而定）

2.1旧版银企直联电子回单容易出现下载不全情况

如下图所示，总结客户从2021年1月到2023年3月招商银行旧版银企直连回单下载不全的常见问题，主要为如电子商业汇票解付、结构性存款利息收入回单等银行未返回流水号等导致无法匹配交易明细等问题。

2.2需对接新一代票据系统

需对接招商银行新一代票据系统（ECDS升级至新一代票据系统，招商银行作为第一批上线银行，于2023年12月底将停用原有旧版银企直连票据接口，如需使用票据系统，将对接新一代票据系统的话，采取云直连方式对接）

2.3原先银企平台对接招商银行银企直连版本中由于历史原因设计参数等考虑不全、后续没办法继续支持

虽然原先已上线招商银行旧版银企的，可以接着使用原先查询、支付、回单接口，但是由于银行不推荐该版本的银企对接，金蝶银企产品对于这一块维护的话，除非是产品BUG，新需求的话一般不接，比如金蝶对接旧版银企直连不支持：

【银企平台对接招商银行旧版直联不支持功能点01】

旧版银企直连中将付款的业务审批写在了前置机配置参数里面，这时候没办法实现：

• 部分银行账号提交银企后直接出账无需审批

• 部分银行账号提交银企后需要网银审核后方可出账

而这个在金蝶对接新版银企直连中却是支持的，因为业务审批模式参数，金蝶银企平台将此处的参数的话写到了银行账户参数中，这样就可以针对每个银行账户设置不同的业务审批模式。

【银企平台对接招商银行旧版直联不支持功能点02】

比如代发，旧版银企直连中，走招商银行代发接口AgentRequest时，银企平台对接旧版银企直连时，采取的是将此处的参数写到了银行参数中。

这时候等于每个银行账户要么只能走代发工资（N03020），要么只能走代发其他（N03010）

没办法按照银行账号设置走不同的接口。

原因：此处设置的银行参数，而非银行账号参数。

综合上述两点银企平台对接招商银行旧版银企直连，总部产品不支持，后续针对此类需求也不会再做支持的需求点，建议升级走新版云直联方式。

3.解决方法

解决思路/操作步骤

3.1升级最新版银企平台和最新版电子回单代理程序

银企平台于20221231支持招商银行云直联有前置机版本对接方式

电子回单代理程序于20230106支持招商银行云直联有前置机版本对接方式

后续：银企平台将于2023年5月底前支持招商银行云直联新一代票据系统接口

3.2确认切换日，确保切换日前的旧版银企直联无再途付款单、交易明细已下载完整、回单已下载完整

如确认切换2023-04-01开始使用新版银企直连（云直联）

（1）确认无在途付款单，就是银企平台和星空中必须显示是交易成功或者是交易失败，不能出现银行处理中或者交易未确认等情况，因为切换完一律使用新版银企对接方式。

（2）确认交易明细和电子回单下载完整（部分历史原因导致电子回单下载不完整原因无法解决可忽略）

3.3关闭旧版招商银行银企直联前置机、旧版招商银行下载回单用的SFTP服务

旧版前置机需关闭、旧版招商银行SFTP需关闭（新版不需要使用SFTP）

3.4网银上需切换支持新版银企直联（此处可由银行老师协助支持）

否则登录后会提示

3.5开启全局参数：交易明细限制返回日期

比如是20230401使用旧版，那就是20230331切换

3.6全局参数参数涉及电子回单系统IP设置

此处新版银企平台有优化，如不注意此处填写将导致下载回单异常

可参考帖子【熊说银企FAQ】电子回单代理程序更新指南20230402

3.7配置新版招商银行云直联连接方式（旧版禁用、新版启用）

3.8星空中银行账户需逐个调整连接方式为新版银企直联

3.9配置许可占用清理

3.10针对原先上线银行进行查询余额和下载电子回单，这样好占用相关许可

4.应用小结

注意事项；补充说明（视情况而定）

升级前需逐一注意调整，避免设置有误导致无法使用。