Skip to content

Frequently Asked Questions

Questions about the Firefly III Data Importer (FIDI).


If you are experiencing issues, please read frequently seen errors.

Can the data importer sync with my bank?

Yes. The data importer uses Spectre and Nordigen to connect to over 6000 banks. Please see the configuration page for more details and read up on Nordigen and Salt Edge / Spectre.

There is also a Firefly III API that you can connect to [YOUR BANK HERE], if you are clever enough to build something in your favorite programming language.

Can you clean-up the transactions from [my bank]?

If your bank delivers terrible CSV files, or when the Nordigen / Salt Edge import is exceptionally messy, there is nothing I can do about it.

There are simply too many banks and financial institutions in the world for me to manage exceptions or options for. If you run into a data quality issue, the best place to get it addressed is at the source: your bank.

I want to auto-import transactions from [my bank] out of the box!

You can use the command line or the POST command to automate your import.

How do I handle custom SSL certificates?

If you run your own CA, check out the options in the .env.example file.

How do I start over or reset the importer?

Browse to the /flush-URL on the data importer to reset it. There is also a button you can use on every page.

Why can't I import duplicate transactions?

The Firefly III data importer can recognise two different types of duplicate transactions. By default, it will refuse to import both of these types.

  1. Duplicate lines in your CSV files are skipped, unless you explicitly tell the data importer to import them anyway.
  2. Firefly III itself will refuse to import transactions it believes already exist. You can overrule this.

Even when you delete the original transaction, importing it again will result in a duplication error. This is because many CSV files come with dummy lines, and it's very annoying to have to keep deleting those.

If you want to reimport duplicate transactions after deleting them, turn off duplicate detection or delete them from the database by hand. Firefly III v5.8.0 has a "purge"-button on your profile page that allows you to permanently remove duplicated transactions.

Why isn't the data importer built into Firefly III?

I turned the data importer into a separate tool. It allows me to keep track of two different tools with different development requirements.

Why isn't this a plugin, like WordPress?

It adds a whole layer of complexities to Firefly III. A plugin needs a framework to land in. For the data importer to be a plugin, I would first have to build it so Firefly III supports plugins. And then the data importer would be the only plugin.

The API is a plugin system of sorts.

How can I automate this?

The easiest way to automate imports is by using the command line option to automatically import files.

Last update: 2023-01-29