GLS Bank: No supported HIKAZS version found

[varac]

Describe the bug

I'm using https://github.com/MoritzR/fints2ledger to fetch my bank transactions for a long time.
Suddenly, without any configuration or code changes, fints2ledger fails with the error message:

This operation is not supported by this bank: No supported HIKAZS version found. I support (5, 6, 7), bank supports ().

I can reproduce this with the script taken from https://python-fints.readthedocs.io/en/latest/trouble.html

*Bank I tested this with
Name of the bank: GLS Bank
FinTS URL: https://fints1.atruvia.de/cgi-bin/hbciservlet

Expected behavior

I'd like to fetch my latest transactions like before

Code required to reproduce

fints2ledger

$ fints2ledger --to-csv-file transactions.csv --journal-file fints2ledger.beancount --date 17.11.2025
Traceback (most recent call last):
  File "/tmp/fints2ledger350271-0.py", line 74, in <module>
    main()
    ~~~~^^
  File "/tmp/fints2ledger350271-0.py", line 55, in main
    transactions = retrieve_transactions(
        account=args["account"],
    ...<5 lines>...
        end=date_string_to_mt940_date(args["end"]),
    )
  File "/tmp/fints2ledger350271-0.py", line 10, in retrieve_transactions
    return TRetriever(client, selected_account).get_hbci_transactions(start, end)
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^
  File "/tmp/fints2ledger350271-0.py", line 23, in get_hbci_transactions
    return self.client.get_transactions(account, start_date, end_date)
           ~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/varac/beancount/.venv/lib/python3.13/site-packages/fints/client.py", line 529, in get_transactions
    hkkaz = self._find_highest_supported_command(HKKAZ5, HKKAZ6, HKKAZ7)
  File "/home/varac/beancount/.venv/lib/python3.13/site-packages/fints/client.py", line 505, in _find_highest_supported_command
    raise FinTSUnsupportedOperation('No supported {} version found. I support {}, bank supports {}.'.format(
    ...<3 lines>...
    ))
fints.exceptions.FinTSUnsupportedOperation: No supported HIKAZS version found. I support (5, 6, 7), bank supports ().

fints2ledger: PyFintsError "Failed to get FinTS transactions, check the message above."
HasCallStack backtrace:
  bracket, called at ./System/IO/Temp.hs:100:3 in temporary-1.3-832318abd3b38d5754335b9f1a12b5f0470b8a9550c5c79bbd841dc543af0662:System.IO.Temp

python-fints Debug script

• Script taken from https://python-fints.readthedocs.io/en/latest/trouble.html, only modified by entering the REPLACEME fields.
• Same error message when trying to fetch transactions from the last 90 days

Log output / error message

• This operation is not supported by this bank: No supported HIKAZS version found. I support (5, 6, 7), bank supports ().
• I could provide the output from the script if needed, but it's huge and I'd like to clean it up before.

Additional context

• I filed the bug here and not at fints2ledger because I could reproduce the issue with the fints debug script.
• python-fints v4.2.4

[softint2]

Having since yesterday the same problem, but I use the library here direct in a self written program, fetching the accounts works, fetching transaction results in the same error.

Verbundsvolksbank OWL

[softint2]

As I am not into fints protocol, I did some "debugging" with the AI:

`# Debug: Check what transaction-related segments the bank supports

print("Bank supported segments:")
for segment in fin_client.bpd.segments:
if 'KAZ' in segment.header.type or 'HIK' in segment.header.type:
print(f" {segment.header.type} v{segment.header.version}")`

Bank supported segments: HIKAUS v2 HIKIFS v7 HIKAAS v1

The bank no longer advertises HIKAZS (account transaction statements) but now only shows:

HIKAUS v2 - Account information (Kontoauszug/statements)
HIKIFS v7 - Account information filtered
HIKAAS v1 - Account information archived

The bank switched from HIKAZS to HIKAUS/HIKIFS for transaction retrieval.

[MJochim]

This is very likely due to the problem in described in #193 and possibly fixed in #196.

[Robera16]

@varac I faced exactly the same error This operation is not supported by this bank: No supported HIKAZS version found. I support (5, 6, 7), bank supports (). its fixed on this pr: #196

[raphaelm]

Yeah, we fully need to move to XML apparently. I'll try to work on this ASAP.

[raphaelm]

Can you test if #202 works for your workflows? The results might be a little different than before, so be cautious.

[varac]

@raphaelm Yes, #202 works with the debug script from the docs !
It still doesn't work with fints2ledger, but this might be a different issue now. Thanks for fixing !

[raphaelm]

What exact issue do you run into with fints2ledger? Maybe it can be solved with a field mapping.

[raphaelm]

I released beta version 5.0.0b1, happy for more feedback!

https://pypi.org/project/fints/5.0.0b1/

See also:
https://python-fints.readthedocs.io/en/latest/upgrading_4_5.html

[varac]

What exact issue do you run into with fints2ledger? Maybe it can be solved with a field mapping.

I get this error now, using fints2ledger v1.3.1 and fints 5.0.0b1:

$ fints2ledger --to-csv-file transactions.csv --journal-file fints2ledger.beancount --date 17.11.2025
Dialog response: 3060 - Bitte beachten Sie die enthaltenen Warnungen/Hinweise.
Dialog response: 3920 - Zugelassene TAN-Verfahren für den Benutzer (['946', '962', '972', '982'])
Dialog response: 3076 - Starke Kundenauthentifizierung nicht notwendig.
Traceback (most recent call last):
  File "/tmp/fints2ledger631021-0.py", line 74, in <module>
    main()
    ~~~~^^
  File "/tmp/fints2ledger631021-0.py", line 64, in main
    converted = json.dumps(list(map(transaction_to_object, transactions)))
                           ~~~~^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/tmp/fints2ledger631021-0.py", line 40, in transaction_to_object
    posting_text = hbci_data["posting_text"]
                   ~~~~~~~~~^^^^^^^^^^^^^^^^
KeyError: 'posting_text'

fints2ledger: PyFintsError "Failed to get FinTS transactions, check the message above."
HasCallStack backtrace:
  bracket, called at ./System/IO/Temp.hs:100:3 in temporary-1.3-832318abd3b38d5754335b9f1a12b5f0470b8a9550c5c79bbd841dc543af0662:System.IO.Temp