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

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

    在回单平台 - 配置项 - 系统配置页面 - 启用银行插件列表中，勾选“长安银行直连版(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.b.cabc.dc.job.CabcDcFetchListJob  : 长安银行电子回单下载请求：
20240411143706806XX0932000000000000ReceiptURLQry00002044
<?xml version="1.0" encoding="GBK"?>
<BankData>
    <Sign>
        <SignedData>xxxxxxxxxxxxxxxxxxxxxxxx6bKCxpCKg==</SignedData>
        <PubKey></PubKey>
    </Sign>
    <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>
</BankData>
2024-04-11 14:37:06.606  INFO [CABC_DC,,1778196258800795648] 33912 --- [pool-3-thread-39] c.k.b.b.cabc.dc.job.CabcDcFetchListJob  : 长安银行电子回单下载响应：
20240411143706806XX0932000000000000ReceiptURLQry00000349
<?xml version="1.0" encoding="GBK" ?>
<BankData>
    <opRep>
        <serialNo>20240411143706806XX0932</serialNo>
        <hostReturnCode>00000000</hostReturnCode>
        <hostErrorMessage/>
        <RepParam>
            <downloadURL>aHR0xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxDQxMC56aXA=</downloadURL>
        </RepParam>
    </opRep>
</BankData>

    对downloadURL使用Base64解码，结果为：

https://ebank.ccabchina.com/image/806/yq_receipt/G-2-t-c-2-0/8xxxxxxxxxxxxxxxxxx8_20240410.zip。

    通过这个URL将8xxxxxxxxxxxxxxxxxx8_20240410.zip文文件下载到\tempPath\CABC_DC\目录下并解压，结果为：\tempPath\CABC_DC/806777777G510000214_20240410_b62Z.pdf 

\tempPath\CABC_DC/806777777GAT0000333_20240410_4ltY.pdf 

    解压完毕，则预处理调度结束。此时可以点任务的【详情】查看回单的文件名（回单的文件名称是按照“账号_交易日期_流水号.pdf”的规则进行命名的），如下图所示

3. 下载调度

    在下载调度阶段，将\tempPath\CABC_DC\目录下的PDF文件移动\scanPath\CABC_DC\目录下，并重命名，命名规则为：账号_交易日期_流水号.pdf。

    至此，下载调度结束。

4. 扫描调度

     对下载到scanPath\CABC_DC\目录的文件进行扫描，解析出结构化数据保存到回单库的表中同时将文件保存到bakPath\CABC_DC\目录下。扫描调度结束后，可点击回单任务的【结果】查看回单的结构化数据。如下图所示：