1、1第一章 概述 -41.1 目的 -41.2 修订记录 -4第二章 文件接口结构 -52.1 概述 -52.2 EXCEL 及逗号分割文件（ *.csv 或 *.txt） -5第三章 旧版本接口文件 -53.1 概述 -53.2 非加密文件 -63.3 加密文件 -63.4 各业务数据文件后缀列表 -6第四章 直联接口结构 -74.1 概述 -7第五章 数据接口格式描述 -75.1 对帐单数据接口格式 -75.2 支付结算数据接口格式 -105.3 内部转帐数据接口格式 -125.4 支付结算查询结果数据格式 -135.5 业务处理结果数据格式 -165.6 收方信息接口数据格式 -175.7
2、 代发接口数据格式 -185.8 代发结果数据格式 -195.9 代扣接口数据格式 -205.10 代扣结果数据格式 -215.11 帐户列表数据格式 -225.12 帐户详细信息数据格式 -235.13 到帐、付款交易通知格式 -235.14 直接支付结果通知格式 -255.15 国内信用证经办格式 -2625.16 国内信用证开证结果格式 -295.17 国内信用证可撤消 /待审批结果格式 -325.18 国内信用证经办 /撤消 /审批结果格式 -335.19 国内信用证受益人信息接口数据格式 -335.20 汇出汇款经办 -345.21 订单状态接口格式 -385.22 代理清算经办 -
3、40附录 A 术语说明 -42A.1 银行代码 -42A.2 系统代码 -42附录 B INI PLUS 格式 -45B.1 概述 -45B.2 格式说明 -45B.3 示例 -45附录 C 系统文件 -45C.1 本地信息文件 -45C.2 使用频度文件 -47附录 D XBASE 格式文件格式 -48D.1 支付结算文件 -48D.2 代发表文件 -48D.3 代扣表文件 -49附录 E 常用数据 -50E.1 招行分行 -50E.2 货币代码表 -50E.3 交易分析吗 -51E.4 交易代码 -52E.5 凭证类型 -53E.6 业务类型 -53E.7 业务请求状态 -543E.8 业
4、务处理结果 -54附录 F C+加解密文件源码示例 -554第 一 章 概 述1.1 目 的本文件描述了企业银行系统中定义的文件数据格式接口及直连接口，这些接口可用于企业银行系统与财务系统对接。接口根据数据流向，可分为两大类，一类是由企业银行系统生成，需要导出到企业的财务系统中，如：对帐单、支付和集团支付查询结果、发工资查询结果、收方信息、受益人信息等；另一类是由企业财务系统生成，需要导入到企业银行系统，用于经办业务，如：成批支付结算数据、工资表、收方信息、受益人信息、成批信用证申请文件等。文件接口根据是否采用了加密方式保存，也可以分为加密和非加密格式两大类。通常加密文件后缀的第一个字符是“E
5、” 。1.2 修 订 记 录日期 修订版本 修订内容2003-02-28 2.0.0 创建。2004-02-20 2.0.1 修改对帐单接口。2004-05-24 2.1.0 以表格形式描述各业务数据字段，方便阅读。2004-12-8 2.1.1 修正一些小错误。2007-02-02 2.2.2集合 Finance.dll 的修改对它的使用示例程序进行修改。2008-01-29 3.0.0 增加对逗号分隔文件的详细说明2008-11-29 3.1.0更新各业务接口说明，整理 excel 及逗号分隔文件的说明。2011-06-17 3.2.0 简化文档结构，增加代发的他行接口说明。本接口文档适用
6、于企业银行系统 4.0.2 版及以后版本、直联 1.0 及以后版本。5第 二 章 文 件 接 口 结 构2.1 概 述文件是从企业银行客户端保存下来的文件，或是从财务系统导出的符合本文档定义的接口文件。旧版本的格式文件，例如*.pam,*.apy 等会逐渐过渡到 excel 或逗号分隔文件（*.csv 或*.txt）的格式。2.2 EXCEL 及 逗 号 分 割 文 件 （ *.csv 或 *.txt）Csv 文件是以逗点分隔各字段，以换行分隔各记录的文本文件，Excel 支持把表格另存为这种格式，其它很多财务系统也支持这功能。是个通用格式。以下描述的格式适用于Excel 或逗号分隔文件，只是
7、 Excel 用格子分开每个数据，逗号分隔文件用逗号及换行分开每个数据。招行网上企业银行导出的逗号分隔文件一般以*.txt 做文件后缀，文件格式与csv 是一样的，只是后缀名不同，导入时支持 csv 及 txt。第一行为每列数据的字段名称行，用逗点或格子分隔各名称从第二行开始为每条记录的值，用逗点或格子分隔（仅适用于逗号分隔文件）若值中间有逗号或换行或”号，将用”号括引此值，如果值中存在”号，则用两个”代表一个”，例如”代表值是” 。换行符为”rn”。下面是例子：YUEREF,TRSAMT,USRNBR2007,999,N1972009,111,N198此例表示有两条记录，每条记录有三个字段，
8、名称分别是YUEREF、TRSAMT 、USRNBR 。第一条记录的 YUEREF 值是 2007，TRSAMT 值是999，USRNBR 值是 N197；第二条记录的 YUEREF 值是 2009，TRSAMT 值是111，USRNBR 值是 N198【注意】Excel 在导出 csv 文件时，可能会在文件最后面产生空记录但带有逗点的行，请把它们删除。或者在 excel 里实现把多余的空行空列去掉。第 三 章 旧 版 本 接 口 文 件3.1 概 述6本章所描述的文件格式会逐渐被 excel 及*.csv/*.txt 替代，导入导出时请尽量选择 excel或*.csv/*.txt。3.2 非
9、 加 密 文 件非加密格式的文件为文本文件，包括描述信息和正文两部分。详细内容可参照第五章“文件描述” 。描述信息在文件的第一行，且以“#”开始，各字段间用空格加分号分开，描述信息可以为空。正文的每一行代表一个查询记录，用“rn“结尾。每一个记录之间的各个元素之间用空格加分号分开，如果对应的元素没有任何内容，可以不填写。具体格式请看“附录 B INI PLUS 格式 ”3.3 加 密 文 件加密格式的文件是采用招行的程序加密本文档所描述的各种文本文件，一般加密文件的后缀名都以 e 开头。 。企业若要自行生成加密或解密文件，请参考附录 F 的代码示例。3.4 各 业 务 数 据 文 件 后 缀
10、列 表加密 非加密对帐单 *.eact *.act支付结算接口 *.epam *.pam代发接口 *.eapy *.apy代扣接口 *.eacl *.acl收方信息接口 *.ercv *.rcv支付查询结果 *.eprt *.prt代发查询结果 *.esrt *.srt代扣查询结果 *.ecrt *.crt7第 四 章 直 联 接 口 结 构4.1 概 述直联接口是财务系统通过企业银行直连控件与企业银行系统交换数据的接口。直联与文件数据的格式一般相同，只是表现的形式不同，直联通过控件 DLL 与财务系统对接。本文档只描述直联的数据接口，有关直连的其它内容，请察看文档“企业银行嵌入式直联系统开发
11、指南.doc”第 五 章 数 据 接 口 格 式 描 述数据由描述块和数据块两部分组成。描述块记录了数据接口的相关信息，如接口版本等。数据块记录了业务信息。 （描述块一般从招行网银客户端导出时会有，企业若要自行生成此类文件导入，描述块不是必须的）描述块为数据接口的第一行，如果第一行以“#”开始，这一行记录了描述信息，描述块可以为空。描述块由多个字段组成，各字段间用 “_ ;” （空格加分号,_表示空格，以下同）分开，每个字段的格式为：字段名=数值。数据块由多条记录组成，每一行表示一条记录，以“rn”结尾（注：“rn”是指回车符和换行符） 。每条记录由多个字段组成，各字段间用 “_ ;” （空格
12、加分号）分开，每个字段的格式为：字段名=数值。字段名必须大写。每一个字段除特殊说明都有类型定义，例如 C（1,20）代表字符类型，允许 1 到 20 个字符，也可省略为 C（20） ； N（20,20）代表数字类型，只允许 20 个数字。数据类型定义：描述C 字符类型，包括中英文字符及数字N 数字类型D 日期类型，格式为：yyyymmddT 6 位时间格式，hhmmnnM 金额类型，nnnnnnnnnnnnn.nn，整数部分最多 13 位，小数部分为 2 位5.1 对 帐 单 数 据 接 口 格 式8对帐单接口用于企业对帐，包括当天交易和历史交易的帐务数据。数据格式和含义如下：描述行字段定义：
13、名称 代码 类型可否为空描述银行码 BANKCODE C（12 ） 可固定为“5456” ，表示招商银行接口版本 VERSION C（12 ） 可本文件定义的格式的版本为“2.0”数据类型 TYPE C（10 ） 可如：“ACCOUNT”表示对帐单银行帐号 ACCOUNTC（11， 13）可 11 位或 13 位字符串帐户币种 CURRENCY C（10 ） 可 如：人民币、港币对帐单生成日期 MAKEDATE D 可经办人用户名 OPERATOR C（20 ） 可累计借金额 SUMDEBIT M 可累计借总笔数 TOTALDEBIT N（5） 可累计贷金额 SUMCREDIT M 可累计贷总
14、笔数 TOTALCREDIT N（5） 可对帐单期初余额 BEGINBALANCE M 可对帐单余额 BALANCE M 可查询开始日期 BEGINDATE D 可查询结束日期 ENDDATE D 可开户行地区 BANKAREA C（12 ） 可数据正文字段定义：名称 代码 类型 可否为空 描述交易日 ETYDAT D 否 交易发生的日期交易时间 ETYTIM T 否交易发生的时间，只有小时有效起息日 VLTDAT D 可 开始计息的日期9交易类型 TRSCOD C（8） 可 具体定义见附录 E.4摘要 NARYURC（16）可若为企业银行客户端经办的交易，则该字段为用途信息（4.0版代发代扣
15、业务除外）若为其它渠道经办的交易，则该字段为交易的简单说明和注解。借方金额 TRSAMTD M 可 企业为借方时的交易金额贷方金额 TRSAMTC M 可 企业为贷方时的交易金额余额 TRSBLV M 可 帐户的联机余额流水号 REFNBR C（8） 否 银行会计系统交易流水号流程实例号 REQNBRN（ 10）可企业银行交易序号，唯一标示企业银行客户端发起的一笔交易业务名称 BUSNAMC（28）可用途 NUSAGEC（28）可业务参考号 YURREFC（30）可企业银行客户端录入的业务参考号。用企业银行做的交易会有业务参考号，没有票据号，在柜台或其它地方生成的交易有票据号或其它的唯一标识，
16、都统一称为业务参考号业务摘要 BUSNARC（196）可对业务的简单说明或注解。企业银行客户端录入的摘要信息其它摘要 OTRNARC（58）可对业务的其它说明或注解（暂不使用）收/付方开户地区 C_RPYBBKC（12）可收/付方帐号开户行所在地区，如北京、上海、深圳等收/付方名称 RPYNAMC（58）可 收/付方帐户名称收/付方帐号 RPYACCN（ 35）可 收/付方的转入或转出帐号10收/付方开户行行号 RPYBBNC（20）可 收/付方帐号的开户行的行号收/付方开户行名 RPYBNKC（58）可 收/付方帐号的开户行的行名收/付方开户行地址 RPYADRC（58）可母/子公司所在地区
17、 C_GSBBBKC（12）可母/子公司帐号的开户行所在地区，如北京、上海、深圳等母/子公司帐号 GSBACCC（35）可母/子公司名称 GSBNAMC（62）可信息标志 INFFLG N（ 1） 可用于标识收/付方帐号和母/子公司的信息。为空表示付方帐号和子公司；为“1”表示收方帐号和子公司；为“2”表示收方帐号和母公司；为“3”表示原收方帐号和子公司有否附件信息标志 C_ATHFLG C（2） 可票据号 CHKNBRC（10）可订单号 REFSUBC（20）可冲帐标志 RSVFLG C（1） 可 *为冲帐，X 为补帐扩展摘要 NAREXTC（30）可 有效位数为 16交易分析码 TRSANL C（6） 可1-2 位 取 值 含 义 件 附 录E.3， 3-6 位 取 值 含 义 件 附 录E.4。 建 议 ： 该 字 段 取 值 后 台 没有 统 一 标 准 ， 所 以 附 录 E.3 和E.4 不 易 公 开 发 表 。 如 有 客 户 需要 区 分 不 同 交 易 ， 再 根 据 具 体
