Wenn Sie GoCardless nutzen und noch kein Odoo haben, müssen Sie vor allem wissen, wo jede Auszahlung von GoCardless landet. Mit dem Konnektor (Eintrag in Odoo Apps) legt Odoo 20 pro Auszahlung einen Datensatz an: Betrag, abgezogene Gebühren, Eingangsdatum, Referenz, Status und Typ, dazu die Aufschlüsselung.

Post to accounting.Was jede Auszahlung mitbringt
Wenn das Modul eine neue Auszahlung importiert, legt es den Datensatz mit Betrag, abgezogenen Gebühren, Eingangsdatum, Referenz, Status und Typ von GoCardless an, in der Währung der Auszahlung. Danach holt es ihre Aufschlüsselung. Jeder Datensatz ist dem GoCardless-Konto zugeordnet, aus dem er stammt.
Der Import liefert nur die Auszahlungen zurück, die er tatsächlich angelegt hat. Wird der Import erneut ausgeführt, zählt Bereits Vorhandenes nicht als neu: Die Zählung meldet dasselbe Geld nicht zweimal.

Zwei geplante Aktionen, bei der Installation aktiv
Bei der Installation des Moduls sind zwei geplante Aktionen aktiv:
GoCardless: import payoutsläuft einmal täglich.GoCardless: recover missed eventsläuft stündlich.
Die erste holt die Auszahlungen. Sie geht die GoCardless-Konten durch, die sie verwenden kann, zählt am Ende, wie viele Auszahlungen sie importiert hat, und vermerkt die Fehler mit ihrem Typ und einem festen Code.
Wie der Einzug automatisiert wird
Auch den Einzug löst Odoo aus, über das Mandat, das der Kunde unterschrieben hat. Wenn der Kunde mit GoCardless bezahlt und das Mandat autorisiert, speichert das Modul es als Zahlungsmethode und zieht darüber ein. Danach schickt das Modul jedes Mal, wenn Odoo diese gespeicherte Methode belastet, zum Beispiel beim Erfassen der Zahlung einer Rechnung oder bei der Verlängerung eines Odoo-Abonnements, den Einzug mit einem festen Schlüssel an GoCardless. Antwortet GoCardless auf diese Anfrage nicht, sendet die stündliche geplante Aktion sie mit demselben Schlüssel erneut, sodass der Einzug nur einmal erfolgt. Was danach kommt, die Auszahlungen, holt die tägliche geplante Aktion.
Die Wege des Konnektors im Vergleich
| Situation | Was der Konnektor tut | Detail |
|---|---|---|
| Jeden Tag | Die Aktion GoCardless: import payouts geht die nutzbaren Konten durch und holt ihre Auszahlungen | Bei der Installation aktiv |
| Jede Stunde | Die Aktion GoCardless: recover missed events läuft | Bei der Installation aktiv |
| Nicht verbundenes Konto, mit einer anderen Umgebung als der seines Tokens oder als Kopie erkannt | Die Aktion ruft es nicht auf | Sie würde bei jeder Ausführung nur dieselbe Ausnahme wiederholen |
| Neue Auszahlung | Legt den Datensatz mit Betrag, abgezogenen Gebühren, Eingangsdatum, Referenz, Status und Typ an und holt ihre Aufschlüsselung | Zählt als importiert |
| Bereits importierte Auszahlung | Aktualisiert Status und Eingangsdatum | Zählt nicht als neu; fehlt die Aufschlüsselung, wird sie erneut geholt |
| Auszahlung in einer archivierten Währung | Reaktiviert die Währung | Odoo bestätigt keine Buchung in einer archivierten Währung |
| Auszahlung in einer Währung, die Odoo nicht kennt | Überspringt sie | Wird im technischen Protokoll vermerkt |
| Viele Auszahlungen | Folgt dem Cursor von GoCardless, Seite für Seite | Der Erstimport verliert die ältesten nicht |
| Ein Konto schlägt fehl | Vermerkt den Fehler und macht mit den übrigen weiter | Vermerkt den Fehlertyp und einen festen Code |
| GoCardless begrenzt die Anfragerate | Wartet und versucht es erneut, begrenzt oft | Sind die Versuche erschöpft, zählt es als Fehler dieses Kontos |
Die Fälle im Detail
Eine ausstehende Auszahlung kann sich später ändern
Eine Auszahlung, die importiert wurde, als sie noch ausstand, kann zurückgebucht oder später bezahlt werden. Deshalb legt das Modul, wenn die Auszahlung schon existiert, keine zweite an: Es aktualisiert ihren Status und ihr Eingangsdatum. Beim ersten Status zu bleiben, würde erlauben, eine zurückgebuchte Zahlung auf dem Bankkonto als eingegangen zu verbuchen.
Hat ein früherer Import den Kopf angelegt und ist beim Holen der Aufschlüsselung gescheitert, fordert der nächste sie erneut an. Ohne diesen Schritt bliebe die Auszahlung unstimmig und ließe sich nicht verbuchen.
Ein Fehler in einem Konto stoppt die anderen nicht
Die Aktion ruft nur GoCardless-Konten auf, die verbunden sind, in der Umgebung ihres Tokens liegen und keine Kopie sind. Gibt ein Konto einen Fehler, vermerkt sie ihn und macht mit dem nächsten weiter. Der Fehler wird mit seinem Typ und einem festen Code vermerkt, nie mit einer GoCardless-Kennung oder deren Text.
Vollständiger Erstimport
GoCardless liefert die Auszahlungen seitenweise. Das Modul folgt dem Cursor, bis keine mehr kommen, denn bei der ersten Seite stehen zu bleiben, würde beim Erstimport alle älteren Auszahlungen stillschweigend verlieren.
Archivierte Währungen
Odoo bringt alle Währungen mit, lässt aber die ungenutzten archiviert. Zahlt GoCardless in einer davon aus, reaktiviert das Modul sie, weil das Geld in dieser Währung eingegangen ist und in der Buchhaltung nutzbar sein muss. Existiert die Währung in Odoo nicht, wird die Auszahlung übersprungen.
Anfragelimit
Begrenzt GoCardless die Anfragerate, wartet das Modul und versucht es erneut, aber nur begrenzt oft. Klappt es weiterhin nicht, vermerkt die Aktion den Fehler dieses Kontos mit seinem Typ und einem festen Code und macht mit den übrigen weiter.
Wie FlexigoTech Ihnen hilft
Wenn Sie Odoo noch nicht nutzen, führt FlexigoTech Odoo 17, 18, 19 und 20 ein und entwickelt Konnektoren und individuelle Integrationen: Wir können Odoo aufsetzen und den GoCardless-Konnektor zum Laufen bringen. Das Modul finden Sie im Eintrag in Odoo Apps und auf der Seite des Konnektors. Der Konnektor funktioniert mit dem Abonnement für FlexigoTech Cloud.
Weiterlesen
Geprüft im Quellcode des Connectors (Version 20.0) und in den verlinkten Quellen
Quellen
- Quellcode des Moduls: flexigo_payment_gocardless 20.0 (6fe1a716): data/ir_cron_data.xml
- Quellcode des Moduls: flexigo_payment_gocardless 20.0 (6fe1a716): models/payment_provider.py
- flexigotech.com/en/services.html
- Quellcode des Moduls: flexigo_payment_gocardless 20.0 (6fe1a716): models/gocardless_payout.py
