Webhooks – Ihre Drittsysteme
reagieren in Echtzeit.
Fakturia informiert Ihr CRM, Ihren Shop, Ihre eigene Plattform oder jedes andere System sofort, wenn ein wichtiges Ereignis eintritt – vollautomatisch, per HTTP-POST, ohne Polling.
Moderne Software-Ökosysteme bestehen selten aus nur einem System. CRM, Onlineshop, eigene SaaS-Plattform, Helpdesk, Marketing-Automation – sie alle müssen wissen, was in Fakturia passiert: Wenn ein Vertrag gekündigt wird, wenn eine Zahlung fehlschlägt, wenn ein neuer Kunde angelegt wird. Webhooks sind der schnellste, zuverlässigste und effizienteste Weg, diese Information weiterzuleiten.
Warum Webhooks besser sind als regelmäßiges Abfragen (Polling)
❌ Polling (Pull-Prinzip)
Ihr System fragt die Fakturia-API alle paar Minuten ab: „Gibt es etwas Neues?" Meistens lautet die Antwort: Nein. Sie verschwenden API-Kapazitäten, erzeugen unnötige Last und reagieren trotzdem erst mit Verzögerung auf Ereignisse.
Ineffizient · Verzögert · Ressourcenhungrig✓ Webhooks (Push-Prinzip)
Fakturia sendet eine Benachrichtigung genau dann, wenn etwas passiert – sofort, aktiv, ohne dass Ihr System fragen muss. Sie reagieren in Echtzeit, ohne unnötige API-Calls, ohne Polling-Overhead.
Sofort · Ressourcenschonend · ZuverlässigEvent bis Delivery
universell nutzbar
Übertragung
konfigurierbar
Der Ablauf: Von Ereignis zur Aktion in Ihrem System
Ein Webhook in Fakturia ist denkbar einfach: Sie hinterlegen eine URL in Ihrem System und wählen aus, bei welchen Ereignissen Fakturia diese URL aufrufen soll. Den Rest übernimmt Fakturia automatisch.
Fakturia sendet beim Auslösen eines Webhooks den vollständigen Datensatz des betroffenen Objekts als JSON-Payload mit. Hier ein Beispiel für das Ereignis Vertrag: Gekündigt:
{
"eventType": "CONTRACT_CANCELLED",
"eventTime": "2026-06-01T14:32:11Z",
"webhookUuid": "f3a8c2d1-9b4e-4f2a-8c1d-2e3f4a5b6c7d",
"payload": {
"contract": {
"id": 48291,
"status": "CANCELLED",
"cancellationDate": "2026-06-30",
"tariff": "Business Pro",
"customer": {
"id": 10042,
"email": "kunde@beispiel.de",
"name": "Muster GmbH"
}
}
}
}
Der Payload enthält immer den vollständigen Datensatz des betroffenen Objekts – beim Event „Kunde geändert" sogar sowohl den neuen als auch den alten Kundenstammsatz (customer und oldCustomer), damit Ihr System exakt nachvollziehen kann, welche Felder sich geändert haben.
Welche Ereignisse können als Webhook ausgelöst werden?
Fakturia bietet eine umfangreiche und kontinuierlich erweiterte Liste von Webhook-Events über alle zentralen Bereiche des Systems:
| Event-Bezeichnung | Bereich | Auslöser |
|---|---|---|
| Kunde angelegt | Kunden | Neuer Kundendatensatz wurde erstellt |
| Kunde geändert | Kunden | Stammdaten wurden aktualisiert (inkl. Vorher-/Nachher-Vergleich) |
| Vertrag angelegt | Verträge | Neues Abonnement wurde erstellt |
| Vertrag geändert | Verträge | Tarifdaten, Status oder Laufzeit wurde angepasst |
| Vertrag gekündigt | Verträge | Kündigung durch Kunde oder Anbieter eingegangen |
| Rechnung erstellt | Rechnungen | Neue Rechnung im System erzeugt |
| Zahlungseingang verbucht | Zahlungen | Zahlung erfolgreich eingegangen und zugeordnet |
| Recurring Payment: Fehler | Zahlungen | Fehler beim PSP-Lastschrifteinzug (z. B. Kreditkarte abgelaufen) |
| Rücklastschrift eingegangen | Zahlungen | SEPA-Rücklastschrift vom Kreditinstitut zurückgemeldet |
| Bestellung: PSP Event | Bestellungen | Rückmeldung des Bezahlanbieters über Bestellstatus |
| Leistung erzeugt | Leistungen | Neue abrechenbare Leistungsposition erstellt |
| USt-Id-Prüfung fehlgeschlagen | Compliance | Fehler bei periodischer EU-USt-Id-Validierung (Enterprise) |
Was Ihre Systeme mit Fakturia-Webhooks machen können
Webhooks entfalten ihren Nutzen in der Kombination mit Ihren bestehenden Systemen. Hier sind die häufigsten Integrationsszenarien:
CRM-Status automatisch aktualisieren
Wenn ein Vertrag in Fakturia gekündigt wird, muss Ihr CRM-System das sofort wissen – damit der Kundenstatus korrekt ist, keine Verlängerungs-E-Mails mehr versandt werden und der Account-Manager informiert wird.
Zugang zur SaaS-Plattform sperren
Schlägt eine wiederkehrende Zahlung fehl, soll Ihr Produkt den Kundenzugang einschränken – und nach erfolgreicher Nachzahlung automatisch wieder freischalten.
Onboarding-Sequenz starten
Sobald ein neuer Vertrag angelegt wird, soll Ihre Marketing-Automation eine personalisierte Willkommenssequenz starten – mit produktspezifischen Inhalten je nach gebuchtem Tarif.
Support-Ticket automatisch öffnen
Bei einer Rücklastschrift oder einem Zahlungsausfall soll Ihr Helpdesk-System automatisch ein Ticket erstellen – damit das Support-Team sofort reagieren kann, ohne manuelles Monitoring.
Echtzeit-Revenue-Tracking
Jede erstellte Rechnung soll sofort in Ihr internes Reporting oder Business-Intelligence-System fließen – für aktuelles MRR-Tracking und Cashflow-Prognosen ohne Datenverzögerung.
Slack-Benachrichtigung bei Kundenereignissen
Wichtige Ereignisse – ein neuer Großkunde, eine Kündigung eines Premium-Abos – sollen sofort als Slack-Nachricht im richtigen Kanal erscheinen, damit das Team informiert ist.
Was die Fakturia-Webhooks technisch leisten
Vollständiger Payload
Jeder Webhook enthält den kompletten Datensatz des ausgelösenden Objekts – kein separater API-Call nötig, um Details abzufragen.
Nachvollziehbarkeit im Backoffice
Gesendete Hook-Messages können jederzeit im Fakturia-Backoffice eingesehen werden – für Debugging und Audit-Trail.
UUID pro Konfiguration
Jede Webhook-Konfiguration erhält eine eindeutige UUID, die im Payload mitgesendet wird – für sichere Zuordnung auf Empfängerseite.
HTTPS-gesichert
Alle Webhook-Calls erfolgen ausschließlich über HTTPS. Die Übertragung der Payload-Daten ist verschlüsselt und abhörsicher.
Individuell konfigurierbar
Für jede Ziel-URL können gezielt die relevanten Event-Typen ausgewählt werden – kein unnötiger Traffic, volle Kontrolle.
Kombinierbar mit Zapier
Webhooks lassen sich direkt mit der Zapier-Integration kombinieren – für NoCode-Verbindungen zu über 2.000 weiteren Tools ohne eine einzige Zeile Code.
Webhooks + REST-API: Zwei-Wege-Integration mit Fakturia
Webhooks und REST-API ergänzen sich zu einem vollständigen Integrations-Ökosystem. Während die REST-API das aktive Abfragen und Steuern von Fakturia aus Ihrem System heraus ermöglicht, übernehmen Webhooks die umgekehrte Richtung: Fakturia informiert proaktiv Ihre Systeme über Ereignisse.
Zusammen ermöglichen sie eine vollständig bidirektionale, Echtzeit-synchronisierte Integration zwischen Fakturia und Ihrer gesamten Systemlandschaft – ohne Datenverluste, ohne Verzögerungen, ohne manuellen Abgleich.
Made in Germany – Serverstandort Nürnberg
Fakturia wird von der Luminea IT Services GmbH aus Sauerlach bei München entwickelt. Alle Webhook-Calls gehen von Servern in einem TÜV-zertifizierten Rechenzentrum in Nürnberg aus – DSGVO-konform, ohne Datenweitergabe in Drittstaaten. Das Unternehmen befindet sich im Privatbesitz seiner Gesellschafter und ist seit 2007 am Markt.
Ihre Systeme verdienen Echtzeit-Daten
Testen Sie Fakturia kostenlos – inkl. vollständigem Webhook-Zugang in der Sandbox. Kein Risiko, keine Kreditkarte.
