GoCardless mandate_replaced: das Mandat hat einen Nachfolger

Was GoCardless meldet

Die Ereignisdokumentation erklärt es so: «The mandate has been cancelled and replaced by a new mandate (for example, because the creditor has moved to a new Service User Number).». Und das Ereignis enthält: «The event will include links[new_mandate] with the ID of the new mandate.».

mandate_replaced ist ein Fehler vom Typ invalid_state: Die Aktion ist im aktuellen Zustand der Ressource nicht gültig. Bei solchen Fehlern empfiehlt GoCardless, den Benutzer zu informieren und keinen erneuten Versuch zuzulassen («invalid_state → inform the end user, do not allow retry.»).

Wann es auftritt

Die Änderung wird nicht vom Kunden oder seiner Bank ausgelöst: Das Ereignis replaced hat den Ursprung gocardless, und die dokumentierte Ursache ist, dass der Gläubiger, also das Konto, über das Sie bei GoCardless einziehen, zu einem neuen Identifikator des Schemas gewechselt ist. GoCardless storniert das alte Mandat und legt an dessen Stelle ein neues an.

mandate_replaced erscheint nur, wenn Odoo mit dem alten Mandat einzieht: die Abbuchung eines verlängerten Abonnements oder eine Zahlung mit der gespeicherten Zahlungsmethode des Kunden, bevor Odoo das Ereignis verarbeitet hat.

Was der Konnektor in Odoo macht

Mit dem Ereignis replaced:

1. Übernimmt er das neue Mandat aus links.new_mandate.
2. Überträgt er die gespeicherte Zahlungsmethode des Kunden auf dieses neue Mandat und behandelt sie als gültig. Ist die Methode archiviert, wird sie wieder aktiviert; Odoo 17 erlaubt das nicht, dort erstellt der Konnektor für das neue Mandat eine neue.
3. Schreibt er dies in den Kundendatensatz: «The GoCardless mandate is usable again (replaced).».

Diesen Vermerk schreibt der Konnektor beim Verarbeiten des Ereignisses, ohne dass jemand eingreift. Der Konnektor ist nicht ins Deutsche übersetzt: Diese Texte erscheinen immer auf Englisch, auch in einem deutschen Odoo, egal ob ein Benutzer oder eine geplante Aktion sie auslöst: «The GoCardless mandate is usable again (replaced).».

Bei mandate_replaced in einer Zahlung unternimmt der Konnektor nichts Besonderes: Beim Anlegen einer Zahlung behandelt er gesondert nur mandate_is_inactive. Die Transaktion geht in den Status «Fehler» mit «GoCardless rejected the request.» und darunter der Meldung von GoCardless mit mandate_replaced und der request_id in eckigen Klammern. Das neue Mandat entnimmt er dem Ereignis, nicht dem Fehler. Der Konnektor ist nicht ins Deutsche übersetzt: Diese Meldung erscheint immer auf Englisch, auch in einem deutschen Odoo, egal ob ein Benutzer oder eine geplante Aktion die Zahlung auslöst: «GoCardless rejected the request.».

Was zu tun ist

1. Bleibt eine Zahlung mit mandate_replaced im Fehler stehen, öffnen Sie die Transaktion über die Rechnung, mit der Schaltfläche «Zahlungstransaktion» oben; das Menü der Transaktionen erscheint nur im Entwicklermodus und existiert in Odoo 20 nicht.
2. Prüfen Sie im Kundendatensatz, ob der Vermerk steht, dass das Mandat wieder verwendbar ist (replaced). Wenn ja, zeigt die Zahlungsmethode bereits auf das neue Mandat.
3. Wenn nicht, ist das Ereignis noch nicht angekommen. Die stündliche Aufgabe, die verlorene Ereignisse nachholt, bringt es mit; dauert das länger, prüfen Sie, ob die Webhooks von GoCardless bei Odoo ankommen.
4. Ist die Zahlungsmethode aktuell, kassieren Sie die Rechnung erneut.

Mit unserem Konnektor

In Odoo 17, 18, 19 und 20 folgt der Konnektor dem neuen Mandat, sobald GoCardless die Ersetzung meldet: Der Kunde behält seine Zahlungsmethode, und die nächste Rechnung wird mit dem Mandat eingezogen, das GoCardless an dessen Stelle gesetzt hat.

Weiterlesen