API-Plattform & Integrationen

REST-API#

Die REST-API deckt alle Module von cashwerk ab und umfasst 441+ Endpoints.

Die OpenAPI-Spezifikation mit interaktiver Dokumentation steht zur Verfügung (Redocly Developer Portal).
Basis-URL: https://production.cashwerk.io/api/v1
Die API ist versioniert, aktuell gilt v1.

Authentifizierung#

Für den Zugriff auf die API stehen drei Methoden zur Verfügung:

Methode	Beschreibung
API-Schlüssel	Header `X-API-Key` für serverseitige Integrationen
OAuth 2.0	Vollständiger Authorization-Server mit Consent-Flow für Drittanbieter-Apps
Bearer Token	JWT für direkte API-Aufrufe

API-Schlüssel mit Name, Präfix, Berechtigungen, Ratenlimit und Status

Webhooks#

Mit Webhooks erhältst du ereignisgesteuerte Benachrichtigungen, sobald sich Daten in cashwerk ändern.

Unterstützte Ereignisse: Kontakte, Unternehmen, Rechnungen, Angebote, Deals, Projekte, Aufgaben, Zeiterfassung, Booking, Chat und Kalender.

Funktionen:

Webhooks erstellen, aktivieren, deaktivieren und löschen
Test-Ping zur Verbindungsprüfung
Retry-Mechanismus bei fehlgeschlagener Zustellung
Delivery-Tracking mit Status-Protokoll

Webhooks mit Ziel-URL, Ereignissen, Fehlerzähler und Status

n8n-Integration#

cashwerk bietet native n8n-Nodes als Community-Paket (n8n-nodes-cashwerk).

Aktions-Node

CRUD-Operationen für Kontakte, Unternehmen, Rechnungen, Angebote, Projekte, Aufgaben, Deals, Zeiteinträge und Bookings

Trigger-Node

Webhook-basierte Trigger für alle Entitäten

Vorgefertigte Workflow-Templates

Deal → Projekt erstellen
Gewonnener Deal → Rechnung erzeugen
Kontakt erstellt → Slack-Benachrichtigung
Tägliche Rechnungszusammenfassung
CSV-Kontakte synchronisieren

Buchhaltungs-Connectors#

cashwerk bindet drei Buchhaltungssysteme an:

Connector	Sync-Umfang
Lexware	Kontakte, Unternehmen, Rechnungen, Gutschriften, Angebote, Zahlungen + Webhooks
sevDesk	Kontakte, Unternehmen, Rechnungen, Gutschriften, Angebote, Zahlungen
DATEV	Rechnungen, Gutschriften, EXTF-CSV, DXSO-XML, OAuth2, Drive-Upload

Funktionen der Connectors

Bidirektionale Synchronisation mit Konflikterkennung
Schutz vor dem Überschreiben interner CRM-Nummern
Automatische Deaktivierung bei Authentifizierungsfehlern (Lexware)
Inbound-Field-Policy für selektive Feld-Updates
Sync-Logs und Fehlerprotokoll

MCP-Server für KI-Agenten#

Der cashwerk MCP Server (@cashwerk/mcp-server) wird aus der OpenAPI-Spezifikation generiert. KI-Agenten erhalten damit Zugriff auf alle cashwerk-APIs.

Weitere Integrationen#

Integration	Zweck
Stripe	Zahlungsabwicklung, Abonnements, Rechnungen, Payment Links
Finax	Erstellung und Validierung von XRechnung / ZUGFeRD
Google Calendar	Bidirektionale Kalender-Synchronisation
Microsoft 365	Kalender-Sync, OAuth-Mail
Apple Calendar (CalDAV)	Kalender-Synchronisation
Recall.ai	Meeting-Bots für Transkription
Google Places	Adress-Autovervollständigung
Google Custom Search	Websuche für den KI-Assistenten
Vertex AI (Gemini)	KI-Engine für Chat, RAG und Zusammenfassungen
Expo Push	Mobile Push-Benachrichtigungen