【电子回单】北京银行直连版（BJB_DC）回单配置指南

    北京银行的电子回单，支持2钟格式：

• 报文：不需要在金蝶电子回单代理程序中进行配置，只需要在银企web-银行业务配置页面设置“北京银行电子回单格式”的值为【报文】，重启银企服务生效。

• 文件：本文详细介绍北京银行文件格式回单的配置过程。

一、北京银行文件格式的电子回单数据说明    

    由银行方推送压缩包文件到企业客户的ftp服务器上，传输方式：SFTP；

    压缩包文件命名规则：企业英文名称_批次号_文件生成时间(年月日).zip

    例如：SJDB_000000000182055_20220309.zip

    压缩包内回单文件命名规则：回单号.pdf

    推送的回单文件与回单结构化数据根据回单号billNumber关联可以关联起来。

    电子回单样式参考下图：

二、企业方搭建SFTP服务

    先联系银行方开通文件格式的回单功能，银行方会要求客户自己去搭建SFTP服务，并提供SFTP服务的IP、端口、用户名和密码信息。

     客户需要找一台机器搭建SFTP服务（这台机器可以是一台独立于银企服务器、回单服务器，以及北京前置机的机器，也可以是北京银行前置机这台机器）。Windows环境下，可以使用freeSSHd、Serv-U或者其它程序搭建SFTP服务，Linux环境系统自带SFTP服务。注意：SFTP的根目录不要配置中文路径。搭建SFTP的操作，可参考《电子回单程序部署说明V1.0.XXXXXXXX.docx》文档的第五章 附录，这里不再赘述。

    搭建好SFTP服务之后，自己可以使用Winscp软件测试一下SFTP能否连通。没问题的话，需要提供SFTP服务的外网IP和端口信息，以及SFTP的用户名、密码给到银行方进行配置，并确保银行方能访问该SFTP服务。

    待银行推送压缩包文件到企业客户的sftp服务器上，可以用看一下是直接推送到根目录下，还是推送到子目录下？这个会影响到回单的配置。例如下面这个客户，搭建的sftp的根目录是C:/BGRECEIPT，但银行推送的压缩包是放在子目录 /BOB 下的：

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

    在配置项 - 系统配置页面，“启用银行插件列表”中勾选“北京银行直连版(BJB_DC)”后点【保存】，然后切换到 银行配置页面，就可以选择“北京银行直连版”并进行配置了。

1、前置机IP地址、端口、用户名、用户密码、签名服务端口号

    这几个配置项，可以参考银企web - 系统管理 - 前置机配置页面“北京银行直联版(BJB_DC)”的配置：

• 银行前置机IP地址

• 银行前置机端口

• 用户名（userID）

• 用户密码（userPWD）

• 签名服务端口号

2、回单获取方式

1）远程sftp获取

    如果客户搭建的SFTP服务和回单服务器不在同一台机器，那么回单获取方式请选择【远程sftp获取】，如下图所示，需要配置SFTP服务的“IP”、“端口”、“用户名”、“密码”点【连接测试】通过即可。

    若银行方推送的压缩包不在sftp根目录下，而是在子目录下，还需要配置“银行SFTP文件保存子路径”。

2）本机获取

    如果客户搭建的SFTP服务和回单服务器在同一台机器，那么回单获取方式请选择【本机获取】，如下图所示，压缩包推送的目录配置到“银行回单推送路径”里。

四、回单调度方式及任务的[创建]->[预处理] ->[下载] ->[扫描]阶段

1、北京银行直联版电子回单调度方式

    需要跟银行方了解一下推送的压缩包的时间，这个推送时间会影响到调度的配置。

    比如，某客户咨询银行方，答复是：北京银行推送电子回单时间在上午十点左右，一般不会超过十点半，时间不能提前。那么，北京银行直联版电子回单调度方式建议选择【自定义】，预处理调度的开始时间也需要调整为每天11点开始，参考下面截图继续配置：

2、[创建]任务调度

    系统会自动创建所有电子回单账号的前一天的回单任务。

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

3、[预处理]任务调度

    在预处理任务调度阶段，会根据任务的账号和日期，获取到回单文件名。预处理任务完成后，可以点【详情】查看文件名，如下图所示：

    具体来讲，如下：

首先，用户登录（CebankUserLogonOp）成功并获取sessionId；

然后，调用查询电子回单接口CebankQueryBillNumOp获取回单数量，请求和响应报文如下：

2024-08-07 10:02:02.118  INFO [BJB_DC,,1821003620942872576] 11624 --- [pool-3-thread-2] c.kingdee.bos.bank.bjb.dc.utils.SSLUtil : 第1获取回单清单信息的请求信息requestStr：opName=CebankQueryBillNumOp&reqData=<?xml version="1.0" encoding="GB18030"?>
<BCCBEBankData>
    <opReq>
        <opName>CebankQueryBillNumOp</opName>
        <serialNo>1722996122118</serialNo>
        <reqTime>20240807</reqTime>
        <ReqParam>
            <accountNo>2xxxxxxxxxxxxxxxxxxxxxxxx1</accountNo>
            <billNumber></billNumber>
            <beginDate>20240806</beginDate>
            <endDate>20240806</endDate>
            <beginAmt>0.00</beginAmt>
            <endAmt>999999999999.00</endAmt>
            <turnPageBeginPos>1</turnPageBeginPos>
            <turnPageShowNum>999</turnPageShowNum>
        </ReqParam>
    </opReq>
</BCCBEBankData>
2024-08-07 10:02:02.651  INFO [BJB_DC,,1821003620942872576] 11624 --- [pool-3-thread-2] c.kingdee.bos.bank.bjb.dc.utils.SSLUtil : 第1获取回单清单信息的响应信息responseStr：<?xml  version="1.0" encoding="GB2312" ?>
<BCCBEBankData>
    <opRep>
        <opName>CebankQueryBillNumOp</opName>
        <retCode>0</retCode>
        <errMsg></errMsg>
        <opResult>
            <turnPageBeginPos>1</turnPageBeginPos>
            <turnPageShowNum>999</turnPageShowNum>
            <turnPageTotalNum>1</turnPageTotalNum>
        </opResult>
        <opResultSet>
            <opResult>
                <businessType>XXXXX