Entitätsüberblick
Arbeitszeit
WorkTime-Einträge speisen Auslastung, Payroll und Rechnungen, ohne dass Teams Stunden doppelt erfassen müssen.
Endpoints
https://api.flowtly.eu/employee_working_hours
Arbeitszeiten auflisten
Liest employee_working_hours mit Filtern für Mitarbeitende, Projekte oder Zeitraum.
https://api.flowtly.eu/employee_working_hours
Arbeitszeit anlegen
Überträgt einen neuen WorkTime-Eintrag mit Sekunden, Beschreibung sowie Mitarbeiter-/Projekt-Referenzen.
https://api.flowtly.eu/employee_working_hours/{id}
Arbeitszeiteintrag per ID abrufen
Einen einzelnen erfassten WorkTime-Eintrag einsehen.
https://api.flowtly.eu/employee_working_hours/{id}
Arbeitszeiteintrag aktualisieren
Erfasste Sekunden, Projekt oder Notizen korrigieren.
https://api.flowtly.eu/employee-working-hours
List employee-working-hours
Retrieve employee-working-hours with pagination and filters.
https://api.flowtly.eu/employee-working-hours
Create employee-working-hour
Create a new employee-working-hour entry.
https://api.flowtly.eu/employee-working-hours/{id}
Get employee-working-hour
Fetch a single employee-working-hour by ID.
https://api.flowtly.eu/employee-working-hours/{id}
Update employee-working-hour
Patch fields of an employee-working-hour entry.
https://api.flowtly.eu/employee-working-hours/{id}
Delete employee-working-hour
Remove an employee-working-hour entry.
https://api.flowtly.eu/work-times
List work-times
Retrieve work-time entries.
https://api.flowtly.eu/work-times
Create work-time
Create a work-time record.
https://api.flowtly.eu/work-times/{id}
Get work-time
Fetch a single work-time by ID.
https://api.flowtly.eu/work-times/{id}
Update work-time
Patch a work-time record.
https://api.flowtly.eu/work-times/{id}
Delete work-time
Delete a work-time record.
https://api.flowtly.eu/employees/{id}/working-hours-stats/{date}
Get working-hours stats
Retrieve aggregated working-hours stats for an employee at a date.
https://api.flowtly.eu/employees
Retrieves the collection of Employee resources.
Retrieves the collection of Employee resources.
https://api.flowtly.eu/employees
Creates a Employee resource.
Creates a Employee resource.
https://api.flowtly.eu/employees/me
Retrieves the collection of Employee resources.
Retrieves the collection of Employee resources.
https://api.flowtly.eu/employees/preview
Retrieves the collection of Employee resources.
Retrieves the collection of Employee resources.
https://api.flowtly.eu/employees/search
Retrieves the collection of Employee resources.
Retrieves the collection of Employee resources.
https://api.flowtly.eu/employees/{id}
Removes the Employee resource.
Removes the Employee resource.
https://api.flowtly.eu/employees/{id}
Retrieves a Employee resource.
Retrieves a Employee resource.
https://api.flowtly.eu/employees/{id}
Updates the Employee resource.
Updates the Employee resource.
https://api.flowtly.eu/employees/{id}/documents
Retrieves a Employee resource.
Retrieves a Employee resource.
https://api.flowtly.eu/employees/{id}/feedback-suggestion
Retrieves a Employee resource.
Retrieves a Employee resource.
https://api.flowtly.eu/employees/{id}/project-rates
Retrieves a Employee resource.
Retrieves a Employee resource.
https://api.flowtly.eu/employees/{id}/user
Removes the Employee resource.
Removes the Employee resource.
https://api.flowtly.eu/employees/{id}/user
Creates a Employee resource.
Creates a Employee resource.
Anwendungsfälle
Schemafelder
WorkTime| Feld | Typ | Beschreibung |
|---|---|---|
id |
integer | Identifier des Zeit-Eintrags. |
employee |
string | IRI des Mitarbeitenden, der die Zeit gemeldet hat. |
project |
string | Projekt-IRI, dem die Zeit zugeordnet ist. |
date |
string | Zeitpunkt der geleisteten Arbeit. |
seconds |
integer | Dauer in Sekunden. |
description |
string | null | Optionaler Kommentar. |
createdAt |
string | Zeitpunkt der Erstellung in Flowtly. |
updatedAt |
string | Letzte Änderung. |
deletedAt |
string | null | Zeitpunkt einer Soft-Deletion. |
deleted |
boolean | Check if the entity has been soft deleted. |
Beispiele
https://api.flowtly.eu/employee_working_hours
Billablen Arbeitslog aus Asana senden
Sendet einen 7,5-Stunden-Log (27.000 Sekunden) aus dem PM-Tool, damit Flowtly Auslastung und Rechnungen aktualisieren kann.
{
"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
}