Welche Chargebee-Ereignisse lösen eine Buchung in DATEV aus?

MID · 22 Okt. 2026

Chargebee-Ereignisse lösen eine Buchung in DATEV aus, sobald sie einen abgeschlossenen Zahlungsvorgang, eine ausgestellte Rechnung oder eine Gutschrift repräsentieren. Nicht jedes Ereignis im Chargebee-System ist buchungsrelevant, deshalb kommt es auf eine saubere Ereignisfilterung an. Dieser Artikel beantwortet die wichtigsten Fragen rund um die Chargebee-DATEV-Integration.

Welche Chargebee-Ereignistypen sind buchungsrelevant?

Buchungsrelevant sind Chargebee-Ereignisse, die einen abgeschlossenen Zahlungsvorgang, eine ausgestellte Rechnung oder eine Gutschrift dokumentieren. Dazu gehören payment_succeeded, invoice_generated, credit_note_created und refund_initiated. Diese Ereignisse erzeugen einen klaren Geldfluss oder eine Forderung und müssen deshalb in der Finanzbuchhaltung erfasst werden.

Im Detail lassen sich buchungsrelevante Ereignisse in drei Kategorien einteilen:

Rechnungsereignisse: invoice_generated, invoice_updated (bei nachträglichen Korrekturen)
Zahlungsereignisse: payment_succeeded, payment_refunded
Gutschriftereignisse: credit_note_created

Ereignisse wie subscription_created oder customer_updated sind rein administrativer Natur. Sie verändern keinen Kontostand und gehören nicht in den Buchungskreislauf. Die Herausforderung bei der Chargebee-Buchung in DATEV liegt darin, genau diese Grenze sauber zu ziehen, bevor Daten in die Buchhaltung fließen.

Wie wird ein Chargebee-Ereignis in einen DATEV-Buchungssatz umgewandelt?

Ein Chargebee-Ereignis wird in einen DATEV-Buchungssatz umgewandelt, indem die relevanten Felder des Ereignisses auf DATEV-Konten gemappt werden: Betrag, Steuersatz, Belegdatum, Debitorennummer und Buchungstext. Das Ergebnis ist ein strukturierter Datensatz im DATEV-Format, der direkt in die Finanzbuchhaltung importiert werden kann.

Konkret läuft die Umwandlung in mehreren Schritten ab. Zuerst liest die Middleware das Chargebee-Ereignis über die API aus und prüft, ob es buchungsrelevant ist. Dann werden die Felder transformiert: Der Nettobetrag wird dem Erlöskonto zugeordnet, die Steuer dem entsprechenden Umsatzsteuerkonto, und der Gesamtbetrag landet auf dem Debitorenkonto des Kunden.

Dabei ist das Belegdatum entscheidend. DATEV erwartet das Rechnungsdatum, nicht das Buchungsdatum der Zahlung. Wer hier das falsche Datum überträgt, riskiert falsche Periodenabgrenzungen. Außerdem muss die Debitorennummer in DATEV mit dem Kunden in Chargebee eindeutig verknüpft sein, entweder über eine externe ID oder ein eigenes Mapping.

Was passiert bei Teilzahlungen oder fehlgeschlagenen Zahlungen in Chargebee?

Bei einer fehlgeschlagenen Zahlung in Chargebee entsteht zunächst kein Buchungssatz, weil kein Geldfluss stattgefunden hat. Die Rechnung bleibt offen. Bei einer Teilzahlung wird nur der tatsächlich eingegangene Betrag gebucht, während der Restbetrag als offene Forderung in der Debitorenbuchhaltung verbleibt.

Fehlgeschlagene Zahlungen erzeugen in Chargebee das Ereignis payment_failed. Dieses Ereignis sollte nicht automatisch gebucht werden, aber es sollte ein Monitoring auslösen, damit das Mahnwesen oder der Kundenservice informiert wird. Erst wenn eine Nachzahlung erfolgreich ist (payment_succeeded), entsteht ein buchungsrelevanter Vorgang.

Teilzahlungen sind buchhalterisch komplexer. Hier muss die Integration unterscheiden, ob Chargebee eine Teilzahlung als eigenständige Transaktion behandelt oder ob die Rechnung auf einen Teilbetrag angepasst wurde. Im ersten Fall entstehen zwei separate Buchungssätze, im zweiten Fall muss die Differenz als offene Forderung weitergeführt werden. Eine saubere Middleware-Buchhaltungsintegration bildet diese Logik automatisch ab, ohne manuelle Eingriffe.

Wie werden Steuern und Währungen aus Chargebee korrekt nach DATEV übertragen?

Steuern aus Chargebee werden nach DATEV übertragen, indem der Steuersatz jeder Rechnungsposition auf das passende DATEV-Umsatzsteuerkonto gemappt wird. Fremdwährungen müssen zum Buchungskurs in Euro umgerechnet werden, wobei der Kurs zum Rechnungsdatum maßgeblich ist.

Chargebee unterstützt mehrere Steuersätze innerhalb einer Rechnung, zum Beispiel bei gemischten Produkten mit unterschiedlichen Mehrwertsteuersätzen. DATEV erwartet für jeden Steuersatz eine eigene Buchungszeile. Die Integration muss deshalb Rechnungspositionen aufschlüsseln und nicht einfach den Gesamtbetrag übertragen.

