Integrationen-Übersicht

Unter Integrationen verbindest du externe Dienste mit deinem Univents-Workspace — von der Zahlungsabwicklung über Kalender- und E-Mail-Synchronisation bis hin zum DATEV-Export für die Buchhaltung und API-Zugriffen für eigene Automatisierungen.

Wo du die Integrationen findest

Navigiere in der linken Sidebar zu Integrationen. Die Seite öffnet sich direkt auf dem Tab Zahlungen. Oben auf der Seite findest du fünf Tabs:

1. Zahlungen — Stripe Connect für Online-Direktzahlungen
2. Kalender — Bidirektionale Sync mit Google, Outlook oder iCloud
3. E-Mail-Postfach — Gmail, Outlook oder IMAP einbinden
4. API-Schlüssel — Schlüssel für externe Tools und MCP-Verbindungen
5. DATEV — Buchungsstapel-Export für deinen Steuerberater

Wechsle zwischen den Bereichen, indem du auf den jeweiligen Tab klickst.

Zahlungen — Stripe Connect

Über den Tab Zahlungen verbindest du Stripe mit deinem Workspace. Ist Stripe Connect aktiv, können Kunden bei einer Onlinebuchung direkt bezahlen; die Einnahmen werden automatisch auf dein hinterlegtes Bankkonto überwiesen.

• Klicke Mit Stripe verbinden, um das Stripe-Onboarding zu starten. Du wirst auf die Stripe-Website weitergeleitet.
• Hast du das Onboarding bereits begonnen, aber noch nicht abgeschlossen, siehst du den Button Onboarding fortsetzen.
• Ist die Verbindung aktiv, zeigt Univents den Badge Aktiv neben dem Stripe-Eintrag. Mit Trennen kannst du die Verbindung jederzeit aufheben.

Kalender — Google, Outlook, iCloud

Unter dem Tab Kalender synchronisierst du Events bidirektional zwischen Univents und deinem Kalenderprogramm. Unterstützte Anbieter sind Google Kalender, Microsoft Outlook und iCloud Kalender.

1. Klicke Neue Verbindung, um eine Authentifizierung zu starten.
2. Nach der Authentifizierung erscheint die Verbindungskarte. Wähle über das Dropdown Kalender auswählen den gewünschten Zielkalender.
3. Mit Locations zuweisen legst du fest, welche deiner Locations Events an diesen Kalender pushen sollen. Ohne Zuweisung gehen Pushes an alle verbundenen Kalender.
4. Mit Jetzt synchronisieren holst du externe Termine manuell ab.
5. Zeigt die Verbindungskarte den Badge Verbindung abgelaufen — neu verbinden, klicke auf den gleichnamigen Button, um die Authentifizierung zu erneuern.

E-Mail-Postfach — Gmail, Outlook, IMAP

Über den Tab E-Mail-Postfach spiegelst du eingehende E-Mails aus einem oder mehreren Konten in Univents. Antworten sendest du weiterhin aus deinem eigenen Mailprogramm; Univents zeigt nur eine Vorschau und verknüpft Nachrichten mit Anfragen, Veranstaltungen und Kontakten.

Vor dem Verbinden wähle unter Sichtbarkeit neuer E-Mail-Konten:

• Pro Workspace (Standard) — alle Teammitglieder sehen das Postfach.
• Pro User — nur die Person, die das Konto verbunden hat, sieht es.

Klicke danach auf E-Mail-Konto verbinden und folge dem Authentifizierungsflow. Ist ein Konto verbunden und läuft der initiale Sync noch, kann es bis zu 24 Stunden dauern, bis alle Nachrichten erscheinen.

API-Schlüssel

Unter dem Tab API-Schlüssel erstellst und verwaltest du Schlüssel für externe Integrationen sowie MCP-Verbindungen (z. B. Claude Desktop, n8n).

1. Klicke Neuen Schlüssel erstellen.
2. Gib dem Schlüssel einen sprechenden Namen (z. B. "Claude Desktop", "n8n Workflow" oder "DWH-Export").
3. Wähle unter Berechtigungen die benötigten Scopes — je Ressource getrennt in Lesen und Schreiben (z. B. events:read, contacts:write). Für reine Daten-Exporte ins DWH/BI reichen die Lesen-Scopes; mcp:read ist der KI-/MCP-Zugriff. Schreiben impliziert kein Lesen — beides ist einzeln wählbar.
4. Klicke Erstellen. Der vollständige Schlüssel (rv_live_…) wird nur einmal angezeigt; kopiere ihn sofort über das Kopieren-Icon.
5. Nicht mehr benötigte Schlüssel lassen sich über Widerrufen deaktivieren oder mit dem Löschen-Icon endgültig entfernen.

Buchhaltung — DATEV-Export

