Cloxo API: Verbinden Sie Ihre Stechuhr mit Ihrer anderen Software
Mit der Cloxo API stempelt Ihre Kasse, Ihre Einsatzplanung oder Ihr Lohnprogramm Mitarbeitende ein und aus und ruft Stunden, Anwesenheit und Monatsberichte ab. Die API ist in jedem Plan enthalten, auch in der Testphase.
Cloxo hält fest, wer wann arbeitet. Diese Stunden brauchen Sie oft auch anderswo: in Ihrer Kasse, in Ihrer Einsatzplanung oder für die Lohnabrechnung. Mit der Cloxo API spricht Ihre andere Software direkt mit Ihrer Stechuhr, ohne Abtippen und ohne Dateien hin- und herzuschicken.
Kurz gesagt
- REST-API mit JSON über HTTPS, beschrieben in einer OpenAPI-Datei
- Ein- und Ausstempeln und Pausen aus Ihrer eigenen Software erfassen
- Mitarbeitende, Anwesenheit, Zeiteinträge und Monatsberichte abrufen
- MCP-Server für KI-Assistenten
- In jedem Plan und in der kostenlosen Testphase enthalten
- Schlüssel in einer Minute erstellt, jederzeit widerrufbar
Entwickler? Lesen Sie die Dokumentation der API (auf Englisch).
Was Sie damit tun
| Sie möchten | So macht es die API |
|---|---|
| Aus Ihrer Kasse oder Zutrittskontrolle einstempeln | Ihre Software sendet ein Stempelereignis, sobald sich jemand anmeldet. Cloxo macht daraus einen Zeiteintrag. |
| Sehen, wer gerade da ist | Eine Anfrage liefert den Stand je Mitarbeitenden: eingestempelt, in Pause oder ausgestempelt. |
| Stunden an die Lohnabrechnung geben | Rufen Sie die Zeiteinträge eines Zeitraums ab oder den Monatsbericht je Mitarbeitenden, auch als PDF. |
| Ihre Planung mit der Wirklichkeit vergleichen | Vergleichen Sie geplante und geleistete Stunden, je Tag und je Person. |
| Neue Mitarbeitende hinzufügen | Ihre Software legt Mitarbeitende an. Sie stempeln danach mit einem PIN-Code. |
So funktioniert es
- Erstellen Sie einen Schlüssel. In Cloxo unter Einstellungen → API & Integrationen. Sie wählen, was der Schlüssel darf: Daten lesen, ein- und ausstempeln oder Mitarbeitende hinzufügen.
- Geben Sie den Schlüssel Ihrem Softwareanbieter oder Entwickler. Er liest die Dokumentation und baut die Integration.
- Fertig. Die Zeiteinträge landen in Cloxo neben denen aus der App, vom QR-Code und vom Tablet. Korrekturen und Berichte funktionieren wie gewohnt.
So sieht ein Stempelereignis aus:
curl -X POST "https://app.cloxo.app/api/public/v1/clock-events" \
-H "Authorization: Bearer cloxo_live_…" \
-H "Content-Type: application/json" \
-d '{"action":"clock_in","employee_id":"7c1d6a52-3f0e-4c9b-9a51-2f6f3f1f0b11"}'
Die vollständige Referenz mit allen Möglichkeiten, Fehlercodes und Beispielen steht in der Dokumentation für Entwickler (auf Englisch). Es gibt auch eine OpenAPI-Datei, die Sie in Postman laden oder zum Generieren eines Clients nutzen können.
Für KI-Assistenten: MCP
Cloxo hat auch einen MCP-Server. Damit arbeitet ein KI-Assistent direkt mit Ihrer Stechuhr. Sie fragen „Wer arbeitet gerade?“ oder „Wie viele Stunden hat Sofie im Oktober gearbeitet?“ und der Assistent holt die Antwort selbst.
Sie verbinden den Assistenten mit demselben Schlüssel. Geben Sie ihm nur das Leserecht, kann der Assistent nichts ändern. Der MCP-Server funktioniert mit Programmen, die einen Schlüssel mitsenden können, etwa Claude Code und Cursor.
Sicher eingerichtet
- Ein Schlüssel gehört zu einem Unternehmen und sieht nie die Daten eines anderen.
- Sie wählen je Schlüssel die Rechte und, wenn Sie möchten, ein Ablaufdatum.
- Sie widerrufen einen Schlüssel mit einem Klick. Er funktioniert dann sofort nicht mehr.
- Cloxo speichert nur einen Fingerabdruck des Schlüssels. Den Schlüssel selbst sehen Sie einmal, beim Erstellen.
- Der gesamte Datenverkehr ist verschlüsselt und die Daten liegen auf europäischen Servern.
Was die API nicht ist
Die API ist ein Baustein. Es gibt keine fertigen Integrationen mit einem bestimmten Lohnprogramm: Die Integration baut Ihr Softwareanbieter oder ein Entwickler. Sie möchten nichts bauen? Dann bleibt der PDF- oder CSV-Export der kürzeste Weg zu Ihrer Buchhaltung.
Häufige Fragen
Hat Cloxo eine API?
Ja. Cloxo bietet eine REST-API, mit der andere Software Mitarbeitende ein- und ausstempeln und Mitarbeitende, Anwesenheit, Zeiteinträge und Monatsberichte abrufen kann. Die Dokumentation finden Sie unter app.cloxo.app/developers.
Kostet die API extra?
Nein. Die API ist in jedem Plan enthalten und funktioniert auch in der kostenlosen Testphase. Sie benötigen ein aktives Abonnement oder eine laufende Testphase.
Kann ich Cloxo mit meinem Lohnprogramm verbinden?
Es gibt keine fertige Integration je Programm. Sie haben zwei Wege: den PDF- oder CSV-Export, den Sie mit einem Klick weiterleiten, oder die API, über die Ihr Softwareanbieter die Stunden automatisch abruft.
Brauche ich einen Entwickler?
Für die Integration selbst ja: Jemand muss Ihre Software an die API anbinden. Den Schlüssel erstellen Sie selbst in einer Minute, in den Einstellungen.
Ist es sicher, einem Anbieter einen API-Schlüssel zu geben?
Ja, wenn Sie ihn wie ein Passwort behandeln. Ein Schlüssel gehört zu einem Unternehmen, erhält nur die Rechte, die Sie wählen, und lässt sich mit einem Klick widerrufen. Cloxo speichert nur einen Fingerabdruck des Schlüssels, nie den Schlüssel selbst.
Funktioniert Cloxo mit KI-Assistenten?
Ja, über den MCP-Server. Ein Assistent, der MCP unterstützt und einen Schlüssel mitsenden kann, etwa Claude Code oder Cursor, ruft Anwesenheit, Stunden und Berichte ab und kann, wenn Sie es erlauben, ein- und ausstempeln.
Loslegen
Erstellen Sie ein Konto, fügen Sie Mitarbeitende hinzu und erstellen Sie Ihren ersten Schlüssel. In der Testphase funktioniert die API vollständig, ohne Zahlungsdaten. Was ein Plan kostet, steht bei den Preisen; praktische Fragen finden Sie in der Hilfe.