一、EAS下载不到电子回单1.电子回单平台没有自动创建相应的回单任务原因：回单模块没有启动。处理：启动回单模块。2.回单任务卡在创建状态原因：1.回单模块没有启动。2.勾选银行插件后没有重新启动回单模块。处理：勾选插件后要重启回单模块。反馈：如果长时间处于预处理中或者下载中（超过两小时），请提单联系开发人员检查原因。3.获取不到银行账户：“获取账号信息发送异常”错误原因：银企平台没有把账户设置为回单账户。处理：在银企平台的[账号管理]中把账号设置为回单账号。4.电子回单平台上回单下载失败*把鼠标放在失败上，看下任务的失败原因。（1）前置机或银企平台连接不上原因：1.报错含有“Connectiontimedout:connect”、“Unexpectedendoffilefromserver”、“Connectionrefused”、“Nosessionavailable”字样为网络问题。2.前置机所在服务器的防火墙没有开通电子回单平台所在服务器IP权限。处理：1.使用页面上的测试连接或Telnet来排查。2.前置机所在服务器开通电子回单平台的权限（入站，出站都要开通）。（2）SFTP连接不上原因：authfail、账户密码错误、登录验证失败，为账号密码错误。SFTP软件配置问题，网络问题等。处理：1.密码错误问题仔细核查自己的账户密码。其他问题可以Telnet一下检查网络问题，用页面上的测试连接或者WinSCP软件（论坛有下载地址）测试SFTP，一步一步按照“金蝶电子回单代理程序部署指南”中的SFTP配置重新下载安装freeSSHd软件。。（3）NoSuchFile、回单文件列表为空、文件不存在等类似错误原因：1.Sftp的路径中，文件夹带了中文2.银行未推送回单文件。3.当天没有交易。4.SFTP路径配置错误。处理：手动重新下载看是否能下载成功，若手动下载成功则说明银行推送回单文件晚了一些。一般情况下是因为调度配置时间过早，此时银行并未生成回单文件，自然会失败，再重试时由于银行已经生成文件，就会成功。1.询问银行回单的最晚推送时间，修改调度为自定义，调整调度时间在回单推送时间之后即可。2.查看当天当账号是否有交易明细，如果没有交易自然没有回单文件。如果有交易，去银行SFTP服务上检查是否有回单文件，如果没有回单文件联系银行推送文件，然后重新执行任务即可。3.如果银行SFTP服务上有回单文件，检查电子回单平台的SFTP目录是否配置正确。（使用WinSCP连接SFTP服务，如果连接进去直接为回单文件的文件夹，那么[银行SFTP文件保存子路径]不需要配置，如果回单文件在WinSCP连接进去的子目录下[银行SFTP文件保存子路径]需配置成WinSCP直接连接进去之后的子目录路径）反馈：如果上诉检查都没问题，请提单联系开发人员检查原因。（4）回单下载报错：Stringindexoutofrange1原因：电子回单平台需要在银行返回的响应报文中截取一些字段，银行响应报文缺失相应的字段。处理：和银行反馈，让银行响应完整报文信息。反馈：先提单给开发人员查看报文缺失字段，再找银行获取完整报文信息。5.EAS下载电子回单报错：【连接回单FTP服务器失败】下载PDF文件：IP:xx.xx.xx.xx端口:xx用户名:kingdee密码:kingdee$2017......原因：1.电子回单程序自带SFTP连接不上。大概率是【回单SFTP模块】没有启动。2.业务系统和回单程序的服务器网络不通3.银企平台的【全局业务配置】下【金蝶银企电子回单系统IP】【金蝶银企电子回单系统sftp的IP】两项填写错误处理：1.启动电子回单模块的【SFTP模块】2.在业务系统服务器Telnet一下回单程序提示的ip端口是都联通3.检查下银企平台的这两项配置是否正确，且均要填写银企平台的实际IP6.电子回单平台下载到回单但是EAS下不到原因：可能是电子回单平台没有扫描成功，或是业务端（EAS等）方面的问题。处理：首先检查电子回单平台【回单信息】中查看是否有下载数据。再检查银企平台是否能查到回单。反馈：如果相关配置正确的情况下银企平台查不到回单文件，请提单联系开发人员检查原因。如果银企平台可以查到回单，请提单到EAS相关部门检查原因。二、程序无法启动1.回单平台安装的路径中包含中文处理：在部分机器可能会有这类问题，建议安装在磁盘根目录下或者安装在全英文的目录中。2.代码不匹配原因：某些时候替换私包，新包依赖的还是旧的jar包，就会导致无法启动，或运行报错。3.输入的登录信息无误，登录界面报错导致无法登录处理：清理下浏览器缓存数据重新启动程序。4.Config目录下的application.yml文件，如果有特殊字符开头的值，会导致启动失败，并且没有报错信息处理：修改配置信息。5.出现如下报错“outOfMemory”原因：系统内存不足。6.端口占用处理：默认是8089端口，端口可以在config文件夹下application.yml文件修改。三、模块无法启动原因：浏览器不兼容。处理：模块点启动没反应，状态不变等问题，注意看右上角是否有个蓝色的小爬虫，如果有的话，说明浏览器不兼容（一般是IE的问题），建议换Firefox或者Chrome浏览器。四、电子回单平台的配置项缺失原因：在一些特殊情况下（替换私包、旧版升级新版等），由于元数据没有更新，会出现【配置项】-【系统配置】或【银行配置】中缺少某些配置项。处理：电子回单平台系统配置下有个更新元数据按钮，点击按钮重启电子回单平台。五、数据库问题1.数据库连接测试失败原因：数据库配置信息填写错误。处理：仔细核对数据库配置信息！2.SqlServer数据库：启动时报错处理：用记事本打开电子回单平台安装目录Config下的application.yml文件，把里面jpa和下面的内容全部删除，重启回单程序。3.Oracle数据库集群：启动时报错原因：1.Oracle目前只支持Normal用户（权限问题）。2.Oracle集群问题。处理：1.改为Normal用户。2.用记事本打开电子回单平台安装目录Config下的application.yml文件，把url:jdbc:oracle:thin:@localhost:3306:orcl中端口号后面的“：”换成“/”。六、电子回单匹配码与交易明细匹配码不一致原因：1.大部分情况：电子回单平台和银企平台版本不对应。2.特殊情况：回单平台和银企平台的银行特殊配置项配置错误；或者是银行返回的流水号不一致。处理：通用处理：升级电子回单平台或银企平台，或者两边都升级。电子回单平台更新地址：（https://vip.kingdee.com/article/165500974349008896）银企平台更新地址：（https://vip.kingdee.com/article/70472246245936896）分析处理：1、先比较电子回单和交易明细里面的回单码。EAS：参考帖子https://vip.kingdee.com/article/198449907345673472。星空：“接收银行交易明细”的电子回单关联标识和“电子回单”的关联标识2、观察两个回单码，一般是有一个多了金额或者其它字段，通常以长的那个为标准。例如交易明细的是：1_2_3_4，回单的是：1_2_3，那这时候就需要升级回单平台反过来交易明细的是：1_2_3，回单的是：1_2_3_4，那这时候需要升级银企平台3、升级完成后只是未来的数据会正常，以前已存在的数据需要手动删除。如果是升级回单平台：先参考二十三删除回单平台数据库的记录，再删除EAS或者星空的数据。如果是升级银企平台：对应的交易明细在银企平台重新打勾查询，然后在EAS或者星空重新联机查询交易明细。反馈：该问题比较常见，若同时按步骤处理后匹配码依旧不匹配，请提单联系开发人员检查原因。七、建行外联版和工商银行回单显示下载成功，但是没有回单文件或者是回单文件缺失原因：电子回单平台执行时银行还未推送回单（建设银行外联版和工商银行回单不是一次性推送的，是分批推送的）。处理：建设银行外联版和工商银行的回单调度会在后台一直执行，等银行传送回单到指定目录，电子回单平台就会获取到回单。反馈：如果次日回单还未推送完全，请提单联系开发人员检查原因。八、建行结息电子回单无法下载到EAS，银企平台也查不到原因：建设银行结息回单没有流水号，所以只能下载到电子回单平台，无法与银企匹配。处理：联系银行增加流水号字段。九、工行秘钥登录SFTP不成功，报错“invalidprivatekey”原因：秘钥格式问题。处理：用winscp软件将秘钥转换为RSA格式。（目前回单只支持这种格式）密码随意填写，只需要用户名和秘钥正确即可。密钥转换方式：1.运行winscp，在工具中选择运行PuTTYgen。2.选择load，选择对应的私钥文件。3.选择conversions下的ExportOpenSSHkey，将转换好的私钥导出，电子回单程序选择导出的密钥文件即可。十、工行下载成功，但是结果没有内容原因：工行有总行分行不同的推送格式，可能是格式选择错误。处理：连接银行的SFTP，拿到银行推送的原文件，和配置项中的【推送的文件格式】中的描述对比，选择自己对应的版本。十一、工行下载失败，提示没有找到回单文件原因：1.工商银行银行方面只提供三天内的回单文件，三天外的下载不到。2.工商银行提供的sftp，子路径没有填写处理：1.和银行沟通，是否可以推送想要下载日期的回单。2.银行给的sftp，登陆进去需要再进入子路径才能看到回单文件（/Ebillsend/download）需要填写次子路径到回单系统银行配置下的sftp子路径中，保存重启回单模块即可。反馈：如果上述操作没有解决问题，请提单联系开发人员检查原因。十二、电子回单平台页面乱码原因：3.浏览器不兼容。4.数据库编码问题。处理：3.使用谷歌或火狐浏览器。4.MySQL数据库的编码集需选择utf8mb4，其他数据库选择utf-8。反馈：如果上述操作没有解决问题，请提单联系开发人员检查原因。十三、电子回单平台页面配置项保存不生效原因：浏览器不兼容。处理：使用谷歌或火狐浏览器。十四、农行选择发请求推送方式，报错：数据文件大于50M原因：农行规定发请求推送文件数据不能大于50M。处理：让银行把推送方式改为主动推送。十五、农行下载成功但是没有结果。原因：农行存在总行分行两种推送文件的格式，可能是选错格式。处理：连接银行的SFTP，拿到银行推送的原文件，和配置项中的【是否使用总行推送通道】中的描述对比，选择自己对应的版本。十六、建行下载失败，日志中显示报错：响应：未经授权访问的IP地址[xx.xx.xx.xx]原因：金蝶前置机代理程序有白名单限制，没有将回单的ip设置成白名单。处理：在金蝶前置机代理程序把电子回单平台的IP设为白名单。十七、平安银行下载失败原因：银行推送的回单文件为.enc后缀的加密文件。处理：连接银行SFTP服务，查看回单文件是否为以.enc结尾。如果是，在前置机配置“FTP服务器8号路径”改为不使用，会出现一个本地路径，在前置机的服务器上重新配置一个SFTP，这个SFTP的路径设置为前置机8号路径给你的那个文件夹，然后回单程序选择远程SFTP获取连接这个SFTP。十八、平安银行近期任务下载成功，历史任务下载失败原因：银行推送的回单文件有效期15天，15天之前的下载不到。处理：和银行沟通看是否可以提供15天之前的回单文件。十九、招行的电子回单正常下载，无法查到原因：很可能是招行前置机版本低的问题。招商银行有时会存在回单任务可以正常下载，且回单任务详情显示完成，但是在回单详情页面查到的条目数量为0，同时在银企平台也无法查到下载好的回单的问题。处理：检查招行SFTP上的回单源文件，看其文件名是否为“账号_开始日期-结束日期_流水号”（如122666666111111_20200324-20200324_4340005140201.jpg）形式，如果是，则说明招行前置机程序为旧版，回单程序暂不支持解析旧版数据，建议升级前置机版本。二十、兴业银行前置机配置电子回单平台配置项：二十一、浦发银行在业务系统不能匹配交易明细原因：浦发银行可以自行选择银行推送的电子回单命名方式，因为我们的匹配码需要用到金额字段，但是银行推送的文件名不含金额，导致匹配失败。处理：账号_日期_交易流水号_序号_交易代码_金额_receipt.pdf，让银行推送这种格式的电子回单文件。银行修改完成后重新下载即可。二十二、获取当日回单功能原因：没有将电子回单加入白名单。处理：问问银行方面是否需要将电子回单加入白名单等操作。反馈：因为当日回单功能是新开发的功能，只有部分银行上线了，若想使用其他银行的当日回单功能，请提单联系开发人员开发。二十三、如何删掉已下载的电子回单数据1.在配置项找到回单文件下载保存根目录，在该目录下找到[bakPath\银行版本\回单日期]文件夹，删除文件名包含[银行账号]的所有文件。2.连接数据库，找到t_receipt_detail表，找出file_path字段为刚才删除的文件的路径的记录，把对应记录也删除。（参考语句：SELECT*FROMt_receipt_detailWHEREfile_pathlike‘%bakPath/银行版本/回单日期/回单账号%’）二十四、区分银行sftp和回单程序自带sftp服务SFTP服务的作用：本地服务器可以通过SFTP读取到远程服务器目录下的文件。银行SFTP和回单程序自带SFTP服务毫无关联，各司其职，使用时不要混淆概念。适用对象不同：银行SFTP服务：电子回单平台需要通过这个SFTP服务下载银行推送的回单原始文件，这个SFTP服务是银行SFTP服务。（供回单程序使用）回单程序自带SFTP服务：业务系统（EAS，星空等）要读取回单程序下载好的回单文件，需要通过这个SFTP服务，电子回单平台为了方便实施人员部署，内嵌了一个SFTP服务，这个SFTP服务就是回单SFTP自带服务。（业务系统使用）搭建位置不同：银行SFTP服务：搭建在银行推送回单文件的服务器上（一般是前置机服务器），根目录指定为回单文件推送到的目录（需要询问银行），里面存有银行原始回单文件。回单程序自带SFTP服务：不需要搭建，直接在电子回单平台【模块管理】启动，根目录为电子回单平台服务器上的目录（在【系统配置】页面配置），里面存储回单程序下载解析好的回单文件。配置方式不一样：银行SFTP服务：【回单】-【配置项】-【银行配置】，回单程序自带SFTP服务：【回单】-【配置项】-【系统配置】，IP为回单程序IP，根目录自己创建，端口配置一个没有占用的端口。若启动模块如果报如下错，到【系统配置】修改一个未被占用的端口。二十五、回单平台SFTP模块启动报错“地址被使用”原因：电子回单所在服务器配置了和电子回单自带SFTP端口一样的SFTP服务。处理：修改自己配置的SFTP端口号（尽量不要修改电子回单平台自带SFTP端口，因为EAS数据库写死的，会出现问题）二十六、招行回单下载入库失败，文件下载到了下载目录下的error文件夹下原因：银行文件推送PDF文件名错误，导致回单扫描失败二十七、系统的软件终止程序原因：360等杀毒软件把回单程序识别为病毒处理：关闭杀毒软件，或将回单程序加入杀毒软件白名单二十八、建行现金管理要用前置机代理程序。银企平台上有前置机代理的配置，报文和文件是两个端口。能查看余额不一定能下载回单。二十九、邮储银行报错银行返回文件名为空原因：银行的2070端口响应中有个字段为回单的文件名字段。银行返回的和接口文档的不一样。处理：请联系银行，将这个字段改为“File_name”三十、原来匹配码不一致，换包后匹配上，旧数据处理方法参考二十三把以前下载的回单数据删除，然后重新下载回单三十一、Mysql数据库启动提示表已存在看看mysql数据库的名字是不是“mysql”，如果是，需要改成其它名字。同名的话会启动失败。
