De/SEPA-Lastschrift

Hier wird die Einrichtung von AqBanking (de/HBCI) für die Nutzung von SEPA-Lastschriften beschrieben. Zwar ist das kein direktes GnuCash-Thema, aber hier war gerade ein Wiki verfügbar.

Voraussetzungen: Aqbanking 5.4.3 oder höher musste installiert sein.

Einrichtung

Für die Einrichtung des Zugangs geht man zunächst so vor wie im "AqBanking Handbuch" http://www2.aquamaniac.de/sites/download/packages.php beschrieben.

Test

Man verifiziert dann den funktionierenden Zugang durch Prüfen von "Saldoabruf" und "Umsatzabruf". Auf der Kommandozeile ein Saldoabruf:

aqbanking-cli request --balance -a $ACCOUNTNUM -c $CONTEXTFILE
aqbanking-cli listbal -a $ACCOUNTNUM -c $CONTEXTFILE

wobei $ACCOUNTNUM die Kontonummer ist und $CONTEXTFILE ein beliebiger Dateiname, in dem beim Abruf die erhaltenen Daten reingeschrieben werden und sie danach mit listbal wieder ausgelesen werden.

SEPA-Informationen

Nun muss man die SEPA-Informationen zum Konto noch abrufen (jedenfalls noch in aqbanking 5.5.x):

aqhbci-tool4 getaccsepa -a $ACCOUNTNUM

Die fertige Konfiguration besteht nun aus dem Inhalt des Verzeichnisses $HOME/.aqbanking sowie ggf. der Schlüsseldatei. Im Verzeichnis $HOME/.aqbanking werden außerdem zu jeder Kommunikation mit dem Server auch Logs abgelegt - die muss man natürlich nicht aufheben, sofern man nicht später noch was nachschauen will. Alle anderen Verzeichnisse und Dateien dort enthalten verschiedene Elemente der Konfiguration.

Lastschrift-Import

Nun muss man sich eine Beschreibung der Import-Tabellen-Datei zurechtlegen. In AqBanking heißen die Formatbeschreibungen von Import-Tabellen "Profiles". Die Details sind im "AqBanking Handbuch", Kapitel 11, beschrieben. Ein mögliches Import-"profile" ist hier vorgeschlagen:

char name="sepalast"
char shortDescr="import sepa debitnotes"
int import="1"
char type="csv"
char subject="debitnotes"
params {
        quote="0"
        title="0"
        delimiter="TAB"
        columns {
                1="localBankCode"
                2="localAccountNumber"
                3="remoteIBAN"
                4="remoteBIC"
                5="remoteName[0]"
                6="value/value"
                7="value/currency"
                8="purpose[0]"
                9="purpose[1]"
                10="creditorSchemeId"
                11="mandateId"
                12="mandateDate"
                13="sequenceType"
                14="date"
        }
}

Diese Formatbeschreibung muss in einer Datei mit dem Suffix ".conf" (wichtig!) abgespeichert werden, z.B. sepalast.conf, und diese Datei in den Ordner $prefix/share/aqbanking/imexporters/csv/profiles/ kopiert werden (wichtig!). (Leider funktionieren in aqbanking 5.4.x und 5.5.x die Kommandozeilenoption --profileFile nicht.)