Zeiterfassung – Flowtly Developer-Plattform

Nutze diesen kuratierten Ausschnitt des Flowtly-OpenAPI-Schemas, um Integrationen zu planen, Workflows zu automatisieren und kritische Daten zu synchronisieren.

Dokumentationsstatus

Zuletzt synchronisiert am 2024-07-08 12:00 (App-Version 2.0.0)

Nur ein Teil der Entitäten ist öffentlich. Führe beide Sync-Befehle aus, sobald Flowtly neue Funktionen veröffentlicht, um die Daten zu aktualisieren.

Zeiterfassung

Synchronisiere Arbeitszeiten aus PM-Tools nach Flowtly.

Entitätsüberblick

Arbeitszeit

WorkTime-Einträge speisen Auslastung, Payroll und Rechnungen, ohne dass Teams Stunden doppelt erfassen müssen.

Endpoints

GET /api/employee_working_hours

Arbeitszeiten auflisten

Liest employee_working_hours mit Filtern für Mitarbeitende, Projekte oder Zeitraum.

POST /api/employee_working_hours

Arbeitszeit anlegen

Überträgt einen neuen WorkTime-Eintrag mit Sekunden, Beschreibung sowie Mitarbeiter-/Projekt-Referenzen.

GET /api/employee_working_hours/{id}

Arbeitszeiteintrag per ID abrufen

Einen einzelnen erfassten WorkTime-Eintrag einsehen.

PATCH /api/employee_working_hours/{id}

Arbeitszeiteintrag aktualisieren

Erfasste Sekunden, Projekt oder Notizen korrigieren.

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.

Anwendungsfälle

Importiere genehmigte Stunden aus Asana, damit PMO-Dashboards in Flowtly aktuell bleiben.
Sende fakturierbare Stunden von einer Agentur-Task-List an Flowtly, um automatisch Rechnungen zu erzeugen.

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

POST /api/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.

Request-Payload 
{
    "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"
}
Response-Payload 
{
    "@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