Wir erweitern die Möglichkeiten der öffentlichen API v2 in RO App weiter. Über die API können Sie jetzt mit Arbeitsplänen und Stundenzetteln Ihrer Mitarbeiter arbeiten, um diese Daten mit anderen Systemen zu synchronisieren und sie nicht mehr manuell eingeben zu müssen.
Arbeitspläne und Stundenzettel über die API
In der öffentlichen API gibt es einen neuen Bereich Employee Hours mit Endpunkten für Arbeitspläne und Stundenzettel.
Sowohl für Arbeitspläne als auch für Stundenzettel können Sie jetzt:
Daten für einen Zeitraum von bis zu 92 Tagen abrufen;
Daten aller Mitarbeiter für ein bestimmtes Datum abrufen;
Daten eines bestimmten Mitarbeiters für ein ausgewähltes Datum abrufen;
Daten eines Mitarbeiters für ein ausgewähltes Datum erstellen oder vollständig ersetzen;
Daten eines Mitarbeiters für ein ausgewähltes Datum löschen.
Bitte beachten Sie: Arbeitspläne können sowohl für vergangene als auch für zukünftige Tage geändert werden, Stundenzettel dagegen nur für vergangene Tage und den heutigen Tag, da sie die tatsächlich geleistete Arbeitszeit erfassen.
Für einen Arbeitstag können Sie mehrere Intervalle übermitteln – zum Beispiel, wenn ein Mitarbeiter in der ersten Tageshälfte an einem Standort und in der zweiten an einem anderen arbeitet. Für einen arbeitsfreien Tag können Sie dessen Art angeben: Urlaub, Krankheitstag oder freier Tag, und außerdem festlegen, ob er bezahlt ist.
Die Daten lassen sich nach Mitarbeitern, Standorten und Tagesart filtern.
Mehr über die Endpunkte für Arbeitspläne und Stundenzettel erfahren Sie in der Dokumentation der öffentlichen API.
Wie die neuen Endpunkte Ihrem Unternehmen helfen
Damit können Sie zum Beispiel:
Arbeitspläne mit HR-Systemen und Diensten zur Schichtplanung synchronisieren;
Arbeitspläne und Stundenzettel automatisch aus externen Systemen in RO App übertragen;
Arbeitszeitdaten an Systeme für Lohnabrechnung und Buchhaltung übermitteln;
eigene Berichte zur Auslastung der Mitarbeiter an verschiedenen Standorten erstellen.
Zugriff auf die Endpunkte
Ein API-Schlüssel gehört einem bestimmten Mitarbeiter in RO App und hat dieselben Zugriffsrechte wie dieser. Zum Abrufen von Daten benötigt der Mitarbeiter die Berechtigung zum Anzeigen der Arbeitszeit der Mitarbeiter, zum Ändern – die Berechtigung zum Bearbeiten des Arbeitsplans oder der Stundenzettel.
Wenn Sie Fragen, Anregungen oder Kommentare zur öffentlichen API und zu Webhooks von RO App haben, kontaktieren Sie uns über den Support-Chat.