hledger中处理包含费用的货币兑换交易记录

在个人财务管理工具hledger中，处理包含手续费的货币兑换交易是一个常见需求。本文将通过一个实际案例，详细介绍如何正确配置CSV规则文件来导入这类交易记录。

问题背景

当用户使用Revolut等数字银行进行货币兑换时，交易记录通常包含以下字段：

• 兑换金额（Amount）
• 手续费（Fee）
• 货币类型（Currency）

以英镑兑换为例，原始数据可能如下：

2024-10-05 | Exchanged to GBP | 48.21 | 0.48 | GBP

其中48.21英镑是总流入金额，0.48英镑是手续费，实际净增加金额应为47.73英镑。

正确的记账方式

在复式记账系统中，这类交易应该记录为：

2024-10-05 Exchanged to GBP
    transfer:revolut-usd-gbp     £-48.21
    assets:bank:revolut:GBP      £47.73
    expenses:fx-fees             £0.48

CSV规则配置方案

要实现这种记账方式，我们需要精心设计CSV规则文件。以下是关键步骤：

1. 字段映射：首先明确映射CSV文件中的各个字段

skip 1
fields type_, product_, started_date_, completed_date_, description_, amount_, fee_, currency_, state_, balance_

2. 日期格式设置：指定CSV中的日期格式

date %completed_date_
date-format %Y-%m-%d %H:%M:%S

3. 交易规则：针对有手续费的交易设置记账规则

if %fee_ [1-9]
    account1 transfer:revolut
    amount1 -%amount_
    account2 assets:bank:revolut:%currency_
    account3 expenses:fx-fees:revolut
    amount3 %fee_

技术要点解析

1. 字段命名：为避免与hledger关键字冲突，建议在字段名后加下划线（如amount_代替Amount）

2. 金额计算：hledger支持自动计算缺失的金额，只需确保：

   • 明确指定两个金额（amount1和amount3）
   • 留空一个金额（amount2）让系统自动计算

3. 导入选项：

   • 使用hledger print查看原始转换结果
   • 使用hledger print -x查看包含计算后金额的完整交易
   • 使用hledger import命令会自动应用-x选项，填充缺失金额

常见问题解决

如果遇到"transaction is unbalanced"错误，检查：

1. 是否正确定义了所有账户
2. 金额符号是否正确（支出应为负值）
3. 确保只留空一个金额字段供系统计算

通过以上配置，用户可以轻松地将包含手续费的货币兑换交易导入hledger，并保持账目平衡。这种方法不仅适用于Revolut，也可适配其他类似金融机构的CSV导出格式。