招商银行直联系统开发的指南.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 嵌入式直联：
即通过在企业财务系统部调用本系统提供的接口，实现财务系统
升级会员 