【电子回单】渤海银行直连版（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
【电子回单】渤海银行直连版（CBHB_DC）回单配置指南
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
