Import Transactions
Overview
Import financial transactions from bank export files. Automatically detects file format by extension (.csv, .ofx, .qif) and identifies the bank (Chase, Amex, BofA, or generic) by inspecting column headers. Previews parsed transactions, deduplicates against existing data, and inserts new records.
Wilson Tools Used
transaction_search — check for existing transactions to prevent duplicates
categorize — apply categorization rules to newly imported transactions
Workflow
- Ask the user for the file path to their bank export.
- Detect the file format by extension:
.csv — parse as CSV, inspect headers to identify bank
.ofx / .qfx — parse as OFX (Open Financial Exchange)
.qif — parse as QIF (Quicken Interchange Format)
- For CSV files, identify the bank by header patterns:
- Chase:
Transaction Date,Post Date,Description,Category,Type,Amount,Memo
- Amex:
Date,Description,Amount (or Reference,Date,Description,Card Member,Amount)
- Bank of America:
Date,Description,Amount,Running Bal.
- Generic: any CSV with recognizable date, description, and amount columns
- Preview the first 5 parsed transactions for the user to confirm.
- Deduplicate by matching date + amount + description against existing transactions.
- Report how many new vs. duplicate transactions were found.
- Insert new transactions into the database.
- Offer to run
categorize on the newly imported transactions.
Without Wilson
You can import transactions manually into any spreadsheet or accounting tool:
Downloading Exports
Chase:
- Log in at chase.com
- Go to the account > Statements & Documents
- Click Download account activity (top right of transaction list)
- Select date range and format: CSV, OFX/QFX, or QIF
- File downloads to your computer
American Express:
- Log in at americanexpress.com
- Go to Statements & Activity
- Click Download your Transactions (right side or under the kebab menu)
- Select date range, choose CSV or OFX/QFX
- Download
Bank of America:
- Log in at bankofamerica.com
- Go to the account > Information & Services tab
- Click Download transactions
- Select date range and format: Microsoft Excel (.csv), Quicken (.qfx), or QuickBooks (.qbo)
- Download
Generic / Other Banks:
Most banks offer CSV or OFX export from their transaction history page. Look for "Download," "Export," or a download icon near the date range selector.
Manual Import into a Spreadsheet
- Open the CSV in Excel or Google Sheets.
- Normalize columns to:
Date, Description, Amount, Category.
- Make amounts negative for expenses, positive for income/credits.
- Remove duplicate rows using Data > Remove Duplicates (Excel) or the
=UNIQUE() function (Sheets).
- Sort by date.
OFX/QIF Files
- OFX files are XML-based. You can open them in a text editor to inspect, or import directly into GnuCash, Quicken, or YNAB.
- QIF files are plain text. Each transaction starts with
D (date), T (amount), P (payee). You can convert QIF to CSV with online tools like qif2csv.com.
Important Notes
- Chase CSV exports use negative amounts for payments/credits and positive for charges. Wilson normalizes this (negative = expense, positive = income).
- Amex CSV has amounts where charges are positive. Wilson inverts the sign on import.
- OFX files contain a date range in the header — Wilson uses this to scope deduplication.
- Deduplication is based on date + amount + description. If you manually edited a transaction description in your bank's app, the edited version may import as a new record.
- Large imports (1000+ transactions) are batched in groups of 500 for performance.
1---
2name: import-transactions
3description: >
4 Import transactions from CSV, OFX, or QIF bank exports and deduplicate.
5metadata:
6 source: https://skillmd.com/skills/openaccountant/import-transactions
7---
8
9# Import Transactions
10
11## Overview
12Import financial transactions from bank export files. Automatically detects file format by extension (.csv, .ofx, .qif) and identifies the bank (Chase, Amex, BofA, or generic) by inspecting column headers. Previews parsed transactions, deduplicates against existing data, and inserts new records.
13
14## Wilson Tools Used
15- `transaction_search` — check for existing transactions to prevent duplicates
16- `categorize` — apply categorization rules to newly imported transactions
17
18## Workflow
191. Ask the user for the file path to their bank export.
202. Detect the file format by extension:
21 - `.csv` — parse as CSV, inspect headers to identify bank
22 - `.ofx` / `.qfx` — parse as OFX (Open Financial Exchange)
23 - `.qif` — parse as QIF (Quicken Interchange Format)
243. For CSV files, identify the bank by header patterns:
25 - **Chase**: `Transaction Date,Post Date,Description,Category,Type,Amount,Memo`
26 - **Amex**: `Date,Description,Amount` (or `Reference,Date,Description,Card Member,Amount`)
27 - **Bank of America**: `Date,Description,Amount,Running Bal.`
28 - **Generic**: any CSV with recognizable date, description, and amount columns
294. Preview the first 5 parsed transactions for the user to confirm.
305. Deduplicate by matching date + amount + description against existing transactions.
316. Report how many new vs. duplicate transactions were found.
327. Insert new transactions into the database.
338. Offer to run `categorize` on the newly imported transactions.
34
35## Without Wilson
36You can import transactions manually into any spreadsheet or accounting tool:
37
38### Downloading Exports
39
40**Chase:**
411. Log in at chase.com
422. Go to the account > **Statements & Documents**
433. Click **Download account activity** (top right of transaction list)
444. Select date range and format: **CSV**, **OFX/QFX**, or **QIF**
455. File downloads to your computer
46
47**American Express:**
481. Log in at americanexpress.com
492. Go to **Statements & Activity**
503. Click **Download your Transactions** (right side or under the kebab menu)
514. Select date range, choose **CSV** or **OFX/QFX**
525. Download
53
54**Bank of America:**
551. Log in at bankofamerica.com
562. Go to the account > **Information & Services** tab
573. Click **Download transactions**
584. Select date range and format: **Microsoft Excel (.csv)**, **Quicken (.qfx)**, or **QuickBooks (.qbo)**
595. Download
60
61**Generic / Other Banks:**
62Most banks offer CSV or OFX export from their transaction history page. Look for "Download," "Export," or a download icon near the date range selector.
63
64### Manual Import into a Spreadsheet
651. Open the CSV in Excel or Google Sheets.
662. Normalize columns to: `Date`, `Description`, `Amount`, `Category`.
673. Make amounts negative for expenses, positive for income/credits.
684. Remove duplicate rows using **Data > Remove Duplicates** (Excel) or the `=UNIQUE()` function (Sheets).
695. Sort by date.
70
71### OFX/QIF Files
72- OFX files are XML-based. You can open them in a text editor to inspect, or import directly into GnuCash, Quicken, or YNAB.
73- QIF files are plain text. Each transaction starts with `D` (date), `T` (amount), `P` (payee). You can convert QIF to CSV with online tools like qif2csv.com.
74
75## Important Notes
76- Chase CSV exports use negative amounts for payments/credits and positive for charges. Wilson normalizes this (negative = expense, positive = income).
77- Amex CSV has amounts where charges are positive. Wilson inverts the sign on import.
78- OFX files contain a date range in the header — Wilson uses this to scope deduplication.
79- Deduplication is based on date + amount + description. If you manually edited a transaction description in your bank's app, the edited version may import as a new record.
80- Large imports (1000+ transactions) are batched in groups of 500 for performance.