aengl/cocoon-ynab

Import bank statements into YNAB using Cocoon. 🏦🐛

cocoon-ynab

This project uses Cocoon to create a visual environment for importing bank statements from N26 to YNAB, though it can be easily adjusted to import from other banks as well.

Installation

Requires Node.js >= 12 and Python >= 3.6.

Recommended: yarn

yarn install
pip3 install n26
cp n26.yml.example n26.yml

Then open the n26.yml and fill in the blanks. It contains more than just the configuration for N26, but python-n26 requires the file to have that name.

Usage

Start the editor using:

yarn editor

If you configured everything correctly, run all the nodes and open the view for the transaction node. Then, have fun approving transactions!

If you have no idea how the editor works, please consult the Cocoon demos for an in-depth explanation.

cocoon-ynab's Issues

First run of the app errors out

The first time you run the app, the Annotate node will error out (probably because the ./transactions.json file doesn't exist yet).

At this point the transactions.json file gets created, and if I run the Annotate node again, it's going to work without issues

Authentication to N26 fails

When trying to run the N26 node, I'm getting error 403 (Forbidden)

When looking at the console I see message:

"{"userMessage":{"title":"A second authentication factor is required.","detail":"Please provide your second form of authentication."},"mfaToken":"672f4dec-48ce-43da-872d-1b26510feae8","error_description":"MFA token is required","detail":"MFA token is required","hostUrl":"https://api.tech26.de","type":"mfa_required","error":"mfa_required","title":"A second authentication factor is required.","message":"Please provide your second form of authentication.","userId":"da02a73a-8608-45b5-b3f6-dd0cb83c3a15","status":403}"

Improvements for the Read N26 node

1. Show message that you need to confirm the login

The first time the node is run, you need to confirm your login in the app. While the app is waiting I think we should show a message: Confirm your login on your N26-paired device

It's pretty hard to figure out what's going on if you don't already expect it. Even I tend to forget about it, and I use the script for all my budgeting.

2. When you approve the login, you get error:

Unexpected token in JSON at position 0

If you try running the ReadN26 node again, it works. Whatever N26 responds with the first time, is not a JSON and it can't be parsed.