附录A 接口数据格式定义招商银行.doc
《附录A 接口数据格式定义招商银行.doc》由会员分享,可在线阅读,更多相关《附录A 接口数据格式定义招商银行.doc(57页珍藏版)》请在三一办公上搜索。
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 代发接口数据格式185.8 代发结果数据格式195.9 代扣接口数据格式205.10 代扣结果数据格
2、式215.11 帐户列表数据格式225.12 帐户详细信息数据格式235.13 到帐、付款交易通知格式235.14 直接支付结果通知格式255.15 国内信用证经办格式265.16国内信用证开证结果格式295.17国内信用证可撤消/待审批结果格式325.18国内信用证经办/撤消/审批结果格式335.19 国内信用证受益人信息接口数据格式335.20 汇出汇款经办345.21 订单状态接口格式385.22 代理清算经办40附录A 术语说明42A.1银行代码42A.2系统代码42附录B INI Plus格式45B.1概述45B.2格式说明45B.3示例45附录C 系统文件45C.1 本地信息文件4
3、5C.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 业务请求状态54E.8业务处理结果54附录F C+加解密文件源码示例55第一章 概述1.1目的本文件描述了企业银行系统中定义的文件数据格式接口及直连接口,这些接口可用于企业银行系统与财务系统对接。接口根据数据流向,可分为两大类,一类是由企业银行系统生成,需要导出到企业的财务系统中,如:对帐单、支付和集团支付查询结果、发工资
4、查询结果、收方信息、受益人信息等;另一类是由企业财务系统生成,需要导入到企业银行系统,用于经办业务,如:成批支付结算数据、工资表、收方信息、受益人信息、成批信用证申请文件等。文件接口根据是否采用了加密方式保存,也可以分为加密和非加密格式两大类。通常加密文件后缀的第一个字符是“E”。1.2修订记录日期修订版本修订内容2003-02-282.0.0创建。2004-02-202.0.1修改对帐单接口。2004-05-242.1.0以表格形式描述各业务数据字段,方便阅读。2004-12-82.1.1修正一些小错误。2007-02-022.2.2集合Finance.dll的修改对它的使用示例程序进行修改
5、。2008-01-293.0.0增加对逗号分隔文件的详细说明2008-11-293.1.0更新各业务接口说明,整理excel及逗号分隔文件的说明。2011-06-173.2.0简化文档结构,增加代发的他行接口说明。本接口文档适用于企业银行系统4.0.2版及以后版本、直联1.0及以后版本。第二章 文件接口结构2.1 概述文件是从企业银行客户端保存下来的文件,或是从财务系统导出的符合本文档定义的接口文件。旧版本的格式文件,例如*.pam,*.apy等会逐渐过渡到excel或逗号分隔文件(*.csv或*.txt)的格式。2.2 EXCEL及逗号分割文件(*.csv或*.txt)Csv文件是以逗点分隔
6、各字段,以换行分隔各记录的文本文件,Excel支持把表格另存为这种格式,其它很多财务系统也支持这功能。是个通用格式。以下描述的格式适用于Excel或逗号分隔文件,只是Excel用格子分开每个数据,逗号分隔文件用逗号及换行分开每个数据。招行网上企业银行导出的逗号分隔文件一般以*.txt做文件后缀,文件格式与csv是一样的,只是后缀名不同,导入时支持csv及txt。第一行为每列数据的字段名称行,用逗点或格子分隔各名称从第二行开始为每条记录的值,用逗点或格子分隔(仅适用于逗号分隔文件)若值中间有逗号或换行或”号,将用”号括引此值,如果值中存在”号,则用两个”代表一个”,例如”代表值是”。换行符为”r
7、n”。下面是例子:YUEREF,TRSAMT,USRNBR2007,999,N1972009,111,N198此例表示有两条记录,每条记录有三个字段,名称分别是YUEREF、TRSAMT、USRNBR。第一条记录的YUEREF值是2007,TRSAMT值是999,USRNBR值是N197;第二条记录的YUEREF值是2009,TRSAMT值是111,USRNBR值是N198【注意】Excel在导出csv文件时,可能会在文件最后面产生空记录但带有逗点的行,请把它们删除。或者在excel里实现把多余的空行空列去掉。第三章 旧版本接口文件3.1 概述本章所描述的文件格式会逐渐被excel及*.csv
8、/*.txt替代,导入导出时请尽量选择excel或*.csv/*.txt。3.2非加密文件非加密格式的文件为文本文件,包括描述信息和正文两部分。详细内容可参照第五章“文件描述”。描述信息在文件的第一行,且以“#”开始,各字段间用空格加分号分开,描述信息可以为空。正文的每一行代表一个查询记录,用rn结尾。每一个记录之间的各个元素之间用空格加分号分开,如果对应的元素没有任何内容,可以不填写。具体格式请看“附录B INI PLUS格式”3.3加密文件加密格式的文件是采用招行的程序加密本文档所描述的各种文本文件,一般加密文件的后缀名都以e开头。企业若要自行生成加密或解密文件,请参考附录F的代码示例。3
9、.4各业务数据文件后缀列表加密非加密对帐单*.eact*.act支付结算接口*.epam*.pam代发接口*.eapy*.apy代扣接口*.eacl*.acl收方信息接口*.ercv*.rcv支付查询结果*.eprt*.prt代发查询结果*.esrt*.srt代扣查询结果*.ecrt*.crt第四章 直联接口结构4.1概述直联接口是财务系统通过企业银行直连控件与企业银行系统交换数据的接口。直联与文件数据的格式一般相同,只是表现的形式不同,直联通过控件DLL与财务系统对接。本文档只描述直联的数据接口,有关直连的其它内容,请察看文档“企业银行嵌入式直联系统开发指南.doc”第五章 数据接口格式描述
10、数据由描述块和数据块两部分组成。描述块记录了数据接口的相关信息,如接口版本等。数据块记录了业务信息。(描述块一般从招行网银客户端导出时会有,企业若要自行生成此类文件导入,描述块不是必须的)描述块为数据接口的第一行,如果第一行以“#”开始,这一行记录了描述信息,描述块可以为空。描述块由多个字段组成,各字段间用 “_ ;”(空格加分号,_表示空格,以下同)分开,每个字段的格式为:字段名=数值。数据块由多条记录组成,每一行表示一条记录,以“rn”结尾(注:“rn”是指回车符和换行符)。每条记录由多个字段组成,各字段间用 “_ ;” (空格加分号)分开,每个字段的格式为:字段名=数值。字段名必须大写。
11、每一个字段除特殊说明都有类型定义,例如C(1,20)代表字符类型,允许1到20个字符,也可省略为C(20);N(20,20)代表数字类型,只允许20个数字。数据类型定义:描述C字符类型,包括中英文字符及数字N数字类型D日期类型,格式为:yyyymmddT6位时间格式,hhmmnnM金额类型,nnnnnnnnnnnnn.nn,整数部分最多13位,小数部分为2位5.1 对帐单数据接口格式对帐单接口用于企业对帐,包括当天交易和历史交易的帐务数据。数据格式和含义如下:描述行字段定义:名称代码类型可否为空描述银行码BANKCODEC(12)可固定为“5456”,表示招商银行接口版本VERSIONC(12
12、)可本文件定义的格式的版本为“2.0”数据类型TYPEC(10)可如:“ACCOUNT”表示对帐单银行帐号ACCOUNTC(11,13)可11位或13位字符串帐户币种CURRENCYC(10)可如:人民币、港币对帐单生成日期MAKEDATED可经办人用户名OPERATORC(20)可累计借金额SUMDEBITM可累计借总笔数TOTALDEBITN(5)可累计贷金额SUMCREDITM可累计贷总笔数TOTALCREDITN(5)可对帐单期初余额BEGINBALANCEM可对帐单余额BALANCEM可查询开始日期BEGINDATED可查询结束日期ENDDATED可开户行地区BANKAREAC(12
13、)可数据正文字段定义:名称代码类型可否为空描述交易日ETYDATD否交易发生的日期交易时间ETYTIMT否交易发生的时间,只有小时有效起息日VLTDATD可开始计息的日期交易类型TRSCODC(8)可具体定义见附录E.4摘要NARYURC(16)可若为企业银行客户端经办的交易,则该字段为用途信息(4.0版代发代扣业务除外)若为其它渠道经办的交易,则该字段为交易的简单说明和注解。借方金额TRSAMTDM可企业为借方时的交易金额贷方金额TRSAMTCM可企业为贷方时的交易金额余额TRSBLVM可帐户的联机余额流水号REFNBRC(8)否银行会计系统交易流水号流程实例号REQNBRN(10)可企业银
14、行交易序号,唯一标示企业银行客户端发起的一笔交易业务名称BUSNAMC(28)可用途NUSAGEC(28)可业务参考号YURREFC(30)可企业银行客户端录入的业务参考号。用企业银行做的交易会有业务参考号,没有票据号,在柜台或其它地方生成的交易有票据号或其它的唯一标识,都统一称为业务参考号业务摘要BUSNARC(196)可对业务的简单说明或注解。企业银行客户端录入的摘要信息其它摘要OTRNARC(58)可对业务的其它说明或注解(暂不使用)收/付方开户地区C_RPYBBKC(12)可收/付方帐号开户行所在地区,如北京、上海、深圳等收/付方名称RPYNAMC(58)可收/付方帐户名称收/付方帐号
15、RPYACCN(35)可收/付方的转入或转出帐号收/付方开户行行号RPYBBNC(20)可收/付方帐号的开户行的行号收/付方开户行名RPYBNKC(58)可收/付方帐号的开户行的行名收/付方开户行地址RPYADRC(58)可母/子公司所在地区C_GSBBBKC(12)可母/子公司帐号的开户行所在地区,如北京、上海、深圳等母/子公司帐号GSBACCC(35)可母/子公司名称GSBNAMC(62)可信息标志INFFLGN(1)可用于标识收/付方帐号和母/子公司的信息。为空表示付方帐号和子公司;为“1”表示收方帐号和子公司;为“2”表示收方帐号和母公司;为“3”表示原收方帐号和子公司有否附件信息标志
16、C_ATHFLGC(2)可票据号CHKNBRC(10)可订单号REFSUBC(20)可冲帐标志RSVFLGC(1)可*为冲帐,X为补帐扩展摘要NAREXTC(30)可有效位数为16交易分析码TRSANLC(6)可1-2位取值含义件附录E.3,3-6位取值含义件附录E.4。建议:该字段取值后台没有统一标准,所以附录E.3和E.4不易公开发表。如有客户需要区分不同交易,再根据具体情况提供取值范围。查询的账号+交易日(ETYDAT)+流水号(REFNBR)可以确定唯一一笔交易5.2 支付结算数据接口格式成批支付结算接口用于用户在脱机状态下或在企业的财务系统中完成批量支付结算数据录入,并使用成批经办功
17、能一次性经办一批支付结算数据,该接口可用于支付和集团支付两种业务。数据格式和含义如下:描述行字段定义(企业自己做的支付文件,可不填这些字段):名称代码类型可否为空描述系统代码SYSCODEC(12)可由招商银行定义接口版本VERSIONC(12)可本文件定义的格式的版本为“2.0”数据类型TYPEC(10)可如:“PAYMENT”表示支付结算数据生成日期MAKEDATED可经办用户名OPERATORC(20)可累计金额SUMM可累计笔数TOTALN(5)可状态STATUSC(1)可N:不允许增加、删除或修改记录数据正文字段定义:名称代码类型可否为空描述业务参考号YURREFC(30)否用于标识
18、该笔业务的编号,企业银行编号+业务类型+业务参考号必须唯一。企业可以自定义业务参考号,也可使用银行缺省值(单笔支付),批量支付须由企业提供。直联必须用企业提供期望日EPTDATD否期望该笔业务开始提交银行处理日期。期望时间EPTTIMT可期望该笔业务在期望日内指定的时间之后发生。付方帐号DBTACCN(35)否企业用于付款的转出帐号,该帐号的币种类型必须与币种字段相符。付方开户地区C_DBTBBKC(12)否付方帐号的开户行所在地区,如北京、上海深圳等。交易金额TRSAMTM否该笔业务的付款金额。币种C_CCYNBRC(10)否付款的币种类型。如:人民币、港币或美元等。结算方式C_STLCHN
19、C(12)否期望该笔业务以何种方式完成结算,如:快速、普通等。用途NUSAGEC(56)否此字段的有效长度为16字节,该值对应对账单中的摘要NARTXT业务摘要BUSNARC(196)可用于企业付款时填写说明或者备注。收方帐号CRTACCN(35)否收款企业的转入帐号,该帐号的币种类型必须与币种字段相符。收方帐户名CRTNAMC(58)否收款方企业的转入帐号的帐户名称。收方开户行CRTBNKC(58)否收方帐号开户行名称,如:招商银行北京分行。名称中必须包含有“行”、“信用社”、“合作社”或“联社”。收方行联行号BRDNBRC(30)可人行规定的所有银行支行联行号收方省份CRTPVCC(16)
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 附录A 接口数据格式定义 招商银行 附录 接口 数据格式 定义
![提示](https://www.31ppt.com/images/bang_tan.gif)
链接地址:https://www.31ppt.com/p-2393557.html