Kontoauszüge importieren: Live Bank Anbindung (finAPI)

API: Die PIN/TAN-URL erhältst du auf Anfrage von deiner Bank. Inzwischen besitzen die meisten Produkte ihre eigene Verbindungsdaten(bank).

FHP_BANK_URL=>https://urlyourbankissues.de/abc/def;
FHP_BANK_IBAN=>DE1234567890123456789;
FHP_BANK_BIC=>ABCDEF123456;
FHP_ONLINE_BANKING_USERNAME=>123456789;
FHP_ONLINE_BANKING_PIN=>{PASSWORD};
API_DAYS=>10;
LOGGING=>1;
FHP_TAN_VERFAHREN=>photoTAN;

Die folgenden Parameter sind besser über ein Beispiel verständlich. Nehmen wir an der letzte Liveimport fand am 01.01.2022 statt und heute ist der 19.01.2022.

Mit dem Parameter API_DAYS wird angegeben, wie lange es dauert bis der nächste Import stattfindet. Es wird ein Zeitraum zwischem dem letzten Import und dem aktuellen Zeitpunkt geschaffen. In unserem Beispiel ist API_DAYS => 10, d.h. beim nächsten Import werden die Daten vom 10.01.22 bis zum heutigen Tag (19.01.22) importiert. Die Tage werden also zum letzten Importdatum hinzu addiert.

API_MAX_DAYS_BEFORE gibt die Tage an, welche maximale Anzahl an Tagen vor dem letzten Import berücksichtigt werden sollen. Ist API_MAX_DAYS_BEFORE => 90, werden 90 Tage vor dem letzten Import mitberücksichtigt. Das wären in diesem Fall die Daten vom 03.10.2021 bis zum heutigen Tag (19.01.22). Die Tage werden also vom letzten Importdatum abgezogen.

Beim Parameter API_DAYS_WAIT können aktuelle Daten ignoriert werden. Ist API_DAYS_WAIT => 1, dann wird der heutige Tag nicht mit importiert. Dies bedeutet für unser Beispiel, dass nur die Daten vom 01.01.22 bis zum 18.01.22 importiert würden. Die hier angegebenen Tage werden also vom aktuellen Tag abgezogen.

LOGGING gibt bei aktiviertem logfile (module=logfile) die Transaktionen beim Abholen der Zahlungseingänge ab. Hier können die Detailstufen 1 bis 5 verwendet werden.

FHP_TAN_VERFAHREN beinhaltet das TAN Medium über das die TAN generiert wird. Wie genau das Medium heißt, ist abhängig von der TAN Methode, die die Bank zulässt.

Beispiele für Bank-URLs:

Sonderfall: Bei der Postbank hat ein Business Konto unter Umständen hinter der neuen Zugangs-ID noch zusätzlich ein Profil hinterlegt. Dieses beginnt mit dem Zeichen #, dann folgen Buchstaben und Zeichen. Damit funktioniert der Live-Import unter Umständen.

FHP_BANK_URL=>https://hbci.postbank.de/banking/hbci.do;
FHP_BANK_IBAN=>DE123456789012345678;
FHP_BANK_BIC=>PBNKDEFF;
FHP_ONLINE_BANKING_USERNAME=> (Customer-ID)#XXX;
FHP_ONLINE_BANKING_PIN=>{PASSWORD};
API_DAYS=>7;

Klicke auf die Schaltfläche Passwort setzen und gib das Passwort ein. Das Passwort wird bei der Eingabe verschlüsselt dargestellt und das Feld nach dem Speichern geleert. Wenn du dir nicht mehr sicher bist, ob das Passwort richtig ist, gib es erneut ein. Das Setzen des Passworts ist ein eigenes Recht in der Benutzerverwaltung.

Bitte prüfe, ob in deinem Online Banking die Funktion HBCI + bzw. FinTS oder PIN/TAN aktiviert ist. Diese Funktion kann z.B. bei der Deutschen Bank hier aktiviert werden:

Sammellastschriften können in Xentral im Modul Zahlungsverkehr erstellt werden. Dabei werden mehrere Zahlungen zu einer gesammelten Zahlung zusammengefasst.

Diese Zahlungen können durch Xentral wieder in Einzelpositionen aufgelöst werden. Dies ist in den Kontoauszügen in Xentral sichtbar und erleichtert die Zuordnung der Zahlungen zu Aufträgen, Gutschriften und Rechnungen.

Gehe wie folgt vor, um Einzelbuchungen zu aktivieren: