Nordlet

← Dokumentation / Leitfäden

Bankverbindungen

Verbinden Sie eine Bank über Open Banking, verknüpfen Sie deren Konten, wählen Sie eine Importvorlage aus und synchronisieren Sie Transaktionen in den Kontenplan.

Diese Anleitung behandelt die Live-Verbindung zu einer Bank (PSD2-Open-Banking): wie Sie die Verbindung herstellen, wie Sie die Konten der Bank mit Ihrem Kontenplan verknüpfen, wie Sie dafür sorgen, dass jeder Abgleich (Sync) Geschäftspartner erstellt, Rechnungen zuordnet und Gebühren über eine Importvorlage bucht, und was der Abgleich zurückgibt. Die API-Details finden Sie unter Bank- und Zahlungsimporte. Für Kontoauszugsdateien anstelle einer Live-Verbindung siehe Bankkontoauszüge importieren (camt.053).

1. Bank verbinden

Wählen Sie unter Bank → Verbindungen das Land aus und klicken Sie auf Banken anzeigen. Wählen Sie Ihre Bank und den Kontoinhabertyp (geschäftlich oder privat) aus und klicken Sie auf Verbinden. Sie werden zur bankeigenen Einwilligungsseite weitergeleitet, melden sich dort an und genehmigen den Zugriff; die Bank leitet Sie daraufhin zu Nordlet zurück. Die Verbindung erscheint in der Liste mit ihrem Ablaufdatum für die Einwilligung. Einwilligungen sind seitens der Bank zeitlich begrenzt (häufig 90 oder 180 Tage); läuft eine Einwilligung ab, stellen Sie die Verbindung erneut her.

Die Liste der Banken stammt von dem für die Nordlet-Instanz konfigurierten Open-Banking-Anbieter. Wenn für das Land keine Banken angezeigt werden, unterstützt der Anbieter dieses noch nicht.

2. Bankkonten verknüpfen

Unter der Verbindung wird jedes von der Bank bereitgestellte Konto mit seiner IBAN und Währung aufgelistet. Wählen Sie für jedes Konto ein bestehendes Bankkonto aus dem Kontenplan oder Neues Bankkonto erstellen, legen Sie optional das Startdatum für den Abgleich fest und klicken Sie auf Verknüpfen. Es werden nur verknüpfte Konten synchronisiert. Ohne ein Startdatum für den Abgleich ruft der erste Abgleich die letzten 90 Tage ab.

3. Importvorlage erstellen

Klicken Sie unter Bank → Importvorlagen auf Neue Importvorlage, wählen Sie den Typ Bankverbindung und vergeben Sie einen Namen. Die Zeilen entsprechen den Attributen, die der Bank-Feed pro Transaktion liefert. Das Feld In Datei erforderlich wird der Vollständigkeit halber beibehalten; ein Live-Feed wird nicht dagegen validiert.

Konto. Die einfache Betragszeile transaction_amount.amount und die Regelzeilen können einem Kontenplankonto zugewiesen werden; jede synchronisierte Transaktion aus einer zugewiesenen Zeile wird sofort gebucht und als dem Buchungssatz zugeordnet markiert. Die Regelzeilen wählen Transaktionen anhand des Bankgeschäftsvorfalls-Codes oder der Richtung aus:

Zeile Wählt aus Typisches Konto
Bankgebühren (Code CHRG) Transaktionen mit der Code-Familie CHRG Bankgebührenaufwand (6800 im Kontenrahmen)
Zinsen (Code INTR) Code-Familie INTR Zinserträge oder Zinsaufwendungen
Steuern (Code TAXE) Code-Familie TAXE Steuerzahlungen
Sonstige Auszahlungen jede andere Belastung auf „Nicht gebucht“ belassen, damit Zahlungen Eingangsrechnungen zugeordnet werden
Sonstige Einzahlungen jede andere Gutschrift auf „Nicht gebucht“ belassen, damit Zahlungseingänge Ausgangsrechnungen zugeordnet werden
transaction_amount.amount jede Transaktion, die von keiner Regel erfasst wurde normalerweise „Nicht gebucht“

Eine Transaktion wird auf dem Konto der ersten Zeile verbucht, zu der sie passt: zuerst nach Code-Familie, dann nach Richtung und schließlich nach der einfachen Betragszeile. Der Code stammt aus dem Feld bank_transaction_code der Bank; Banken, die keinen Code übermitteln, lassen die Code-Zeilen ohne Treffer.

Fehlende Kunden/Lieferanten erstellen. Aktivieren Sie Fehlende Kunden erstellen in der Zeile debtor.name, um für jeden unbekannten Zahler von eingehendem Geld einen Kunden anzulegen, und Fehlende Lieferanten erstellen in der Zeile creditor.name für jeden unbekannten Zahlungsempfänger von ausgehendem Geld. Partner werden anhand der IBAN (debtor_account.iban / creditor_account.iban, gespeichert bei den Bankkonten des Partners) und anschließend anhand des exakten Namens erkannt; bei einem über den Namen gefundenen Partner wird die IBAN ergänzt. Ein neuer Partner ist ein Unternehmen, wenn sein Name eine Rechtsform enthält (UAB, MB, SIA, GmbH, Ltd. usw.), und andernfalls eine Privatperson.

Partner für die Bank erstellen. Aktivieren Sie diese Option in der Regelzeile für Bankgebühren. Der Abgleich erstellt einmalig einen Lieferanten mit dem Namen der verbundenen Bank und verbucht jede Gebühr im Journal mit diesem Partner.

Rechnungen über dieses Feld verknüpfen. Aktivieren Sie dies in der Zeile remittance_information oder reference_number. Jede neue Transaktion, deren Verwendungszweck oder Referenznummer die Nummer einer offenen ausgestellten Ausgangsrechnung (Geldeingang) oder einer erfassten Eingangsrechnung (Gelausgang) enthält, wird dieser zugeordnet und die Zahlung wird verbucht. Wenn der Zahler ein bekannter Partner ist – anhand einer gespeicherten IBAN, des exakten Partnernamens oder des Codes –, muss die Rechnung zu diesem Partner gehören. Die Zahlung eines unbekannten Zahlers wird nur dann zugeordnet, wenn sie dem verbleibenden Saldo entspricht und die Rechnungsnummer ihr Serienpräfix enthält. Eine Zahlung, die den verbleibenden Saldo übersteigt, wird niemals zugeordnet. Transaktionen, die diese Prüfungen nicht bestehen, bleiben unzugeordnet, damit Sie sie manuell zuordnen können. Die Option Abschlagsrechnungen für unzugeordnete Zahlungseingänge erstellen wandelt einen unzugeordneten Zahlungseingang von einem bekannten Partner in eine ausgestellte Abschlagsrechnung über den Betrag um, datiert auf das Zahlungsdatum, zum angegebenen Steuersatz oder dem ausgewählten Artikel; hierfür ist Fehlende Kunden erstellen erforderlich, damit der Partner bekannt ist.

Speichern Sie die Vorlage.

4. Vorlage anwenden und Zeitplan wählen

Zurück unter Bank → Verbindungen verfügt jedes verknüpfte Konto über eine Vorlagenauswahl und eine Zeitplanauswahl. Wählen Sie die Vorlage aus, wählen Sie Manuell synchronisieren, Täglich synchronisieren, Wöchentlich synchronisieren oder Monatlich synchronisieren und klicken Sie auf Anwenden. Ein verknüpftes Konto ohne Vorlage wird zwar weiterhin synchronisiert, zeichnet jedoch nur die Transaktionen auf; es wird nichts gebucht, zugeordnet oder erstellt.

Bei einem täglichen, wöchentlichen oder monatlichen Zeitplan synchronisiert die API das Konto eigenständig: Einmal stündlich sucht sie nach Konten, deren letzter Abgleich länger zurückliegt als ihr Intervall (24 Stunden, 7 Tage oder 30 Tage), und führt den Abgleich genau wie bei Jetzt synchronisieren durch, wobei im Anschluss die Vorlage ausgeführt wird. Ein planmäßiger Abgleich zählt wie ein manueller zur Nutzung (alle 10 abgerufenen Transaktionen entsprechen einer Anfrage). Weist die Bank den Abgleich zurück, beispielsweise weil die Einwilligung abgelaufen ist, wird die Verbindung mit dem Fehler markiert und übersprungen, bis Sie die Verbindung erneut herstellen.

5. Synchronisierung

Klicken Sie bei der Verbindung auf Jetzt synchronisieren. Nordlet ruft neue gebuchte Transaktionen für jedes verknüpfte Konto ab; ausstehende (pending) Transaktionen werden übersprungen, bis die Bank sie bucht. Die Abfrage erfolgt seit dem letzten Abgleich mit einer einwöchigen Überlappung, damit verspätete Buchungen nicht übersehen werden. Die Transaktionen werden einmalig erfasst – sie werden anhand der Eintragsreferenz der Bank erkannt – und anschließend wird die Vorlage des Kontos ausgeführt. Die Ergebniszeile zeigt an, wie viele Transaktionen importiert wurden und wie viele bereits vorhanden waren; über die API gibt der Abgleich zudem die Anzahl der gebuchten Bewegungen, erstellten Partner, verknüpften und erstellten Rechnungen, zugeordneten Zahlungen sowie Warnungen für nicht zuordenbare Zahlungen zurück.

Abgleiche können über die API (bank/feeds/sync) nach einem Zeitplan ausgelöst werden; alle 10 abgerufenen Transaktionen zählen dabei als eine API-Anfrage.

6. Wo Sie im Anschluss nachsehen können

  • Bank → Transaktionen – jede synchronisierte Transaktion, unterteilt in Registerkarten pro Konto; zugeordnete Transaktionen verlinken auf die Rechnung oder den Buchungssatz.
  • Rechnungen – Abschlagsrechnungen, die für unzugeordnete Zahlungseingänge erstellt wurden.
  • Partner – erstellte Kunden und Lieferanten, jeweils mit der IBAN unter den Bankkonten.
  • Kontenplan → Journal – die Buchungen für Gebühren (mit der Bank als Partner), Zinsen, Steuern und Zahlungen.

Wenn die Mühseligkeit der Verbindung einsetzt (Fehlerbehebung)

Ein fehlgeschlagener Abgleich kennzeichnet die Verbindung mit der Fehlermeldung der Bank. Eine abgelaufene Einwilligung ist die häufigste Ursache: Klicken Sie erneut für dieselbe Bank auf Verbinden und genehmigen Sie den Zugriff; die verknüpften Konten und deren Vorlagen bleiben erhalten. Trennen entfernt die Verbindung und deren Kontoverknüpfungen, nicht jedoch die bereits erfassten Transaktionen.