Orari e presenze – costruisci su Flowtly

Usa questo snapshot curato dello schema OpenAPI di Flowtly per pianificare integrazioni, automatizzare workflow e sincronizzare i dati su cui i tuoi team fanno affidamento.

Stato della documentazione

Ultima sincronizzazione il 2026-04-03 18:31 (versione app 2.0.0)

Solo un sottoinsieme di entità è reso pubblico. Esegui entrambi i comandi di sincronizzazione per aggiornare questa documentazione quando l'app Flowtly introduce nuove funzionalità.

Orari e presenze

Registrazioni di lavoro, pianificazioni, festività e gestione delle assenze.

Panoramica entità

Ore di lavoro

Usa le voci WorkTime per alimentare i dashboard di utilizzo, paghe e fatturazione senza costringere i team a reinserire le ore.

Endpoint

GET https://api.flowtly.eu/employee-working-hours

Elenca ore di lavoro

Recupera la raccolta di risorse WorkTime.

POST https://api.flowtly.eu/employee-working-hours

Crea ore di lavoro

Crea una risorsa WorkTime.

GET https://api.flowtly.eu/employee-working-hours/{id}

Ottieni ore di lavoro per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/employee-working-hours/{id}

Elimina ore di lavoro

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/employee-working-hours/{id}

Aggiorna ore di lavoro

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/work-times

Elenca ore di lavoro

Recupera la raccolta di risorse WorkTime.

POST https://api.flowtly.eu/work-times

Crea ore di lavoro

Crea una risorsa WorkTime.

GET https://api.flowtly.eu/work-times/{id}

Ottieni ore di lavoro per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/work-times/{id}

Elimina ore di lavoro

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/work-times/{id}

Aggiorna ore di lavoro

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Importa le ore approvate in retrospettiva da Asana affinché i dashboard PMO in Flowtly rimangano aggiornati.

Invia le ore fatturabili dalla board attività di un'agenzia in Flowtly per generare le fatture automaticamente.

Campi dello schema

WorkTime-employee_working_hour.read

Campo	Tipo	Descrizione
`id`	integer	Campo id.
`employee`	string	Campo employee.
`project`	string	Campo project.
`date`	string	Campo date.
`seconds`	integer	Campo seconds.
`description`	string \| null	Campo description.

Panoramica entità

Ferie e permessi

Gestisci ferie retribuite, malattia e tipi di assenza personalizzati con workflow di approvazione.

Endpoint

GET https://api.flowtly.eu/holidays

Elenca ferie e permessi

Recupera la raccolta di risorse HolidayType.

POST https://api.flowtly.eu/holidays

Crea ferie e permesso

Crea una risorsa HolidayRequest.

GET https://api.flowtly.eu/holidays/active

Elenca attivi

Recupera la raccolta di risorse Holiday.

GET https://api.flowtly.eu/holidays/{id}

Ottieni ferie e permesso per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/holidays/{id}

Elimina ferie e permesso

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/holidays/{id}

Aggiorna ferie e permesso

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/holiday-requests

Elenca ferie e permessi

Recupera la raccolta di risorse HolidayType.

POST https://api.flowtly.eu/holiday-requests

Crea ferie e permesso

Crea una risorsa HolidayRequest.

GET https://api.flowtly.eu/holiday-requests/{id}

Ottieni ferie e permesso per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/holiday-requests/{id}

Elimina ferie e permesso

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/holiday-requests/{id}

Aggiorna ferie e permesso

Aggiorna i campi della risorsa tramite JSON Merge Patch.

POST https://api.flowtly.eu/holiday-requests/{id}/approve

Crea una risorsa HolidayRequest.

POST https://api.flowtly.eu/holiday-requests/{id}/reject

Crea una risorsa HolidayRequest.

GET https://api.flowtly.eu/holiday-types

Elenca ferie e permessi

Recupera la raccolta di risorse HolidayType.

GET https://api.flowtly.eu/holiday-types/{id}

Ottieni ferie e permesso per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/holiday-types/{id}

Aggiorna ferie e permesso

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Sincronizza i congedi approvati dal tuo portale HR affinché la pianificazione della capacità in Flowtly rimanga accurata.

Invia i saldi ferie al tuo sistema paghe per la deduzione automatica.

Campi dello schema

HolidayRequest-holiday_request.read_employee.preview

Campo	Tipo	Descrizione
`id`	integer	Campo id.
`status`	string	Campo status.
`employee`	object	Campo employee.
`holiday`	string \| null	Campo holiday.
`type`	string	Campo type.
`description`	string \| null	Campo description.
`dateFrom`	string	Campo dateFrom.
`dateTo`	string	Campo dateTo.
`seconds`	integer \| null	Campo seconds.
`requestedSeconds`	integer \| null	Campo requestedSeconds.
`requestedAt`	datetime	Campo requestedAt.

Panoramica entità

Diritto ferie

Configura i budget di congedo per dipendente, le regole di riporto e i calendari delle festività pubbliche.

Endpoint

GET https://api.flowtly.eu/holiday-days-frees

Elenca diritti ferie

Recupera la raccolta di risorse HolidayDaysLimitDefault.

POST https://api.flowtly.eu/holiday-days-frees

Crea diritto ferie

Crea una risorsa HolidayDaysLimitDefault.

GET https://api.flowtly.eu/holiday-days-frees/{id}

Ottieni diritto ferie per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/holiday-days-frees/{id}

