Projekt

Allgemein

Profil

Umstellung von SWIFT MT940 auf CAMT (November 2025)

Einige Banken schalten den Job HKKAZ ab ("Umsatzabruf mit SWIFT MT940 Daten"). Dadurch ist bei diesen Banken kein Umsatzabruf mehr möglich, es sei denn, man setzt das Konto-Flag "CAMT Download bevorzugen" (in den Onlinebanking-Einstellungen zum Konto).

Zudem stellen einige Banken auch das verwendete CAMT-Format um und verlangen jetzt camt.052.001.08. AqBanking unterstützt bisher aber nur camt.052.001.02.

Ein Hotfix bis zur nächsten Version von AqBanking wird nachfolgend vorgestellt.

Hotfix

Neue Dateien aus dem GIT herunterladen und installieren

$PREFIX ist dabei üblicherweise "/usr", bei eigenem Kompilieren und Installieren "/usr/local" (einfach schauen, welche Verzeichnisse schon existieren).

CAMT-Download aktivieren

In den Kontoeinstellungen beim Onlinebanking (im Menue bei GnuCash, KMyMoney oderAqFinance) das Kästchen "CAMT Download bevorzugen" aktivieren.

Kundeninformationen aktualisieren

In den Benutzereinstellungen beim Onlinebanking "Kontenliste abrufen" aufrufen.

Hintergrund der Problematik

Banken schalten HKKAZ ab

Erstellen der Auftragsliste/Limitliste

Generell gibt es zwei Möglichkeiten, Umsätze abzurufen: Auftrag HKKAZ (Abruf als SWIFT MT940 Daten) und HKCAZ (Abruf als CAMT.052-Daten).

HKKAZ ist ein sehr alter Auftrag zum Abrufen der Umsatzdaten, dieser wurde bisher standardmässig verwendet, einfach weil es früher gar keine Alternative dazu gab.

HKCAZ ist neuer und gibt Daten in einem XML-Format zurück.

Wenn AqBanking neue Kundeninformationen erhält (z.B. weil die Bank sie aktualisiert hat), wird AqBanking's interne Liste an Bankkonten und Beschreibungen dazu (die sogenannten "AccountSpecs") neu aufgebaut. Dabei wird einmal jeder mögliche Auftrag erzeugt um die verschiedenen Begrenzungen der Aufträge zu aktualisieren (z.B. ob ein Auftrag überhaupt mit einem bestimmten Konto erlaubt ist, wie lange der Vorlauf bei terminierten Überweisungen sein darf, wie weit zurück das Startdatum beim Umsatzabruf sein darf etc).

Wenn dabei der Auftrag zum Umsatzabruf erzeugt wird, hängt von den Benutzereinstellungen ab, welcher Auftrag letztendlich erzeugt wird: Ist das Konto-Flag "preferCamtDownload" gesetzt, wird der Auftrag HKCAZ erzeugt, sonst der alte HKKAZ.

Wenn nun der Benutzer dieses Flag nicht gesetzt hat und die Bank den Job HKKAZ nicht mehr anbietet, kann kein Auftrag zum Abrufen der Umsatzdaten erzeugt werden, also taucht dieser Auftrag nicht in den AccountSpecs auf.

Die Lösung sollte nun sein, dieses Flag zu setzen (z.B. in der Gui unter Onlinebanking-Einrichtung, Konto, Kontoeinstellungen, "CAMT Download bevorzugen") und dann noch mal die Kontenliste abzurufen (auch im Onlinebanking-Menue, Benutzer, "Kontoliste abrufen").

Warum wird nicht automatisch HKCAZ verwendet?

Beim Aendern des Flags "preferCamtDownload" aendern sich die empfangenen Daten, weil leider die alten SWIFT MT940-Daten andere Inhalte haben, als die Daten in einem CAMT.052. Dadurch kann es in der Buchhaltungssoftware zu Duplikaten kommen, die man dann mindestens teilweise manuell entfernen muss.
So ein Fall koennte aber z.B. auch auftreten, wenn die Bank hypothetisch komplett auf eine neue Version von HKKAZ umgestellt haette, die wir vielleicht noch nicht implementiert haetten. Dann wuerde AqBanking auf CAMT wechseln (und Duplikate provozieren). Wenn dann das gleiche mit dem Job HKCAZ passiert, wuerde AqBanking wieder automatisch auf HKKAZ wechseln (und auch wieder Duplikate erzeugen).

AqBanking haelt sich da lieber an die Vorgaben des Benutzers, und da AqBanking viel von der Konsole benutzt wird, z.T. auch im produktivem Umfeld, waeren unvorhersehbare, automatische Wechsel inakzeptabel.

Warum schalten wir nicht einfach HKKAZ ab?

Das geht derzeit noch nicht, da es eben doch noch Banken gibt, die nicht HKCAZ anbieten, bzw. die noch HKKAZ verwenden. Die Standardvorgabe zu aendern, waere auch nicht so einfach, dazu muesste man das Flag "preferCamtDownload" ersetzen. Dann muessten aber die Benutzereinstellungen geaendert werden, und nicht jeder will gezwungen werden, die Art des Umsatzabrufes zu aendern, nur weil manche Banken das fuer andere User vorgeben. Ausserdem gaebe das ein Chaos bei Usern, die z.B. GnuCash aus AppImages verwenden und parallel vielleicht noch ein installiertes KMyMoney, aqbanking-cli oder andere Pogramme.

Banken steigen um auf neuere CAMT-Formate

Nun hat man also schon umgestellt auf CAMT-Abruf, aber einige Banken verlassen die alten CAMT-Versionen.

Bisher wurde camt.052.001.02 verwendet, diese Banken sind aber jetzt auf camt.052.001.08 umgestiegen, und dafür hat AqBanking erst seit Version 6.7.9beta einen inzwischen auch bereits getesteten Importer.