Skip to main content

Fetches your Amazon order history and matching/tags your Mint transactions

Project description

Mint Transactions Tagger for Amazon Purchases

Do you order a lot from Amazon? Tired of everything showing up as "Amazon" w/ category "Shopping"? Then this tool is for you!

This tool DOES NOT require an Amazon store card/Visa. All you need is to pay for your Amazon orders with an account that is sync'ed with Mint. For example, if you alternate between 5 different credit cards to pay for purchases on your Amazon account, only the transactions from credit cards sync'ed with Mint will get tagged.

This tool takes Amazon order reports and merges it with your existing Mint transactions. If it finds exact matches, it will either:

  • Update the transaction description/category if there was only 1 item
  • Split the transaction, one line-item per item in the order

The tagger will try to guess the best Mint category for you. It does this by looking at each item's category from the Amazon Items report. Look at category.py to see which Amazon categories map to which Mint categories.

!!!NEW!!! After running the tagger, if you are not happy with the category, simply change it! Next time you run the tagger, it will attempt to remember your past personalized category and apply it to future purchases of the same item. Caveats: this only works if item names match exactly. also, you must change all (or the majority of) all the past, tagged examples of that item. ie. if you only change 1 example and you have 10 purchases of that same item it will take whatever the most common category used for that item.

The tagger will NOT retag or touch transactions that have already been tagged. So feel free to adjust categories after the fact without fear that the next run will wipe everything out. However, if you DO want to re-tag previously tagged transactions, take a look at --retag_changed and --prompt_retag arguments.

Getting started

Setup

  1. pip3 install mint-amazon-tagger

  2. To get the latest from time to time, update your version: pip3 install --upgrade mint-amazon-tagger

  3. Chromedriver should be fetched automatically. But if you run into issues, try this:

# Mac:
brew tap homebrew/cask
brew cask install chromedriver

# Ubuntu/Debian:
# See also: https://askubuntu.com/questions/539498/where-does-chromedriver-install-to
sudo apt-get install chromium-chromedriver

Running - Full Auto

This mode will fetch your Amazon Order History for you as well as tag mint.

  1. mint-amazon-tagger --amazon_email email@cool.com --mint_email couldbedifferent@aol.com

Running - Semi-Auto

This mode requires you to fetch your Amazon Order History manually, then the tagger automates the rest.

  1. Generate and download your Amazon Order History Reports.

a. Login and visit Amazon Order History Reports

b. "Request Report" for "Items", "Orders and shipments", and "Refunds". Make sure the date ranges are the same.

c. Download the completed reports. Let's called them Items.csv Orders.csv Refunds.csv for this walk-through. Note that Refunds is optional! Yay.

  1. (Optional) Do a dry run! Make sure everything looks right first. Run: mint-amazon-tagger --items_csv Items.csv --orders_csv Orders.csv --refunds_csv Refunds.csv --dry_run --mint_email yourEmail@here.com

  2. Now perform the actual updates, without --dry_run: mint-amazon-tagger --items_csv Items.csv --orders_csv Orders.csv --refunds_csv Refunds.csv --mint_email yourEmail@here.com

  3. Sit back and relax! The run time depends on the speed of your machine, quality of internet connection, and total number of transactions. For reference, my machine did about 14k Mint transactions, finding 2k Amazon matches in under 10 minutes.

To see all options, see: mint-amazon-tagger --help

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mint-amazon-tagger, version 1.17
Filename, size File type Python version Upload date Hashes
Filename, size mint_amazon_tagger-1.17-py3-none-any.whl (42.0 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size mint-amazon-tagger-1.17.tar.gz (36.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page