招商银行数据接口说明
- 格式：doc
- 大小：151.50 KB
- 文档页数：31
招商银行数据接口说明
第一章概述2
1.1目的2
1.2文件生成日期2
第二章文件结构2
2.1非加密格式2
2.1加密格式3
第三章文件描述3
3.1 对帐单接口数据格式4
3.2 支付结算接口数据格式6
3.3 支付结算查询结果数据格式9
3.4 收方信息接口数据格式12
3.5 代发接口数据格式14
3.6 代发结果数据格式15
3.7 代扣接口数据格式16
3.8 代扣结果数据格式18
3.9 XX信息数据格式19
附录A 术语说明19
A．2系统代码20
附录B INI PLUS格式22
B．1概述22
B．2格式说明22
B．3示例23
附录C 系统文件23
C．1 本地信息文件23
C．2 使用频度文件25
附录D XBASE格式文件格式25
D．1 支付结算文件25 D．2 代发表文件26
D．3 代扣表文件26
附录E 常用数据27
E．1招行分行27
E．2货币代码表27
附录F C++源码示例27
第一章 概述
1.1目的
本文件描述了企业银行系统中定义的文件数据格式接口，该接口可用于企业银行系统与财务系统对接。
接口文件根据数据流向，可分为两大类，一类是由企业银行系统生成，需要导出到企业的财务系统中，如：对帐单、支付和集团支付查询结果、发工资查询结果、收方信息、受益人信息等；另一类是由企业财务系统生成，需要导入到企业银行系统，用于经办业务，如：成批支付结算文件、工资表、收方信息、受益人信息、成批信用证申请文件等。
根据接口文件是否采用了加密方式保存，也可以分为加密和非加密格式两大类。通常加密格式的文件的后缀的第一个字符是“E”。
1.2文件生成日期
本文件于2003年2月28日制定，适用于企业银行系统4.0版及以后版本。
第二章 文件结构
2.1非加密格式
非加密格式的文件为文本文件，包括描述信息和正文两部分。详细内容可参照第三章“文件描述”。
描述信息在文件的第一行，且以“#”开始，各字段间用空格加分号分开，描述信息可以为空。
正文的每一行代表一个查询记录，用"\r\n"结尾。每一个记录之间的各个元素之间用空格加分号分开，如果对应的元素没有任何内容，就不填写。
2.1加密格式
加密格式的文件是一个二进制文件，包括文件头和加密数据块两部分。文件头包括标识、版本、描述块长度和描述块。加密数据块经解密后格式同非加密格式的文件，加密算法由招商银行定义。文件头在加密文件的开头，之后是加密数据块。
现对文件头详细说明如下：
字节0~6为标识（”CMBDATA”）。
字节7~8为版本号（字节7为主版本号，字节8为副版本号，本文件定义的格式为“2.0”）。
字节9~10为描述块的长度，整型。
描述块由多个描述字段组成，每个字段包括字段名（4个字节）、字段长度(1个字节)和字段内容。字段名以“#”号开头的为招行保留，对于由企业财务系统生成的加密格式文件可由企业财务系统自定义。如：“＃CKC”表示校验码，长度为4字节。
第三章 文件描述
本单描述了企业银行系统中与用户相关的数据文件格式，分为加密和非加密格式两大类，由于加密格式的加密数据块经解密后格式同非加密格式的文件，因此，以下只对非加密文件的格式进行详细说明。
非加密格式文件由描述块和数据块两部分组成。描述块记录了数据文件的相关信息，如接口版本等。数据块记录了业务信息。
描述块为文件的第一行，如果第一行以“#”开始，这一行记录了描述信息，描述块可以为空。描述块由多个字段组成，各字段间用 “_ ;”(空格加分号,_表示空格，以下同)分开，每个字段的格式为：字段名=数值。
数据块由多条记录组成，每一行表示一条记录，以“\r\n”结尾（注：“\r\n”是指回车符和换行符）。每条记录由多个字段组成，各字段间用 “_ ;” (空格加分号)分开，每个字段的格式为：字段名=数值。
在以下的格式说明中，如果未指明某个字段允许为空，则该字段不能为空。
3.1 对帐单接口数据格式
对帐单文件用于企业对帐，系统可以将当天交易和历史交易的帐务数据用对帐单文件格式保存下来。文件格式和含义如下：
对帐单文件的文件名格式如下：“XX”+“-”+“开始日期（yymmdd）”+“-”+“结束日期（yymmdd）”+“.”+“后缀”。用非加密方式保存的帐务文件是一个文本文件，后缀是“ACT”；用加密方式保存的帐务文件是一个二进制文件，后缀是“EACT”。如：01-000808-000810.act是一个保存了XX01在2000-08-08到2000-08-10期间发生的交易的对帐单文件；01-000808-000810.eact则是一个加密的对帐单文件。
加密的对帐单文件经解密后格式同非加密的对帐单文件。以下介绍非加密对帐单文件格式。
如果第一行以“#”开始，这一行记录了对帐单描述信息，各字段间用“_ ;” (空格加分号)分开。格式如下：BANKCODE=银行码（固定为“5456”，表示招商银行）；VERSION=接口版本（本文件定义的格式的版本为“2.0”）；TYPE=文件类型（最长10位字符，如：“ACCOUNT”表示对帐单）；ACCOUNT=银行XX（11位或13位字符串）；CURRENCY=XX币种（最长10位字符串，如：人民币、港币或美元等）；MAKEDATE=对帐单生成日期（8位日期格式，yyyymmdd）；OPERATOR=经办人用户名(最长20位字符串)；SUMDEBIT=累计借金额（整数部分最多13位，小数2位）；TOTALDEBIT=累计借总笔数（最长5位数字）；SUMCREDIT=累计贷金额（整数部分最多11位，小数2位）；TOTALCREDIT=累计贷总笔数（最长5位数字）；BEGINBALANCE=对帐单期初余额（整数部分最多11位，小数2位）；BALANCE-对帐单余额（整数部分最多13位，小数2位）；BEGINDATE=查询开始日期（8位日期格式，yyyymmdd）；ENDDATE=查询结束日期（8位日期格式，yyyymmdd）。由企业银行生成的对帐单文件，描述行的所有字段均不为空。
正文的每一行代表一条对帐单查询记录，用"\r\n"结尾。每一条记录的各个字段之间用“_ ;” (空格加分号)分开，如果对应的字段没有任何内容，就不填写。
用企业银行做的交易会有业务参考号，没有票据号，在柜台或其它地方生成的交易有票据号或其它的唯一标识，都统一称为业务参考号
一行中各元素格式如下：ETYDAT=交易日；ETYTIM=交易时间；VLTDAT=起息日；TRSCOD=交易类型；NARYUR=摘要；TRSAMTD=借方金额；TRSAMTC=贷方金额； TRSBLV=余额； REFNBR=流水号；REQNBR=流程实例号；BUSNAM=业务名称；NUSAGE=用途；YURREF=业务参考号；BUSNAR=业务摘要；OTRNAR=其它摘要；C_RPYBBK=收/付方开户地区；RPYNAM=收/付方名称；RPYACC=收/付方XX；RPYBBN=收/付方开户行行号；RPYBNK=收/付方开户行名；RPYADR=收/付方开户行地址；C_GSBBBK=母/子公司开户地区；GSBACC=母/子公司XX；GSBNAM=母/子公司名称；INFFLG=信息标志。
格式说明：
ETYDAT(交易日)：交易发生的日期。8位日期格式，yyyymmdd。
ETYTIM（交易时间）：交易发生的时间，只有小时有效。6位时间格式，hhmmnn。
VLTDAT（起息日）：开始计息的日期。8位日期格式，yyyymmdd。
TRSCOD（交易类型）：交易的类型。最大8位字符串。
NARYUR（摘要）：交易的简单说明和注解。最长16位字符串。
TRSAMTD（借方金额）：企业为借方时的交易金额。nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分为2位。
TRSAMTC（贷方金额）：企业为贷方时的交易金额。nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分为2位。
TRSBLV（余额）：XX的联机余额。nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分为2位。
REFNBR（流水号）：交易的流水号。8位字符串。
REQNBR（流程实例号）：最大10位数字
BUSNAM（业务名称）：最大28位字符串。 NUSAGE（用途）：最大28位字符串。
YURREF（业务参考号）：最大30位字符串。
BUSNAR（业务摘要）：对业务的简单说明或注解。最大196位字符串。
OTRNAR（其它摘要）：对业务的其它说明或注解。最大58位字符串。
C_RPYBBK（收/付方开户地区）：收/付方XX开户行所在地区。最大12位字符串，如、XX、XX等。
RPYNAM（收/付方名称）：收/付方XX名称。最长58位字符串。
RPYACC（收/付方XX）：收/付方的转入或转出XX。最长35位数字。
RPYBBN（收/付方开户行行号）：收/付方XX的开户行的行号。最长20位字符串。
RPYBNK（收/付方开户行名）：收/付方XX的开户行的行名。最长58位字符串。
RPYADR（收/付方开户行地址）：收/付方XX的开户行的地址。最长58位字符串。
C_GSBBBK（母/子公司所在地区）：母/子公司XX的开户行所在地区，最长12位字符串，如、XX、XX等。
GSBACC（母/子公司XX）：最长35位字符串。
GSBNAM（母/子公司名称）：最长62位字符串。
INFFLG（信息标志）：用于标识收/付方XX和母/子公司的信息。为空表示付方XX和子公司；为“1”表示收方XX和子公司；为“2”表示收方XX和母公司；为“3”表示原收方XX和子公司。
C_ATHFLG（有否附件信息标志）：2位字符
示例：
3.2 支付结算接口数据格式
成批支付结算接口文件用于用户在脱机状态下或在企业的财务系统中完成批量支付结算数据录入，并使用成批经办功能一次性经办一批支付结算数据，该接口文件可用于支付和集团支付两种业务。文件格式和含义如下：
