电脑桌面
添加蚂蚁七词文库到电脑桌面
已经有10万+用户把蚂蚁七词文库添加到电脑桌面，以后点击桌面图标一键打开，无需搜索，非常快捷！
上传文档
开通会员限时优惠
充值
登录  |  注册
首页文章金蝶知识文章eas cloud知识【电子回单】光大银行直连版（CEB_DC）回单配置指南

【电子回单】光大银行直连版（CEB_DC）回单配置指南

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

【电子回单】光大银行直连版（CEB_DC）回单配置指南

    电子回单程序向光大前置机发送回单查询和下载的请求，银行收到请求后将回单文件推送到前置机上的指定目录downloads中，电子回单程序再通过事先安装在光大银行前置机上的SFTP下载回单文件。

一、回单代理程序 - 配置项 - 银行配置

1. 前置机配置信息和银行业务配置信息

  • 银行前置机IP地址

  • 银行前置机端口

  • 客户号

  • 操作员号

  • 通讯密码

    以上配置信息请参考银企平台 - 系统管理 - 前置机配置页面，选择“光大银行直联版(CEB_DC)”的配置，如下图所示：

2. 回单获取方式

    20230106版本的回单平台，光大银行的回单获取方式不支持“本机获取”（即使光大银行前置机和电子回单代理程序在同一台机器；在20230720版本已优化，当光大银行前置机和电子回单代理程序在同一台机器时，支持“本机获取”，“银行回单推送路径”配置为光大银行前置机安装路径的downloads目录）

    回单获取方式选择“远程sftp”获取。在光大银行前置机这台机器上，搭建sftp服务，可以参考回单部署文档的第五章 附录操作。注意，SFTP服务的根路径配置为光大银行前置机安装路径的downloads目录（根目录不支持中文）。搭建SFTP服务后，把SFTP服务的IP、端口、用户名、密码，配置到这里：

3. 回单文件格式

    支持PDF和OFD两种回单文件格式，默认是PDF格式。

4. 银企交易明细查询接口是否是'b2e004002'接口

这里选择的交易明细查询接口要跟银企平台-银行业务配置页面选择的接口保持一致：

5. 回单下载请求的间隔时间

6. 是否获取当日回单

    获取当日回单功能，能够下载当天的回单文件，如果选择"是"请对下方【[当日回单创建]任务调度配置】进行设置。



二、[创建]任务调度—— 创建光大银行的回单任务

    自动创建所有回单账号的前一天的回单任务。

    刚部署的情况下是没有任务的，可以手动添加一个任务进行测试。如下图所示，点【+添加任务】按钮进行添加。

三、[预处理]任务调度

    在预处理任务调度阶段，会根据任务的账号和日期，获取到回单文件名（单个文件或文件列表）。

1. 回单文件格式：PDF

第一步：发b2e005023请求获取回单号

    电子回单代理程序向光大银行前置机发起回单信息查询请求，接口b2e005023（operationType 0-查询），获取到回单号BillNumber

    请求和响应报文如下：

光大银行——回单信息查询请求：<?xml version="1.0" encoding="GBK"?>
<Transaction>
    <SystemHead>
        <Language></Language>
        <Encodeing></Encodeing>
        <Version></Version>
        <ServiceName></ServiceName>
        <CifNo>2616338584</CifNo>
        <UserID>001</UserID>
        <SyMacFlag></SyMacFlag>
        <MAC></MAC>
        <SyPinFlag></SyPinFlag>
        <PinSeed></PinSeed>
        <LicenseId></LicenseId>
        <Flag></Flag>
        <Note></Note>
    </SystemHead>
    <TransHead>
        <TransCode>b2e005023</TransCode>
        <BatchID>26163385842023032806362880</BatchID>
        <JnlDate>20230328</JnlDate>
        <JnlTime>200100</JnlTime>
    </TransHead>
    <TransContent>
        <ReqData>
            <ClientPatchID>261633858420230328063628800001</ClientPatchID>
            <OperationType>0</OperationType>
            <BillNumber></BillNumber>
            <ActNo>35500188069279339</ActNo>
            <BeginDate>20230328</BeginDate>
            <EndDate>20230328</EndDate>
            <BeginAmount></BeginAmount>
            <EndAmount></EndAmount>
            <BeginNum>1</BeginNum>
            <QueryNum>50</QueryNum>
        </ReqData>
    </TransContent>
</Transaction>

光大银行——回单信息查询响应：<?xml version="1.0" encoding="GB2312"?>

<Transaction xmlns="http://www.cebbank.com/wangshangyh/ebankToBiz" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.cebbank.com/wangshangyh/ebankToBiz schema_v0.5.5.xsd">
	<SystemHead>
		<Language></Language>
		<Encodeing></Encodeing>
		<Version></Version>
		<ServiceName></ServiceName>
		<CifNo>2616338584</CifNo>
		<UserId>001</UserId>
		<SyMacFlag></SyMacFlag>
		<MAC></MAC>
		<SyPinFlag></SyPinFlag>
		<PinSeed></PinSeed>
		<LicenseId></LicenseId>
		<Flag></Flag>
		<Note></Note>
	</SystemHead>

