Firefly III Importer
Import your transactions into Firefly III
Firefly III



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.
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
⚠️ 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
⚠️ 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
⚠️ 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
⚠️ 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
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
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
⚠️ 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
⚠️ 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
⚠️ 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
⚠️ 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
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
⚠️ 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
⚠️ 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
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
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
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
This minor update implements proper rate limiting for GoCardless.
Full release notes can be found at https://github.com/firefly-iii/data-importer/releases
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
⚠️ 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
