korAccountKontoauszüge von der Bank laden
korAccount holt die Umsätze Ihrer Konten direkt bei Ihrer Bank ab, auf zwei Wegen: über den Open-Banking-Dienst YAXI oder über HBCI (FinTS) mit TAN. Diese Seite zeigt, welcher Weg zu Ihrer Bank passt und wie Sie ihn einrichten. Jedes Konto merkt sich seinen Weg, danach genügt Start > Kontoauszug herunterladen.
Welcher Weg zu Ihrer Bank passt
| YAXI | HBCI | Datei-Import | |
|---|---|---|---|
| Verfügbar | ab Version 7 | seit Version 4.7 | immer |
| Banken | mehr als 1.000 in Europa | Banken mit HBCI-Zugang, je Bank verschieden | jede Bank mit Umsatzexport |
| Sie brauchen | einen kostenlosen Schlüssel von YAXI und die IBAN | Bankleitzahl, BIC, HBCI-Adresse, HBCI-Version und Benutzerkennung | eine CSV- oder Excel-Datei aus dem Online-Banking |
| Verbindung | über YAXI zu Ihrer Bank | direkt von Ihrem Rechner zur Bank | keine |
Antwortet Ihre Bank über HBCI nicht oder nicht zuverlässig, ist YAXI meist der einfachere Weg. Der Datei-Import bleibt in jedem Fall verfügbar.
Ohne Gewähr. Ob der Abruf gelingt, hängt von Ihrer Bank und bei YAXI auch von diesem Dienst ab. Beide können ihre Schnittstellen jederzeit ändern. Prüfen Sie die Umsätze vor dem Übernehmen und sichern Sie Ihre Daten regelmäßig. Die Nutzung erfolgt auf eigene Gefahr.
Warum korAccount YAXI nutzt
Nicht jede Bank gibt ihre Umsätze über HBCI heraus, und wo sie es tut, verhält sich jede ein wenig anders. YAXI spricht mit mehr als 1.000 Banken in Europa über deren Schnittstellen und gibt korAccount die Umsätze in einer einheitlichen Form zurück. Für Sie heißt das: IBAN eintragen, anmelden, abrufen, ohne Bankleitzahl, Serveradresse oder HBCI-Version.
YAXI liefert nur die Verbindung. Ihre Konten, Buchungen und Auswertungen bleiben in korAccount auf Ihrem Rechner.
Wie ein Abruf über YAXI abläuft
- Sie starten den Abruf in korAccount und geben Anmeldename und PIN Ihres Online-Bankings ein.
- korAccount baut eine verschlüsselte Verbindung zu YAXI auf. Vorher prüft es, dass auf der Gegenseite der versiegelte Rechenbereich von YAXI läuft, in dem die Anfrage abgeschottet verarbeitet wird. Nach Angaben von YAXI kann dort niemand mitlesen, auch YAXI selbst nicht.
- YAXI meldet sich mit Ihren Zugangsdaten bei Ihrer Bank an. Verlangt die Bank eine Freigabe, zeigt korAccount sie an: Bestätigung in der Banking-App, Code-Eingabe oder Freigabe im Browser.
- Die Umsätze kommen auf demselben Weg zurück zu korAccount. Sie prüfen sie und übernehmen sie ins Konto.
YAXI speichert nach eigener Aussage weder Zugangsdaten noch Kontodaten. korAccount merkt sich den Anmeldename beim Konto, die PIN nie. Die Freigabe der Bank behält korAccount bis zum Beenden des Programms, danach ist sie wieder nötig.
Warum YAXI einen eigenen Schlüssel braucht
korAccount betreibt keinen eigenen Server und schaltet keinen Dienst dazwischen. Der Schlüssel verbindet korAccount auf Ihrem Rechner direkt mit YAXI, und jeder Abruf läuft über Ihren eigenen Zugang. Im Portal von YAXI sehen Sie, welche Abrufe Ihr Schlüssel ausgelöst hat, und können ihn jederzeit löschen.
Der kostenlose Tarif von YAXI reicht für den privaten Gebrauch. Wie viele Abrufe er im Monat enthält, steht auf yaxi.tech. Ein Abruf in korAccount zählt dort meist als zwei Aufrufe, weil Umsätze und Kontostand getrennt geholt werden.
YAXI einrichten
API-Schlüssel bei YAXI erstellen
Das Portal von YAXI ist englisch. Die Namen der Felder stehen deshalb hier so, wie Sie sie dort sehen.
- Öffnen Sie hub.yaxi.tech und wählen Sie Sign up. Legen Sie ein Konto mit Ihrer E-Mail-Adresse an. Fragt das Portal nach Ihrem Namen, tragen Sie als Privatperson Ihren vollständigen Namen ein.
- Öffnen Sie API Keys und wählen Sie New API key.
- Füllen Sie das Formular so aus:
| Feld im Portal | Einstellung für korAccount |
|---|---|
| Name | frei wählbar, zum Beispiel korAccount |
| Environment | Production (free plan) |
| Expiration Date | No expiration. Wählen Sie ein Datum, endet der Abruf an diesem Tag, und Sie brauchen einen neuen Schlüssel. |
| Host Software | Generic |
| Override FinTS Product Registration Number | nicht angehakt. Das Feld erscheint nicht bei jedem Zugang. |
| Enable Redirect Scraping | angehakt |
| Enable Beta Connections | angehakt |
| Prefer FinTS Connections | nicht angehakt. Das Feld erscheint nicht bei jedem Zugang. |
| Service Permissions | nur Accounts, Balances und Transactions |
- Wählen Sie Create.
- Das Portal zeigt jetzt Key ID und Secret. Kopieren Sie beide sofort, zum Beispiel direkt in korAccount wie im nächsten Abschnitt beschrieben. Das Secret zeigt YAXI nur dieses eine Mal an.
Was die Einstellungen bewirken:
- Production ist die Umgebung mit den echten Banken. Die Umgebung Integration enthält nur Testbanken, ein Schlüssel dafür funktioniert in korAccount nicht.
- Redirect Scraping erledigt die Anmeldung im Hintergrund, wenn eine Bank Sie sonst auf ihre eigene Webseite schicken würde. Sie geben die Zugangsdaten dann in korAccount ein. Wo das nicht geht, öffnet korAccount wie gewohnt die Seite Ihrer Bank im Browser.
- Override FinTS Product Registration Number ist für Programme mit einer eigenen, bei der Deutschen Kreditwirtschaft registrierten Produktnummer. Ohne Häkchen verwendet YAXI seine eigene, und genau das braucht korAccount.
- Beta Connections schaltet Bankverbindungen frei, die YAXI noch erprobt. Damit erreichen Sie mehr Banken.
- Service Permissions legt fest, was mit dem Schlüssel möglich ist. korAccount braucht nur drei Dienste: Accounts findet Ihre Konten bei der Bank, Balances liest den Kontostand und Transactions die Umsätze. Lassen Sie Transfer und Collect Payment aus, dann lassen sich mit dem Schlüssel keine Überweisungen auslösen, auch nicht, falls er einmal in falsche Hände gerät. Wählen Sie deshalb nicht Enable All Service Permissions.
Ändern lässt sich ein Schlüssel nach dem Anlegen nicht. Wollen Sie eine Einstellung ändern, legen Sie einen neuen an und löschen den alten.
Schlüssel in korAccount eintragen
Am Desktop: Öffnen Sie Datei > Optionen und tragen Sie im Bereich Online-Banking über YAXI die Key ID als API-Schlüssel-ID und das Secret als Secret ein. Fehlt der Schlüssel noch, wenn Sie den Abruf eines Kontos einrichten, erscheinen dieselben beiden Felder auch dort.
Im Browser: Dieselben Felder stehen unter Einstellungen > Online-Banking.
Am Desktop liegt der Schlüssel in den Einstellungen dieses Rechners, nicht im Datenordner bei Ihren Konten. Auf einem zweiten Rechner tragen Sie ihn deshalb noch einmal ein. Behandeln Sie das Secret wie ein Passwort.
Konto für den Abruf über YAXI einrichten
- Öffnen Sie die Kontoeinstellungen im Reiter Kontoabruf, zum Beispiel über Start > Kontoauszug herunterladen > Kontoabruf einrichten…
- Wählen Sie links YAXI und tragen Sie rechts die IBAN des Kontos ein. korAccount sucht damit die passende Bank bei YAXI.
- Lassen Sie das Konto bei der Bank prüfen. Nach Anmeldename, PIN und gegebenenfalls einer Freigabe zeigt korAccount die Konten Ihrer Bankverbindung, und Sie wählen das richtige aus.
- Schließen Sie die Kontoeinstellungen mit OK.
Ab jetzt lädt Start > Kontoauszug herunterladen die Umsätze dieses Kontos über YAXI. Den Zeitraum legen Sie im Abruffenster fest, bereits vorhandene und vorgemerkte Umsätze sind dort gekennzeichnet und werden nur auf Wunsch übernommen.
HBCI einrichten
Beim Abruf über HBCI geht die Verbindung von Ihrem Rechner direkt zur Bank, ohne Umweg über einen anderen Server. Den Abruf mit starker Kundenauthentifizierung nach PSD2 gibt es seit Version 4.7.
- Öffnen Sie die Kontoeinstellungen im Reiter Kontoabruf, zum Beispiel über Start > Kontoauszug herunterladen > Kontoabruf einrichten…
- Wählen Sie links HBCI / FinTS. Rechts tragen Sie Bank, Bankleitzahl, BIC, Kontonummer, HBCI-Adresse, HBCI-Version und Benutzerkennung ein. Bankdaten suchen… füllt die Angaben der Bank aus einem mitgelieferten Verzeichnis. Prüfen Sie die Werte, das Verzeichnis wird nicht laufend aktualisiert.
- Schließen Sie die Kontoeinstellungen mit OK.
- Starten Sie den Abruf über Start > Kontoauszug herunterladen. TAN-Verfahren und TAN-Medium ermittelt der Abruf selbst und merkt sie sich im Konto. Die PIN wird nicht gespeichert, korAccount fragt sie bei jedem Abruf.
Wechseln Sie später zwischen HBCI und YAXI, bleiben die Angaben des anderen Wegs erhalten. Benutzerkennung für HBCI und Anmeldename für YAXI werden getrennt gespeichert.
Wenn der Abruf von der Bank nicht klappt
korAccount meldet, dass der YAXI-Schlüssel ungültig ist. Prüfen Sie, ob Key ID und Secret vollständig und in den richtigen Feldern stehen. Ist das Secret verloren, legen Sie im Portal von YAXI einen neuen Schlüssel an.
Der Abruf über YAXI ging bisher und geht plötzlich nicht mehr. Hat der Schlüssel ein Expiration Date, ist er vielleicht abgelaufen. Im Portal steht unter API Keys, bis wann er gilt.
Die Bank lehnt die Anmeldung ab. Prüfen Sie Anmeldename und PIN. Gemeint sind die Zugangsdaten, mit denen Sie sich im Online-Banking Ihrer Bank anmelden.
Die Bank antwortet über HBCI nicht. Das Verhalten ist je Bank verschieden, und nicht jede Bankverbindung lässt sich über HBCI abrufen. Versuchen Sie dann den Weg über YAXI.
Keiner der beiden Wege erreicht Ihre Bank. Dann bleibt der Datei-Import: Speichern Sie die Umsätze im Online-Banking als CSV- oder Excel-Datei und lesen Sie sie über Start > Datei importieren ein. Der Assistent merkt sich die Zuordnung der Spalten je Konto.
Fragen zum Abruf beantwortet support [at] kornelius.org.