招商银行银企直连开发指南210.docx

招商银行银企直连开发指南210.docx

《招商银行银企直连开发指南210.docx》由会员分享，可在线阅读，更多相关《招商银行银企直连开发指南210.docx（26页珍藏版）》请在冰豆网上搜索。

招商银行银企直连开发指南210

招商银行直联系统开发指南

2.1

修订记录

日期

修订版本

修订人

修订内容

2010-10-18

1.0.0

杨成海

新建

2011-9-27

1.0.1

徐蓓

3.3发布，修改版本信息，更新5.1版本信息和6.1接口文档

2011-11-21

1.0.2

徐蓓

3.4发布，修改版本信息，更新5.1版本信息和6.1接口文档

2012-02-23

1.0.3

徐蓓

3.5发布，修改版本信息，更新5.1版本信息和6.1接口文档

2012-04-13

1.0.4

徐蓓

3.6发布，修改版本信息，更新5.1版本信息和6.1接口文档

2013-4-2

1.0.6

杨成海

3.8发布，更新5.1版本信息和6.1接口文档

2013-4-18

2.0.0

杨成海

5.0发布，更新3.1.3菜单功能说明、5.1版本信息和6.1接口文档.删除原4.3.6国内信用证接口

2013-4-19

2.0.1

杨成海

5.1发布，增加二代支持。

2013-7-9

2.0.2

徐蓓

增加供应链金融功能（增加附录6.6）。

修改了票据通的业务接口（附录6.3的接口文档）；修改5.1版本信息；

2013-8-15

2.0.3

杨成海

增加公司理财业务接口（附录6.1）；更新供应链接口文档V1.1（附录6.6）；修改5.1版本信息;

2013-9-3

2.0.4

徐蓓

修改人民币现金池业务接口（附录6.1）；更新供应链接口文档V1.2（附录6.6）；修改5.1版本信息;

2013-9-12

2.0.5

杨成海

增加记账宝接口（附录6.1）；修改5.1版本信息;

2013-10-10

2.0.6

徐蓓

5.2发布；增加对跨境账户视图功能的支持（附录6.1）；修改5.1版本信息;修改5.3的版本查看方式。

2013-10-29

2.0.7

杨成海

更新6.1接口文档

2013-10-30

2.0.8

徐蓓

更新供应链接口文档V1.3（附录6.6）；修改5.1版本信息

2013-11-20

2.0.9

杨成海

（1）代发代扣业务增加“代发工资额度查询接口”

（2）修改公司理财业务接口

详情见附录6.1。

2014-1-8

2.1

徐蓓

更新6.1接口文档，增加新的支付和内转接口；把第4部分移入6.7嵌入式开发指南；修改5.1版本信息

招商银行直联系统开发指南1

1系统简介3

1.1概述3

1.2背景3

1.2.1前置机式直联（推荐）：

3

1.2.2嵌入式直联：

4

1.3阅读对象4

1.4术语定义4

2解决方案5

2.1概述5

2.2功能6

2.3整体要求7

2.3.1系统要求7

2.3.2技术要求7

2.3.3企业要求7

2.4开发流程7

2.4.1准备7

2.4.2开发8

2.4.3使用8

3前置机式9

3.1前置程序说明9

3.1.1概述9

3.1.2程序主界面说明9

3.1.3菜单功能说明10

3.1.4注意事项15

3.2通讯协议说明16

3.2.1概述16

3.2.2协议16

3.2.3协议16

3.3报文格式16

3.3.1概述16

3.3.2格式三17

3.3.3格式一18

3.3.4格式二18

3.3.5说明19

3.4调用频率20

3.4.1说明20

3.5并发性能20

3.5.1说明20

4嵌入式21

5版本说明21

5.1版本信息21

5.2升级建议23

5.3查看版本信息24

6资源下载24

6.1招商银行银企直连接口说明书（格式三说明文档）24

6.2人行电子票据银企直连接口说明书（格式三）24

6.3招商银行票据通银企直连接口说明书（格式三）25

6.4格式一和格式二报文说明文档25

6.5开发范例源码25

