家庭财务数据交换协议

Family Financial Data Exchange Protocol
(简称FFDEP，或FEP)

第一版(试行)

由深圳市快意客软件有限公司（家庭财富网） 起草于2004 发布于2005.10.05

序言

家庭是组成我们社会最基本的细胞，也是一个相对独立的经济实体。随着现代社会经济的发展，家庭经济活动越来越活跃，家庭财务数据也越来越烦杂，基本上每个家庭都与各种金融机构、服务团体等有一定的往来。在此形势下，许多家庭为了处理众多的私人财务数据，已使用或将会使用计算机及网络技术来帮助自身，既可减轻必不可少又烦杂的家庭事务，又能为提高家庭的资产效益，帮助达到理财目标，实现完美人生。

当我们应用家庭电脑来处理自已的财务信息时，需要对外进行各种数据的交换，如银行账户交易记录的批量下载或实时反馈、股票交易指令的提交或结算单的下载、社会保险账户的对账等等。为了方便、快速、协调地处理这些对外的数据，我们需要一个统一、规化的公共接口协议——《家庭财务数据交换协议》(FFDEP)。同时，此协议也是各家庭财务软件系统之间交换数据的一个桥梁。

第一部分记账记录

数据文件格式
采用ASCII文本，txt或csv文档格式。

由于各金融机构的计算机系统各不相同，对外的格式也是千差万别，但一般提供的数据大部分还是ASCII的文本为主，所以FEP采用ASCII普通文本为交换数据的主要格式。随着系统升级与技术的发展，XML可以考虑作为以后的升级版本格式。

文件内部结构
以行为单位，每行作为一条记录。

第一行是字段标题，以汉字命名，每项以“[]”括起来，也用分隔符分开。

从第二行开始到文件结尾都是正式的数据，数据项位置与第一行的标题对应。

数据项之间的顺序可以任意组合，只需标题与下面的数据项对应就行。

例子数据：

[账号],[日期],[收支种类],[币种],[收入],[支出],[余额],[摘要]

3819660311,2004-2005-01-05,支出,人民币,0,54.20, 6403.89,消费款

3819660311,2004-2005-04-08,收入,人民币,1000.00,0,1120.09,转保证金户

数据项分隔符

字段分隔符可以是以下三种，全部是英文半角符号：

逗号“,”

竖号“|”

Tab符“\t”

数据项标题名称
数据项有以下：
[账户],[账号],[日期],[收支种类],[币种],[收入],[支出],[余额],[摘要],[人员],[对方账户],[对方名称]

其中以下是必需的：[日期],[收支种类],[收入],[支出]
其余所有是可选的。

数据项说明
[账户]
对应M3软件中的账户名称。不超过40个字符。 如果缺省此项，则在进行交换时自动提醒补加可选账户。

[账号]
银行真实账号。[账号]与[账户]不能同时出现，只需有一项即可。

[日期]
交易发生的实际日期，格式为：四位年-两位月-两位日，不足补0

[收支分类]
对应M3软件中的收支分类项，如果发现有软件中不存在的项，在交换时可自动把它补到系统中，或者替换掉不存在项，如替换成“其他收入”或“其他支出”。

[币种]
中文名称表示。如“人民币”、“美元”、“港币”等。 如果缺省此项，则由账户中取币种。

[收入]
数字金额，格式是不带任何符号的纯数字，如“123.45”,“120”等 不能为空，如果没有，则为0

[支出]
数字金额，格式是不带任何符号的纯数字，如“123.45”,“120”等 不能为空，如果没有，则为0

[余额]
数字金额，格式是不带任何符号的纯数字，如“123.45”,“120”等 不能为空，如果没有，则为0 此项数据仅作参考，在数据交换导入后，将根据日期顺序按收入/支出重新结余，不会以此余额为准。

[摘要]
此笔交易的说明，最多100个字符（50个汉字）

[人员]
家庭成员的名字。

[对方账户]
如果收支类别是“转入”、“转出”，则有此项，对应软件中的账户名称。

[对方名称]
关联人员或对方的名称。如银行名称、转账时对方的名称等。

第二部分股票交易记录
(暂缺)

第三部分社会保险记录
(暂缺)