【电子回单】建设银行外联版（CCB_DC） 回单配置指南

第一步：建行外联版前置机服务器上搭建sftp服务

    如果建行外联版前置机 和电子回单服务器在同一台服务器上，则不需要搭建sftp服务了，跳过这个步骤。

    银行服务器会把回单推送到建行外联版前置机安装路径的download目录下，所以需要以此目录为根目录搭建好SFTP服务，并确保回单代理程序能访问该SFTP服务。

    如何搭建sftp服务？

1）可参考《电子回单程序部署说明V1.0.20230106.docx》文档的“五、附录”操作（下载回单安装包并解压，\ebgProxy_20230106 目录下就有这个文件）

2）搭建sftp服务的工具freesshd可以在帖子中找到下载链接：https://vip.kingdee.com/article/165500974349008896?productLineId=8  ）

    搭建sftp服务之后，记录一下sftp服务的SFTP服务的“IP”、“端口”、“账号”、“密码”信息。

    需要注意的是，用freesshd搭建的sftp服务，其根目录不支持中文（经验表明，根目录有中文的时候，测试连接不通，且还存在中文乱码问题）。所以请将其安装在一个非中文路径下；因建行外联版前置机默认会安装在一个中文路径下，咨询过银行技术人员，可以在停止服务后将这一层目录直接拷贝到windows的盘符下，再去启动服务。

    建行外联版，发请求后银行推送的回单文件如下图所示：

第二步：登录进入回单系统，在[配置项 - 银行配置]页面配置相关信息

    登录进入电子回单系统后，在[系统配置]页面，“启用银行插件列表”中勾选“建行银行外联版(CCB_DC)”后保存，然后切换到[银行配置]页面就可以选到这个插件了。

1、配置前置机的ip和端口信息

    可以参考银企平台-系统管理-前置机配置页面中，建行外联版前置机IP和端口的配置：

2、配置网银客户号、操作员号和操作员密码

    配置以下信息：

* 建行外联版本的'网银客户号'

* 建行外联版本的'操作员号'

* 建行外联版本的'操作员密码'

    可以参考银企平台-系统管理-前置机配置页面中，建行外联版前置机的“银行业务配置”信息进行配置：

3、配置回单获取方式

    如果建行外联版前置机和电子回单服务器在同一台服务器上，则 回单获取方式选择“本地获取”，然后“银行回单推送路径”配置为建行外联版前置机的download目录的全路径。

    如果建行外联版前置机和电子回单服务器不在同一台服务器上，则 回单获取方式选择“远程sftp获取”，需要把第一步中搭建的sftp服务的“IP”、“端口”、“账号”、“密码”配置到下图所示的“银行SFTP服务器IP地址”、“银行SFTP端口”、“登录SFTP服务器使用的用户名”、“登录SFTP服务器使用的密码”文本框中。保存之后，点【测试连接】按钮，测试连接通过后，再去下载回单。

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

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

1、创建调度

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

    刚部署的情况下是没有任务的，可以手动添加一个任务进行测试。如下图所示，点【+添加任务】按钮进行添加。注意：不要添加今日的任务，回单有可能缺失。

2、预处理调度

    根据任务的账号和日期，获取到回单文件名。

    预处理阶段，回单代理程序发送查询及下载回单的请求给建行外联版前置机（根据NWHD01返回的回单编号调用NWHD02生成回单文件），前置机再将请求转发给银行服务器；银行服务器收到请求后，返回回单的文件名等信息。

首先，调用NWHD01获取回单编号<INNER_NO>
建设银行外联电子回单信息查询（NWHD01）请求报文第1页查询请求：
<?xml version="1.0" encoding="GB18030"?>
<TX>
    <REQUEST_SN>9279482357153793</REQUEST_SN>
    <CUST_ID>SHxxxxxxxxxxxxxxx1</CUST_ID>
    <USER_ID>WLxxx1</USER_ID>
    <PASSWORD>xxxxxxxx</PASSWORD>
    <TX_CODE>NWHD01</TX_CODE>
    <LANGUAGE>CN</LANGUAGE>
    <TX_INFO>
        <ACC_NO>31xxxxxxxxxxxxxxxx4</ACC_NO>
        <STARTDATE>20230712</STARTDATE>
        <ENDDATE>20230712</ENDDATE>
        <PAGE>1</PAGE>
        <TOTAL_RECORD>20</TOTAL_RECORD>
        <PRINT_FLAG></PRINT_FLAG>
    </TX_INFO>
</TX>

建设银行外联电子回单信息查询（NWHD01）响应报文第1页查询响应：
<?xml version="1.0" encoding="GB18030"?>
<TX>
    <REQUEST_SN>9279482357153793</REQUEST_SN>
    <CUST_ID>SHxxxxxxxxxxxxxxx1</CUST_ID>
    <TX_CODE>NWHD01</TX_CODE>
    <RETURN_CODE>000000</RETURN_CODE>
    <RETURN_MSG></RETURN_MSG>
    <LANGUAGE>CN</LANGUAGE>
    <TX_INFO>
        <PAGE>1</PAGE>
        <TOTAL_PAGE>1</TOTAL_PAGE>
        <DETAILLIST>
            <INNER_NO>31020231019885537834</INNER_NO>
            <TRAN_DATE>20230712</TRAN_DATE>
            <LOG_NO>3102800000N5PX33REY</LOG_NO>
            <CR_COD>贷</CR_COD>
            <TX_AMT>500000.00</TX_AMT>
            <DOC_TYP>电汇凭证</DOC_TYP>
            <DOC_NO></DOC_NO>
            <OP_ACCT_NO>121903205310602</OP_ACCT_NO>
            <OP_ACCT_NAME>xxxxxxxx有限公司</OP_ACCT_NAME>
            <CCYCD>人民币</CCYCD>
            <Atch_Ind>N</Atch_Ind>
        </DETAILLIST>
    </TX_INFO>
</TX>

然后，调用NWHD02，获取到文件名FILE_NAME（多个回单编号的话，要多次调用NWHD02）
建设银行外联批量回单文件查询（NWHD02）请求报文：
<?xml version="1.0" encoding="GB18030"?>
<TX>
    <REQUEST_SN>1679279485830037504</REQUEST_SN>
    <CUST_ID>SHxxxxxxxxxxxxxxx1</CUST_ID>
    <USER_ID>WLxxx1</USER_ID>
    <PASSWORD>xxxxxxxx</PASSWORD>
    <TX_CODE>NWHD02</TX_CODE>
    <LANGUAGE>CN</LANGUAGE>
    <TX_INFO>
        <ACC_NO>31xxxxxxxxxxxxxxxx4</ACC_NO>
        <DOWNLOAD_NOS>31020231019885537834</DOWNLOAD_NOS>
    </TX_INFO>
</TX>

建设银行外联批量回单文件查询（NWHD02）响应报文：
<?xml version="1.0" encoding="GB18030"?>
<TX>
    <REQUEST_SN>1679279485830037504<