招商银行直联系统开发的指南.docx
《招商银行直联系统开发的指南.docx》由会员分享,可在线阅读,更多相关《招商银行直联系统开发的指南.docx(67页珍藏版)》请在冰点文库上搜索。
招商银行直联系统开发的指南
日期
修订版本
修订人
修订容
2010-10-18
1.0.0
成海
新建
2011-9-27
1.0.1
徐蓓
FBSDK3.3 发布,修改版本信息,更新 5.1 版本信息
和 6.1 接口文档
2011-11-21
1.0.2
徐蓓
FBSDK3.4 发布,修改版本信息,更新 5.1 版本信息
和 6.1 接口文档
2012-02-23
1.0.3
徐蓓
FBSDK3.5 发布,修改版本信息,更新 5.1 版本信息
和 6.1 接口文档
2012-04-13
1.0.4
徐蓓
FBSDK3.6 发布,修改版本信息,更新 5.1 版本信息
和 6.1 接口文档
2013-4-2
1.0.6
成海
FBSDK3.8 发布,更新 5.1 版本信息和 6.1 接口文档
2013-4-18
2.0.0
成海
FBSDK5.0 发布,更新 3.1.3 菜单功能说明、5.1 版本
信息和 6.1 接口文档.删除原 4.3.6 国信用证接口
2013-4-19
2.0.1
成海
FBSDK5.1 发布,增加二代 KEY 支持。
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
徐蓓
FBSDK5.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 版本信息
2014-1-24
2.1.1
成海
更新 6.1 接口文档:
增加购汇申请接口、联动支付接
招商银行直联系统开发指南
version 2.1.17
修订记录
口;修改 5.1 版本信息
2014-3-17
2.1.2
成海
更新 6.1 接口文档:
修改外汇汇款接口;修改 5.1 版
本信息
2014-3-17
2.1.3
徐蓓
更新 6.6 供应链金融银企直连接口说明书;修改 5.1
版本信息
2014-4-30
2.1.4
成海
更新 6.1 接口文档
2014-5-6
2.1.5
徐蓓
新增国信用证直联接口;更新 6.1 和 6.2 接口文档;
修改 5.1 版本信息
2014-5-28
2.1.6
成海
新增智能定期存款接口;更新 6.1 接口文档;修改 5.1
版本信息
2014-6-24
2.1.7
徐蓓
发布前置机程序 FBSDKV5.5;新增 C+账户及组合存
款接口;更新 6.1 接口文档到 V5.10.0;修改 5.1 版本
信息
2014-8-9
2.1.8
徐蓓
更新 6.1 接口文档到 V5.11.0:
信贷平移相关功能增
改,记账宝增加批量新增虚拟户功能;更新 6.3 接口
文档到 V1.3:
修改票据通额度查询;修改 5.1 版本信
息
2014-9-10
2.1.9
徐蓓
增加 6.8 网银互联(人行超级网银)直联接口;修改
5.1 版本信息
2014-9-10
2.1.10
徐蓓
发布供应口 V1.5,见 6.6;修改 5.1 版本信息
2014-11-05
2.1.11
徐蓓
发布供应口 V1.5.1,见 6.6;修改 5.1 版本信息
2014-11-19
2.1.12
徐蓓
更新 6.1 接口文档到 V5.12.0:
增加商务支付订单确
认接口;修改 5.1 版本信息
2014-11-22
2.1.13
徐蓓
发布供应口 V1.6,见 6.6;修改 5.1 版本信息
2014-11-26
2.1.14
徐蓓
更新 6.1 接口文档到 V5.13.0:
修改联动支付功能接
口;更新 6.3 接口文档到 V1.4:
票据通查询接口的付
款联行号长度由 6 位升级到 20 位。
2014-12-18
2.1.15
徐蓓
增加 6.9 国际业务直联接口说明书;修改 6.1 接口文
档;修改 5.1 版本信息
2015-03-18
2.1.16
徐蓓
更新 6.6 供应口文档到 V1.7;更新 6.1 接口文档;
1.4 增加业务模式的说明;增加 3.1.3 中查询模式的说
明;修改 5.1 版本信息
2015-05-06
2.1.17
徐蓓
增加 2.3.4 网络要求;发布供应口 V1.8,见 6.6;
修改 5.1 版本信息
招商银行直联系统开发指南...................................................................................................1
1 系统简介.......................................................................................................................................4
1.1 概述 ...................................................................................................................................4
1.2 背景 ...................................................................................................................................4
1.2.1 前置机式直联(推荐):
.....................................................................................4
1.2.2 嵌入式直联:
.........................................................................................................4
1.3 阅读对象 ...........................................................................................................................5
1.4 术语定义 ...........................................................................................................................5
2 解决方案.......................................................................................................................................6
2.1 概述 ...................................................................................................................................6
2.2 功能 ...................................................................................................................................7
2.3 整体要求 ...........................................................................................................................8
2.3.1 系统要求.................................................................................................................8
2.3.2 技术要求.................................................................................................................8
2.3.3 企业要求.................................................................................................................8
2.3.4 网络要求.................................................................................................................8
2.4 开发流程 ...........................................................................................................................9
2.4.1 准备.........................................................................................................................9
2.4.2 开发.......................................................................................................................10
2.4.3 使用.......................................................................................................................10
3 前置机式.....................................................................................................................................11
3.1 前置程序说明 .................................................................................................................11
3.1.1 概述.......................................................................................................................11
3.1.2 程序主界面说明...................................................................................................11
3.1.3 菜单功能说明.......................................................................................................12
3.1.4 注意事项...............................................................................................................18
3.2 通讯协议说明 .................................................................................................................19
3.2.1 概述.......................................................................................................................19
3.2.2 HTTP/HTTPS 协议 ...............................................................................................19
3.2.3 SOCKET 协议 .......................................................................................................19
3.3 XML 报文格式 ................................................................................................................19
3.3.1 概述.......................................................................................................................19
3.3.2 格式三...................................................................................................................20
3.3.3 格式一...................................................................................................................21
3.3.4 格式二...................................................................................................................21
3.3.5 说明.......................................................................................................................22
3.4 调用频率 .........................................................................................................................23
3.4.1 说明.......................................................................................................................23
3.5 并发性能 .........................................................................................................................23
3.5.1 说明.......................................................................................................................23
4 嵌入式.........................................................................................................................................24
5 版本说明.....................................................................................................................................24
5.1 版本信息 .........................................................................................................................24
5.2 升级建议 .........................................................................................................................27
5.3 查看版本信息 .................................................................................................................27
6 资源下载.....................................................................................................................................28
6.1 招商银行银企直连接口说明书(XML 格式三说明文档).............................................28
6.2 人行电子票据银企直连接口说明书(XML 格式三).....................................................28
6.3 招商银行票据通银企直连接口说明书(XML 格式三).................................................28
6.4 XML 格式一和格式二报文说明文档 ............................................................................28
6.5 开发例源码 .................................................................................................................29
6.6 供应链金融银企直连接口说明书 .................................................................................29
6.7 招商银行嵌入式银企直联开发指南 .............................................................................30
6.8 网银互联(人行超级网银)直联接口说明书 .............................................................30
6.9 国际业务直联接口说明书 .............................................................................................30
1 系统简介
1.1 概述
本开发指南对招商银行企业银行直联系统(以下简称本系统)进行详细地描述,通过该指南
可以对本系统有个全面地了解,并可用于指导如何在该系统上进行二次开发,实现与企业财
务/ERP/电子商务交易平台等系统(以下简称企业财务系统)平滑对接和有机融合。
1.2 背景
招商银行网上企业银行本身有一套完整的经办、审批机制,帮助企业规财务制度、安全地
做网上业务,但是它有一定的限制,就是必须在企业银行系统封闭的完成。
很多企业都有一套自己的财务系统,企业使用财务系统生成一些经办业务需要的数据,如支
付脱机制单数据、工资表和收方信息等,然后将生成的数据交由企业银行系统经办和审批,
再将银行返回的数据导入到财务系统中。
目前企业财务系统与企业银行系统间只能以文件形
式进行数据交换,而企业希望能在自己的系统和企业银行间进行直接的数据交换。
基于以上情况,招商银行开发了本系统。
本系统提供两种方式与企业财务系统对接。
一种是
前置机式;一种是嵌入式。
1.2.1 前置机式直联(推荐):
即通过在企业部网络安装一台前置机(即安装了本系统并启动了直连服务的 PC 机),
企业财务系统通过报文交互的方式与前置机通讯,以实现向企业银行系统发送指令,并接收
银行返回的数据。
1.2.2 嵌入式直联:
即通过在企业财务系统部调用本系统提供的接口,实现财务系统