Icon of Firefly III Importer app on Umbrel App Store

Firefly III Importer

Import your transactions into Firefly III

Firefly III

Open App Store on your umbrelOS device to install this app
Screenshot 1 of Firefly III Importer app on Umbrel App Store
Screenshot 2 of Firefly III Importer app on Umbrel App Store
Screenshot 3 of Firefly III Importer app on Umbrel App Store
About this app

Firefly III is a manager for your personal finances. The data importer is built to help you import transactions into Firefly III. It is separated from Firefly III for security and maintenance reasons.

The data importer does not connect to your bank directly. Instead, it uses Nordigen and SaltEdge to connect to over 6000 banks worldwide. These services are free for Firefly III users, but require registration. Keep in mind these services have their own privacy and data usage policies.

The data importer can import CSV files you've downloaded from your bank.

You can run the data importer once, for a bulk import. You can also run it regularly to keep up with new transactions.

What's new
Version 1.9.1last week

Key highlights in this release include:

  • Added Lunch Flow support for importing transactions
  • Fixed handling of conflicting range options
  • Resolved issues with GoCardless API availability

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.9.0this month

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions due to changes in data handling routines.

Key highlights in this release include:

  • Added Lunch Flow support for importing transactions
  • Fixed handling of conflicting range options
  • Resolved issues with GoCardless API availability

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.8.4last month

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions due to changes in data handling routines.

Key highlights in this release include:

  • Updated Salt Edge API to use v6
  • Fixed decimal separator interpretation
  • Resolved issues with auto-import functionality

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.8.2last month

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions due to changes in data handling routines.

Key highlights in this release include:

  • Added JSON Schema validation for the configuration file
  • Improved GoCardless importer functionality
  • Fixed issues with restoring empty accounts array from configuration
  • Fixed an issue where CANNOT_PARSE_CONFIG was thrown on Importer-Image 1.8.0

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.8.0last month

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions due to changes in data handling routines.

Key highlights in this release include:

  • Added JSON Schema validation for the configuration file
  • Improved GoCardless importer functionality
  • Fixed issues with restoring empty accounts array from configuration

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.7.102 months ago

Key highlights in this release include:

  • Fixed issues with SimpleFIN imports
  • Improved handling of date ranges and pending transactions
  • Added support for bookingDateTime in Nordigen imports

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.7.93 months ago

Key highlights in this release include:

  • Added support for "OUT" as a debit indicator
  • Fixed an issue with importing from ING
  • Improved handling of SimpleFIN imports

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.7.83 months ago

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions. This is caused by changes in the data handling routines.

Key highlights in this release include:

  • Fixed SimpleFIN imports to respect datetime
  • Addressed SimpleFIN import issues
  • Prevented note on GoCardless imports with 0 exchange rate

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.7.64 months ago

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions. This is caused by changes in the data handling routines.

Key highlights in this release include:

  • Added logging of data importer version for better tracking
  • Improved handling of GoCardless Revolute currency exchange
  • Enhanced SimpleFIN imports with connection string saving
  • Fixed issues with zero transaction imports for SimpleFIN Bridge

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.7.04 months ago

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions. This is caused by changes in the data handling routines.

This release includes several key improvements:

  • Added support for SimpleFIN for connecting to financial institutions
  • Better authorization header checking for users with Basic Auth
  • Enhanced data handling routines with new insights and API changes

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.6.35 months ago

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions. This is caused by changes in the data handling routines.

This release includes several improvements and bug fixes:

  • Added debug logging for better troubleshooting
  • Enhanced GoCardless imports with support for tags from custom transaction fields
  • Improved handling of account numbers by removing spaces for easier matching
  • Fixed issues with reverse proxy support and X-Forwarded-Prefix header
  • Resolved problems with importing inverted transactions when account information is missing
  • Better token acquisition methods for authentication

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.6.26 months ago

This release includes improvements for auto-import functionality and various bug fixes.

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.6.18 months ago

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions due to changes in data handling routines.

This release contains bug fixes and improvements.

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.6.09 months ago

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions due to changes in data handling routines.

Key updates in this release:

  • Better rate limit reporting for Nordigen
  • Improved data caching for faster imports
  • Better exit codes
  • Support for PHP 8.4
  • Allow newlines in description

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.5.712 months ago

This update includes several improvements and fixes:

  • Better handling and error catching for GoCardless rate limits
  • Added support for DB as Debit indicator
  • Improved handling when no transactions are found
  • Fixed issues with transaction imports and CSV line matching
  • Better error messages for expired GoCardless EUA
  • Default transaction imports without year now use current year

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.5.6last year

This update includes improvements to GoCardless rate limiting handling and reporting.

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.5.5last year

This update includes improvements to GoCardless rate limiting reporting and fixes an issue with account details import.

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.5.4last year

This minor update implements proper rate limiting for GoCardless.

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.5.3last year

This update includes several bug fixes and improvements:

  • Support for another bank's debit indicator.
  • Fixed case-sensitive matching on bank debit indicator.
  • Improved handling of account mapping for automated imports.
  • Fixed minor issue in AutoImport.php related to 'bad path' error.

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Version 1.4.4last year

⚠️ Some changes in this release may unexpectedly lead to duplicate transactions.

Full release notes can be found at https://github.com/firefly-iii/data-importer/releases

Information