Clockify-Integration
docs101 bietet eine schreibgeschützte Integration mit Clockify, mit der Sie Ihre Clockify-Workspace-Daten direkt in der Anwendung durchsuchen können. Nach der Verbindung mit Ihrem API-Key können Sie Ihre Arbeitsbereiche, die Benutzer in jedem Arbeitsbereich und die zugehörigen Kunden einsehen.
Die Clockify-Integration in docs101 ist eine schreibgeschützte Verbindung, mit der Sie Ihre Clockify-Workspace-Struktur (Arbeitsbereiche, Benutzer, Kunden) durchsuchen können. Das ist nützlich, um Ihre Clockify-Daten beim Arbeiten an Rechnungen als Referenz zu nutzen, ohne zwischen Anwendungen wechseln zu müssen.
Voraussetzungen
Bevor Sie die Clockify-Integration nutzen können, benötigen Sie:
- Ein aktives Clockify-Konto (kostenloser oder bezahlter Tarif)
- Einen Clockify-API-Key zur Authentifizierung
Falls Sie noch kein Clockify-Konto haben, besuchen Sie clockify.me, um eines zu erstellen. Der kostenlose Tarif umfasst Zeiterfassung, Projekte und API-Zugriff.
Schritt 1: Clockify-API-Key generieren
Um docs101 mit Clockify zu verbinden, müssen Sie einen API-Key aus Ihrem Clockify-Konto generieren.
In Clockify:
- Melden Sie sich bei Ihrem Clockify-Konto an
- Klicken Sie auf Ihr Profilsymbol (obere rechte Ecke)
- Gehen Sie zu Einstellungen
- Wählen Sie in der linken Seitenleiste API
- Ihr API-Key wird angezeigt
- Klicken Sie auf das Kopieren-Symbol, um ihn in die Zwischenablage zu kopieren
Ihr API-Key ist wie ein Passwort. Teilen Sie ihn niemals und fügen Sie ihn nicht an unsicheren Orten ein. Geben Sie ihn nur über die offizielle Integrations-Einstellung an docs101 weiter. docs101 speichert Ihren API-Key verschlüsselt.
Alternative Methode (Arbeitsbereich-Einstellungen): Einige Clockify-Versionen zeigen API-Einstellungen in den Arbeitsbereich-Einstellungen:
- Gehen Sie zu Arbeitsbereich-Einstellungen (über das Einstellungen-Dropdown)
- Wählen Sie Arbeitsbereich > API
- Kopieren Sie Ihren API-Key
Schritt 2: Clockify mit docs101 verbinden
Nun fügen Sie Ihren Clockify-API-Key in docs101 hinzu.
In docs101:
- Melden Sie sich bei docs101 an
- Navigieren Sie zu Kontoeinstellungen
- Finden Sie den Abschnitt Integrationen
- Suchen Sie Clockify und klicken Sie auf Verbinden
- Fügen Sie Ihren Clockify-API-Key in das Feld ein
- Klicken Sie auf Speichern
- Sie sehen eine Bestätigungsmeldung bei erfolgreicher Verbindung
Nach Eingabe Ihres API-Keys testet docs101 die Verbindung, indem es eine Liste Ihrer Clockify-Arbeitsbereiche abruft. Wenn Arbeitsbereiche angezeigt werden, ist Ihre Integration einsatzbereit.
Behebung von Verbindungsproblemen
| Problem | Lösung |
|---|---|
| "Ungültiger Token"-Fehler | Prüfen Sie, ob Sie den vollständigen API-Key kopiert haben. Generieren Sie einen neuen Key, falls unsicher. |
| "Arbeitsbereich nicht gefunden" | Stellen Sie sicher, dass Sie mit dem richtigen Clockify-Arbeitsbereich verbunden sind. Prüfen Sie Ihr Profil. |
| Verbindungs-Timeout | Prüfen Sie Ihre Internetverbindung. Versuchen Sie, die Verbindung zu trennen und erneut herzustellen. |
Verfügbare Funktionen
Nach der Verbindung bietet die Clockify-Integration drei schreibgeschützte Abfragen:
Arbeitsbereiche durchsuchen
Zeigen Sie alle Arbeitsbereiche an, die mit Ihrem Clockify-API-Key verknüpft sind. Jeder Arbeitsbereich zeigt:
- Arbeitsbereich-ID
- Arbeitsbereich-Name
Das ist nützlich, wenn Sie mehrere Clockify-Arbeitsbereiche verwalten und bestätigen möchten, welcher die benötigten Daten enthält.
Benutzer pro Arbeitsbereich durchsuchen
Nach Auswahl eines Arbeitsbereichs können Sie alle zugehörigen Benutzer anzeigen. Jeder Eintrag zeigt:
- Benutzer-ID
- Benutzername
Das hilft Ihnen, Teammitglieder und deren Arbeitsbereichszugehörigkeit zu identifizieren, wenn Sie Rechnungen für zeitbasierte Arbeit vorbereiten.
Kunden pro Arbeitsbereich durchsuchen
Nach Auswahl eines Arbeitsbereichs können Sie alle konfigurierten Kunden anzeigen. Jeder Eintrag zeigt:
- Kunden-ID
- Kundenname
Das ist nützlich zum Abgleich Ihrer Clockify-Kundenliste mit Ihren docs101-Kundendaten.
Integration in der Praxis nutzen
Die Clockify-Integration in docs101 ist zwar schreibgeschützt, dient aber als praktisches Nachschlage-Tool während Ihres Rechnungs-Workflows:
- Clockify-Bereich öffnen in docs101
- Arbeitsbereich auswählen, um dessen Daten zu durchsuchen
- Benutzer und Kunden anzeigen zum Abgleich mit Ihrer Rechnung
- Rechnungspositionen manuell erstellen in docs101 basierend auf den eingesehenen Informationen
Die Integration erstellt keine Rechnungspositionen automatisch aus Clockify-Daten. Nutzen Sie die durchsuchten Informationen als Referenz beim manuellen Hinzufügen von Positionen zu Ihren Rechnungen. Details zum Hinzufügen von Positionen finden Sie im Leitfaden Rechnung erstellen & versenden.
Best Practices
- API-Key aktuell halten: Wenn Sie Ihren Clockify-API-Key neu generieren, aktualisieren Sie ihn sofort in docs101
- Clockify-Kunden organisieren: Verwenden Sie in Clockify konsistente Kundennamen, die Ihren docs101-Kundennamen entsprechen, um den Abgleich zu erleichtern
- Arbeitsbereiche effektiv nutzen: Bei Arbeit mit mehreren Teams oder Geschäftsbereichen verwenden Sie separate Clockify-Arbeitsbereiche zur Datenorganisation
Referenz-Links
- Rechnung erstellen & versenden - Rechnungserstellungs-Workflow