<TransHead>
	<TransCode>b2e005023</TransCode>
	<BatchID>B2EQUERY000206951421</BatchID>
	<JnlDate>2023-03-28</JnlDate>
	<JnlTime>2023-03-28 20:01:17.91</JnlTime>
	<response1></response1>
	<response2></response2>
	<response3></response3>
</TransHead>
	<TransContent>
		<ReturnCode>0000</ReturnCode>
		<ReturnMsg>交易成功</ReturnMsg>
		<ReturnNote></ReturnNote>
		<TotalNum>1</TotalNum>
		<BatchRespList>
			
				<RespData>
				  	<BillNumber>202303289013120215080000000001</BillNumber>
					<WriteDate>20230328</WriteDate>
					<AcName2>中国银行对公户</AcName2>
					<AcBankName2>104100000004</AcBankName2>
					<AcNo2>6230521111111111111</AcNo2>
					<AcName>广西机场</AcName>
					<AcNo>35500188069279339</AcNo>
					<AcBankName>北京分行本部</AcBankName>
					<Amount>24.00</Amount>
					<purpose>电子回单查询测试－KDgsiup31l@</purpose>
					<FlowNumber>901312021508</FlowNumber>
					<ValidateCode>3072287B638BED23</ValidateCode>
					<BillQueryCode></BillQueryCode>
					<ClientPatchID>261633858420230328063628800001</ClientPatchID>
				  	<respond1>0</respond1>
					<respond2></respond2>
					<respond3></respond3>
					<respond4></respond4>
					<respond5></respond5>
			  	</RespData>
		  	
	  	</BatchRespList>
	</TransContent>
</Transaction>

第二步：发b2e005023请求获取文件名

     电子回单代理程序向光大银行前置机发起回单文件名查询请求，接口b2e005023（operationType 1-文件生成），获取到文件名fileName

    请求和响应报文如下：

光大银行——回单文件名查询请求：<?xml version="1.0" encoding="GBK"?>
<Transaction>
    <SystemHead>
        <Language></Language>
        <Encodeing></Encodeing>
        <Version></Version>
        <ServiceName></ServiceName>
        <CifNo>2616338584</CifNo>
        <UserID>001</UserID>
        <SyMacFlag></SyMacFlag>
        <MAC></MAC>
        <SyPinFlag></SyPinFlag>
        <PinSeed></PinSeed>
        <LicenseId></LicenseId>
        <Flag></Flag>
        <Note></Note>
    </SystemHead>
    <TransHead>
        <TransCode>b2e005023</TransCode>
        <BatchID>26163385842023032833721344</BatchID>
        <JnlDate>20230328</JnlDate>
        <JnlTime>200200</JnlTime>
    </TransHead>
    <TransContent>
        <ReqData>
            <ClientPatchID>261633858420230328337213440001</ClientPatchID>
            <OperationType>1</OperationType>
            <BillNumber>202303289013120215080000000001</BillNumber>
            <ActNo>35500188069279339</ActNo>
            <BeginDate>20230328</BeginDate>
            <EndDate>20230328</EndDate>
            <BeginAmount></BeginAmount>
            <EndAmount></EndAmount>
            <BeginNum>1</BeginNum>
            <QueryNum>1</QueryNum>
        </ReqData>
    </TransContent>
</Transaction>

光大银行——回单文件名查询响应：<?xml version="1.0" encoding="GB2312"?>
<Transaction xmlns="http://www.cebbank.com/wangshangyh/ebankToBiz" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://www.cebbank.com/wangshangyh/ebankToBiz schema_v0.5.5.xsd">
	<SystemHead>
		<Language></Language>
		<Encodeing></Encodeing>
		<Version></Version>
		<ServiceName></ServiceName>
		<CifNo>2616338584</CifNo>
		<UserId>001</UserId>
		<SyMacFlag></SyMacFlag>
		<MAC></MAC>
		<SyPinFlag></SyPinFlag>
		<PinSeed></PinSeed>
		<LicenseId></LicenseId>
		<Flag></Flag>
		<Note></Note>
	</SystemHead>

<TransHead>
	<TransCode>b2e005023</TransCode>
	<BatchID>B2EQUERY000206951987</BatchID>
	<JnlDate>2023-03-28</JnlDate>
	<JnlTime>2023-03-28 20:02:18.199</JnlTime>
	<response1></response1>
	<response2></response2>
	<response3></response3>
</TransHead>
	<TransContent>
		<ReturnCode></ReturnCode>
		<ReturnMsg></ReturnMsg>
		<ReturnNote></ReturnNote>
			<RespData>
				<ClientPatchID>261633858420230328337213440001</ClientPatchID>
			  	<fileName>2616338584_20230328200218.pdf</fileName>
			  	<respond1></respond1>
				<respond2></respond2>
				<respond3></respond3>
				<respond4></respond4>
				<respond5></respond5>
		  	</RespData>
	</TransContent>
