import-transactions

导入交易

概述

从银行导出文件导入金融交易。根据扩展名（.csv、.ofx、.qif）自动检测文件格式，并通过检查列标题识别银行（Chase、Amex、BofA 或通用格式）。预览解析后的交易，与现有数据去重，然后插入新记录。

使用的 Wilson 工具

• transaction_search — 检查是否存在交易，以防止重复
• categorize — 对新导入的交易应用分类规则

工作流

1. 向用户询问银行导出文件的路径。
2. 根据扩展名检测文件格式：
   • .csv — 解析为 CSV，并检查标题以识别银行
   • .ofx / .qfx — 解析为 OFX（开放式金融交换格式）
   • .qif — 解析为 QIF（Quicken 交换格式）
3. 对于 CSV 文件，根据标题模式识别银行：
   • Chase：Transaction Date,Post Date,Description,Category,Type,Amount,Memo
   • Amex：Date,Description,Amount（或 Reference,Date,Description,Card Member,Amount）
   • Bank of America：Date,Description,Amount,Running Bal.
   • 通用格式：包含可识别的日期、描述和金额列的任意 CSV
4. 向用户预览前 5 笔解析后的交易，以供确认。
5. 根据日期 + 金额 + 描述与现有交易匹配，进行去重。
6. 报告找到的新交易和重复交易数量。
7. 将新交易插入数据库。
8. 询问是否要对新导入的交易运行 categorize。

不使用 Wilson

你可以将交易手动导入任意电子表格或会计工具：

下载导出文件

Chase：

1. 登录 chase.com
2. 前往账户 > Statements & Documents
3. 点击 Download account activity（位于交易列表右上方）
4. 选择日期范围和格式：CSV、OFX/QFX 或 QIF
5. 文件将下载到你的电脑

American Express：

1. 登录 americanexpress.com
2. 前往 Statements & Activity
3. 点击 Download your Transactions（位于右侧或 kebab 菜单下）
4. 选择日期范围，并选择 CSV 或 OFX/QFX
5. 下载文件

Bank of America：

1. 登录 bankofamerica.com
2. 前往账户 > Information & Services 标签页
3. 点击 Download transactions
4. 选择日期范围和格式：Microsoft Excel (.csv)、Quicken (.qfx) 或 QuickBooks (.qbo)
5. 下载文件

通用格式 / 其他银行： 大多数银行都提供从交易历史页面导出 CSV 或 OFX 的功能。在日期范围选择器附近查找“Download”“Export”或下载图标。

手动导入电子表格

1. 在 Excel 或 Google Sheets 中打开 CSV。
2. 将列统一为：Date、Description、Amount、Category。
3. 支出金额设为负数，收入/贷项金额设为正数。
4. 使用 Data > Remove Duplicates（Excel）或 =UNIQUE() 函数（Sheets）删除重复行。
5. 按日期排序。

OFX/QIF 文件

• OFX 文件基于 XML。你可以用文本编辑器打开文件进行检查，也可以直接将其导入 GnuCash、Quicken 或 YNAB。
• QIF 文件是纯文本。每笔交易以 D（日期）、T（金额）、P（收款方）开头。你可以使用 qif2csv.com 等在线工具将 QIF 转换为 CSV。

重要说明

• Chase CSV 导出文件中，付款/贷项金额为负数，消费金额为正数。Wilson 会对其进行规范化处理（负数 = 支出，正数 = 收入）。
• Amex CSV 中的消费金额为正数。Wilson 会在导入时反转正负号。
• OFX 文件的标题中包含日期范围 — Wilson 会利用该范围限定去重范围。
• 去重依据为日期 + 金额 + 描述。如果你在银行应用中手动修改了交易描述，修改后的版本可能会作为新记录导入。
• 对于大型导入（1000 笔以上交易），会按每组 500 笔分批处理，以提升性能。