Tempo e presença – construir no Flowtly

Utilize este instantâneo selecionado do esquema OpenAPI do Flowtly para planear integrações, automatizar fluxos de trabalho e sincronizar os dados em que as suas equipas confiam.

Estado da documentação

Última sincronização em 2026-04-03 18:31 (versão da aplicação 2.0.0)

Apenas um subconjunto de entidades é tornado público. Execute ambos os comandos de sincronização para atualizar esta documentação quando a aplicação Flowtly disponibilizar novas capacidades.

Tempo e presença

Registos de trabalho, horários, feriados e gestão de ausências.

Visão geral da entidade

Tempo de trabalho

Utilizar entradas de WorkTime para orientar dashboards de utilização, processamento salarial e faturação sem obrigar as equipas a reinserir horas.

Endpoints

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

Listar tempos de trabalho

Obtém a coleção de recursos WorkTime.

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

Criar tempo de trabalho

Cria um recurso WorkTime.

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

Obter tempo de trabalho por ID

Obter um único recurso pelo seu identificador.

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

Eliminar tempo de trabalho

Eliminar o recurso.

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

Atualizar tempo de trabalho

Atualizar campos do recurso utilizando JSON Merge Patch.

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

Listar tempos de trabalho

Obtém a coleção de recursos WorkTime.

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

Criar tempo de trabalho

Cria um recurso WorkTime.

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

Obter tempo de trabalho por ID

Obter um único recurso pelo seu identificador.

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

Eliminar tempo de trabalho

Eliminar o recurso.

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

Atualizar tempo de trabalho

Atualizar campos do recurso utilizando JSON Merge Patch.

Casos de uso

Importar horas aprovadas retroativamente do Asana para que os dashboards de PMO no Flowtly se mantenham atualizados.

Enviar horas faturáveis do quadro de tarefas de uma agência para o Flowtly para gerar faturas automaticamente.

Campos do esquema

WorkTime-employee_working_hour.read

Campo	Tipo	Descrição
`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.

Visão geral da entidade

Férias e ausência

Gerir férias pagas, baixa médica e tipos de ausência personalizados com fluxos de trabalho de aprovação.

Endpoints

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

Listar férias e ausências

Obtém a coleção de recursos HolidayType.

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

Criar férias e ausência

Cria um recurso HolidayRequest.

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

Listar ativos

Obtém a coleção de recursos Holiday.

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

Obter férias e ausência por ID

Obter um único recurso pelo seu identificador.

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

Eliminar férias e ausência

Eliminar o recurso.

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

Atualizar férias e ausência

Atualizar campos do recurso utilizando JSON Merge Patch.

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

Listar férias e ausências

Obtém a coleção de recursos HolidayType.

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

Criar férias e ausência

Cria um recurso HolidayRequest.

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

Obter férias e ausência por ID

Obter um único recurso pelo seu identificador.

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

Eliminar férias e ausência

Eliminar o recurso.

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

Atualizar férias e ausência

Atualizar campos do recurso utilizando JSON Merge Patch.

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

Cria um recurso HolidayRequest.

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

Cria um recurso HolidayRequest.

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

Listar férias e ausências

Obtém a coleção de recursos HolidayType.

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

Obter férias e ausência por ID

Obter um único recurso pelo seu identificador.

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

Atualizar férias e ausência

Atualizar campos do recurso utilizando JSON Merge Patch.

Casos de uso

Sincronizar ausências aprovadas do seu portal de RH para que o planeamento de capacidade do Flowtly se mantenha preciso.

Enviar saldos de ausências para o seu sistema de processamento salarial para dedução automática.

Campos do esquema

HolidayRequest-holiday_request.read_employee.preview

Campo	Tipo	Descrição
`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.

Visão geral da entidade

Subsídio de férias

Configurar orçamentos de ausências por colaborador, regras de transição e calendários de feriados.

Endpoints

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

Listar subsídios de férias

Obtém a coleção de recursos HolidayDaysLimitDefault.

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

Criar subsídio de férias

