Przegląd encji
Ewidencja czasu
Wpisy WorkTime zasilają raporty wykorzystania, płace i fakturowanie bez ręcznego przepisywania godzin.
Endpointy
/api/employee_working_hours
Lista wpisów czasu
Czytaj employee_working_hours z filtrami po pracowniku, projekcie i czasie.
/api/employee_working_hours
Utwórz wpis czasu
Dodaj wpis z liczbą sekund, opisem i referencjami do pracownika oraz projektu.
/api/employee_working_hours/{id}
Pobierz wpis czasu po ID
Zobacz pojedynczy zapis czasu pracy.
/api/employee_working_hours/{id}
Zaktualizuj wpis czasu
Skoryguj sekundy, projekt lub notatki w istniejącym wpisie.
/api/employee-working-hours
List employee-working-hours
Retrieve employee-working-hours with pagination and filters.
/api/employee-working-hours
Create employee-working-hour
Create a new employee-working-hour entry.
/api/employee-working-hours/{id}
Get employee-working-hour
Fetch a single employee-working-hour by ID.
/api/employee-working-hours/{id}
Update employee-working-hour
Patch fields of an employee-working-hour entry.
/api/employee-working-hours/{id}
Delete employee-working-hour
Remove an employee-working-hour entry.
/api/work-times
List work-times
Retrieve work-time entries.
/api/work-times
Create work-time
Create a work-time record.
/api/work-times/{id}
Get work-time
Fetch a single work-time by ID.
/api/work-times/{id}
Update work-time
Patch a work-time record.
/api/work-times/{id}
Delete work-time
Delete a work-time record.
/api/employees/{id}/working-hours-stats/{date}
Get working-hours stats
Retrieve aggregated working-hours stats for an employee at a date.
Przypadki użycia
Pola schematu
WorkTime| Pole | Typ | Opis |
|---|---|---|
id |
integer | Identyfikator wpisu czasu pracy. |
employee |
string | IRI pracownika, który zgłosił czas. |
project |
string | Projekt, do którego przypisano czas. |
date |
string | Data/godzina wykonania pracy. |
seconds |
integer | Czas trwania w sekundach. |
description |
string | null | Opcjonalny opis aktywności. |
createdAt |
string | Data utworzenia wpisu. |
updatedAt |
string | Data ostatniej modyfikacji. |
deletedAt |
string | null | Data miękkiego usunięcia (jeśli dotyczy). |
deleted |
boolean | Check if the entity has been soft deleted. |
Przykłady
/api/employee_working_hours
Prześlij rozliczalny wpis z Asany
Przesyła wpis 7,5 godziny (27 000 sekund) z narzędzia projektowego, aby Flowtly zaktualizowało wykorzystanie i fakturowanie.
{
"employee": "/api/employees/emp_102",
"project": "/api/projects/aurora",
"date": "2024-07-04T00:00:00+00:00",
"seconds": 27000,
"description": "Budget review for Aurora project"
}
{
"@id": "/api/employee_working_hours/wkt_9001",
"@type": "WorkTime",
"id": 9001,
"employee": "/api/employees/emp_102",
"project": "/api/projects/aurora",
"date": "2024-07-04T00:00:00+00:00",
"seconds": 27000,
"description": "Budget review for Aurora project",
"createdAt": "2024-07-04T18:05:00+00:00",
"updatedAt": "2024-07-04T18:05:00+00:00",
"deleted": false
}