Vue d’ensemble
Temps de travail
Les entrées WorkTime alimentent l’utilisation, la paie et la facturation sans ressaisie des heures.
Endpoints
/api/employee_working_hours
Lister les temps de travail
Consulte les collections employee_working_hours filtrées par collaborateur, projet ou période.
/api/employee_working_hours
Créer un temps de travail
Enregistre une entrée WorkTime avec secondes, description et références employé/projet.
/api/employee_working_hours/{id}
Obtenir un temps de travail par ID
Consulte une entrée WorkTime précise.
/api/employee_working_hours/{id}
Mettre à jour un temps de travail
Corrige les secondes, le projet ou les notes d’une entrée.
/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.
Cas d’usage
Champs du schéma
WorkTime| Champ | Type | Description |
|---|---|---|
id |
integer | Identifiant de l’entrée de temps. |
employee |
string | IRI de l’employé qui a saisi les heures. |
project |
string | Projet auquel l’entrée est rattachée. |
date |
string | Date/heure d’exécution du travail. |
seconds |
integer | Durée en secondes. |
description |
string | null | Commentaire optionnel. |
createdAt |
string | Date de création dans Flowtly. |
updatedAt |
string | Dernière mise à jour. |
deletedAt |
string | null | Horodatage de suppression logique, le cas échéant. |
deleted |
boolean | Check if the entity has been soft deleted. |
Exemples
/api/employee_working_hours
Envoyer un log facturable depuis Asana
Envoie une saisie de 7,5 heures (27 000 secondes) depuis l’outil projet pour que Flowtly mette à jour l’utilisation et la facturation.
{
"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
}