6.6供应链金融银企直连接口说明书26

6.7招商银行嵌入式银企直联开发指南26

1系统简介

1.1概述

本开发指南对招商银行企业银行直联系统（以下简称本系统）进行详细地描述，通过该指南可以对本系统有个全面地了解，并可用于指导如何在该系统上进行二次开发，实现与企业财务电子商务交易平台等系统（以下简称企业财务系统）平滑对接和有机融合。

1.2背景

招商银行网上企业银行本身有一套完整的经办、审批机制，帮助企业规范财务制度、安全地做网上业务，但是它有一定的限制，就是必须在企业银行系统内封闭的完成。

很多企业都有一套自己的财务系统，企业使用财务系统生成一些经办业务需要的数据，如支付脱机制单数据、工资表和收方信息等，然后将生成的数据交由企业银行系统经办和审批，再将银行返回的数据导入到财务系统中。

目前企业财务系统与企业银行系统间只能以文件形式进行数据交换，而企业希望能在自己的系统内和企业银行间进行直接的数据交换。

基于以上情况，招商银行开发了本系统。

本系统提供两种方式与企业财务系统对接。

一种是前置机式；一种是嵌入式。

1.2.1前置机式直联（推荐）：

即通过在企业内部网络内安装一台前置机（即安装了本系统并启动了直连服务的机），企业财务系统通过报文交互的方式与前置机通讯，以实现向企业银行系统发送指令，并接收银行返回的数据。

1.2.2嵌入式直联：

即通过在企业财务系统内部调用本系统提供的接口，实现财务系统和企业银行间的直接交互。

本系统作为财务系统的一个组成部分嵌入到财务系统，在财务系统和企业银行间采用不落地方式交换数据，财务系统通过本系统提供的接口直接向企业银行系统发送指令，并接收银行返回的数据。

嵌入式直联方式仅作向下兼容支持，新增客户请使用前置机式直联。

1.3阅读对象

预期读者为利用本系统进行二次开发的相关人员，以及其他需要了解本系统的人员。

1.4术语定义

招行银企直联：

招商银行提供的一种网上“企业银行”系统与企业的财务软件系统的直接联接的接入方式。

招行企业网银：

招商银行企业网银是使用本地客户端软件，通过网络或其它信息网络，将用户电脑终端连接至银行，实现将银行服务直接送到用户办公室和家中。

它改变了银行传统的服务方式，是银行业务系统的扩充和延伸。

用户管理：

企业银行系统的用户分为系统管理员和一般用户。

企业到银行申请开办“企业银行”业务时，由银行为企业生成两个系统管理员，两个系统管理员的权限完全平等，共同负责企业银行管理的工作。

通常系统的设置必须由一个系统管理员进行经办而由另一个系统管理员进行授权，必须两个系统管理员同时认可后设置方才有效；系统管理员不能为自己设置业务权限，也不能对自己经办的系统设置进行授权。

建议由公司财务经理担任系统管理员之一。

一般用户由系统管理员使用“用户管理”功能增加到系统中，由系统管理员设置其权限。

负责在权限内经办和授权各项企业银行业务。

另外，系统管理员也可具有业务权限，处理企业银行业务。

业务管理：

业务管理用于在网上企业银行上建立适应企业内部财务管理要求的业务操作规范。

网上企业银行采用灵活的预设模式方式，实行“操作链”式管理，系统性地固化企业财务管理制度。

客户可以自由定制企业内部财务授权管理模式，适应多种个性化财务管理需求。

“操作链”形象地描述了企业内部财务管理的岗位设置、业务分工和业务流程，同时规定了岗位上不同身份的人员的操作权限和关系。

“操作链”上设经办岗位一个，设审批岗位一级或多级。

经办岗位可以设置多人，人数不限制。

经办人员负责所有其有权处理的业务的制单发起操作，经办人员之间是同一级别的并列关系。

每一级审批岗位只可以设一名审批人员，审批人员负责其有权处理的业务的复核审批操作，不同级别审批岗位之间是上下级的关系，审批的权限依次增大，但是审批的流程必须依次进行，不得越级。

