Skip to content

GLS Bank: No supported HIKAZS version found #200

Closed
Closed
GLS Bank: No supported HIKAZS version found#200
Assignees
raphaelm

Description

@varac
varac
opened on Nov 26, 2025

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

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

Activity

  1. softint2 commented on Nov 26, 2025

    @softint2
    softint2
    on Nov 26, 2025

    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

  2. softint2 commented on Nov 26, 2025

    @softint2
    softint2
    on Nov 26, 2025

    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.

  3. MJochim commented on Nov 26, 2025

    @MJochim
    MJochim
    on Nov 26, 2025

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

  4. Robera16 commented on Nov 26, 2025

    @Robera16
    Robera16
    on Nov 26, 2025

    @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

  5. raphaelm commented on Nov 26, 2025

    @raphaelm
    raphaelm
    on Nov 26, 2025
    Owner

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

  6. raphaelm commented on Nov 27, 2025

    @raphaelm
    raphaelm
    on Nov 27, 2025
    Owner

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

  7. raphaelm
    self-assigned this
    on Nov 27, 2025

  8. varac commented on Nov 27, 2025

    @varac
    varac
    on Nov 27, 2025
    Author

    @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 !

  9. raphaelm commented on Nov 27, 2025

    @raphaelm
    raphaelm
    on Nov 27, 2025
    Owner

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

  10. raphaelm commented on Nov 27, 2025

    @raphaelm
    raphaelm
    on Nov 27, 2025
    Owner

    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

  11. raphaelm
    closed this as completedon Nov 27, 2025

  12. varac commented on Nov 27, 2025

    @varac
    varac
    on Nov 27, 2025
    Author

    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

  13. varac commented on Nov 27, 2025

    @varac
    varac
    on Nov 27, 2025
    Author

    I also created a fints2ledger issue: fints 5.0.0b1: KeyError: 'posting_text'

  14. MJochim commented on Dec 1, 2025

    @MJochim
    MJochim
    on Dec 1, 2025

    5.0.0b1 fixed this issue for me, same bank. Mine is a simple read-only workflow. Thanks so much to @raphaelm and everyone who contributed!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

No labels
No labels

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions