Volksbank Zuffenhausen

Die Volksbank Zuffenhausen ist an das Fiducia Rechenzentrum angeschlossen, welches auch den HBCI Zugang übernimmt. Meines Wissens werden die meisten Volksbanken in Baden-Württemberg dort versorgt.

Es gibt folgende Möglichkeiten:

Diskettenversion (RDH)
RSA-Karte "VR-NetWorld Card" (derzeit von OpenHBCI nicht unterstützt)

Diese Beschreibung gilt daher nur für die Diskettenversion.

An HBCI-Funktionen (Geschäftsvorfälle) werden unterstützt:

Saldenabfrage (Kontostand ermitteln)
Kontoumsätze (Buchungshistorie abrufen)
Einzelüberweisung
Sammelüberweisung (nicht von OpenHBCI unterstützt)
Einzellastschrift
Sammellastschrift (nicht von OpenHBCI unterstützt)

Die Funktion 'Kontoliste' (engl: accountlist) wird nicht unterstützt. Man muss daher das Konto selbst einrichten.

Einrichtung mit AqMoney

Ich beschreibe hier die Verwendung von AqMoney, da sich hier die Kommunikation mit der Bank am einfachsten verfolgen lässt.

Von der Bank erhält man einen Ini-Brief der in etwa so aussieht:

  HBCI-Ini-Brief

  Kundennummer: xxxxxxx
  Bankleitzahl: xxxxxxxx
  unterstützte HBCI-Version: 2.01 und 2.1

  unsere Kommunikationsadressen für HBCI lauten: Domainadresse: .......
                                                 TCP/IP-Adresse: ...........


  Benutzerkennung: xxxxxxxxxxxxxxx
  Hash-Wert        xx xx xx xx xx xx xx xx xx xx
                   xx xx xx xx xx xx xx xx xx xx

Zuerst richtet man in aqmoney einen Benutzer ein:

  aqmoney --user="<Benutzerkennung>" --institute="<Bankleitzahl>" --medium="<Pfad zum Keyfile>" --mediumtype="file" --server="<IP-Adresse>" createuser

Wenn man von der Bank zusätzlich zur Benutzerkennung noch eine Kundennummer bekommen hat, muss man diese bei diesem Schritt zusätzlich per --customer="<Kundennummer>" angeben!

In diesem "Keyfile" werden die Schlüssel der Bank und der eigene gespeichert. Im darauf folgenden Dialog wird man nach einer PIN gefragt. Diese darf man sich selber ausdenken - sie sollte aber den Ansprüchen eines Passwortes genügen.

Dann holt man sich den Public-Key der Bank:

  aqmoney --user="<Benutzerkennung>" --institute="<Bankleitzahl>" getkeys

Als Ergebnis erhält man dann:

  Neuer Auftrag: Verbindung herstellen
  Auftrag erledigt.
  Neuer Auftrag: Schluessel des Servers abrufen
   Pin-Eingabe
   --------------------------------------------------------
    Sie koennen die Pin-Eingabe abbrechen, indem sie direkt
    ENTER druecken ohne die Pin einzugeben.
    Abgeschlossen wird die Pineingabe durch ENTER.
   --------------------------------------------------------
   Bitte geben Sie die derzeitige Pin ein fuer <Bankleitzahl>:
   Pin :
   Ergebnis: Die UPD wird aktualisiert (Code 3050, 3)
   Ergebnis: Nachricht/ Auftrag angenommen (Code 10)
   Ergebnis: Nachricht/ Auftrag angenommen (Code 10)
   Ergebnis: Nachricht/ Auftrag angenommen (Code 100)
  Auftrag erledigt.
  Neuer Auftrag: Verbindung trennen
  Auftrag erledigt.

Nun überprüft man, ob der Key der Bank in Ordnung ist:

  aqmoney --user="<Benutzerkennung>" --institute="<Bankleitzahl>" --key="institute" iniletter

Das Ergebnis sollte in etwa so aussehen:

 Pin-Eingabe
 --------------------------------------------------------
  Sie koennen die Pin-Eingabe abbrechen, indem sie direkt
  ENTER druecken ohne die Pin einzugeben.
  Abgeschlossen wird die Pineingabe durch ENTER.
 --------------------------------------------------------
 Bitte geben Sie die derzeitige Pin ein fuer VOLKSBANK <Ort>:
 Pin :



INI-Brief

Datum              : 20.08.2003
Uhrzeit            : 16:06.12
Institutskennung   : xxxxxxxxx
Kundensystemkennung: AqMoney 0.6.1

Oeffentlicher Schluessel fuer die elektronische Signatur

  Exponent

   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX

  Modulus

   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX

  Hash

   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX

Den Hash sollte man mit dem im Ini-Brief der Bank genannten vergleichen. Sollten diese unterschiedlich sein, muss man das mit der Bank abklären.