</Transaction>

    

    预处理任务完成后，可以点【详情】查看文件名，如下图所示：


2. 回单文件格式：OFD

第一步：通过b2e004032接口，根据账号、交易日期等信息，发起电子回单文件预约申请请求；

第二步：返回交易成功（ReturnCode=0000）且预约成功（Flag=0）后，再通过b2e004034接口发起电子回单文件预约结果查询请求，获取到文件名FileName和文件路径FilePath；

第三步：根据文件名和文件路径，发起电子回单下载（downloadFile）请求。

    请求报文：

 http://光大银行前置机IP:端口/ent/downloadFile.do?userPassword=123456&transcode=b2e004034&fileName=fileName=35030188011164119202111148700008786709899019.zip&filePath=STORAGE/batch/tft/20211114/

    成功返回：

<?xml version="1.0" encoding="GBK"?>

<transaction>

<success>350xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx19.zip</success>

</transaction>

    此时，银行服务器会推送名称为350xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx19.zip的压缩包到光大银行前置机的downloads/交易日期yyyyMMdd/目录下，zip文件解压后就是ODF格式的回单文件。

四、[下载]任务调度

1. 回单文件格式：PDF

第一步：根据预处理调度返回的文件名发起电子回单下载请求（downloadFile） 

    在下载阶段，建立SFTP连接之后，首先在checkBeforeDownload()方法中统一发送所有生成回单的请求,有几条交易明细就发送几次生成文件的请求，请求如下：

http://光大银企前置机IP:端口/ent/downloadFile.do?userPassword=123456&transcode=b2e005023&fileName=2616338584_20230328200218.pdf

  响应报文类似下面这样：

光大银行——回单文件下载响应：<?xml version="1.0" encoding="GBK"?>

<transaction>

<success>2616338584_20230328200218.pdf</success>

</transaction>

    此时，会在光大银行前置机安装目录下生成downloads目录（一开始downloads目录是不存在的），并在其下按交易日期创建目录，目录下是生成的PDF回单文件。


第二步：切换到SFTP目录下载文件

    切换到sftp目录：/2023-03-28下，下载文件2616338584_20230328200218.pdf到回单文件下载保存根目录的tempPath\CEB_DC\下并重命名文件（文件名规则：账号_交易日期_回单号_金额.pdf）。

    下载文件成功后，关闭SFTP连接成功，然后把\tempPath\CEB_DC\35500188069279339_20230328_202303289013120215080000000001_24.00.pdf 文件移动到\scanPath\CEB_DC\下。

    下载任务结束。

2. 回单文件格式：OFD

    建立SFTP连接之后，切换到sftp目录：/交易日期yyyymmdd 下，下载.zip压缩包到回单文件下载保存根目录的tempPath\CEB_DC\下，解压后对OFD回单文件进行重命名，然后把重命名后的文件移动到\scanPath\CEB_DC\下。

五、[扫描]任务调度

    对下载到scanPath目录的文件进行扫描，解析出结构化数据保存到回单库的表中（主要是这两个表：t_receipt_detail、t_receipt_info ），同时将文件保存到bakPath目录下。扫描调度结束后，可点击回单任务的【结果】查看回单的结构化数据。

    下图所示为PDF格式回单的【结果】页面：


六、常见问题

1. 银企平台 - 业务管理 - 银行业务配置 - 回单获取方式

    光大银行支持两种格式的回单：报文、文件。如果客户要下载的是文件格式的回单，那在部署回单代理程序、配置并下载中国银行的回单之后，还要在银企平台 - 业务管理 - 银行业务配置页面把“回单获取方式”设置为“文件”，重启银企服务生效。

【电子回单】光大银行直连版（CEB_DC）回单配置指南

电子回单程序向光大前置机发送回单查询和下载的请求，银行收到请求后将回单文件推送到前置机上的指定目录downloads中，电子回单程序再...
点击下载文档
标签： # EAS Cloud# 常见问题# 快速入门# 银企平台# 电子回单程序
分享：
上一篇：回单代理程序前端环境配置下一篇：苏州银行回单插件部署指导
本文2024-09-22 20:17:36发表“eas cloud知识”栏目。
本文链接：https://wenku.my7c.com/article/kingdee-eas-112690.html
最新文档
热门文章

阅读排行

热门标签
# 常见问题# 企业版/标准版# 财务会计# EAS Cloud# K3 WISE# 功能介绍# 基础入门# 快速入门# s-HR# 金蝶云星瀚# 供应链# 金蝶云·星辰# 推送至苍穹帮助中心# 金蝶云·星空# 金蝶云·苍穹# 高级技巧# 新特性# 总账# 金蝶云·星空实施# 旗舰版
一键复制下载文档联系客服
确认删除?
取消确定
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息