GoCardless Xero Schnittstelle

Was eine GoCardless-Xero-Anbindung wirklich leistet

GoCardless weiß alles über einen Einzug - das Mandat, unter dem er erfolgte, die Zahlung, die am Donnerstag durchging, die Transaktionsgebühr, die Auszahlung, die kommende Woche netto auf dem Bankkonto landet, die Lastschrift, die vier Tage später fehlschlägt und zurückgeholt wird. Xero und die Person, die darin den Abschluss macht, brauchen all das als Buchhaltung: die Rechnung als bezahlt markiert, die Zahlung auf dem richtigen Konto, die Auszahlung gegen die tatsächliche Bankzeile abgestimmt, die Gebühren als Aufwand gebucht.

In der Lücke zwischen beiden Systemen steckt die Handarbeit. Eine GoCardless-Xero-Anbindung schließt sie automatisch. Sie liest jeden relevanten Vorgang aus GoCardless, wendet Ihre Zuordnungs- und Buchungsregeln an und hält Xero im Takt - damit niemand am Monatsende eine gebündelte Auszahlung gegen eine Liste einzelner Zahlungen abstimmen muss.

Welche Daten fließen

GoCardless-Objekt / -Ereignis	Wird in Xero zu	Hinweis
Bestätigte Zahlung	Zahlung, der passenden Ausgangsrechnung zugeordnet	Über ein GoCardless-Verrechnungskonto gebucht, per Referenz, Betrag und Mandat zugeordnet
Kunde / Mandat	Kontakt	Einmalig abgebildet, damit jede weitere Zahlung am selben Debitor hängt
Auszahlung	Bankbuchung, gegen den Bankfeed abgestimmt	Saldiert viele Zahlungen abzüglich Gebühren, Erstattungen und Fehlschlägen des Laufs
Gebühren	Aufwandsbuchung auf die Auszahlung	Pro Transaktion plus Prozentanteil, vor dem Geldeingang abgezogen
Fehlgeschlagene / zurückgebuchte Zahlung	Stornobuchung, Rechnung wieder geöffnet	Lastschriften können Tage nach der Zahlungsmeldung fehlschlagen
Erstattung	Gutschrift zum Kontakt	Storniert die ursprüngliche Zahlung mit Datum der Erstattung
In GoCardless abgerechnetes Abo	In Xero erzeugte Ausgangsrechnung	Nur wenn die wiederkehrende Abrechnung in GoCardless liegt, nicht in Xero

Verrechnungskonto, Gebührenkonto und Zuordnungsregeln stimmen wir einmalig ab und hinterlegen sie in der Pipeline. Danach ordnet niemand mehr eine Zahlung von Hand zu.

Die Details, an denen einfache Syncs scheitern

Ein CSV-Import oder ein generischer Connector bringt Sie fast ans Ziel und lässt den teuren Teil auf Ihrem Schreibtisch liegen:

• Die Auszahlung ist nicht die Summe der Zahlungen. GoCardless zahlt Tage nach dem Einzug netto nach Gebühren aus - in einem Sammelbetrag über viele Zahlungen, manchmal in mehr als einer Währung. Bucht man die Auszahlung als Ertrag, stimmt nichts mehr. Einzug und Auszahlung müssen getrennte Buchungen sein, verbunden über ein Verrechnungskonto, das wieder auf null geht.
• Späte Fehlschläge und Rücklastschriften. Eine SEPA- oder Bacs-Lastschrift wird als bezahlt gemeldet und kann Tage später trotzdem fehlschlagen oder zurückgebucht werden. Fließt die Stornierung nicht nach Xero zurück, bleibt die Rechnung fälschlich bezahlt und die Auszahlung geht nicht mehr auf.
• Zuordnung zur richtigen Rechnung. GoCardless identifiziert eine Zahlung über Mandat und Referenz, Xero über Rechnung und Kontakt. Der Betrag allein ist mehrdeutig, sobald zwei Kunden denselben Betrag zahlen. Die Zuordnung braucht Mandat, Referenz und Betrag zusammen.
• Mehrwährung. GoCardless zahlt jede Währung in einer eigenen Auszahlung aus. Diese müssen in der richtigen Xero-Organisation und Währung landen, mit korrekter Fremdwährungsbehandlung statt auf eine Zahl eingedampft.
• Rate-Limits und Token. Xero begrenzt API-Aufrufe pro Minute und pro Tag und lässt OAuth-Token nach Fahrplan ablaufen. Ein naiver Sync, der beides ignoriert, bleibt unter Last stehen oder verliert Datensätze.
• Idempotenz und Reihenfolge. GoCardless-Ereignisse müssen in Reihenfolge angewendet werden - bestätigt vor ausgezahlt, ausgezahlt vor fehlgeschlagen - und nie zweimal. Läuft ein unachtsamer Job erneut, ist ein ganzer Monat doppelt gebucht.

Wie wir sie bauen und betreiben

Wir behandeln das als Pipeline, nicht als Stapellauf von Hand. Zahlungs-, Auszahlungs-, Gebühren-, Erstattungs- und Fehlschlag-Ereignisse aus GoCardless werden per Webhook oder zeitgesteuert konsumiert, validiert, dem richtigen Xero-Kontakt und der richtigen Rechnung zugeordnet und über Ihre abgestimmten Verrechnungs- und Gebührenkonten gebucht. Auszahlungen werden gegen den Bankfeed abgestimmt, sodass die Zahlen sich selbst schließen.

Die Pipeline ist idempotent: Jedes GoCardless-Ereignis trägt eine stabile Kennung, sodass ein erneuter Lauf nie eine doppelte Zahlung oder eine doppelt gezählte Auszahlung erzeugt. Ereignisse werden in Reihenfolge verarbeitet, sodass eine späte Rücklastschrift die bereits gebuchte Zahlung korrekt storniert. Sie läuft auf cloud-nativer, vollständig EU-gehosteter AWS-Infrastruktur - Zahlungs- und Kundendaten verlassen die EU nicht, was AVV und DSGVO sauber hält.

Und dann halten wir sie am Laufen. Monitoring, Alerting, Incident Response und das Beobachten von API-Änderungen bei GoCardless und Xero, Token-Rotation und Rate-Limits liegen vertraglich bei uns. Sie bekommen einen festen Ansprechpartner und ein SLA. Der Abschluss hängt nicht mehr daran, dass jemand an einen Sync denkt.

Wann sich diese Anbindung lohnt

Wenn Sie eine Handvoll Lastschriften im Monat zu Rechnungen einziehen, die Sie ohnehin in Xero erstellen, ist die native GoCardless-Verbindung völlig in Ordnung - und wir sagen Ihnen das auch. Die Pipeline lohnt sich, wenn das Volumen steigt, wenn Abos in GoCardless statt in Xero abgerechnet werden, wenn Auszahlungen über Währungen laufen, oder wenn Gebühren, Erstattungen und späte Fehlschläge jede Auszahlung zur manuellen Abstimmung machen, die Ihr Finanzteam nicht von Hand erledigen sollte.