Przejdź do głównej zawartości

Aktualizacja publicznego API v2: nowe endpointy dla grafiku i kart czasu pracy

Poznaj nowe endpointy publicznego API, które pozwalają pracować z grafikiem i kartami czasu pracy pracowników.

J
Napisane przez Julia

Nadal rozszerzamy możliwości publicznego API v2 w RO App. Teraz przez API możesz pracować z grafikiem i kartami czasu pracy pracowników, aby synchronizować te dane z innymi systemami i nie wprowadzać ich ręcznie.

Grafik i karty czasu pracy przez API

W publicznym API pojawiła się nowa sekcja Employee Hours z endpointami dla grafiku i kart czasu pracy.

Zarówno dla grafiku, jak i dla kart czasu pracy możesz teraz:

  • pobierać dane za okres do 92 dni;

  • pobierać dane wszystkich pracowników na konkretną datę;

  • pobierać dane konkretnego pracownika na wybraną datę;

  • tworzyć lub całkowicie zastępować dane pracownika na wybraną datę;

  • usuwać dane pracownika na wybraną datę.

Pamiętaj: grafik można zmieniać zarówno dla dni przeszłych, jak i przyszłych, a karty czasu pracy – tylko dla dni przeszłych i dnia bieżącego, ponieważ odzwierciedlają faktycznie przepracowany czas.

Dla dnia roboczego możesz przekazać kilka przedziałów czasowych – na przykład jeśli pracownik w pierwszej połowie dnia pracuje w jednej lokalizacji, a w drugiej – w innej. Dla dnia nieroboczego możesz wskazać jego typ: urlop, zwolnienie lekarskie lub dzień wolny, a także zaznaczyć, czy jest płatny.

Dane można filtrować według pracowników, lokalizacji i typu dnia.

Więcej o endpointach dla grafiku i kart czasu pracy znajdziesz w dokumentacji publicznego API.

Jak nowe endpointy pomogą Twojej firmie

Na przykład za ich pomocą możesz:

  • synchronizować grafik z systemami HR i serwisami do planowania zmian;

  • automatycznie przenosić grafik i karty czasu pracy z systemów zewnętrznych do RO App;

  • przekazywać dane o czasie pracy do systemów płacowych i księgowych;

  • tworzyć własne raporty dotyczące obciążenia pracowników w różnych lokalizacjach.

Dostęp do endpointów

Klucz API należy do konkretnego pracownika RO App i ma takie same uprawnienia dostępu jak on. Do pobierania danych pracownik potrzebuje uprawnienia do przeglądania rozkładu pracowników, a do ich zmiany – uprawnienia do edycji grafiku lub kart czasu pracy.

Jeśli masz pytania, sugestie lub uwagi dotyczące publicznego API i webhooków RO App, skontaktuj się z nami przez czat wsparcia.

Czy to odpowiedziało na twoje pytanie?