Als nächstes liefert man seinen öffentlichen Key bei der Bank ab:

  aqmoney --user="<Benutzerkennung>" --institute="<Bankleitzahl>" sendkeys

Als Egebnis sieht man folgendes auf seinem Bildschirm:

Neuer Auftrag: Verbindung herstellen
Auftrag erledigt.
Neuer Auftrag: Oeffentliche Schluessel senden
 Pin-Eingabe
 --------------------------------------------------------
  Sie koennen die Pin-Eingabe abbrechen, indem sie direkt
  ENTER druecken ohne die Pin einzugeben.
  Abgeschlossen wird die Pineingabe durch ENTER.
 --------------------------------------------------------
 Bitte geben Sie die derzeitige Pin ein fuer VOLKSBANK <Ort>:
 Pin :
 Ergebnis: Öffentlicher Schlüssel wurde entgegengenommen (Code 10)
 Ergebnis: Öffentlicher Schlüssel wurde entgegengenommen (Code 10)
Auftrag erledigt.
Neuer Auftrag: Verbindung trennen
Auftrag erledigt.

Wenn in diesem Schritt direkt nach der PIN-Eingabe die Meldung ERROR: nothing received (113) at API::_handleMessageQueue() erscheint, sollte man alle Benutzerdaten (Benutzerkennung/Kundennummer) nochmal überprüfen. Der Schlüssel wurde in diesem Fall noch nicht versendet.
$/!\$ Man darf seinen öffentlichen Schlüssel nur einmal einliefern. Geht das irgendwie schief muss man die Bank bitten den öffentlichen Schlüssel zu löschen.

Damit die Bank den Zugang freischalten kann, generiert man seinen Ini-Brief, druckt ihn aus, unterschreibt ihn und schickt ihn per Post an die Bank.

  aqmoney --user="<Benutzerkennung>" --institute="<Bankleitzahl>" --key="user" iniletter

Das kommt dabei heraus:

 Pin-Eingabe
 --------------------------------------------------------
  Sie koennen die Pin-Eingabe abbrechen, indem sie direkt
  ENTER druecken ohne die Pin einzugeben.
  Abgeschlossen wird die Pineingabe durch ENTER.
 --------------------------------------------------------
 Bitte geben Sie die derzeitige Pin ein fuer VOLKSBANK <Ort>:
 Pin :



INI-Brief

Benutzername       : __________________________
Datum              : 20.08.2003
Uhrzeit            : 15:11:35
Benutzerkennung    : xxxxxxxxxxxxxxxxxx
Schluesselnummer   : 1
Schluesselversion  : 1
Kundensystemkennung: AqMoney 0.6.1

Oeffentlicher Schluessel fuer die elektronische Signatur

  Exponent

   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX

  Modulus

   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX

  Hash


   XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX XX
   XX XX XX XX


Ich bestaetige, dass ich den obigen Schluessel
fuer meine elektronische Signatur ermittelt habe.


_________________________  ____________________________
Ort/Datum                  Unterschrift

Damit der Iniletter auch in einer Datei landet, muß man ihn per Umlenkung (">iniletter.txt" an obige Kommandozile anhängen) speichern. Diese Datei kann man dann mit folgendem Befehl in eine 'schöne' Postscript-Seite zum Drucken verwandeln:

a2ps -n 1 -s 1 -f 15 -B --portrait --columns=1 iniletter.txt -o iniletter.ps

Zum Archivieren kann letztere mit ps2pdf in ein pdf Umgewandelt werden, welches nur wenige Bytes größer ist als die ursprüngliche Textdatei.

Nach dem Ausdrucken, Unterschreiben und Absenden wartet man ein paar Tage, bis die Bank den Zugang freigeschaltet hat.

Dann richtet man sein Konto ein. Da die Volksbank Zuffenhausen das Abrufen der verfuegbaren Konten nicht unterstuetzt muss man das manuell eintragen:

  aqmoney --user="<Benutzerkennung>" --institute="<Bankleitzahl>" --account="<Kontonummer>" accadd

Danach läßt man sich seiner Anwendung (hier aqmoney) von der Bank eine Anwendungskennung zuteilen:

  aqmoney --user="<Benutzerkennung>" --institute="<Bankleitzahl>" --syncmode=sysid sync

Die Bildschirmausgabe sieht dazu so aus:

Neuer Auftrag: Verbindung herstellen
Auftrag erledigt.
Neuer Auftrag: Systemkennung abrufen
 Pin-Eingabe
 --------------------------------------------------------
  Sie koennen die Pin-Eingabe abbrechen, indem sie direkt
  ENTER druecken ohne die Pin einzugeben.
  Abgeschlossen wird die Pineingabe durch ENTER.
 --------------------------------------------------------
 Bitte geben Sie die derzeitige Pin ein fuer VOLKSBANK <Ort>:
 Pin :
 Ergebnis: Die UPD ist bereits aktuell (Code 20, 2)
 Ergebnis: Neue Kunden-ID zurueckgemeldet (Code 20)
 Ergebnis: Nachricht/ Auftrag angenommen (Code 100)
