【电子回单】中信银行直连版（CITICB_DC）回单配置指南

    中信银行推送电子回单方式，是电子回单程序向前置机发送回单下载的请求，银行收到请求后将回单文件的文件流通过前置机返回给回单程序，电子回单程序将回单文件的文件流转成文件存在本地。这种方式配置往往比较简单。

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

1. 银企前置机IP地址、端口、登录用户

• 银行前置机IP地址

• 银行前置机端口

• 登录用户

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

2. 中信银行号

    中信银行号（银行提供），一般不用填写。

3. 是否获取当日回单

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

    说明：

如果是EAS客户，建议不要去获取当日回单。原因如下：中信银行当日回单和历史回单，银行返回的回单编号不一样。如下图所示，当日回单下载，银行返回的回单编号较短（下图中回单文件名称中的第三段），而回单平台为了避免回单缺失还会在第二天去下载昨天的回单（历史回单），此时银行返回的回单编号变了，如下图所示文件名称比较长，也就是说回单文件名称和当日回单下载的回单文件名称不一样了，而且历史回单下载后，会删除掉当日回单下载的回单文件。

而EAS中，下载回单结构化数据和下载回单pdf文件是两个步骤。下载回单的结构化数据后，回单结构化数据中保存了回单文件的路径和文件名称，再去根据这个文件路径和文件名称访问回单平台内置SFTP服务去下载回单的pdf文件。若下载回单结构化数据和下载回单pdf文件这两个步骤都在当天能执行完毕，那么就没有问题；若当天只下载了回单的结构化数据，而回单的pdf文件因为种种原因没有下载完全，所以需要等到第二天再去下载pdf文件，那因为第二天回单平台下载历史回单导致回单文件名称发生了变化、且当日回单任务下载的回单文件被删除了，那EAS再去根据当日回单结构化数据中保存的回单文件名称去回单sftp下找个文件，就找不到了。

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

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

1. 创建调度

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

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

2. 预处理调度

    根据任务的账号和日期，获取到回单文件名。具体来讲，是使用DLEDDRSQ接口，根据账号、交易日期等获取到回单编号brSeqNo。

    报文如下：

中信银行回单信息查询(DLEDDRSQ)请求：
<?xml version="1.0" encoding="GBK"?>
<stream>
    <action>DLEDDRSQ</action>
    <userName>YXXXXXXX1</userName>
    <qryType>2</qryType>
    <accNo>8110201012600792380</accNo>
    <billType>0</billType>
    <minAmt>-999999999999.99</minAmt>
    <maxAmt>9999999999999.99</maxAmt>
    <startDate>20230619</startDate>
    <endDate>20230619</endDate>
    <pageSize>9</pageSize>
    <startNo>1</startNo>
</stream>

中信银行回单信息查询(DLEDDRSQ)响应：
<?xml version="1.0" encoding="GBK"?>
<stream>
    <status>AAAAAAA</status>
    <statusText>交易成功</statusText>
    <totalCount>1</totalCount>
    <list name="userDataList">
        <row>
            <billType>200000</billType>
            <bizTpdes>二代支付</bizTpdes>
            <bizType>200000</bizType>
            <brseqNo>2023061920000020230619SC1900135480520000010001</brseqNo>
            <cdfg>D</cdfg>
            <cryType>001</cryType>
            <payeeAccNm>22232122233331</payeeAccNm>
            <payeeAccNo>111111111111111</payeeAccNo>
            <payerAccNm>测试专用客户</payerAccNm>
            <payerAccNo>8110201012600792380</payerAccNo>
            <tranAmt>33.00</tranAmt>
            <tranCode>3505700</tranCode>
            <tranDate>20230619</tranDate>
            <tran