银行银企直连开发指南.doc





《银行银企直连开发指南.doc》由会员分享,可在线阅读,更多相关《银行银企直连开发指南.doc(42页珍藏版)》请在淘文阁 - 分享文档赚钱的网站上搜索。
1、精品文档 仅供参考 学习与交流银行银企直连开发指南【精品文档】第 42 页银行直联系统开发指南修订记录日期修订版本修订人修订内容2010-10-181.0.0杨成海新建2011-9-271.0.1徐蓓FBSDK3.3发布,修改版本信息,更新5.1版本信息和6.1接口文档2011-11-211.0.2徐蓓FBSDK3.4发布,修改版本信息,更新5.1版本信息和6.1接口文档2012-02-231.0.3徐蓓FBSDK3.5发布,修改版本信息,更新5.1版本信息和6.1接口文档2012-04-131.0.4徐蓓FBSDK3.6发布,修改版本信息,更新5.1版本信息和6.1接口文档2013-4-21
2、.0.6杨成海FBSDK3.8发布,更新5.1版本信息和6.1接口文档2013-4-182.0.0杨成海FBSDK5.0发布,更新3.1.3菜单功能说明、5.1版本信息和6.1接口文档.删除原4.3.6国内信用证接口2013-4-192.0.1杨成海FBSDK5.1发布,增加二代KEY支持。2013-7-92.0.2徐蓓增加供应链金融功能(增加附录6.6)。修改了票据通的业务接口(附录6.3的接口文档);修改5.1版本信息;2013-8-152.0.3杨成海增加公司理财业务接口(附录6.1);更新供应链接口文档V1.1(附录6.6);修改5.1版本信息; 2013-9-32.0.4徐蓓修改人民
3、币现金池业务接口(附录6.1);更新供应链接口文档V1.2(附录6.6);修改5.1版本信息; 2013-9-122.0.5杨成海增加记账宝接口(附录6.1);修改5.1版本信息; 2013-10-102.0.6徐蓓FBSDK5.2发布;增加对跨境账户视图功能的支持(附录6.1);修改5.1版本信息; 修改5.3的版本查看方式。2013-10-292.0.7杨成海更新6.1接口文档2013-10-302.0.8徐蓓更新供应链接口文档V1.3(附录6.6);修改5.1版本信息2013-11-202.0.9杨成海(1) 代发代扣业务增加“代发工资额度查询接口”(2) 修改公司理财业务接口详情见附录
4、6.1。2014-1-82.1徐蓓更新6.1接口文档,增加新的支付和内转接口;把第4部分移入6.7嵌入式开发指南;修改5.1版本信息银行直联系统开发指南11系统简介31.1概述31.2背景31.2.1前置机式直联(推荐):31.2.2嵌入式直联:41.3阅读对象41.4术语定义42解决方案52.1概述52.2功能62.3整体要求72.3.1系统要求72.3.2技术要求72.3.3企业要求72.4开发流程72.4.1准备72.4.2开发82.4.3使用83前置机式93.1前置程序说明93.1.1概述93.1.2程序主界面说明93.1.3菜单功能说明103.1.4注意事项153.2通讯协议说明16
5、3.2.1概述163.2.2HTTP/HTTPS协议163.2.3SOCKET协议163.3XML报文格式163.3.1概述163.3.2格式三173.3.3格式一183.3.4格式二183.3.5说明193.4调用频率203.4.1说明203.5并发性能203.5.1说明204嵌入式215版本说明215.1版本信息215.2升级建议235.3查看版本信息246资源下载246.1银行银企直连接口说明书(XML格式三说明文档)246.2人行电子票据银企直连接口说明书(XML格式三)246.3银行票据通银企直连接口说明书(XML格式三)256.4XML格式一和格式二报文说明文档256.5开发范例源
6、码256.6供应链金融银企直连接口说明书266.7银行嵌入式银企直联开发指南261 系统简介1.1 概述本开发指南对银行企业银行直联系统(以下简称本系统)进行详细地描述,通过该指南可以对本系统有个全面地了解,并可用于指导如何在该系统上进行二次开发,实现与企业财务/ERP/电子商务交易平台等系统(以下简称企业财务系统)平滑对接和有机融合。 1.2 背景银行网上企业银行本身有一套完整的经办、审批机制,帮助企业规范财务制度、安全地做网上业务,但是它有一定的限制,就是必须在企业银行系统内封闭的完成。 很多企业都有一套自己的财务系统,企业使用财务系统生成一些经办业务需要的数据,如支付脱机制单数据、工资表
7、和收方信息等,然后将生成的数据交由企业银行系统经办和审批,再将银行返回的数据导入到财务系统中。目前企业财务系统与企业银行系统间只能以文件形式进行数据交换,而企业希望能在自己的系统内和企业银行间进行直接的数据交换。 基于以上情况,银行开发了本系统。本系统提供两种方式与企业财务系统对接。一种是前置机式;一种是嵌入式。 1.2.1 前置机式直联(推荐):即通过在企业内部网络内安装一台前置机(即安装了本系统并启动了直连服务的PC机),企业财务系统通过报文交互的方式与前置机通讯,以实现向企业银行系统发送指令,并接收银行返回的数据。 1.2.2 嵌入式直联:即通过在企业财务系统内部调用本系统提供的接口,实
8、现财务系统和企业银行间的直接交互。本系统作为财务系统的一个组成部分嵌入到财务系统,在财务系统和企业银行间采用不落地方式交换数据,财务系统通过本系统提供的接口直接向企业银行系统发送指令,并接收银行返回的数据。 嵌入式直联方式仅作向下兼容支持,新增客户请使用前置机式直联。1.3 阅读对象预期读者为利用本系统进行二次开发的相关人员,以及其他需要了解本系统的人员。 1.4 术语定义招行银企直联:银行提供的一种网上“企业银行”系统与企业的财务软件系统的直接联接的接入方式。招行企业网银:银行企业网银是使用本地客户端软件,通过Internet网络或其它信息网络,将用户电脑终端连接至银行,实现将银行服务直接送
9、到用户办公室和家中。它改变了银行传统的服务方式,是银行业务系统的扩充和延伸。用户管理:企业银行系统的用户分为系统管理员和一般用户。企业到银行申请开办“企业银行”业务时,由银行为企业生成两个系统管理员,两个系统管理员的权限完全平等,共同负责企业银行管理的工作。通常系统的设置必须由一个系统管理员进行经办而由另一个系统管理员进行授权,必须两个系统管理员同时认可后设置方才有效;系统管理员不能为自己设置业务权限,也不能对自己经办的系统设置进行授权。建议由公司财务经理担任系统管理员之一。一般用户由系统管理员使用“用户管理”功能增加到系统中,由系统管理员设置其权限。负责在权限内经办和授权各项企业银行业务。另
10、外,系统管理员也可具有业务权限,处理企业银行业务。业务管理:业务管理用于在网上企业银行上建立适应企业内部财务管理要求的业务操作规范。网上企业银行采用灵活的预设模式方式,实行“操作链”式管理,系统性地固化企业财务管理制度。客户可以自由定制企业内部财务授权管理模式,适应多种个性化财务管理需求。“操作链”形象地描述了企业内部财务管理的岗位设置、业务分工和业务流程,同时规定了岗位上不同身份的人员的操作权限和关系。“操作链”上设经办岗位一个,设审批岗位一级或多级。经办岗位可以设置多人,人数不限制。经办人员负责所有其有权处理的业务的制单发起操作,经办人员之间是同一级别的并列关系。每一级审批岗位只可以设一名
11、审批人员,审批人员负责其有权处理的业务的复核审批操作,不同级别审批岗位之间是上下级的关系,审批的权限依次增大,但是审批的流程必须依次进行,不得越级。备注:招行银企直联与招行企业网银共用一套用户管理、业务管理系统,后台业务处理系统也相同,是招行网上企业银行系统的两个不同接入渠道。用户、业务管理只能在企业网银上管理。CA(认证中心):(Certification Authority 认证中心)是用来颁发数字证书的权威机构,它具有权威性、公正性和可靠性。其主要任务是受理数字证书的申请、签发及对数字证书的管理。在受理申请的同时,一般还会核对申请者的身份,以确保正确。数字证书:数字证书是用电子手段来证实
12、一个用户的身份和对网络资源的访问权限。数字证书是由权威机构(CA)采用数字签名技术,颁发给用户,用以在数字领域中证实用户其本身的一种数字凭证。本系统的证书由银行CA签发,用于确认用户在招行企业银行系统中的身份。2 解决方案2.1 概述本系统支持两种直连方式: 前置机式:向本系统发送HTTP请求,实现和银行的直联。(具体请参考目录前置机式) 嵌入式:以Win32动态链接库(DLL)和JAVA开发包(jar)的方式提供编程调用接口,企业可利用这些接口进行相应的二次开发。该方式支持VC、VB、C#、DELPHI、CB、PB、JAVA等开发工具。(具体请参考目录嵌入式) 结构示意图如上图所示,企业可以
13、有自己完善的财务管理系统,公司内部资金调拨及对外支付先经过其内在的财务管理流程,再通过招行提供的编程接口把生成的指令直接提交到招行,招行根据该指令进行处理;企业的帐户信息、交易信息等也可以通过直联接口从招行获得。 2.2 功能 本系统目前提供的业务功能包括: 账户管理 支付结算 代发代扣 商务支付 委托贷款 定期业务 信用管理 人民币现金池 代理清算 外汇汇款 支付限额协议管理 资金余额管理大额划拨 外币现金池 人行电子票据 网上电子票据 供应链金融后续将根据市场需求,逐步添加其他业务。2.3 整体要求2.3.1 系统要求 硬件:建议Pentium133以上CPU,32MB RAM,至少256
14、色(建议16位以上真彩)显示,100M以上的空闲硬盘空间。对数字证书卡用户,需要一个串口或USB口,用于安装数字证书卡驱动器; 操作系统:建议中文/英文WINDOWS 98/NT/2000/XP/2003,对英文WINDOWS,需要外挂中文平台; 浏览器:必须安装Microsoft Internet Explorer 4.0以上的浏览器。本系统不支持Netscape的浏览器; 系统环境:建议使用一台电脑专门运行财务系统和直联系统,应确保系统中没有病毒、木马等有害程序。 2.3.2 技术要求 在正式使用直联系统前,请确认您所使用的财务系统和本系统的直联已在招行的测试环境下经过严格测试,并得到招行
15、技术部门的认证; 请确认所使用的本系统的动态库均有招行的数字签名。 2.3.3 企业要求 开通招行网上企业银行; 与招行签订直联协议; 开通帐户查询、直接支付等所需业务,经办用户需要拥有招行签发的数字证书卡。 2.4 开发流程2.4.1 准备 到所在地招行的分/支行开通招行企业银行; 到所在地招行的分/支行申请调试直联系统,银行分配用于测试的用户ID、密码等; 到招行网站下载本系统的开发工具包(包括开发包安装程序、本开发指南等); 运行开发包安装程序完成本系统的安装; 修改system32driversetchosts文件,增加两行数据:58.61.30.96 58.61.30.96 使用FB
16、SdkManager.exe或者FBSdkTest.exe修改通讯方式的服务器为测试机,如下图所示: 通过提供的测试程序验证测试环境是否正确。(注:在测试环境,允许经办用户采用非证书卡方式登录) 2.4.2 开发 根据提供的编程接口,在自己的财务系统上进行开发,实现所需要的业务功能(接口调用可参考提供的测试程序源代码); 对自己财务系统的业务功能进行测试(可根据提供的测试程序进行验证)。 2.4.3 使用 到所在地招行的分/支行签订直联协议; 到所在地招行的分/支行开通直接支付/账户查询等所需业务; 到招行网站下载本系统的正式发布包; 运行正式发布包安装程序完成本系统的安装; 在企业银行客户端
17、,由企业系统管理员对业务模式进行设置; 可在自己财务系统上进行相应的直联操作,完成相关业务。(注:在真实环境,经办用户必须采用证书卡方式登录) 专线用户,且无DNS服务器时需要在系统HOST文件中增加如下域名的映射:, 3 前置机式3.1 前置程序说明3.1.1 概述本系统支持HTTP/HTTPS/SOCKET请求,企业通过HTTP/HTTPS(POST方式)或SOCKET协议发送请求到前置程序FBSdkManager,并处理接收到的应答报文来实现和银行系统的交互。3.1.2 程序主界面说明1、系统菜单:详情见菜单功能说明。2、菜单工具栏:从左至右依次为:启动服务、停止服务、登陆银行、退出银行
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 银行 银企直连 开发 指南

限制150内