Fakturia — Feature im Detail
REST-API: Volle Kontrolle.
Programmierbar.
Kunden, Verträge, Rechnungen und Zahlungen – alle Fakturia-Ressourcen sind über eine vollständige REST-API zugänglich. Integrieren Sie Ihr Abo-Modell nahtlos in jede bestehende Systemlandschaft.
REST
JSON • OpenAPI-Doku
100 %
aller Ressourcen per API
MCP
Server für KI-Agenten
Beispiel: Neuen Kunden anlegen und Vertrag starten
JSON / REST
# 1. Kunden anlegen
POST https://api.fakturia.de/v1/kunden
Authorization: Bearer YOUR_API_KEY
{
"firma": "Muster GmbH",
"email": "kontakt@muster.de",
"land": "DE"
}
# Response: 201 Created
{ "id": "KD-00042", "status": "aktiv" }
# 2. Vertrag für den neuen Kunden anlegen
POST https://api.fakturia.de/v1/vertraege
{
"kunden_id": "KD-00042",
"tarif_id": "BUSINESS-PRO",
"start": "2026-07-01",
"zahlungsart": "sepa"
}
# Response: 201 Created → Fakturia erzeugt automatisch die erste Rechnung
{ "id": "VT-00198", "rechnung_id": "RE-2026-0701" }
Kein Subscription-Management-System existiert im Vakuum. Shops, CRM-Systeme, interne Tools, KI-Agenten – alle benötigen Zugriff auf Kundendaten, Verträge und Rechnungen. Wer hier auf CSV-Exporte oder manuelle Datenpflege setzt, baut sich einen Flaschenhals, der mit wachsendem Volumen immer enger wird.
Fakturia bietet eine vollständige REST-API, über die alle zentralen Ressourcen – Kunden, Verträge, Artikel, Rechnungen, Zahlungen – programmgesteuert lesbar und schreibbar sind. Die API ist nach REST-Prinzipien aufgebaut, liefert JSON zurück und ist vollständig per OpenAPI-Dokumentation beschrieben.
🔒
API-Key Auth
Sandbox & Produktiv getrennt
📄
OpenAPI-Doku
Vollständig dokumentiert
🇩🇪
Entwickelt in Deutschland
TÜV-RZ Nürnberg, DSGVO
🤖
MCP-Server
KI-Agenten-Integration
Alle API-Ressourcen im Überblick
Vollständige CRUD-Operationen – lesen, anlegen, aktualisieren, löschen.
Kunden anlegen & aktualisieren
Adress- & Kontaktdaten verwalten
Kunden suchen & filtern
Zahlungsmittel hinterlegen
Guthaben abfragen
Verträge anlegen & starten
Tarifwechsel (Upgrade/Downgrade)
Kündigung einreichen
Add-ons hinzufügen
Vertragsstatus abfragen
Rechnungen abrufen & filtern
PDF-Download per API
Zahlungsstatus prüfen
Gutschriften erstellen
E-Rechnung (ZUGFeRD/XRechnung)
Artikel & Tarife anlegen
Preismodelle konfigurieren
Mengenrabatte definieren
Tariflisten abfragen
Zahlungseingsänge abrufen
Zahlungen manuell buchen
Rücklastschriften verarbeiten
Transaktionshistorie abfragen
Webhook-Endpunkte registrieren
Events abonnieren
Delivery-Logs einsehen
Retry-Mechanismus konfiguriert
Weitere API-Funktionen
Was die Fakturia-API neben den Endpunkten noch bietet.
🔒
Sandbox-Umgebung
Volle API-Funktionalität auf Testdaten – kein Risiko für Produktivdaten. Separate API-Keys für Sandbox und Produktion verhindern versehentliche Zugriffe. Kostenlos und sofort verfügbar.
📄
OpenAPI / Swagger
Die gesamte Fakturia-API ist nach OpenAPI-Standard dokumentiert. Entwickler können Client-SDKs automatisch generieren oder die API direkt im Browser per Swagger UI erkunden.
🔗
Zapier & Locoia (NoCode)
Keine Programmierkenntnisse? Kein Problem. Über Zapier verbinden Sie Fakturia mit über 2.000 Tools – HubSpot, Mailchimp, Google Sheets und mehr. Für komplexere Workflows steht Locoia bereit.
📈
Paginierung & Filterung
Alle Listen-Endpunkte unterstützen Paginierung, Sortierung und Filterung nach Datum, Status und weiteren Feldern – ideal für effiziente Datenimporte und Synchronisierungen.
🤖 Fakturia API trifft KI: Der offizielle MCP-Server
Fakturia stellt einen offiziellen MCP-Server (Model Context Protocol) bereit – die neue Schnittstelle zwischen Subscription-Management und KI-Agenten wie Claude Code. Entwickler können damit Abrechnungslogik per natürlichsprachlicher Anweisung steuern: „Leg einen neuen Kunden an, starte den Business-Pro-Tarif und schick mir die erste Rechnung.“ – Claude erledigt den Rest per API-Call.
Der MCP-Server ist Open Source und frei verfügbar: github.com/edjufy/fakturia-mcp. Er ermöglicht sogenanntes Vibe Coding – Abo-Prozesse entwickeln ohne klassische Programmierschnittstelle.
⚡ Webhook-Events – Fakturia hält Ihr System in Echtzeit informiert
invoice.created
Neue Rechnung erzeugt
payment.received
Zahlung eingegangen
payment.failed
Zahlung fehlgeschlagen
contract.created
Neuer Vertrag angelegt
contract.cancelled
Vertrag gekündigt
contract.upgraded
Tarifwechsel durchgeführt
dunning.level_reached
Mahnstufe erreicht
customer.created
Neuer Kunde angelegt
sepa.returned
SEPA-Rücklastschrift
Integration mit & ohne API
Was ein fehlender API-Zugang in der Praxis bedeutet.
Aufgabe
Ohne API (manuell)
Mit Fakturia REST-API
Neukunden aus CRM anlegen
✗ Manuelle Doppelpflege in beiden Systemen
✓ CRM-Webhook → Fakturia API, vollautomatisch
Rechnungen in ERP übertragen
✗ CSV-Export, manueller Import
✓ /rechnungen abrufen, direkt ins ERP
Vertragsstart bei Checkout
✗ Manuelle Anlage nach Bestelleingang
✓ POST /vertraege direkt aus Shop-System
Zahlungsstatus im Portal anzeigen
✗ Nicht möglich ohne Datenzugriff
✓ GET /zahlungen per API, Echtzeit
Kündigung aus eigenem Frontend
✗ Weiterleitung zu Fakturia-Oberfläche
✓ DELETE /vertraege/{id} im eigenen UI
Reaktion auf Zahlungsausfall
✗ Tägliches Monitoring nötig
✓ payment.failed Webhook, sofortige Reaktion
Häufige Fragen zur Fakturia REST-API
Technische Fragen von Entwicklern und Architekten.
Welche Ressourcen können über die Fakturia REST-API angesprochen werden?
Die Fakturia REST-API bietet Zugriff auf alle zentralen Ressourcen: Kunden, Verträge (inkl. Tarifwechsel, Kündigung), Artikel und Tarifpläne, Rechnungen, Zahlungen sowie Webhooks. Alle Ressourcen folgen dem REST-Prinzip und liefern JSON zurück.
Wie authentifiziert man sich an der Fakturia API?
Die Fakturia REST-API verwendet API-Key-Authentifizierung. Der API-Key wird als HTTP-Header übermittelt. Separate Keys für Sandbox- und Produktivumgebung stellen sicher, dass Testszenarien nie versehentlich auf Live-Daten zugreifen.
Gibt es eine Sandbox-Umgebung für die Fakturia API?
Ja. Fakturia stellt eine vollständige Sandbox-Umgebung bereit, die sich in allen Funktionen identisch zur Produktivumgebung verhält. Entwickler können alle API-Endpunkte gefahrlos testen. Die Sandbox ist kostenlos unter fakturia.de/testmandant verfügbar.
Unterstützt Fakturia Webhooks für Echtzeit-Benachrichtigungen?
Ja. Fakturia sendet Webhooks bei allen wichtigen System-Events – z. B. bei neuen Rechnungen, Zahlungseinsängen, Vertagsänderungen oder Kündigungen. Webhook-Endpunkte werden in der Fakturia-Oberfläche konfiguriert und empfangen strukturierte JSON-Payloads.
Kann ich die Fakturia API mit KI-Agenten wie Claude Code nutzen?
Ja. Fakturia stellt einen offiziellen MCP-Server bereit, über den KI-Agenten wie Claude Code direkt auf die Fakturia-API zugreifen können. Der Open-Source-Server ist unter github.com/edjufy/fakturia-mcp verfügbar.
Kann ich Fakturia ohne Programmierkenntnisse per API anbinden?
Ja. Über die Zapier-Integration verbinden auch Nicht-Entwickler Fakturia mit über 2.000 Tools. Für komplexere NoCode-Workflows steht zusätzlich die Locoia-Integration zur Verfügung.