Bankverbindungen

Diese Anleitung behandelt die Live-Verbindung zu einer Bank (PSD2 Open Banking): wie eine Verbindung herstellt wird, wie die Bankkonten mit Ihrem Hauptbuch verknüpft werden, wie bei jeder Synchronisation über eine Importvorlage Geschäftspartner angelegt, Rechnungen abgeglichen und Gebühren gebucht werden, und welche Ergebnisse die Synchronisation zurückgibt. Die API-Details finden Sie unter Bank- & Zahlungsimporte. Für den Import von Kontoauszugsdateien anstelle einer Live-Verbindung siehe Kontoauszü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 Typ des Kontoinhabers (geschäftlich oder privat) und klicken Sie auf Verbinden. Sie werden auf die Zustimmungsseite der Bank weitergeleitet; loggen Sie sich dort ein und genehmigen Sie den Zugriff. Anschließend leitet die Bank Sie zu Nordlet zurück. Die Verbindung erscheint in der Liste mit dem Ablaufdatum der Einwilligung. Einwilligungen sind seitens der Bank zeitlich befristet (üblicherweise auf 90 oder 180 Tage); sobald eine abläuft, stellen Sie die Verbindung erneut her.

Die Liste der Banken stammt vom Open-Banking-Anbieter, der für die Nordlet-Instanz konfiguriert ist. Wenn für das Land keine Banken angezeigt werden, wird es vom Anbieter noch nicht unterstützt.

2. Bankkonten verknüpfen

Unter der Verbindung wird jedes von der Bank freigegebene Konto mit seiner IBAN und Währung aufgelistet. Wählen Sie für jedes ein bestehendes Bankkonto aus dem Hauptbuch oder Neues Bankkonto erstellen, legen Sie optional das Startdatum für die Synchronisation fest und klicken Sie auf Verknüpfen. Nur verknüpfte Konten werden synchronisiert. Ohne Startdatum werden bei der ersten Synchronisation die letzten 90 Tage abgerufen.

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 zurückgibt. Die Option Erforderlich in Datei wird der Vollständigkeit halber beibehalten; ein Live-Feed wird nicht dagegen validiert.

Sachkonto. Die reine Betragszeile transaction_amount.amount und die Regelzeilen können einem Sachkonto zugewiesen werden; jede aus einer zugewiesenen Zeile generierte, synchronisierte Transaktion wird sofort gebucht und als mit der Journalbuchung abgeglichen markiert. Die Regelzeilen filtern Transaktionen nach Bank-Transaktionscode oder Richtung (Soll/Haben):

Zeile	Erfasst	Typisches Konto
Bankgebühren (Code CHRG)	Transaktionen mit der Code-Familie CHRG	Aufwandskonto für Bankgebühren (6800 im Standardkontenrahmen)
Zinsen (Code INTR)	Code-Familie INTR	Zinserträge oder Zinsaufwendungen
Steuern (Code TAXE)	Code-Familie TAXE	Steuerzahlungen
Sonstige Ausgänge	alle anderen Belastungen (Soll)	"Nicht gebucht" belassen, damit Zahlungen mit Eingangsrechnungen abgeglichen werden können
Sonstige Eingänge	alle anderen Gutschriften (Haben)	"Nicht gebucht" belassen, damit Geldeingänge mit Ausgangsrechnungen abgeglichen werden können
transaction_amount.amount	jede Transaktion, die von keiner Regel erfasst wurde	üblicherweise "Nicht gebucht"

Eine Transaktion wird auf das Konto der ersten passenden Zeile gebucht: zuerst nach Code-Familie, dann nach Richtung und zuletzt nach der reinen Betragszeile. Der Code stammt aus dem Feld bank_transaction_code der Bank; senden Banken keinen Code, erzielen die Code-Zeilen keine Treffer.

Fehlende Kunden / Lieferanten erstellen. Aktivieren Sie Fehlende Kunden erstellen in der Zeile debtor.name, um für jeden unbekannten Zahler eines Geldeingangs einen Kunden anzulegen, und Fehlende Lieferanten erstellen in der Zeile creditor.name für jeden unbekannten Zahlungsempfänger eines Geldausgangs. Geschäftspartner werden anhand der IBAN (debtor_account.iban / creditor_account.iban, die in den Bankkonten des Geschäftspartners hinterlegt ist) und anschließend nach dem exakten Namen erkannt; einem über den Namen gefundenen Geschäftspartner wird die IBAN hinzugefügt. Ein neuer Geschäftspartner wird als Unternehmen angelegt, wenn der Name eine Rechtsform enthält (UAB, MB, SIA, GmbH, Ltd, …), andernfalls als natürliche Person.