Auftrag erledigt.
Neuer Auftrag: Verbindung trennen
Auftrag erledigt.

Danach kann man seinen aktuellen Kontostand abrufen:

  aqmoney --institute="<Bankleitzahl>" --account="<Kontonummer>" balance

Bei erfolgreicher Abfrage sieht man dies:

Neuer Auftrag: Verbindung herstellen
Auftrag erledigt.
Neuer Auftrag: Dialog eroeffnen
 Pin-Eingabe
 --------------------------------------------------------
  Sie koennen die Pin-Eingabe abbrechen, indem sie direkt
  ENTER druecken ohne die Pin einzugeben.
  Abgeschlossen wird die Pineingabe durch ENTER.
 --------------------------------------------------------
 Bitte geben Sie die derzeitige Pin ein fuer VOLKSBANK <Ort>:
 Pin :
 Ergebnis: Die UPD ist bereits aktuell (Code 20, 2)
Auftrag erledigt.
Neuer Auftrag: Kontostand abrufen
 Ergebnis: AUFTRAG ENTGEGENGENOMMEN (Code 20)
Auftrag erledigt.
Neuer Auftrag: Dialog schliessen
 Ergebnis: Nachricht/ Auftrag angenommen (Code 100)
Auftrag erledigt.
Neuer Auftrag: Verbindung trennen
Auftrag erledigt.
Got balance.

Wenn man will kann man alle verfügbaren Kontobewegungen abrufen. Das Kommando dazu ist:

  aqmoney --institute="<Bankleitzahl>" --account="<Kontonummer>" turnover

Das bekommt man dann zu sehen:

Neuer Auftrag: Verbindung herstellen
Auftrag erledigt.
Neuer Auftrag: Dialog eroeffnen
 Pin-Eingabe
 --------------------------------------------------------
  Sie koennen die Pin-Eingabe abbrechen, indem sie direkt
  ENTER druecken ohne die Pin einzugeben.
  Abgeschlossen wird die Pineingabe durch ENTER.
 --------------------------------------------------------
 Bitte geben Sie die derzeitige Pin ein fuer VOLKSBANK <Ort>:
 Pin :
 Ergebnis: Die UPD ist bereits aktuell (Code 20, 2)
Auftrag erledigt.
Neuer Auftrag: Kontoauszuege abrufen
 Ergebnis: ausgefuehrt (Code 20)
Auftrag erledigt.
Neuer Auftrag: Kontostand abrufen
 Ergebnis: AUFTRAG ENTGEGENGENOMMEN (Code 20)
Auftrag erledigt.
Neuer Auftrag: Dialog schliessen
 Ergebnis: Nachricht/ Auftrag angenommen (Code 100)
Auftrag erledigt.
Neuer Auftrag: Verbindung trennen
Auftrag erledigt.

Jetzt kann man sich ansehen was man da so alles bekommen hat:

  aqmoney --balance --transactions dump

Zum Schluss: Man sollte das "Keyfile" und die Datei '..openhbci' in regelmäßigen Abständen sichern.

Übernahme in GnuCash

Zunächst sollte man die obige Anleitung bis zur Erstellung einer Anwendungskennung (inklusive) mit aqmoney befolgen. Danach startet man einfach GnuCash, legt eine neue Datei an und wählt im Menü "Werkzeuge" den Eintrag "HBCI Einrichtung". Im Assistenten wählt man dann den Pfad- und Dateiname der Konfigurationsdatei, die von aqmoney angelegt wurde (~/.openhbci). Im nächsten Schritt wird dann bereits eine Liste mit den HBCI-Konten der Bank angezeigt. Jedem dieser Konten kann man dann mit einem einfachen Klick ein GnuCash-Konto zuweisen.

Normale Anwendung

Neueste Kontobewegungen abholen

  aqmoney --institute="<Bankleitzahl>" --account="<Kontonummer>" turnover

Man kann bei diesem Kommando den Zeitraum der angeforderten Kontobewegungen mit zusätzlichen Optionen einschränken.

Kontobewegungen in lesbarer Form darstellen

  aqmoney --balance --transactions --outformat=html dump > aqmoney-dump.html

Das listet die Kontobewegungen im HTML-Format auf und schreibt diese aqmoney-dump.html. Natuerlich darf man auch einen anderen Dateinamen angeben. Diese Datei kann man sich dann mit einem Browser (konquerer, Netscape, etc.) ansehen.

OpenHBCI/GetesteteBanken/VolksbankZuffenhausen (zuletzt geändert am 2007-12-23 22:46:51 durch localhost)