Elimina diritto ferie

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/holiday-days-frees/{id}

Aggiorna diritto ferie

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/holiday-days-limits

Elenca diritti ferie

Recupera la raccolta di risorse HolidayDaysLimitDefault.

POST https://api.flowtly.eu/holiday-days-limits

Crea diritto ferie

Crea una risorsa HolidayDaysLimitDefault.

GET https://api.flowtly.eu/holiday-days-limits/{id}

Ottieni diritto ferie per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/holiday-days-limits/{id}

Elimina diritto ferie

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/holiday-days-limits/{id}

Aggiorna diritto ferie

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/holiday-days-limit-defaults

Elenca diritti ferie

Recupera la raccolta di risorse HolidayDaysLimitDefault.

POST https://api.flowtly.eu/holiday-days-limit-defaults

Crea diritto ferie

Crea una risorsa HolidayDaysLimitDefault.

GET https://api.flowtly.eu/holiday-days-limit-defaults/{id}

Ottieni diritto ferie per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/holiday-days-limit-defaults/{id}

Elimina diritto ferie

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/holiday-days-limit-defaults/{id}

Aggiorna diritto ferie

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Importa i diritti di ferie statutorie dal tuo HRIS all'inizio di ogni anno fiscale.

Sincronizza i calendari delle festività pubbliche per paese per calcoli accurati dei giorni rimanenti.

Campi dello schema

HolidayDaysLimit-holiday_days_limit.read

Campo	Tipo	Descrizione
`id`	integer	Campo id.
`employee`	string	Campo employee.
`days`	integer	Campo days.
`holidayType`	string \| null	Campo holidayType.
`variant`	string	Campo variant.
`allowRequestWhenUsed`	boolean	Campo allowRequestWhenUsed.
`dateFrom`	string	Campo dateFrom.
`notes`	string \| null	Campo notes.

Panoramica entità

Pianificazione

Definisci pianificazioni ricorrenti e assegna i dipendenti ai turni per il monitoraggio della capacità e delle presenze.

Endpoint

GET https://api.flowtly.eu/schedules

Elenca pianificazioni

Recupera la raccolta di risorse ScheduleRange.

POST https://api.flowtly.eu/schedules

Crea pianificazione

Crea una risorsa ScheduleRange.

GET https://api.flowtly.eu/schedules/plan/{date}

Ottieni pianificazione per ID

Recupera una singola risorsa tramite il suo identificatore.

GET https://api.flowtly.eu/schedules/{id}

Ottieni pianificazione per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/schedules/{id}

Aggiorna pianificazione

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/schedule-employees

Elenca pianificazioni

Recupera la raccolta di risorse ScheduleRange.

POST https://api.flowtly.eu/schedule-employees

Crea pianificazione

Crea una risorsa ScheduleRange.

GET https://api.flowtly.eu/schedule-employees/{id}

Ottieni pianificazione per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/schedule-employees/{id}

Elimina pianificazione

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/schedule-employees/{id}

Aggiorna pianificazione

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/schedule-ranges

Elenca pianificazioni

Recupera la raccolta di risorse ScheduleRange.

POST https://api.flowtly.eu/schedule-ranges

Crea pianificazione

Crea una risorsa ScheduleRange.

GET https://api.flowtly.eu/schedule-ranges/{id}

Ottieni pianificazione per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/schedule-ranges/{id}

Elimina pianificazione

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/schedule-ranges/{id}

Aggiorna pianificazione

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Invia i turni dal tuo strumento di pianificazione in Flowtly per la validazione della rilevazione presenze.

Sincronizza le modifiche alla pianificazione per mantenere allineati i calcoli degli straordinari e le paghe.

Campi dello schema

Schedule-schedule.read_schedule_range.read_employee.preview

Campo	Tipo	Descrizione
`id`	string	Campo id.
`name`	string	Campo name.
`description`	string \| null	Campo description.
`numberOfDays`	integer	Campo numberOfDays.
`regular`	boolean	Campo regular.
`overwriteBankHolidays`	boolean	Campo overwriteBankHolidays.
`scheduleRanges`	array	Campo scheduleRanges.
`scheduleEmployees`	array	Campo scheduleEmployees.
`createdAt`	string	Campo createdAt.
`employees`	object	Campo employees.
`employeesCount`	integer	Campo employeesCount.

Panoramica entità

Giorno festivo

Mantieni i calendari ufficiali dei giorni festivi che alimentano i calcoli dei congedi e i conteggi dei giorni lavorativi.

Endpoint

GET https://api.flowtly.eu/bank-holidays

Elenca giorni festivi

Recupera la raccolta di risorse BankHoliday.

POST https://api.flowtly.eu/bank-holidays

Crea giorno festivo

Crea una risorsa BankHoliday.

GET https://api.flowtly.eu/bank-holidays/{id}

Ottieni giorno festivo per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/bank-holidays/{id}

Elimina giorno festivo

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/bank-holidays/{id}

Aggiorna giorno festivo

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Importa le festività pubbliche specifiche per paese per i team multi-regione.

Escludi i giorni festivi dai calcoli di fatturazione automaticamente.

Campi dello schema

BankHoliday-bank_holiday.read

Campo	Tipo	Descrizione
`id`	integer	Campo id.
`date`	string	Campo date.
`publicNotes`	string \| null	Campo publicNotes.
`yearFrom`	integer \| null	Campo yearFrom.
`yearTo`	integer \| null	Campo yearTo.