Import your ING Germany bank statements via FinTS into YNAB.
Before setting this up, please
register your FinTS product
– it's free and takes only a few days.
If you don't do this, the application will fallback to the product id from the
python-fints library, which should only
be used for evaluation.
Since this application will need your ING pin and YNAB access token it's recommended to run this in your local network (could be a Raspberry Pi, it's pretty light).
The application writes the last date and a hash of the last imported transaction
to a state
file. If you use it in a container be sure to mount it to
prevent duplicates.
There are various ways to start the application:
This can be run on any environment with Python 3.8 or higher.
$ python3 -m pip install ing-ynab
$ touch .env # see configuration section
$ ing-ynab
$ cp .env.example .env # and customize fields
$ docker run \
-v $PWD/ing_ynab_state:/app/state \
--env-file .env \
docker.pkg.github.com/bahlo/ing-ynab/ing-ynab:1.1.1
version: "2.0"
services:
ing-ynab:
image: docker.pkg.github.com/bahlo/ing-ynab/ing-ynab:1.1.1
volumes:
- ${PWD}/ing_ynab_state:/app/state
environment:
# Environment variables, see the configuration section
The configuration is done via environment variables:
START_DATE
: The date to start getting transactions (defaults to today).SLEEP_INTERVAL
: Interval in seconds until the next check happens (defaults to 5 minutes).FINTS_PRODUCT_ID
: Your FinTS product ID (deafults to python-fints one).ING_LOGIN
: The login id of your ING account.ING_IBAN
: The IBAN of the account you want to add.ING_PIN
: The pin of your ING account (leave empty to be prompted).YNAB_ACCESS_TOKEN
: Go to your budget settings to create one (leave empty to be prompted).YNAB_BUDGET_ID
: On the webpage of your budget the last number in the path.YNAB_ACCOUNT_ID
: On the webpage of the account the last uuid in the path.YNAB_FLAG_COLOR
: If set, use that color for the imported transactions.DEBUG
: Set to1
to enable debug output and print transactions instead of importing them.
You can pass in your bank pin and YNAB access token via environment variables, if you like. This has the drawback that anyone with system access can read and potentially use them so it's discouraged (but supported).
The alternative is not specifying YNAB_ACCESS_TOKEN
and/or ING_PIN
, which
will cause the application to prompt you on startup. This has the drawback that
you need to input them everytime the application restarts.
For docker you'll need to pass the -it
flags to be able to input these
variables. For docker-compose, add these fields:
tty: true
stdin_open: true
After starting with docker-compose up -d
, run docker attach $container_id
to attach to the container. Note that the prompt for the pin might be hidden,
so you have to enter the pin directly.
It is, but the implementations differ a lot. This actually started out as a general-purpose library but I can only really test ING and I rather have a specialised library than a multipurpose one where I can't guarantee functionality.