Integrationen & API

docunest lässt sich mit über 7.000 Apps verbinden — von Slack über Outlook bis DATEV. Dafür gibt es drei Wege: Zapier, Webhooks und die REST-API.

Alle Integrations-Einstellungen findest du im Dashboard unter Einstellungen → Integrationen.

API-Key erstellen

Ein API-Key ist die Voraussetzung für alle Integrationen. Er authentifiziert externe Systeme gegenüber docunest.

1. Gehe zu Einstellungen → Integrationen → API Keys.
2. Gib einen Namen ein (z. B. „Zapier" oder „DATEV-Export").
3. Klicke auf Erstellen.

Der vollständige Key wird nur einmal angezeigt — kopiere ihn sofort und speichere ihn sicher. Er beginnt mit dk_live_.

Du kannst bis zu 10 API-Keys gleichzeitig haben. Keys lassen sich jederzeit deaktivieren oder löschen.

Zapier verbinden

Mit Zapier verbindest du docunest mit tausenden Apps — ohne Programmierung. Typische Anwendungsfälle:

• Schicht beendet → Slack-Nachricht an den Team-Channel
• Urlaubsantrag → E-Mail an den Vorgesetzten
• Neuer Mitarbeiter → Eintrag in Google Sheets

So richtest du es ein

1. Erstelle einen API-Key (siehe oben) mit Lese- und Schreibrechten.
2. Erstelle einen kostenlosen Account auf zapier.com.
3. Erstelle einen neuen Zap und suche nach docunest Zeiterfassung.
4. Gib deinen API-Key ein, wenn nach der Verbindung gefragt wird.
5. Wähle einen Trigger (z. B. „Schicht Beendet") und eine Action (z. B. „Slack-Nachricht senden").
6. Teste den Zap und aktiviere ihn.

Verfügbare Trigger

| Trigger | Beschreibung | |---------|-------------| | Schicht Erstellt | Wird ausgelöst, wenn eine Schicht angelegt wird | | Schicht Gestartet | Wird ausgelöst, wenn jemand einstempelt | | Schicht Beendet | Wird ausgelöst, wenn jemand ausstempelt | | Pause Gestartet | Wird ausgelöst bei Pausenbeginn | | Pause Beendet | Wird ausgelöst bei Pausenende | | Urlaub Beantragt | Wird ausgelöst bei neuem Urlaubsantrag | | Urlaub Entschieden | Wird ausgelöst bei Genehmigung oder Ablehnung eines Urlaubsantrags | | Abwesenheit Gemeldet | Wird ausgelöst bei neuer Abwesenheitsmeldung | | Neuer Mitarbeiter | Wird ausgelöst, wenn ein Mitarbeiter hinzugefügt wird |

Verfügbare Actions

| Action | Beschreibung | |--------|-------------| | Einstempeln | Startet eine Schicht für einen Mitarbeiter | | Ausstempeln | Beendet die aktive Schicht | | Schicht Anlegen | Erstellt eine abgeschlossene Schicht mit Start- und Endzeit | | Urlaub Anlegen | Erstellt einen Urlaubsantrag | | Abwesenheit Anlegen | Meldet eine Abwesenheit |

Webhooks einrichten

Webhooks senden automatisch Benachrichtigungen an eine URL deiner Wahl, sobald ein Ereignis eintritt. Das ist nützlich für eigene Systeme oder Automatisierungen.

1. Gehe zu Einstellungen → Integrationen → Webhooks.
2. Klicke auf Webhook hinzufügen.
3. Gib die Ziel-URL ein (z. B. https://dein-server.de/webhook).
4. Wähle das Event aus (z. B. „Schicht abgeschlossen").
5. Klicke auf Erstellen.

Sicherheit

Jeder Webhook wird mit einer HMAC-SHA256-Signatur versehen. Den zugehörigen Secret findest du in den Webhook-Details. Prüfe die Signatur im Header X-Webhook-Signature, um sicherzustellen, dass die Anfrage tatsächlich von docunest stammt.

Zustellung

• Webhooks werden mit bis zu 3 Wiederholungsversuchen zugestellt (nach 1s, 5s, 25s).
• Nach 3 fehlgeschlagenen Versuchen in Folge wird der Webhook automatisch deaktiviert.
• Im Tab Webhook-Logs siehst du den Status jeder Zustellung.

REST-API

Für fortgeschrittene Integrationen bietet docunest eine vollständige REST-API. Die Dokumentation findest du im Dashboard unter Einstellungen → Integrationen → API-Dokumentation (Button oben rechts).

Die API bietet:

• Triggers: Polling-Endpoints für alle Events
• Actions: Schichten, Urlaub und Abwesenheiten erstellen
• Searches: Mitarbeiter, Projekte und Schichten durchsuchen

Alle Anfragen werden mit dem API-Key im Header Authorization: Bearer dk_live_... authentifiziert.