金蝶EASV8.5电子回单代理程序使用说明金蝶软件（中国）有限公司2018年7月金蝶EASV8.5电子回单代理程序使用说明目录1.引言.11.1文档用途.11.2阅读对象.12.名称解释.12.1代理.12.2回单.13.代理程序框架.23.1通讯简图.23.2金蝶代理架构图.33.3回单部署方案图.34.电子回单代理程序功能列表.55.配置说明.55.1创建数据库.55.2配置数据库连接信息.55.3启动和停止代理系统.76.回单模块配置.86.1登录代理系统.86.2创建新的管理员.96.3配置回单配置项.116.4配置已启用回单的银行配置.126.5启动模块.156.6使用sftp模块.157.回单任务配置.177.1设置银企平台电子回单账号.177.2银企平台前置机设置.187.3查看回单任务信息.187.4查询回单信息.197.5登录sftp查看文件(可跳过).19金蝶EASV8.5电子回单代理程序使用说明11.引言1.1文档用途本文档旨在对金蝶银企平台电子回单代理程序做一个完整的使用说明，以方便指导用户快速接入和解决问题。本文档只用于对接银企平台的实施用途。1.2阅读对象1.金蝶内部技术、内部技术支持人员。2.对接金蝶银企平台的实施人员。3.学校科研等非盈利教育机构。2.名称解释2.1代理间接通讯的一种方式。2.2回单即银行回执单，银行回执单是表明个人或在单位在银行办理业务的一个有效凭证。金蝶EASV8.5电子回单代理程序使用说明23.代理程序框架3.1通讯简图图3.1-1可以看到回单是由银行服务器先推送到银行的sftp上再由银行sftp下载到回单服务器上。业务系统通过银企平台来获取回单服务器上的回单。金蝶EASV8.5电子回单代理程序使用说明33.2金蝶代理架构图金蝶电子回单代理程序上面有sftp及回单两个模块和配置项管理和回单查询两个功能。3.3回单部署方案图由于银行传输回单方式不同部署回单程序和相应软件的方式会有区别，总体可以归纳为以下几种方案：A方案：银行主动推送回单压缩包到回单服务器上。金蝶EASV8.5电子回单代理程序使用说明4此方案部署相对简单，只需要部署回单程序然后开启回单程序上的SFTP模块即可。B方案：回单程序发起请求获取回单下载链接，再通过前置机上的SFTP获取文件。此方案用于处理银行将回单下载到前置机上的情况。除了部署回单程序到回单服务器上外还需要额外部署一个SFTP软件在银行前置机上（SFTP软件推荐使用server-u，需要客户购买）。金蝶EASV8.5电子回单代理程序使用说明54.电子回单代理程序功能列表1.模块管理2.内嵌SFTP文件服务3.配置统一管理4.回单任务查询5.回单列表查询5.配置说明5.1创建数据库回单程序支持mysql，sqlserver和oracle数据库。在使用代理程序前请确认需要使用的数据库类型，并创建一个数据库供代理程序使用，数据库的编码集需选择utf-8。5.2配置数据库连接信息在安装目录下启动start_DBConfig.bat（windows系统下）或linux_start_DBConfig.sh（Linux系统下）。运行后会启动数据库配置程序。金蝶EASV8.5电子回单代理程序使用说明6请根据之前创建的数据库输入数据库信息并保存，点击测试按钮可以检测是否能连接上数据库。该数据库信息将会保存到config文件夹下的application.yml文件里。当数据库配置程序无法启动时(比如在没有图形界面的linux系统下)，也可以通过直接金蝶EASV8.5电子回单代理程序使用说明7手动修改数据库配置文件application.yml来更改数据库配置。用该种方式配置数据库无法进行连接测试，需要特别注意参数配置的正确性。附配置参考文件：application.yml根据使用的数据库类型选择模板，模板中需要配置的参数有：1.登录数据库的用户名和密码2.数据库ip及端口3.数据库名(oracle的SID)以下图片中带有下划线的，是需要修改的参数，其它地方保持不变。Oracle：Sqlserver：Mysql：配置完成后，将文件application.yml放到回单代理程序安装目录下的config文件夹中，不再需要启动数据库配置程序。5.3启动和停止代理系统启动：双击或是运行对应的start_in_console.bat（windows系统下）或linux_startup.sh（linux系统下）来启动代理系统。金蝶EASV8.5电子回单代理程序使用说明8停止：关闭运行后启动的终端即可。注意：出现上面提示表示启动成功。如果没有配置数据库信息将会启动失败，需先配置数据库信息。6.回单模块配置6.1登录代理系统登录代理系统管理页面。在浏览器里输入127.0.0.1:8089即可打开代理管理系统。默认的登录用户信息为：账号:kingdee密码:123456点击登录即可。金蝶EASV8.5电子回单代理程序使用说明96.2创建新的管理员由于使用的默认管理员kingdee账号存在风险，建议第一次登录的时候创建新的管理员并用新管理员登录。(该步骤也可以在业务测试结束后再进行)金蝶EASV8.5电子回单代理程序使用说明10在用户菜单创建一个角色为ADMIN的用户。点击右上角Kingdee图标，选择退出系统后，再使用新创建的管理员账号登录，将kingdee管理员账号删除。金蝶EASV8.5电子回单代理程序使用说明116.3配置回单配置项创建回单服务器根路径。请在文件系统里创建一个用来存储回单文件的目录。如：c:/receipt或/var/share/receipt在[回单-配置项-系统配置]里配置"回单服务器根路径"为上面创建的路径。同时在该页面填写银企平台所在服务器的ip及端口，并注意保存。金蝶EASV8.5电子回单代理程序使用说明12选择需要启用回单模块的银行：在[回单-配置项-系统配置]中的"启用回单列表"勾选需要使用回单的银行版本缩写并保存。6.4配置已启用回单的银行配置在[回单-配置项-银行配置]中，选择需要配置的银行版本。对于初次配置已经存在默认值的选项，通常情况下不需要更改。不同银行的配置要求会有所不同，例如对于"中国银行NET版"只需要配置以下用于对接的中行sftp配置项即可。(银行配置中所指的sftp用户账号为登录银行sftp服务器的账号，非代理程序启动的sftp账号，需向银行方获取)不同银行的配置要求会有所不同，取决于银行以何种方式提供回单文件，较为常见的有以下两种：1.银行返回给银企平台电子回单的信息，并将回单文件传递至前置机安装路径下某一文件夹内，需要用户根据返回的信息去指定的文件夹内获取回单文件2.银行将文件以base64字符串的形式发送给前置机，前置机同样以base64字符串的形式返回给回单平台，回单平台再由取得的字符串生成回单文件目前在回单程序上支持的第一批银行版本中，使用第一种方式的银行版本有:中国建设银行外联版(CCB_DC)、招商银行直连版(CMB_DC)为获取这类银行的回单文件，需要在前置机所在服务器上额外搭建第三方sftp服务，金蝶EASV8.5电子回单代理程序使用说明13并在配置项中填写sftp的相关信息。注意创建的sftp用户需要有读写删的权限，根目录设置为前置机存放下载回单文件的文件夹且锁定用户至根目录。使用第二种方式的银行版本有：内蒙古银行银企直连版(BOIMC_DC)、建设银行企业现金管理直连版(CCB_CCIP)、民生银行(CMBC_DC)、中信银行直连版(CITICB_DC)这类银行不需要搭建额外的第三方sftp服务，完成相应的前置机配置即可。除了以上两种常用的方式之外，还有一些采用其它方式的银行版本，如中国银行BOCNET版本(BOC_NET)和中国农业银行公网版本(ABC_DC)，银行会提供银行方的sftp服务器供回单系统取回单文件，不需要用户自行搭建sftp服务，此时配置项中的sftp服务器的ip和地址就填入银行给的sftp服务器的信息。另外需要注意，在配置时每个参数更改后都需要点击对应配置项后的保存按钮。说明范例(招商银行)：第一部分为银行前置机信息，一般可以参考银企平台上的前置机配置；第二部分为sftp服务的信息，一般需要用户自己搭建在前置机服务器上，并将sftp用户的根路径指向银行前置机的安装目录；第三部分为任务调度Cron表达式，即执行任务的频率，默认设置时间间隔较长，是为了给生成文件预留充分的时间。测试的时候可以挑选记录少的日期进行，并配置为说明中的测试参考表达式(两分钟执行一次)，提高测试效率。并不是所有的银行都有以上三部分的配置，比如不需要通过回单平台向前置机发送请求的银行没有第一部分的前置机配置，而不需要通过sftp传递回单文件的银行则没有第二部分的sftp相关配置。金蝶EASV8.5电子回单代理程序使用说明14金蝶EASV8.5电子回单代理程序使用说明156.5启动模块完成以上配置后，已经满足了启动回单模块的前提。此时可以在[模块管理]界面启动对应的模块。6.6使用sftp模块业务系统需要通过回单平台自带的sftp服务获取回单平台上的电子回单文件，在启动sftp模块之前，需先配置回单服务器根路径和创建登录sftp的用户：其中回单服务器根路径在[系统配置]中可以配置，sftp用户在[用户管理]中可以新增。在用户管理页面新增一个角色为sftp的用户，用于登录回单模块。金蝶EASV8.5电子回单代理程序使用说明16当回单服务器根路径配置完成后，可以在模块管理页面将sftp模块启动。金蝶EASV8.5电子回单代理程序使用说明177.回单任务配置7.1设置银企平台电子回单账号该步骤需要登录银企平台，在[业务管理-账号管理]中点击需要使用回单功能的账号后的附加属性，将其设置为电子回单账号。被设置为电子回单账号的账号可以被电子回单系统获取。在[回单-回单任务]中选择银行版本后，点击账户输入框，可以查看到该银行版本下已经被设置为电子回单账号的账号信息。金蝶EASV8.5电子回单代理程序使用说明187.2银企平台前置机设置在银企平台的[业务管理-全局业务配置]菜单中，填入电子回单代理程序所在服务器的信息，以及sftp的用户名及密码。(此处所指的sftp用户账号为登录代理程序sftp服务器的账号，非银行的sftp账号)7.3查看回单任务信息在电子回单系统上，通过[回单-回单任务]可以查看回单的下载情况。在默认的配置下每天都会为所有电子回单账号自动创建回单任务，而在此界面中也可以进行手动添加任务。金蝶EASV8.5电子回单代理程序使用说明197.4查询回单信息当回单文件下载成功后，您可以在代理系统里查看回单文件信息。在[回单-回单信息]中选择银行版本后点击查询，可以展示指定日期段内请求下载回来的回单文件，目前只能看到回单的路径信息，无法在网页上查看回单文件。至此，银行的电子回单文件已经被下载至电子回单sftp服务器，之后便需通过ERP系统向银企平台发送请求，获取回单所在位置并进行下载。最后，需要在银企平台的[业务管理-银行业务配置]中将配置项”文件类电子回单接口版本”更改为”新版json格式”，如下图。7.5登录sftp查看文件(可跳过)启用sftp模块后可以使用sftp客户端登录sftp查看回单文件。以下为使用WinSCP查看回单的方法：输入IP为代理系统ip，端口为[系统配置]中配置的值(默认22)，用户名和密码填入上面配置的sftp用户的用户名和密码。金蝶EASV8.5电子回单代理程序使用说明20登录成功后可以在回单文件备份路径目录下查看到回单文件。金蝶EASV8.5电子回单代理程序使用说明21
