【电子回单】中原银行直连版(ZYB_DC)回单配置指南
中原银行推送回单的方式,是发请求银行返回文件流。具体来讲,是金蝶电子回单代理程序向中原银行前置机发送回单下载的请求,银行前置机将请求转发给银行,银行收到请求后将回单文件的base64字符串文件流通过前置机返回给回单程序,电子回单程序将回单文件的文件流转成文件存在本地。因不需进行PDF文件的传输,索引不需要配置银行SFTP服务。
一、回单代理程序 - 配置项 - 银行配置
在回单代理程序 - 配置项 - 系统配置页面的“启用银行插件列表”中,勾选“中原银行直连版(ZYB_DC)”后保存,切换到 银行配置 页面,下拉列表就可以选择到这个银行插件了。从界面可以看到,配置项比较少,
银行前置机IP地址 —— 中原银行前置机所在服务器的IP地址
银行前置机端口 —— 中原银行前置机所在服务的端口号
电子回单程序IP —— 交易接口请求报文头要求上送客户机IP(WsId),即电子回单服务器的IP地址
前置机密码 —— 在请求URL中需要拼接userPassword
其中,银行前置机IP地址、端口、前置机密码,也可以参考银企平台 - 系统管理 - 前置机配置页面进行配置,如下图所示:
二、任务的[创建]->[预处理] ->[下载] ->[扫描]阶段
为了快速的看到效果,可以在[配置项 - 银行配置]页面,将“中原银行直连版电子回单调度方式”修改为“测试使用”(测试调度仅需要大约4分钟就可以完成一次调度)。修改并保存后,在“模块管理”页面重启【回单模块】生效。
1. 创建调度
自动创建所有回单账号的前一天的回单任务。
刚部署的情况下是没有任务的,可以手动添加一个任务进行测试。如下图所示,点【+添加任务】按钮进行添加。
2. 预处理调度
首先,调用账户交易明细查询接口05B2EActTrsQry,根据银行账号AcNo、交易日期(最大查询范围为当前时间往前推一年以内数据)、
获取到业务参考号Reference、借贷标志DCFlag、发生额Amount等信息。
请求方式http://ProxyIP:ProxyPort/b2e/05B2EActTrsQry.do?userPassword=******&SIGDATA=0
然后,调用电子回单下载接口B2EEleReceiptPrintDetailPrint,根据银行账号AcNo、交易日期、业务类型OpType(0:业务参考号)、打印类型Flag(2:打印手续费支出回单和转账回单)、交易编号SeqNo(OpType=0时,送业务参考号,即账户交易明细查询接口05B2EActTrsQry返回的<Reference>),获取到文件名FileName、文件内容FileContent(返回文件的base64编码串)。
请求方式http://ProxyIP:ProxyPort/b2e/B2EEleReceiptPrintDetailPrint.do?userPassword==******&&SIGDATA=0&_PrintCurrentPage='1'&_Download=pdf&_MultiReports=false&_HidePdfToolBar=false&_ForbidPdfPrint=false"
最后,对于下载下来的回单文件重命名,命名规则为“银行账号_交易日期_业务参考号_借贷标识_金额.pdf”,并将其保存到\tempPath\ZYB_DC目录下。
账户交易明细查询请求(05B2EActTrsQry)的请求和响应报文如下:
2024-04-19 17:45:00.086 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 中原银行账户交易明细查询请求(05B2EActTrsQry):<?xml version="1.0" encoding="GBK"?> <Message> <Sys_Head> <TrsCode>05B2EActTrsQry</TrsCode> <ERPTrsTimestamp>20240419174500086</ERPTrsTimestamp> <ERPJnlNo>45366431713519900086</ERPJnlNo> <WsId>xxx.xxx.xxx.xxx</WsId> </Sys_Head> <Body> <AcNo>4xxxxxxxxxxxxxxxxxx2</AcNo> <BeginDate>20240311</BeginDate> <EndDate>20240311</EndDate> <Total_Num>-1</Total_Num> <Current_Num>0</Current_Num> </Body> </Message> 2024-04-19 17:45:01.245 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 中原银行账户交易明细查询响应(05B2EActTrsQry):<?xml version="1.0" encoding="GBK"?> <Reply_Msg> <Sys_Head> <ReturnCode>000000</ReturnCode> <ReturnMsg></ReturnMsg> </Sys_Head> <Body> <RecordNumber>2</RecordNumber> <List> <Row> <SeqNo>6497554893</SeqNo> <TransDate>2024-03-11</TransDate> <TransTime>16:53:09</TransTime> <EffectDate>2024-03-11</EffectDate> <Currency>CNY</Currency> <DCFlag>D</DCFlag> <Amount>-99000000.00</Amount> <Balance>********</Balance> <TranDesc>********</TranDesc> <TranType>A200</TranType> <TranNote></TranNote> <Remark>********</Remark> <OtherAcNo>4xxxxxxxxxxxxxxxxxx9</OtherAcNo> <OtherName>xxxxxxxxxxxx有限公司</OtherName> <OthBankName>兴业银行xxxxxxxxxxx支行</OthBankName> <Reference>TLE24031101193700110</Reference> <TrsChannel>网上银行</TrsChannel> <SubAcctNo></SubAcctNo> <SubAcctName></SubAcctName> </Row> <Row> <SeqNo>6497466919</SeqNo> <TransDate>2024-03-11</TransDate> <TransTime>16:35:27</TransTime> <EffectDate>2024-03-11</EffectDate> <Currency>CNY</Currency> <DCFlag>D</DCFlag> <Amount>99000000.00</Amount> <Balance>********</Balance> <TranDesc>汇出汇款</TranDesc> <TranType>A100</TranType> <TranNote>********</TranNote> <Remark>********</Remark> <OtherAcNo>4xxxxxxxxxxxxxxxxxx9</OtherAcNo> <OtherName>4xxxxxxxxxxxxxxxxxx9</OtherName> <OthBankName>兴业银行xxxxxxxxxxx支行</OthBankName> <Reference>IBS24031115541132201</Reference> <TrsChannel>网上银行</TrsChannel> <SubAcctNo></SubAcctNo> <SubAcctName></SubAcctName> </Row> </List> </Body> </Reply_Msg> 2024-04-19 17:45:01.245 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.bos.bank.zyb.dc.utils.ResponsePars : 读取到报文中reference = TLE24031101193700110,并添加进list中 2024-04-19 17:45:01.245 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.bos.bank.zyb.dc.utils.ResponsePars : 读取到报文中reference = IBS24031115541132201,并添加进list中
电子回单下载请求(B2EEleReceiptPrintDetailPrint)的请求和响应报文如下:
2024-04-19 17:45:01.245 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 要拼入报文的Reference = TLE24031101193700110 2024-04-19 17:45:01.245 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.bos.bank.zyb.dc.utils.RequestPack : receiptRequest中的Reference = TLE24031101193700110 2024-04-19 17:45:01.260 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.bos.bank.zyb.dc.utils.RequestPack : 已拼装进SeqNo 2024-04-19 17:45:01.260 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 中原银行电子回单下载请求(B2EEleReceiptPrintDetailPrint):<?xml version="1.0" encoding="GBK"?> <Message> <Sys_Head> <TrsCode>B2EEleReceiptPrintDetailPrint</TrsCode> <ERPTrsTimestamp>20240419174501260</ERPTrsTimestamp> <ERPJnlNo>61546921713519901260</ERPJnlNo> <WsId>xxx.xxx.xxx.xxx</WsId> </Sys_Head> <Body> <AcNo>4xxxxxxxxxxxxxxxxxx2</AcNo> <BeginDate>20240311</BeginDate> <EndDate>20240311</EndDate> <OpType>0</OpType> <Flag>2</Flag> <SeqList> <Row> <SeqNo>TLE24031101193700110</SeqNo> </Row> </SeqList> </Body> </Message> 2024-04-19 17:45:02.435 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 中原银行电子回单下载响应(B2EEleReceiptPrintDetailPrint):<?xml version="1.0" encoding="GBK"?> <Reply_Msg> <Sys_Head> <ReturnCode>000000</ReturnCode> <ReturnMsg></ReturnMsg> </Sys_Head> <Body> <FileName>B2EEleReceiptPrintDetailPrint_20240419054501.pdf</FileName> <FileContent>JVBERi0*****************MzkwMAolJUVPRgo=</FileContent> </Body> </Reply_Msg> 2024-04-19 17:45:02.451 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 回单文件:4xxxxxxxxxxxxxxxxxx2_20240311_TLE24031101193700110_D_-99000000.00.pdf成功生成到:D:\yhhd\tempPath\ZYB_DC 2024-04-19 17:45:02.451 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 要拼入报文的Reference = IBS24031115541132201 2024-04-19 17:45:02.451 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.bos.bank.zyb.dc.utils.RequestPack : receiptRequest中的Reference = IBS24031115541132201 2024-04-19 17:45:02.451 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.bos.bank.zyb.dc.utils.RequestPack : 已拼装进SeqNo 2024-04-19 17:45:02.451 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 中原银行电子回单下载请求(B2EEleReceiptPrintDetailPrint):<?xml version="1.0" encoding="GBK"?> <Message> <Sys_Head> <TrsCode>B2EEleReceiptPrintDetailPrint</TrsCode> <ERPTrsTimestamp>20240419174502451</ERPTrsTimestamp> <ERPJnlNo>49014081713519902451</ERPJnlNo> <WsId>xxx.xxx.xxx.xxx</WsId> </Sys_Head> <Body> <AcNo>4xxxxxxxxxxxxxxxxxx2</AcNo> <BeginDate>20240311</BeginDate> <EndDate>20240311</EndDate> <OpType>0</OpType> <Flag>2</Flag> <SeqList> <Row> <SeqNo>IBS24031115541132201</SeqNo> </Row> </SeqList> </Body> </Message> 2024-04-19 17:45:03.501 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 中原银行电子回单下载响应(B2EEleReceiptPrintDetailPrint):<?xml version="1.0" encoding="GBK"?> <Reply_Msg> <Sys_Head> <ReturnCode>000000</ReturnCode> <ReturnMsg></ReturnMsg> </Sys_Head> <Body> <FileName>B2EEleReceiptPrintDetailPrint_20240419054502.pdf</FileName> <FileContent>JVBERi0xL********************0CiUlRU9GCg==</FileContent> </Body> </Reply_Msg> 2024-04-19 17:45:03.517 INFO [ZYB_DC,,1775066554128400384] 5512 --- [pool-3-thread-45] c.k.b.bank.zyb.dc.job.ZybDcFetchListJob : 回单文件:4xxxxxxxxxxxxxxxxxx2_20240311_IBS24031115541132201_D_99000000.00.pdf成功生成到:D:\yhhd\tempPath\ZYB_DC
预处理调度结束后,任务变成“预处理完成”状态,此时点击【详情】可以查看回单文件的名称:
3. 下载调度
在下载调度阶段,将\tempPath\ZYB_DC目录下的回单移动到扫描工作路径\scanPath\ZYB_DC下。至此,下载任务结束。
4. 扫描调度
在扫描调度阶段,对\scanPath\ZYB_DC目录下的回单进行扫描,解析出结构化数据保存到回单库的表中,同时将回单文件移动到备份目录\bakPath\ZYB_DC下。扫描调度结束后,可点击回单任务的【结果】查看回单的结构化数据。
【电子回单】中原银行直连版(ZYB_DC)回单配置指南
本文2024-09-22 20:17:29发表“eas cloud知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-eas-112679.html