【电子回单】中原银行直连版(ZYB_DC)回单配置指南

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

【电子回单】中原银行直连版(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)回单配置指南

中原银行推送回单的方式,是发请求银行返回文件流。具体来讲,是金蝶电子回单代理程序向中原银行前置机发送回单下载的请求,银行前置机...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息