备注：

招行银企直联与招行企业网银共用一套用户管理、业务管理系统，后台业务处理系统也相同，是招行网上企业银行系统的两个不同接入渠道。

用户、业务管理只能在企业网银上管理。

（认证中心）：

（认证中心）是用来颁发数字证书的权威机构，它具有权威性、公正性和可靠性。

其主要任务是受理数字证书的申请、签发及对数字证书的管理。

在受理申请的同时，一般还会核对申请者的身份，以确保正确。

数字证书：

数字证书是用电子手段来证实一个用户的身份和对网络资源的访问权限。

数字证书是由权威机构（）采用数字签名技术，颁发给用户，用以在数字领域中证实用户其本身的一种数字凭证。

本系统的证书由招商银行签发，用于确认用户在招行企业银行系统中的身份。

2解决方案

2.1概述

本系统支持两种直连方式：

∙前置机式：

向本系统发送请求，实现和银行的直联。

（具体请参考目录"前置机式"）

∙嵌入式：

以32动态链接库（）和开发包（）的方式提供编程调用接口，企业可利用这些接口进行相应的二次开发。

该方式支持、、、、、、等开发工具。

（具体请参考目录"嵌入式"）

结构示意图

如上图所示，企业可以有自己完善的财务管理系统，公司内部资金调拨及对外支付先经过其内在的财务管理流程，再通过招行提供的编程接口把生成的指令直接提交到招行，招行根据该指令进行处理；企业的帐户信息、交易信息等也可以通过直联接口从招行获得。

2.2功能

本系统目前提供的业务功能包括：

∙账户管理

∙支付结算

∙代发代扣

∙商务支付

∙委托贷款

∙定期业务

∙信用管理

∙人民币现金池

∙代理清算

∙外汇汇款

∙支付限额协议管理

∙资金余额管理大额划拨

∙外币现金池

∙人行电子票据

∙招商网上电子票据

∙供应链金融

后续将根据市场需求，逐步添加其他业务。

2.3整体要求

2.3.1系统要求

∙硬件：

建议133以上，32，至少256色（建议16位以上真彩）显示，100M以上的空闲硬盘空间。

对数字证书卡用户，需要一个串口或口，用于安装数字证书卡驱动器；

∙操作系统：

建议中文/英文9820002003，对英文，需要外挂中文平台；

∙浏览器：

必须安装4.0以上的浏览器。

本系统不支持的浏览器；

∙系统环境：

建议使用一台电脑专门运行财务系统和直联系统，应确保系统中没有病毒、木马等有害程序。

2.3.2技术要求

∙在正式使用直联系统前，请确认您所使用的财务系统和本系统的直联已在招行的测试环境下经过严格测试，并得到招行技术部门的认证；

∙请确认所使用的本系统的动态库均有招行的数字签名。

2.3.3企业要求

∙开通招行网上企业银行；

∙与招行签订直联协议；

∙开通帐户查询、直接支付等所需业务，经办用户需要拥有招行签发的数字证书卡。

2.4开发流程

2.4.1准备

∙到所在地招行的分/支行开通招行企业银行；

∙到所在地招行的分/支行申请调试直联系统，银行分配用于测试的用户、密码等；

∙到招行网站下载本系统的开发工具包（包括开发包安装程序、本开发指南等）；

∙运行开发包安装程序完成本系统的安装；

∙修改32\\\文件，增加两行数据：

58.61.30.96

58.61.30.96

∙使用或者修改通讯方式的服务器为测试机，如下图所示：

∙通过提供的测试程序验证测试环境是否正确。

（注：

在测试环境，允许经办用户采用非证书卡方式登录）

2.4.2开发

∙根据提供的编程接口，在自己的财务系统上进行开发，实现所需要的业务功能（接口调用可参考提供的测试程序源代码）；

∙对自己财务系统的业务功能进行测试（可根据提供的测试程序进行验证）。

2.4.3使用

∙到所在地招行的分/支行签订直联协议；

∙到所在地招行的分/支行开通直接支付/账户查询等所需业务；

∙到招行网站下载本系统的正式发布包；