Tidrapportering – bygg på Flowtly

Använd denna kuraterade snapshot av Flowtlys OpenAPI för att planera integrationer, automatisera flöden och synka data teamen behöver.

Dokumentationsstatus

Senast synkad 2025-12-11 09:43 (app‑version 2.0.0)

Endast ett urval av entiteter är publikt. Kör båda sync‑kommandon när Flowtly släpper nytt.

Tidrapportering

Synka arbetspass från projektverktyg till Flowtly.

Entitetsöversikt

Arbetstid

Använd WorkTime‑poster för nyttjande, lön och fakturering utan att team behöver dubbelregistrera.

API‑slutpunkter

GET /api/employee_working_hours

Lista tidloggar

Läs employee_working_hours‑samlingar filtrerade på anställd, projekt eller tidsintervall.

POST /api/employee_working_hours

Skapa tidlogg

Skicka in en ny arbetstidspost med sekunder, beskrivning och referenser till anställda/projekt.

GET /api/employee_working_hours/{id}

Hämta tidlogg via ID

Inspektera en enskild registrerad tidpost.

PATCH /api/employee_working_hours/{id}

Uppdatera tidlogg

Patcha loggade sekunder, projekt eller anteckningar vid korrigeringar.

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.

Användningsfall

Importera retroaktivt godkända timmar från Asana så PMO‑paneler i Flowtly är aktuella.
Skicka fakturerbara timmar från en byrås tavla till Flowtly för automatiska fakturor.

Schemafält

WorkTime
Fält Typ Beskrivning
id integer Internt ID för tidloggen.
employee string IRI för den anställda som rapporterade tiden.
project string Projekt‑IRI som tar emot arbetet.
date string Tidsstämpel för när arbetet skedde.
seconds integer Varaktighet i sekunder.
description string | null Valfri anteckning som beskriver aktiviteten.
createdAt string När posten skapades i Flowtly.
updatedAt string När posten senast ändrades.
deletedAt string | null Tidsstämpel för ev. mjuk radering.
deleted boolean Check if the entity has been soft deleted.

Exempel

POST /api/employee_working_hours

Tryck in en fakturerbar tidlogg från Asana

Skickar en 7,5‑timmars (27 000 sekunder) logg från ditt PM‑verktyg så Flowtly kan uppdatera nyttjande‑ och fakturamått.

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