<!-- https://docs.kontoflux.io/ -->

# Kontoflux.io nutzen

Mit Kontoflux.io sammelst du Bankkonten und Transaktionen in einem gemeinsamen Arbeitsbereich, dem **Workspace**. Von dort kannst du Daten nach Ninox übertragen, Webhooks auslösen oder den Zugriff für eigene Anwendungen und KI-Clients einrichten.

Du fängst gerade an? Die Anleitung [In wenigen Schritten starten](https://docs.kontoflux.io/erste-schritte/step-by-step-guide/) führt dich durch die Einrichtung.

## Wobei brauchst du Hilfe?

| Deine Aufgabe | Passende Anleitung |
| --- | --- |
| Einen Account anlegen oder mich anmelden | [Registrieren und anmelden](https://docs.kontoflux.io/erste-schritte/registrieren-und-anmelden/) |
| Mich in der App zurechtfinden | [Orientierung in der App](https://docs.kontoflux.io/erste-schritte/orientierung-in-der-app/) |
| Mit meinem Team zusammenarbeiten | [Workspaces verwalten](https://docs.kontoflux.io/workspaces-and-account-management/workspaces/) |
| Ein Bankkonto verbinden | [Bankkonten hinzufügen](https://docs.kontoflux.io/konten-anbinden/bankkonten-hinzufugen/) |
| Umsätze ansehen und Konten auswählen | [Transaktionen ansehen](https://docs.kontoflux.io/transaktionen/umsatze-ansehen/) |
| Transaktionen nach Ninox übertragen | [Ninox einrichten](https://docs.kontoflux.io/integrationen/ninox/) |
| Daten an einen Webhook senden | [Webhooks einrichten](https://docs.kontoflux.io/integrationen/webhooks/) |
| Einen KI-Client verbinden | [MCP-Server einrichten](https://docs.kontoflux.io/integrationen/mcp-server/) |
| Eine eigene Anwendung anbinden | [Zugang zur API](https://docs.kontoflux.io/api/zugang-zur-api/) |
| Herausfinden, warum ein Vorgang fehlgeschlagen ist | [Ereignisprotokoll](https://docs.kontoflux.io/hilfe/ereignisprotokoll/) |

## Bankdaten abholen und Daten weitergeben

Diese beiden Abläufe hängen zusammen:

1. **Bankdaten abholen:** Kontoflux.io liest Konten und Umsätze deiner angebundenen Bank ein. In **Bankkonten** prüfst du den Verbindungsstatus, in **Transaktionen** die eingelesenen Umsätze.
2. **Daten weitergeben:** Eine Integration überträgt die vorhandenen Daten in deine andere Software. Webhooks, API und MCP bieten weitere Wege, mit diesen Daten zu arbeiten.

Fehlt eine Buchung bereits in Kontoflux.io, prüfe zuerst den [Abruf der Bankdaten](https://docs.kontoflux.io/limitationen-and-sonderfalle/aktualitat-der-daten/). Ist sie dort vorhanden, aber fehlt in Ninox, prüfe die [Synchronisation der Integration](https://docs.kontoflux.io/konten-synchronisieren/manuelle-synchronisation/).

## Wenn eine Funktion nicht verfügbar ist

> [!NOTE]
> Welche Aktionen du ausführen kannst, hängt von deiner Rolle und dem Tarif des Workspaces ab. Ein ausgeblendeter oder gesperrter Eintrag bedeutet deshalb nicht unbedingt, dass etwas kaputt ist.

Prüfe zuerst, ob du im richtigen Workspace bist. Danach helfen die Übersichten zu [Rollen und Berechtigungen](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/) und [Abonnement und Abrechnung](https://docs.kontoflux.io/workspaces-and-account-management/abrechnung-und-abonnements/).

---

<!-- https://docs.kontoflux.io/erste-schritte/step-by-step-guide/ -->

# In wenigen Schritten starten

Für den Start brauchst du eine E-Mail-Adresse, Zugriff auf dein Online-Banking und einen Workspace. Das ist der Arbeitsbereich, in dem Kontoflux.io deine Bankkonten, Integrationen und Teammitglieder zusammenfasst.

## 1. Account anlegen

1. Öffne die [Registrierung](https://app.kontoflux.io/login?mode=signup).
2. Trage deine Daten ein und erstelle deinen Account.
3. Bestätige deine E-Mail-Adresse über die Nachricht, die du erhältst. Die Einrichtung in der App geht danach weiter.

Du hast bereits einen Account? [Melde dich an](https://app.kontoflux.io/login). Für die normale Registrierung brauchst du keinen Einladungscode.

Falls die Bestätigung fehlt oder du dein Passwort vergessen hast, hilft [Registrieren und anmelden](https://docs.kontoflux.io/erste-schritte/registrieren-und-anmelden/).

## 2. Workspace einrichten oder beitreten

Gib deinem neuen Workspace einen passenden Namen und hinterlege die abgefragten Kontaktdaten. Wenn dich jemand eingeladen hat, kannst du stattdessen dem vorhandenen Workspace beitreten.

Prüfe vor den nächsten Schritten den Workspace-Namen in der Navigation. Bankkonten und Integrationen werden dem gerade gewählten Workspace zugeordnet.

Du kannst später [weitere Workspaces anlegen](https://docs.kontoflux.io/workspaces-and-account-management/workspaces/) und [Teammitglieder einladen](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/).

## 3. Bankkonto verbinden

1. Öffne **Bankkonten** und wähle **Bankkonto hinzufügen**.
2. Suche deine Bank und wähle das passende Institut aus.
3. Folge dem Bankdialog. Dort meldest du dich bei deiner Bank an und bestätigst den Zugriff, wenn deine Bank das verlangt.
4. Warte, bis die Verbindung und der erste Import abgeschlossen sind. Prüfe anschließend die angezeigten Konten.

Wie weit die erste Umsatzhistorie zurückreicht, hängt von der Bank und den verfügbaren Daten ab. Die Anleitung [Bankkonten hinzufügen](https://docs.kontoflux.io/konten-anbinden/bankkonten-hinzufugen/) erklärt den Ablauf genauer.

## 4. Transaktionen prüfen

Öffne **Transaktionen**. Über **Konto** grenzt du die Liste auf ein bestimmtes Konto ein. Mit **Spalten** stellst du ein, welche Angaben du sehen möchtest.

Prüfe zunächst ein paar bekannte Buchungen: Stimmen Konto, Betrag und Verwendungszweck? So erkennst du früh, ob du mit den richtigen Daten arbeitest.

Mehr dazu: [Umsätze ansehen](https://docs.kontoflux.io/transaktionen/umsatze-ansehen/) und [Spalten anpassen](https://docs.kontoflux.io/transaktionen/spalten-anpassen/).

## 5. Den nächsten Ablauf einrichten

Unter **Automationen** findest du drei Bereiche:

| Bereich | Dafür nutzt du ihn |
| --- | --- |
| **Integrationen** | Ninox anbinden oder einen MCP- bzw. OAuth2-Server einrichten. |
| **Webhooks** | Daten an eine festgelegte Adresse senden, etwa für einen eigenen automatisierten Ablauf. |
| **API** | API-Schlüssel für eigene Anfragen und Anwendungen verwalten. |

Wähle die Anleitung, die zu deinem Vorhaben passt:

- **Ninox:** [Verbindung und Feldzuordnung einrichten](https://docs.kontoflux.io/integrationen/ninox/), danach einen [Testlauf prüfen](https://docs.kontoflux.io/konten-synchronisieren/testen-und-reparieren/).
- **Webhook:** [Zieladresse und Übertragung konfigurieren](https://docs.kontoflux.io/integrationen/webhooks/).
- **KI-Client:** [MCP-Server einrichten](https://docs.kontoflux.io/integrationen/mcp-server/) und die gewünschten Zugriffe freigeben.
- **Eigene Anwendung:** [API-Schlüssel anlegen](https://docs.kontoflux.io/api/zugang-zur-api/) oder [OAuth-Apps verwalten](https://docs.kontoflux.io/integrationen/oauth-apps/).

## 6. Im Alltag prüfen

Kontoflux.io holt Umsätze automatisch ab. Mit **Umsätze abholen** im **Dashboard** kannst du bereits verfügbare neue Umsätze zusätzlich einlesen. Eine erneute Freigabe bei deiner Bank kann trotzdem nötig sein; folge dann dem Hinweis in **Bankkonten**.

Die Übertragung nach Ninox ist ein eigener Ablauf. Prüfe dafür die Integration und ihren Zeitplan. [Automatische Synchronisation](https://docs.kontoflux.io/konten-synchronisieren/automatische-synchronisation/) erklärt die Einstellungen.

> [!TIP]
> Richte [Benachrichtigungen](https://docs.kontoflux.io/workspaces-and-account-management/benachrichtigungen/) ein, damit du wichtige Vorgänge und Fehler mitbekommst. Im [Ereignisprotokoll](https://docs.kontoflux.io/hilfe/ereignisprotokoll/) kannst du später nachsehen, was passiert ist.

---

<!-- https://docs.kontoflux.io/erste-schritte/registrieren-und-anmelden/ -->

# Registrieren und anmelden

Für Kontoflux.io brauchst du einen persönlichen Account mit E-Mail-Adresse und Passwort. Die Registrierung ist offen. Eine Einladung brauchst du, wenn du einem bestehenden Workspace beitreten möchtest.

## Einen Account erstellen

1. Öffne die [Registrierung](https://app.kontoflux.io/login?mode=signup).
2. Trage unter **Dein Name** deinen Namen ein.
3. Gib unter **Deine Geschäfts E-Mail Adresse** die Adresse ein, mit der du Kontoflux.io nutzen möchtest.
4. Lege unter **Dein Passwort** ein Passwort fest.
5. Klicke auf **Registrieren**.

Du erhältst eine E-Mail zur Bestätigung deiner Adresse. Danach geht es mit der Einrichtung weiter.

## Die E-Mail-Adresse bestätigen

Öffne die Bestätigungs-E-Mail und folge dem Link. Kehre anschließend zum geöffneten Einrichtungsfenster zurück. Die Seite erkennt die Bestätigung und führt dich zum nächsten Schritt.

Falls die E-Mail fehlt, prüfe deinen Spamordner. Unter **E-Mail Bestätigen** kannst du mit **E-Mail erneut senden** eine neue Nachricht anfordern.

Wenn für deine Adresse eine Workspace-Einladung vorliegt, zeigt die Einrichtung diese an. Du kannst sie öffnen oder mit **Neuen Workspace erstellen** einen eigenen Workspace einrichten. Die nächsten Schritte stehen in der [Einrichtungsanleitung](https://docs.kontoflux.io/erste-schritte/step-by-step-guide/).

## Bei Kontoflux.io anmelden

1. Öffne die [Anmeldeseite](https://app.kontoflux.io/login).
2. Gib **E-Mail** und **Passwort** ein.
3. Klicke auf **Anmelden**.

Normalerweise öffnet sich dein Dashboard. Wenn du einem Einladungslink oder einem anderen geschützten Link gefolgt bist, führt dich die Anmeldung zurück zu diesem Ziel.

## Ein vergessenes Passwort zurücksetzen

1. Klicke auf der Anmeldeseite auf **Passwort vergessen?**.
2. Gib die E-Mail-Adresse deines Accounts ein.
3. Klicke auf **Passwort zurücksetzen**.
4. Öffne den Link in der E-Mail und lege ein neues Passwort fest.
5. Melde dich mit dem neuen Passwort an.

Wenn du dein bisheriges Passwort noch kennst, kannst du es auch in den [persönlichen Einstellungen](https://docs.kontoflux.io/erste-schritte/persoenliche-einstellungen/) ändern.

## Eine Workspace-Einladung verwenden

Melde dich mit genau der E-Mail-Adresse an, an die die Einladung geschickt wurde. Ein anderer Account kann diese Einladung nicht annehmen. Bereits registrierte Nutzer brauchen für einen weiteren Workspace keinen neuen Account.

Die Anleitung zur Annahme und zu ungültigen Einladungen findest du unter [Mitglieder und Rollen](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/#eine-einladung-annehmen).

## Ausloggen

Klicke unten in der Seitenleiste auf dein Profil und wähle **Ausloggen**. Auf kleinen Bildschirmen öffnest du dazu zuerst das Menü oben links.

---

<!-- https://docs.kontoflux.io/erste-schritte/persoenliche-einstellungen/ -->

# Persönliche Einstellungen

Deine persönlichen Einstellungen gelten für deinen Account. Hier änderst du dein Profil und die Darstellung der App.

## Die Einstellungen öffnen

Klicke unten in der Seitenleiste auf dein Profil und wähle **Einstellungen**. Auf kleinen Bildschirmen öffnest du die Seitenleiste über das Menü oben links.

Du findest die Bereiche **Profil**, **Sicherheit**, **Präferenzen** und **Account löschen**. Die Angaben eines Unternehmens änderst du in den [Workspace-Einstellungen](https://docs.kontoflux.io/workspaces-and-account-management/workspaces/).

## Namen und Profilbild ändern

1. Öffne **Profil**.
2. Ändere unter **Dein Name** deinen angezeigten Namen.
3. Klicke für ein neues Profilbild auf das bisherige Bild oder deine Initialen und wähle eine JPG- oder PNG-Datei aus.
4. Klicke auf **Speichern**.

Mit **Abbrechen** verwirfst du Änderungen im Profilformular.

## Die Anmeldeadresse ändern

1. Öffne **Profil**.
2. Ändere **Deine Geschäfts E-Mail Adresse**.
3. Gib im zusätzlich eingeblendeten Feld **Passwort** dein aktuelles Passwort ein.
4. Klicke auf **Speichern**.

Die Passwortabfrage bestätigt die Änderung deiner Anmeldeadresse. Workspace-Kontakte und Rechnungsinformationen verwaltest du separat im jeweiligen Workspace.

## Passwort ändern

1. Öffne **Sicherheit**.
2. Trage dein neues Passwort unter **Neues Passwort** und **Neues Passwort bestätigen** ein.
3. Gib unter **Altes Passwort** dein bisheriges Passwort ein.
4. Klicke auf **Passwort ändern**.

Beide Eingaben des neuen Passworts müssen übereinstimmen. Wenn du das alte Passwort nicht mehr kennst, nutze [Passwort zurücksetzen](https://docs.kontoflux.io/erste-schritte/registrieren-und-anmelden/).

## Hellen oder dunklen Farbmodus wählen

Öffne **Präferenzen → Farbmodus** und wechsle zwischen **Lightmode** und **Darkmode**. Die Änderung wird direkt gespeichert. Solange du keinen Farbmodus gewählt hast, orientiert sich die App am Farbschema deines Geräts.

## Sensible Daten auf dem Bildschirm ausblenden

Unter **Präferenzen → Sensible Daten Filter** findest du Schalter für **Beträge**, **IBANs**, **Namen** und **E-Mails**. Wähle die gewünschten Anzeigeoptionen aus.

Mit **Alle sensiblen Daten ausblenden** aktivierst du alle diese Filter zusammen. Die Auswahl wird direkt gespeichert. Über das Drei-Punkte-Menü oben rechts in der App erreichst du die Anzeigeoptionen auch während der Arbeit.

Die Filter ändern die Darstellung einzelner Angaben. Prüfe vor einer Bildschirmfreigabe die sichtbare Seite: Namen von Kontoinhabern und Transaktionspartnern können trotz aktiviertem Filter weiterhin sichtbar sein. Die [Rollen im Workspace](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/) verwaltest du unabhängig davon.

## Den Account löschen lassen

Unter **Account löschen** öffnet **Löschen** eine Passwortabfrage. Nach der Bestätigung weist die App dich darauf hin, den Support zu kontaktieren. Die Löschung des Accounts wird derzeit über den Support bearbeitet.

Wenn du nur aus einem Team ausscheiden möchtest, kannst du stattdessen den [Workspace verlassen](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/#einen-workspace-verlassen).

---

<!-- https://docs.kontoflux.io/erste-schritte/orientierung-in-der-app/ -->

# Orientierung in der App

Die wichtigsten Bereiche findest du in der seitlichen Navigation. Auf schmalen Bildschirmen öffnest du sie über das Menüsymbol. Die Navigation lässt sich auch einklappen, damit mehr Platz für die Inhalte bleibt.

## Zuerst den Workspace prüfen

Oben in der Navigation steht der ausgewählte Workspace. Öffne die Auswahl, um zu einem anderen Arbeitsbereich zu wechseln. Dort kannst du auch einen neuen Workspace erstellen.

Bankkonten, Teammitglieder und Automationen gehören zum jeweiligen Workspace. Wenn dir ein Konto oder eine Integration fehlt, prüfe zuerst diese Auswahl.

## Die vier Hauptbereiche

| Bereich | Was du dort findest |
| --- | --- |
| **Dashboard** | Gesamtguthaben, Einnahmen und Ausgaben, Hinweise zu deinem Workspace, Teammitglieder und Zugänge zu den Workspace-Einstellungen. |
| **Bankkonten** | Deine Bankverbindungen, zugehörige Konten und Aktionen zum Hinzufügen oder Aktualisieren einer Verbindung. |
| **Transaktionen** | Die eingelesenen Umsätze. Du kannst ein Konto auswählen und die sichtbaren Spalten anpassen. |
| **Automationen** | Die Reiter **Integrationen**, **Webhooks** und **API**. Hier richtest du ein, wie andere Tools mit deinen Daten arbeiten. |

Die Anzeigen und verfügbaren Aktionen hängen von deiner Rolle ab. Details findest du unter [Rollen und Berechtigungen](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/).

## Das Dashboard verwenden

Im Dashboard siehst du Kennzahlen und Hinweise, etwa zu Bankverbindungen oder deinem Abonnement. Mit **Umsätze abholen** kannst du verfügbare neue Umsätze in Kontoflux.io einlesen. Bestätige dazu die gleichnamige Aktion im Dialog.

Im Bereich **Workspace** findest du die Workspace-ID zum Kopieren sowie Einträge für Einstellungen, Benachrichtigungen, Abonnement und Abrechnung. Einige dieser Aktionen stehen nur einem Admin zur Verfügung.

Unter **Aktivitätsverlauf** siehst du die letzten Ereignisse. **Alle anzeigen** öffnet das vollständige [Ereignisprotokoll](https://docs.kontoflux.io/hilfe/ereignisprotokoll/), in dem du nach Vorgängen und Fehlern suchen kannst.

> [!NOTE]
> **Umsätze abholen** aktualisiert die Daten in Kontoflux.io. Wenn du vorhandene Umsätze nach Ninox übertragen möchtest, öffne stattdessen die entsprechende [Integration](https://docs.kontoflux.io/integrationen/ninox/).

## Persönliche Einstellungen öffnen

Klicke unten in der Navigation auf dein Profil und wähle **Einstellungen**. Dort verwaltest du unter anderem deine Profildaten und Anzeigepräferenzen. Im selben Profilmenü kannst du dich abmelden.

Die vollständige Anleitung findest du unter [Persönliche Einstellungen](https://docs.kontoflux.io/erste-schritte/persoenliche-einstellungen/).

## Sensible Angaben auf dem Bildschirm ausblenden

Im Drei-Punkte-Menü oben rechts findest du Sichtbarkeitsfilter für Kontostände, Kontonummern, Namen und E-Mail-Adressen. Die Filter erfassen nicht alle Angaben in jeder Ansicht. Prüfe deshalb vor dem Teilen deines Bildschirms, welche Informationen noch sichtbar sind.

Der Filter verändert die Darstellung. Er ersetzt keine [Berechtigungen für Teammitglieder](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/) oder Freigaben für Anwendungen.

---

<!-- https://docs.kontoflux.io/workspaces-and-account-management/account-management/ -->

# Account und Zusammenarbeit

Dein Account ist dein persönlicher Zugang zu Kontoflux.io. Mit ihm meldest du dich an und arbeitest in einem oder mehreren Workspaces. Jeder Workspace hat eigene Bankkonten, Integrationen, Mitglieder und ein eigenes Abonnement.

## Account und Workspace unterscheiden

| Bereich | Was du dort verwaltest |
| --- | --- |
| Dein Account | Name, Profilbild, E-Mail-Adresse, Passwort und persönliche Anzeigeeinstellungen |
| Ein Workspace | Bankverbindungen, Transaktionen, Automationen, Team, Benachrichtigungen und Abrechnung |

Du kannst in verschiedenen Workspaces unterschiedliche Rollen haben. Zum Beispiel verwaltest du den Workspace deines Unternehmens als **Administrator** und unterstützt einen Kunden als **Integrator**.

## Mit einem eigenen Account zusammenarbeiten

Lade jede Person mit ihrer eigenen E-Mail-Adresse ein. So kannst du Rollen einzeln vergeben und den Zugang zum Workspace beenden, wenn sich Aufgaben ändern oder jemand das Team verlässt.

Eine Einladung gilt für die angegebene E-Mail-Adresse. Wer sie annimmt, muss mit dieser Adresse angemeldet sein. Ein bestehender Account lässt sich für weitere Workspace-Einladungen verwenden.

Die einzelnen Schritte findest du unter [Mitglieder und Rollen verwalten](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/).

## Den passenden Bereich öffnen

- **Neu bei Kontoflux.io:** [Registrieren und anmelden](https://docs.kontoflux.io/erste-schritte/registrieren-und-anmelden/).
- **Name, E-Mail oder Passwort ändern:** [Persönliche Einstellungen](https://docs.kontoflux.io/erste-schritte/persoenliche-einstellungen/).
- **Bankkonten und Team organisieren:** [Workspaces erstellen und verwalten](https://docs.kontoflux.io/workspaces-and-account-management/workspaces/).
- **Tarif oder Zahlungsdaten ändern:** [Abrechnung und Abonnements](https://docs.kontoflux.io/workspaces-and-account-management/abrechnung-und-abonnements/).

## Zusammenarbeit beenden

Du kannst einen Workspace über deinen Eintrag unter **Team Mitglieder** verlassen. Als letzter Administrator musst du vorher ein anderes Mitglied zum Administrator machen. Die Anleitung steht unter [Workspace verlassen](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/#einen-workspace-verlassen).

Wenn du deinen persönlichen Account löschen lassen möchtest, öffne im Profilmenü **Einstellungen → Account löschen**. Nach der Passwortbestätigung zeigt die App den Hinweis **Kontaktiere den Support**. Die Account-Löschung wird derzeit über den Support bearbeitet.

---

<!-- https://docs.kontoflux.io/workspaces-and-account-management/workspaces/ -->

# Workspaces erstellen und verwalten

Ein Workspace fasst die Bankkonten, Transaktionen, Automationen und Mitglieder eines Unternehmens oder Projekts zusammen. Wenn du für mehrere Unternehmen arbeitest, kannst du für jedes einen eigenen Workspace nutzen.

Das Abonnement und die gebuchten Kontingente gelten jeweils für einen Workspace. Deine Rolle kann von Workspace zu Workspace unterschiedlich sein.

## Einen Workspace erstellen

Bei der ersten Anmeldung führt dich Kontoflux.io durch die Einrichtung. Die vollständige Anleitung findest du unter [Erste Schritte](https://docs.kontoflux.io/erste-schritte/step-by-step-guide/).

Einen weiteren Workspace erstellst du so:

1. Klicke oben in der Seitenleiste auf den Namen des aktuellen Workspaces.
2. Wähle **Neuen Workspace erstellen**.
3. Gib unter **Name des Workspaces** einen Namen ein. Ergänze bei Bedarf ein Symbol und eine **Beschreibung oder Notiz**.
4. Klicke auf **Workspace erstellen**.
5. Vervollständige die Einrichtung mit den Kontaktdaten und klicke am Ende auf **Abschließen**.

Wenn du einen Workspace für einen Kunden einrichtest, hinterlege dessen Kontaktdaten. Verwende einen Namen, an dem dein Team den Workspace wiedererkennt.

## Zwischen Workspaces wechseln

Öffne die Workspace-Auswahl oben in der Seitenleiste und klicke auf den gewünschten Workspace. Du landest auf dessen **Dashboard**.

Auf kleinen Bildschirmen öffnest du die Seitenleiste zuerst über das Menüsymbol oben links. Prüfe vor dem Verbinden einer Bank oder dem Einrichten einer Automation den Workspace-Namen.

## Namen und Kontaktdaten ändern

Du brauchst die Rolle **Administrator**, um den Workspace zu bearbeiten.

1. Öffne das **Dashboard** des Workspaces.
2. Klicke im Bereich **Workspace** auf **Workspace Einstellungen**.
3. Wähle **Allgemein**.
4. Passe unter **Basis Informationen** den Namen, das Symbol oder die interne Beschreibung an.
5. Ändere unter **Hinterlegter Kontakt** bei Bedarf Namen, E-Mail-Adresse, Unternehmen und Anschrift.
6. Klicke auf **Speichern**.

Deine persönliche Anmeldeadresse änderst du in den [Profileinstellungen](https://docs.kontoflux.io/erste-schritte/persoenliche-einstellungen/). Empfänger für einzelne Ereignisse legst du unter [Benachrichtigungen](https://docs.kontoflux.io/workspaces-and-account-management/benachrichtigungen/) fest. Rechnungsinformationen verwaltest du über [Abrechnung verwalten](https://docs.kontoflux.io/workspaces-and-account-management/abrechnung-und-abonnements/#rechnungen-und-zahlungsdaten-verwalten).

## Einstellungen im Dashboard finden

| Eintrag | Wofür du ihn nutzt |
| --- | --- |
| **Workspace Einstellungen** | Basisinformationen, Team und Abonnement öffnen |
| **Benachrichtigungen verwalten** | Ereignisse, Empfänger und Übermittlungskanäle festlegen |
| **Abonnement verwalten** | Verbrauch ansehen und den gebuchten Umfang ändern |
| **Abrechnung verwalten** | Das Abrechnungsportal öffnen |

Diese Verwaltungsfunktionen stehen Administratoren zur Verfügung. Welche Optionen zusätzlich erscheinen, hängt vom Abonnement und einer möglichen Partnerverwaltung ab.

## Die Workspace-ID kopieren

Im **Dashboard** steht im Bereich **Workspace** die **Workspace-ID**. Klicke darauf, um sie zu kopieren. Sie hilft beispielsweise dabei, eine Supportanfrage dem richtigen Workspace zuzuordnen.

## Einen Workspace löschen

Ein Administrator kann unter **Workspace Einstellungen → Workspace löschen** die Löschung starten. Der Dialog verlangt zur Bestätigung den Text `unwiderruflich löschen` und anschließend **Workspace löschen**.

Dabei werden die Bankverbindungen und zugehörigen Daten des Workspaces gelöscht. Diese Aktion lässt sich nicht rückgängig machen. Wenn du nur deine Mitarbeit beenden möchtest, nutze [Workspace verlassen](https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/#einen-workspace-verlassen). Dein Abonnement verwaltest du unter [Abrechnung und Abonnements](https://docs.kontoflux.io/workspaces-and-account-management/abrechnung-und-abonnements/).

---

<!-- https://docs.kontoflux.io/workspaces-and-account-management/nutzerrollen-and-berechtigungen/ -->

# Mitglieder und Rollen verwalten

Mitglieder erhalten ihre Rolle für einen bestimmten Workspace. Du vergibst sie beim Einladen und kannst sie später ändern. Für die Verwaltung anderer Mitglieder brauchst du die Rolle **Administrator**.

## Die passende Rolle wählen

Die Rollenauswahl verwendet diese Bezeichnungen:

| Rolle | Aufgaben im Workspace |
| --- | --- |
| **Administrator** | Verwaltet den Workspace, Mitglieder, Abonnement, Bankkonten und Automationen. In der Mitgliederliste mit **Admin** gekennzeichnet. |
| **Member** | Arbeitet im Workspace mit Bankkonten und Finanzdaten. Kann keine Mitglieder einladen und keine Workspace-Einstellungen oder Abonnements verwalten. |
| **Finances** | Ist für die Auswertung von Finanzdaten und Transaktionen vorgesehen. |
| **Banking** | Verbindet und verwaltet Bankkonten. Geeignet für die Person, die einen Bankzugang autorisiert. |
| **Integrator** | Richtet Integrationen und technische Zugänge ein und verwaltet sie. Geeignet für interne Entwickler oder externe Dienstleister. |

Für das Einrichten und Ändern von Integrationen und deren Zugangsdaten wählst du **Administrator** oder **Integrator**. Das gilt auch für die Verwaltung von API-Schlüsseln. Der verfügbare Funktionsumfang hängt zusätzlich vom Abonnement des Workspaces ab.

Es kann mehrere Administratoren geben. Lass mindestens eine Person in dieser Rolle, damit der Workspace weiter verwaltet werden kann.

## Mitglieder einladen

1. Öffne im **Dashboard** den Bereich **Team Mitglieder**.
2. Klicke auf **einladen**.
3. Gib die E-Mail-Adresse der Person ein und wähle ihre Rolle.
4. Für weitere Personen klicke auf **Weitere Mitglieder hinzufügen** und ergänze die zusätzlichen Zeilen.
5. Klicke auf **Einladung senden**.

Du kannst Einladungen auch unter **Workspace Einstellungen → Mitglieder** verschicken. Bis zur Annahme erscheint die Person als **Einladung ausstehend**.

## Eine Einladung annehmen

1. Öffne den Einladungslink.
2. Melde dich mit der E-Mail-Adresse an, an die die Einladung geschickt wurde. Falls du noch keinen Account hast, registriere dich mit dieser Adresse.
3. Prüfe den Workspace-Namen und die angebotene Rolle.
4. Klicke auf **Einladung akzeptieren** und danach auf **Zum Workspace**.

Wenn du nicht beitreten möchtest, wähle **Einladung ablehnen**.

Bei einer Meldung zur falschen E-Mail-Adresse klicke auf **Abmelden**, melde dich mit der eingeladenen Adresse an und öffne den Link erneut. Bei einer ungültigen oder abgelaufenen Einladung bitte einen Administrator um eine neue Einladung.

## Eine ausstehende Einladung verwalten

Öffne im **Dashboard** unter **Team Mitglieder** das Drei-Punkte-Menü der Einladung. Dort stehen dir diese Aktionen zur Verfügung:

- **Einladungslink kopieren:** Kopiert den bestehenden Link.
- **Einladung erneut senden:** Verschickt die Einladung erneut per E-Mail.
- **Einladung zurückziehen:** Entfernt die ausstehende Einladung nach Bestätigung.

Der kopierte Link gilt weiterhin für die ursprünglich eingeladene E-Mail-Adresse.

## Die Rolle eines Mitglieds ändern

1. Öffne im **Dashboard** das Drei-Punkte-Menü neben dem Mitglied.
2. Wähle **Rolle ändern**.
3. Wähle unter **Rolle auswählen** die neue Rolle.
4. Klicke auf **Speichern**.

Alternativ kannst du unter **Workspace Einstellungen → Mitglieder** die Rolle direkt in der Liste ändern. Dort bestätigst du die Änderung mit **Ändern**.

## Ein Mitglied entfernen

Öffne das Drei-Punkte-Menü des Mitglieds im **Dashboard**, wähle **Mitglied entfernen** und bestätige den Dialog. Damit endet die Mitgliedschaft in diesem Workspace. Der persönliche Account bleibt für andere Workspaces bestehen.

## Einen Workspace verlassen

Öffne im **Dashboard** das Drei-Punkte-Menü an deinem eigenen Eintrag und wähle **Workspace verlassen**. Bestätige anschließend den Dialog.

Als letzter Administrator kannst du den Workspace nicht verlassen. Ernenne zuerst ein anderes Mitglied zum **Administrator**. Danach kannst du auch deine eigene Rolle über **Meine Rolle ändern** anpassen.

---

<!-- https://docs.kontoflux.io/workspaces-and-account-management/abrechnung-und-abonnements/ -->

# Abrechnung und Abonnements

Ein Abonnement gilt für einen Workspace. Als **Administrator** verwaltest du den gebuchten Umfang und die Abrechnung im **Dashboard**. Die aktuellen Preise und Kontingente siehst du direkt in der App.

## Abonnement und Verbrauch prüfen

Öffne im **Dashboard** den Eintrag **Abonnement verwalten**. Unter **Aktuelles Abonnement und Verbrauch** siehst du:

- dein aktuelles Abonnement;
- den Abrechnungszeitraum und das Rechnungsintervall;
- die angebundenen Bankkonten im Verhältnis zum Kontingent;
- die monatlichen Transaktionen im Verhältnis zum Limit;
- die aktiven Integrationen im Verhältnis zu den verfügbaren Plätzen.

Eine Übersicht findest du auch unter **Workspace Einstellungen → Abrechnung & Pläne**. Bei einer Testphase oder einem gekündigten Abonnement zeigt die App den jeweiligen Ablaufstatus an.

## Ein Abonnement buchen

1. Öffne **Abonnement verwalten**.
2. Wähle im **Preisrechner** unter **Abrechnungszeitraum** zwischen **Monatlich** und **Jährlich**.
3. Stelle unter **Anzahl Bankkonten** ein, wie viele Konten du anbinden möchtest.
4. Prüfe **Passendes Abonnement**, den Preis und die enthaltenen Leistungen.
5. Klicke auf **zur Buchung**.
6. Prüfe die Angaben in der Buchungsmaske und schließe die Buchung dort ab.

Der Preisrechner zeigt eine Vorschau. Die Buchungsmaske zeigt den verbindlichen Betrag; dort kannst du auch einen Gutschein eingeben, sofern du einen hast. Mit **Buchung abbrechen** verlässt du eine noch nicht abgeschlossene Buchung.

## Den gebuchten Umfang ändern

Du kannst die Anzahl der Bankkonten und den Abrechnungszeitraum im **Preisrechner** anpassen. Klicke anschließend auf **Abonnement umbuchen**. Die App öffnet ein zusätzliches Fenster, in dem du die Änderung prüfen und bestätigen kannst.

Wenn der Button deaktiviert ist, prüfe die Hinweise neben der Auswahl. Die App lässt beispielsweise keine erneute Buchung derselben Konfiguration zu. Bei einem bereits gekündigten Abonnement musst du es zuerst wieder aufnehmen, bevor du es änderst.

Wenn du weniger Plätze auswählst, als du aktuell Bankkonten verbunden hast, zeigt die App einen Hinweis. Vergleiche vor einer Reduzierung auch die enthaltenen Integrationen und weiteren Leistungen mit deiner Nutzung.

Die Abrechnung einer Änderung siehst du im nächsten Schritt. Prüfe dort den Betrag und den Zeitpunkt, zu dem die Änderung wirksam wird.

## Rechnungen und Zahlungsdaten verwalten

1. Öffne im **Dashboard** den Eintrag **Abrechnung verwalten**. Du erreichst ihn auch unter **Workspace Einstellungen → Abrechnung & Pläne**.
2. Die App öffnet das Abrechnungsportal in einem neuen Fenster.
3. Rufe dort deine Rechnungen auf oder bearbeite die angebotenen Zahlungs- und Rechnungsinformationen.

Die Schaltfläche ist verfügbar, sobald für den Workspace ein entsprechender Abrechnungszugang besteht. Bei individuell verwalteten oder durch Partner bereitgestellten Workspaces können die Optionen abweichen.

## Ein Abonnement kündigen

1. Öffne **Abonnement verwalten**.
2. Klicke unter **Aktuelles Abonnement und Verbrauch** auf **Abonnement kündigen**.
3. Bestätige den Hinweis mit **Abonnement kündigen**.
4. Schließe die Kündigung im geöffneten Abrechnungsportal ab und prüfe dort das angezeigte Enddatum.

Der Kündigungsdialog nennt das Ende des Abrechnungszeitraums als Kündigungstermin. Der erste Klick in der App öffnet den Vorgang; die Bestätigung im Abrechnungsportal gehört noch dazu.

Nach einer Kündigung zeigt die Abonnementseite einen Hinweis mit einer Aktion zum Wiederaufnehmen. Darüber öffnest du das Portal erneut.

## Ein von einem Partner verwaltetes Abonnement

Wenn dein Workspace von einem Partner bereitgestellt wird, erscheint unter **Abrechnung & Pläne** der Hinweis **Von Partner verwaltet** mit den Partnerinformationen. Wende dich bei Fragen zum gebuchten Umfang und zur Abrechnung an diesen Partner.

Die Verwaltung eines eigenen Partner-Workspaces ist unter [Partner-Workspaces verwalten](https://docs.kontoflux.io/workspaces-and-account-management/partner-workspaces/) beschrieben.

---

<!-- https://docs.kontoflux.io/workspaces-and-account-management/benachrichtigungen/ -->

# Benachrichtigungen einrichten

Mit Benachrichtigungen erfährt dein Team, wenn zum Beispiel eine Bankverbindung erneuert werden muss oder eine Synchronisierung fehlgeschlagen ist. Du legst für jedes Ereignis fest, ob es gemeldet wird, wer es erhält und welcher Kanal verwendet wird.

Du brauchst die Rolle **Administrator**, um diese Einstellungen für den Workspace zu verwalten.

## Ein Ereignis auswählen

1. Öffne das **Dashboard** des gewünschten Workspaces.
2. Klicke im Bereich **Workspace** auf **Benachrichtigungen verwalten**.
3. Wähle ein Ereignis aus der Liste.

Die Ereignisse sind nach Bereichen geordnet. Jeder Eintrag zeigt eine Beschreibung, die Dringlichkeit und den Status **Aktiv** oder **Deaktiviert**. Bei aktiven Einträgen siehst du außerdem eine Vorschau der ausgewählten Mitglieder.

Über den Schalter in der Liste kannst du eine Benachrichtigung direkt aktivieren oder deaktivieren. Diese Änderung wird sofort gespeichert. In der Detailansicht speicherst du Änderungen mit **Speichern**.

## Empfänger festlegen

Wähle in der Detailansicht unter **Empfänger** eine der drei Möglichkeiten:

| Auswahl | Wer die Benachrichtigung erhält |
| --- | --- |
| **Alle** | Alle Mitglieder des Workspaces |
| **Nach Rolle** | Mitglieder der ausgewählten Rollen; mehrere Rollen sind möglich |
| **Bestimmte Nutzer** | Die Mitglieder, die du unter **Bestimmte Nutzer auswählen** auswählst |

Bei **Nach Rolle** kannst du beispielsweise **Admin** und **Banking** für Hinweise zur Bankverbindung auswählen. Für Probleme mit Integrationen sind **Admin** und **Integrator** passende Ansprechpartner.

Prüfe die angezeigten Namen. Eine Rolle ohne Mitglieder ergibt keine Empfänger. Die Auswahl gilt jeweils für das geöffnete Ereignis.

## E-Mail als Kanal verwenden

Aktiviere unter **Übermittlungskanäle** den Schalter **E-Mail**. Die Benachrichtigung wird an die ausgewählten Mitglieder geschickt. Klicke anschließend auf **Speichern**.

Die Empfänger stellst du hier pro Ereignis ein. Eine Änderung an der Kontaktadresse des Workspaces ersetzt diese Auswahl nicht.

## Einen Webhook als Kanal verwenden

Ein Webhook sendet die Meldung an eine URL, die du oder dein Dienstleister bereitstellt. So kannst du beispielsweise ein eigenes Meldesystem anbinden.

1. Aktiviere unter **Übermittlungskanäle** den Schalter **Webhook**.
2. Trage unter **Webhook URL** die Zieladresse ein. Sie muss mit `https://` beginnen und öffentlich erreichbar sein.
3. Falls das Ziel zusätzliche Angaben zur Anmeldung benötigt, öffne **Erweiterte Webhook-Einstellungen → HTTP-Header**.
4. Klicke auf **Header hinzufügen** und trage **Header-Schlüssel** und **Header-Wert** ein.
5. Klicke auf **Speichern**.

Du kannst **E-Mail** und **Webhook** gleichzeitig aktivieren. Dieser Webhook übermittelt das ausgewählte Ereignis des Workspaces. Für die Übertragung von Bankdaten findest du die separate Anleitung unter [Webhooks](https://docs.kontoflux.io/integrationen/webhooks/).

## Benachrichtigungen gezielt auswählen

Prüfe zuerst Ereignisse, bei denen jemand handeln muss: zum Beispiel eine ablaufende Bankzustimmung, einen fehlgeschlagenen Import oder eine fehlgeschlagene Integrations-Synchronisierung. Ergänze anschließend die Erfolgsmeldungen, die dein Team wirklich braucht.

Die App übernimmt zunächst die hinterlegten Vorgaben für jedes Ereignis. Verlasse dich deshalb nicht darauf, dass alle Ereignisse aktiv sind oder immer dieselben Empfänger haben.

## Wenn eine Meldung fehlt

Prüfe die Einstellungen des betreffenden Ereignisses:

1. Ist die Benachrichtigung **Aktiv**?
2. Sind die gewünschten Mitglieder unter **Empfänger** ausgewählt?
3. Ist der benötigte Kanal eingeschaltet?
4. Hast du Änderungen in der Detailansicht mit **Speichern** übernommen?
5. Bei E-Mail: Liegt die Nachricht im Spamordner? Bei Webhooks: Ist die Zieladresse erreichbar und stimmen die Header?

Mit **Abbrechen** verlässt du die Detailansicht ohne die dortigen Änderungen zu speichern.

---

<!-- https://docs.kontoflux.io/workspaces-and-account-management/partner-workspaces/ -->

# Partner-Workspaces verwalten

In einem als Partner-Workspace eingerichteten Workspace kannst du Lizenzen an Kunden-Workspaces vergeben und eigene Supportinformationen hinterlegen. Die zusätzlichen Bereiche erscheinen unter **Workspace Einstellungen**, sobald der Workspace als Partner eingerichtet ist.

Du brauchst Administratorzugriff auf den Partner-Workspace. Wenn dein eigener Workspace lediglich von einem Partner verwaltet wird, findest du dessen Kontakt unter [Abrechnung & Pläne](https://docs.kontoflux.io/workspaces-and-account-management/abrechnung-und-abonnements/#ein-von-einem-partner-verwaltetes-abonnement).

## Das Partner-Profil vervollständigen

1. Öffne **Workspace Einstellungen → Partner-Profil**.
2. Ergänze im **Firmenprofil** den Firmennamen, die **Support-URL** und die Anschrift einschließlich Land.
3. Ergänze bei Bedarf eine Beschreibung.
4. Hinterlege unter **Support-Kontakt** die Support-URL und Support-E-Mail für deine Kunden.
5. Klicke auf **Speichern**.

Ein vollständiges Firmenprofil ist Voraussetzung dafür, Kunden-Workspaces bereitzustellen. Die App zeigt einen Hinweis, wenn Angaben fehlen.

## Verfügbare Lizenzen prüfen

Öffne **Bereitstellung**. Der **Lizenz-Pool** zeigt die Werte **Lizenzen gesamt**, **Zugewiesen** und **Verfügbar**.

Über **Lizenzen verwalten** öffnest du das Abrechnungsportal für deine Partnerlizenzen. Wenn noch keine Lizenzen vorhanden sind, bietet die Seite **Lizenzen kaufen** an.

## Einen Kunden-Workspace bereitstellen

1. Öffne **Bereitstellung**.
2. Prüfe, ob freie Lizenzen im Pool vorhanden sind.
3. Klicke bei Bedarf unter **Neuen Arbeitsbereich bereitstellen** auf **Verfügbare Arbeitsbereiche finden**.
4. Wähle den gewünschten Workspace aus der Liste. Du musst Mitglied dieses Workspaces sein, damit er zur Auswahl stehen kann.
5. Trage unter **Zuzuweisende Lizenzen** die gewünschte Anzahl ein.
6. Klicke auf **Arbeitsbereich bereitstellen**.

Der Workspace erscheint anschließend unter **Bereitgestellte Arbeitsbereiche** mit der zugewiesenen Anzahl und dem Bereitstellungsdatum.

## Eine Zuweisung ändern

Klicke in der Liste **Bereitgestellte Arbeitsbereiche** auf das Stiftsymbol neben einem Workspace. Passe die Anzahl an und bestätige sie mit dem Häkchen. Die mögliche Erhöhung hängt von den noch verfügbaren Lizenzen ab.

Über das Papierkorbsymbol öffnest du den Dialog zum Beenden der Bereitstellung. Prüfe dessen Hinweis, bevor du bestätigst: Die Partnerverwaltung und das zugewiesene Kontingent dieses Kunden-Workspaces werden dadurch geändert.

## Das Erscheinungsbild der Quick-Pages anpassen

Unter **Whitelabeling** kannst du die kompakten Quick-Pages mit deinem eigenen Erscheinungsbild versehen.

1. Aktiviere **Whitelabeling aktivieren**.
2. Hinterlege bei Bedarf die **Quick-Pages Logo-URL** sowie Logo-URLs für den hellen und dunklen Modus.
3. Wähle **Primärfarbe**, **Hintergrundfarbe** und **Akzentfarbe**.
4. Ergänze bei Bedarf einen **Fußzeilen-Text**.
5. Klicke auf **Speichern** und prüfe das Ergebnis über **Quick-Actions Vorschau öffnen**.

Die **App-Bezeichnung** lässt sich auch ohne aktiviertes Whitelabeling einstellen. Sie bestimmt den angezeigten Text im Abonnement-Label.

---

<!-- https://docs.kontoflux.io/konten-anbinden/bankkonten-hinzufugen/ -->

# Bankkonten hinzufügen

Du verbindest deine Bank mit einem Workspace. Prüfe deshalb vor dem Start den Workspace-Namen: Dort werden die Konten und Umsätze anschließend angezeigt.

## Konto verbinden

1. Melde dich in der [Kontoflux.io App](https://app.kontoflux.io) an und öffne den gewünschten Workspace.
2. Wähle **Bankkonten** und anschließend **Bankkonto hinzufügen**.
3. Suche nach dem Namen, der BIC oder der BLZ deiner Bank. Die Suche startet ab drei Zeichen.
4. Wähle den passenden Eintrag aus. Vergleiche bei ähnlichen Namen die Bankdaten.
5. Folge dem Bank-Login über finAPI. Führe die angeforderten Anmelde- und Freigabeschritte aus und wähle die gewünschten Konten, wenn das Formular eine Auswahl anbietet.
6. Warte, bis der Vorgang abgeschlossen ist. Prüfe danach die Konten unter **Bankkonten** und die importierten Buchungen unter **Transaktionen**.

## Wenn sich ein neuer Tab öffnet

Das Bank-Login kann im Fenster von Kontoflux.io oder in einem eigenen Tab erscheinen. Wird **Bank-Login öffnen** angezeigt, öffne damit den neuen Tab und schließe dort den Vorgang ab. Lass das ursprüngliche Fenster geöffnet; es verfolgt den Abschluss automatisch.

Wenn das Bank-Login nicht abgeschlossen werden konnte, zeigt Kontoflux.io eine Fehlermeldung. Mit **Erneut versuchen** kannst du den Vorgang erneut starten, sofern diese Aktion angeboten wird.

## Nach dem Verbinden

Unter **Bankkonten** siehst du deine Konten nach Bank gruppiert. Klappe ein Konto auf, um den Kontoinhaber und den Zeitpunkt der letzten Aktualisierung zu prüfen.

Die erfolgreiche Anmeldung und der Import der Umsätze sind getrennte Schritte. Wenn noch keine Buchungen sichtbar sind, prüfe zunächst den Verbindungsstatus und die [Aktualität der Daten](https://docs.kontoflux.io/limitationen-and-sonderfalle/aktualitat-der-daten/).

## Deine Bank wird nicht gefunden

Probiere zusätzlich zum Namen die BIC oder BLZ. Erscheint weiterhin kein passender Eintrag, kläre die Verfügbarkeit mit dem Support. Wähle nur einen Eintrag, der zu deiner Bank gehört.

Für einen direkten Einstieg aus einer anderen Anwendung kannst du auch den [Quick-Connect-Link](https://docs.kontoflux.io/konten-anbinden/quick-connect/) deines Workspaces verwenden.

---

<!-- https://docs.kontoflux.io/konten-anbinden/bankkonten-verwalten/ -->

# Bankkonten verwalten

Unter **Bankkonten** siehst du die verbundenen Konten nach Bank gruppiert. Jede Kontozeile zeigt unter anderem Kontoname, Kontostand, Kontotyp und Verbindungsstatus.

## Kontoinformationen öffnen

Klicke auf eine Kontozeile, um sie aufzuklappen. Dort findest du den Kontoinhaber, die IBAN und zwei Zeitangaben:

- **Zuletzt aktualisiert**: Zeitpunkt der letzten erfolgreichen Aktualisierung.
- **Letzter Aktualisierungs-Versuch**: Zeitpunkt des letzten Versuchs. Dieser kann neuer sein, auch wenn die Aktualisierung nicht erfolgreich war.

Wenn ein Ablaufdatum vorliegt, erscheint es bei der Bank unter **Verbindung läuft ab am**.

## Den Status einordnen

| Anzeige | Nächster Schritt |
| --- | --- |
| **Verbindung aktiv** | Prüfe bei fehlenden Buchungen den Aktualisierungszeitpunkt. |
| **Empfange Transaktionen...** | Warte, bis der laufende Abruf abgeschlossen ist. |
| **Authentifizierung erforderlich** | Schließe die angeforderte Freigabe im Bank-Login ab. |
| **Verbindung wird erneut versucht** | Prüfe den Status später erneut. |
| **Verbindung muss aktualisiert werden** | Öffne **Neu autorisieren** und folge dem Bank-Login. |
| **Neuverbindung erforderlich** | Verwende **Jetzt neu verbinden**. |

## Eine Freigabe erneuern

1. Öffne **Bankkonten** und suche die betroffene Bank.
2. Klicke auf **Neu autorisieren**. Die Aktion ist auch im Drei-Punkte-Menü der Bank verfügbar.
3. Falls ein Bank-Login erscheint, schließe die angeforderten Schritte ab.
4. Warte auf die Rückmeldung. Sie zeigt an, ob neue Umsätze importiert wurden oder ob der Vorgang noch läuft.

Wird bereits ein offenes Formular angezeigt, nutze **Zugangsdaten aktualisieren**, um dort weiterzumachen.

Bei **Die Aktualisierung läuft im Hintergrund weiter** musst du keinen zweiten Vorgang starten. Prüfe nach einigen Minuten den Kontostatus und die Transaktionen erneut.

## Eine Bank neu verbinden

Wenn der bisherige Zugangsweg nicht mehr verfügbar ist, erscheint **Neuverbindung erforderlich**.

1. Klicke auf **Jetzt neu verbinden**.
2. Lies den Hinweis und bestätige mit **Neu verbinden**.
3. Schließe das Bank-Login für dieselbe Bank ab und wähle die bisherigen Konten wieder aus, sofern das Formular eine Auswahl anbietet.
4. Prüfe anschließend Konten und Transaktionen.

Die alte Verbindung wird entfernt. Die bisherigen Konten, Transaktionen und Übertragungsverläufe werden dabei archiviert. Erkennt Kontoflux.io die erneut verbundenen Konten beim Import wieder, ordnet es ihnen die archivierten Daten automatisch zu. Bis dahin erscheinen diese Daten nicht in der normalen Konto- und Transaktionsliste.

Brichst du die Neuverbindung ab, kannst du sie später über **Bankkonto hinzufügen** fortsetzen.

## Ein Konto oder eine Bank entfernen

Für ein einzelnes Konto klappst du die Kontozeile auf und wählst **Konto entfernen**. Für die gesamte Bankverbindung öffnest du das Drei-Punkte-Menü der Bank und wählst **Bank entfernen**. Bestätige den jeweiligen Dialog erst, nachdem du Konto oder Bank geprüft hast.

Auch beim Entfernen werden die zugehörigen Daten archiviert. Die Verbindung wird getrennt und das Konto verschwindet aus der aktiven Übersicht. Wenn du es später erneut verbindest und es wiedererkannt wird, können die bisherigen Daten wieder zugeordnet werden.

Wenn nach einer Neuverbindung weiterhin Daten fehlen, prüfe das [Ereignisprotokoll](https://docs.kontoflux.io/hilfe/ereignisprotokoll/) und den [Importstatus](https://docs.kontoflux.io/limitationen-and-sonderfalle/aktualitat-der-daten/).

---

<!-- https://docs.kontoflux.io/konten-anbinden/quick-connect/ -->

# Quick Connect

Quick Connect führt direkt zur Bankanbindung eines bestimmten Workspaces. Das ist praktisch, wenn du den Einstieg in einer anderen Anwendung verlinken oder an die Person weitergeben möchtest, die eure Bankkonten betreut.

Der Link setzt eine Anmeldung bei Kontoflux.io und Zugriff auf den Workspace voraus. Das Teilen des Links vergibt keine Mitgliedschaft oder zusätzlichen Rechte.

## Link kopieren und verwenden

1. Öffne das **Dashboard** des gewünschten Workspaces.
2. Kopiere den Link aus dem Bereich **Quick Connect Link**.
3. Öffne den Link oder hinterlege ihn in deiner Anwendung.
4. Prüfe auf der Startseite den angezeigten Workspace-Namen und wähle **Fortfahren**.
5. Suche deine Bank, wähle sie aus und schließe das Bank-Login ab.
6. Nach **Konto erfolgreich verbunden!** kannst du das Fenster schließen und die Konten im Workspace prüfen.

Falls du dich zuerst anmelden musst, führt dich die App anschließend zum aufgerufenen Link zurück.

## Die Banksuche vorbereiten

Du kannst dem Link einen Suchwert mitgeben. Verwende die Parameternamen in Kleinbuchstaben.

| Parameter | Suchwert |
| --- | --- |
| `iban` | IBAN eines Kontos bei der gesuchten Bank |
| `bic` | BIC der Bank |
| `blz` | Bankleitzahl |
| `bankname` | Name der Bank |

Ein Link mit vorbereitetem Banknamen sieht zum Beispiel so aus:

```text
https://app.kontoflux.io/DEINE-WORKSPACE-ID/quick-connect?bankname=Sparkasse
```

Ersetze `DEINE-WORKSPACE-ID` durch die ID aus deinem kopierten Link. Leerzeichen im Banknamen schreibst du in der URL als `%20`.

Gib möglichst nur einen Suchwert an. Sind mehrere vorhanden, verwendet Quick Connect zuerst die IBAN, danach BIC, BLZ und Bankname. Ein einzelner Treffer wird direkt ausgewählt; bei mehreren Treffern wählst du die Bank selbst. Mit **Zur Banksuche** kannst du die Suche ändern.

Der Suchwert bereitet die Auswahl der Bank vor. Die Anmeldung und Freigabe im Bank-Login bleiben erforderlich.

## Ungültiger Link oder fehlender Zugriff

Prüfe, ob der Link vollständig ist und du mit dem richtigen Benutzerkonto angemeldet bist. Bei fehlendem Workspace-Zugriff muss ein berechtigtes Teammitglied dich zuerst einladen.

---

<!-- https://docs.kontoflux.io/konten-anbinden/demokonto-zum-testen/ -->

# Mit einem Demokonto testen

Ein Demokonto hilft dir, die Bankanbindung und die Arbeit mit Umsätzen kennenzulernen. Ob ein Demo- oder Testzugang verfügbar ist, siehst du in der Banksuche.

## Verfügbarkeit prüfen

1. Öffne im gewünschten Workspace **Bankkonten**.
2. Wähle **Bankkonto hinzufügen**.
3. Suche nach `Demo` oder `Test`.
4. Wenn ein passender Testzugang erscheint, öffne ihn und folge den dort angegebenen Schritten.

Die benötigten Test-Zugangsdaten richten sich nach dem angebotenen Zugang. Wenn kein passender Eintrag erscheint oder dir die Zugangsdaten fehlen, frage den Support nach einer aktuellen Testmöglichkeit.

## Den Ablauf kennenlernen

Nach einer erfolgreichen Verbindung kannst du unter **Bankkonten** den Status prüfen. Unter **Transaktionen** kannst du ein Konto auswählen, [Spalten anpassen](https://docs.kontoflux.io/transaktionen/spalten-anpassen/) und [Buchungen kopieren](https://docs.kontoflux.io/transaktionen/kopieren-und-weitergeben/).

Prüfe vor einer Weitergabe an eine Integration oder einen Webhook das Ziel. Auch Testumsätze können über diese Aktionen an die verbundene Anwendung gesendet werden.

---

<!-- https://docs.kontoflux.io/konten-anbinden/paypal-anbinden/ -->

# PayPal anbinden

Für PayPal nutzt du dieselbe Suche wie für eine Bankverbindung. Welche PayPal-Zugänge dir zur Verfügung stehen, zeigt die aktuelle Trefferliste.

## Verbindung einrichten

1. Öffne im passenden Workspace **Bankkonten** und wähle **Bankkonto hinzufügen**.
2. Suche nach `PayPal`.
3. Wähle den passenden Zugang aus der Trefferliste.
4. Folge den Anweisungen im Verbindungsformular und schließe die angeforderten Freigaben ab.
5. Prüfe das verbundene Konto unter **Bankkonten** und seine Buchungen unter **Transaktionen**.

Wenn kein passender Zugang erscheint, kläre die Verfügbarkeit mit dem Support. Die Auswahl und die benötigten Angaben richten sich nach dem angebotenen Zugang.

## Kontodaten prüfen

Prüfe vor der Weitergabe an eine andere Anwendung, welche Angaben bei deinem Konto und deinen Buchungen tatsächlich gefüllt sind.

Bei Konten ohne IBAN zeigt die Kontoübersicht stattdessen die übermittelte Kontonummer. Auch die Spalte **Gegenpartei IBAN** verwendet die Kontonummer als Ersatz, wenn keine IBAN vorliegt. Du kannst **Gegenpartei Kontonummer** zusätzlich als eigene Spalte einblenden.

Lege deine Feldzuordnung in einer Integration anhand dieser Daten fest. Eine leere IBAN allein bedeutet nicht, dass der Import fehlgeschlagen ist. Mehr dazu unter [Datenfelder verstehen](https://docs.kontoflux.io/limitationen-and-sonderfalle/sonderfalle-datenfelder-und-banken/).

---

<!-- https://docs.kontoflux.io/transaktionen/umsatze-ansehen/ -->

# Umsätze ansehen

Unter **Transaktionen** findest du die importierten Umsätze deines Workspaces. Die Tabelle zeigt Betrag, Verwendungszweck, Buchungsdatum und Angaben zur Gegenpartei. Welche Spalten du siehst, kannst du selbst einstellen.

## Ein Konto auswählen

1. Öffne **Transaktionen** im gewünschten Workspace.
2. Wähle bei **Konto** das Konto aus, dessen Buchungen du sehen möchtest.
3. Klicke unter der Tabelle auf **Mehr laden**, um weitere Buchungen abzurufen.

Wenn du das Konto wechselst, lädt die Tabelle die Buchungen für diese Auswahl neu.

## Eine Buchung genauer prüfen

Nutze die Spalten **Verwendungszweck**, **Gegenpartei Name** und **Buchungsdatum Bank**, um eine Buchung zuzuordnen. Für weitere Angaben kannst du zum Beispiel **Wertstellungsdatum**, **Gegenpartei Kontonummer** oder **Typ** einblenden.

Ziehe eine Spalte breiter, wenn ein langer Buchungstext zu wenig Platz hat. Mit einem Rechtsklick auf eine Zelle kannst du ihren Wert kopieren.

Die Anleitungen [Spalten anpassen](https://docs.kontoflux.io/transaktionen/spalten-anpassen/) und [Datenfelder verstehen](https://docs.kontoflux.io/limitationen-and-sonderfalle/sonderfalle-datenfelder-und-banken/) helfen dir bei der Auswahl und Einordnung der Angaben.

## Es werden keine Buchungen angezeigt

Prüfe zuerst, ob du im richtigen Workspace bist und das gewünschte Konto ausgewählt hast. Sind noch gar keine Umsätze vorhanden, verbinde ein Bankkonto und warte auf den Import.

Ist das Konto schon verbunden, prüfe unter **Bankkonten** den Status und den Zeitpunkt der letzten erfolgreichen Aktualisierung. Folge bei Bedarf der Anleitung [Fehlende oder veraltete Umsätze](https://docs.kontoflux.io/limitationen-and-sonderfalle/aktualitat-der-daten/).

## Mit Buchungen weiterarbeiten

Du kannst einzelne Werte oder mehrere Zeilen kopieren und in eine Tabelle einfügen. Über das Kontextmenü lassen sich Buchungen außerdem an aktive Integrationen und Webhooks senden. Die Schritte findest du unter [Kopieren und weitergeben](https://docs.kontoflux.io/transaktionen/kopieren-und-weitergeben/).

---

<!-- https://docs.kontoflux.io/transaktionen/spalten-anpassen/ -->

# Spalten anpassen

Passe die Transaktionsliste an die Angaben an, die du im Alltag brauchst. Kontoflux.io speichert deine Auswahl, die Reihenfolge und die Spaltenbreiten als persönliche Einstellung für diese Ansicht.

## Spalten ein- und ausblenden

1. Öffne **Transaktionen**.
2. Öffne die Auswahl neben **Spalten**.
3. Wähle die Felder aus, die du in der Tabelle sehen möchtest.

Zur Auswahl stehen **Betrag**, **Verwendungszweck**, **Buchungsdatum Bank**, **Wertstellungsdatum**, **Buchungsdatum finAPI**, **Gegenpartei Name**, **Gegenpartei IBAN**, **Gegenpartei Kontonummer**, **Kategorie**, **Währung** und **Typ**.

Ein hilfreicher Ausgangspunkt sind Betrag, Buchungsdatum, Verwendungszweck und Gegenpartei. Für einen Vergleich von Buchungs- und Wertstellungsdatum blendest du beide Datumsspalten ein.

## Reihenfolge ändern

Klicke neben der Spaltenauswahl auf **Reihenfolge**. Im geöffneten Menü kannst du die Einträge am Griff an die gewünschte Position ziehen.

Am Computer kannst du die Spalten auch direkt in der Tabellenüberschrift am Griff verschieben.

## Spalten breiter oder schmaler machen

Ziehe am rechten Rand einer Tabellenüberschrift, bis die Spalte die gewünschte Breite hat. Für längere Verwendungszwecke lohnt sich meist mehr Platz als für Betrag oder Datum.

## Die Ansicht fürs Kopieren vorbereiten

Beim Kopieren einer Zeile verwendet Kontoflux.io die sichtbaren Spalten in ihrer aktuellen Reihenfolge. Richte die Ansicht deshalb vorher passend zu deiner Zieltabelle ein. Die Kopfzeile kannst du separat kopieren.

Weiter zu [Kopieren und weitergeben](https://docs.kontoflux.io/transaktionen/kopieren-und-weitergeben/).

---

<!-- https://docs.kontoflux.io/transaktionen/kopieren-und-weitergeben/ -->

# Kopieren und weitergeben

Für die Übernahme in Excel, Google Sheets oder eine andere Tabelle kannst du Umsätze in die Zwischenablage kopieren. Die Kopier- und Sendeaktionen öffnest du am Computer mit einem Rechtsklick in der Transaktionsliste.

## Einen Wert oder eine Zeile kopieren

1. Öffne **Transaktionen** und suche die gewünschte Buchung.
2. Klicke mit der rechten Maustaste auf eine Zelle.
3. Wähle die Aktion für den einzelnen Wert, zum Beispiel **Verwendungszweck kopieren**, oder **Zeile kopieren** für alle sichtbaren Spalten.
4. Füge den Inhalt in deiner Zieltabelle ein.

Die Werte einer kopierten Zeile sind durch Tabulatoren getrennt. Tabellenprogramme können sie dadurch auf mehrere Spalten verteilen. Passe vorher die [Spaltenauswahl und Reihenfolge](https://docs.kontoflux.io/transaktionen/spalten-anpassen/) an deine Zieltabelle an.

Mit einem Rechtsklick auf eine Tabellenüberschrift und **Kopfzeile kopieren** übernimmst du zusätzlich die Spaltennamen.

## Mehrere Buchungen kopieren

1. Lade mit **Mehr laden** zuerst die benötigten Buchungen.
2. Markiere die gewünschten Zeilen über die Kontrollkästchen. Das Kästchen in der Kopfzeile wählt alle aktuell geladenen Buchungen aus.
3. Klicke mit der rechten Maustaste auf eine der markierten Zeilen.
4. Wähle **Ausgewählte kopieren** und füge den Inhalt in deiner Zieltabelle ein.

Am Computer kannst du einen zusammenhängenden Bereich auch mit gedrückter Maustaste markieren. Mit **Auswahl aufheben** im Kontextmenü entfernst du die Markierung wieder.

> [!NOTE]
> Die Auswahl umfasst die geladenen Zeilen. Buchungen, die du noch nicht mit **Mehr laden** abgerufen hast, werden dadurch nicht automatisch mitkopiert.

Wenn sich eine ganze Zeile nicht kopieren lässt, probiere einen einzelnen Wert. Blende für einen erneuten Versuch Spalten aus, die bei den betroffenen Buchungen leer sind.

## Eine Buchung direkt senden

1. Klicke mit der rechten Maustaste auf die gewünschte Buchung.
2. Öffne **Senden an**.
3. Wähle unter **Integrationen** oder **Webhooks** das gewünschte aktive Ziel aus.
4. Prüfe die Rückmeldung zur Übertragung und bei Bedarf den passenden Eintrag im [Protokoll](https://docs.kontoflux.io/hilfe/ereignisprotokoll/).

Diese Aktion stößt die tatsächliche Weitergabe an. Prüfe deshalb vorher, ob du die richtige Buchung und das richtige Ziel ausgewählt hast.

Für mehrere markierte Buchungen kannst du über **Auswahl senden an** einen aktiven Webhook auswählen. Wenn kein Ziel verfügbar ist, prüfe, ob die benötigte Integration oder der Webhook eingerichtet und aktiv ist.

---

<!-- https://docs.kontoflux.io/integrationen/direkt-integrationen/ -->

# Integrationen und Automationen

Unter **Automationen** richtest du ein, wie andere Anwendungen mit deinen Daten aus Kontoflux.io arbeiten. Die Einstellungen gehören immer zum ausgewählten Workspace.

## Welcher Weg passt zu dir?

| Du möchtest … | Dafür verwendest du … |
| --- | --- |
| Konten und Transaktionen in Ninox übernehmen | die [Ninox-Integration](https://docs.kontoflux.io/integrationen/ninox/) mit Tabellen- und Feldzuordnung |
| einem KI-Client Zugriff auf Konten und Transaktionen geben | einen [MCP-Server](https://docs.kontoflux.io/integrationen/mcp-server/) |
| eine Anwendung über einen Anmeldedialog autorisieren | einen [OAuth2 Server](https://docs.kontoflux.io/integrationen/oauth-apps/) |
| neue Daten an eine Empfangsadresse schicken | [Webhooks](https://docs.kontoflux.io/integrationen/webhooks/) |
| Bankdaten aus einem eigenen Skript abrufen | einen [API-Schlüssel](https://docs.kontoflux.io/api/zugang-zur-api/) |

Zum Einrichten und Ändern von Integrationen brauchst du die Workspace-Rolle **Eigentümer** oder **Integrator**.

## Integration hinzufügen

1. Wähle den gewünschten Workspace.
2. Öffne **Automationen → Integrationen**.
3. Klicke auf einen freien Integrationsplatz und wähle **Ninox**, **MCP-Server** oder **OAuth2 Server**.
4. Gib der Integration einen Namen, an dem du ihren Zweck erkennst, etwa „Ninox Buchhaltung“.
5. Schließe die Einrichtung auf der Detailseite ab und prüfe den Aktivierungsstatus.

Die Übersicht zeigt, wie viele Integrationsplätze dein Workspace verwenden kann. **Webhooks** und **API** haben eigene Tabs.

## Integrationen verwalten

Öffne eine Integration, um ihre Konfiguration zu ändern. Über das Menü an ihrem Eintrag kannst du sie aktivieren, deaktivieren oder löschen. Eine noch nicht fertig eingerichtete Ninox-Integration lässt sich erst nach Abschluss der Einrichtung aktivieren.

Für mehrere Workspaces kannst du eine [Ninox-Konfiguration übertragen](https://docs.kontoflux.io/integrationen/konfiguration-uebertragen/). Zugangsdaten richtest du im Ziel-Workspace separat ein.

## Abruf und Übertragung unterscheiden

Die Bankverbindung liefert Daten an Kontoflux.io. Eine Ninox-Synchronisation überträgt den vorhandenen Stand weiter an Ninox. API und MCP lesen die in Kontoflux.io verfügbaren Daten. Wenn Umsätze fehlen, prüfe deshalb zuerst, ob sie bereits unter **Transaktionen** zu sehen sind.

---

<!-- https://docs.kontoflux.io/integrationen/ninox/ -->

# Ninox einrichten

Die Ninox-Integration überträgt Kontodaten und Transaktionen aus deinem Workspace in eine Ninox-Datenbank. Du legst fest, welche Tabellen und Felder dafür verwendet werden.

## Vorbereiten

Du brauchst einen Ninox API Key mit Zugriff auf das gewünschte Team und die Datenbank. Lege die Zieltabellen und ihre Felder vorher in Ninox an. Du kannst eine Konto-Tabelle, eine Transaktionen-Tabelle oder beide verwenden.

Wenn du beide Tabellen verknüpfen möchtest, lege auch die passenden Referenzfelder in Ninox an. Ein Textfeld mit dem Kontonamen ersetzt keine Tabellenverknüpfung.

## 1. Zugang zu Ninox einrichten

1. Öffne **Automationen → Integrationen** und füge **Ninox** hinzu.
2. Trage deinen Schlüssel unter **Ninox API Key** ein.
3. Für eine Ninox Private Cloud oder eine eigene Installation trägst du zusätzlich die passende Basisadresse unter **Custom API Base** ein. Für die reguläre Ninox Cloud lässt du das Feld leer.
4. Klicke auf **Weiter**. Kontoflux.io prüft den Zugang.
5. Wähle **Manuell konfigurieren**. Wenn du bereits eine exportierte Konfiguration hast, verwende stattdessen [**Konfiguration hochladen**](https://docs.kontoflux.io/integrationen/konfiguration-uebertragen/).

Wird der Schlüssel als ungültig gemeldet, prüfe ihn und seinen Zugriff auf das Ninox-Team. Bei einem abgelaufenen gespeicherten Schlüssel gibst du einen neuen ein.

## 2. Team, Datenbank und Tabellen wählen

1. Wähle zuerst **Team**, danach **Datenbank** und klicke auf **Weiter**.
2. Wähle unter **Konto-Tabelle** die Tabelle für Kontoname, IBAN und Kontostand.
3. Wähle unter **Transaktionen-Tabelle** die Tabelle für einzelne Umsätze.
4. Klicke auf **Weiter**. Mindestens eine Tabelle muss gewählt sein.

Neu angelegte Tabellen kannst du über die Schaltfläche zum Neuladen der Tabellen einlesen.

## 3. Felder zuweisen

Unter **Zuweisung der Ninox Felder** wählst du für jedes Ziel-Feld aus, welcher Wert aus Kontoflux.io dort ankommen soll. Prüfe automatische Vorschläge, bevor du fortfährst.

Eine einfache Zuordnung kann so aussehen:

| Feld in deiner Ninox-Tabelle | Wert aus Kontoflux.io |
| --- | --- |
| Kontoname in der Konto-Tabelle | **Kontoname** |
| IBAN in der Konto-Tabelle | **IBAN** |
| Saldo in der Konto-Tabelle | **Kontostand** |
| Umsatz-ID in der Transaktionen-Tabelle | **ID** |
| Betrag in der Transaktionen-Tabelle | **Betrag** |
| Buchungstext in der Transaktionen-Tabelle | **Verwendungszweck** |
| Datum in der Transaktionen-Tabelle | **Wertstellungsdatum** |
| Geschäftspartner in der Transaktionen-Tabelle | **Empfänger / Sender Name** |
| Kontoverknüpfung in der Transaktionen-Tabelle | **Referenz auf Kontotabelle** |

Verwende in Ninox passende Feldtypen: Zahlen für Beträge, Datumsfelder für Daten und Referenzfelder für Verknüpfungen. Mit **Feld ignorieren** lässt du ein Ziel-Feld ohne Zuordnung.

Die **ID** ist die Kennung der Transaktion in Kontoflux.io. Lege dafür ein eigenes Feld an; verwechsle sie nicht mit der internen Datensatznummer von Ninox.

Wenn du während der Einrichtung Felder in Ninox ergänzt, lade die Feldliste neu und prüfe die Zuordnung erneut. Schließe den Schritt mit **Weiter** ab.

## 4. Übertragung prüfen und aktivieren

1. Prüfe die fertige Konfiguration unter **Einstellungen**.
2. Führe bei Bedarf einen [**Testlauf Synchronisation**](https://docs.kontoflux.io/konten-synchronisieren/testen-und-reparieren/) aus. Er zeigt die geplante Übertragung ohne Daten zu schreiben.
3. Aktiviere die Integration über **Aktiv Status**.
4. Starte die [erste manuelle Synchronisation](https://docs.kontoflux.io/konten-synchronisieren/manuelle-synchronisation/).
5. Prüfe in Ninox Beträge, Datumswerte und Verknüpfungen. Richte danach bei Bedarf einen [Zeitplan](https://docs.kontoflux.io/konten-synchronisieren/automatische-synchronisation/) ein.

**Testdaten senden** verschickt dagegen Beispieldaten an Ninox. Dabei können dort Datensätze entstehen. Verwende diese Funktion gezielt, wenn du die tatsächliche Verarbeitung testen möchtest.

## Konfiguration später ändern

Öffne **Konfiguration ändern**, wenn du ein anderes Team, eine Datenbank, Tabellen oder Feldzuordnungen verwenden möchtest. Unter **Letzte Synchronisation** siehst du das Ergebnis des letzten Laufs und seine Meldungen.

Wenn du ein Feld ergänzt hast und bestehende Ninox-Datensätze damit füllen möchtest, findest du die passende Funktion unter [**Operationen**](https://docs.kontoflux.io/konten-synchronisieren/testen-und-reparieren/).

---

<!-- https://docs.kontoflux.io/integrationen/konfiguration-uebertragen/ -->

# Ninox-Konfiguration übertragen

Du kannst eine Ninox-Konfiguration wiederverwenden, wenn du mehrere Workspaces mit derselben Tabellenstruktur einrichtest. Übertragen werden die Einstellungen und Feldzuordnungen. Den Ninox API Key gibst du im Ziel separat ein.

## Als Datei herunterladen

1. Öffne **Automationen → Integrationen**.
2. Öffne das Menü deiner eingerichteten Ninox-Integration.
3. Wähle **Konfiguration herunterladen**.
4. Bewahre die JSON-Datei für die spätere Einrichtung auf.

Die Datei enthält die Integrationskonfiguration, keine Bankumsätze und keinen Ninox API Key. Sie ist kein vollständiges Backup deiner Daten.

## Datei in einem Workspace verwenden

1. Wechsle in den Ziel-Workspace.
2. Öffne einen freien Integrationsplatz und wähle **Konfiguration importieren**.
3. Gib den Ninox API Key für diesen Workspace ein und lass ihn prüfen.
4. Lade die exportierte JSON-Datei hoch.
5. Prüfe die Rückmeldung. Falls Team, Datenbank, Tabellen oder Felder nicht passen, korrigiere sie im Einrichtungsassistenten.
6. Kontrolliere die fertige Konfiguration und den Zeitplan, bevor du die Integration aktivierst.

Du kannst auch bei einer neu angelegten Ninox-Integration nach der Schlüsselprüfung **Konfiguration hochladen** wählen. Der Dateiimport unterstützt die Ninox-Konfiguration.

## Direkt in einen anderen Workspace kopieren

1. Öffne das Menü der Ninox-Integration.
2. Wähle **In anderen Workspace kopieren**.
3. Wähle einen angebotenen Ziel-Workspace aus.
4. Öffne die Kopie im Ziel-Workspace und vervollständige die Einrichtung mit dem passenden Ninox API Key.

Die Kopie startet inaktiv. Prüfe auch hier die Tabellen- und Feldzuordnung: Ein passender Tabellenname allein bedeutet nicht, dass die internen Feldkennungen übereinstimmen.

---

<!-- https://docs.kontoflux.io/integrationen/webhooks/ -->

# Webhooks einrichten und prüfen

Ein Webhook schickt Daten an eine Adresse deiner Anwendung, wenn passende Änderungen vorliegen. Kontoflux.io sendet dafür eine HTTP-POST-Anfrage an die von dir hinterlegte HTTPS-Adresse.

## Webhook anlegen

1. Öffne **Automationen → Webhooks** im gewünschten Workspace.
2. Klicke auf **Webhook erstellen** und öffne den neuen Eintrag.
3. Gib ihm einen Namen, zum Beispiel „Umsätze an Buchhaltung“.
4. Trage die Empfangsadresse unter **Webhook URL** ein. Sie muss mit `https://` beginnen.
5. Wähle den **Scope** und die **Bankkonten**.
6. Ergänze bei Bedarf die HTTP-Header und klicke auf **Speichern**.
7. Prüfe den Empfang mit **Testdaten senden** und aktiviere anschließend den Webhook über den Statusschalter.

Ein neuer Webhook ist zunächst inaktiv. Ohne HTTPS-Adresse lässt er sich nicht aktivieren.

## Daten auswählen

| Scope | Übertragene Daten |
| --- | --- |
| **Transaktionen** | Umsätze der ausgewählten Konten |
| **Konten** | Daten der ausgewählten Bankkonten |
| **Transaktionen + Konten** | Beide Datenarten |

Mit **Bankkonten** beschränkst du, für welche Konten der Webhook Daten übermitteln soll. Prüfe die Zusammenfassung unter **Auswahl der Daten**, bevor du speicherst.

## Empfang authentifizieren

Unter **HTTP-Header** kannst du über **Header hinzufügen** Schlüssel und Werte hinterlegen. Benötigt deine Anwendung beispielsweise einen Bearer-Token, trägst du als Schlüssel `Authorization` und als Wert `Bearer DEIN_EMPFAENGER_TOKEN` ein.

Verwende hier die Zugangsdaten deiner empfangenden Anwendung. Ob du gespeicherte URL- und Header-Werte sehen oder ändern darfst, hängt von deiner Workspace-Rolle ab.

## Testdaten senden

**Testdaten senden** öffnet einen Dialog für Beispieltransaktionen. Dort wählst du ein Konto und bearbeitest unter anderem Betrag, Währung, Datum und Verwendungszweck. Du kannst weitere Transaktionen hinzufügen und die Daten absenden.

Der Test erreicht die echte Empfangsadresse. Die Transaktionen sind Beispieldaten; bei einem Scope mit Kontodaten werden die tatsächlichen Kontodaten der gewählten Bankkonten mitgesendet. Prüfe beim Empfänger, ob die Daten angekommen sind und wie sie verarbeitet wurden.

## Aufbau der Anfrage

Die JSON-Anfrage enthält `workspaceId` und `webhookId`. Je nach Scope kommen die Listen `transactions`, `accounts` oder beide hinzu. Testanfragen tragen zusätzlich `debug: true`. Berücksichtige dieses Feld, wenn dein Empfänger Testdaten gesondert behandeln soll.

## Ausführungen kontrollieren

Unter **Letzte Ausführung** siehst du Status und Meldungen des letzten Laufs. **View Executions** öffnet die einzelnen Ausführungen. Einige Beschriftungen in diesem Dialog sind derzeit auf Englisch:

- **All**, **Successful** und **Failed** filtern die Liste nach Ergebnis.
- Ein Eintrag zeigt Zeitpunkt, Statuscode, Konto- und Transaktionskennung sowie eine Rückmeldung zur Zustellung.
- Bei längeren gespeicherten Rückmeldungen öffnet **View Full Response** deren vollständigen Text. Aktuelle Ausführungen speichern eine Statuszusammenfassung; eine vollständige Antwort des Empfängers ist dort nicht garantiert.
- Über das Menü eines Transaktionseintrags kannst du **Resend Webhook** oder **Copy Details** wählen.

Eine erneute Zustellung kann die Verarbeitung beim Empfänger nochmals auslösen. Prüfe deshalb vor **Resend Webhook**, ob die erste Anfrage dort bereits verarbeitet wurde.

## Wenn keine Daten ankommen

Prüfe zuerst Aktivierungsstatus, HTTPS-Adresse, Scope und Kontenauswahl. Öffne dann die fehlgeschlagene Ausführung und prüfe Statuscode und Rückmeldung. Bei `401` oder `403` kontrollierst du beispielsweise die Zugangsdaten des Empfängers. Für weitere Details prüfe das Protokoll deiner empfangenden Anwendung.

Zum Pausieren schaltest du den Webhook inaktiv. Mit **Webhook löschen** entfernst du die Konfiguration.

---

<!-- https://docs.kontoflux.io/konten-synchronisieren/manuelle-synchronisation/ -->

# Manuell synchronisieren

Eine manuelle Synchronisation überträgt die in Kontoflux.io vorhandenen Konten und Transaktionen an deine Ninox-Integration. Du kannst sie zusätzlich zu einem Zeitplan starten.

## Voraussetzungen prüfen

Die Ninox-Integration muss fertig eingerichtet und aktiv sein. Auch dein Workspace muss aktiv sein. Prüfe unter **Transaktionen**, ob die benötigten Umsätze bereits in Kontoflux.io vorliegen.

Wenn deine Bank neue Daten erst nach einer erneuten Anmeldung liefert, aktualisiere die Bankverbindung vor der Übertragung. Der Start einer Integration ersetzt diese Anmeldung nicht.

## Synchronisation starten

1. Öffne **Automationen → Integrationen** und wähle deine Ninox-Integration.
2. Gehe zu **Manuelle Synchronisation**.
3. Öffne den **Synchronisations Link**. Die Seite **Quick-Sync** erscheint.
4. Prüfe die Hinweise zum Stand deiner Bankkonten. Bei einer abgelaufenen Verbindung kannst du sie über **Neu autorisieren** aktualisieren.
5. Klicke auf **Synchronisation starten**.
6. Warte auf das Ergebnis und kontrolliere die Daten in Ninox.

Bei einer abgelaufenen Verbindung bietet Quick-Sync auch **Trotzdem synchronisieren** an. Dann wird der bereits vorhandene Stand übertragen. Beachte dafür die Anzeige **Stand der Transaktionen**.

## Ergebnis verstehen

- **Synchronisation in Warteschlange…**: Der Auftrag wartet auf die Verarbeitung.
- **Synchronisation erfolgreich!** beziehungsweise eine Erfolgsmeldung mit Anzahl: Die Übertragung wurde abgeschlossen.
- **Es gab jedoch keine neuen Transaktionen zu synchronisieren.**: Der Lauf war erfolgreich, ohne neue Umsätze zu übertragen.
- **Synchronisation fehlgeschlagen.**: Prüfe die Integration und ihre Protokolle, bevor du erneut startest.

Unter **Letzte Synchronisation** in der Integration findest du die Meldungen des letzten Laufs. Zum Prüfen der geplanten Änderungen verwendest du den [Testlauf](https://docs.kontoflux.io/konten-synchronisieren/testen-und-reparieren/).

---

<!-- https://docs.kontoflux.io/konten-synchronisieren/automatische-synchronisation/ -->

# Automatisch synchronisieren

Für deine Ninox-Integration kannst du einen Zeitplan festlegen. Die Integration überträgt dann den in Kontoflux.io vorhandenen Stand, ohne dass du jeden Lauf von Hand starten musst.

## Zeitplan einrichten

1. Öffne **Automationen → Integrationen** und wähle die Ninox-Integration.
2. Prüfe unter **Einstellungen**, ob **Aktiv Status** eingeschaltet ist.
3. Wähle bei **Übertrage** den Rhythmus.
4. Stelle Uhrzeit und gegebenenfalls Wochentag oder Tag des Monats ein.
5. Klicke auf **Speichern**, wenn die Schaltfläche für ungespeicherte Änderungen erscheint.
6. Prüfe die Anzeige **Nächste Synchronisation**.

| Auswahl | Weitere Einstellung |
| --- | --- |
| **täglich** | Uhrzeit |
| **wöchentlich** | Wochentag und Uhrzeit |
| **monatlich** | Tag des Monats und Uhrzeit |
| **nicht automatisch** | Übertragung nur bei manuellem Aufruf |

Die angezeigte nächste Synchronisation hilft dir, den Zeitplan zu prüfen. Sie ist kein Nachweis, dass bereits Daten übertragen wurden. Das Ergebnis findest du nach dem Lauf unter **Letzte Synchronisation**.

## Automatische Übertragung pausieren

Wähle **nicht automatisch** und speichere. Die Integration kann dann weiterhin [manuell](https://docs.kontoflux.io/konten-synchronisieren/manuelle-synchronisation/) gestartet werden.

Schaltest du dagegen **Aktiv Status** aus, stoppt die gesamte Integration. Auch manuelle Übertragungen sind dann gesperrt.

## Wenn der Datenstand nicht stimmt

Ein Zeitplan für Ninox bestimmt, wann Kontoflux.io Daten weitergibt. Wie aktuell diese Daten sind, hängt vom letzten erfolgreichen Bankabruf ab. Prüfe deshalb bei fehlenden Umsätzen zuerst die Bankverbindung und danach das Ergebnis der Integration.

---

<!-- https://docs.kontoflux.io/konten-synchronisieren/quick-sync-link/ -->

# Quick-Sync-Link verwenden

Der Quick-Sync-Link öffnet eine Seite, auf der du eine Ninox-Synchronisation starten und ihr Ergebnis sehen kannst. Du kannst ihn beispielsweise hinter einem Button in deiner Ninox-Datenbank hinterlegen.

## Link kopieren

1. Öffne **Automationen → Integrationen** und wähle die gewünschte Ninox-Integration.
2. Gehe zu **Manuelle Synchronisation → Synchronisations Link**.
3. Kopiere den angezeigten Link.
4. Hinterlege ihn als normalen Weblink in deiner Anwendung.

Der Link gehört zu genau dieser Integration in diesem Workspace. Wer ihn öffnet, muss bei Kontoflux.io angemeldet sein und Zugriff auf den Workspace haben.

## Was beim Öffnen passiert

Quick-Sync prüft den Zugriff und zeigt den Zustand der Bankkonten. Die Übertragung startet, wenn du auf **Synchronisation starten** klickst.

Bei abgelaufenen Verbindungen kannst du **Neu autorisieren** wählen. Über **Bankkonten anzeigen** erreichst du die verbundenen Konten. **Trotzdem synchronisieren** überträgt den vorhandenen Datenstand, wenn du die Bankverbindung noch nicht aktualisieren möchtest.

Nach dem Lauf siehst du, ob neue Transaktionen übertragen wurden oder ob ein Fehler aufgetreten ist. Das Fenster kannst du danach schließen.

## Fehler beim Zugriff

Bei **Kein Zugriff oder ungültiger Link** prüfst du, ob die Integration noch existiert und du mit dem richtigen Kontoflux.io-Konto angemeldet bist. Eine inaktive Integration muss zunächst in ihren Einstellungen aktiviert werden.

Für einen Aufruf aus einem Skript ohne Browser-Anmeldung verwendest du den [JSON-Sync-Endpunkt](https://docs.kontoflux.io/konten-synchronisieren/json-sync-endpunkt/).

---

<!-- https://docs.kontoflux.io/konten-synchronisieren/json-sync-endpunkt/ -->

# Synchronisation per JSON-Endpunkt

Mit dem **Synchronisations Endpunkt** startest du eine Ninox-Synchronisation aus einem Skript oder einer anderen Anwendung. Die Antwort ist JSON. Ein Token im Link erlaubt den Aufruf ohne Anmeldung im Browser.

## Endpunkt erstellen

1. Öffne **Automationen → Integrationen** und wähle die Ninox-Integration.
2. Gehe zu **Manuelle Synchronisation → Synchronisations Endpunkt**.
3. Klicke auf **Neuen Link generieren**.
4. Kopiere die vollständige angezeigte URL einschließlich `?token=…` in deine Anwendung.

Verwende die URL aus der Oberfläche. Sie gehört zur Synchronisation deiner Integration und verwendet eine andere Adresse als die öffentliche API zum Lesen von Bankdaten.

> Wer den vollständigen Link besitzt, kann die Synchronisation auslösen. Bewahre ihn wie einen Zugangsschlüssel auf und hinterlege ihn nur in Anwendungen, die diese Übertragung starten sollen.

## Aufruf

Der Endpunkt akzeptiert `POST` und `GET`. Dieses Beispiel setzt voraus, dass `KONTOFLUX_SYNC_URL` in der Umgebung deines Skripts die kopierte URL enthält:

```bash
curl --fail-with-body --request POST "$KONTOFLUX_SYNC_URL"
```

Der Token berechtigt zum Starten dieser Integration. Die Integration muss aktiv sein. Ein bereits laufender Auftrag kann einen weiteren Start verhindern.

## Antwort auswerten

Ein erfolgreicher HTTP-Aufruf bedeutet nicht immer, dass der Lauf schon abgeschlossen ist. Prüfe die Felder der JSON-Antwort:

| Felder | Bedeutung |
| --- | --- |
| `finished: true`, `status: "success"` | Der Lauf ist abgeschlossen. `items` und `log` enthalten das Ergebnis. |
| `finished: false`, `status: "running"` | Der Lauf wurde eingeplant oder läuft noch. Prüfe das endgültige Ergebnis in Kontoflux.io. |
| `finished: true`, `status: "error"` | Der Lauf ist fehlgeschlagen. `log` enthält die Meldungen. |

Bei einer Fehlermeldung prüfst du außerdem den HTTP-Status und den Antworttext. Starte denselben Auftrag nicht fortlaufend neu, während er noch verarbeitet wird.

## Link ersetzen oder entziehen

- **Neuen Link generieren** ersetzt den bisherigen Token. Aktualisiere danach alle Anwendungen, die den alten Link verwenden.
- **Link löschen** entzieht dem bisherigen Link den Zugriff.

Den sichtbaren Ablauf mit Bankprüfung und Anmeldung findest du beim [Quick-Sync-Link](https://docs.kontoflux.io/konten-synchronisieren/quick-sync-link/).

---

<!-- https://docs.kontoflux.io/konten-synchronisieren/testen-und-reparieren/ -->

# Synchronisation testen und reparieren

Unter **Operationen** findest du Funktionen, um eine Ninox-Synchronisation zu prüfen oder bestehende Ziel-Datensätze zu bearbeiten. Wähle zuerst die betroffene Integration.

## Ohne Schreibzugriff testen

1. Wähle in Kontoflux.io den gewünschten Workspace und öffne anschließend die Seite [**Operationen**](https://app.kontoflux.io/operations). Sie verwendet deinen zuletzt geöffneten Workspace. Prüfe die Auswahl in der Kopfzeile.
2. Wähle die Ninox-Integration.
3. Klicke auf **Testlauf Synchronisation**.
4. Lies die Zusammenfassung und das **Synchronisations-Log**.

Der Testlauf zeigt, welche Daten synchronisiert würden. Dabei werden keine Daten geschrieben. Er eignet sich zum Prüfen einer neuen Einrichtung oder geänderter Feldzuordnungen.

**Testdaten senden** in der Integration hat einen anderen Zweck: Die Funktion sendet von dir zusammengestellte Beispieltransaktionen tatsächlich an Ninox. Dadurch können dort Datensätze entstehen.

## Passende Operation auswählen

| Funktion | Wann sie hilft | Was du vorher prüfen solltest |
| --- | --- | --- |
| **Alle Transaktionen in externer Quelle überschreiben** | Du hast ein Feld ergänzt oder möchtest die zugeordneten Felder auf den Stand von Kontoflux.io bringen. | Eigene Änderungen in zugeordneten Ninox-Feldern können überschrieben werden. |
| **Ab Zeitpunkt neu übertragen** | Du möchtest Daten für einen Zeitraum neu aufbauen. | Die betroffenen Ziel-Datensätze werden gelöscht und neu erstellt. |
| **Duplikate aus externer Quelle entfernen** | Die Zieltabelle enthält mehrfach übertragene Transaktionen. | Prüfe die Vorschau der erkannten Duplikate vor dem Löschen. |
| **Synchronisations-Historie löschen** | Du möchtest die gespeicherten Übertragungszuordnungen zurücksetzen. | Beim nächsten Lauf können Daten erneut übertragen und neue Datensätze erstellt werden. |

## Änderungen ausführen

1. Wähle die passende Operation.
2. Bei **Ab Zeitpunkt neu übertragen** legst du **Startdatum** und **Enddatum** fest. Mit **Kein Datumsfilter (alle Transaktionen)** umfasst die Auswahl alle Transaktionen.
3. Öffne gegebenenfalls **Vorschau der Operation anzeigen** und lies das Ergebnis.
4. Prüfe die angezeigte Erklärung der Auswirkungen und bestätige sie über den Schalter.
5. Klicke auf **Operation starten**.
6. Kontrolliere das Ergebnis und die betroffenen Datensätze in Ninox.

Die Synchronisations-Historie dient dazu, übertragene Daten wiederzuerkennen. Lösche sie deshalb nicht allein, um ein Protokoll aufzuräumen.

## Wenn eine Synchronisation fehlschlägt

Prüfe zuerst den Ninox API Key, die gewählte Datenbank und die Feldzuordnung. Unter **Letzte Synchronisation** in der Integration findest du Meldungen zum letzten Lauf. Im Testlauf erhältst du ein eigenes **Synchronisations-Log** für die geplante Übertragung.

Wenn Kontoflux.io einen Umsatz selbst noch nicht anzeigt, hilft eine Reparatur der Ninox-Übertragung nicht. Aktualisiere in diesem Fall zuerst die Bankverbindung.

---

<!-- https://docs.kontoflux.io/api/uberblick-api/ -->

# API im Überblick

Über die öffentliche API liest deine Anwendung die Bankdaten eines Kontoflux.io-Workspaces. Du kannst zum Beispiel Kontostände in einem eigenen Bericht anzeigen oder Transaktionen für einen Abgleich abrufen.

## Zugang wählen

| Anwendung | Zugang |
| --- | --- |
| Eigenes Skript oder serverseitiger Prozess | [API-Schlüssel](https://docs.kontoflux.io/api/zugang-zur-api/) |
| Anwendung mit Anmeldung und Zustimmung der Nutzer | [OAuth-App](https://docs.kontoflux.io/integrationen/oauth-apps/) |
| KI-Client mit MCP-Unterstützung | [MCP-Server](https://docs.kontoflux.io/integrationen/mcp-server/) |

API-Zugänge sind an einen Workspace gebunden. Ihre Berechtigungen und Kontenauswahl bestimmen, welche Daten erreichbar sind.

## Aufbau der Adresse

```text
https://api.kontoflux.io/v1/WORKSPACE_ID/RESOURCE
```

Ersetze `WORKSPACE_ID` durch die Kennung deines Workspaces und `RESOURCE` durch den gewünschten Endpunkt. Die Workspace-Kennung ist beispielsweise der Teil direkt vor `/automations` in der Adresse der geöffneten Automationsseite.

| Endpunkt | Zweck |
| --- | --- |
| `/accounts` | Konten und Kontodaten abrufen |
| `/accounts/KONTO_ID/transactions` | Transaktionen eines Kontos abrufen |
| `/transactions` | Transaktionen des Workspaces abrufen |
| `/transactions/search` | Transaktionen mit einem Suchtext finden |
| `/transactions/match` | Passende Transaktionen zu einer Referenz suchen |
| `/categories` | Verfügbare Kategorien abrufen |
| `/key/scope` | Berechtigungen des verwendeten Zugangs prüfen |

## Ersten Abruf vorbereiten

1. Erstelle und aktiviere einen [API-Schlüssel](https://docs.kontoflux.io/api/zugang-zur-api/).
2. Wähle dessen Berechtigungen und Bankkonten.
3. Übernimm deine Workspace-Kennung.
4. Probiere einen kleinen Abruf mit den [Codebeispielen](https://docs.kontoflux.io/api/api-snippets/).
5. Ergänze [Filter und Seitennavigation](https://docs.kontoflux.io/api/transaktionen-filtern/), wenn du größere Datenmengen liest.

Die API liefert den bereits in Kontoflux.io vorhandenen Stand. Ein Datenabruf startet keine Bankanmeldung und keine Ninox-Synchronisation.

Die vollständige Beschreibung von Parametern und Antworten findest du in der [API-Referenz](https://api.kontoflux.io/).

---

<!-- https://docs.kontoflux.io/api/zugang-zur-api/ -->

# API-Schlüssel verwalten

Mit einem API-Schlüssel greift ein Skript auf Daten eines bestimmten Workspaces zu. Verwende für verschiedene Anwendungen getrennte Schlüssel, damit du ihren Zugriff einzeln ändern oder beenden kannst.

API-Schlüssel verwalten **Eigentümer** und **Integratoren** des Workspaces.

## Schlüssel erstellen

1. Wähle den gewünschten Workspace und öffne **Automationen → API**.
2. Klicke auf **API Schlüssel erstellen**.
3. Öffne den neuen Eintrag und gib ihm über das Stiftsymbol einen passenden Namen.
4. Kopiere den Schlüssel über das Kopierfeld und hinterlege ihn in deiner Anwendung.
5. Wähle **Scope** und **Bankkonten**. Speichere die Änderungen mit **Speichern**.
6. Aktiviere den Schlüssel über den Statusschalter.

Ein neuer Schlüssel ist zunächst inaktiv. Der vollständige Wert wird beim Erstellen beziehungsweise Neugenerieren einmal bereitgestellt. Kopiere ihn, bevor du die Seite neu lädst. Später zeigt die Liste nur eine gekürzte Vorschau.

## Zugriff eingrenzen

Unter **Scope** bestimmst du die lesbaren Daten:

- **Transaktionen** erlaubt den Zugriff auf Transaktionen.
- **Konten** erlaubt den Zugriff auf Kontodaten.
- Wenn deine Anwendung beides abruft, wähle beide Bereiche.
- **Jede Funktion** umfasst die derzeit verfügbaren Leseberechtigungen einschließlich Kategorien.

Unter **Bankkonten** wählst du einzelne Konten oder **Alle Bankkonten**. Die Auswahl aller Konten umfasst auch später hinzugefügte Konten. Prüfe, ob deine Anwendung das braucht.

Den wirksamen Zugriff kannst du über `/key/scope` abrufen. Die Antwort nennt die tatsächlichen Scopes und die Kontobeschränkung. Ein Schlüssel mit **Transaktionen** erhält beispielsweise `transactions:read`.

## Schlüssel verwenden

Sende den vollständigen Schlüssel im HTTP-Header:

```http
Authorization: Bearer DEIN_API_SCHLUESSEL
```

Hinterlege den Wert serverseitig, etwa als Umgebungsvariable. Ein Schlüssel in ausgeliefertem Browser-JavaScript wäre für Besucher dieser Anwendung sichtbar.

Normale API-Schlüssel beginnen mit `sk-`. Für die MCP-URL erstellst du einen eigenen Schlüssel innerhalb der [MCP-Integration](https://docs.kontoflux.io/integrationen/mcp-server/).

## Schlüssel ersetzen oder sperren

- **Schlüssel neu generieren** ersetzt den bisherigen Wert sofort. Kopiere den neuen Schlüssel und aktualisiere deine Anwendung. Der alte Wert funktioniert danach nicht mehr.
- Über den Statusschalter deaktivierst du einen Schlüssel vorübergehend.
- **API Schlüssel löschen** entfernt den Zugang dauerhaft.

**Zuletzt verwendet** hilft dir zu erkennen, ob eine Anwendung den Schlüssel bereits genutzt hat. Wenn du den vollständigen Schlüssel nicht mehr hast, generiere ihn neu.

## Bei Zugriffsfehlern

Prüfe Workspace-Kennung, Schlüsselwert und Aktivierungsstatus. Kontrolliere anschließend Scope und Bankkontenauswahl. Für `/accounts` brauchst du beispielsweise eine Kontenberechtigung; eine reine Transaktionsberechtigung reicht dort nicht.

---

<!-- https://docs.kontoflux.io/api/transaktionen-filtern/ -->

# Transaktionen per API filtern

Mit Filtern holst du genau die Transaktionen ab, die deine Anwendung braucht. Alle Beispiele verwenden die öffentliche API mit `/v1/WORKSPACE_ID` und einem Bearer-Schlüssel.

## Konto und Zeitraum wählen

Für ein bestimmtes Konto verwendest du:

```text
GET /v1/WORKSPACE_ID/accounts/KONTO_ID/transactions
```

Für einen Zeitraum kannst du diese Parameter ergänzen:

| Datum | Beginn | Ende |
| --- | --- | --- |
| Buchungsdatum der Bank | `bookedAfter` | `bookedBefore` |
| Wertstellungsdatum | `valuedAfter` | `valuedBefore` |
| Importdatum in Kontoflux.io | `importedAfter` | `importedBefore` |

Die Grenzen werden einschließlich ausgewertet. Verwende vollständige Zeitangaben mit Zeitzone, wenn du einen Zeitraum genau abgrenzen möchtest. Ein reines Datum wie `2026-08-31` steht für den Tagesbeginn, nicht für das Ende dieses Tages.

Dieses Beispiel liest Buchungen im August 2026 nach UTC. `KONTOFLUX_WORKSPACE_ID` und `KONTOFLUX_API_KEY` stehen für Umgebungsvariablen deiner Anwendung:

```bash
curl --fail-with-body --get \
  "https://api.kontoflux.io/v1/${KONTOFLUX_WORKSPACE_ID}/transactions" \
  --header "Authorization: Bearer ${KONTOFLUX_API_KEY}" \
  --data-urlencode 'bookedAfter=2026-08-01T00:00:00.000Z' \
  --data-urlencode 'bookedBefore=2026-08-31T23:59:59.999Z' \
  --data-urlencode 'limit=50'
```

## Kategorien filtern

Mit `category` filterst du nach der Kategorie einer Transaktion. Du kannst eine Kategorie-ID oder einen exakten Kategorienamen übergeben. Die gültigen Werte liest du über `/categories`.

`parentCategory` eignet sich für eine übergeordnete Kategorie. Der Filter berücksichtigt sie auch dann, wenn die Transaktion direkt dieser Hauptkategorie zugeordnet ist. Verwende für einfache Abfragen jeweils den passenden einzelnen Kategorienfilter.

## Suchen oder Referenzen abgleichen

| Endpunkt | Verwendung |
| --- | --- |
| `/transactions/search?query=SUCHTEXT` | Freitextsuche über die durchsuchbaren Transaktionsfelder |
| `/transactions/match?query=REFERENZ` | Suche nach einer passenden Zahlungs- oder Rechnungsreferenz |

Verwende zum Beispiel `/transactions/match?query=RE-2026-1042` für eine Rechnungsreferenz. Die Ergebnisse enthalten einen `score`, der die Übereinstimmung bewertet. Er ist keine Bestätigung, dass eine Rechnung bezahlt ist. Prüfe zusätzlich Betrag, Währung, Richtung und mögliche Mehrfachtreffer.

Für `/match` kannst du mit `threshold` zwischen `0` und `1` die Mindestbewertung festlegen. Der Standardwert ist `0.60`. Ein höherer Wert lässt weniger Treffer zu. Der Abgleich verwendet Referenz- und Textmerkmale; aus dem Score lässt sich keine Zahlungswahrscheinlichkeit ableiten.

Konto- und Datumsfilter helfen auch beim Referenzabgleich, den Suchbereich einzugrenzen. Die Varianten für ein einzelnes Konto enden entsprechend auf `/accounts/KONTO_ID/transactions/search` oder `/accounts/KONTO_ID/transactions/match`.

## Weitere Ergebnisse laden

Listen liefern ein JSON-Array. Mit `limit` bestimmst du die Seitengröße, mit `offset` überspringst du bereits geladene Ergebnisse.

| Endpunkt | Standard | Maximum pro Abruf |
| --- | --- | --- |
| `/transactions` und `/transactions/search` | 250 | 250 |
| `/transactions/match` | 10 | 50 |

Bei `limit=50` rufst du nacheinander `offset=0`, `offset=50`, `offset=100` ab. Im Antwortheader `X-Total-Count` findest du die Gesamtzahl der passenden Ergebnisse. Behalte beim Weiterblättern dieselben Filter bei.

Alle Parameter und Antwortfelder findest du in der [API-Referenz](https://api.kontoflux.io/).

---

<!-- https://docs.kontoflux.io/api/api-snippets/ -->

# API-Codebeispiele

Die Beispiele lesen Daten aus einem Workspace. Sie setzen einen aktiven [API-Schlüssel](https://docs.kontoflux.io/api/zugang-zur-api/) mit passenden Berechtigungen voraus.

Hinterlege Workspace-Kennung und Schlüssel als `KONTOFLUX_WORKSPACE_ID` und `KONTOFLUX_API_KEY` in der Umgebung deines Skripts. So bleiben die Zugangsdaten außerhalb des Quelltexts.

## Berechtigungen mit curl prüfen

```bash
curl --fail-with-body \
  "https://api.kontoflux.io/v1/${KONTOFLUX_WORKSPACE_ID}/key/scope" \
  --header "Authorization: Bearer ${KONTOFLUX_API_KEY}"
```

Die Antwort enthält unter anderem `workspaceId`, `scopes` und die Kontobeschränkung. Prüfe diese Angaben, wenn ein anderer Endpunkt den Zugriff ablehnt.

## Konten abrufen

```bash
curl --fail-with-body \
  "https://api.kontoflux.io/v1/${KONTOFLUX_WORKSPACE_ID}/accounts" \
  --header "Authorization: Bearer ${KONTOFLUX_API_KEY}"
```

## Rechnungsreferenz suchen

```bash
curl --fail-with-body --get \
  "https://api.kontoflux.io/v1/${KONTOFLUX_WORKSPACE_ID}/transactions/match" \
  --header "Authorization: Bearer ${KONTOFLUX_API_KEY}" \
  --data-urlencode 'query=RE-2026-1042' \
  --data-urlencode 'threshold=0.8' \
  --data-urlencode 'limit=10'
```

`--data-urlencode` übernimmt die korrekte Übertragung von Leerzeichen und Sonderzeichen. Die Treffer sind Kandidaten für deinen Abgleich. Prüfe die Transaktion, bevor du daraus einen Zahlungsstatus ableitest.

## Transaktionen mit JavaScript lesen

Dieses Beispiel ist für eine serverseitige JavaScript-Umgebung mit `fetch` und Umgebungsvariablen gedacht:

```javascript
const workspaceId = process.env.KONTOFLUX_WORKSPACE_ID;
const apiKey = process.env.KONTOFLUX_API_KEY;

if (!workspaceId || !apiKey) {
  throw new Error('Workspace-Kennung und API-Schlüssel fehlen.');
}

const url = new URL(
  `https://api.kontoflux.io/v1/${encodeURIComponent(workspaceId)}/transactions`
);
url.searchParams.set('limit', '50');
url.searchParams.set('offset', '0');

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${apiKey}` },
});

if (!response.ok) {
  throw new Error(`Kontoflux.io antwortet mit HTTP ${response.status}.`);
}

const transactions = await response.json();
if (!Array.isArray(transactions)) {
  throw new Error('Die API-Antwort enthält keine Transaktionsliste.');
}

console.log(`${transactions.length} Transaktionen geladen.`);
console.log(`Treffer insgesamt: ${response.headers.get('X-Total-Count')}`);
```

Für weitere Seiten erhöhst du `offset` um die Seitengröße. Zeitraum, Konten und Kategorien kannst du wie unter [Transaktionen filtern](https://docs.kontoflux.io/api/transaktionen-filtern/) beschrieben ergänzen.

---

<!-- https://docs.kontoflux.io/api/interaktive-api-dokumentation/ -->

# API-Referenz verwenden

Die [interaktive API-Referenz](https://api.kontoflux.io/) beschreibt die öffentliche Kontoflux.io API. Sie ergänzt dieses Handbuch um die technischen Details zu einzelnen Endpunkten.

## Zur passenden Anfrage gelangen

1. Öffne in Kontoflux.io **Automationen → API**.
2. Klicke auf **API Dokumentation**.
3. Suche in der Referenz den benötigten Bereich, etwa Konten, Transaktionen oder Kategorien.
4. Prüfe HTTP-Methode, Pfad, erforderliche Parameter und die beschriebenen Antworten.
5. Übernimm die Anfrage in dein Skript und ergänze Workspace-Kennung und Zugangsdaten.

Achte auf die Version im Pfad: Die hier beschriebenen Aufrufe beginnen mit `/v1/WORKSPACE_ID/`.

## Was du hier im Handbuch findest

- [API-Zugang einrichten](https://docs.kontoflux.io/api/zugang-zur-api/): Schlüssel erstellen, aktivieren und Berechtigungen auswählen.
- [Transaktionen filtern](https://docs.kontoflux.io/api/transaktionen-filtern/): Konto, Zeitraum, Suche und Seitennavigation.
- [Codebeispiele](https://docs.kontoflux.io/api/api-snippets/): Kleine Abrufe als Ausgangspunkt für dein Skript.
- [OAuth-Apps](https://docs.kontoflux.io/integrationen/oauth-apps/): Anmeldung mit Zustimmung der Nutzer.
- [MCP-Server](https://docs.kontoflux.io/integrationen/mcp-server/): Zugang für KI-Clients.

Der [JSON-Sync-Endpunkt](https://docs.kontoflux.io/konten-synchronisieren/json-sync-endpunkt/) startet eine Ninox-Übertragung. Seine vollständige URL erzeugst du direkt in der Integration.

---

<!-- https://docs.kontoflux.io/integrationen/mcp-server/ -->

# MCP-Server für KI-Clients

Ein MCP-Server gibt einem kompatiblen KI-Client Zugriff auf ausgewählte Bankdaten. MCP steht für Model Context Protocol: Der Client erhält darüber Werkzeuge, mit denen er Daten aus Kontoflux.io abrufen kann.

## Server einrichten

1. Öffne **Automationen → Integrationen** und füge einen **MCP-Server** hinzu.
2. Gib der Integration einen passenden Namen, etwa „KI-Auswertung Geschäftskonto“.
3. Öffne **MCP-Einstellungen** und wähle unter **Verfügbare Tools** die gewünschten Werkzeuge.
4. Speichere die Auswahl.
5. Öffne **Bankkonten** und wähle unter **Erlaubte Bankkonten** die Konten für diese Integration. Speichere auch diese Einstellung.
6. Wähle einen der unten beschriebenen Zugangswege und prüfe, ob die Integration **Aktiv** ist.
7. Kopiere unter **Übersicht → MCP URL** die vollständige Adresse in deinen MCP-Client.

Die URL enthält Workspace und Integration. Verwende die kopierte Adresse dieser Integration, auch wenn du im selben Workspace weitere MCP-Server eingerichtet hast.

## Verfügbare Werkzeuge

| Tool | Aufgabe |
| --- | --- |
| `get_accounts` | Kontodaten und Kontostände lesen |
| `get_transactions` | Transaktionen lesen |

Der Client sieht nur Werkzeuge, die in der Integration freigegeben sind und zu seinen Berechtigungen passen. **Alle Tools** gibt auch künftig ergänzte Tools frei. Wenn du die Auswahl fest begrenzen möchtest, wähle die einzelnen Werkzeuge.

Für eine erste Prüfung kannst du den Client bitten, die verfügbaren Konten aufzulisten. Kontrolliere, ob nur die vorgesehenen Konten erscheinen.

## Zugang über OAuth

Für Clients mit OAuth-Unterstützung:

1. Öffne **OAuth2-Einstellungen** und prüfe **OAuth-Autorisierungsserver aktivieren**.
2. Lege unter **Erlaubte Scopes** fest, welche Berechtigungen die Integration vergeben darf. Für MCP-Zugriff wird `mcp:tools` benötigt; Konten und Transaktionen brauchen zusätzlich ihre jeweilige Leseberechtigung.
3. Wenn sich dein Client selbst registriert, aktiviere **Dynamic Client Registration erlauben**. Andernfalls [erstelle eine OAuth-App](https://docs.kontoflux.io/integrationen/oauth-apps/#oauth-app-manuell-erstellen) unter **Registrierte Apps**.
4. Klicke auf **OAuth-Einstellungen speichern**.
5. Starte die Verbindung im Client und [bestätige den Zugriff](https://docs.kontoflux.io/integrationen/apps-verbinden-und-widerrufen/) in Kontoflux.io.

Eine dynamische Registrierung legt nur die App an. Bankdaten erhält sie erst nach der Anmeldung und Zustimmung eines Kontoflux.io-Nutzers mit Zugriff auf den Workspace.

## Zugang über einen statischen Schlüssel

Wenn dein Client einen Bearer-Schlüssel statt OAuth verwendet:

1. Öffne **API-Schlüssel** in der MCP-Integration.
2. Klicke auf **Neuer MCP-Schlüssel**.
3. Kopiere den vollständigen Schlüssel und prüfe seinen Aktivierungsstatus.
4. Hinterlege ihn im Client für die kopierte MCP URL als Bearer-Schlüssel.

Diese Schlüssel beginnen mit `mcp-` und gehören zu einer bestimmten Integration. Ein normaler `sk-`-Schlüssel aus dem API-Tab passt nicht zur MCP-URL.

Den Kontoumfang dieser Schlüssel legst du im Bereich **Bankkonten** der Integration fest. Die Schlüsselansicht bietet Kopieren, Aktivieren, Neugenerieren und Löschen.

## Bankkonten begrenzen

**Alle Bankkonten** umfasst vorhandene und später hinzugefügte Konten. Eine Auswahl einzelner Konten begrenzt den Zugriff der gesamten Integration, einschließlich ihrer OAuth-Verbindungen und MCP-Schlüssel.

Mit **Endnutzer wählen Bankkonten beim Verbinden** erhält der OAuth-Zustimmungsdialog eine zusätzliche Kontenauswahl. Nutzer können dann innerhalb deiner Freigabe einzelne Konten auswählen.

Änderungen an der Kontenauswahl gelten auch für bestehende Zugänge. Bereits in einen Client übernommene Daten werden dadurch dort nicht gelöscht.

## Verbindung beenden

Über **Registrierte Apps → Widerrufen** entziehst du einer OAuth-App den Zugriff. Einen statischen Schlüssel deaktivierst oder löschst du im Bereich **API-Schlüssel**. Der Aktivierungsschalter der Integration sperrt die gesamte MCP-Instanz.

Wenn der Client keine Tools sieht, prüfe Werkzeugauswahl und OAuth-Scopes. Bei einer nicht erreichbaren URL prüfe außerdem den Aktivierungsstatus und ob die URL zur richtigen Integration gehört.

---

<!-- https://docs.kontoflux.io/integrationen/oauth-apps/ -->

# OAuth-Apps einrichten

Mit OAuth verbindet sich eine Anwendung nach Anmeldung und Zustimmung mit Kontoflux.io. Du legst fest, welche Berechtigungen und Bankkonten sie dabei erhalten kann. Die Registrierung einer App allein gibt noch keinen Zugriff auf Bankdaten.

## OAuth2 Server hinzufügen

1. Öffne **Automationen → Integrationen**.
2. Füge **OAuth2 Server** hinzu und gib der Integration einen Namen.
3. Öffne **OAuth2-Einstellungen** und prüfe **OAuth-Autorisierungsserver aktivieren**.
4. Wähle **Erlaubte Scopes** und speichere mit **OAuth-Einstellungen speichern**.
5. Lege unter **Bankkonten → Erlaubte Bankkonten** den Kontoumfang fest und speichere ihn.
6. Prüfe, ob die Integration **Aktiv** ist.

Unter **Übersicht** findest du die kopierbaren Adressen **AS metadata**, **authorize** und **token**. Die Metadaten beschreiben dem Client die verfügbaren Anmelde-Endpunkte.

Ein [MCP-Server](https://docs.kontoflux.io/integrationen/mcp-server/) hat dieselben OAuth-Einstellungen innerhalb seiner Integration. Für einen MCP-Client brauchst du deshalb keinen zusätzlichen OAuth2 Server.

## OAuth-App manuell erstellen

1. Öffne **Registrierte Apps → Neue OAuth-App** innerhalb der Integration.
2. Trage einen **App-Namen** ein.
3. Hinterlege die **Redirect-URIs**, jeweils eine vollständige Adresse pro Zeile. Dorthin darf die Anwendung nach der Zustimmung zurückleiten.
4. Wähle die **Angeforderten Scopes**.
5. Wähle den **Client-Typ**.
6. Ergänze bei Bedarf eine **Beschreibung** und klicke auf **App erstellen**.
7. Kopiere `client_id` und gegebenenfalls `client_secret`, bevor du mit **Fertig** schließt.

| Client-Typ | Verwendung |
| --- | --- |
| **Serverseitiger Client** | Die Anwendung kann ein Secret auf einem Server schützen. Sie verwendet `client_secret_post` und PKCE. |
| **Client ohne Secret** | Die Anwendung kann kein Secret sicher aufbewahren, etwa eine lokale Desktop-App. Sie verwendet PKCE ohne `client_secret`. |

PKCE ergänzt den Anmeldeablauf um einen Nachweis, dass der Client den Vorgang selbst gestartet hat. Beide Client-Typen verwenden diesen Schutz. **Client ohne Secret** bedeutet nicht, dass Bankdaten öffentlich zugänglich sind.

Ein `client_secret` wird nur einmal angezeigt. Hinterlege es direkt in der vorgesehenen Anwendung.

## Berechtigungen wählen

| Scope | Bedeutung |
| --- | --- |
| `accounts:read` | Konten und Kontostände lesen |
| `transactions:read` | Transaktionen abrufen, suchen und abgleichen |
| `categories:read` | Kategorien lesen |
| `mcp:tools` | MCP-Werkzeuge verwenden; gilt für MCP-Integrationen |

Die Scopes der Integration bilden die Obergrenze. Die App kann nur innerhalb dieser Freigabe Berechtigungen anfordern; im Zustimmungsdialog können Nutzer die Auswahl weiter begrenzen.

Die Standardfreigabe umfasst Leseberechtigungen. Der ebenfalls auswählbare Scope `transactions:write` ist für künftige Schreibfunktionen reserviert. Er stellt aktuell keine eigene Schreibfunktion bereit.

## Selbstregistrierung von Clients

Mit **Dynamic Client Registration erlauben** können kompatible Clients ihre OAuth-App selbst registrieren. Unter **Maximale Anzahl dynamischer Apps** begrenzt du die Zahl aktiver, auf diesem Weg registrierter Apps.

Unter **Alle Domains und IPs zulassen** bestimmst du, ob die Weiterleitungsadressen auf eine Liste begrenzt werden. Wenn du die Einschränkung einschaltest, trage unter **Erlaubte Redirect-Domains** die benötigten Hostnamen ein, einen pro Zeile und ohne `https://` oder Pfad. Eine leere Liste ist in diesem Modus nicht gültig.

Für eine manuell erstellte App müssen die später verwendeten Redirect-URIs exakt zu den eingetragenen Adressen passen. Eine erlaubte Domain ersetzt diese genaue Prüfung nicht.

## Konten und bestehende Apps verwalten

**Erlaubte Bankkonten** begrenzt die gesamte Integration. Mit **Endnutzer wählen Bankkonten beim Verbinden** lässt du Nutzer beim Autorisieren eine kleinere Auswahl freigeben.

Unter **Registrierte Apps** siehst du Client-ID, Scopes, erlaubte Bankkonten, Redirect-URIs und die erste Nutzung. Selbstregistrierte Apps tragen die Markierung **DCR**. Mit **Widerrufen** entziehst du einer App den Zugriff; bestätige dafür den angezeigten Dialog.

Wie sich die Zustimmung für Nutzer anfühlt, beschreibt [Apps verbinden und Zugriff entziehen](https://docs.kontoflux.io/integrationen/apps-verbinden-und-widerrufen/). Technische Parameter des OAuth-Ablaufs stehen in der [API-Referenz](https://api.kontoflux.io/).

---

<!-- https://docs.kontoflux.io/integrationen/apps-verbinden-und-widerrufen/ -->

# Apps verbinden und Zugriff entziehen

Wenn eine Anwendung oder ein KI-Client OAuth verwendet, öffnet sich in Kontoflux.io die Seite **Zugriff erlauben?**. Dort entscheidest du, welche Daten die App lesen darf.

## Zugriff bestätigen

1. Starte die Verbindung in der Anwendung, die du mit Kontoflux.io verbinden möchtest.
2. Melde dich bei Kontoflux.io mit einem Konto an, das Zugriff auf den angezeigten Workspace hat.
3. Prüfe Workspace und App-Name.
4. Lies unter **Berechtigungen**, welchen Zugriff die App erhalten soll. Entferne Häkchen bei Berechtigungen, die du nicht freigeben möchtest.
5. Falls **Bankkonten** angezeigt wird, wähle die Konten für diese App.
6. Prüfe die Adresse unter **Weiterleitung nach Bestätigung**.
7. Klicke auf **Erlauben**, um die Verbindung abzuschließen, oder auf **Ablehnen**, um abzubrechen.

Mindestens eine Berechtigung muss ausgewählt bleiben. Wenn die Kontenauswahl angezeigt wird, muss auch mindestens ein Konto gewählt sein. Die angebotene Auswahl ist bereits auf die Freigabe der Integration begrenzt.

## Selbstregistrierte Apps erkennen

Bei einer dynamisch registrierten App zeigt die Zustimmungsseite einen Hinweis, dass sie nicht vom Workspace-Eigentümer geprüft wurde. Eine solche Registrierung kann zum normalen Verbindungsablauf deines Clients gehören. Prüfe trotzdem App-Name und Weiterleitungsadresse, bevor du Zugriff erlaubst.

Wenn dir eine App unbekannt ist oder die angezeigte Adresse nicht zum gestarteten Vorgang passt, wähle **Ablehnen**.

## Warum die Verbindung scheitern kann

- **Ungültige Anfrage**: Starte die Verbindung aus dem Client neu.
- Die Weiterleitungsadresse passt nicht zur App: Die zuständige Person muss die registrierten Redirect-URIs prüfen.
- Die App wurde nicht gefunden oder ist deaktiviert: Prüfe mit der Person, die die Integration verwaltet, den App-Status.
- Du hast keinen Zugriff auf den Workspace: Melde dich mit dem vorgesehenen Kontoflux.io-Konto an oder lass dir Zugriff geben.

Die Registrierung einer App ersetzt weder die Workspace-Mitgliedschaft noch deine Zustimmung.

## Zugriff später entziehen

Wenn du die Integration verwalten darfst:

1. Öffne **Automationen → Integrationen**.
2. Wähle den betroffenen **MCP-Server** oder **OAuth2 Server**.
3. Öffne **Registrierte Apps** und den Eintrag der Anwendung.
4. Prüfe App-Name, Scopes und erlaubte Bankkonten.
5. Klicke auf **Widerrufen** und bestätige den Dialog.

Bestehende Tokens dieser App funktionieren danach nicht mehr. Der Widerruf betrifft die registrierte App dieser Integration. In der MCP-Integration kannst du außerdem **Alle DCR-Apps widerrufen** verwenden, um ihre dynamisch registrierten Apps gemeinsam zu sperren.

Wenn du keine Verwaltungsberechtigung hast, wende dich an den Eigentümer oder Integrator deines Workspaces. Ein Widerruf verhindert weitere Zugriffe; bereits von der Anwendung gespeicherte Daten bleiben dort bestehen.

---

<!-- https://docs.kontoflux.io/limitationen-and-sonderfalle/aktualitat-der-daten/ -->

# Fehlende oder veraltete Umsätze

Wenn eine Buchung fehlt, prüfe zuerst, an welcher Stelle sie noch nicht angekommen ist: bei der Bankanbindung, in den Transaktionen von Kontoflux.io oder in der verbundenen Anwendung.

## 1. Workspace und Konto prüfen

Öffne den richtigen Workspace. Wähle unter **Transaktionen** bei **Konto** das betroffene Konto aus. Mit **Mehr laden** rufst du weitere Buchungen ab.

Ist das Konto bereits unter **Bankkonten** nicht zu sehen, prüfe, ob es verbunden wurde. Nach dem Entfernen einer Verbindung liegen ihre Daten zunächst im Archiv. Sie werden beim Import wieder zugeordnet, wenn das erneut verbundene Konto wiedererkannt wird.

## 2. Letzte Aktualisierung ansehen

Öffne **Bankkonten** und klappe die Kontozeile auf. Vergleiche **Zuletzt aktualisiert** mit **Letzter Aktualisierungs-Versuch**. Ein neuer Versuch allein bestätigt noch keinen erfolgreichen Abruf.

Achte auch auf Hinweise wie **Authentifizierung erforderlich** oder **Neuverbindung erforderlich**. Folge dann den Schritten unter [Bankkonten verwalten](https://docs.kontoflux.io/konten-anbinden/bankkonten-verwalten/).

## 3. Laufende Vorgänge abwarten

Die Bankverbindung kann bereits aktualisiert sein, während die Umsätze noch importiert werden. Kontoflux.io unterscheidet deshalb zwischen einem erfolgreichen Import, einem fehlgeschlagenen Import und einer Aktualisierung, die im Hintergrund weiterläuft.

| Rückmeldung | Was du tun kannst |
| --- | --- |
| **Aktualisierung erfolgreich** mit neuen Umsätzen | Öffne **Transaktionen** erneut und prüfe das Konto. |
| **Aktualisierung erfolgreich – keine neuen Umsätze.** | Der Abruf hat keine zusätzlichen Buchungen geliefert. Prüfe die Buchung im Onlinebanking und den gewählten Kontofilter. |
| **Für diese Bankverbindung läuft bereits eine Aktualisierung.** | Lass den laufenden Vorgang abschließen. |
| **Die Aktualisierung läuft im Hintergrund weiter.** | Prüfe nach einigen Minuten erneut. |
| Bankverbindung aktualisiert, Import fehlgeschlagen | Versuche es später erneut und prüfe den Fehler im **Protokoll**. |

Entscheidend sind der angezeigte Status und der tatsächliche Import. Eine feste Uhrzeit, zu der jede neue Buchung verfügbar sein muss, lässt sich daraus nicht ableiten.

## 4. Die Weitergabe getrennt prüfen

Ist die Buchung unter **Transaktionen** sichtbar, aber in deiner Zielanwendung noch nicht vorhanden, prüfe die zuständige Integration oder den Webhook. Ein erfolgreicher Bankabruf bestätigt nicht automatisch die anschließende Übertragung.

Im [Ereignisprotokoll](https://docs.kontoflux.io/hilfe/ereignisprotokoll/) kannst du **Importe**, **Integrationen** und **Webhooks** getrennt ansehen. Öffne den passenden Eintrag, um Zeitpunkt und Fehlermeldung zu prüfen.

## Wenn du Unterstützung brauchst

Halte den Workspace-Namen, die betroffene Bank, den Zeitpunkt des letzten Versuchs und die genaue Fehlermeldung bereit. Wenn es einen passenden Protokolleintrag gibt, kannst du dessen Link ergänzen. So lässt sich der Vorgang leichter zuordnen.

---

<!-- https://docs.kontoflux.io/limitationen-and-sonderfalle/wechselwirkung-softwares-mit-finapi.io/ -->

# Bankzugriff erneut freigeben

Verlangt Kontoflux.io eine neue Freigabe für deine Bank, beginne bei der angezeigten Meldung unter **Bankkonten**. Sie hilft dir, zwischen einer nötigen Anmeldung und einer vollständigen Neuverbindung zu unterscheiden.

## Zugangsdaten oder Freigabe werden angefordert

1. Öffne **Bankkonten** und suche die betroffene Bank.
2. Klicke auf **Neu autorisieren**. Bei einem bereits offenen Formular wird auch **Zugangsdaten aktualisieren** angeboten.
3. Führe die Schritte im Bank-Login vollständig aus.
4. Warte auf die Rückmeldung und prüfe danach **Zuletzt aktualisiert** im aufgeklappten Konto.

Auch wenn die Freigabe erfolgreich war, kann der Import der Umsätze noch laufen. Mehr dazu unter [Fehlende oder veraltete Umsätze](https://docs.kontoflux.io/limitationen-and-sonderfalle/aktualitat-der-daten/).

## Die App verlangt eine Neuverbindung

Bei **Neuverbindung erforderlich** steht der bisherige Zugangsweg nicht mehr zur Verfügung. Nutze **Jetzt neu verbinden** und folge dem Dialog. Die [Anleitung zur Neuverbindung](https://docs.kontoflux.io/konten-anbinden/bankkonten-verwalten/#eine-bank-neu-verbinden) erklärt, wie dabei mit deinen bisherigen Daten umgegangen wird.

## Du nutzt dieselbe Bank in mehreren Anwendungen

Wenn die erneute Freigabe zeitlich mit einem Abruf in einer anderen Anwendung zusammenfällt, notiere den Ablauf: Welche Anwendung wurde genutzt, wann trat die Meldung auf und was steht genau darin?

Eine solche zeitliche Nähe allein erklärt die Ursache noch nicht. Prüfe den Status in Kontoflux.io und den passenden Eintrag im [Protokoll](https://docs.kontoflux.io/hilfe/ereignisprotokoll/). Wenn sich das Verhalten wiederholt, helfen diese Angaben dem Support bei der Prüfung.

---

<!-- https://docs.kontoflux.io/limitationen-and-sonderfalle/sonderfalle-datenfelder-und-banken/ -->

# Datenfelder verstehen

In der Transaktionsliste kannst du zusätzliche Felder einblenden, um eine Buchung genauer zu prüfen. Nicht jede Bank und nicht jede Buchung liefert zu jedem Feld einen Wert.

## Häufige Felder

| Spalte | Einordnung |
| --- | --- |
| **Betrag** | Eingehende Beträge sind positiv, ausgehende negativ. Die Anzeige verwendet die Währung der Buchung. |
| **Verwendungszweck** | Der übermittelte Buchungstext. Er kann neben einem Zahlungshinweis weitere Angaben enthalten. |
| **Buchungsdatum Bank** | Das von der Bank gelieferte Buchungsdatum. |
| **Wertstellungsdatum** | Das Datum der Wertstellung; es kann vom Buchungsdatum abweichen. |
| **Buchungsdatum finAPI** | Ein zusätzliches Buchungsdatum aus finAPI. Es ist ein eigenes Feld neben dem Buchungsdatum der Bank. |
| **Gegenpartei Name** | Name der anderen Seite einer Zahlung, also Empfänger oder Absender. |
| **Gegenpartei IBAN** | Die übermittelte IBAN. Fehlt sie, zeigt die Liste ersatzweise die Gegenpartei-Kontonummer. |
| **Gegenpartei Kontonummer** | Die übermittelte Kontonummer in einer eigenen Spalte. |
| **Kategorie** | Die zur Buchung gelieferte Kategorie. |
| **Typ** | Transaktionstyp, sofern ein Wert geliefert wird. |

So blendest du diese Angaben ein: [Spalten anpassen](https://docs.kontoflux.io/transaktionen/spalten-anpassen/).

## Ein Feld bleibt leer

Prüfe zunächst andere Felder derselben Buchung. Beispielsweise kann eine Kontonummer vorhanden sein, obwohl keine IBAN geliefert wurde. Das gilt auch für die Kontoübersicht: Sie verwendet bei einer fehlenden IBAN die Kontonummer.

Bei einem einzelnen leeren Feld lohnt sich ein Blick auf weitere Buchungen desselben Kontos. Fehlen dagegen ganze Buchungen, gehe die Schritte unter [Fehlende oder veraltete Umsätze](https://docs.kontoflux.io/limitationen-and-sonderfalle/aktualitat-der-daten/) durch.

## Daten an eine andere Anwendung weitergeben

Prüfe einige echte Buchungen, bevor du die Feldzuordnung deiner Integration abschließt. Achte besonders auf Buchungsdatum, Betrag, Währung und die Kennung der Gegenpartei. Plane ein, dass optionale Angaben leer sein können.

Beim [Kopieren aus der Tabelle](https://docs.kontoflux.io/transaktionen/kopieren-und-weitergeben/) werden die sichtbaren Spalten in ihrer eingestellten Reihenfolge übernommen. Blende deshalb vorher die benötigten Felder ein.

---

<!-- https://docs.kontoflux.io/hilfe/ereignisprotokoll/ -->

# Ereignisprotokoll nutzen

Im **Protokoll** findest du die aufgezeichneten Ereignisse deines Workspaces. Hier kannst du zum Beispiel prüfen, ob ein Import abgeschlossen wurde, eine Integration einen Fehler gemeldet hat oder ein Teammitglied eingeladen wurde.

## Den passenden Vorgang finden

1. Öffne das **Dashboard** im gewünschten Workspace und klicke oben im **Aktivitätsverlauf** auf **Alle anzeigen**. Damit öffnest du das **Protokoll**.
2. Wähle eine **Kategorie**, zum Beispiel **Importe**, **Konten**, **Integrationen** oder **Webhooks**.
3. Grenze bei Bedarf die **Priorität** ein. Für die Fehlersuche sind häufig **Warnung**, **Fehler** oder **Kritisch** hilfreich.
4. Wähle unter **Von** und **Bis** den Zeitraum aus oder nutze **Ereignisse durchsuchen...**.
5. Öffne den passenden Eintrag, um seine Details zu sehen.

Weitere Kategorien sind **Benachrichtigungen** und **Mitglieder**. Über **Alle anzeigen** hebst du die Kategorieauswahl auf. **Filter zurücksetzen** entfernt alle gesetzten Filter. Mit den Pfeilen unter der Liste wechselst du zwischen den Ergebnisseiten.

## Ereignisdetails lesen

Die Detailansicht zeigt die Angaben, die zum Ereignis vorliegen. Besonders hilfreich sind:

- **Nachricht**: Beschreibung des Vorgangs oder des Fehlers.
- **Zeitpunkt**: Wann das Ereignis stattgefunden hat.
- **Ausgelöst von**: Wer oder was den Vorgang gestartet hat.
- **Betroffenes Objekt**: Welche Verbindung oder welches andere Objekt betroffen ist.
- **Verknüpfungen**: Verweise auf die zugehörigen Konten, Integrationen oder Webhooks.

Über eine Verknüpfung kannst du zur entsprechenden Verwaltung wechseln. Mit **Zurück zur Liste** kehrst du zur Übersicht zurück.

## Zusammengehörige Ereignisse verfolgen

Ein Vorgang kann mehrere Ereignisse erzeugen. Wenn die Detailansicht **Trace-Informationen** enthält, kannst du auf die **Trace ID** klicken. Diese gemeinsame Kennung filtert die Liste auf zusammengehörige Ereignisse.

So kannst du beispielsweise prüfen, welche Schritte vor einer Fehlermeldung aufgezeichnet wurden. Den Filter entfernst du über das Kreuz neben der angezeigten Kennung.

## Benachrichtigungen prüfen

Wenn zum Ereignis Benachrichtigungen vorliegen, erscheinen sie unter **Gesendete Benachrichtigungen**. Dort siehst du den Kanal, etwa **E-Mail**, **Webhook** oder **In-App**, und den aufgezeichneten Status.

Bei Fehlern können zusätzlich eine Fehlermeldung oder ein Antwortstatus angezeigt werden. **Gesendet** und **Zugestellt** sind unterschiedliche Statusangaben; lies deshalb den konkreten Status des Eintrags.

## Einen Vorgang für den Support festhalten

Öffne die Details und kopiere die Adresse aus deinem Browser. Ergänze kurz, was du ausführen wolltest und welches Ergebnis du erwartet hast. Der Link verweist auf dieses Ereignis im Workspace; zum Öffnen ist entsprechender Zugriff erforderlich.