# Okresy rozliczeniowe

GET /v2/employeeworktimeperiods

EmployeeWorktimePeriod (Okres rozliczeniowy pracownika). Pozwala na pobranie rozliczonych okresów rozliczeniowych pracowników.

Definicja obiektu EmployeeWorktimePeriod.

id int
Unikalny identyfikator dla tego obiektu.

employeeId string
Numer interfejsowy pracownika.

employeeUniqueId int
Unikalny identyfikator pracownika.

isValid bool
Jeśli true to oznacza, że okres rozliczeniowy jest poprawnie rozliczony. W przeciwnym wypadku wymaga reakcji pracownika odpowiedzialnego za rozliczenia czasu pracy, a dane rozliczenia mogą być nieprawidłowe.

closedAt datetime
Data i czas kiedy okres rozliczeniowy został zamknięty.

recalculatedAt datetime
Data i czas kiedy okres rozliczeniowy był ostatni raz przeliczany.

from date
Data rozpoczęcia okresu rozliczeniowego.

to datetime
Data zakończenia okresu rozliczeniowego.

normDaysOff int
Liczba dni wolnych.

normValue duration
Czas do przepracowania wg. normy dla okresu rozliczeniowego pracownika.

weeklyNormAverageOvertimesAll duration
Czas pracy rozliczony jako nadgodziny średnio-tygodniowe.

weeklyNormAverageOvertimesExchanged duration
Czas pracy rozliczony jako nadgodziny średnio-tygodniowe odebrane.

weeklyNormAverageOvertimesPaid duration
Czas pracy rozliczony jako nadgodziny średnio-tygodniowe wypłacone.

sumRegisteredTotalDuration duration
Suma zarejestrowanego czasu pracy.

sumRegisteredBreaksDuration duration
Suma zarejestrowanego czasu jako przerwy.

sumRegisteredAtNightDuration duration
Suma zarejestrowanego czasu pracy w porze nocnej.

sumCalculatedIncludedDuration duration
Suma zaliczonego czas pracy.

sumCalculatedOvertime50Duration duration
Suma zaliczonego czasu pracy jako nadgodziny dobowe z dodatkiem 50%.

sumCalculatedOvertime100Duration duration
Suma zaliczonego czasu pracy jako nadgodziny dobowe z dodatkiem 100%.

sumCalculatedOvertimeWeeklyDuration duration
Suma zaliczonego czasu pracy jako nadgodziny kwalifikowane do nadgodzin średnio-tygodniowe z dodatkiem 100%.

sumCalculatedOvertimeAllDuration duration
Suma zaliczonego czasu pracy wszystkich nadgodzin.

sumCalculatedParttimerComplementationDuration duration
Suma zaliczonego czasu pracy ponad wymiar bez dodatku.

sumCalculatedUnjustifiedAbsenceDuration duration
Suma zaliczonego czasu pracy jako nieobecności nieusprawiedliwione.

sumCalculatedIncludedBalancedDuration duration
Suma bilanu zaliczonego czasu pracy.

sumCalculatedTotalBalanceDuration duration
Suma całkowitego bilansu zaliczonego czasu pracy.

modifiedAt datetime
Data i czas ostatniej modyfikacji

{
    "id": 1,
    "employeeId": "abc123",
    "employeeUniqueId": 123,
    "isValid": true,
    "from": "2020-01-01",
    "to": "2020-01-31",
    "closedAt": "2020-02-01",
    "recalculatedAt": "2020-02-01T00:00:00",
    "normDaysOff": 9,
    "normValue": "00:00:00",
    "weeklyNormAverageOvertimesAll": "00:00:00",
    "weeklyNormAverageOvertimesExchanged": "00:00:00",
    "weeklyNormAverageOvertimesPaid": "00:00:00",
    "sumRegisteredTotalDuration": "00:00:00",
    "sumRegisteredBreaksDuration": "00:00:00",
    "sumRegisteredAtNightDuration": "00:00:00",
    "sumCalculatedIncludedDuration": "00:00:00",
    "sumCalculatedOvertimeDuration": "00:00:00",
    "sumCalculatedOvertime50Duration": "00:00:00",
    "sumCalculatedOvertime100Duration": "00:00:00",
    "sumCalculatedOvertimeWeeklyDuration": "00:00:00",
    "sumCalculatedOvertimeAllDuration": "00:00:00",
    "sumCalculatedUnjustifiedAbsenceDuration": "00:00:00",
    "sumCalculatedParttimerComplementationDuration": "00:00:00",
    "sumCalculatedIncludedBalancedDuration": "00:00:00",
    "sumCalculatedTotalBalanceDuration": "00:00:00",
    "modifiedAt": "2020-02-01T00:00:00"
}

Zwraca stronicowalną listę rozliczonych okresów rozliczeniowych pracowników.

Parametry

• limit - ilość rekordów dla strony - domyślnie 1000
• page - numer strony - domyślnie 1
• forDay - filtr bazujący na zakresie obowiązywania okresu rozliczeniowego, podanie tej daty spowoduje, że zwrócone zostaną tylko te rekordy dla których podana data będzie się zawierać w okresie rozliczeniowym - domyślnie dzień bieżący
• employee - podany id pracownika spowoduje, że zwrócone zostaną absencje tylko jednego pracownika - domyślnie puste
• location - podany id lokalizacji spowoduje, że zwrócone zostaną absencje pracowników ze wskazanej lokalizacji - domyślnie puste
• employer - podany id pracodawcy spowoduje, że zwrócone zostaną absencje pracowników dla wskazanego pracodawcy - domyślnie puste
• withArchivedEmployees - dla wartości 1 dodatkowo zostaną zwrócone dane także dla pracowników archiwalnych - domyślnie puste

{
    "paging": {
        "current": 1,
        "total": 1
    },
    "items": [
        { EmployeeWorktimePeriod },
        { ... }
    ]
}

Zwraca
Obiekt zawierający metadane oraz listę absencji items. Każdy element listy jest osobnym obiektem EmployeeWorktimePeriod. Pusta lista oznacza, że nie ma więcej rekordów. To żądanie nigdy nie powinno zwrócić błędu.