Über den Tab DATEV exportierst du deine Ausgangsrechnungen als DATEV-Buchungsstapel (EXTF-CSV) — das Format, das Steuerberater in DE/AT für die Übernahme in ihre Kanzleisoftware erwarten. Alle Einstellungsfelder im Detail findest du im Artikel Buchhaltungs-Integrationen.

1. Öffne den Tab DATEV und trage unter DATEV-Einstellungen die Daten deines Steuerberaters ein: Beraternummer, Mandantennummer, Kontenrahmen (SKR03 oder SKR04) sowie die Standard-Konten für Debitor und Erlöse. Klicke auf Einstellungen speichern.
2. Fehlen diese Angaben noch, zeigt Univents oben auf der Seite den Hinweis DATEV-Einstellungen fehlen — folge dem Link, um sie nachzutragen.
3. Sind die Einstellungen gespeichert, wähle im Abschnitt Buchungsstapel exportieren den gewünschten Zeitraum (Von/Bis) und klicke auf DATEV-CSV herunterladen.
4. Bereits exportierte Rechnungen aus dem gewählten Zeitraum werden beim nächsten Export automatisch übersprungen. Für einen erneuten Export — etwa nach einer Korrektur — aktivierst du die Option Re-Export: bereits exportierte Rechnungen einschließen.

Steht der Tab DATEV in deinem Workspace nicht zur Verfügung, ist die Funktion in deinem aktuellen Plan noch nicht enthalten — Univents zeigt dir an der Stelle einen Upgrade-Hinweis.

REST-API (Daten-Export ins DWH/BI)

Univents bietet eine reguläre REST-API (v1) — gebaut für den laufenden Import deiner Workspace-Daten in ein Data Warehouse oder BI-Tool (initialer Voll-Abzug + inkrementeller Delta-Sync). Kein MCP/KI nötig; das ist die klassische, strukturierte Schiene.

• Spezifikation (öffentlich, ohne Schlüssel abrufbar, direkt in Postman/Codegen importierbar):
  • OpenAPI 3.1: https://univents.app/api/v1/openapi.json
  • Interaktive Doku: https://univents.app/api/v1/docs
• Authentifizierung: Bearer-API-Key (rv_live_…) mit Lesen-Scopes pro Ressource (siehe oben).
• Daten-Streams: Veranstaltungen, Kontakte & Firmen, Locations (Stammdaten) sowie Anfragen, Buchungen + Positionen und Finanzdokumente — Angebote/Rechnungen/Lieferscheine — inkl. Positionen (Transaktionsdaten).
• Delta-Sync: Über updated_since holst du nur Änderungen; die Cursor-Pagination liefert vollständige Seiten (bei Bedarf per id deduplizieren). Gelöschte Datensätze erscheinen als Tombstones (include_deleted=true) bzw. im eigenen /deleted-records-Stream. Alle Zeitstempel sind ISO 8601 UTC. Limit: 120 Anfragen/Minute pro Schlüssel.

Für ein laufendes Setup wende dich an den Support — wir stellen einen Schlüssel bereit und ergänzen fehlende Felder gezielt.

Häufige Fragen

Kann ich mehrere Kalender gleichzeitig verbinden? Ja. Füge über Neue Verbindung weitere Konten hinzu und weise jeder Verbindung eigene Locations zu, damit Pushes gezielt an den richtigen Kalender gehen.

Was passiert, wenn die Kalender- oder E-Mail-Verbindung abläuft? Univents zeigt den Badge Verbindung abgelaufen — neu verbinden direkt in der Verbindungskarte. Klicke darauf, um die Authentifizierung zu erneuern; alle bisherigen Einstellungen (Kalenderauswahl, Location-Zuweisung) bleiben erhalten.

Ist mein API-Schlüssel sicher? Bewahre den Schlüssel wie ein Passwort auf. Nach dem Erstellen zeigt Univents ihn genau einmal. Sollte ein Schlüssel in falsche Hände geraten, widerrufe ihn sofort über Widerrufen und erstelle einen neuen.

Kann ich meine Daten per API in ein eigenes DWH exportieren? Ja. Nutze die REST-API (siehe Abschnitt oben) mit einem Lesen-Schlüssel. Sie ist auf laufenden Voll- und Delta-Export ausgelegt; die Spezifikation liegt öffentlich unter https://univents.app/api/v1/openapi.json und lässt sich direkt in dein Tooling importieren.

Was genau exportiert der DATEV-Export? Festgeschriebene Ausgangsrechnungen (nicht mehr im Entwurf) aus dem gewählten Zeitraum, als Buchungsstapel im EXTF-CSV-Format — bereit für den Import in die Kanzleisoftware deines Steuerberaters. Details zu den einzelnen Feldern stehen im Artikel Buchhaltungs-Integrationen.

Ich sehe den Tab „DATEV" nicht — woran liegt das? Der DATEV-Export ist ab einem bestimmten Univents-Plan freigeschaltet. Klickst du trotzdem in den Bereich, zeigt Univents dir eine Upgrade-Information statt der Export-Funktion.