Zum Inhalt springen
Rechnungskit

GoCardless verbinden

Aktualisiert am

GoCardless zieht SEPA-Lastschriften ein. Rechnungskit erstellt daraus automatisch die Rechnung, archiviert sie GoBD-konform und bereitet den DATEV-Export auf.

Einrichtung

  1. Im GoCardless-Dashboard: Developers → Access tokens, neuen Token mit Scope Read-write anlegen (direkter Link: https://manage.gocardless.com/developers/access-tokens?action=create). Read-write ist nötig, damit Rechnungskit den Webhook prüfen kann; Zahlungen werden nie ausgelöst. Wichtig: Verwende den Token des Live-Kontos, auch wenn du Rechnungskit erst testest; ein sandbox_-Token verbindet die leere GoCardless-Sandbox, in der deine echten Lastschriften nie erscheinen.
  2. In Rechnungskit unter Einstellungen → Verbinden: Zahlungsanbieter hinzufügen → GoCardless, Access Token eintragen. Direkt danach öffnet sich Schritt 2 als Dialog mit der Webhook-URL und dem direkten Link zur GoCardless-Webhook-Seite (https://manage.gocardless.com/developers/webhook-endpoints, in der Sandbox manage-sandbox.gocardless.com).
  3. Dort einen Endpoint mit dieser URL anlegen (Name z. B. Rechnungskit; "Generate a secret for me" ist in Ordnung; das optionale Webhook client certificate wird NICHT benötigt, jede Meldung wird über das Secret kryptografisch geprüft). Das Secret erscheint nicht beim Anlegen: den neuen Endpoint in der Liste anklicken, das Secret kopieren und im Dialog einfügen, das aktiviert die Verbindung. Wird der Dialog geschlossen, bleibt die Verbindung pausiert (Karte zeigt "Webhook fehlt" mit dem Button "Webhook einrichten"); GoCardless meldet Zahlungen ausschließlich per Webhook, ohne ihn kommt nichts an. Aktivieren ohne hinterlegtes Secret ist deshalb gesperrt.
  4. Rechnungskit zeigt nach dem Speichern die Webhook-URL an. Diese im GoCardless-Dashboard unter Developers → Webhook endpoints eintragen. Das dort angezeigte Endpoint-Secret ist das Webhook-Secret aus Schritt 2.

Anders als bei Stripe oder Unzer kann Rechnungskit den Webhook nicht selbst anlegen: GoCardless bietet dafür keine Schnittstelle an. Deshalb die manuelle Eintragung.

Wann die Rechnung entsteht

Erst wenn GoCardless den Einzug als bestätigt meldet (Status confirmed). Eine Lastschrift durchläuft mehrere Tage lang Zwischenstände und kann noch scheitern. Eine archivierte Rechnung ist GoBD-bedingt unveränderbar und ließe sich nur per Storno zurücknehmen. Deshalb wird bewusst der bestätigte Einzug abgewartet. Als Zahlungsdatum gilt das tatsächliche Einzugsdatum.

Rücklastschriften

Eine Rücklastschrift erzeugt keine automatische Stornorechnung. Die Leistung wurde erbracht, nur die Zahlung ging zurück. Rechnungskit öffnet die Forderung wieder und legt eine Aufgabe unter /payments an. Ob eine Korrektur nötig ist, etwa als Forderungsausfall nach Paragraf 17 UStG, entscheidest du mit deiner Steuerkanzlei.

Gebühren und Auszahlungen

GoCardless bündelt Einzüge zu Auszahlungen und weist die abgezogenen Gebühren getrennt aus. Beides wird automatisch übernommen: die Auszahlung als Ganzes und ihre Einzelpositionen. Im DATEV-Export erscheinen ein eigenes Geldtransitkonto für GoCardless, die Gebühren als eigene Buchung und die Auszahlung auf das Bankkonto. Auszahlungen siehst du unter /payouts.

Grenzen, ehrlich benannt

  • Der Webhook muss im GoCardless-Dashboard von Hand eingetragen werden (keine API dafür).
  • Ohne Webhook-Secret ist keine Verbindung möglich: Ohne das Secret könnte keine Meldung als echt geprüft werden, und ungeprüfte Webhooks werden nie angenommen.
  • Zahlungen vor dem bestätigten Einzug erzeugen bewusst noch keine Rechnung.
de