Ewidencja czasu – platforma deweloperska Flowtly

Korzystaj z kuratowanego wycinka schematu OpenAPI Flowtly, aby planować integracje, automatyzować procesy i synchronizować kluczowe dane.

Status dokumentacji

Ostatnia synchronizacja: 2024-07-08 12:00 (wersja aplikacji 2.0.0)

Publicznie udostępniamy tylko część encji. Po każdej aktualizacji Flowtly uruchom obie komendy synchronizacji, by odświeżyć dane.

Ewidencja czasu

Synchronizuj wpisy czasu z narzędzi projektowych do Flowtly.

Przegląd encji

Ewidencja czasu

Wpisy WorkTime zasilają raporty wykorzystania, płace i fakturowanie bez ręcznego przepisywania godzin.

Endpointy

GET /api/employee_working_hours

Lista wpisów czasu

Czytaj employee_working_hours z filtrami po pracowniku, projekcie i czasie.

POST /api/employee_working_hours

Utwórz wpis czasu

Dodaj wpis z liczbą sekund, opisem i referencjami do pracownika oraz projektu.

GET /api/employee_working_hours/{id}

Pobierz wpis czasu po ID

Zobacz pojedynczy zapis czasu pracy.

PATCH /api/employee_working_hours/{id}

Zaktualizuj wpis czasu

Skoryguj sekundy, projekt lub notatki w istniejącym wpisie.

GET /api/employee-working-hours

List employee-working-hours

Retrieve employee-working-hours with pagination and filters.

POST /api/employee-working-hours

Create employee-working-hour

Create a new employee-working-hour entry.

GET /api/employee-working-hours/{id}

Get employee-working-hour

Fetch a single employee-working-hour by ID.

PATCH /api/employee-working-hours/{id}

Update employee-working-hour

Patch fields of an employee-working-hour entry.

DELETE /api/employee-working-hours/{id}

Delete employee-working-hour

Remove an employee-working-hour entry.

GET /api/work-times

List work-times

Retrieve work-time entries.

POST /api/work-times

Create work-time

Create a work-time record.

GET /api/work-times/{id}

Get work-time

Fetch a single work-time by ID.

PATCH /api/work-times/{id}

Update work-time

Patch a work-time record.

DELETE /api/work-times/{id}

Delete work-time

Delete a work-time record.

GET /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

Importuj zatwierdzone godziny z Asany, aby pulpity PMO w Flowtly były aktualne.
Wyślij rozliczalne godziny z tablicy agencji do Flowtly, by wystawić fakturę automatycznie.

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

POST /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.

Ładunek żądania
{
    "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"
}
Ładunek odpowiedzi
{
    "@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
}
Whatsapp