【电子回单】长安银行直连版（CABC_DC）回单配置指南

    长安银行推送电子回单的方式，是电子回单程序向长安银行前置机发送回单下载的请求，交易成功之后，银行返回回单文件的下载链接，通过这个下载链接将回单文件存到本地。

一、回单代理程序 - 配置项 - 银行配置

    在回单平台 - 配置项 - 系统配置页面 - 启用银行插件列表中，勾选“长安银行直连版(CABC_DC)”后，点【保存】按钮，在银行配置页面，“--请选择银行--”下拉列表中就可以选择到这个插件并进行配置了。 

• 银行前置机IP地址：对接的银行前置机所在服务器IP地址 —— “银企平台，部署服务器的IP地址”

• 银行前置机端口：对接的银行前置机服务的端口号 —— “银企平台，前置机服务端口号”

• 客户号：客户号，例如：100000002600  —— “银企平台，客户号”

• 用户号：用户号，例如：102643 —— “银企平台，网银中合法的企业操作员号”

• 用户ID：财务软件客户端登陆用户ID。例如：SA    —— 银企平台，银行为企业编号分配的两位编号”

• scp客户端IP：生成秘钥的scp客户端签名服务的IP —— 可以配置为“银企平台，部署服务器的IP地址”

• scp客户端端口：生成秘钥的scp客户端签名服务的端口 ———— “银企平台，前置机签名端口号”

     以上配置信息请参考银企平台 - 系统管理 - 前置机配置页面，选择“长安银行直连版(CABC_DC)”的配置，如下图所示：

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

    为了快速的看到效果，可以在[配置项 - 银行配置]页面，将“长安银行直连版电子回单调度方式”修改为“测试使用”（测试调度仅需要大约4分钟就可以完成一次调度）。修改并保存后，在[模块管理]页面重启【回单模块】生效。

1. 创建调度

    自动创建所有回单账号的前一天的回单任务。

    刚部署的情况下是没有任务的，可以点【+添加任务】按钮手动添加一个任务进行测试。

2. 预处理调度

    根据任务的账号、日期等信息调用电子回单下载请求接口（ReceiptURLQry）接口，获取到回单文件的下载链接downloadURL（链接经过base64编码，需要解码后使用），然后通过URL将压缩包文件下载到\tempPath\CABC_DC\目录下，并解压成PDF文件，获取到回单的文件名。

    调用ReceiptURLQry接口时，需要先进行签名，签名成功后，发送电子回单下载请求，验签成功后会返回回单文件的下载链接downloadURL。

2024-04-11 14:37:06.077  INFO [CABC_DC,,1778196258800795648] 33912 --- [pool-3-thread-39] c.k.b.b.cabc.dc.job.CabcDcFetchListJob  : ----****----:请求地址：http:/xxx.xxx.xxx.xxx:7071/yqbank/APIReqServlet
2024-04-11 14:37:06.078  INFO [CABC_DC,,1778196258800795648] 33912 --- [pool-3-thread-39] c.k.bos.bank.cabc.dc.utils.GetSign      : 长安银行签名请求：
<?xml version="1.0" encoding="GBK"?>
<msg>
    <msg_head>
        <msg_type>0</msg_type>
        <msg_id>1005</msg_id>
        <msg_sn>0</msg_sn>
        <version>1</version>
    </msg_head>
    <msg_body>
        <origin_data>
            <opReq>
                <opname>ReceiptURLQry</opname>
                <cstNo>1xxxxxxxxxxxx9</cstNo>
                <userNo>1xxxx7</userNo>
                <serialNo>20240411143706806XX0932</serialNo>
                <userId>XX</userId>
                <reqTime>20240411143706</reqTime>
                <ReqParam>
                    <accountNo>8xxxxxxxxxxxxxxxxxx8</accountNo>
                    <qryDate>20240410</qryDate>
                </ReqParam>
            </opReq>
        </origin_data>
    </msg_body>
</msg>

2024-04-11 14:37:06.520  INFO [CABC_DC,,1778196258800795648] 33912 --- [pool-3-thread-39] c.k.bos.bank.cabc.dc.utils.GetSign      : 长安银行签名响应：
<?xml version="1.0" encoding="UTF-8"?>
<msg>
    <msg_head>
        <msg_type>1</msg_type>
        <msg_id>1005</msg_id>
        <msg_sn>0</msg_sn>
        <version>1</version>
    </msg_head>
    <msg_body>
        <signed_data>xxxxxxxxxxxxxxxxxxxxxxxx6bKCxpCKg==</signed_data>
    </msg_body>
</msg>
2024-04-11 14:37:06.520  INFO [CABC_DC,,1778196258800795648] 33912 --- [pool-3-thread-39] c.k.bos.bank.cabc.dc.utils.GetSign      : 签名成功.
2024-04-11 14:37:06.521  INFO [CABC_DC,,1778196258800795648] 33912 --- [pool-3-thread-39] c.k.b