Difference between revisions of "De/SEPA-Lastschrift"
(initial explanation) |
(next tep) |
||
| Line 3: | Line 3: | ||
Voraussetzungen: Aqbanking 5.4.3 oder höher musste installiert sein. | Voraussetzungen: Aqbanking 5.4.3 oder höher musste installiert sein. | ||
| − | 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. Man verifiziert dann den funktionierenden Zugang durch Prüfen von "Saldoabruf" und "Umsatzabruf". Auf der Kommandozeile ein Saldoabruf: | + | == 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 request --balance -a $ACCOUNTNUM -c $CONTEXTFILE | ||
| Line 9: | Line 15: | ||
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. | 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. | ||
| − | Nun muss man die SEPA-Informationen zum Konto noch abrufen: | + | === SEPA-Informationen === |
| + | Nun muss man die SEPA-Informationen zum Konto noch abrufen (jedenfalls noch in aqbanking 5.5.x): | ||
aqhbci-tool4 getaccsepa -a $ACCOUNTNUM | 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: | ||
| + | <pre> | ||
| + | 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" | ||
| + | } | ||
| + | } | ||
| + | </pre> | ||
| + | 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.) | ||
Revision as of 19:44, 22 September 2014
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.)
