Firefly III Nordigen importer

A tool to import Nordigen connected banks Firefly III
Explore the docs »

View Firefly III demo · Report Bug · Request Feature

• About the Firefly III Nordigen importer
  • Purpose
  • Features
  • Who's it for?
• Getting Started
  • Using the web interface
  • Using the command line
  • Using the auto-import
• Known import challenges
• Other stuff
• Need help?
  • Contribute
  • Donate
  • License
  • Contact

About the Firefly III Nordigen importer

Welcome! You found the Nordigen importer, a tool to import transactions from banks that are supported by Nordigen, into Firefly III. The name kind of gave it away, didn't it?

This tool is built and designed to make it easy to import data into your Firefly III installation. It uses the official Nordigen API's and optionally, a config file to make everything go smooth.

Purpose

Use this tool to (automatically) import your transactions into Firefly III. If you're a bit of a developer, feel free to use this code to generate your own import tool.

Features

• This tool will let you download or generate a configuration file, so the next import will go faster.
• It will not import duplicate transactions.
• It can recognize all currencies, transaction types and other things that Firefly III supports.

Who's it for?

Anybody who uses Firefly III and wants to automatically import transactions. Your bank must be supported by Nordigen.

Getting Started

You can use this tool in several ways.

1. Install it on your server using composer.
2. Use the Docker-image.

Generally speaking, it's easiest to use and install this tool the same way as you use Firefly III. And although it features an excellent web-interface, you can also use the command line to import your data.

There are upgrade instructions for both methods of installation.

The full usage instructions can be found in the documentation. Basically, this is the workflow:

Using the web interface

1. Register with Nordigen.
2. Set up and configure the importer.
3. Map values from your transactions to existing values in your database.
4. Enjoy the result in Firefly III.

Using the command line

1. Register with Nordigen.
2. Set up and configure the importer.
3. Follow the command line instructions

Using the auto-import

1. Import at least once, so you'll have a configuration file (see above).
2. Run the Docker inline import command

Other stuff

Need help?

If you need support using Firefly III or the associated tools, come find us!

• GitHub Discussions for questions and support
• Gitter.im for a good chat and a quick answer
• GitHub Issues for bugs and issues
• Follow me around for news and updates on Twitter

Contribute

There are contributing guidelines and a code of conduct, which I invite you to check out.

For all other contributions, see below.

Donate

If you feel Firefly III made your life better, consider contributing as a sponsor. Please check out my Patreon and GitHub Sponsors page for more information. Thank you for considering.

License

This work is licensed under the GNU Affero General Public License v3.

Contact

You can contact me at [email protected], you may open an issue in the main repository or contact me through the various social media pages there are: gitter and Twitter.