金蝶EASV8.0BOS银企平台用户手册金蝶软件（中国）有限公司2014年11月1/37目录1基本概念..............................................................................51.1.什么是银企互联.......................................................................................................51.2.BOS银企平台..........................................................................................................51.3.银企平台的必要性...................................................................................................51.4.银企平台结构...........................................................................................................52银企平台部署说明......................................................................62.1银企部署流程...........................................................................................................62.2银企部署支持的环境...............................................................................................82.3系统配置要求...........................................................................................................93银企平台部署步骤......................................................................93.1银企安装包准备.......................................................................................................93.2银企数据库准备.......................................................................................................93.3银企平台启动.........................................................................................................113.4银企平台系统初始化.............................................................................................134银行前置机部署.......................................................................165银企平台配置.........................................................................165.1业务初始化向导.....................................................................................................175.2系统管理................................................................................................................215.2.1前置机...................................................................................................................215.2.2License管理.........................................................................................................215.2.3定时任务...............................................................................................................225.2.4日志文件系统.....................................................................................................245.2.5业务日志搜索........................................................................................................245.2.6日志备份...............................................................................................................255.3业务管理................................................................................................................265.3.1全局业务配置........................................................................................................265.3.2银行业务配置........................................................................................................265.3.3账号管理...............................................................................................................275.3.4币别管理...............................................................................................................275.4用户管理................................................................................................................285.4.1用户列表...............................................................................................................285.5退出........................................................................................................................295.6左侧业务菜单.........................................................................................................295.6.1余额.......................................................................................................................295.6.2交易明细...............................................................................................................305.6.3付款记录...............................................................................................................315.6.4联动支付记录........................................................................................................316注意事项.............................................................................326.1银企互联设置.........................................................................................................326.2账户管理................................................................................................................322/376.3其他事项说明.........................................................................................................327银企版本支持银行列表对比.............................................................328帮助与支持...........................................................................343/37金蝶EASV8.0BOS银企平台用户手册前言本文档提供EASV8.0银企平台用户操作指南的相关信息，包括：基本概念、部署环境说明、银企平台部署步骤、银企平台配置等。适用于使用金蝶EASV8.0的用户。4/37金蝶EASV8.0BOS银企平台用户手册1基本概念1.1.什么是银企互联随着经营理念的转变和管理水平的提高，大量集团企业客户纷纷提出资金集中管理、提高资金使用效率、降低经营成本的财务管理需求。网上银行的出现，一定程度上满足了客户这部分需求，但还不能完全解决个性化服务、财务信息与银行账务信息的一致性问题。为了满足企业高端客户对网上银行提出的个性化需求，进一步推进网上银行业务向纵深发展，各家商业银行推出了网上银行银企互联模式，这种新的网上银行业务模式是通过企业财务软件与商业银行网上银行系统的有机互联，整合了银企双方的系统资源，从而带给企业安全、简易、实时、个性化的银企服务。1.2.BOS银企平台BOS银企平台是对金蝶资金产品支持与多家银行的银企直联的中间产品。金蝶ERP产品银企互联模块能通过向银企平台请求来达到与不同的银行系统达到交互的目的。银企平台负责与各商业银行的网银系统对接，集团企业通过ERP或财务系统连接银企平台实时获取各银行账户及交易信息，并向指定的银行传递交易指令和接收反馈信息，依托统一的BOS银企平台，实现跨银行的账户管理和付款交易管理。银企平台随着金蝶ERP产品的发展逐渐丰富和完善，支持EAS、K3或其它大型ERP产品。支付网关，用于转发业务系统与银行网银系统之间的消息。集成了多家银行的业务功能，屏蔽各银行的差异。以WebService方式提供服务，跨平台跨语言。独立安装部署。1.3.银企平台的必要性屏蔽各个银行差异，为业务系统提供统一的银行业务接口。新增银行时，不需要业务系统有所改变。1.4.银企平台结构银企平台在系统中处于业务系统与银行网银系统之间，如下图所示：5/37金蝶EASV8.0BOS银企平台用户手册说明：BOS银企平台、银行前置机以及ERP系统都部署在企业端。银企平台负责将ERP系统与银行银企互联系统对接，消息转发。EAS6.0以及K3V12版本开始，共用同一个银企平台，因此，银企平台单独部署，与ERP系统分开安装。2银企平台部署说明2.1银企部署流程请实施人员按照下图所示流程进行实施：6/37金蝶EASV8.0BOS银企平台用户手册7/37金蝶EASV8.0BOS银企平台用户手册下表为实施银企平台几个主要阶段说明：阶段主要工作参与人前期准备阶段三方交流，确定银企实施内容，确定银行提供的银企互联版本。企业、银行、金蝶测试部署阶段1、银行测试环境搭建，由银行相关人员在企业内部部署其测试环境，并提供相应的文档及测试账号信息。2、金蝶实施人员部署BOS银企平台，并安装最新的银企补丁。3、EAS/K3需要安装最新的补丁。4、确保EAS服务器或K3服务器能够连通BOS银企平台，BOS银企平台能够连通银行前置机银行、金蝶测试实施人员进行查询余额、查询明细、付款、划拨等业务的测试。测试发现问题，查看日志，日志里包含银行返回的信息，根据银行返回信息判断错误原因。有些问题需要咨询银行，让银行协助查看。金蝶、银行操作手册实施人员结合客户业务情况攥写操作手册，并把一些注意事项写在手册里。金蝶上线由银行部署正式环境。银企平台部署到正式环境，并做好正式环境设置工作。金蝶、银行、企业2.2银企部署支持的环境金蝶BOS银企平台是基于JAVA开发的独立系统，独立部署，可部署在windows、linux和unix等操作系统。8/37金蝶EASV8.0BOS银企平台用户手册2.3系统配置要求3银企平台部署步骤3.1银企安装包准备BOS银企平台支持windows、linux、unix操作系统。目前银企平台安装文件以压缩包方式提供，请联系总部银企平台获取。3.2银企数据库准备需要为银企平台准备相应的数据库软件，支持的数据库类型，请参考1.2接系统配置要求。建议单独创建数据库实例和分配数据库用户供银企使用。数据库访问用户建议需要具有管理员权限，银企数据库初始化过程中，需要建表，需要使用到对表内容的的增、删、改、查和索引权限。数据库和数据库用户的创建可请客户方数据库管理员协助处理。以SQL2005为例1、创建数据库进入SQL2005新建数据9/37硬件平台PC机最低要求：双核2G以上，4G内存，100M带宽操作系统UnixAIXHPUNIXLinuxRedHatEnterpriseLinuxAdvancedServerSuseLinuxEnterpriseWindows2008serversp2及以上2008serverR22012serverR2中间件jetty6.1.23平台自带数据库Oracle10g企业版,10.2.0.４以上11g企业版,11.２.0.１以上DB29.5企业版，Fixpack4以上MSSqlServer2005企业版，sp1以上2008企业版MySql5.0不推荐金蝶EASV8.0BOS银企平台用户手册新建的数据在【选项】中选择【排序规则】Chinese_PRC_CI_AI10/37金蝶EASV8.0BOS银企平台用户手册3.3银企平台启动1、点击对应系统平台下的脚本启动银企服务。AIX系统：aix_debug_in_console.sh（debug模式启动服务器）aix_ebg_db_init.sh（手动运行数据库初始化脚本，前提是server.properties已经配置好）aix_shutdown.sh（关闭银企平台）aix_startup_in_console.sh（启动服务器）aix_startup.sh（在后台启动服务器）Linux系统：linux_debug_in_console.sh（debug模式启动服务器）linux_ebg_db_init.sh（手动运行数据库初始化脚本，前提是server.properties已经配置好）linux_shutdown.sh（关闭银企平台）linux_startup_in_console.sh（启动服务器）linux_startup.sh（在后台启动服务器）Windows系统：windows_debug_in_console.bat（debug模式启动服务器）windows_ebg_db_init.bat（手动运行数据库初始化脚本，前提是server.properties已经配置好）windows_shutdown.bat（关闭银企平台）windows_startup_in_console.bat（启动服务器）server.properties（服务器配置信息。不推荐手动配置，若要手动配置，配置时须保留state.port=5288一行）以Windows系统为例：双击windows_startup_in_console.bat运行银企平台，当看到‘成功注册dbservices服务!’提示时，说明银企平台启动成功。如下图所示：11/37金蝶EASV8.0BOS银企平台用户手册2、点击apache-tomcat-6.0.20\bin下的startup.sh(aixlinux平台)或者startup.bat启动tomcat银企平台客户端。成功启动后，会自动弹出浏览器访问http://127.0.0.1:5389/system/ebserver-config/(安装有默认浏览器的linux及windows系统)。如果不能自动弹出，请手工把地址拷贝到浏览器进行访问。如下图：12/37金蝶EASV8.0BOS银企平台用户手册3.4银企平台系统初始化1、银企服务器设置银企服务器设置配置的是从tomcat客户端访问银企服务器的ip及端口信息（允许两者分开部署，但通常放在一起即可）。2、License导入选择license文件，然后点击“上传”，上传结果如下图：测试license允许使用5个前置机，超过5个时，会出现业务异常。3、数据库配置数据库配置是配置银企平台服务器使用的数据库，tomcat客户端无需使用数据库。注：选择正确的“数据库类别”；在执行本向导前应该先创建好数据库、用户及赋予DBA权限（可以执行数据库脚本）13/37金蝶EASV8.0BOS银企平台用户手册4、管理员设置管理员设置用于设置登陆web客户使用的用户名及密码。5、完成向导根据配置好的银企服务器、数据库等信息，系统将在后台执行初始化。初始化所花费时间可能需要多几分钟，请耐心等候。14/37金蝶EASV8.0BOS银企平台用户手册初始化成功后，点击“业务向导”，会跳到登陆页面，输入刚才“管理员设置”的信息即可登陆15/37金蝶EASV8.0BOS银企平台用户手册到此，银企平台部署完成。4银行前置机部署由客户方联系银行电子银行部或现金管理部，获取银行前置机软件和安装部署指南，并安装在客户的电脑上，需要保证该电脑能够访问外网。一般银行前置机部署在企业DMZ区。测试阶段从银行获取测试用的客户证书或KEY，银行测试服务器信息，测试用账号（一般需要三个，其中两个属于集团内部账号，另外一个是外部账号）。对某些银行需要询问服务器时间，如工行，在做具体业务的时候需要修改ERP系统的系统时间。获取访问端口，银企前置机一般都会开放某个端口由外部系统来访问，此端口在银企互联设置中使用。一般情况下前置机的部署都是由银行人员到现场进行部署。正式上线测试完成后，需要在正式环境部署银行前置机。5银企平台配置成功登录银企平台后，将进入银企平台的主界面，如下图：16/37金蝶EASV8.0BOS银企平台用户手册5.1业务初始化向导业务初始化向导提供用户配置银行前置机、银行账户信息、测试前置机连通性及业务可操作性的能力。银行版本选择一个银行可能有多个版本的接口，对应金蝶银企中间件的多个插件版本，使用时需要明确账户需要使用的插件版本。前置机配置17/37金蝶EASV8.0BOS银企平台用户手册根据银行提供的信息进行填写，工行推广版的设置如下图：账号设置账号设置时，目前只有中行、农行、工行、建行、招行需要“地区码”；“机构号”只有建行需要。进行设置的时候，不需要该项的银行，填不为空的字符即可。工行推广版的设置如下图：18/37金蝶EASV8.0BOS银企平台用户手册余额查询测试余额测试异常情况：19/37金蝶EASV8.0BOS银企平台用户手册异常情况可以点击“查看日志”查看异常原因。如果是前置机问题，可以在右上角“系统管理”->“前置机”中进行修改；如果是账号户信息配置问题，可以在“业务管理”->“账号管理”中进行修改后刷新页面测试即可。余额测试正常情况：正常的情况也可以通过“查看日志”来看银企平台发出的报文，以及银行返回的报文信息。20/37金蝶EASV8.0BOS银企平台用户手册5.2系统管理5.2.1前置机完成银行前置接口登陆信息的配置功能。从左边选择需要配置的银行版本并双击即可以配置相应的配置项。，如下图：配置完成后先“保存”再“测试前置机连接”（测试银企平台到银行前置机的连接性，使用telnet方式）。需要实现“前置机集群”功能的客户，可以点击‘’来添加多个“登陆配置”，添加银行账号时，分配到各个“登陆配置”上。5.2.2License管理完成银企平台License许可文件的更换（重新导入）功能。21/37金蝶EASV8.0BOS银企平台用户手册打开License管理页面，可以看到当前配置的License状态。对于有异常的情况，需要重新导入License文件。对于提示“该License文件不适用于该服务器”，可能是许可已经过期、或者是正式License没有使用在指定的申请License的机器上。上传成功后，可以看到License的“许可数量”及“过期时间”。5.2.3定时任务对于普通业务都可以进行定时任务配置，例如：付款（对公对私等，操作名为22/37金蝶EASV8.0BOS银企平台用户手册pay）、付款状态查询（操作名为queryPay）、余额（操作名为balance）、明细（操作名为detail）。对于联动支付业务，可能需要多个业务的定时任务配置才能进行。1、定时任务列表，可以查看当前已经配置的定时任务。2、付款定时任务配置如果前置机没有启动、网络不通、服务器意外关闭，或者其他导致付款信息未正常提交的情况，付款信息存在在数据库中，处于“准备提交”状态。当环境恢复后，付款定时任务配置会在后台完成提交付款操作（只针对提交异常的付款）。插件实现类：可以选择相应业务实现类（对公/对私等）的定时任务。时间规则：有三种规则的设置方式。如下图：3、查询付款状态定时任务配置操作名对应queryPay，定时时间间隔推荐5分钟或以上。对于联动支付，这个很重要，需要同步为“交易成功”后，才进行下一步的支付。4、余额定时任务配置操作名对应为balance，对于某些银行存在登陆超时的情况，可以使用明细定时任务的方式定时发送查询指令。5、明细定时任务配置23/37金蝶EASV8.0BOS银企平台用户手册操作名对应为detail，需要定时在后台查询明细的银行，可以配置定时查询。由于明细查询会有缓存记录，“强制从银行下载所有”指查询指定时间范围内的明细时，忽略缓存记录，到银行取最新数据。5.2.4日志文件系统列举出银企平台logs目录下的目录树，以web方式查询日志文件，所有目录与文件按时间倒序排序。便于查看和分析银企平台的日志。5.2.5业务日志搜索根据设定的业务条件，搜索日志信息。24/37金蝶EASV8.0BOS银企平台用户手册点击某条目，可以查看具体的客户端请求信息（request）、银企的响应信息（response）、银行报文日志(有银企平台发送的封装报文，及银行的响应报文，如balance_20120903110035_7651500s.ICBC_CMP-1)，切换文件名即可查看。5.2.6日志备份由于银企平台会保留比较多的日志记录，且有单文件大小较小，文件数较多的特点。所以当银企平台运行较长的时间后，日志占用的磁盘空间会比较多，需25/37金蝶EASV8.0BOS银企平台用户手册要进行压缩或转存。用户可以备份指定时间范围内的日志文件，可以选择“备份后同时删除原日志文件”（压缩转存），但是后台控制“当前日期30天内的文件不允许删除”。如果需要指定范围内的日志信息分析业务，也可以通过备份后下载这种方式来提取。备份后，可以通过列表查看备份的文件信息。5.2.7接入方配置基于安全考虑，在银企平台中增加接入方访问限制的功能，配置项包括：支付通道开关、访问IP限制。支付通道开关配置为『关』时，银企平台将不接收业务系统提交的支付类请求。访问IP限制有白名单和黑名单两种策略，即列表中的IP可以访问和列表中的IP不允许访问。根据配置的IP访问限制策略，银企平台对访问的请求进行过滤，不允许访问的IP发出任何请求均会被拒绝。5.2.8安全配置基于安全考虑，银企平台增加了安全接入模块，提供了更安全的接入方式。使用安全方式对接银企平台，业务系统与银企平台之间的通讯数据将得到加密处理。注：该功能需要业务系统的支持。配置步骤：1、配置页面上的参数，并生成证书（支持两种方式生成）A．在银企平台web页面导入客户端和服务器端的pfx证书26/37金蝶EASV8.0BOS银企平台用户手册B．在银企平台web页面输入配置信息（客户端和服务端的证书用户名及密码），由银企平台生成证书2、配置服务端通过『开启安全服务』按钮，打开安全服务的开关3、配置客户端（业务系统端）通过页面下方的『下载客户端证书』、『下载客户端配置文件』链接，分别下载客户端证书和配置文件，并放置到客户端指定目录中页面参数说明：客户端userName：用户定义的客户端名称，标识访问银企平台的客户端的身份客户端password：用户定义的客户端密码服务端userName：用户定义的银企平台名称，标识业务系统接收到的响应的身份服务端password：用户定义的服务端密码客户端密钥别名：客户端证书的别名客户端密钥仓库密码：客户端程序中保存证书的仓库密码客户端密钥私钥保护口令：客户端证书的密码服务端密钥别名：服务端证书的别名服务端密钥仓库密码：服务端程序中保存证书的仓库密码服务端密钥私钥保护口令：服务端证书的密码27/37金蝶EASV8.0BOS银企平台用户手册5.3业务管理5.3.1全局业务配置全局业务配置与具体的银行无关，配置项影响的范围为整个银企平台。目前配置项较少。5.3.2银行业务配置银行业务配置为各家银行除了“前置机配置”外的业务配置项，在7.0.5之前都使用配置文件方式，目前以界面方式展示配置项。以建行现金管理平台为例：5.3.3账号管理账号的添加必须添加在某“银行版本”下面。账号可能会有些“附加属性”，设置后才可以做相应的业务，如建行现金管理28/37金蝶EASV8.0BOS银企平台用户手册平台“虚拟现金池”业务、批量代发业务等，这些配置项都是关联“账号”的：5.3.4币别管理系统初始化时，会初始化一些常用银行的币种映射。对于没有配置的银行插件或者币别，需要手动进行配置（币种对应的映射信息联系相关银行获取），方可进行业务；否则会报币种配置错误，无法进行业务操作。29/37金蝶EASV8.0BOS银企平台用户手册配置币种映射：5.4用户管理5.4.1用户列表30/37金蝶EASV8.0BOS银企平台用户手册管理登陆web客户端的用户，目前有两种角色：“管理员”、“普通用户”。有只“管理员”有操作右上角管理菜单的权限，“普通用户”只能操作左树业务菜单。5.5退出用户退出系统。5.6左侧业务菜单5.6.1余额列表所有的银行账号，选择“币别”后，点击账号对应的“查询余额”即可查询。查询完毕后，点击即可查看日志信息，包括客户端请求、响应信息以及请求前置机的请求、响应报文。点击可以高亮显示所查询的内容，方便定位。如下图31/37金蝶EASV8.0BOS银企平台用户手册鼠标移到红色字段上面，即可快速知道异常消息，如：5.6.2交易明细选定银行账号，币种，查询时间区间，明细类型，交易类型，点击“查询”“强制从银行下载所有”选中时，该账号指定时间范围内的明细都到银行重32/37金蝶EASV8.0BOS银企平台用户手册新获取（忽略银企平台的缓存）。5.6.3付款记录查询所有客户端提交的付款信息，并可以同步每一笔的付款状态，以及提供同步状态的相关日志。另外提供了付款记录查询的条件过滤，以便快速定位付款记录。5.6.4联动支付记录联动支付是银企平台7.0.5才添加的功能，有些银行可能提供了联动支付接口，会优先使用；对于银行没有提供的，银企平台会拆分成两步进行支付，一是划拨，一是对外支付。33/37金蝶EASV8.0BOS银企平台用户手册点击可查看联动支付每一步的执行过程以及结果。点击可查看日志。6注意事项6.1银企互联设置银企平台EBG705版，银行前置机的登录信息都需要在银企管理控制台中进行设置。详细配置请查看银企平台配置下“前置机”章节。（EAS703版之前银行前置机信息是在在EAS系统中设置的）6.2账户管理本版本需要在银企平台中设置账户信息，开通了银企互联的账户都需要在银企平台中重新设置，可通过EAS账户同步功能完成，也可在银企平台管理控制台中手工完成。（建议在EAS中设置，然后同步到银企平台）6.3其他事项说明暂无7银企版本支持银行列表对比银行名称版本名称银企6.0银企7.0.534/37金蝶EASV8.0BOS银企平台用户手册中国工商银行中国工商银行专业版不支持很少用户使用，已不再维护不支持中国工商银行普通版支持很少用户使用，已不再维护支持很少用户使用，已不再维护，不建议使用中国工商银行推广版支持支持中国农业银行中国农业银行企业银行平台3.0版本支持很少用户使用，已不再维护不支持农业银行公网版支持支持农业银行专线版不支持支持705新增农业银行网银版不支持支持705新增中国银行中国银行BOCNET5.0标准版支持支持中国银行银企对接版本不支持很少用户使用，已不再维护不支持中国银行（香港）中国银行（香港）直联版支持支持中国建设银行中国建设银行外联版本支持支持中国建设银行佛山版本不支持无用户使用，已不再维护不支持中国建设银行现金管理平台支持支持中国建设银行重客版本支持很少用户使用，已不再维护不支持中国交通银行中国交通银行直联版本支持支持中国交通银行银企通版本不支持很少用户使用，已不再维护不支持中国招商银行招行银企直联支持支持中国邮政储蓄中国邮政储蓄银行直联版不支持支持705新增中国民生银行中国民生银行3.0支持支持中国兴业银行中国兴业银行直联版本支持支持上海浦东发展银行上海浦东发展银行直联版本支持支持上海农商银行上海农商银行直联版支持支持上海银行上海银行直联版支持支持光大银行光大银行银企通V1.10支持支持平安银行平安银行直联版支持支持浙江商业银行浙江商业银行直联版支持支持35/37金蝶EASV8.0BOS银企平台用户手册宁波银行宁波银行直联版支持支持中信银行中信银行直联版本V3.0支持支持中信银行直联版本V2.0不支持很少用户使用，已不再维护不支持东亚银行东亚银行直联支持支持汇丰银行汇丰银行直联版本V1.13支持不支持未迁移至705版本渣打银行渣打银行H2H版本支持支持中国华夏银行中国华夏银行直联版本支持支持江苏银行江苏银行直联集团版支持支持江苏银行直联版支持不支持未迁移至705版本江苏农信社江苏农信社直联版支持支持厦门商业银行厦门商业银行银企支持支持广东发展银行广东发展银行直联版本支持支持徽商银行徽商银行直联版支持支持支付宝支付宝直联版支持支持齐鲁银行齐鲁银行直联版支持支持青岛银行青岛银行直联版支持支持通联支付通联通太保版不支持支持705新增北京银行北京银行直联版不支持支持705新增华融湘江银行华融湘江银行直联版不支持支持705新增江南农村商业银行江南农村商业银行直联版不支持支持705新增安徽农信安徽农信直联版不支持支持705新增浙江农信浙江银行直联版不支持支持705新增深圳发展银行深圳发展银行直联版支持支持东莞银行东莞银行直联版支持支持贵阳银行贵阳银行直联版支持不支持未迁移至705版本36/37金蝶EASV8.0BOS银企平台用户手册内蒙古银行内蒙古银行直联版支持不支持未迁移至705版本哈尔滨商业银行哈尔滨商业银行银企支持不支持未迁移至705版本8帮助与支持您可就近联系当地的金蝶营销服务机构以获取服务和技术支持。如您需要查询金蝶营销服务机构联系方式，可登录金蝶网站http://www.kingdee.com详细查询。想了解您购买的金蝶软件是否是正版产品，可登录http://www.kingdee.com/genuine/index.jsp进行校验。37/37
