ynab-api-import 0.1.1

Library to import bank transactions via API into You Need A Budget (YNAB)

ynab-api-import

This library enables importing YNAB transactions via the Gocardless Bank Account Data API (formerly Nordigen).

Preparations

Gocardless Bank Account API (formerly Nordigen)

1. Check if your bank is supported by the API.
2. Create an account with Gocardless for the Bank Account Data API (They have a separate Login for it which you can get to by clicking on 'Get API Keys' or clicking the link at the bottom of their standard login page)
3. Go to Developers -> User Secrets and create a new pair of secret_id and secret_key

YNAB

1. Create a personal access token for YNAB as described here
2. Get your target budget & account IDs. You can find the IDs if you go to https://app.ynab.com/ and open the target account by clicking on the name on the left hand side menu. The URL does now contain both IDs https://app.ynab.com/<budget_id>/accounts/<account_id>

Usage

1. Install library from PyPI

pip install ynab-api-import

2. Initiate Library

from ynabapiimport import YnabApiImport
ynab_api_import = YnabApiImport(secret_id='<secret_id>', secret_key='<secret_key>', budget_id='<budget_id>', token='<token>')

Optionally you can initiate an object from a config.yaml file. To do that create a YAML file with the following content:

secret_id: <secret_id>
secret_key: <secret_key>
token: <ynab_token>
budget_id: <budget_id>

Save the file and provide the path to the library when initializing

ynab_api_import = YnabApiImport.from_yaml('path/to/config.yaml')

2. Find the institution_id of your bank

Countrycode is ISO 3166 two-character country code.

ynab_api_import.fetch_institutions(countrycode='<countrycode>')

You get back a dictionary with all available banks in that country and their institution_ids. Find and save the institution_id of your bank.

[{'name': '<name>', 'institution_id': '<institution_id>'}]

3. Create Auth Link and authenticate with your bank

Provide a unique reference (e.g. 'mycheckingaccount') per bank account to identify the grant later on.

ynab_api_import.create_auth_link(institution_id='<institution_id', reference='<reference>')

You get back a link which you need to copy to your browser and go through authentication flow with your bank

4. Run import with your reference and YNAB account_id

ynab_api_import.import_transactions(reference='<reference>', account_id='<account_id')

Development

Read the CONTRIBUTING.md file.