银企平台介绍2019/7熟悉银企平台产品蓝图熟悉银企平台主要功能熟悉银企业务场景掌握银企平台安装部署掌握银企常见问题分析技巧课程目的产品介绍–概述/服务能力/客户应用案例/销售政策部署说明–硬件配置要求–安装配置过程介绍/代理程序使用说明关键特性说明–安全–通用数据：行名行号/地区码/省市代码/联行号/清算行号–KD标识/对账码/日常运维–银企日志分析–未提交/交易未确认付款/付款失败场景目录概述什么是银企平台？业界称为银企互联，也有厂商称网银适配器，银企通。银企互联是指通过企业财务系统与银行网上银行系统的有机互联，整合银行、企业双方的系统资源，从而带给企业客户提供安全、快捷、实时、个性化的金融服务。它是银行系统与企业的财务系统在线直接联接的一种接入方式。一般采用VPN或专线连接方式，实现企业系统和银行系统的对接。屏蔽了不同银行数据格式、连接方式的不同，将其转换为统一的内部标准数据格式与统一的连接方式，业务系统只需要与内部标准接口交互。银行系统VPN/专线ERP/财务系统银企平台银企互联VS网上银行网上银行指客户通过通用浏览器（如微软的IE浏览器）或者银行客户端软件方式登录银行的网上银行系统，获得银行服务和查询相关银行业务处理情况。银企互联网上银行对比分析业务方式所有银行功能集中在一个平台每家银行都有不同KEY，分别登录各家银行网站集成度高，操作简便业务处理速度速度较快。查询过的数据保存在企业端，查询速度快速度较慢，公网容易受网络条件影响处理速度快，实时响应操作便利性在财务系统或ERP中操作，所有银行统一操作流程每个银行都有一套特有操作流程。操作统一个性化服务通过网银接口，在业务系统中可以定制个性化服务固有功能可以灵活定制创新服务银企平台产品蓝图安全管理IP地址限制系统管理业务接口服务前置机配置银行配置测试连接数据中心限制CA配置对公/对私付款电子回单下载电子回单电子商业汇票工商银行交易明细查询代发等农业银行建设银行中国银行更多……许可管理日志备份接口类型业务系统webservicejsonEAS金蝶云星空K/3WISE银行前置机支付通道管理用户管理数据转储业务管理银行账户管理行名行号业务参数配置币别管理招商银行前置机代理账户头寸与结算余额查询信用证补丁安装工具第三方支付接口支付宝通联银企平台架构WebServiceJSONK/3CLOUD银行前置机系统银行前置机系统银企管理控制台管理应用（License、配置、行名行号、地区码维护、交易状态监控等）HTTPSFTPTCP银企前置机代理工商银行农行工行普通版.银企插件VPN/专线中国银行建设银行银企平台银行前置机银行服务EAS第三方系统数据库(sqlserver/oracle)中间件(自带，免费)业务接口银行扩展安全组件付款提交付款状态同步后台任务CA加密、签名IP地址白黑名单数据中心限制K/3WISE业务接口功能账户头寸一般结算集团应用扩展业务金蝶云星空支持银行列表---账户查询及支付接口1中国银行2中国农业银行3中国工商银行4中国建设银行5交通银行6招商银行7中国光大银行8平安银行9兴业银行10华夏银行11中信银行12民生银行13广东发展银行14中国邮政储蓄银行15国家开发银行16安徽农信社联合社17中国银行（香港）18汇丰银行19渣打银行20东亚银行21北京银行22北京农商银行23邯郸银行24天津银行25邢台银行26上海浦东发展银行27上海银行28上海农商银行29华融湘江银行30江南农村商业银行31江苏农信社32南京银行33宁波银行34青岛银行35齐鲁银行36顺德农商银行支持银行列表---账户查询及支付接口49渤海银行50中原银行51内蒙古银行52支付宝53齐商银行54潍坊银行55烟台银行56威海市商业银行57临商银行58日照银行59德州银行60莱商银行37厦门商业银行38浙江农村信用社联合社39浙江商业银行40杭州银行41江苏银行42广西北部湾银行43桂林银行44徽商银行45安徽霍山联合村镇银行46盛京银行47深圳农村商业银行48东莞银行61东营银行62济宁银行63泰安银行64枣庄银行65长安银行66广州农商银行支持银行列表---电子回单接口序号银行名称版本回单文件格式1中国银行NET版本(BOC_NET)pdf文件2中国农业银行农业银行公网版（ABC_DC）pdf文件3中国农业银行农业银行专线版（ABC_EB）pdf文件4中国工商银行推广版（ICBC_CMP）pdf文件5中国工商银行推广版（ICBC_CMP）xml格式（默认）6中国建设银行建设银行企业现金管理直连（CCB_CCIP）pdf文件7中国建设银行中国建设银行外联版pdf文件8中国交通银行交通银行直连版pdf文件9邮政储蓄银行pdf文件10平安银行直连版(PAB_DC)报文格式（xml）11招商银行招商银行直连版（CMB_DC）pdf文件12光大银行直连版(CEB_DC)报文格式（xml）13兴业银行直连版(CIB_DC)报文格式（xml）14内蒙古银行直连版pdf文件15华夏银行直连版(HXB_DC)报文格式（xml）16中信银行直连版pdf文件17民生银行直连版(CMBC_DC)pdf文件18广发银行pdf文件注：中国农业银行仅内蒙古分行、苏州分行支持电子回单银企平台价值多业务系统无缝接入与EAS,K/3WISE,K/3CLOUD等系统无缝接入，满足多种资金业务需求。实时全面资金监控与网上银行系统建立实时通道，实现集中高效的资金交易。全面、及时、准确的对企业所有账户资金变动情况进行有效监控。为业务提供统一接口屏蔽银行间接口差异，为业务提供统一接口，提升业务开发效率。丰富的银行接口标准产品支持66家银行；扩展能力强，能够快速开发支持新银行。安全等级高完善的安全支付解决方案。典型客户银企平台概况66家合作银行1000+银企直联客户12000+个银行账户单一客户20万笔交易/天单一客户8000亿元支付额/年单一客户EAS,星空,SAP多种业务系统接入快速连接新银行插件开发，功能扩展金蝶银企平台销售政策参考《金蝶EASV8.5系统标准报价（注册模式）》发文；BOS银企平台独立许可，许可按照银行前置机数量及模块计算。银企互联平台（标准版）账户查询及支付接口、电子回单，电子商业汇票三个模块。平台报价5万元，默认包含两个账户查询及支付接口许可。账户查询及支付接口3万元/许可，电子回单2万元/许可，电子商业汇票3万元/许可。订货系统中选择EAS,EAS大类下面EBP银企互联，许可按照接入的银行（银行前置机）数量，选择的模块计算。金蝶云星空私有云金蝶云星空网上银行模块VPN通道+银企互联模块++银企互联平台（标准版）+银企互联平台（标准版）销售说明产品介绍概述/服务能力/客户应用案例/销售政策部署说明–部署流程/硬件配置要求–安装配置过程介绍/代理程序使用说明关键特性说明–安全–通用数据：行名行号/地区码/省市代码/联行号/清算行号–KD标识/对账码日常运维–银企日志分析–未提交/交易未确认付款/付款失败场景目录实施完整流程服务器及配置要求类别名称要求服务器银企平台服务器建议Windows或linux操作系统Cpu>4,memory>=8GB银行前置机建议一家银行一台机器,一般是windows系统配置要求请参考银行要求网络互联网，专线或VPN银行要求，保障前置机与银行服务通讯安全基础软件银企平台数据库Sqlserver或Oracle银企平台当前按照许可模式销售，私有部署在企业端环境。如果对接的业务系统是金蝶云星空，则需要通过VPN保证星空与银企平台之间通讯安全。如果私有部署金蝶云星空，则在星空与银企平台之间不需要部署VPN。不需要购买中间件；产品介绍–概述/服务能力/客户应用案例/销售政策部署说明–硬件配置要求–安装配置过程介绍/代理程序使用说明关键特性说明–安全–通用数据：行名行号/地区码/省市代码/联行号/清算行号–KD标识/对账码/日常运维–银企日志分析–未提交/交易未确认付款/付款失败场景目录银企平台实施过程结合三方（ERP，银企平台和银行）部署结构，实施即是针对三方分别进行1,银行前置机安装、证书配置2,银企平台安装、参数配置3,ERP系统维护账号、银企服务设置4,查询交易明细测试前置机（银行提供）银行银企直联服务HTTP或TCP通信报文企业局域网公网或专线321银企平台ERP前置机安装与配置应用场景由银行方提供软件及配置说明文档，并进行初始安装和配置。配置地址、通信端口、签名等。注意事项配置操作文档由银行交由客户留存。银行方确认前置机程序正常运行后，再进行银企业务操作。通过日志辅助分析银行前置机状态。银行前置机安装与配置银企平台安装与配置---安装包、补丁下载前置机配置初始化启动安装银企平台安装包与补丁银企平台安装包：目前银企平台最新的安装包可以在金蝶企业云盘上下载，下载地址：https://pan.kingdee.com/s/MTA5MzU0NSwyZjIx银企平台补丁：登录mykingdee，进入KSM--》补丁下载，查找“银企平台”，安装最新日期银企补丁。银企平台安装与配置---安装银企平台注意事项：linux下安装需要图形界面，可能需要安装以下类库。使用以下脚本完成安装。sudoyuminstall-yperl-Digest-MD5sudoyuminstall-yglibc.i686sudoyuminstall-ylibXext.i686前置机配置初始化启动安装银企平台安装包与补丁银企平台安装与配置---启动注意事项：启动脚本，停止脚本（分OS提供）Linux下运行请执行linux_startup.sh进行后台运行（putty等连接工具退出后不会停止）。如果需要登录web界面，需要启动银企客户端（银企安装目录下tomcat）前置机配置初始化启动安装银企平台安装包与补丁银企平台安装与配置---初始化注意事项：请使用chrome或是FireFox浏览器进行初始化。使用银企8.0以上许可需要打上最新补丁方可支持。需要先在数据库中创建银企数据库，sqlserver数据库【排序规则】Chinese_PRC_CI_AI前置机配置初始化启动安装银企平台安装包与补丁新安装银企平台，启动完会自动跳转到初始化界面，如果未自动跳转请手动在浏览器地址栏输入http://127.0.0.1:5389/system/ebserver-config/进入初始化页面。银企平台测试许可申请1，mykingdee–>金蝶专区–>iCRM2，进入流程中心页签，选择限时license流程申请3，特征码来源4，选择产品名称5，提交申请6，等待审批7，下载许可注意：不要选择BOS银企平台，BOS银企平台（EBP），这是教学版功能说明银企平台安装与配置---补丁安装注意事项与说明：推荐使用补丁安装工具进行安装（有备份功能）。如需要重新初始化银企平台，请清空ebservice目录下server.properties文件内容后，重启银企平台登陆初始化界面进行初始化。前置机配置初始化启动安装银企平台安装包与补丁手动安装或是使用补丁安装工具安装手动安装：1.解压补丁到ebservice750目录下覆盖原文件。2.执行对应的数据库初始化脚本windows_ebg_db_init.bat（区分操作系统）。补丁安装工具安装请参考补丁安装手册http://club.kingdee.com/forum.php?mod=viewthread&tid=997541银企平台安装与配置---导入许可注意事项：银企平台初始化时可导入试用许可，生产环境请使用正式许可。使用银企8.0以上许可需要打上最新补丁方可支持。前置机配置初始化启动安装银企平台安装包与补丁银企平台安装与配置---前置机配置前置机配置初始化启动安装银企平台安装包与补丁注意事项与说明：服务器IP和端口填入银行前置机的IP和端口。客户号密码等参数由银行方提供，可以参考银行的实施手册或咨询银行实施人员。测试查询交易明细-维护账号信息维护账号请参考：账户，开户地区等资料维护在ERP端维护账号后，点开银企平台业务管理-账号管理会有ERP端维护好的账号。为方便测试现在银企平台端维护账号进入银企平台web界面业务管理-账号管理注意事项与说明：生产环境请严格按要求在ERP端进行账号维护。开户行地区码和机构号ERP中无法维护，需要在此界面进行维护。地区码信息由银行方提供。以上参数仅供参考，生产环境以实际为准。查询交易明细维护银行账号测试查询交易明细-维护账号信息业务首页-交易明细菜单选择刚才配置好的账号信息，选择时间段进行查询。查询交易明细维护银行账号注意事项与说明：以上参数仅供参考，生产环境以实际为准。如果查询7天前且之前查询过的交易明细不会连接银行进行查询，直接取本地数据库里的记录。银企服务器代理程序使用说明金蝶建行企业现金直连前置机配置说明.doc金蝶农行公网版前置机代理程序部署指南.doc农行的交易明细查询文件产生在前置机机器目录，需要在银企平台可访问，通过代理程序访问是其中一种方式。需要部署前置机代理程序。付款文件也需要通过代理程序传递到前置机。建行前置机代理程序部署后，银企平台通过前置机代理程序访问建行银行服务。银企平台农行代理程序农行前置机农行前置机机器交易明细文件目录批量付款文件文件目录付款状态文件目录产品介绍–概述/服务能力/客户应用案例/销售政策部署说明–硬件配置要求–安装配置过程介绍/代理程序使用说明关键特性说明–安全–通用数据：行名行号/地区码/省市代码/联行号/清算行号–KD标识/对账码日常运维–银企日志分析–未提交/交易未确认付款/付款失败场景目录产品介绍–概述/服务能力/客户应用案例/销售政策部署说明–硬件配置要求–安装配置过程介绍/代理程序使用说明关键特性说明–安全–通用数据：行名行号/地区码/省市代码/联行号/清算行号–KD标识/对账码日常运维–银企日志分析–未提交/交易未确认付款/付款失败场景目录银企安全方案VPN/专线ERP应用服务器银企平台ERP客户端/浏览器ERP数据库招商银行工商银行建设银行终端用户群由银行保障安全SSL/加密传输CA身份认证/短信验证码加密存储HTTPS/CA限制IP和端口CA身份认证银行前置机物理隔离：1、IP绑定2、独立网络3、专用机柜安全保障体系——支付防重，日志及监控•业务单据ID重复检查•支付请求唯一支付ID防止重复支付•业务请求端到端全流程日志记录•请求银行报文及银行响应报文全记录•快速日志搜索，日志文件自动备份完整日志记录•每天交易笔数统计•未知状态交易分析•未提交交易检查业务监控•业务系统IP地址白名单•业务系统ID限制•支付通道时间限制接入限制接入方配置支付通道开关。在上班时间开放支付通道。IP地址黑白名单。限制接入方，一般配置EAS应用服务器IP地址为白名单。接入方ID验证开关。保证同一个IP地址来的某一个数据中心可以接入。防止测试数据中心连接正式银企平台。安全设置---接入方配置产品介绍–概述/服务能力/客户应用案例/销售政策部署说明–硬件配置要求–安装配置过程介绍/代理程序使用说明关键特性说明–安全–通用数据：行名行号/地区码/省市代码/联行号/清算行号–KD标识/对账码日常运维–银企日志分析–未提交/交易未确认付款/付款失败场景目录行名行号行名行号：银行联行号就是一个地区银行的唯一识别标志。用于人民银行所组织的大额支付系统\小额支付系统\城市商业银行银行汇票系统\全国支票影像系统（含一些城市的同城票据自动清分系统）等跨区域支付结算业务。由12位组成：3位银行代码+4位城市代码+4位银行编号+1位校验位。银行的名称与编码；全国具有唯一性。当前全国大概有15万条行名行号数据。行名行号数据也随着银行的产生或合并，银行网点的变化而变化。另外，并不是每一个银行网点都有一个行名行号，不少银行网点拥有相同的行名行号。金蝶行名行号系统：金蝶提供了实时的行名行号系统，数据来源于某商业银行，每周同步更新一次。数据已经相对准确实时。提供全国行名行号查询及数据下载。地址：http://web20.kingdee.com/eb_cloud_cnaps/行名行号库不存在的银行行号--银行合并或撤销或是小的营业网点，需要查询银行官网，找银行公告或找到银行网点电话，电话咨询确认对应的行号。招行地区码地区码：地区代码，代表一个区域，少数银行有此概念。招商银行全国共有30多个地区码，在余额查询，明细查询，付款等交易中都要求提供地区码，没有地区码或者地区码错误都将导致操作报错。招商银行提供接口查询账号对应的地区码。在银企平台中，在银行账号管理中，地区码是账号的一个属性。使用场景：招商银行支付（PAYMENT）,直接支付（DCPAYMNT）时,必须填写付方开户地区代码也必须填写收方的身份，城市，这些都是从招行的地区码excel数据文件中获取。其中定义了全国所有的省份与城市，城市对应的地区码等。在余额查询与交易明细查询时也需要付方账户地区码。数据文件位置：招商银行的地区码与省市代码在如下配置文件定义：招商银行地区码配置文件为cmbareadcode.xls.插件位置：银企平台安装目录/ebservice/bundles/com.kingdee.ebservice.cmb.dc_1.0.2.jar,打开压缩包，com.kingdee.bos.ebservice.banks.cmb.dc.area.cmbareacode.xls注意事项：当有城市名称发生变化时需要在这份excel数据文件中同步调整。农行省市代码省市代码或地区码：农业银行中省市代码就是地区码，代表一个区域，农业银行全国共有30多个地区码，在余额查询，明细查询，付款等交易中都要求提供地区码，没有地区码或者地区码错误都将导致操作报错。在银企平台中，在银行账号管理中，地区码是账号的一个属性，另外在插件包中也有一份省市带的数据文件。使用场景：农业银行单笔对私（CFRT21），对公（CFRT02）等接口必须有借贷账户开户地区省市代码，可以在界面配置，也可以从农行的省市代码excel数据文件中获取。其中定义了全国所有的省份的省市代码等。在余额查询与交易明细查询时也需要付方账户省市代码，需要在账户管理中维护。数据文件位置：农业银行的省市代码在如下配置文件定义：农业银行地区码配置文件为农业银行省市代码.xls.插件位置：银企平台安装目录/ebservice/bundles/com.kingdee.ebservice.abc.eb_1.0.2.jar,打开压缩包，com.kingdee.bos.ebservice.banks.abc.dc.area.农业银行省市代码.xls注意事项：当有城市名称发生变化时需要在这份excel数据文件中同步调整。中国银行省联行号省联行号或地区码：中国银行中省联行号就是地区码，代表一个区域，中国银行全国共有30多个地区码，在余额查询，明细查询，付款等交易中都要求提供地区码，没有地区码或者地区码错误都将导致操作报错。在银企平台中，在银行账号管理中，地区码是账号的一个属性。一般查询类操作直接从账号管理中获取省市代码；另外在插件包中也有一份省市的数据文件，一般在付款时使用到此文件，根据文件定义的映射关系获取省市代码。使用场景：中国银行支付接口必须有借贷账户开户地区省联行号，可以在界面配置，也可以从中行的省市代码excel数据文件中获取。其中定义了全国所有省份的省联行号等。在余额查询与交易明细查询时也需要付方账户省联行号，需要在账户管理中维护地区码字段。数据文件位置：中国银行的省联行号在如下配置文件定义：中国银行地区码配置文件为areaCode.xls.插件位置：银企平台安装目录/ebservice/bundles/com.kingdee.ebservice.boc.net_1.0.2.jar,打开压缩包，com.kingdee.bos.ebservice.banks.boc.net.area.areaCode.xls注意事项：当有城市名称发生变化时需要在这份excel数据文件中同步调整。KD标识/对账码名称说明：通过银企直连进行的付款，在打开KD标识的前提下，对应的交易明细中将带有kd标识（对账码）。在提交银企付款时，银企平台产生KD标识，返回给业务系统，存储到付款单的某个字段。同时银企平台将kd标识附加到提交银行付款的摘要或者业务参考号上。银行在形成的交易明细中摘要或业务参考号中将带有此标识，从而将交易明细与付款单关联起来。应用场景：通过kd标识进行对账。付款单与交易明细对账。支持单据：EAS付款单，金蝶云星空付款单支持银行：常用银行支持；大部分银行需要通过配置参数开启KD标识。当前建行默认开启KD标识。接口路由说明最终确定使用银行接口及参数值；使用什么单据付款影响付款路由；银行业务配置参数影响付款路由；账号管理中账号类型等影响付款路由；全局业务配置影响付款路由；产品介绍–概述/服务能力/客户应用案例/销售政策部署说明–硬件配置要求–安装配置过程介绍/代理程序使用说明关键特性说明–安全–通用数据：行名行号/地区码/省市代码/联行号/清算行号–KD标识/对账码日常运维–银企日志分析–未提交/交易未确认付款/付款失败场景目录连通类问题分析方法前置机（银行提供）银行银企直联服务银企平台ERP相邻的两个节点之间网络是否通畅？Pingiptelnetipport先保障网络通畅，再分析应用问题非法接入方问题现象非法接入方问题解决当开启过滤IP将服务器的ip地址配置到过滤ip列表，将银企web配置到接入方ID列表功能说明银企web界面，系统管理-日志文件系统菜单。bank_message下为银企平台发给银行的日志。mbt_invoke下为EAS请求银企平台的日志。日志pay开头为付款日志，detail为查询交易日志，balance为查询余额日志。登陆银企平台web端进入系统管理-日志备份菜单进行备份操作。备份该段时间内的所有日志直接下载即可日志文件系统出现业务问题的所在那一天银企日志信息：1)银行通信日志(银企平台'某银行'日志，某银行通过"银行简码"标志)~\ebservice\logs\bank_message\银行简码\银行简码-X\yyyy_mm_dd(文件夹)2)银企平台日志：~\ebservice\logs\ebgateway_debug.log~\ebservice\logs\ebgateway_debug.log.yyyy-mm-dd3)EAS系统上送到银企平台的日志在mbtv_invoke目录下对应的日期日志。~\ebservice\logs\mbts_invoke\yyyy-mm-dd日志文件分析日志文件分析产品介绍–概述/服务能力/客户应用案例/销售政策部署说明–硬件配置要求–安装配置过程介绍/代理程序使用说明关键特性说明–安全–通用数据：行名行号/地区码/省市代码/联行号/清算行号–KD标识/对账码日常运维–银企日志分析–未提交/交易未确认付款/付款失败场景目录业务请求处理机制业务系统银企平台银行前置机付款指令明细查询余额查询1,保存付款数据2,付款线程招商银行对公招商银行对私中国银行对公中国银行对私待提交银行付款3,同步状态线程招商银行对公招商银行对私中国银行对公中国银行对私招商银行前置机中国银行前置机工商银行前置机前置机锁管理器招行锁中行锁工行锁查询余额查询明细<7天招商银行前置机2招商银行前置机3交易明细数据提交最长时间/未提交记录查询登录银企平台后台管理系统->工具->异常付款检查菜单，可以查看当前各种疑似异常付款付款最长提交时间配置参数：在ebservcie/configuration/config.ini中，参pay_timeout_minutes，如果付款没有提交银行。检查是否付款记录比较多，付款时间太短导致，可以调大此参数Thanksterimakasih感謝谢谢ありがとうขอบคุณ
