FinTS Account Balance icon

FinTS Account Balance

Retrieves the account balance for all accounts via FinTS/HBCI

Account → Get Statements

AI-generated

Overview

This node connects to German banks using the FinTS (Financial Transaction Services) protocol to retrieve account statements, including balances and recent transactions, for the user's bank accounts. It supports FinTS protocols 3.0 and 4.1, with an auto-detect option to choose the best protocol. The node is useful for automating the retrieval of bank statement data for personal finance management, accounting, or integration with other financial software like Firefly III.

Use Case Examples

  1. Fetch recent bank statements from ING using FinTS 3.0 protocol.
  2. Automatically detect and use FinTS 4.1 protocol to retrieve account transactions from Deutsche Bank.
  3. Exclude specific IBANs from the results when fetching statements from multiple accounts.
  4. Enable debug mode to get detailed logs of the FinTS communication for troubleshooting.

Properties

Name Meaning
FinTS Protocol Selects the FinTS protocol version to use for communication with the bank (3.0 stable, 4.1 experimental, or auto-detect).
Select Bank Choose the bank to connect to; this sets the bank code (BLZ) and FinTS URL automatically for common banks.
Expert Mode: Enter BLZ and FinTS URL Manually Allows manual entry of bank code (BLZ) and FinTS server URL instead of selecting a predefined bank.
Bank Code (BLZ) The bank code used to identify the bank, required if expert mode is enabled.
FinTS Server URL The URL of the FinTS server to connect to, required if expert mode is enabled.
FinTS Registration Number Optional FinTS Product Registration ID required by some banks to access their FinTS interface.
Start Date The start date from which to fetch bank statements; defaults to 14 days ago if not set.
End Date The end date up to which to fetch bank statements; defaults to today if not set.
Include Firefly III Fields Whether to include additional fields in a nested 'firefly' object for integration with Firefly III personal finance software.
Debug Mode Enables detailed debug logs in the output, adding a _debug property with step-by-step execution information.
Exclude IBANs/Account Numbers Comma-separated list of IBANs or account numbers to exclude from the results.
App TAN Wait Timeout (Seconds) Maximum time in seconds to wait for user confirmation of a push notification TAN (AppTAN), relevant for some banks like Sparda Bank.

Output

JSON

  • account - The IBAN or account number of the bank account.
  • bank - The bank code (BLZ) of the bank.
  • balance - The closing balance of the account for the statement period.
  • currency - The currency of the account balance.
  • transactions
    • ``
      * currency - Currency of the transaction amount.
      * amount - Amount of the transaction; positive for credits, negative for debits.
      * valueDate - Date of the transaction.
      * text - Description text of the transaction.
      * reference - Bank reference for the transaction.
      * isCredit - Boolean indicating if the transaction is a credit.
      * isExpense - Boolean indicating if the transaction is an expense.
      * firefly - Optional nested object with additional fields for Firefly III integration, including transactionId, transactionType, description, date, sendingAccount, targetAccount, notes, and endToEndRef.

Dependencies

  • An API key credential for FinTS authentication is required.

Troubleshooting

  • Ensure the bank code (BLZ) and FinTS URL are correctly set, especially when using expert mode.
  • Verify that the User ID and PIN in the FinTS credentials are correct to avoid authentication errors.
  • If using the FinTS Registration Number, ensure it is valid and registered with the bank to prevent error 9050.
  • Check that the start date is not after the end date to avoid validation errors.
  • If no accounts are found, verify the credentials and bank selection.
  • If all accounts are excluded by the filter, adjust the 'Exclude IBANs/Account Numbers' parameter to include at least one account.
  • Enable debug mode to get detailed logs for troubleshooting connection or authentication issues.

Links

Discussion