【电子回单】招商银行云直连（CMB_CMP）回单配置指南

一、系统配置 - 启用银行插件列表，选“招商银行无前置机版(CMB_CMP)”

    在20230106及之后的版本中，登录电子回单系统后，点[回单 - 配置项 - 系统配置]，在“启用银行插件列表”中，勾选[招商银行无前置机版(CMB_CMP)]后保存。

二、银行配置

    银行前置机IP地址、银行前置机端口，这两个是冗余配置项，可以不填，不用管这两个配置项。

1. 加密方式

    之前的老客户如果没有升级国密，那可以继续使用“AES”；如果是新客户，请选择“国密”。如不清楚当前客户使用了哪种加密方式，可咨询银行方。    

2. 招行云直联模式

    可选择：标准无前置机模式、SAAS模式、有前置机模式。

    该选择哪种模式呢？一般情况下，在配置回单之前，已经在银企平台测试了余额、交易明细等功能，也就是说，银企平台的配置都是正确的，所以可参考银企平台的配置进行配置。

    登录银企web，进入[业务管理 - 银行业务配置]，查看“云直连接入模式”选的是哪种模式。

3. 招商银行企业银行系统访问地址、招商银行企业银行系统下载回单地址

    “招商银行企业银行系统访问地址”怎么配置？

    可以参考银企平台的配置。具体如下：登录银企web，进入[系统管理 - 前置机配置]，如下图所示，把这里配置的“招商银行企业银行系统访问地址”拷贝过去即可。

    具体来讲，针对三种不同的云直连接入模式“标准无前置机模式、SAAS模式、有前置机模式”，配置的值也有所区别：

• 标准无前置机模式

招商银行企业银行系统访问地址：如果配置了nginx，此处填nginx转发地址，否则填默认地址：

正式环境：https://cdc.cmbchina.com/cdcserver/api/v2

测试环境：http://cdctest.cmburl.cn/cdcserver/api/v2 

招商银行企业银行系统下载回单地址：如果走nginx，填代理地址，否则填默认地址：

正式环境：

1）互联网访问，配置为这个地址：http://s3gwst.cmburl.cn

2）专线访问，配置为这个地址： https://cdc.cmbchina.com/cdcserver/api/v2

测试环境：http://s3gwst.cmburl.cn:8081

• SAAS模式

    SAAS模式，一般是直接上生产环境，不用测试，所以这里就配置正式环境的访问地址即可。

招商银行企业银行系统访问地址：如果配置了nginx，此处填nginx转发地址，否则默认填入：https://cdc.cmbchina.com/cdcserver/api/v2

招商银行企业银行系统下载回单地址：如果走nginx，填代理地址，否则填默认地址：http://s3gwst.cmburl.cn

• 有前置机模式

招商银行企业银行系统访问地址：登录银企web，进入[系统管理 - 前置机配置]，选择“招商银行云直连(CMB_CMP)”,把页面上配置的“招商银行企业银行系统访问地址”拷贝过来即可。

招商银行企业银行系统下载回单地址：http://s3gwst.cmburl.cn

4. 配置密钥文件

    云直连模式选择“有前置机模式”时，不需要配置密钥文件，这几个配置项置空即可。

    云直连模式选择“标准无前置机模式”或SAAS模式时，才需要配置密钥文件的本地存放完整路径（包含文件名）。

密钥文件存放在这个银企平台服务器的这个路径下：

    注意：

    如果电子回单服务器跟银企平台服务器安装在同一台服务器上，那么电子回单系统配置密钥文件路径就可以选择银企平台存放密钥的这个路径。

    如果电子回单服务器跟银企平台服务器不是安装在同一台服务器上，那么需要到银企平台存放密钥的这个路径下把这四个文件拷贝到电子回单服务器的某个目录下。

• AES密钥路径

    加密方式选国密时，此项不填，选AES时，必填。AES密钥存放的路径，例如：C:\ebservice705\ebservice\configs\banks\CMB_CMP\aes.txt

• RSA密钥路径

    加密方式选国密时，此项不填，选AES时，必填。RSA密钥存放的路径，例如：C:\ebservice705\ebservice\configs\banks\CMB_CMP\rsa.txt

• 用户对称密钥

    加解密算法如果为国密(SM)，请上传SM4密钥。客户自己保存，用户报文加密、解密使用，请妥善保管，防止泄露。例如：C:\ebservice705\ebservice\configs\banks\CMB_CMP\aes.txt

• 用户私钥

    加解密算法如果为国密(SM)，请上传SM私钥。 客户自己保存，用户报文签名、验签时使用，请妥善保管，防止泄露。例如：C:\ebservice705\ebservice\configs\banks\CMB_CMP\rsa.txt

• 平台私钥

    SAAS模式，请上传平台私钥。 客户自己保存，用户报文签名、验签时使用，请妥善保管，防止泄露。例如：C:\ebservice705\ebservice\configs\banks\CMB_CMP\kingdee.txt

    如果你不知道要配置哪几个选项，那就全配置上，也没关系的。系统只会根据你选的加密方式和云直连模式去读取对应的密钥文件。

5. 用户ID

    这里填入招商银行银企直连的用户名，就是在银企web-[系统管理 - 前置机配置]，选择“招商银行云直连(CMB_CMP)”,把页面上配置的“招商银行企业银行直连系统的'UID'（银行提供）”拷贝过来即可。

6. 是否为互联网访问链接

    如果是专线，请选择false。默认值(true)

    注意，大部分客户的文件地址类型都是互联网可访问的，所以一般这里选择默认值true即可；专线接入客户该值选择false。

7. 保留压缩包天数

    给招商局做的临时处理，这个功能可能会严重消耗硬盘物理内存，请谨慎使用。默认值0。

8. 是否获取当日回单

    获取当日回单功能，能够下载当天的回单文件，如果选择"是"请对下方【[当日回单创建]任务调度配置】进行设置。

默认值(否)

三、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段

     可参考《电子回单程序部署说明V1.0.20230106.docx》文档的第三章“7.回单下载配置”操作，这里不再赘述。

    招行云直连下载电子回单，使用到两个接口：

• 电子回单异步查询（ASYCALHD）

根据银行账号、交易日期、文件格式（PDF），获取到打印任务编号rtndat（即任务ID，根据该ID查询PDF文件）

• 回单异步打印结果查询（DCTASKID）

根据任务ID、文件地址类型（true或者空：生成的url链接为互联网可访问；false：生成的url链接为专线访问地址，请专线接入客户该值传false），查询电子回单异步处理结果。如果后台处理完成会返回一个URL链接，可通过该URL链接下载文件。

    下载的回单文件的命名规则是：账号_起始日期_结束日期_回单编号_流水号（有部分回单没有流水号字段）。“回单文件命名中的流水号”字段可以与账户交易信息查询（DCTRSINF）接口交易流水中的“<refnbr>流水号”字段一一对应，从而可以实现交易明细与电子回单的一一匹配。。

    下面为互联网访问类型下，ASYCALHD 和 DCTASKID 的请求和响应报文：

电子回单异步查询（ASYCALHD）请求：
{
    "request":{
        "body":{
            "begamt":"",
            "begdat":"2022-12-28",
            "eacnbr":"755xxxxxxxxxxxx3",
            "endamt":"",
            "enddat":"2022-12-28",
            "primod":"PDF",
            "rrccod":"",
            "rrcflg":"1"
        },
        "head":{
            "funcode":"ASYCALHD",
            "reqid":"202212301136150991608668258519482368",
            "userid":"B0xxxxxx33"
        }
    },
    "signature":{
        "sigdat":"dLX48wBkCNT/An192s2P2/GhQoUmS7Dk/IhWe3+N6iJ4TRnzZ6EPuEIaBlMJHQSb0Yn61n7xMD+/HKZPNduhUw==",
        "sigtim":"20221230113615"
    }
}

电子回单异步查询（ASYCALHD）响应：
{
    "response":{
        "body":{
            "asycalhdz1":{
                "rtncod":"SUC0000",
                "rtndat":"KzvFHWvykYl3+N4JbA3hY9un8Dnsbuglb+feImoAcv4=",
                "rtnmsg":"",
                "taskid":"1608668259504664577"
            },
            "ctnkeyz2":{
                "begamt":"",
                "begdat":"2022-12-28",
                "clientid":"",
                "daltag":"N",
                "eacnbr":"755xxxxxxxxxxxx3",
                "endamt":"",
                "