Geschäftspartner für die Bank erstellen. Aktivieren Sie dies in der Regelzeile für Bankgebühren. Die Synchronisation legt einmalig einen nach der verbundenen Bank benannten Lieferanten an und erfasst jede Gebühr im Journal mit diesem Geschäftspartner.

Rechnungen über dieses Feld verknüpfen. Aktivieren Sie dies in der Zeile remittance_information oder reference_number. Jede neue Transaktion, deren Verwendungszweck (remittance information) oder Referenz die Nummer einer offenen Ausgangsrechnung (Geldeingang) oder einer erfassten Eingangsrechnung (Geldausgang) enthält, wird mit dieser abgeglichen und die Zahlung gebucht. Die Option Abschlagsrechnungen für nicht abgeglichene Zahlungseingänge erstellen wandelt einen nicht zugeordneten Geldeingang eines bekannten Geschäftspartners in eine ausgestellte Anzahlungsrechnung über diesen Betrag um, datiert auf den Zahlungstag, mit dem angegebenen Umsatzsteuersatz oder dem gewählten Katalogartikel; diese Funktion erfordert Fehlende Kunden erstellen, damit der Geschäftspartner bekannt ist.

Speichern Sie die Vorlage.

4. Vorlage anwenden und Zeitplan auswählen

Zurück unter Bank → Verbindungen verfügt jedes verknüpfte Konto über eine Vorlagen- und eine Zeitplanauswahl. Wählen Sie die Vorlage und anschließend Manuell synchronisieren, Täglich synchronisieren, Wöchentlich synchronisieren oder Monatlich synchronisieren und klicken Sie auf Anwenden. Ein verknüpftes Konto ohne Vorlage wird zwar synchronisiert, erfasst die Transaktionen aber nur; es wird nichts gebucht, abgeglichen oder erstellt.

Bei einem täglichen, wöchentlichen oder monatlichen Zeitplan synchronisiert die API das Konto automatisch: einmal pro Stunde sucht sie nach Konten, deren letzte Synchronisation länger als das jeweilige Intervall (24 Stunden, 7 Tage oder 30 Tage) zurückliegt, und synchronisiert diese genau wie es Jetzt synchronisieren tun würde, wobei anschließend die Vorlage ausgeführt wird. Eine geplante Synchronisation wird genau wie eine manuelle Synchronisation auf die Nutzung angerechnet (jeweils 10 abgerufene Transaktionen = ein Request). Wenn die Bank die Synchronisation ablehnt, beispielsweise weil die Einwilligung abgelaufen ist, wird die Verbindung mit dem Fehler markiert und übersprungen, bis Sie sich erneut verbinden.

5. Synchronisieren

Klicken Sie bei der Verbindung auf Jetzt synchronisieren. Nordlet ruft neue Transaktionen für jedes verknüpfte Konto ab (seit der letzten Synchronisation, mit einer Überschneidung von einer Woche, damit verspätete Buchungen nicht verpasst werden), zeichnet sie einmalig auf – Transaktionen werden an der Buchungsreferenz der Bank erkannt – und führt dann die Kontovorlage aus. Die Ergebniszeile meldet, wie viele Transaktionen importiert wurden und wie viele bereits existierten; über die API liefert die Synchronisation zudem die Anzahl der gebuchten Kontobewegungen, der erstellten Geschäftspartner, der verknüpften und erstellten Rechnungen, der abgeglichenen Zahlungen sowie Warnungen für Zahlungen, die nicht zugeordnet werden konnten.

Synchronisationen können über die API (bank/feeds/sync) zeitplangesteuert ausgelöst werden; jeweils 10 abgerufene Transaktionen zählen als ein API-Request.

6. Wo Sie im Anschluss nachsehen können

• Bank → Transaktionen — jede synchronisierte Transaktion, sortiert in Reitern pro Konto; abgeglichene Transaktionen sind mit der Rechnung oder dem Journalbuchungssatz verlinkt.
• Rechnungen — erstellte Anzahlungsrechnungen für nicht abgeglichene Zahlungseingänge.
• Geschäftspartner — angelegte Kunden und Lieferanten, jeweils mit der IBAN unter den Bankkonten.
• Hauptbuch → Journal — die Buchungen für Gebühren (mit der Bank als Geschäftspartner), Zinsen, Steuern und Zahlungen.

Wenn die Verbindung nicht mehr funktioniert

Eine fehlgeschlagene Synchronisation markiert die Verbindung mit der Fehlermeldung der Bank. Meist ist eine abgelaufene Einwilligung die Ursache: Klicken Sie für dieselbe Bank erneut auf Verbinden und genehmigen Sie den Zugriff; die verknüpften Konten und ihre Vorlagen bleiben dabei erhalten. Trennen entfernt die Verbindung und ihre Kontoverknüpfungen, jedoch nicht die bereits erfassten Transaktionen.