42 多线程调用 - 招商银行.doc

招商银行直联系统开发指南 version 1.0.4 修订记录 日期 修订版本 修订人 修订内容 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接口文档 招商银行直联系统开发指南 1 1 系统简介 3 1.1 概述 3 1.2 背景 3 1.2.1 前置机式直联： 3 1.2.2 嵌入式直联： 3 1.3 阅读对象 3 1.4 术语定义 4 2 解决方案 4 2.1 概述 4 2.2 功能 5 2.3 整体要求 6 2.3.1 系统要求 6 2.3.2 技术要求 6 2.3.3 企业要求 6 2.4 开发流程 6 2.4.1 准备 6 2.4.2 开发 7 2.4.3 使用 7 3 前置机式 8 3.1 前置程序说明 8 3.1.1 概述 8 3.1.2 程序主界面说明 8 3.1.3 菜单功能说明 9 3.1.4 注意事项 12 3.2 通讯协议说明 13 3.2.1 概述 13 3.2.2 HTTP/HTTPS协议 13 3.2.3 SOCKET协议 13 3.3 XML报文格式 13 3.3.1 概述 13 3.3.2 格式三 14 3.3.3 格式一 15 3.3.4 格式二 16 3.3.5 说明 17 3.4 调用频率 17 3.4.1 说明 17 3.5 并发性能 18 3.5.1 说明 18 4 嵌入式 18 4.1 开发概述 18 4.1.1 概述 18 4.1.2 数据格式 18 4.1.3 接口返回值 19 4.2 多线程调用 20 4.2.1 概述 20 4.2.2 调用方法 20 4.2.3 调用说明 20 4.2.4 术语定义 21 4.3 编程接口 21 4.3.1 XML请求(XmlComm) 21 4.3.2 系统函数 22 4.3.3 账户信息 30 4.3.4 支付结算 35 4.3.5 代发代扣 40 4.3.6 国内信用证 46 4.3.7 商务支付 52 4.3.8 其他接口 54 5 版本说明 55 5.1 版本信息 55 5.2 升级建议 56 5.3 查看版本信息 56 6 资源下载 57 6.1 招商银行银企直连接口说明书(XML格式三说明文档) 57 6.2 人行电子票据银企直连接口说明书(XML格式三) 57 6.3 招商银行票据通银企直连接口说明书(XML格式三) 57 6.4 XML格式一和格式二报文说明文档 58 6.5 开发范例源码 58 系统简介 概述 本开发指南对招商银行企业银行直联系统（以下简称本系统）进行详细地描述，通过该指南可以对本系统有个全面地了解，并可用于指导如何在该系统上进行二次开发，实现与企业财务/ERP/电子商务交易平台等系统（以下简称企业财务系统）平滑对接和有机融合。 背景 招商银行网上企业银行本身有一套完整的经办、审批机制，帮助企业规范财务制度、安全地做网上业务，但是它有一定的限制，就是必须在企业银行系统内封闭的完成。 很多企业都有一套自己的财务系统，企业使用财务系统生成一些经办业务需要的数据，如支付脱机制单数据、工资表和收方信息等，然后将生成的数据交由企业银行系统经办和审批，再将银行返回的数据导入到财务系统中。目前企业财务系统与企业银行系统间只能以文件形式进行数据交换，而企业希望能在自己的系统内和企业银行间进行直接的数据交换。 基于以上情况，招商银行开发了本系统。本系统提供两种方式与企业财务系统对接。一种是前置机式；一种是嵌入式。 前置机式直联： 即通过在企业内部网络内安装一台前置机（即安装了本系统并启动了直连服务的PC机），企业财务系统通过报文交互的方式与前置机通讯，以实现向企业银行系统发送指令，并接收银行返回的数据。 嵌入式直联： 即通过在企业财务系统内部调用本系统提供的接口，实现财务系统和企业银行间的直接交互。本系统作为财务系统的一个组成部分嵌入到财务系统，在财务系统和企业银行间采用不落地方式交换数据，财务系统通过本系统提供的接口直接向企业银行系统发送指令，并接收银行返回的数据。 阅读对象 预期读者为利用本系统进行二次开发的相关人员，以及其他需要了解本系统的人员。 术语定义 直联：招商银行提供的一种网上“企业银行”系统与企业的财务软件系统的直接联接的接入方式。Internet网络或