Bei Fremdwährungen gelten besondere Anforderungen. DATEV benötigt sowohl den Originalbetrag in Fremdwährung als auch den Eurogegenwert. Der Wechselkurs muss dokumentiert sein, weil er für die Steuerprüfung relevant ist. Wenn Chargebee den Kurs nicht direkt mitliefert, muss die Middleware ihn aus einer externen Quelle beziehen und am Buchungssatz hinterlegen. Dieser Schritt ist für eine revisionssichere Archivierung unerlässlich.

Welche Chargebee-Ereignisse sollten nicht automatisch gebucht werden?

Nicht automatisch gebucht werden sollten Chargebee-Ereignisse, die keinen abgeschlossenen Geldfluss oder keine rechtsgültige Forderung dokumentieren. Dazu gehören Abonnement-Ereignisse, Kundenänderungen, fehlgeschlagene Zahlungsversuche und interne Statusänderungen.

Konkret sind folgende Ereignistypen aus der automatischen Buchung auszuschließen:

subscription_created, subscription_changed, subscription_cancelled: Diese beschreiben Vertragsstatus, keinen Geldfluss.
payment_failed: Keine Zahlung eingegangen, deshalb keine Buchung.
customer_created, customer_updated: Stammdatenänderungen ohne Buchungsrelevanz.
invoice_updated (ohne Betragsänderung): Reine Metadatenänderungen sollten nicht erneut gebucht werden.

Wer diese Ereignisse trotzdem automatisch in DATEV überträgt, riskiert Doppelbuchungen oder Buchungen ohne realen Hintergrund. Das führt bei einer Betriebsprüfung zu Erklärungsbedarf. Deshalb gehört eine Whitelist buchungsrelevanter Ereignisse zum Fundament jeder stabilen Chargebee-Ereignisse-DATEV-Integration.

Wie lässt sich die Chargebee-DATEV-Integration technisch umsetzen?

Die Chargebee-DATEV-Integration lässt sich technisch über eine Middleware umsetzen, die Chargebee-Webhooks empfängt, die Ereignisse filtert und transformiert und die fertigen Buchungssätze im DATEV-Format überträgt. Alternativ ist ein periodischer API-Pull möglich, bei dem die Middleware Chargebee in regelmäßigen Abständen nach neuen Ereignissen abfragt.

Webhook-basierter Ansatz

Chargebee sendet bei jedem relevanten Ereignis automatisch einen Webhook an einen konfigurierten Endpunkt. Die Middleware empfängt diesen Webhook, prüft den Ereignistyp gegen die Whitelist buchungsrelevanter Ereignisse und startet bei Übereinstimmung die Transformation. Dieser Ansatz ermöglicht nahezu Echtzeit-Buchungen und reduziert die Latenz zwischen Zahlung und Buchung auf wenige Sekunden.

Periodischer API-Pull

Beim Pull-Ansatz fragt die Middleware die Chargebee-API in festgelegten Intervallen ab, zum Beispiel stündlich oder täglich. Dieser Ansatz ist robuster gegenüber kurzfristigen Verbindungsausfällen, weil keine Ereignisse verloren gehen, wenn der Webhook-Endpunkt kurzzeitig nicht erreichbar ist. Er eignet sich besonders für Unternehmen, die ihre Buchungen gesammelt am Ende des Tages verarbeiten.

In beiden Fällen muss die Integration passive Rechnungsabgrenzungsposten (pRAP) berücksichtigen, wenn Chargebee Abonnements über Perioden abrechnet. Ein Jahresabonnement, das im Oktober beginnt, darf nicht vollständig im Oktober gebucht werden, sondern muss periodengerecht aufgeteilt werden. Das ist eine der häufigsten Fehlerquellen bei der automatischen Buchungserfassung aus Subscription-Systemen. Die Finanzbuchhaltungs-Integration muss diese Logik von Anfang an abbilden.

So unterstützt der MID Buchungsmanager bei der Chargebee-DATEV-Integration

Der MID Buchungsmanager von MIDbridge® ist speziell für Anforderungen wie diese entwickelt worden. Er verbindet Chargebee und DATEV bidirektional und übernimmt alle beschriebenen Schritte automatisiert:

Filterung buchungsrelevanter Chargebee-Ereignisse nach konfigurierbarer Whitelist
Transformation von Rechnungspositionen mit korrekter Steuerzuordnung und Währungsumrechnung
Generierung von Buchungssätzen inklusive passiver Rechnungsabgrenzungsposten
GoBD-konforme Übertragung und revisionssichere Dokumentation
Behandlung von Teilzahlungen und fehlgeschlagenen Zahlungen ohne manuelle Eingriffe

Das Ergebnis: Dein Buchhaltungsteam und Dein Steuerberater arbeiten mit konsistenten, geprüften Daten, ohne manuell zwischen Chargebee und DATEV abgleichen zu müssen. Wenn Du wissen möchtest, wie der MID Buchungsmanager in Deine bestehende Systemlandschaft passt, schau Dir die Lösung im Detail an oder nimm direkt Kontakt mit uns auf.