版权所有©1993-2019金蝶国际软件集团有限公司④内部公开请勿外传银企电子回单部署指导郑飞2021.12.272目录CONTENTS一、电子回单概述二、电子回单业务流程三、电子回单部署四、常见问题解析方法3①绝密信息严禁泄露电子回单概述1、电子回单：银行回执单，银行回执单是表明个人或单位在银行办理业务的一个有效凭证。银行回执单在发生交易流水后才会产生。2、电子回单代理程序：回单代理程序是一个高度依赖于银企平台的程序，作用是帮助银企平台下载文件格式(如PDF格式)的电子回单。使用前需搭建好银企平台。在回单代理程序完成下载任务后，就可以在银企平台查询到电子回单。电子回单支持银行及版本1中国银行NET版本(BOC_NET)pdf文件19内蒙古银行直联版pdf文件2中国农业银行农业银行公网版（ABC_DC）pdf文件20广州农商行直联版（GZRCB_DC）pdf文件3中国农业银行农业银行专线版（ABC_EB）pdf文件21华夏银行直联版(HXB_DC)报文格式（xml）4中国工商银行推广版（ICBC_CMP）pdf文件22中信银行中信银行直联版pdf文件5中国工商银行推广版（ICBC_CMP）报文格式（xml）23民生银行直联版(CMBC_DC)pdf文件6中国建设银行建设银行企业现金管理直连（CCB_CCIP）pdf文件24广发银行广发银行直联版pdf文件7中国建设银行中国建设银行外联版pdf文件25浙商银行浙商银行直联版pdf文件8中国交通银行交通银行直联版pdf文件26浦发银行浦发银行直联版pdf文件9邮政储蓄银行邮政储蓄银行直联版pdf文件27长安银行直联版pdf文件10平安银行直联版(PAB_DC)报文格式（xml）28长沙银行直联版pdf文件11平安银行直联版(PAB_DC)pdf文件29上海银行直联版pdf文件12招商银行招商银行直联版（CMB_DC）pdf文件30大连银行直联版pdf文件13招商银行招商银行无前置机版pdf文件31渤海银行直联版pdf文件14光大银行直联版(CEB_DC)报文格式（xml）32河北银行直联版pdf文件15光大银行直联版(CEB_DC)pdf文件33浙江农信社直联版pdf文件16兴业银行直联版(CIB_DC)报文格式（xml）34郑州银行直联版pdf文件17兴业银行直联版(CIB_DC)pdf文件35华兴银行直联版pdf文件18江苏银行现金管理平台（JSB_DC）pdf文件36沧州银行直联版pdf文件具体查询地址：http://web20.kingdee.com/eb_cloud_cnaps/banksupport5目录CONTENTS一、电子回单概述二、电子回单业务流程三、电子回单部署四、常见问题解析6①绝密信息严禁泄露电子回单流程1、银企平台直接请求前置机，返回回单报文，在ERP业务端配置套打模板，打印回单。2、电子回单首先是由银行服务器先推送或者请求推送到银行的前置机服务器上，再通过回单代理程序下载到回单代理程序所在的服务器（即客户的服务器）上，然后银企平台从回单代理程序上获取电子回单结构化数据，最后业务系统再通过银企平台来获取回单代理程序所在的服务器上的电子回单。7①绝密信息严禁泄露银行主动推送（需要搭建SFTP）电子回单主动推送银行汇总序号银行名称版本配置信息1中国农业银行中国农业银行公网版(ABC_DC)SFTP2中国农业银行专线版(ABC_EB)SFTP3建设银行建设银行企业现金管理直连(CCB_CCIP)SFTP3交通银行民生银行直连版(CMBC_DC)SFTP4广东发展银行广东发展银行直连版本(GDB_DC)SFTP5中国工商银行工商银行推广版(ICBC_CMP)SFTP6浦发银行浦发银行直连版(SPDB_DC)SFTP或WTocaP8①绝密信息严禁泄露电子回单流程1.准备阶段（1）询问银行会将回单文件推送至哪个目录（一般情况下是在前置机服务器上），以此目录为根目录搭建SFTP服务。需要确保银行方及回单程序都能访问该SFTP服务（2）将SFTP服务的“IP”“端口”“账号”“密码”配置到回单代理程序的银行配置的SFTP服务信息里2.下载阶段（1）银行在指定时间主动向SFTP服务推送回单文件（2）回单代理程序定时从SFTP服务上下载回单文件到回单程序服务器（即客户的服务器）*注意：浦发银行直连版(SPDB_DC)有些差异，可选择通过银行提供的wtp服务替代SFTP服务。需要联系银行协助搭建wtp服务，wtp服务必须和回单代理程序在同一台服务器上，无需配置wtp的信息，回单代理程序会自动找到本机搭建的wtp服务，从wtp服务获取文件。9①绝密信息严禁泄露电子回单流程电子回单发请求推送-银行SFTP银行汇总序号银行名称版本配置信息1中国农业银行中国农业银行公网版(ABC_DC)银行前置机、前置机上搭建SFTP2长沙银行长沙银行直连版（BCS_DC）银行前置机、前置机上搭建SFTP3中国银行（*特殊）中国银行BOCNET版本(BOC_NET)银行提供SFTP4内蒙古银行内蒙古银行银企直连版(BOIMC_DC)银行前置机、前置机上搭建SFTP5渤海银行渤海银行直联版（CBHB_DC）银行前置机、前置机上搭建SFTP6建设银行建设银行外联版(CCB_DC)银行前置机、前置机上搭建SFTP7光大银行光大银行直联版（CEB_DC）银行前置机、前置机上搭建SFTP8招商银行招商银行银企直连(CMB_DC)银行前置机、前置机上搭建SFTP9大连银行大连银行直连版（DLB_DC）银行前置机、前置机上搭建SFTP10广州农商银行广州农商银行直连版（GZRCB_DC）银行前置机、前置机上搭建SFTP11河北银行河北银行直连版（HBB_DC）银行前置机、前置机上搭建SFTP12平安银行平安银行直连版（PAB_DC）银行前置机、前置机上搭建SFTP13中国邮政储蓄银行中国邮政储蓄银行直连版(PSBC_DC)SFTP、银行前置机14浙江农信社浙江农信银行直连版（ZJRC_DC）银行前置机、前置机上搭建SFTP15浙商银行浙商银行直连版(ZSB_DC)银行前置机、前置机上搭建SFTP16郑州银行郑州银行直连版（ZZB_DC）银行前置机、前置机上搭建SFTP10①绝密信息严禁泄露电子回单流程1.准备阶段（1）询问银行会将文件推送至哪个目录（一般情况是在前置机服务器上），以此目录为根目录搭建好SFTP服务，需要确保银行方及回单代理程序都能访问该SFTP服务（2）将SFTP服务的“IP”“端口”“账号”“密码”配置到回单代理程序的银行配置的银行SFTP服务信息里（3）将银行前置机的“IP”“端口”配置到回单代理程序的银行配置的银行前置机信息里2.下载阶段（1）回单代理程序发送查询及下载回单的请求给银行前置机（2）银行前置机将请求转发给银行（3）银行收到请求后，给前置机返回回单的文件名等信息，前置机转发给回单代理程序，同时将回单文件推送到SFTP服务根目录（4）回单代理程序从SFTP服务上下载回单文件到回单代理程序服务器（即客户的服务器)*注意：中国银行BOCNET版本(BOC_NET)的回单文件下载流程与上述标准稍微有些差异，回单下载请求由银企平台发送而非回单代理程序。11①绝密信息严禁泄露电子回单流程电子回单发送请求银行返回文件流银行汇总序号银行名称版本配置信息1建设银行建设银行企业现金管理直连(CCB_CCIP)银行前置机2上海银行上海银行直连版（BOSH_DC）银行前置机3长安银行长安银行直连版（CABC_DC）银行前置机4中信银行中信银行直连版(CITICB_DC)银行前置机5招商银行招商银行无前置机版（CMB_CMP）银行前置机6民生银行民生银行直连版(CMBC_DC)银行前置机7兴业银行兴业银行直连版(CIB_DC)银行前置机8广东华兴银行广东华兴银行直联版（GHB_DC）银行前置机12①绝密信息严禁泄露电子回单流程1.准备阶段（1）将银行前置机的“IP”“端口”配置到回单代理程序的银行配置的银行前置机信息里。2.下载阶段（1）回单代理程序发送查询及下载回单的请求给银行前置机（2）银行前置机将请求转发给银行（3）银行收到请求后，将回单文件的base64字符串文件流返回给回单代理程序（4）回单代理程序解析并生成回单文件，放到回单代理程序服务器（即客户的服务器）13目录CONTENTS一、电子回单概述二、电子回单业务流程介绍三、电子回单部署四、常见问题解析141.设置银行前置机登录银企平台，在[系统管理-前置机配置]中选择需要添加前置机的银行，点击+添加配置，即可添加一个新的前置机。*注意：如果银企平台上配置多个前置机，则回单代理程序上也需要配置和银企平台顺序一样的多个前置机。银企平台配置15银企平台配置2.银企平台添加账号登录银企平台，在[业务管理-账号管理]中选择银行和银行版本并点击查询后，点击[+添加账号]，输入账号信息已及此账号对应的前置机号（登录配置编号为前置机选项）。163.设置电子回单账号登录银企平台，在[业务管理-账号管理]中点击需要使用回单功能的账号后的附加属性，将其设置为电子回单账号。在银企平台上被设置为电子回单账号的账号才可以被回单代理程序获取。*注意：从银企平台获取到的银行账号，如果其绑定的前置机为第n个前置机，那么回单代理程序上此账号也会绑定第n个前置机。因此要求回单代理程序配置的前置机信息顺序和银企平台的一致银企平台配置17回单代理程序数据库配置1.创建数据库支持数据库类型：mysql、sqlserver、oracle。数据库的编码集：mysql选择utf8mb4sqlserver排序规则选择Chinese_PRC_CI_ASoracle选择UTF82.配置数据库信息到回单代理程序启动数据库配置程序。Window系统下：start_Config.batLinux系统下：linux_start_Config.sh填写数据库配置信息，点击测试按钮，验证测试数据库是否能够正常连接成功。18回单代理程序数据库配置3.通过更改数据库配置文件更改数据库连接信息。（config文件夹下的application.yml文件）当数据库配置程序无法启动时，也可以直接用记事本打开数据库配置文件来更改并保存数据库配置。手动修改数据库方式配置数据库无法进行连接测试，需要特别注意参数配置的正确性。19回单代理程序启动与关闭1、启动：运行对应的启动程序。windows系统下：start_in_console.batlinux系统下：linux_startup.sh2、关闭：关闭运行的启动程序即可。20回单代理程序登录1、在浏览器里输入http://127.0.0.1:8089即可打开回单代理程序。（浏览器注意选择使用chrome或者firefox浏览器）默认的用户登录信息为：账号:kingdee密码:123456或者kingdee@2020（20210311以前的版本密码默认是123456；20210311版本及以后版本默认是kingdee2020）21回单代理程序配置1.银企平台信息配置回单代理程序需要依赖于银企平台，所以要在[回单-配置项-系统配置]页面填写银企平台所在服务器的“IP”“端口”，保存并且测试连接。电子回单代理程序安装目录下都配备“电子回单代理程序部署指南”并且回单的每个配置都有具体的“配置说明”，请使用前仔细阅读再进行配置！22回单代理程序配置2.下载路径配置(1).配置电子回单文件下载到本地的路径请在回单服务器本地手动创建一个用来存储回单文件的目录，路径为全英文！（如：c:/temp）(2).在[回单-配置项-系统配置]菜单页面里>>“回单文件下载保存根目录”配置项，填写上面创建的路径23回单代理程序配置3.回单程序SFTP配置回单平台SFTP：是回单代理程序自带的SFTP服务，提供给业务系统获取回单文件使用的。默认的账号：kingdee；密码：kingdee$2017（账号密码可以在安装目录下../config/application.yml文件中进行修改配置，见下页）回单SFTP服务的根目录：[回单-配置项-系统配置]的“回单文件下载保存根目录”配置路径回单SFTP服务的端口：[回单-配置项-系统配置]的“回单平台SFTP服务端口”配置的端口号配置完成后，需要在银企平台的[业务管理-全局业务配置]中填写“金蝶银企电子回单系统sftp的IP”：回单服务器实际IP，不能填写127.0.0.1“金蝶银企电子回单系统交互协议”：SFTP“金蝶银企电子回单系统IP”：回单服务器实际IP，不能填写127.0.0.124回单代理程序配置1、回单SFTP服务的账户名，密码配置模板因为文件是yml文件，所以有格式要求，配置是要严格按模板格式2、因为星空是在云端安装使用，所以在银企平台的全局业务配置中填写的sftp信息会区别于一般配置，具体见右图25回单代理程序配置4.选择要使用的银行在[回单-配置项-系统配置]中的"启用银行插件列表"勾选需要使用回单的银行版本并保存。(不使用的银行请勿开启)5.选择要使用的银行(1)在[回单-配置项-系统配置]中的"是否自动下载失败回单",启用后可以自动下载3-90天内下载失败的回单任务（目前3-90天的时间不可修改）(2)在[回单-配置项-系统配置]中的"回单完整度误差",回单文件数量与交易明细数量允许的最大误差，设置后超过此误差的回单任务能够在历史回单任务中自动重新下载(3)在[回单-配置项-系统配置]中的"回单平台预警邮箱",回单平台定时对前置机以及SFTP进行监控，发生连接失败的情况后，将通过邮件方式通知用户(4)在[回单-配置项-系统配置]中的"重新初始化元数据",针对老版本回单升级到新版本，数据库缺少字段等问题，一键初始化，更加方便26回单代理程序配置1.选择银行在[回单-配置项-银行配置]中，选择需要配置的银行版本（因各银行版本配置和推送不同，此PPT选取一个银行版本为例）。请先仔细阅读每个配置项的“配置说明”，再进行配置！其他银行配置可参考金蝶电子回单代理程序部署指南。½ðµûµç×ӻص¥´úÀí³ÌÐò²¿ÊðÖ¸ÄÏ(1).docx27回单代理程序配置（以工商银行推广版为例）2.银行信息配置[银行前置机配置信息]：填写银行前置机实际IP、端口和并发数，点击报存后再点击测试连接验证IP端口是否联通[回单获取方式]：默认为SFTP获取，在下面配置中配置SFTP的“IP”“端口”“用户名”“密码”等信息。回单代理程序会通过SFTP服务获取到银行推送的电子回单文件。如果银行推送文件的服务器和回单代理程序的服务器是同一台服务器，可以选择“本地获取”方式，并指定银行推送电子回单的文件目录。28回单代理程序配置[招商银行前置机登录用户名]：填写银行前置机的登录用户名[是否获取当日回单]：招商银行下载当日回单开关：打开后每隔半小时调度一次下载当日回单29回单代理程序配置3.银行调度配置[电子回单调度方式]的配置项，即执行任务的时间和频率，每个任务分为4个调度执行。（创建调度、预处理调度、下载调度、扫描调度）调度阶段解析：[创建]任务调度配置：根据回单创建回单任务，每个账号每天只会创建一个任务；[预处理]任务调度配置：根据任务的账号和日期，请求获取银行回单文件的文件名等信息；[下载]任务调度配置：根据预处理阶段获取的文件名去银行sftp根目录中下载回单文件;[扫描]任务调度配置：系统将下载到本地的回单文件解析出来并且存到数据库中，同时会将本地回单文件移动到回单备份目录下配置：“正式使用”：各任务执行时间间隔为1小时，主要是为了给交互和银行上传回单文件这些步骤准备充足的时间。“测试使用”：会将各任务的执行时间间隔缩小到1分钟。“自定义”:用户根据银行推送回单文件的时间自定义配置回单下载的时间30回单代理程序配置4.启动模块完成以上银行配置后，已经满足了启动回单模块的前提。此时可以在[模块管理]界面启动回单模块。启动回单模块后，各银行的回单任务才会开始执行31回单代理程序配置1.查看回单任务信息在回单代理程序上，通过[回单-回单任务]选择银行版本、账户和时间就可以查看回单的下载情况。刚部署的情况下是没有任务的，可以手动添加一个任务进行测试（不要添加今日的任务，回单有可能缺失）。正常的流程在任一步骤如果出现报错，任务的状态都会转换为“失败”，这时将鼠标移到失败二字上即可看到失败原因。32回单代理程序配置当回单文件下载成功后，可以在回单代理程序里查看回单文件的信息。[回单-回单任务]中查看下载状态为下载完成的回单任务：1、点击[详情]按钮，查看回单下载的回单文件信息2、点击[结果]按钮，查看回单扫描入库的文件信息和回单匹配码33回单代理程序配置[回单-回单信息]中选择银行版本和日期后点击查询，可以展示在此银行在时间段内下载的回单文件，目前只能看到回单的路径信息，无法在网页上查看回单文件。[回单-回单详情]中选择银行版本，银行账户和日期，可以展示此银行账户在具体日期内下载的回单文件。至此，银行的电子回单文件已经被下载至回单文件下载保存根目录（回单平台SFTP服务的根路径）下。34回单代理程序配置[本地查看回单文件]打开回单文件下载保存根目录（[回单-配置项-系统配置]里配置“回单文件下载保存根目录”）中的bakPath目录，我们可以直接看到下载好的文件。35目录CONTENTS一、电子回单概述二、电子回单业务流程三、电子回单部署四、常见问题解析36①绝密信息严禁泄露1、业务系统查询不到回单分析方法：①进入银企平台前端管理页面，在【系统管理】-【日志文件管理】菜单左侧找到mbts_invoke文件夹，在里面找到对应刚才操作的response日志文件，观察日志内容是否有返回回单文件信息；②若日志返回正常，请联系业务系统的技术人员排查问题；若返回为空则检查该账户查询日期是否有交易明细存在，没有交易明细则没有回单，不用做后续分析；①检查电子回单代理程序该账户回单任务是否下载完成，若果下载失败，则点击将鼠标挪到失败状态上，观察显示报错内容进行配置修改或在金蝶论坛搜索解决方法；②若回单下载完成，点击回单任务的结果按钮，观察是否有回单信息显示，如果没有则表示回单文件没有扫描入库，请检查回单文件名是否异常或者重新下载，提单处理；③检查银企平台业务配置的全局业务配置页面中是否填写了电子回单的IP和端口，且回单IP要填写实际IP；④检查银企平台补丁版本，同时查询银企平台上的回单日志，观察传给业务系统的报文中complete字段是否为1，如果为0，则需要升级银企平台补丁到最新版本。37①绝密信息严禁泄露2、电子回单平台上回单下载失败——NoSuchFile、回单文件列表为空、文件不存在等类似错误可能原因：①银行未推送回单文件②当天没有交易③SFTP路径配置错误解决方法：④手动重新下载看是否能下载成功，若手动下载成功则说明银行推送回单文件晚了一些。一般情况下是因为调度配置时间过早，此时银行并未生成回单文件，自然会失败，再重试时由于银行已经生成文件，就会成功。⑤询问银行回单的最晚推送时间，修改调度为自定义，调整调度时间在回单推送时间之后即可。⑥查看当天当账号是否有交易明细，如果没有交易自然没有回单文件。如果有交易，去银行SFTP服务上检查是否有回单文件，如果没有回单文件联系银行推送文件，然后重新执行任务。⑦如果银行SFTP服务上有回单文件，检查电子回单平台的SFTP目录是否配置正确。（使用WinSCP连接SFTP服务，如果连接进去直接为回单文件的文件夹，那么[银行SFTP文件保存子路径]不需要配置，如果回单文件在WinSCP连接进去的子目录下[银行SFTP文件保存子路径]需配置成WinSCP直接连接进去之后的子目录路径）38①绝密信息严禁泄露3、电子回单与交易明细无法匹配可能原因：①农行可能会因为回单平台配置是否总行推送与银企平台上的②银行业务配置不同，导致匹配码不一致③银企平台和回单程序版本较低，需要同步更新到最新版本④银行返回的字段不同导致匹配码不一致，需要联系银行处理分析方法：⑤在银企平台上查询同个账号同一天的交易明细、电子回单，然后导出日志⑥查看日志中的mbts_invoke/[查询日期]/queryReceipt/queryReceipt_[查询时间]_[流水号]/response，找到这笔回单的日志，查看其中的detailNo⑦再找到mbts_invoke/[查询日期]/detail/detail_[查询时间]_[流水号]/response，查看其中的receiptNo，对比两者不同⑧回单匹配码形成规则可在电子回单代理程序“20210311”版本的各个银行插件的银行配置页面找到⑨根据匹配码不同的字段再去找银行返回的报文，查看银行返回是否正确39①绝密信息严禁泄露4、电子回单下载不全（1）回单下载不全，但是等到下午或其他时间段手动下载又可以正常下载全解决方法：这种情况是银行推送回单较晚，回单下载设置的调度时间较早，导致回单只下载部分①首先要咨询银行，前一天的回单会在第二天什么时间段全部生成或者推送完全②修改电子回单程序的银行配置中下载调度方式为自定义，更改下方的[预处理]、[下载]、[扫描]时间段的配置③点击保存后，重启电子回单模块（2）回单下载不全，过段时间后再去下载还是一样解决方法：④使用winscp工具连接银行sftp服务，检查银行回单文件是否推送⑤查询回单任务的下载详情，查看银行推送的回单文件命名与结果里扫描成功的文件命名是否相同⑥以上异常均联系银行处理405、星空下载回单提示“无法连接到远程服务器”解决方法：1、银企平台的全局业务配置页面上“金蝶银企电子回单系统IP”，“金蝶银企电子回单系统端口”分别填写电子回单服务器的实际IP和端口(端口一般默认为8089)，这个配置是提供给银企平台访问电子回单系统的；2、当电子回单代理程序安装在银企平台同一服务器上，查看在星空上填写的银企平台IP是多少，然后在银企平台的全局业务配置上“金蝶银企电子回单系统sftp的IP”填写相应的IP，金蝶银企电子回单系统交互协议选择“SFTP”。Thanksterimakasih感謝谢谢ありがとうขอบคุ�ณ版权所有©1993-2019金蝶国际软件集团有限公司