Cria um recurso HolidayDaysLimitDefault.

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

Obter subsídio de férias por ID

Obter um único recurso pelo seu identificador.

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

Eliminar subsídio de férias

Eliminar o recurso.

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

Atualizar subsídio de férias

Atualizar campos do recurso utilizando JSON Merge Patch.

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

Listar subsídios de férias

Obtém a coleção de recursos HolidayDaysLimitDefault.

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

Criar subsídio de férias

Cria um recurso HolidayDaysLimitDefault.

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

Obter subsídio de férias por ID

Obter um único recurso pelo seu identificador.

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

Eliminar subsídio de férias

Eliminar o recurso.

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

Atualizar subsídio de férias

Atualizar campos do recurso utilizando JSON Merge Patch.

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

Listar subsídios de férias

Obtém a coleção de recursos HolidayDaysLimitDefault.

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

Criar subsídio de férias

Cria um recurso HolidayDaysLimitDefault.

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

Obter subsídio de férias por ID

Obter um único recurso pelo seu identificador.

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

Eliminar subsídio de férias

Eliminar o recurso.

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

Atualizar subsídio de férias

Atualizar campos do recurso utilizando JSON Merge Patch.

Casos de uso

Importar direitos legais de férias do seu HRIS no início de cada ano fiscal.

Sincronizar calendários de feriados por país para cálculos precisos de dias restantes.

Campos do esquema

HolidayDaysLimit-holiday_days_limit.read

Campo	Tipo	Descrição
`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.

Visão geral da entidade

Horário

Definir horários repetitivos e atribuir colaboradores a turnos para acompanhamento de capacidade e presença.

Endpoints

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

Listar horários

Obtém a coleção de recursos ScheduleRange.

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

Criar horário

Cria um recurso ScheduleRange.

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

Obter horário por ID

Obter um único recurso pelo seu identificador.

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

Obter horário por ID

Obter um único recurso pelo seu identificador.

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

Atualizar horário

Atualizar campos do recurso utilizando JSON Merge Patch.

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

Listar horários

Obtém a coleção de recursos ScheduleRange.

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

Criar horário

Cria um recurso ScheduleRange.

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

Obter horário por ID

Obter um único recurso pelo seu identificador.

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

Eliminar horário

Eliminar o recurso.

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

Atualizar horário

Atualizar campos do recurso utilizando JSON Merge Patch.

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

Listar horários

Obtém a coleção de recursos ScheduleRange.

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

Criar horário

Cria um recurso ScheduleRange.

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

Obter horário por ID

Obter um único recurso pelo seu identificador.

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

Eliminar horário

Eliminar o recurso.

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

Atualizar horário

Atualizar campos do recurso utilizando JSON Merge Patch.

Casos de uso

Enviar escalas de turnos da sua ferramenta de agendamento para o Flowtly para validação do registo de horas.

Sincronizar alterações de horário para manter os cálculos de horas extraordinárias e o processamento salarial alinhados.

Campos do esquema

Schedule-schedule.read_schedule_range.read_employee.preview

Campo	Tipo	Descrição
`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.

Visão geral da entidade

Feriado

Manter calendários oficiais de feriados que alimentam os cálculos de ausências e contagens de dias úteis.

Endpoints

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

Listar feriados

Obtém a coleção de recursos BankHoliday.

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

Criar feriado

Cria um recurso BankHoliday.

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

Obter feriado por ID

Obter um único recurso pelo seu identificador.

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

Eliminar feriado

Eliminar o recurso.

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

Atualizar feriado

Atualizar campos do recurso utilizando JSON Merge Patch.

Casos de uso

Importar feriados públicos específicos de cada país para equipas multirregionais.

Excluir feriados dos cálculos de faturação automaticamente.

Campos do esquema

BankHoliday-bank_holiday.read

Campo	Tipo	Descrição
`id`	integer	Campo id.
`date`	string	Campo date.
`publicNotes`	string \| null	Campo publicNotes.
`yearFrom`	integer \| null	Campo yearFrom.
`yearTo`	integer \| null	Campo yearTo.