import-transactions

取引のインポート

概要

銀行のエクスポートファイルから金融取引をインポートします。拡張子（.csv、.ofx、.qif）からファイル形式を自動検出し、列ヘッダーを調べて銀行（Chase、Amex、BofA、または一般）を特定します。解析した取引をプレビューし、既存のデータと重複していないか確認してから、新しいレコードを挿入します。

使用するWilsonツール

• transaction_search — 重複を防ぐため、既存の取引を確認します
• categorize — 新しくインポートした取引に分類ルールを適用します

ワークフロー

1. 銀行のエクスポートファイルのパスをユーザーに尋ねます。
2. 拡張子からファイル形式を検出します。
   • .csv — CSVとして解析し、ヘッダーを調べて銀行を特定します
   • .ofx / .qfx — OFX（Open Financial Exchange）として解析します
   • .qif — QIF（Quicken Interchange Format）として解析します
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（右側、またはケバブメニュー内）をクリックします
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をエクスポートできます。期間選択の近くにある「ダウンロード」、「エクスポート」、またはダウンロードアイコンを探してください。

スプレッドシートへの手動インポート

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件ずつのグループに分けて処理します。