Welcome to release v2.0.0 of the Firefly III DataImporter. It contains the latest fixes, translations and features. Docker users can find this release under the latest tag.
Changelog
Version 2.0 of the Firefly III data importer introduces some big architectural changes that should make it easier to work with, and easier to extend.
Warning
This release introduces many new things, so there will be bugs. Some changes in this release may also unexpectedly lead to duplicate transactions. This is caused by changes in the data handling routines. This is unfortunate, but a result of new insights, changed APIs and other minor fixes. My apologies for any inconvenience. I try to avoid these kinds of changes, but it can't always be helped.
Added
- New import data provider "Sophtron". In the interest of full disclosure, they have sponsored me to add their API to the data importer. Their support (and yours!) allows me to spend more time on Firefly III and the data importer, and I'm very grateful for it.
- PR 1035 (Add support for CAMT.052) by @beatbesmer
- PR 1037 (Syntax error in debug logging) by @beatbesmer
Changed
- Import jobs are no longer managed using session data. This is a technical change, and it means that import jobs are easier to monitor, update and (in the future) can be re-run using new settings. This allows for a whole new range of flexibility.
- A lot of code has been rewritten to make it easier to manage an import job. Thanks to the previously mentioned changed, it is easier to switch back and forth between the necessary steps of an import job.
- A small API is now in place (with documentation to follow), that allows you to communicate with the data importer more easily. This will not be relevant for a lot of folks but the "auto import" and "auto upload" endpoints for example, will be documented just like the Firefly III API documentation.
Deprecated
- The "Spectre" import routine created and supported by Salt Edge, has been officially deprecated and can no longer be used.
Fixed
- Discussion 11162 (Importer account generation via account number) started by @ahmetpekbas
- Issue 11172 (Special characters not sorted correctly in account mapping) reported by @empeig
- Issue 11327 (SimpleFIN import fails with "Account mappings cannot be empty" even when "Map data: NO" is selected) reported by @metalchef1
- Issue 11377 (Importer ignores date option set in config file) reported by @rmu1987
Installation and upgrade instructions
- Please read the installation instructions for Docker, Portainer, Kubernetes or self-managed servers
- Or read the upgrade instructions for Docker, Kubernetes or self-managed servers
The releases are signed, and you can verify them using the Firefly III releases PGP key.
Develop with Firefly III
Are you interested in (future) API changes to Firefly III, or other interesting dev-related updates? Sign up to the Firefly III developer newsletter to receive low-frequency updates about the development of Firefly III.
Support Firefly III
Did you know you can support the development of Firefly III? You can donate in many ways, like GitHub Sponsors or Patreon. Please follow this link for more information. Thank you for your consideration.
