Skip to content

Commit ab693d2

Browse files
wesmclaude
andcommitted
docs: Add Amazon transaction linking documentation
Document the new feature that links Monarch/YNAB transactions to Amazon orders when pressing 'i' (Info) on Amazon-like merchants. Includes matching criteria, example output, and requirements. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent 8e4d308 commit ab693d2

File tree

1 file changed

+39
-0
lines changed

1 file changed

+39
-0
lines changed

docs/guide/amazon-mode.md

Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -137,6 +137,45 @@ moneyflow amazon import ~/Downloads/"Your Orders"
137137

138138
Cancelled orders are automatically skipped during import.
139139

140+
### Transaction Linking with Monarch/YNAB
141+
142+
When you use Amazon mode alongside Monarch Money or YNAB, moneyflow can automatically link Amazon orders to
143+
transactions in your bank accounts.
144+
145+
**How it works:**
146+
147+
When viewing a transaction in Monarch or YNAB that has an Amazon-like merchant name (e.g., "Amazon.com",
148+
"AMZN MKTP US"), pressing ++i++ (Info) will:
149+
150+
1. Search your Amazon database for matching orders
151+
2. Match by amount (within $0.02 tolerance) and date (within 7 days)
152+
3. Display matched orders at the top of the transaction details
153+
154+
**Example:**
155+
156+
You have a $47.98 charge from "AMZN MKTP US" on your credit card. Pressing ++i++ shows:
157+
158+
```text
159+
Matching Amazon Orders
160+
───────────────────────────────────────
161+
Order: 113-1234567-8901234*
162+
Date: 2025-01-10 | From: amazon
163+
USB-C Cable (x2): -$12.99
164+
Wireless Mouse: -$24.99
165+
Total: -$37.98
166+
───────────────────────────────────────
167+
```
168+
169+
The `*` indicates a high-confidence match (exact amount and close date).
170+
171+
**Requirements:**
172+
173+
- Import your Amazon purchase history first (`moneyflow amazon import`)
174+
- Transaction must have "amazon" or "amzn" in the merchant name
175+
- Amount and date must be within tolerance
176+
177+
This feature helps you identify exactly what items were in each Amazon charge, making categorization easier.
178+
140179
### Incremental Imports
141180

142181
Amazon mode supports incremental imports, preserving any manual edits you've made:

0 commit comments

Comments
 (0)