# Change Log
All notable changes to this project will be documented in this file.
This project adheres to [Semantic Versioning](http://semver.org/).

## v2.3.4 - 2026-06-30

<!-- summary: This release fixes a crash in the Soptron import routine. -->

### Fixed
- [Issue 12413](https://github.com/firefly-iii/firefly-iii/issues/12413) (Sophtron import has the wrong class visibility for a property, crashing the data importer) reported by @Apadgett879

## v2.3.3 - 2026-06-28

> [!WARNING]
> Some changes in this release may 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.

<!-- summary: This release fixes a variety of bugs and updates a lot of used packages. -->

### Fixed
- [Discussion 11891](https://github.com/orgs/firefly-iii/discussions/11891) (Enable Banking use of environment variables) started by @Ilpredatore
- [Discussion 11928](https://github.com/orgs/firefly-iii/discussions/11928) (Import transaction with destination account type "liability") started by @zearan
- [Issue 12168](https://github.com/firefly-iii/firefly-iii/issues/12168) (Error in Data Importer: `$importJob` must not be accessed before initialization) reported by @Kaysera
- [Issue 12250](https://github.com/firefly-iii/firefly-iii/issues/12250) (.env.example needs a fix for oauth access token generation location) reported by @cloudboundboris
- [Discussion 12279](https://github.com/orgs/firefly-iii/discussions/12279) (Question / Tips wanted: Handling strict bank rate limits (PSU-IP-Address) during autoimport) started by @torsteinelv
- [Issue 12374](https://github.com/firefly-iii/firefly-iii/issues/12374) (Fix OAuth creation link in Importer) reported by @RustyPotato
- Fix "class visibility" which broke some imports.

## v2.3.2 - 2026-04-20

> [!WARNING]
> Some changes in this release may 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.

<!-- summary: This release supports UUID access tokens and fixes several issues. -->

### Added
- Support for new UUID access tokens as used and generated by Firefly III v6.6.0 and later.

### Fixed
- [Issue 12093](https://github.com/firefly-iii/firefly-iii/issues/12093) (EnableBanking: duplicate detection fails due to session-scoped accountUid in external_id) reported by @dominikheiss
- [Issue 12094](https://github.com/firefly-iii/firefly-iii/issues/12094) (GoCardless import with expired EUA does not send error notification/report email) reported by @Jazzmax
- [Discussion 12100](https://github.com/orgs/firefly-iii/discussions/12100) (Enable Banking Importer - Issue when you specify dates to Import) started by @ZeluisFS
- [Issue 12102](https://github.com/firefly-iii/firefly-iii/issues/12102) (Error "Cannot modify header information" in /autoupload endpoint) reported by @MagelanM
- [Issue 12128](https://github.com/firefly-iii/firefly-iii/issues/12128) (SimpleFIN date range options exceed 90 days but backend makes a single unchunked API call) reported by @CodeBradley
- [Discussion 12158](https://github.com/orgs/firefly-iii/discussions/12158) (Importer oAuth Issue) started by @danielpngr

## v2.3.1 - 2026-04-20

> [!WARNING]
> Some changes in this release may 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.

<!-- summary: This release supports UUID access tokens and fixes several issues. -->

### Added
- Support for new UUID access tokens as used and generated by Firefly III v6.6.0 and later.

### Fixed
- [Issue 12093](https://github.com/firefly-iii/firefly-iii/issues/12093) (EnableBanking: duplicate detection fails due to session-scoped accountUid in external_id) reported by @dominikheiss
- [Issue 12094](https://github.com/firefly-iii/firefly-iii/issues/12094) (GoCardless import with expired EUA does not send error notification/report email) reported by @Jazzmax
- [Discussion 12100](https://github.com/orgs/firefly-iii/discussions/12100) (Enable Banking Importer - Issue when you specify dates to Import) started by @ZeluisFS
- [Issue 12102](https://github.com/firefly-iii/firefly-iii/issues/12102) (Error "Cannot modify header information" in /autoupload endpoint) reported by @MagelanM
- [Issue 12128](https://github.com/firefly-iii/firefly-iii/issues/12128) (SimpleFIN date range options exceed 90 days but backend makes a single unchunked API call) reported by @CodeBradley
- [Discussion 12158](https://github.com/orgs/firefly-iii/discussions/12158) (Importer oAuth Issue) started by @danielpngr

## v2.3.0 - 2026-04-20

> [!WARNING]
> Some changes in this release may 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.

<!-- summary: This release supports UUID access tokens and fixes several issues. -->

### Added
- Support for new UUID access tokens as used and generated by Firefly III v6.6.0 and later.

### Fixed
- [Issue 12093](https://github.com/firefly-iii/firefly-iii/issues/12093) (EnableBanking: duplicate detection fails due to session-scoped accountUid in external_id) reported by @dominikheiss
- [Issue 12094](https://github.com/firefly-iii/firefly-iii/issues/12094) (GoCardless import with expired EUA does not send error notification/report email) reported by @Jazzmax
- [Discussion 12100](https://github.com/orgs/firefly-iii/discussions/12100) (Enable Banking Importer - Issue when you specify dates to Import) started by @ZeluisFS
- [Issue 12102](https://github.com/firefly-iii/firefly-iii/issues/12102) (Error "Cannot modify header information" in /autoupload endpoint) reported by @MagelanM
- [Issue 12128](https://github.com/firefly-iii/firefly-iii/issues/12128) (SimpleFIN date range options exceed 90 days but backend makes a single unchunked API call) reported by @CodeBradley

## v2.2.3 - 2026-04-07

> [!WARNING]
> Some changes in this release may 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.

### Fixed
- [Issue 12041](https://github.com/firefly-iii/firefly-iii/issues/12041) (ignore_duplicate_transactions is not taken into account) reported by @Passific
- [Issue 12073](https://github.com/firefly-iii/firefly-iii/issues/12073) (Clarify `_FILE` is already supported for `MAIL_DESTINATION` in importer.env) reported by @elp3dr0
- [Issue 12093](https://github.com/firefly-iii/firefly-iii/issues/12093) (EnableBanking: duplicate detection fails due to session-scoped accountUid in external_id) reported by @dominikheiss

## v2.2.2 - 2026-03-28

> [!WARNING]
> Some changes in this release may 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.

<!-- summary: This releases improves Enable Banking imports and fixes a CAMT import issue. -->

### Removed
- Removed all instances of `isset`
- Removed old Spectre code

### Changed
- Can now add Enable Banking private key as raw PEM string.

### Fixed
- [Issue 11917](https://github.com/firefly-iii/firefly-iii/issues/11917) (Enable Banking continuation key not used) reported by @victor-amblard
- [Issue 11923](https://github.com/firefly-iii/firefly-iii/issues/11923) (Positive transactions in CAMT files fail to import) reported by @rmu1987
- [Issue 11924](https://github.com/firefly-iii/firefly-iii/issues/11924) ("Missing array offset", broken auto-import when using import configuration with no `flow` key) reported by @Unsantae
- [Issue 11925](https://github.com/firefly-iii/firefly-iii/issues/11925) (Enable Banking does not find duplicate transactions when changing status) reported by @rigibe
- [Issue 11932](https://github.com/firefly-iii/firefly-iii/issues/11932) (ignore_duplicate_transactions field is not updated in the import_config.json) reported by @Passific
- [Discussion 11959](https://github.com/orgs/firefly-iii/discussions/11959) ([Importer] SimpleFIN uses “posted_at” instead of “transacted_at” field for Transaction Date) started by @Siddhant-k
- Fix a missing JS variable

## v2.2.1 - 2026-03-10

<!-- summary: This release fixes the auto-import feature and expands Enable Banking support. -->

### Added
- [Issue 11884](https://github.com/firefly-iii/firefly-iii/issues/11884) (Add BBAN to Enable Banking imports for better transfer matching) reported by @zorknemsis

### Fixed
- [Issue 11906](https://github.com/firefly-iii/firefly-iii/issues/11906) (`AUTO_IMPORT_SECRET` is not validated correctly) reported by @ict
- Fix various code quality issues.

## v2.2.0 - 2026-03-06

> [!IMPORTANT]  
> This release is the same as 2.1.1, but only works on PHP 8.5 and higher. To continue using the latest version of the data importer, you must upgrade to (at least) PHP 8.5.0, or switch to the Docker containers.

### Fixed
- [Issue 11775](https://github.com/firefly-iii/firefly-iii/issues/11775) (Data-importer 2.1.1 CAMT: Exception occurs parsing amount) reported by @lindely
- [Issue 11777](https://github.com/firefly-iii/firefly-iii/issues/11777) (Fix for issue 11775 not working) reported by @lindely
- [Issue 11783](https://github.com/firefly-iii/firefly-iii/issues/11783) (Firefly importer: Map income / transfer) reported by @Kiekeboe100

### Security
- Some AI bot found a mild security issue in SimpleFIN token parsing, so I fixed that.  

## v2.1.1 - 2026-02-21

> [!WARNING]
> If no pressing issues get reported, this release will be followed by **v2.2.0**. It will be exactly the same but require PHP 8.5.

### Fixed
- [Issue 11753](https://github.com/firefly-iii/firefly-iii/issues/11753) (Enable Banking importer doesn't work when re-using a config json) reported by @icewind1991

## v2.1.0 - 2026-02-01

### Added
- GitHub user @barreeeiroo built support for [Enable Banking](https://enablebanking.com/). Read more about it in the [documentation](https://docs.firefly-iii.org/tutorials/data-importer/eb/).
- Support for batch submissions
- [Issue 10753](https://github.com/firefly-iii/firefly-iii/issues/10753) (Add Enable Banking to Data Importer as alternative to GoCardless) reported by @Madnex

### Fixed
- Default currency validation for SimpleFIN
- [Issue 11539](https://github.com/firefly-iii/firefly-iii/issues/11539) (Importing camt.053 file fails if amount is 0.0) reported by @j-palms
- [Issue 11577](https://github.com/firefly-iii/firefly-iii/issues/11577) (Two notification emails after import) reported by @ragnarkarlsson
- [Issue 11600](https://github.com/firefly-iii/firefly-iii/issues/11600) ([Importer] GoCardless import skips manual mapping step) reported by @avee87
- [Issue 11687](https://github.com/firefly-iii/firefly-iii/issues/11687) (SimpleFIN import fails for liability accounts (mortgage/loan/debt)) reported by @demahaffey
- [Issue 11693](https://github.com/firefly-iii/firefly-iii/issues/11693) (EmptyAccounts task fails to set "(no name)" for withdrawals with empty destination) reported by @sqelirus

## v2.0.5 - 2026-01-17

> [!WARNING]
> This will be one of the last Firefly III data importer releases that supports PHP 8.4. 

### Fixed
- [Issue 11504](https://github.com/firefly-iii/firefly-iii/issues/11504) (Date conversion error when importing a range from SimpleFIN) reported by @anarion80
- [Issue 11521](https://github.com/firefly-iii/firefly-iii/issues/11521) (Importer CAMT file import fails server error 500) reported by @rmu1987
- [Issue 11523](https://github.com/firefly-iii/firefly-iii/issues/11523) (Importer no longer outputs progress updates for submission) reported by @grgar
- [Issue 11525](https://github.com/firefly-iii/firefly-iii/issues/11525) (SimpleFIN cannot convert account types and fails to import) reported by @tmkowalewski

## v2.0.4 - 2026-01-11

This release fixes some issues left in v2.0.0.

### Fixed
- [PR 1107](https://github.com/firefly-iii/data-importer/pull/1107) (Fix config key inconsistency in MapController) created by @egyptianbman

## v2.0.3 - 2026-01-10

This release fixes some issues left in v2.0.0.

### Fixed

- Various issues reported in the [gitter.im](https://gitter.im/firefly-iii/firefly-iii)-chat room, thank you!
- Various issues reported over mail, thanks!
- [Issue 11485](https://github.com/firefly-iii/firefly-iii/issues/11485) (Importer doesn't skip mapping, fails to find accounts when using SimpleFIN) reported by @Kage1
- [Issue 11486](https://github.com/firefly-iii/firefly-iii/issues/11486) (Importer fails non-gracefully with expired GoCardless requisition) reported by @molnarti
- [Issue 11487](https://github.com/firefly-iii/firefly-iii/issues/11487) (Initial SimpleFIN import fails during data conversion with "Cannot access private property...") reported by @tmkowalewski
- [Issue 11491](https://github.com/firefly-iii/firefly-iii/issues/11491) (Importer redirects without starting job when "skip configuration" is true) reported by @danielpngr

## v2.0.2 - 2026-01-09

This release fixes some issues left in v2.0.0 and a regression bug I introduced in v2.0.1.

### Fixed
- [Issue 11482](https://github.com/firefly-iii/firefly-iii/issues/11482) (Data importer loops from Convert -> Map -> Convert when importing from external providers) reported by @avee87

## v2.0.1 - 2026-01-09

This release fixes some issues left in v2.0.0.

### Fixed
- Various code related bugs not reported as an issue.
- Various issues reported in our Gitter.im chatroom, thank you!
- [Issue 11459](https://github.com/firefly-iii/firefly-iii/issues/11459) (CVS data conversion crashes on missing field in conversion routine code) reported by @Sycoraxya
- [Issue 11460](https://github.com/firefly-iii/firefly-iii/issues/11460) (Importer does not create transactions with foreign_amount and foreign_currency_code from CAMT imports) reported by @vizzerdrix55
- [Issue 11470](https://github.com/firefly-iii/firefly-iii/issues/11470) (Non UTF-8 files cannot be handled as file uploads) reported by @andyesten
- [Issue 11477](https://github.com/firefly-iii/firefly-iii/issues/11477) (Old redirect URL is not properly handled during data conversion) reported by @avee87

## v2.0.0 - 2026-01-05

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](https://sophtron.com/index)". In the interest of full disclosure, they have sponsored me to add their API to the data importer. [Their support (and yours!)](https://docs.firefly-iii.org/explanation/more-information/donations/) allows me to spend more time on Firefly III and the data importer, and I'm very grateful for it.
- [PR 1035](https://github.com/firefly-iii/data-importer/pull/1035) (Add support for CAMT.052)  by @beatbesmer
- [PR 1037](https://github.com/firefly-iii/data-importer/pull/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](https://api-docs.firefly-iii.org/).

### Deprecated
- The "Spectre" import routine created and supported by Salt Edge, has been officially deprecated and can no longer be used.

### Fixed
- [Discussion 11162](https://github.com/orgs/firefly-iii/discussions/11162) (Importer account generation via account number) started by @ahmetpekbas
- [Issue 11172](https://github.com/firefly-iii/firefly-iii/issues/11172) (Special characters not sorted correctly in account mapping) reported by @empeig
- [Issue 11327](https://github.com/firefly-iii/firefly-iii/issues/11327) (SimpleFIN import fails with "Account mappings cannot be empty" even when "Map data: NO" is selected) reported by @metalchef1
- [Issue 11377](https://github.com/firefly-iii/firefly-iii/issues/11377) (Importer ignores date option set in config file) reported by @rmu1987

## v1.9.2 - 2025-11-08

### Added
- Support for composite transaction identifiers, by @pingu8007
- Support for camt.052, by @beatbesmer

### Fixed
- [Discussion 11162](https://github.com/orgs/firefly-iii/discussions/11162) (Importer account generation via account number) started by @ahmetpekbas
- [Issue 11172](https://github.com/firefly-iii/firefly-iii/issues/11172) (Special characters not sorted correctly in account mapping) reported by @empeig

## v1.9.1 - 2025-11-02

### Fixed

- [Issue 11090](https://github.com/firefly-iii/firefly-iii/issues/11090) (Importer - Getting error "..redirected you too many times") reported by @hiyan
- [Issue 11100](https://github.com/firefly-iii/firefly-iii/issues/11100) (Camt 052.001.08 xml import error) reported by @bestlinuxgamers
- [Issue 11151](https://github.com/firefly-iii/firefly-iii/issues/11151) (Submitting import before /import/check-duplicate returns breaks importer) reported by @grgar
- [Issue 11118](https://github.com/firefly-iii/firefly-iii/issues/11118) (Camt importer ignoring config role definitions) reported by @bestlinuxgamers

## v1.9.0 - 2025-10-19

> [!NOTE]
> Lunch Flow support is new to the Data Importer. Please read the [tutorial](https://docs.firefly-iii.org/tutorials/data-importer/lunchflow/) carefully. Feel free to open an issue or start a discussion if you have issues. Thanks in advance for your support!

### Added
- [Issue 10849](https://github.com/firefly-iii/firefly-iii/issues/10849) (Integrate Lunch Flow with the data importer) reported by @JC5
- Lunch Flow support was also brought to you by @amrawadk

### Fixed
- [Issue 11075](https://github.com/firefly-iii/firefly-iii/issues/11075) (Importer handling of conflicting range options) reported by @molnarti
- [Issue 11070](https://github.com/firefly-iii/firefly-iii/issues/11070) (GoCardless API no longer available) reported by @jgelon

## v1.8.4 - 2025-10-14

### Fixed

- [Issue 11061](https://github.com/firefly-iii/firefly-iii/issues/11061) (Importing using `importer:auto-import` results in error "foreach() argument must be of type array|object, string given") reported by @jurgenhaas

## v1.8.3 - 2025-10-13

### Added
- [Issue 11032](https://github.com/firefly-iii/firefly-iii/issues/11032) (Data importer interprets decimal separator as thousands separator) reported by @beatbesmer
- Update Salt Edge API to use v6 by @bedesv

### Fixed
- [Issue 11000](https://github.com/firefly-iii/firefly-iii/issues/11000) (fontawesome v7 not compatible with current app.scss) reported by @Linguardium
- [Discussion 11001](https://github.com/orgs/firefly-iii/discussions/11001) (Venmo Transactions not working with Simplefin) started by @fighterjetj
- [Issue 11040](https://github.com/firefly-iii/firefly-iii/issues/11040) (AutoImport triggered by POST only imports last file) reported by @beatbesmer 
- Fixed fonts in build, by @Linguardium

## v1.8.2 - 2025-10-02

### Fixed
- [Issue 10983](https://github.com/firefly-iii/firefly-iii/issues/10983) (CANNOT_PARSE_CONFIG thrown on Importer-Image 1.8.0) reported by @beatbesmer

## v1.8.1 - 2025-10-01

### Added
- [Issue 6061](https://github.com/firefly-iii/firefly-iii/issues/6061) (Set import daterange on both ends) reported by @JC5

### Changed
- [Discussion 10947](https://github.com/orgs/firefly-iii/discussions/10947) (Shouldn't GoCardless import ignore pending transactions?) started by @molnarti

### Removed
- Add message about future removal of Spectre / Salt Edge.

## v1.8.0 - 2025-09-20

> [!WARNING]
> Some changes in this release may 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
- [Issue 9045](https://github.com/firefly-iii/firefly-iii/issues/9045) (Data Importer - Add config filename or bank name into end-of-import email) reported by @Terry-JF
- [Issue 10923](https://github.com/firefly-iii/firefly-iii/issues/10923) ([Importer] CSV import broken in cli image (does not adhere to the v3 schema)) reported by @MacPaille
- JSON Schema validation for the configuration file.

### Changed
- [Issue 10863](https://github.com/firefly-iii/firefly-iii/issues/10863) (Data Importer: GoCardless: option to use internalTransactionId instead) reported by @diogotcorreia
- [Issue 10914](https://github.com/firefly-iii/firefly-iii/issues/10914) (GoCardless importer: external_id dedupe should be per account) reported by @Jazzmax

### Fixed
- Fix issue with restoring empty `accounts` array from configuration.

## v1.7.10 - 2025-08-23

### Deprecated
- Support for Firefly III < v6.3.2

### Fixed
- [Issue 10699](https://github.com/firefly-iii/firefly-iii/issues/10699) ([Importer] SimpleFIN error - create flag must be set for new account creation with de-selected accounts) reported by @Siddhant-k
- [Issue 10805](https://github.com/firefly-iii/firefly-iii/issues/10805) (Importer: Importer loops when there are no tractions to import from SimpleFin) reported by @Kage1
- Eternal loop in UI, reported by @Kage1
- Date range can be selected out of order, breaking the import, reported by @Kage1
- Selecting transactions from a single day doesn't work, reported by @Kage1
- Loop back to role selection has the wrong label, reported by @Kage1
- Pending transactions were always imported, reported by @Kage1

## v1.7.9 - 2025-07-31

### Added
- [PR 917](https://github.com/firefly-iii/data-importer/pull/917) (Add OUT as debit indicator) by @icewind1991

### Fixed
- [Issue 10643](https://github.com/firefly-iii/firefly-iii/issues/10643) (Importer failing on an import of ING) reported by @MTijn

## v1.7.8 - 2025-07-20

>  ⚠️ Some changes in this release may 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.

### Fixed
- [Issue 10602](https://github.com/firefly-iii/firefly-iii/issues/10602) ([Importer] SimpleFIN import does not respect datetime) reported by @wyomatthew
- [Discussion 10599](https://github.com/orgs/firefly-iii/discussions/10599) (Issue with simpleFIN importing) started by @DrEthan77
- [Issue 10609](https://github.com/firefly-iii/firefly-iii/issues/10609) (GoCardless imports with exchange rate 0 should not add note to transaction) reported by @TomVarga
- [PR 901](https://github.com/firefly-iii/data-importer/pull/901) by @TomVarga for issue 10609
- [PR 905](https://github.com/firefly-iii/data-importer/pull/905) by @DrEthan77 (This PR fixes issue 10599)

## v1.7.7 - 2025-07-16

### Changed
- Various SimpleFIN optimizations, drops the "CORS URL" from the required fields.

### Fixed
- [Discussion 10599](https://github.com/orgs/firefly-iii/discussions/10599) (Issue with simpleFIN importing) started by @DrEthan77

## v1.7.6 - 2025-07-15

>  ⚠️ Some changes in this release may 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
- Log entries will occasionally include the data importer version, so that you can see which version was used to import data.
- [Issue 8296](https://github.com/firefly-iii/firefly-iii/issues/8296) (GoCardless Revolute currency exchange) reported by @TomVarga

### Changed
- [Issue 10556](https://github.com/firefly-iii/firefly-iii/issues/10556) (Save the connection string for subsequent SimpleFIN imports) reported by @Gsyltc

### Fixed
- [Issue 10590](https://github.com/firefly-iii/firefly-iii/issues/10590) ([Importer] SimpleFIN Bridge fails on zero transaction imports) reported by @wyomatthew
- [Issue 10556](https://github.com/firefly-iii/firefly-iii/issues/10556) (Save the connection string for subsequent SimpleFIN imports) reported by @Gsyltc
- [Issue 10580](https://github.com/firefly-iii/firefly-iii/issues/10580) ([Importer] GoCardless account matching UI is broken in dark mode) reported by @avee87
- [PR 882](https://github.com/firefly-iii/data-importer/pull/882) (This PR fixes issue 8296) by @TomVarga

## v1.7.5 - 2025-07-06

### Fixed
- Improved duplicate detection for SimpleFIN imports.

## v1.7.4 - 2025-07-06

### Fixed
- [Issue 10550](https://github.com/firefly-iii/firefly-iii/issues/10550) ([Importer] Issues with SimpleFIN Import) reported by @PacketThrowr
- [Issue 10556](https://github.com/firefly-iii/firefly-iii/issues/10556) (Save the connection string for subsequent SimpleFIN imports) reported by @Gsyltc
- [Issue 10541](https://github.com/firefly-iii/firefly-iii/issues/10541) (Type error in str_replace function, breaks GoCardless import during configuration) reported by @alexmaisel

## v1.7.3 - 2025-07-04

### Fixed
- Restore duplicate detection options
- SimpleFIN import will not always try to create accounts

## v1.7.2 - 2025-07-03

### Fixed
- [Issue 10541](https://github.com/firefly-iii/firefly-iii/issues/10541) (Type error in str_replace function, breaks GoCardless import during configuration) reported by @alexmaisel

## v1.7.1 - 2025-07-02

>  ⚠️ Some changes in this release may 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.

### Changed
- For GoCardless imports: opposing account names and other reference data is no longer added as tags, but as text in the notes. This may lead to duplicates.
- GoCardless: better handling of rate limits.

### Fixed
- [Issue 10508](https://github.com/firefly-iii/firefly-iii/issues/10508) (Firefly Version 1.7.0 uses SimpleFIN for GoCardless and crashes when importing) reported by @L3tum
- Improved parsing of dates.

## v1.7.0 - 2025-06-26

### Added
- Support for SimpleFIN, developed by user 'skell'

### Fixed
- Better check on Authorization header for users who use Basic Auth.
- [Issue 5396](https://github.com/firefly-iii/firefly-iii/issues/5396) (Data importer: SimpleFIN) reported by @marcusds, with special thanks again to skell, and all the beta testers who helped out!

## v1.6.3 - 2025-06-08

>  ⚠️ Some changes in this release may 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
- Add some more debug logging.
- [Issue 8994](https://github.com/firefly-iii/firefly-iii/issues/8994) (Creditor Reference Information) reported by @fschirinzi
- [Issue 9533](https://github.com/firefly-iii/firefly-iii/issues/9533) (Extension of GoCardess imports with tags from custom transaction fields) reported by @kondas

### Changed
- Data Importer generated transaction IDs are prefixed with `ff3-`.
- Account numbers have their spaces removed, for easier matching in Firefly III.

### Fixed
- [Discussion 10162](https://github.com/orgs/firefly-iii/discussions/10162) (Reverse proxy and `X-Forwarded-Prefix` header) started by @frenchu
- [Issue 10387](https://github.com/firefly-iii/firefly-iii/issues/10387) (Failing to import inverted transactions when there is no account name and the account number does not exist) reported by @oddstr13
- [PR 802](https://github.com/firefly-iii/data-importer/pull/802) Ensure all token acquisition methods are the same by @grgar
- [PR 803](https://github.com/firefly-iii/data-importer/pull/803) Ignore exception opening counter-main.txt by @grgar
- [PR 814](https://github.com/firefly-iii/data-importer/pull/814) Consider account number uniquely identifying by @oddstr13

## v1.6.2 - 2025-04-21

### Added
- [PR 782](https://github.com/firefly-iii/data-importer/pull/782) Auto import: Honor JSON_CONFIGURATION_DIR by @yparitcher

### Fixed

- [Issue 9980](https://github.com/firefly-iii/firefly-iii/issues/9980) (Firefly FIDI incorrect exit code when errors received) reported by @miguelangel-nubla
- [Issue 10099](https://github.com/firefly-iii/firefly-iii/issues/10099) (Data Importer loses Secrets from Variables after clicking "Start over") reported by @rrosenbauer

## 1.6.1 - 2025-02-19

> ⚠️⚠️ This release required **PHP 8.4.0** and will not work on earlier releases of PHP ⚠️⚠️

>  ⚠️ Some changes in this release may 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.

### Fixed

- [Issue 9840](https://github.com/firefly-iii/firefly-iii/issues/9840) (Data Importer doesn't detect duplicates when using "notes" for the unique column) reported by @muhammad-saleh

## 1.6.0 - 2025-01-31

> ⚠️⚠️ This release required **PHP 8.4.0** and will not work on earlier releases of PHP ⚠️⚠️

>  ⚠️ Some changes in this release may 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.

### Changed

Due to changes in the Docker image, the commands that use `WEB_SERVER=false` to automatically import data need another docker container. You can read more about it [in the documentation](https://docs.firefly-iii.org/how-to/data-importer/import/automated/).

- Better rate limit reporting for Nordigen
- Better exit codes
- Data is cached, should make the importer slightly faster

### Fixed 
- [Issue 9484](https://github.com/firefly-iii/firefly-iii/issues/9484) (Exit code 72 when no results are found - expecting 73) reported by @james-prince
- [Issue 9505](https://github.com/firefly-iii/firefly-iii/issues/9505) (data-importer develop failing on CSV file) reported by @MacPaille
- [Discussion 9513](https://github.com/orgs/firefly-iii/discussions/9513) (Importer Stuck on Configuration with no exception) started by @KasparRosin
- [Issue 9651](https://github.com/firefly-iii/firefly-iii/issues/9651) (Data importer fails to check configured self signed CA when checking for duplicate external IDs) reported by @zebrapurring
- [Issue 9688](https://github.com/firefly-iii/firefly-iii/issues/9688) ([Importer] Gocardless Import not using correct values for creditor) reported by @arnolicious

### Added
- Support for PHP 8.4
- [Discussion 9626](https://github.com/orgs/firefly-iii/discussions/9626) (Allow newlines in description/Add hook points to Data importer process) started by @Sobuno

### Removed
- Support for < PHP 8.4

## v1.5.7 - 2024-11-10

### Added
- Add debug information for rate limits from GoCardless
- [Pull request 686](https://github.com/firefly-iii/data-importer/pull/686) (Add DB as Debit indicator) by @akhy

### Changed
- [Issue 9272](https://github.com/firefly-iii/firefly-iii/issues/9272) (Update data-importer to reflect aquisition of Nordigen by Gocardless) reported by @gene1wood
- [Issue 9357](https://github.com/firefly-iii/firefly-iii/issues/9357) (Data Importer exits with error code 1 when no transactions are found) reported by @diogotcorreia

### Fixed
- Better error catching for rate limits from GoCardless
- Fix link to documentation 
- [Issue 9180](https://github.com/firefly-iii/firefly-iii/issues/9180) (Data importer - gocardless EUA is expired - print clear message instead of 500 server error) reported by @Ovenlade
- [Issue 9340](https://github.com/firefly-iii/firefly-iii/issues/9340) (Default transaction import without year to current year) reported by @mokkun
- [Issue 9347](https://github.com/firefly-iii/firefly-iii/issues/9347) (Importing transaction with huge external id throws error) reported by @diogotcorreia
- [Issue 9345](https://github.com/firefly-iii/firefly-iii/issues/9345) (data importer - error lines don't match to actual lines in csv) reported by @rel-thanu

## 1.5.6 - 2024-09-15

### Changed
- Improved GoCardless rate limiting handling

### Fixed
- GoCardless rate limit could report negative time.
- Documentation links

## 1.5.5 - 2024-09-05

### Changed
- Better GoCardless rate limiting reporting

### Fixed
- [Issue 9194](https://github.com/firefly-iii/firefly-iii/issues/9194) (data importer via gocardless EU - details of the account is not imported anymore after last two versions) reported by @fate8383

## 1.5.4 - 2024-08-22

### Added
- [Issue 9139](https://github.com/firefly-iii/firefly-iii/issues/9139) (Implement rate limiting for GoCardless) reported by @JC5

## 1.5.3 - 2024-07-28

### Added
- Support for another bank's debit indicator, by @0xjams 

### Fixed
- Case-sensitive matching on bank debit indicator, by @rajabilal555
- [Discussion 9067](https://github.com/orgs/firefly-iii/discussions/9067) (Unable to automate: Data-importer doesn't remember which accounts spectre accounts map to.) started by @demiGod095
- [Issue 9044](https://github.com/firefly-iii/firefly-iii/issues/9044) (Minor issue in AutoImport.php - does not catch a 'bad path' error) reported by @Terry-JF

## 1.5.2 - 2024-04-24

### Added
- [Issue 8769](https://github.com/firefly-iii/firefly-iii/issues/8769) (Perform balance check after the import) reported by @dawid-czarnecki

### Fixed
- [Issue 8799](https://github.com/firefly-iii/firefly-iii/issues/8799) (Undefined index in CAMT role selection) reported by @beune
- [Issue 8800](https://github.com/firefly-iii/firefly-iii/issues/8800) (Call to undefined function 'hasResponse') reported by @VanQz

## 1.5.1 - 2024-04-18

### Fixed
- [Issue 8798](https://github.com/firefly-iii/firefly-iii/issues/8798) (Undefined variable $version) reported by @JC5
- Fix an issue with default currency selection.

## 1.5.0 - 2024-04-18

### Added
- The data importer has a release flow just like Firefly III, dropping generated JS files and other dependencies from the repository.
- [Issue 8665](https://github.com/firefly-iii/firefly-iii/issues/8665) (API exception if transaction is deleted by rule) reported by @Medformatik
- [Issue 8691](https://github.com/firefly-iii/firefly-iii/issues/8691) (Import gocardless "merchantCategoryCode") reported by @tboby

### Changed
- Rewrote front-end layout to AlpineJS + Laravel Blade, moving away from Twig + Vue.
- Some rules in the PR template

### Fixed
- [Discussion 8709](https://github.com/orgs/firefly-iii/discussions/8709) (Data importer imports duplicates of deleted transactions when detection is set to external id) started by @kesot
- [Issue 8736](https://github.com/firefly-iii/firefly-iii/issues/8736) (Error importing CAMT.053 XML with data-importer) reported by @Gamesh
- [Issue 8771](https://github.com/firefly-iii/firefly-iii/issues/8771) (Typo on Data Importer log) reported by @jemtz-deleon
- [PR 575](https://github.com/firefly-iii/data-importer/pull/575) (Update `.env.example`, `ASSET_URL` moved, example given) by @stevewasiura

## 1.4.5 - 2024-03-21

### Added
- Added the option to add a "fallback" configuration file for directory imports, by @Call-Me-G-Now. See the [documentation](https://docs.firefly-iii.org/how-to/data-importer/advanced/post/#importing-a-local-directory) for more info.
- Client side file type validation by @Call-Me-G-Now

### Changed
- Better list of currencies in the configuration screen, by @patricksindelka

### Fixed
- [Issue 8574](https://github.com/firefly-iii/firefly-iii/issues/8574) (Importing camt.053 file fails during conversion step ) reported by @laeckerv
- [Issue 8582](https://github.com/firefly-iii/firefly-iii/issues/8582) (CSV importer uses "contains" to detect duplicates in External ID) reported by @RobinWeitzel
- [Issue 8583](https://github.com/firefly-iii/firefly-iii/issues/8583) (Importing camt.053 file fails during conversion step when Statement Account IBAN  is mapped) reported by @laeckerv
- [Issue 8607](https://github.com/firefly-iii/firefly-iii/issues/8607) (Data Importer Vanity URL with Docker not being shown) reported by @Jademalo
- Typo in debug logs by @Call-Me-G-Now

## v1.4.4 - 2024-02-18

### Fixed
- [Issue 8534](https://github.com/firefly-iii/firefly-iii/issues/8534) (Data Importer ignoring relevant Nordigen error.) reported by @miguelangel-nubla
- [Issue 8541](https://github.com/firefly-iii/firefly-iii/issues/8541) (new gocardless connection string, old string will be deprecated) reported by @siemdejong
- [PR 529](https://github.com/firefly-iii/data-importer/pull/529) (Fixed a small issue with a label targeting the wrong input) by @moritzgloeckl
- [PR 531](https://github.com/firefly-iii/data-importer/pull/531) (Update Nordigen base url) by @JcMinarro

## 1.4.3 - 2024-02-05

### Changed
- The data importer can connect to nightly builds of Firefly III, which self-report as version `develop/YYYY-MM-DD`.

### Fixed
- [Discussion 8482](https://github.com/orgs/firefly-iii/discussions/8482) (Why is the importer turning 25.00000 into 2,500,000?) started by @jerrac

## v1.4.2 - 2024-01-22

### Added
- [Issue 8391](https://github.com/firefly-iii/firefly-iii/issues/8391) (Add OCI Labels to Docker Images) reported by @mytlogos

### Fixed
- [Issue 8367](https://github.com/orgs/firefly-iii/discussions/8367) Bad type error, reported by @quotary
- [Issue 8389](https://github.com/firefly-iii/firefly-iii/issues/8389) (Data Importer stops Autoimport of multiple Nordigen/GoCardless files if one has zero transactions) reported by @rerobade
- [Issue 8404](https://github.com/firefly-iii/firefly-iii/issues/8404) (Data importer confuses thousands separator for decimal separator when decimal separator is missing.) reported by @nonsavant
- [Issue 8408](https://github.com/firefly-iii/firefly-iii/issues/8408) (Importing camt.053 file fails during conversion step) reported by @ltouroumov
- [Issue 8414](https://github.com/firefly-iii/firefly-iii/issues/8414) (Getting `Unexpected data found.` trying to import via GoCardless/Nordigen) reported by @dabeeeenster

## v1.4.1 - 2024-01-15

### Added
- Nordigen supports "bookingDateTime"

### Fixed
- [Issue 8267](https://github.com/firefly-iii/firefly-iii/issues/8267) Fix reference to variable
- [Issue 8294](https://github.com/firefly-iii/firefly-iii/issues/8294) [issue 8355](https://github.com/firefly-iii/firefly-iii/issues/8355) Null pointer fixed
- [Issue 8293](https://github.com/firefly-iii/firefly-iii/issues/8293) Don't stop importing when one connection has no transactions
- [Issue 8344](https://github.com/firefly-iii/firefly-iii/issues/8344) The UI will report progress again
- [Issue 8355](https://github.com/firefly-iii/firefly-iii/issues/8355) Foreign amounts would not be imported
- Fix log levels in papertrail configuration
- The UI will email reports again

## 1.4.0 - 2023-12-18

> ⚠️⚠️ This release required **PHP 8.3.0** and will not work on earlier releases of PHP ⚠️⚠️

>  ⚠️ Some changes in this release may 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
- GoCardless-users are forwarded to refresh their agreement if necessary.

### Changed
- ⚠️⚠️ Added support for PHP 8.3 ⚠️⚠️
- Requires Firefly III **v6.1.0** or higher

### Removed
- ⚠️⚠️ Removed support for PHP 8.2 ⚠️⚠️

### Fixed
- [Issue 8000](https://github.com/firefly-iii/firefly-iii/issues/8000) Inform user when there are no transactions found by the Nordigen Data Importer
- [Issue 6500](https://github.com/firefly-iii/firefly-iii/issues/6500) Transactions with 0.0 amount are not imported
- [Issue 6470](https://github.com/firefly-iii/firefly-iii/issues/6470) use the "ultimateCreditor"-field for Nordigen transactions
- [Issue 5460](https://github.com/firefly-iii/firefly-iii/issues/5460) Add balance info in configuration screen
- Access token from `Authorization`-header is forwarded to Firefly III if necessary.
- All documentation links are fixed again.
- Improve text in configuration screen.
- Expand notifications so logging can be more easily parsed.
- Nordigen / GoCardless now saves the booked / pending tags as well.

## 1.3.12 - 2023-11-23

### Added
- Support for Mint imports. Use [this configuration file](https://github.com/firefly-iii/import-configurations/blob/main/other-software/mint.json).

## 1.3.11 - 2023-11-23

### Changed
- Add some more explanation text to the date input

### Fixed
- [Issue 8184](https://github.com/firefly-iii/firefly-iii/issues/8184) I broke the importer 

## 1.3.10 - 2023-11-21

>  ⚠️ Some changes in this release may 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
- [Issue 7977](https://github.com/firefly-iii/firefly-iii/issues/7977) More details on accounts added

### Changed
- Renamed Nordigen to GoCardless

### Fixed
- [Issue 8130](https://github.com/firefly-iii/firefly-iii/issues/8130) External ID with space breaks duplicate check
- [Issue 8158](https://github.com/firefly-iii/firefly-iii/issues/8158) Several nullpointers


## 1.3.9 - 2023-11-04

>  ⚠️ Some changes in this release may 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
- Fancy new security.txt file.

### Changed
- Better safety catches for Nordigen and Spectre, in case they accidentally try to create deposits or withdrawals that should be transfers.

### Fixed
- [Issue 7948](https://github.com/firefly-iii/firefly-iii/issues/7948) Null pointer exception in CAMT processing.
- [Issue 8005](https://github.com/firefly-iii/firefly-iii/issues/8005) Sometimes the importer does not recognize the importer account
- [Issue 8045](https://github.com/firefly-iii/firefly-iii/issues/8045) Bad caching leads to unfixable authentication errors
- [Issue 8052](https://github.com/firefly-iii/firefly-iii/issues/8052) Credit card transactions after a certain date are not imported while all other transactions are
- [Issue 8207](https://github.com/firefly-iii/firefly-iii/issues/8207) Data Importer ignoring relevant Nordigen error.

## 1.3.8 - 2023-09-02

### Fixed
- [Issue 7918](https://github.com/firefly-iii/firefly-iii/issues/7918) Make sure XML file are recognized by the POST importer

## 1.3.7 - 2023-09-02

### Fixed
- The POST import command and the CLI import routine will also stop working if the connected Firefly III is too old.

## 1.3.6 - 2023-09-02

>  ⚠️ This release may create duplicate transactions. Don't import large batches!

### Fixed
- [Issue 7891](https://github.com/firefly-iii/firefly-iii/issues/7891) Importing from Spectre has improved, taking into account new API information. This may change the look and feel of your transactions.
- Some banks would return amount in scientific notation.
- Several CAMT fixes when the file is missing data.
- CAMT fix to verify the transaction type.
- Better flow for the onboarding of new users. Updated the documentation to match.

## 1.3.5 - 2023-08-23

### Fixed
- Error in CSV import would break imports for many users, thanks for reporting!
- Many null pointers removed from CAMT.053 import.

## 1.3.4 - 2023-08-21

>  ⚠️ This release may create duplicate transactions. Don't import large batches!

### Added
- Unmapped fields are now sorted at the top for CSV files.
- Spectre import will include IBAN and name, not just "name or IBAN".

### Fixed
- Notes are properly trimmed for import
- Account search will report on its results in the logs
- Fixed several camt.053 unstructured data import issues.
- [Issue 7816](https://github.com/firefly-iii/firefly-iii/issues/7816) Importer would break when there was no currency information in a camt file.

## 1.3.3 - 2021-07-17

### Fixed
- Formatting issue in debug log message broke the CAMT import

## 1.3.2 - 2023-07-16

### Added
- Better error handling for CAMT files.

### Changed
- New way of saving user info, should make it easier to change variables without running into old values.

### Fixed
- [Issue 7729](https://github.com/firefly-iii/firefly-iii/issues/7729) Make sure account type detection can't be overruled by later attempts.
- [Issue 7747](https://github.com/firefly-iii/firefly-iii/issues/7747) Nullpointer in CAMT import

## 1.3.1 - 2021-06-27=8

> ⚠️ This release may create duplicate transactions. Don't import large batches!

### Changed
- This version of the data importer requires Firefly III v6.0.16 or higher.

### Fixed
- Many small and large fixes in the new CAMT.053 import routine. Thanks again, @beatbesmer and bug testers!
- [Issue 7643](https://github.com/firefly-iii/firefly-iii/issues/7643) Bad redirect when trying to import using a config file. 

## v1.3.0 - 2023-06-05

- ⚠️ This release may create duplicate transactions. Don't import large batches!

### CAMT.053 support

GitHub user @beatbesmer has been working hard to make the data importer support CAMT.053 files. You can now upload 
these files like you would a CSV file and have them imported into Firefly III. Although this new feature has been
thorougly tested by Beat and myself, CAMT.053's XML standards are a very loose standard so expect bugs, issues and
crashes. We welcome your feedback in the form of [bug reports](https://github.com/firefly-iii/firefly-iii/issues/new?assignees=&labels=&projects=&template=bug.yml)

### Added
- [Issue 6108](https://github.com/firefly-iii/firefly-iii/issues/6108) You can customize the import tag used by the data importer

### Fixed
- [Issue 5996](https://github.com/firefly-iii/firefly-iii/issues/5996) Cannot send email using self-signed certificates
- [Issue 7512](https://github.com/firefly-iii/firefly-iii/issues/7512) Broken links in app and documentation
- [Issue 7264](https://github.com/firefly-iii/firefly-iii/issues/7264) Data Importer crashes when mail server auth fails

## v1.2.2 - 2023-03-19

- ⚠️ This release may create duplicate transactions. Don't import large batches!

### Changed
- Drop accuracy to 12 decimals. This fixes a lot of rounding issues.

### Fixed
- [Issue 7225](https://github.com/firefly-iii/firefly-iii/issues/7225) Fix email error when no vanity url is set

## 1.2.1 - 2023-03-13

### Fixed
- [Issue 7214](https://github.com/firefly-iii/firefly-iii/issues/7214) Previous issue with account currency matching needed a Data Importer fix as well.

### Changed
- This release will only work with Firefly III v6.0.4

## 1.2.0 - 2023-03-13

### Fixed
- [Issue 7207](https://github.com/firefly-iii/firefly-iii/issues/7207) Missing key validation

### Changed
- This release will only work with Firefly III v6.0.3

## 1.1.0 - 2023-03-12

### Added
- Warnings when you use bad configuration values.
- `IMPORT_DIR_WHITELIST` is now `IMPORT_DIR_ALLOWLIST` 

### Changed
- Improve logging when reporting on possible duplicates.

## 1.0.2 - 2022-01-27

### Fixed
- Missing array key breaks Nordigen and Spectre imports.

## 1.0.1 - 2022-01-26

### Fixed
- Fixed missing options when importing CSV file.
- Remove `APP_KEY` generation since the data importer doesn't use one.

## 1.0.0 - 2022-01-23

- ⚠️ This release requires PHP 8.2.
- ⚠️ This release may create duplicate transactions. Don't import large batches!

### Added
- The data importer has a health checkpoint, thanks @davidschlachter!

### Changed
- ⚠️ Use Nordigen's internal transaction ID as the transaction ID.
- Switch to Mastodon in the readme.
- Fix the link to the PHP docs, thanks @sa7mon!
- Small fixes to the `.env.example` file, thanks @axelsimon!

### Fixed
- [Issue 6518](https://github.com/firefly-iii/firefly-iii/issues/6518) Issue with bad account listings
- Fix bad method call
- Make sure CSV import values are trimmed (prevents account names like `PAYPAL    `)

## 0.9.17 - 2021-10-24

⚠️ This release WILL create duplicate transactions. Don't import large batches!

### Added
- Better error handling.

### Fixed
- Fix [issue 6548](https://github.com/firefly-iii/firefly-iii/issues/6548)
- Fix [issue 6525](https://github.com/firefly-iii/firefly-iii/issues/6525)

## 0.9.16 - 2022-09-12

### Added
- Ability to recognize 'Charge' as a debit transaction.
- Expand error messages with URL.
- Log more errors.

### Fixed
- [Issue 6354](https://github.com/firefly-iii/firefly-iii/issues/6354) Path fix for subdirectory installations.
- [Issue 6377](https://github.com/firefly-iii/firefly-iii/issues/6377) Switch issue were transaction amounts were reversed (and thus also the types)
- [Issue 6412](https://github.com/firefly-iii/firefly-iii/issues/6412) Update for command line import.
- [Issue 6419](https://github.com/firefly-iii/firefly-iii/issues/6419) Time out and SSL check wasn't consistent.

### Security
- Update packages

## 0.9.15 - 2022-07-25

### Fixed
- [Issue 6259](https://github.com/firefly-iii/firefly-iii/issues/6259) Fixed an issue where deposits would not be given a source account.

## 0.9.14 - 2022-07-21

### Added
- Fallback to additional information field if description is empty, thanks @martinslota

### Fixed
- [Issue 6242](https://github.com/firefly-iii/firefly-iii/issues/6242) Bad string conversion when dates are empty.
- [Issue 6244](https://github.com/firefly-iii/firefly-iii/issues/6244) Rename field from 'uri' to 'url'.
- Fix missing field data check for spectre imports.

## 0.9.13 - 2022-07-19

### Fixed
- Fixed an issue where the importer would break when importing mapped transactions.

## 0.9.12 - 2022-07-16

### Fixed
- Make sure packages match PHP 8.0

## 0.9.11 - 2022-07-16

### Fixed
- Issue where config files with empty strings would break the date selection.
- [Issue 6146](https://github.com/firefly-iii/firefly-iii/issues/6146) Fix issue where missing Nordigen data would break the import.
- [Issue 6233](https://github.com/firefly-iii/firefly-iii/issues/6233) Fix issue where mapping an expense account to a revenue spot would break the import.
- Fix issue where the importer would not detect empty descriptions. Thanks @BerghsJelmer

## 0.9.10 - 2022-05-03

### Changed
- Require the most recent version of Firefly III

## 0.9.9 - 2022-05-03

### Changed
- Made the texts more generic to accommodate future changes
- Catch deleted transactions
- Require most recent Firefly III

### Fixed
- [Issue 5980](https://github.com/firefly-iii/firefly-iii/issues/5980) Fix date range.

## 0.9.8 - 2022-04-13

### Fixed
- Fixes an issue with an underlying package.

## 0.9.7 - 2022-04-11

### Fixed
- Fixes an issue with an underlying package.

## 0.9.6 - 2022-04-11

### Fixed
- Fixes an issue with an underlying package.

## 0.9.5 - 2022-04-10

### Fixed
- Fixes an issue with an underlying package.

## 0.9.4 - 2022-04-10

### Fixed
- Fixes another issue with detecting duplicate transactions.

## 0.9.3 - 2022-04-05

### Fixed

- A small change should make it easier for the data importer to detect failed transaction creation attempts.
- [Issue 5964](https://github.com/firefly-iii/firefly-iii/issues/5964) Updated libraries to fix issue.

## 0.9.2 - 2022-04-02

### Fixed
- Removed some overly chatty status messages.

## 0.9.1 - 2022-04-02

### Added
- There is an option to set the maximum days to import from Nordigen, thanks @krehl!
- Importer will now report expired Nordigen User Agreements, thanks @MacPaille!

### Fixed
- [Issue 5871](https://github.com/firefly-iii/firefly-iii/issues/5871) Importer would ignore time-outs

## 0.9.0 - 2022-02-22

- ⚠️ This release WILL create duplicate transactions. Don't import large batches!

### Added
- Add command to upgrade import configurations.

### Changed
- Stop logging stack traces to prevent logs from filling up.
- ⚠️ Don't submit unused `amount_modifier` field

### Fixed
- Better error catching in configuration controller and other places.
- Sanity check to prevent the importer from treating JSON files as CSV files.
- [Issue 5731](https://github.com/firefly-iii/firefly-iii/issues/5731) Could not import transfers from Spectre
- [Issue 5735](https://github.com/firefly-iii/firefly-iii/issues/5735) Better support for old import configuration files

## 0.8.0 - 2022-02-07

- ⚠️ Using Nordigen? This release WILL create duplicate transactions. Don't import large batches.

### Added
- Collect more Nordigen information for future debug.
- Collect IBAN from secondary source if possible.
- Add value date as "payment date" whenever possible.

### Fixed
- [Issue 5590](https://github.com/firefly-iii/firefly-iii/issues/5590) 500 error when attempting to add bank account from Nordigen
- [Issue 5650](https://github.com/firefly-iii/firefly-iii/issues/5650) Better error catching for timeouts
- [Issue 5700](https://github.com/firefly-iii/firefly-iii/issues/5700) Missing route for Nordigen (experimental fix)
- Clean up some logging.
- Better check on session states
- Better check on messages to report
- Will not email if not configured to

## 0.7.0 - 2022-01-22

- ⚠️ Using Nordigen? This release WILL create duplicate transactions. Don't import large batches.

A special thanks to the excellent folks over at @nordigen for some quick debugging and fixing.

### Added
- A special 500 page so you can see what's happening.
- Nordigen will now import transaction details in notes.
- If you have no Firefly III accounts, the importer will warn you.
- Extra account details debug information.

### Fixed
- A missing method broke navigation.
- Sometimes session details would get lost in translation.

## 0.6.5 - 2022-01-15

### Fixed

- Catch error in `balanceAfterTransaction` field.

## 0.6.4 - 2022-01-15

### Fixed

- `ownerAddressUnstructured` could unexpectedly be unset.

## 0.6.3 - 2022-01-12

### Fixed

- Nordigen reports the `ownerAddressUnstructured` both as string and array, thanks @dawid-czarnecki

## 0.6.2 - 2022-01-12

### Fixed

- [Issue 5507](https://github.com/firefly-iii/firefly-iii/issues/5507) `ownerAddressUnstructured` field is of the wrong data type.
- Version 0.6.1 also reports as 0.6.0.

## 0.6.1 - 2022-01-08

### Fixed

- Missing continue statement in transaction processor

## 0.6.0 - 2022-01-08

- ⚠️ Duplicate detection could be broken, due to changes in the way transactions are handled. Be careful importing large batches.
- 💡 Some people have reported running into loops when trying to start importing CSV files. Please [open an issue](https://github.com/firefly-iii/firefly-iii/issues) if this happens to you.

### Added
- The Spectre import checks more fields for payee information, thanks @ddelbondio!

### Changed
- The importer can stop warning you about duplicate transactions, making for a cleaner import. Check out `.env.example`.
- If there is nothing to report, there will be no email message.
- The import tag will not be created until the first transaction is successfully imported.
- The configuration file export will mention the data importer version.

### Fixed
- Various issues where people would end up in a redirect loop.
- In some cases, the "mapping" feature was hidden.
- The debug page could add newlines, breaking the table.
- The autoupload endpoint would require CSV files, even when using Nordigen or Spectre.
- [Issue 5502](https://github.com/firefly-iii/firefly-iii/issues/5502) Sloppy copy/paste bug leads to confusion between the base URL and the vanity URL.

## 0.5.0 - 2022-01-01

- ⚠️ Duplicate detection could be broken, due to changes in the way transactions are handled. Be careful importing large batches.
- 💡 Some people have reported running into loops when trying to start importing CSV files. Please [open an issue](https://github.com/firefly-iii/firefly-iii/issues) if this happens to you.

### Added
- Code to support the [cloud installation](https://docs.firefly-iii.org/references/data-importer/public/).
- Proper page for maintenance mode.

### Changed
- [Issue 5453](https://github.com/firefly-iii/firefly-iii/issues/5453) Different text for button
- Importer will complain about bad environment variables.
- Only create the import tag when necessary.

### Fixed
- [Issue 5354](https://github.com/firefly-iii/firefly-iii/issues/5354) Fix edge case when importing CSV files.
- [Issue 5440](https://github.com/firefly-iii/firefly-iii/issues/5440) Can now handle amounts formatted `0,xxxxx`
- [Issue 5452](https://github.com/firefly-iii/firefly-iii/issues/5452) Bad vanity URL in reports
- [Issue 5459](https://github.com/firefly-iii/firefly-iii/issues/5459) Fix issue when skipping configuration page.
- Filter spaces from IBANs

## 0.4.1 - 2021-12-23

- ⚠️ Duplicate detection could be broken, due to changes in the way transactions are handled. Be careful importing large batches.
- 💡 Some people have reported running into loops when trying to start importing CSV files. Please [open an issue](https://github.com/firefly-iii/firefly-iii/issues) if this happens to you.

### Added
- Dark mode. Responds to your browser or OS.

### Fixed
- [Issue 5416](https://github.com/firefly-iii/firefly-iii/issues/5416) Mismatch in function name breaks Nordigen.

## 0.4.0 - 2021-12-22

### Known issues

- ⚠️ Duplicate detection could be broken, due to changes in the way transactions are handled. Be careful importing large batches.
- 💡 Some people have reported running into loops when trying to start importing CSV files. Please [open an issue](https://github.com/firefly-iii/firefly-iii/issues) if this happens to you.

### Changed
- The importer will search for, and match account numbers as well as IBANs.
- The importer will prefer 'bookDate' over 'valueDate'

### Added
- POST import and import via upload is now possible. Several mandatory security measures are listed in `.env.example`.

### Fixed
- [Issue 5397](https://github.com/firefly-iii/firefly-iii/issues/5397) Could not import into liabilities.
- [Issue 23](https://github.com/firefly-iii/data-importer/pull/23), fixed date range settings, thanks @p-rintz
- [Issue 5407](https://github.com/firefly-iii/firefly-iii/issues/5407) Fix issue with empty accountlists.

## 0.3.0 - 2021-12-11

### Added
- [Issue 5342](https://github.com/firefly-iii/firefly-iii/issues/5342) Can import "external URL" field.
- Will now send report messages over mail if you want.

### Fixed
- Remove TODO's from README file.
- Respect date range when importing.
- Nordigen will pre-select country + bank
- Nordigen will recycle requisition
- Mapping works for Spectre + Nordigen
- Better secret management for Nordigen + Spectre
- [Issue 5351](https://github.com/firefly-iii/firefly-iii/issues/5351) Fix URL's
- Fix duplicate detection.
- Fix issue with transfers being imported as deposits.
- New debit indicator thanks to @reeperbahnause

## 0.2.0 - 2021-12-04

### Added
- There is a `/debug` page if you need it.
- Auto-import works over the command line.
- Importing works over the command line.
- Full documentation in place.

### Changed
- More consistent layout

### Fixed
- [Issue 5336](https://github.com/firefly-iii/firefly-iii/issues/5336) Undefined array key "Liabilities
- [Issue 5337](https://github.com/firefly-iii/firefly-iii/issues/5337) Config download fails
- [Issue 5338](https://github.com/firefly-iii/firefly-iii/issues/5338) APISubmitter not found in RoutineManager
- [Issue 5339](https://github.com/firefly-iii/firefly-iii/issues/5339) fails to read CSV delimiter correctly
- [Issue 5343](https://github.com/firefly-iii/firefly-iii/issues/5343) Missing config variable
- [Issue 5344](https://github.com/firefly-iii/firefly-iii/issues/5344) Protocol mismatch
- [Issue 5345](https://github.com/firefly-iii/firefly-iii/issues/5345) Some transactions are said to have the same source and destination

## 0.1.0 - 2021-11-27

First release of the data importer.

## v0.0.0 - 2021-xx-xx

<!-- summary: In this release ... If you can read this I forgot to update the summary! -->

### Added
- Initial release.

### Changed
- Initial release.

### Deprecated
- Initial release.

### Removed
- Initial release.

### Fixed
- Initial release.

### Security
- Initial release.
