Control horario – plataforma para desarrolladores de Flowtly

Usa esta instantánea curada del esquema OpenAPI de Flowtly para planear integraciones, automatizar procesos y sincronizar los datos críticos.

Estado de la documentación

Última sincronización: 2024-07-08 12:00 (versión de la app 2.0.0)

Solo exponemos un conjunto limitado de entidades. Ejecuta ambos comandos de sincronización cuando Flowtly lance novedades para actualizar los datos.

Control horario

Sincroniza horas desde tus herramientas de proyectos hacia Flowtly.

Resumen de la entidad

Horas trabajadas

Los registros WorkTime alimentan paneles de utilización, nómina y facturación sin reintroducir datos.

Endpoints

GET /api/employee_working_hours

Listar registros de tiempo

Lee colecciones employee_working_hours filtradas por empleado, proyecto o rango temporal.

POST /api/employee_working_hours

Crear registro de tiempo

Envía un nuevo registro con segundos, descripción y referencias de empleado/proyecto.

GET /api/employee_working_hours/{id}

Obtener registro de tiempo por ID

Consulta un registro de tiempo específico.

PATCH /api/employee_working_hours/{id}

Actualizar registro de tiempo

Corrige segundos, proyecto o notas de un registro.

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.

Casos de uso

Importa horas aprobadas desde Asana para mantener al día los tableros del PMO en Flowtly.
Envía horas facturables desde el tablero de una agencia para que Flowtly genere facturas automáticamente.

Campos del esquema

WorkTime
Campo Tipo Descripción
id integer Identificador del registro de tiempo.
employee string IRI del empleado que registró las horas.
project string IRI del proyecto al que se imputa el tiempo.
date string Fecha/hora en la que se realizó el trabajo.
seconds integer Duración en segundos.
description string | null Nota opcional del usuario.
createdAt string Momento en que se creó el registro.
updatedAt string Última modificación.
deletedAt string | null Fecha de eliminación lógica, si existe.
deleted boolean Check if the entity has been soft deleted.

Ejemplos

POST /api/employee_working_hours

Enviar un registro facturable desde Asana

Envía un registro de 7,5 horas (27 000 segundos) desde el gestor de proyectos para que Flowtly actualice la utilización y la facturación.

Carga del request 
{
    "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"
}
Carga de la respuesta 
{
    "@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