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

栏目：eas cloud知识作者：金蝶来源：金蝶云社区发布：2024-09-22浏览：1

北京银行的电子回单，支持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>XXXXXXXX业务</businessType>
                <amtMax>人民币捌万元整</amtMax>
                <currencyType>01</currencyType>
                <billNumber>0910120240806WSYHE1306278</billNumber>
                <acctDate>2024-08-06</acctDate>
                <payAcct>2xxxxxxxxxxxxxxxxxxxxxxxx1</payAcct>
                <payAcctName>XXXXXXXXXXXX公司</payAcctName>
                <payBankName>XXX支行营业部</payBankName>
                <payBankOrgCode></payBankOrgCode>
                <recAcct>1xxxxxxxxxxxxx1</recAcct>
                <recAcctName>XXXXXXXXXXXXXXXX公司</recAcctName>
                <recBankName>招商银行股份有限公司XXXXXXX支行</recBankName>
                <recBankOrgCode></recBankOrgCode>
                <amount>*******</amount>
                <summary>XXXXXXXXXXXX</summary>
                <lendingDirection>借方</lendingDirection>
                <promptMessage>请注意：1、电子回单可重复打印，请勿重复记账。2、电子回单不作为收款方的发货依据。3、本回单与本行原始记录不符的，以本行原始记录为准。</promptMessage>
                <checker></checker>
                <accountant>121</accountant>
                <businessTypeDetail></businessTypeDetail>
                <taxpayerCode></taxpayerCode>
                <taxTicketCode></taxTicketCode>
                <taxpayerName></taxpayerName>
                <levingInsitutation></levingInsitutation>
                <taxTradeNumber></taxTradeNumber>
                <gatheringName></gatheringName>
                <kernelNum>20240806000018101040000000000001</kernelNum>
                <channelNum>381700</channelNum>
                <remark1></remark1>
                <remark2></remark2>
                <remark3></remark3>
                <remark4></remark4>
            </opResult>
        </opResultSet>
    </opRep>
</BCCBEBankData>

最后，通过回单明细信息生成回单下载详情信息DownloadListDetail，包括以下内容：

旧的回单文件名：回单号billNumber.pdf
交易日期：
新的回单文件名，格式为：银行账号_交易日期_金额amount_回单号billNumber.pdf

4、[下载]任务调度

在下载调度阶段，回单程序通过远程sftp获取或者本机获取的方式，将银行推送的压缩包文件（根据当前任务回单日期，去匹配压缩包文件生成时间(年月日) ），下载到\tempPath\BJB_DC\目录下并解压；解压后把再把回单文件名“回单号.pdf” 修改为 “银行账号_交易日期_金额amount_回单号billNumber.pdf”并挪动到扫描目录\scanPath\BJB_DC\下。至此，下载任务结束，下载调度结束后任务状态显示为【下载完成】。