【电子回单】渤海银行直连版（CBHB_DC）回单配置指南
渤海银行直连版（CBHB_DC），是发请求银行推送回单文件的方式。配置步骤如下：
第一步：在[配置项 - 系统配置]页面启用银行插件
登录回单系统，在[配置项 - 系统配置]页面启用银行插件列表中，勾选“渤海银行直连版（CBHB_DC）”，并保存。
第二步：在[配置项 - 银行配置]页面配置相关信息
一般情况下，在配置电子回单的时候，银企平台这边已经配置好了（也就是说已经可以正常查询交易明细、余额了），那我们可以参考银企平台 - 系统管理 - 前置机配置页面中“渤海银行直连版(CBHB_DC)”的配置去配置回单平台中银行配置页面的信息，主要是下面三项：
银行前置机IP地址
银行前置机端口
客户号
第三步：回单获取方式
如果回单平台和渤海银行前置机软件在同一台机器，可以直接【本机获取】。银行服务器会把回单推送到渤海银行前置机参数配置页面的【文件下载路径】下。所以，回单平台这里，银行回单推送路径配置也要配置为下图中的这个“文件下载路径”。
例如，某客户的渤海银行前置机配置的文件下载路径为“E:/bhshchagent/sh64/bhshchagentdownload”，那么如下图所示，银行回单推送路径就这样配置：
如果回单平台和渤海银行前置机软件不在同一台机器，可以通过银行sftp获取，回单获取方式选择【远程sftp获取】。那么客户需要在渤海银行前置机上搭建一个sftp服务，根目录配置为渤海银行前置机的参数配置页面的【文件下载路径】，并确保回单代理程序能访问该SFTP服务。搭建好sftp服务之后，在银行配置页面进行配置。
第四步：银行接口版本
旧版接口：需要将本方账号作为付款方和收款方账号分别查询回单
新版接口：只需要通过本方账号就可以进行查询所有交易的回单。
第五步：任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
为了快速的看到效果，可以在[配置项 - 银行配置]页面，将“渤海银行直联版电子回单调度方式”修改为“测试使用”（测试调度仅需要大约4分钟就可以完成一次调度）。修改并保存后，在[模块管理]页面重启【回单模块】生效。
1、创建调度
自动创建所有回单账号的前一天的回单任务。
刚部署的情况下是没有任务的，可以手动添加一个任务进行测试。如下图所示，点【+添加任务】按钮进行添加。注意：不要添加今日的任务，因为这个银行插件不支持当日回单下载。
2、预处理调度
1）根据任务的银行账号、回单日期，调用电子回单流水查询（交易码EDSQ01）接口，获取到打印流水号PrintTaskId 和 凭证种类Vouch_Type（渤海银行都有哪些凭证种类，可以看一下接口文档，这里不详述）。
接口的请求和响应报文大概如下：
2023-11-07 15:59:00.193 INFO [CBHB_DC,,1721458912563036160] 9100 --- [pool-3-thread-3] c.k.bos.bank.cbhb.dc.job.CbhbDcFetchJob : 渤海银行——电子回单流水查询请求（EDSQ01）：<?xml version="1.0" encoding="GBK"?> <CBHB> <head> <Locale>zh_CN</Locale> <RequestTime>20231107155900</RequestTime> <RespondTime></RespondTime> <UserId></UserId> <CifNo>2xxxxxxxx3</CifNo> <TransCode>EDSQ01</TransCode> <ClientSeqno>1721799396011540480</ClientSeqno> <RecordIndex></RecordIndex> <RecordMax></RecordMax> <BankSeqno></BankSeqno> <RespondCode></RespondCode> <RespondInfo></RespondInfo> <RecordTotal></RecordTotal> <RecordCount></RecordCount> <TransPatches></TransPatches> </head> <body> <BeginDate>20231031</BeginDate> <EndDate>20231031</EndDate> <AccountNo>2xxxxxxxxxxxxxxx7</AccountNo> <PageNo>1</PageNo> <NumOfPage>10</NumOfPage> <VunchType></VunchType> </body> </CBHB> 2023-11-07 15:59:01.831 INFO [CBHB_DC,,1721458912563036160] 9100 --- [pool-3-thread-3] c.k.bos.bank.cbhb.dc.job.CbhbDcFetchJob : 渤海银行——电子回单流水查询响应（EDSQ01）： <?xml version="1.0" encoding="GBK"?> <CBHB> <head> <Locale>zh_CN</Locale> <RequestTime>20231107155900</RequestTime> <RespondTime>20231107155901</RespondTime> <UserId></UserId> <CifNo>2000395703</CifNo> <TransCode>EDSQ01</TransCode> <ClientSeqno>1721799396011540480</ClientSeqno> <RecordIndex></RecordIndex> <RecordMax></RecordMax> <BankSeqno>2023110797150540</BankSeqno> <RespondCode>000000</RespondCode> <RespondInfo>程序执行正常!</RespondInfo> <RecordTotal>24</RecordTotal> <RecordCount>10</RecordCount> <TransPatches></TransPatches> </head> <body> <PrintTaskList> <Record> <PrintTaskId>04762023103116369183</PrintTaskId> <Amount>51.91</Amount> <PayErAccNo>2xxxxxxxxxxxxxxx7</PayErAccNo> <PayErAccName></PayErAccName> <PayEeAccNo>2xxxxxxxxxxxxxxx7</PayEeAccNo> <PayEeAccName></PayEeAccName> <Trade_Date>20231031</Trade_Date> <Vouch_Type>SPS019</Vouch_Type> </Record> <Record> <PrintTaskId>04762023103116369182</PrintTaskId> <Amount>12847.16</Amount> <PayErAccNo>2xxxxxxxxxxxxxxx7</PayErAccNo> <PayErAccName></PayErAccName> <PayEeAccNo>2xxxxxxxxxxxxxxx7</PayEeAccNo> <PayEeAccName></PayEeAccName> <Trade_Date>20231031</Trade_Date> <Vouch_Type>SPS019</Vouch_Type> </Record> ……省略… </PrintTaskList> </body> </CBHB>
2）再调用电子回单明细文件查询（交易码EDSQ02）接口，根据EDSQ01返回的PrintTaskList 列表中的打印流水号PrintTaskId、凭证种类Vouch_Type，获取到文件获取路径PDFUrl 和 主机流水号HLOGN，再发送电子回单文件下载请求，交易成功后，渤海银行前置机的参数配置页面的 文件下载路径/当期日期/download/ 目录下会生成这个回单文件。
注意，回单程序暂时不支持下载OFD类型的回单（凭证种类：CBS039）。
接口的请求和响应报文大概如下：
2023-11-07 15:59:03.533 INFO [CBHB_DC,,1721458912563036160] 9100 --- [pool-3-thread-3] c.k.bos.bank.cbhb.dc.job.CbhbDcFetchJob : 渤海银行——电子回单明细文件查询请求（EDSQ02）：<?xml version="1.0" encoding="GBK"?> <CBHB> <head> <Locale>zh_CN</Locale> <RequestTime>20231107155903</RequestTime> <RespondTime></RespondTime> <UserId></UserId> <CifNo>2xxxxxxxx3</CifNo> <TransCode>EDSQ02</TransCode> <ClientSeqno>1721799410184093696</ClientSeqno> <RecordIndex></RecordIndex> <RecordMax></RecordMax> <BankSeqno></BankSeqno> <RespondCode></RespondCode> <RespondInfo></RespondInfo> <RecordTotal></RecordTotal> <RecordCount></RecordCount> <TransPatches></TransPatches> </head> <body> <PRINTTASKID>04762023103116369183</PRINTTASKID> <VOUCH_TYPE>SPS019</VOUCH_TYPE> </body> </CBHB> 2023-11-07 15:59:06.344 INFO [CBHB_DC,,1721458912563036160] 9100 --- [pool-3-thread-3] c.k.bos.bank.cbhb.dc.job.CbhbDcFetchJob : 渤海银行——电子回单明细文件查询响应（EDSQ02）： <?xml version="1.0" encoding="GBK"?> <CBHB> <head> <Locale>zh_CN</Locale> <RequestTime>20231107155903</RequestTime> <RespondTime>20231107155906</RespondTime> <UserId></UserId> <CifNo>2xxxxxxxx3</CifNo> <TransCode>EDSQ02</TransCode> <ClientSeqno>1721799410184093696</ClientSeqno> <RecordIndex></RecordIndex> <RecordMax></RecordMax> <BankSeqno>2023110797150653</BankSeqno> <RespondCode>000000</RespondCode> <RespondInfo>程序执行正常!</RespondInfo> <RecordTotal></RecordTotal> <RecordCount></RecordCount> <TransPatches></TransPatches> </head> <body> <RETCODE>000000</RETCODE> <RETMSG>PDFUrl生成成功！</RETMSG> <VOUCH_TYPE>SPS019</VOUCH_TYPE> <PRINTTASKID>04762023103116369183</PRINTTASKID> <HLOGN>5381977</HLOGN> <PDFUrl>fa4a1126-fedb-48be-959c-28b71a3ebaac1699343945262.pdf</PDFUrl> </body> </CBHB>
获取到渤海银行回单文件名：fa4a1126-fedb-48be-959c-28b71a3ebaac1699343945262.pdf 后，会发送下载请求，日志如下：
渤海银行——电子回单文件下载请求：fa4a1126-fedb-48be-959c-28b71a3ebaac1699343945262.pdf
建立连接...
渤海银行回单文件下载成功
（响应码只有：000000：成功，999999：失败，E20001：文件不存在）
3、下载调度
在下载调度阶段，回单平台通过远程sftp或者本机获取的方式将回单PDF文件从渤海银行前置机的bhshchagentdownload/当期日期/download/ 目录下，下载到回单服务器的\tempPath\CBHB_DC\目录下并将其重命名，命名规则为：银行账号-交易日期-主机流水号-交易金额.pdf；然后又将其移动到scanPath\CBHB_DC\目录下。下载任务结束。
4、扫描调度
对下载到scanPath目录的文件进行扫描，解析出结构化数据保存到回单库的表中，同时将文件保存到\bakPath\CBHB_DC\目录下。扫描调度结束后，可点击回单任务的【结果】查看回单的结构化数据。
【电子回单】渤海银行直连版（CBHB_DC）回单配置指南
本文2024-09-22 20:17:26发表“eas cloud知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-eas-112673.html
