招商银行数据接口说明

招商银行数据接口说明第一章概述-----------------------------------------------------------------------------------31.1目的-------------------------------------------------------------------------------------31.2文件生成日期-------------------------------------------------------------------------3第二章文件结构-----------------------------------------------------------------------------42.1非加密格式----------------------------------------------------------------------------42.1加密格式-------------------------------------------------------------------------------4第三章文件描述-----------------------------------------------------------------------------53.1对帐单接口数据格式----------------------------------------------------------------53.2支付结算接口数据格式-------------------------------------------------------------93.3支付结算查询结果数据格式------------------------------------------------------113.4收方信息接口数据格式------------------------------------------------------------153.5代发接口数据格式------------------------------------------------------------------163.6代发结果数据格式------------------------------------------------------------------173.7代扣接口数据格式------------------------------------------------------------------193.8代扣结果数据格式------------------------------------------------------------------203.9帐户信息数据格式------------------------------------------------------------------22附录A术语说明----------------------------------------------------------------------------23A．2系统代码----------------------------------------------------------------------------23附录BINIPLUS格式-----------------------------------------------------------------------26B．1概述----------------------------------------------------------------------------------26B．2格式说明----------------------------------------------------------------------------26B．3示例----------------------------------------------------------------------------------26附录C系统文件----------------------------------------------------------------------------27C．1本地信息文件---------------------------------------------------------------------27C．2使用频度文件---------------------------------------------------------------------28附录DXBASE格式文件格式-----------------------------------------------------------30D．1支付结算文件---------------------------------------------------------------------30D．2代发表文件------------------------------------------------------------------------30D．3代扣表文件------------------------------------------------------------------------31附录E常用数据----------------------------------------------------------------------------32E．1招行分行----------------------------------------------------------------------------32E．2货币代码表-------------------------------------------------------------------------32附录FC++源码示例-----------------------------------------------------------------------33第一章概述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对帐单接口数据格式对帐单文件用于企业对帐，系统可以将当天交易和历史交易的帐务数据用对帐单文件格式保存下来。文件格式和含义如下：对帐单文件的文件名格式如下：“帐号”+“-”+“开始日期（yymmdd）”+“-”+“结束日期（yymmdd）”+“.”+“后缀”。用非加密方式保存的帐务文件是一个文本文件，后缀是“ACT”；用加密方式保存的帐务文件是一个二进制文件，后缀是“EACT”。如：1280001510001-000808-000810.act是一个保存了帐号1280001510001在2000-08-08到2000-08-10期间发生的交易的对帐单文件；1280001510001-000808-000810.eact则是一个加密的对帐单文件。加密的对帐单文件经解密后格式同非加密的对帐单文件。以下介绍非加密对帐单文件格式。如果第一行以“#”开始，这一行记录了对帐单描述信息，各字段间用“_;”(空格加分号)分开。格式如下：BANKCODE=银行码（固定为“5456”，表示招商银行）；VERSION=接口版本（本文件定义的格式的版本为“2.0”）；TYPE=文件类型（最长10位字符，如：“ACCOUNT”表示对帐单）；ACCOUNT=银行帐号（11位或13位字符串）；CURRENCY=帐户币种（最长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=起息日；TR