【电子回单】光大银行直连版（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>