https://github.com/richardlitt/ynab-convert-csv

A converter for Banking transaction CSV files to YNAB format
https://github.com/richardlitt/ynab-convert-csv

bank converter csv schwab td-bank transaction ynab ynab-format

Last synced: 8 days ago
JSON representation

A converter for Banking transaction CSV files to YNAB format

• Host: GitHub
• URL: https://github.com/richardlitt/ynab-convert-csv
• Owner: RichardLitt
• License: mit
• Created: 2016-07-27T17:21:58.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2017-10-02T15:39:17.000Z (over 7 years ago)
• Last Synced: 2025-01-27T11:31:46.542Z (16 days ago)
• Topics: bank, converter, csv, schwab, td-bank, transaction, ynab, ynab-format
• Language: JavaScript
• Homepage:
• Size: 9.77 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

README

        
# ynab-convert-csv

> A converter for Banking transaction CSV files to YNAB format

This tool lets you transform csvs from various banks into a format expected by YNAB. Currently accepted Schwab and TDBank only.

## Install

    npm install -g ynab-convert-csv

## Usage

    ynab-convert-csv --input=examples/schwab.csv --output=schwab_CONVERTED.csv [--map=map.json] --bank=schwab

## Mapping files

If you supply a mapping file, we'll try to map transactions to payees and categories. This matching is pretty simple, keys in a JSON file are matched with transaction descriptions with a "starts with" check. So, for example, a transaction with a description of `VDP-PAYPAL` will match transactions that start with this (e.g. `VDP-PAYPAL *SPOTIF` would match). Beneath these keys is an object with two keys: `payee` & `category`, which you can use to specify your payees and categories. Payees and categories here work the same way they do in YNAB, so transfers, for example, will have the same rules as YNAB for whether they need a category or not.

Examples speak louder than words, here's a sample `map.json`:

    {

      "VDP-Amazon *Mktplc": {

        "payee": "Amazon Marketplace",

        "category": "Everyday Expenses: Amazon"

      },

      "VDA-": {

        "payee": "Transfer: Cash",

        "category": ""

      },

      "D/D BORD GAIS EIRE": {

        "payee": "Bord Gais",

        "category": "Monthly Bills: Gas and Electricity"

      }

    }

If a map isn't found, the transformer falls back to using the description for both `payee` and `category`.

## For Schwab

For schwab, there's an extra line at the beginning of the file that currently needs to be manually deleted. Work is ongoing on the `feat/strip-schwab-lines` branch.

## Contribute

Please do! I basically used the code from [this module for AIB](https://github.com/jasonmadigan/aib-to-ynab) by [@jasonmadigan](https://github.com/jasonmadigan), to whom I am very grateful. Happy to edit this or pass it along to others who are interested. Open an issue.

## License

MIT