bank-sync

Bank Sync

概要

Plaid API を使って銀行口座を接続し、取引を自動で定期的にインポートできます。接続すると、Wilson が手動で CSV をエクスポートしなくても、毎日新しい取引を取得します。数千の金融機関の当座預金口座、普通預金口座、クレジットカード口座に対応しています。

注意：Plaid 連携には Wilson Pro ライセンスが必要です。

使用する Wilson ツール

• transaction_search — インポートされた取引を確認し、重複がないか確認します
• categorize — 新しく同期された取引を自動で分類します

ワークフロー

1. ユーザーが有効な Wilson Pro ライセンスを持っていることを確認します。
2. Plaid Link フローを開始し、銀行口座を接続します。
   • ユーザーが金融機関を選択します
   • ユーザーが銀行の認証情報を使って認証します
   • ユーザーが同期する口座を選択します
3. Plaid アクセストークンをローカルデータベースに安全に保存します。
4. 初回同期を実行して、過去 30 日間の取引を取得します。
5. 以前にインポートされた取引と照合し、重複を除外します。
6. 新しく同期された取引に対して categorize を実行します。
7. 同期結果（新しい取引、スキップした重複、接続された口座）を報告します。
8. 毎日の自動同期を設定します（次回の Wilson セッション開始時に実行されます）。

Wilson を使わない場合

Wilson Pro をお持ちでない場合や、手動でのインポートを希望する場合は、主要銀行ごとの代替手段をご覧ください。

手動エクスポートのスケジュール（毎月を推奨）

Chase：

• chase.com > Account > Download account activity > CSV
• または、一定額を超える取引について Chase のメールアラートを設定します

Bank of America：

• bankofamerica.com > Account > Information & Services > Download transactions > CSV
• BofA は Quicken／QuickBooks への自動エクスポートにも対応しています

Wells Fargo：

• wellsfargo.com > Account > Download Account Activity > Comma Delimited

Citi：

• citibank.com > Account > View Activity > Download（CSV、OFX、QIF）

Capital One：

• capitalone.com > Account > Download Transactions > CSV

American Express：

• americanexpress.com > Statements & Activity > Download your Transactions > CSV

Plaid の無料代替サービス

• Monarch Money（$9.99/月）：予算管理機能付きの銀行口座自動同期
• Lunch Money（$10/月）：開発者に使いやすく、CSV インポートと Plaid 同期に対応
• Actual Budget（無料、セルフホスト可能）：OFX に対応した手動インポート
• GnuCash（無料）：一部の銀行から OFX を直接ダウンロード

Plaid を使わない自動化

• 毎月、各銀行から CSV をエクスポートするようカレンダーにリマインダーを設定します
• import-transactions スキルを使って各ファイルをインポートします
• 一部の銀行は OFX Direct Connect に対応しています。GnuCash と KMyMoney では、Plaid を使わずに取引を自動取得できます

重要な注意事項

• Plaid の認証情報は Wilson のデータベースにローカル保存され、端末の外に送信されることはありません。
• 銀行同期では Plaid の取引同期 API を使用します。この API では、サーバー側で重複が処理されます。
• 一部の金融機関では 90 日ごとに再認証が必要です（Plaid から案内されます）。
• Plaid は米国、カナダ、英国の 12,000 以上の金融機関に対応しています。
• 銀行との接続が切れた場合、Wilson から通知が届き、再認証または手動での CSV インポートへの切り替えを選択できます。