Fragen? (0 81 04) 90 966 - 0

Fakturia · Schnittstellen & Integration

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.

Grundlagen verstehen

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ässig
<1s
Latenz vom
Event bis Delivery
JSON
Payload-Format,
universell nutzbar
HTTPS
Verschlüsselte
Übertragung
Empfänger-Systeme
konfigurierbar

So funktioniert es

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.

⚙️
Ereignis in Fakturia
z. B. Vertrag gekündigt
📡
Webhook ausgelöst
HTTP POST an Ihre URL
📦
JSON Payload
Alle Event-Details mitgeschickt
🔧
Ihr System reagiert
CRM, Shop, Plattform, …
Aktion ausgeführt
Vollautomatisch, in Echtzeit

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:

POST https://ihr-system.de/webhook/fakturia
{
  "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.


Verfügbare Events

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)

Einsatzszenarien

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:

🔗 CONTRACT_CANCELLED

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.

CRM-Deal auf „Churned" setzen, Aufgabe für Account-Manager anlegen
🔒 PAYMENT_FAILED

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.

Feature-Flag deaktivieren, reaktivieren nach Zahlungseingang
📬 CONTRACT_CREATED

Onboarding-Sequenz starten

Sobald ein neuer Vertrag angelegt wird, soll Ihre Marketing-Automation eine personalisierte Willkommenssequenz starten – mit produktspezifischen Inhalten je nach gebuchtem Tarif.

HubSpot/Mailchimp: Onboarding-E-Mail-Sequenz starten
🎫 CHARGEBACK_RECEIVED

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.

Zendesk/Freshdesk: Ticket mit Kundendaten anlegen
📊 INVOICE_CREATED

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.

Data Warehouse / BI-Tool: Umsatzdaten in Echtzeit aktualisieren
🔔 CUSTOMER_CHANGED

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.

Slack: Nachricht in #sales oder #churn-alerts posten

Technische Eigenschaften

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.


Das perfekte Duo

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.


Über Fakturia

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.

DSGVO-konform
TÜV-Rechenzentrum Nürnberg
Entwickelt in Deutschland
Seit 2007 am Markt
Scroll to top
Cookie Consent mit Real Cookie Banner