《招商银行数据接口说明.docx》由会员分享，可在线阅读，更多相关《招商银行数据接口说明.docx（36页珍藏版）》请在taowenge.com淘文阁网|工程机械CAD图纸|机械工程制图|CAD装配图下载|SolidWorks_CaTia_CAD_UG_PROE_设计图分享下载上搜索。
1、编号：时间：2021年x月x日书山有路勤为径，学海无涯苦作舟页码：第36页 共36页招商银行数据接口说明第一章 概述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 术语说明23A2系统代码23附录B INI Plus格式26B1概述26B2格式说明26B3示例26附录C
2、 系统文件27C1 本地信息文件27C2 使用频度文件28附录D XBASE格式文件格式30D1 支付结算文件30D2 代发表文件30D3 代扣表文件31附录E 常用数据32E1招行分行32E2货币代码表32附录F C+源码示例33第一章 概述1.1目的本文件描述了企业银行系统中定义的文件数据格式接口，该接口可用于企业银行系统与财务系统对接。接口文件根据数据流向，可分为两大类，一类是由企业银行系统生成，需要导出到企业的财务系统中，如：对帐单、支付和集团支付查询结果、发工资查询结果、收方信息、受益人信息等；另一类是由企业财务系统生成，需要导入到企业银行系统，用于经办业务，如：成批支付结算文件、工
3、资表、收方信息、受益人信息、成批信用证申请文件等。根据接口文件是否采用了加密方式保存，也可以分为加密和非加密格式两大类。通常加密格式的文件的后缀的第一个字符是“E”。1.2文件生成日期本文件于2003年2月28日制定，适用于企业银行系统4.0版及以后版本。第二章 文件结构2.1非加密格式非加密格式的文件为文本文件，包括描述信息和正文两部分。详细内容可参照第三章“文件描述”。描述信息在文件的第一行，且以“#”开始，各字段间用空格加分号分开，描述信息可以为空。正文的每一行代表一个查询记录，用rn结尾。每一个记录之间的各个元素之间用空格加分号分开，如果对应的元素没有任何内容，就不填写。2.1加密格式
4、加密格式的文件是一个二进制文件，包括文件头和加密数据块两部分。文件头包括标识、版本、描述块长度和描述块。加密数据块经解密后格式同非加密格式的文件，加密算法由招商银行定义。文件头在加密文件的开头，之后是加密数据块。现对文件头详细说明如下：字节06为标识（”CMBDATA”）。字节78为版本号（字节7为主版本号，字节8为副版本号，本文件定义的格式为“2.0”）。字节910为描述块的长度，整型。描述块由多个描述字段组成，每个字段包括字段名（4个字节）、字段长度(1个字节)和字段内容。字段名以“#”号开头的为招行保留，对于由企业财务系统生成的加密格式文件可由企业财务系统自定义。如：“CKC”表示校验码
5、，长度为4字节。第三章 文件描述本单描述了企业银行系统中与用户相关的数据文件格式，分为加密和非加密格式两大类，由于加密格式的加密数据块经解密后格式同非加密格式的文件，因此，以下只对非加密文件的格式进行详细说明。非加密格式文件由描述块和数据块两部分组成。描述块记录了数据文件的相关信息，如接口版本等。数据块记录了业务信息。描述块为文件的第一行，如果第一行以“#”开始，这一行记录了描述信息，描述块可以为空。描述块由多个字段组成，各字段间用 “_ ;”(空格加分号,_表示空格，以下同)分开，每个字段的格式为：字段名=数值。数据块由多条记录组成，每一行表示一条记录，以“rn”结尾（注：“rn”是指回车符
6、和换行符）。每条记录由多个字段组成，各字段间用 “_ ;” (空格加分号)分开，每个字段的格式为：字段名=数值。在以下的格式说明中，如果未指明某个字段允许为空，则该字段不能为空。3.1 对帐单接口数据格式对帐单文件用于企业对帐，系统可以将当天交易和历史交易的帐务数据用对帐单文件格式保存下来。文件格式和含义如下：l 对帐单文件的文件名格式如下：“帐号”+“-”+“开始日期（yymmdd）”+“-”+“结束日期（yymmdd）”+“.”+“后缀”。用非加密方式保存的帐务文件是一个文本文件，后缀是“ACT”；用加密方式保存的帐务文件是一个二进制文件，后缀是“EACT”。如：1280001510001
7、-000808-000810.act是一个保存了帐号1280001510001在2000-08-08到2000-08-10期间发生的交易的对帐单文件；1280001510001-000808-000810.eact则是一个加密的对帐单文件。l 加密的对帐单文件经解密后格式同非加密的对帐单文件。以下介绍非加密对帐单文件格式。l 如果第一行以“#”开始，这一行记录了对帐单描述信息，各字段间用“_ ;” (空格加分号)分开。格式如下：BANKCODE=银行码（固定为“5456”，表示招商银行）；VERSION=接口版本（本文件定义的格式的版本为“2.0”）；TYPE=文件类型（最长10位字符，如：“
8、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-对帐
9、单余额（整数部分最多13位，小数2位）；BEGINDATE=查询开始日期（8位日期格式，yyyymmdd）；ENDDATE=查询结束日期（8位日期格式，yyyymmdd）。由企业银行生成的对帐单文件，描述行的所有字段均不为空。l 正文的每一行代表一条对帐单查询记录，用rn结尾。每一条记录的各个字段之间用“_ ;” (空格加分号)分开，如果对应的字段没有任何内容，就不填写。l 用企业银行做的交易会有业务参考号，没有票据号，在柜台或其它地方生成的交易有票据号或其它的唯一标识，都统一称为业务参考号l 一行中各元素格式如下：ETYDAT=交易日；ETYTIM=交易时间；VLTDAT=起息日；TRSCO
10、D=交易类型；NARYUR=摘要；TRSAMTD=借方金额；TRSAMTC=贷方金额； TRSBLV=余额； REFNBR=流水号；REQNBR=流程实例号；BUSNAM=业务名称；NUSAGE=用途；YURREF=业务参考号；BUSNAR=业务摘要；OTRNAR=其它摘要；C_RPYBBK=收/付方开户地区；RPYNAM=收/付方名称；RPYACC=收/付方帐号；RPYBBN=收/付方开户行行号；RPYBNK=收/付方开户行名；RPYADR=收/付方开户行地址；C_GSBBBK=母/子公司开户地区；GSBACC=母/子公司帐号；GSBNAM=母/子公司名称；INFFLG=信息标志。l 格式说
11、明：ETYDAT(交易日)：交易发生的日期。8位日期格式，yyyymmdd。ETYTIM（交易时间）：交易发生的时间，只有小时有效。6位时间格式，hhmmnn。VLTDAT（起息日）：开始计息的日期。8位日期格式，yyyymmdd。TRSCOD（交易类型）：交易的类型。最大8位字符串。NARYUR（摘要）：交易的简单说明和注解。 最长16位字符串。TRSAMTD（借方金额）：企业为借方时的交易金额。nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分为2位。TRSAMTC（贷方金额）：企业为贷方时的交易金额。nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分为2位。TRS
12、BLV（余额）：帐户的联机余额。nnnnnnnnnnnnn.nn，整数部分最多13位，小数部分为2位。REFNBR（流水号）：交易的流水号。8位字符串。REQNBR（流程实例号）：最大10位数字BUSNAM（业务名称）：最大28位字符串。NUSAGE（用途）：最大28位字符串。YURREF（业务参考号）：最大30位字符串。BUSNAR（业务摘要）：对业务的简单说明或注解。最大196位字符串。OTRNAR（其它摘要）：对业务的其它说明或注解。最大58位字符串。C_RPYBBK（收/付方开户地区）：收/付方帐号开户行所在地区。最大12位字符串，如北京、上海、深圳等。RPYNAM（收/付方名称）：收
13、/付方帐户名称。最长58位字符串。RPYACC（收/付方帐号）：收/付方的转入或转出帐号。最长35位数字。RPYBBN（收/付方开户行行号）：收/付方帐号的开户行的行号。最长20位字符串。RPYBNK（收/付方开户行名）：收/付方帐号的开户行的行名。最长58位字符串。RPYADR（收/付方开户行地址）：收/付方帐号的开户行的地址。最长58位字符串。C_GSBBBK（母/子公司所在地区）：母/子公司帐号的开户行所在地区，最长12位字符串，如北京、上海、深圳等。GSBACC（母/子公司帐号）：最长35位字符串。GSBNAM（母/子公司名称）：最长62位字符串。INFFLG（信息标志）：用于标识收/
14、付方帐号和母/子公司的信息。为空表示付方帐号和子公司；为“1”表示收方帐号和子公司；为“2”表示收方帐号和母公司；为“3”表示原收方帐号和子公司。C_ATHFLG（有否附件信息标志）：2位字符l 示例：3.2 支付结算接口数据格式成批支付结算接口文件用于用户在脱机状态下或在企业的财务系统中完成批量支付结算数据录入，并使用成批经办功能一次性经办一批支付结算数据，该接口文件可用于支付和集团支付两种业务。文件格式和含义如下：l 成批支付结算文件的文件名格式如下：“系统制单的日期（yymmdd）”+“-”+“序号i”+“.”+“后缀”。用非加密方式保存的支付结算文件是一个文本文件，后缀是“PAM”；用
15、加密方式保存的支付结算文件是一个二进制文件，后缀是“EPAM”。如：000808-10.pam是一个保存了2000-08-08产生的序号为10的成批支付结算文件； 000808-10.epam则是一个加密的成批支付结算文件。l 加密的支付结算文件由文件头和加密数据块两部分组成。加密数据块经解密后格式同非加密的支付结算文件，加密算法由招商银行定义。以下介绍非加密的支付格式。l 如果第一行以“#”开始，这一行就表示支付结算文件的描述信息，各字段间用空格加分号分开。格式如下：SYSCODE=系统代码（12位字符串，由招商银行定义）；VERSION=接口版本（本文件定义的格式的版本为“2.0”）；TY
16、PE=文件类型（最长10位字符，如：“PAYMENT”表示支付结算）；MAKEDATE=文件生成日期（8位日期格式，yyyymmdd）；OPERATOR=经办用户名(最长20位字符串)；SUM=累计金额（整数部分最多13位，小数2位）；TOTAL=累计笔数（最长5位数字）。描述行中SYSCODE、VERSION和TYPE不可为空，其它字段可选，为空的字段不填写。l 正文的每一行代表一条支付结算请求，用rn结尾。每一条请求的各个字段之间用“_ ;” (空格加分号)分开，如果对应的字段没有任何内容，就不填写。l 一行中各字段格式如下：YURREF=参考号；EPTDAT =期望日；EPTTIM=期望
17、时间；DBTACC=付方帐号；C_DBTBBK=付方开户地区；TRSAMT=金额；C_CCYNBR =币种；C_STLCHN=结算方式；NUSAGE=用途；BUSNAR =摘要；CRTACC=收方帐号；CRTNAM=收方名称；CRTBNK=收方开户行；CRTPVC=收方省份；CRTCTY=收方城市；CRTDTR=收方县/区；NTFCH1=收方电子邮件；NTFCH2=收方移动电话；CRTSQN=收方编号。l 格式：YURREF（业务参考号）：用于标识该笔业务的编号，该号必须唯一。最大30位字符串。EPTDAT（期望日）：期望该笔业务在该日期发生。8位日期格式，yyyymmdd。EPTTIM（期望
18、时间）：期望该笔业务在期望日内指定的时间之后发生。6位数字，24小时制式的时间表示，hhmmss。只有小时数有效。可以为空。DBTACC（付方帐号）：企业用于付款的转出帐号，该帐号的币种类型必须与币种字段相符。最大35位数字。C_DBTBBK（付方开户地区）：付方帐号的开户行所在地区，最大12位字符串，如北京、上海和深圳等。TRSAMT（交易金额）该笔业务的付款金额。nnnnnnnnnnnnn.nn ，整数部分最多13位，小数部分为2位。C_CCYNBR（币种）：付款的币种类型。最长10位字符串。如：人民币、港币或美元等。C_STLCHN（结算方式）：期望该笔业务以何种方式完成结算。最长12位
19、字符串。如：快速、普通等。NUSAGE（用途）：最长56位字符串。BUSNAR（业务摘要）：用于企业付款时填写说明或者备注。最长196位字符。可以为空。CRTACC（收方帐号）：收款企业的转入帐号，该帐号的币种类型必须与币种字段相符。最长35位数字。CRTNAM（收方帐户名）：收款方企业的转入帐号的帐户名称。最长58位字符串。CRTBNK（收方开户行）：收方帐号开户行名称，如：招商银行北京分行。最长58位字符串。名称中必须包含有“行”、“信用社”、“合作社”或“联社”。CRTPVC（收方省份）：收方帐号开户行所在的省份，如：广东省、北京市或新疆自治区。最长16位字符串，格式为：XX省（或市或自
20、治区）。CRTCTY（收方城市）：收款方帐号开户行所在的城市名，指市或省辖行政单位。最长20位字符串，格式为“XX市（或县）”，对直辖市，市县名可为空。如：深圳市。CRTDTR(收方县/区)：收方帐号开户行所在的县或区，最长20位字符串，格式为：XX县/区，可为空。如：宝安区。NTFCH1(收方电子邮件)：收款方的电子邮件地址，用于邮件通知。最长36位字符串。可以为空。NTFCH2（收方移动电话）：收款方的移动电话，用于短信通知。最长16位字符串。可以为空。CRTSQN：收方编号，用于标识收款方的编号。最长20位字符串。3.3 支付结算查询结果数据格式支付结算查询结果文件用于企业通过支付结算查
21、询功能查询一段时间内的支付、集团支付和内部转帐等业务的经办情况，并将查询到的结果保存到该格式的文件中。文件格式和含义如下：l 支付结算查询结果文件的文件名格式如下：“查询起始日期（yymmdd）”+“-”+“查询结束日期（yymmdd）”+“.”+“后缀”。用非加密方式保存的支付结算查询结果文件是一个文本文件，后缀是“PRT”；用加密方式保存的支付结算查询结果文件是一个二进制文件，后缀是“EPRT”。如：000808-000818.prt是一个保存了2000-08-08到2000-08-18间支付结算查询结果的文件； 000808-000818.eprt则是一个加密的支付结算查询结果文件。l
22、加密的支付结算查询结果文件由文件头和加密数据块两部分组成。加密数据块经解密后格式同非加密的支付结算查询结果文件，加密算法由招商银行定义。以下介绍非加密支付结算查询结果文件格式。l 如果第一行以“#”开始，这一行就表示支付结算查询结果文件的描述信息，各字段间用空格加分号分开。格式如下：BANKCODE=银行码（固定为“5456”，表示招商银行）；VERSION=接口版本（本文件定义的格式的版本为“2.0”）；TYPE=文件类型（最长10位字符，如：“PAYRS”表示支付结算查询结果）；MAKEDATE=文件生成日期（8位日期格式，yyyymmdd）；OPERATOR=经办人用户名(最长20位字符
23、串)；SUM=累计金额（整数部分最多13位，小数2位）；TOTAL=累计笔数（最长5位数字）；C_BUSCOD=业务类型（全部、支付、集团支付或内部转帐）；BEGINDATE=查询开始日期（8位日期格式，yyyymmdd）；ENDDATE=查询结束日期（8位日期格式，yyyymmdd）。由企业银行生成的对帐单文件，描述行的所有字段均不为空。l 正文的每一行代表一条支付结算查询记录，用rn结尾。每一条记录的各个字段之间用“_ ;” (空格加分号)分开，如果对应的字段没有任何内容，就不填写。l 一行中各元素意义如下：C_BUSCOD=业务类型；BUSMOD=业务模式；C_DBTBBK=付方开户地区
24、；DBTACC=付方帐号；DBTNAM=付方帐户名；C_DBTREL=付方公司名；DBTBNK=付方行名称；DBTADR=付方行地址；C_CRTBBK=收方开户地区；CRTACC=收方帐号；CRTNAM=收方帐户名；C_CRTREL=收方公司名；CRTBNK=收方行名称；CRTADR=收方行地址；C_GRPBBK=母公司开户地区；GRPACC=母公司帐号；GRPNAM=母公司帐户名；C_CCYNBR=币种；TRSAMT=交易金额；EPTDAT=期望日；EPTTIM=期望时间；BNKFLG=系统内外标志；REGFLG=同城异地标志；C_STLCHN=结算通路；NUSAGE=用途；NTFCH1=收
25、方电子邮件；NTFCH2=收方移动电话；OPRDAT=经办日期；YURREF=业务参考号；BUSNAR=业务摘要；C_REQSTS=请求状态；C_OPRALS=操作别名；C_RTNFLG=业务处理结果；RTNNAR=结果摘要；RTNDAT=退票日期；ATHFLG=是否有附件信息。l 格式：C_BUSCOD（业务类型）：12位字符。支付、集团支付或内部转帐。C_BUSMOD（业务模式）：支付结算业务所采用的业务审批模式，最长58位字符串。C_DBTBBK（付方开户地区）：付方帐号的开户行所在地区，最大12位字符串，如北京、上海和深圳等。DBTACC（付方帐号）：企业用于付款的转出帐号，该帐号的币
26、种类型与币种字段相符。最大35位数字。DBTNAM（付方帐户名）：企业用于付款的转出帐号的户名，最大58位字符。C_DBTREL（付方公司名）：付款企业的公司名称，最大58位字符。只对内部转帐有效。DBTBNK（付方开户行）：企业用于付款的转出帐号的开户行名称，如：招商银行北京分行。最长58位字符串。DBTADR（付方行地址）：企业用于付款的转出帐号的开户行地址，最大58位字符。C_CRTBBK（收方开户地区）：收方帐号的开户行所在地区，最大12位字符串，如北京、上海和深圳等。CRTACC（收方帐号）：收款企业的转入帐号，该帐号的币种类型与币种字段相符。最长35位数字。CRTNAM（收方帐户名
27、）：收款方企业的转入帐号的帐户名称。最大58位字符串。C_CRTREL（收方公司名）：收款方企业的公司名称，最大58位字符。CRTBNK（收方开户行）：收方帐号的开户行名称，如：招商银行北京分行。最长58位字符串。CRTADR（收方行地址）：收方帐号的开户行地址。C_GRPBBK（母公司开户地区）：企业所属母公司帐号的开户行所在地区，最大12位字符串，如北京、上海和深圳等。只对集团支付有效。GRPACC（母公司帐号）：企业所属母公司的帐号。最大35位数字。只对集团支付有效。GRPNAM（母公司帐户名）：企业所属母公司帐号的帐户名称。最大58位字符串。只对集团支付有效。C_CCYNBR（币种）：
28、付款的币种类型。最长10位字符串。如：人民币、港币或美元等。TRSAMT（交易金额）：该笔业务的付款金额。nnnnnnnnnnnnn.nn ，整数部分最多13位，小数部分为2位。EPTDAT（期望日）：期望该笔业务在该日期发生。8位日期格式，yyyymmdd。EPTTIM（期望时间）：期望该笔业务在期望日内指定的时间之后发生。6位数字，24小时制式的时间表示，hhmmss。只有小时数有效。可以为空。BNKFLG（系统内外标志）：表示该笔业务是否为招行系统内的支付结算业务，一位字符，“Y”表示系统内，“N”表示系统外。REGFLG（同城异地标志）：表示该笔业务是否为同城业务，一位字符，“Y”表示
29、同城业务；“N”表示异地业务。C_STLCHN（结算方式）：最大12位字符串。NUSAGE（用途）：最大28位字符串。NTFCH1（收方电子邮件）：收款方的电子邮件地址，用于邮件通知。最长36位字符串。可以为空。NTFCH2（收方移动电话）：收款方的移动电话，用于短信通知。最长16位字符串。可以为空。OPRDAT（经办日期）：经办该笔业务的日期。8位日期格式，yyyymmdd。YURREF（业务参考号）：用于标识该笔业务的编号，该号必须唯一。30位字符串。BUSNAR（业务摘要）：用于企业付款时填写说明或者备注。最长196位字符。REQSTS（请求状态）：支付结算业务请求目前所处的状态，3位字
30、母，AUT-待授权，NTE-受理完毕。C_OPRALS（操作别名）：待处理的操作名称。最大28位字符串。C_RTNFLG（业务处理结果）：支付结算业务处理的结果。1位字符，F-失败，S-成功，C-取消，R-拒绝。RTNNAR（结果摘要）：支付结算业务处理的结果，如失败原因、退票原因等。最大88位字符串。RTNDAT（退票日期）：8位日期格式，yyyymmdd。ATHFLG（是否有附件信息）：一位字符，“Y”表示有附件，“N”表示无附件。3.4 收方信息接口数据格式收方信息文件保存了支付收款方的名称、帐号、开户行等相关信息。本地收方信息是指企业的贸易伙伴通常较为固定，预先把收方信息编辑好，在支付
31、经办时引用或就地查询，可以大大方便支付经办工作，减少出错机会。收方信息也可以从企业的财务系统中导出。文件格式和含义如下：l 收方信息文件的文件名格式如下：“文件名”+“.”+“后缀”。用非加密方式保存的收方信息文件是一个文本文件，后缀是“RCV”；用加密方式保存的收方信息文件是一个二进制文件，后缀是“ERCV”。l 加密的收方信息文件由文件头和加密数据块两部分组成。加密数据块经解密后格式同非加密的收方信息文件，加密算法由招商银行定义。以下介绍非加密收方信息文件格式。l 如果第一行以“#”开始，这一行就表示收方信息文件的描述信息，各字段间用“_;”（空格加分号）分开。格式如下：SYSCODE=系
32、统代码（12位字符串，由招商银行定义）；VERSION=接口版本（本文件定义的格式的版本为“2.0”）；TYPE=文件类型（最长10位字符，如：“RECV”表示收方信息）；MAKEDATE=文件生成日期（8位日期格式，yyyymmdd）；OPERATOR=经办用户名(最长20位字符串)；TOTAL=收方总数（最长5位数字）。描述行中SYSCODE、VERSION和TYPE不可为空，其它字段可选，为空的字段不填写。l 正文的每一行代表一条收方信息记录，用rn结尾。每一条记录的各个字段之间用“_ ;” (空格加分号)分开，如果对应的字段没有任何内容，就不填写。l 一行中各元素意义如下：CRTSQN
33、=编号；CRTNAM=帐户名；CRTACC=帐号；CRTBNK=开户行；CRTPVC=省份；CRTCTY=城市；CRTDTR=县/区；NTFCH1=电子邮件 ；NTFCH2=移动电话。l 格式：CRTSQN（编号）：最长20位字符串。为索引关键字，不可以重复。CRTNAM（帐户名）：收款方企业的转入帐号的帐户名称。最大58位字符串。CRTACC（帐号）：收款企业的转入帐号，该帐号的币种类型与币种字段相符。最长35位数字。CRTBNK（开户行）：收方帐号的开户行名称，如：招商银行北京分行。最长58位字符串。名称中必须包含有“行”、“信用社”、“合作社”、“金库”或“联社”。CRTPVC（省份）：
34、收方帐号开户行所在的省份，最长16位字符串，格式为：XX省（或市或自治区）。如：广东省、北京市或新疆自治区。CRTCTY（城市）：收方帐号开户行所在的城市名，指市和省辖行政单位，最长20位字符串，格式为：XX市（或县），对直辖市，城市名可为空。如：深圳市。CRTDTR(县/区)：收方帐号开户行所在的县或区，最长20位字符串，格式为：XX县/区，可为空。如：宝安区。NTFCH1（邮件地址）：收款方的电子邮件地址，用于邮件通知。最长36位字符串。可以为空。NTFCH2（移动电话）：收款方的移动电话，用于短信通知。最长16位字符串。可以为空。3.5 代发接口数据格式代发数据接口文件用于企业在脱机状态
35、下或者在企业的财务系统中编写代发表，然后在联机时使用代发经办功能经办代发数据。文件格式和含义如下：l 代发表的文件名格式如下：“系统制单的日期（yymm）”+“-”+“序号i”+“.”+“后缀”。用非加密方式保存的代发表是一个文本文件，后缀是“APY”；用加密方式保存的代发表是一个二进制文件，后缀是“EAPY”。如：0008-10.apy是一个保存了2000年8月产生的序号为10的代发表； 0008-10.eapy则是一个加密的代发表。l 加密的代发表由文件头和加密数据块两部分组成。加密数据块经解密后格式同非加密的代发表，加密算法由招商银行定义。以下介绍非加密代发表格式。l 如果第一行以“#”
36、开始，这一行就表示代发表的描述信息，各字段间用空格加分号分开。格式如下：SYSCODE=系统代码（12位字符串，由招商银行定义）；VERSION=接口版本（本文件定义的格式为“2.0”）；TYPE=文件类型（最长10位字符，如：“AGENTP”表示代发）；MAKEDATE=文件生成日期（8位日期格式，yyyymmdd）；OPERATOR=经办用户名(最长20位字符串)；DBTACC=转出帐号（13或11位数字）；CURRENCY=币种（最长10位字符串，如：人民币、港币或美元等）；BANKAREA=开户行地区（分行城市名，最长10位字符串）；SUM=累计金额（整数部分最多13位，小数2位）；T
37、OTAL=累计人数（最长6位数字）；MEMO=备注（最长30位字符串）；YURREF=业务参考号（最长30位字符串）。描述行是可选择的，所有字段内容均可为空，为空的字段不填写。l 正文的每一行代表一条代发信息记录，用rn结尾。每一条记录的各个字段之间用“_ ;” (空格加分号)分开，如果对应的字段没有任何内容，就不填写。l 一行中各元素意义如下：ACCNBR=帐号； CLTNAM=姓名； TRSAMT=金额；TRSDSP=注释。l 格式：ACCNBR（帐号）：员工的收款帐户，可以是旧版一卡通、新版一卡通或存折，旧版一卡通应包含4位分行地区码和8位卡号，新版一卡通为16位，存折必须加4位分行地区
38、码（共14位）。如：075512888888（旧版一卡通）或07551288888811（存折）。CLTNAM（姓名）：员工姓名或编号，最长20位字符串。TRSAMT（金额）：代发的金额。nnnnnnnnnnnnn.nn ，整数部分最多13位，小数部分为2位。TRSDSP(注释)：对该笔代发的简单说明。最大16个字符。可以为空。3.6 代发结果数据格式企业代发经办和授权完毕后，企业银行系统可以把代发结果保存在代发结果接口文件，供企业保存或导入企业的财务系统。文件格式和含义如下：l 代发结果接口文件的文件名格式如下：“代发期望日期（yymmdd）”+“-”+“序号i”+ “.”+“后缀”。用非加
39、密方式保存的代发接口文件是一个文本文件，后缀是“SRT”；用加密方式保存的代发接口文件是一个二进制文件，后缀是“ESRT”。如：000801-1.srt是一个保存了期望日期为2000-08-01，序号为1的代发经办结果接口文件；000801-1.esrt则是加密的代发经办结果接口文件。l 加密的代发经办结果接口文件由文件头和加密数据块两部分组成。加密数据块经解密后格式同非加密的代发经办结果接口文件，加密算法由招商银行定义。以下介绍非加密代发经办结果接口文件格式。l 如果第一行以“#”开始，这一行就表示代发文件的描述信息，各字段间用“_ ;”（空格加分号）分开。格式如下：BANKCODE=银行码
40、（固定为“5456”，表示招商银行）；VERSION=接口版本（本文件定义的格式为“2.0”）；TYPE=文件类型（最长10位字符，如：“AGENTPRS”表示代发）；MAKEDATE=文件生成日期（8位日期格式，yyyymmdd）；COMPLETEDATE=业务发生日期（8位日期格式，yyyymmdd）；OPERATOR=生成文件的用户名(最长20位字符串)； DBTACC=转出帐号（13或11位数字）；CURRENCY=币种（最长10位字符串，如：人民币、港币或美元等）；BANKAREA=开户行地区（分行城市名，最长10位字符串）；SUM=累计金额（整数部分最多13位，小数2位）；TOTA
41、L=累计人数（最长6位数字）；MEMO=备注（最长30位字符串）；YURREF=业务参考号（最长30位字符串）。描述行是可选择的，所有字段内容均可为空，为空的字段不填写。l 正文的每一行代表一条收方信息记录，用rn结尾。每一条记录的各个字段之间用“_ ;” (空格加分号)分开，如果对应的字段没有任何内容，就不填写。l 一行中各元素意义如下：ACCNBR=帐号；CLTNAM=姓名； TRSAMT=金额；TRSDSP=注释 ； STSCOD=状态。l 格式：ACCNBR（帐号）：员工的收款帐户，可以是12位旧版一卡通、16位新版一卡通或存折，旧版一卡通应包含4位分行地区码和8位卡号，存折必须加4位
42、分行地区码（共14位）。如：075512888888（旧版一卡通）或07551288888811（存折）。CLTNAM（姓名）：员工姓名或编号，最长20位字符串。TRSAMT（金额）：代发的金额。nnnnnnnnnnnnn.nn ，整数部分最多13位，小数部分为2位。TRSDSP(注释)：注释或备注，对该笔代发的简单说明。最大16个字符。可为空。STSCOD（状态）：该笔代发所处的状态。如“成功”、“失败”、“ 撤消”等。3.7 代扣接口数据格式代扣数据接口文件用于企业在脱机状态下或者在企业的财务系统中编写代扣表，然后在联机时使用代扣经办功能经办代扣数据。文件格式和含义如下：l 代扣表的文件名
43、格式如下：“系统制单的日期（yymm）”+“-”+“序号i”+“.”+“后缀”。用非加密方式保存的代扣表是一个文本文件，后缀是“ACL”；用加密方式保存的代扣表是一个二进制文件，后缀是“EACL”。如：0008-10.acl是一个保存了2000年8月产生的序号为10的代扣表； 0008-10.eacl则是一个加密的代扣表。l 加密的代扣表由文件头和加密数据块两部分组成。加密数据块经解密后格式同非加密的代扣表，加密算法由招商银行定义。以下介绍非加密代扣表格式。l 如果第一行以“#”开始，这一行就表示代扣表的描述信息，各字段间用空格加分号分开。格式如下：SYSCODE=系统代码（12位字符串，由招
44、商银行定义）；VERSION=接口版本（本文件定义的格式为“2.0”）；TYPE=文件类型（最长10位字符，如：“AGENTC”表示代扣）；MAKEDATE=文件生成日期（8位日期格式，yyyymmdd）；OPERATOR=经办用户名(最长20位字符串)；DBTACC=收款帐号（13或11位数字）；CURRENCY=币种（最长10位字符串，如：人民币、港币或美元等）；BANKAREA=开户行地区（分行城市名，最长10位字符串）；SUM=累计金额（整数部分最多13位，小数2位）；TOTAL=累计人数（最长6位数字）；MEMO=备注（最长30位字符串）；YURREF=业务参考号（最长30位字符串）
45、。描述行是可选择的，所有字段内容均可为空，为空的字段不填写。l 正文的每一行代表一条代扣信息记录，用rn结尾。每一条记录的各个字段之间用“_ ;” (空格加分号)分开，如果对应的字段没有任何内容，就不填写。l 一行中各元素意义如下：ACCNBR=帐号； CLTNAM=姓名； TRSAMT=金额；TRSDSP=注释。l 格式：ACCNBR（帐号）：员工的扣款帐户，可以是12位旧版一卡通、16位新版一卡通或存折，旧版一卡通应包含4位分行地区码和8位卡号，存折必须加4位分行地区码（共14位）。如：075512888888（旧版一卡通）或07551288888811（存折）。CLTNAM（姓名）：员工
46、姓名或编号，最长20位字符串。TRSAMT（金额）：代扣的金额。nnnnnnnnnnnnn.nn ，整数部分最多13位，小数部分为2位。TRSDSP(注释)：对该笔代扣的简单说明。最大16个字符。可以为空。3.8 代扣结果数据格式企业代扣经办和授权完毕后，企业银行系统可以把代扣结果保存在代扣结果接口文件，供企业保存或导入企业的财务系统。文件格式和含义如下：l 代扣结果接口文件的文件名格式如下：“代扣期望日期（yymmdd）”+“-”+“序号i”+ “.”+“后缀”。用非加密方式保存的代扣接口文件是一个文本文件，后缀是“CRT”；用加密方式保存的代扣接口文件是一个二进制文件，后缀是“ECRT”。
47、如：000801-1.crt是一个保存了期望日期为2000-08-01，序号为1的代扣经办结果接口文件；000801-1.ecrt则是加密的代扣经办结果接口文件。l 加密的代扣经办结果接口文件由文件头和加密数据块两部分组成。加密数据块经解密后格式同非加密的代扣经办结果接口文件，加密算法由招商银行定义。以下介绍非加密代扣经办结果接口文件格式。l 如果第一行以“#”开始，这一行就表示代扣文件的描述信息，各字段间用“_ ;”（空格加分号）分开。格式如下：BANKCODE=银行码（固定为“5456”，表示招商银行）；VERSION=接口版本（本文件定义的格式为“2.0”）；TYPE=文件类型（最长10
48、位字符，如：“AGENTCRS”表示代扣）；MAKEDATE=文件生成日期（8位日期格式，yyyymmdd）；COMPLETEDATE=业务发生日期（8位日期格式，yyyymmdd）；OPERATOR=生成文件的用户名(最长20位字符串)； DBTACC=收款帐号（13或11位数字）；CURRENCY=币种（最长10位字符串，如：人民币、港币或美元等）；BANKAREA=开户行地区（分行城市名，最长10位字符串）；SUM=累计金额（整数部分最多13位，小数2位）；TOTAL=累计人数（最长6位数字）；MEMO=备注（最长30位字符串）；YURREF=业务参考号（最长30位字符串）。描述行是可选择的，所有字段内容均可为空，为空的字段不填写。l 正文的每一行代表一条收方信息记录，用