Endpoint: reporting/hours-registration

Omschrijving

Endpoint geeft het rapport "Ingeroosterde uren (incl. urenregistratie)": geplande versus gewerkte uren en kosten per medewerker, blok en dag, voor een gegeven periode.

Request

Method: GET

URL: reporting/hours-registration/{startDate}/{endDate}/

Parameters: token, contractPermanent (optioneel, 0 of 1, standaard 1), contractFlex (optioneel, 0 of 1, standaard 1), sort (optioneel, veldnaam om op te sorteren, zie Veldbeschrijving), order (optioneel, asc of desc, standaard asc)

Example request: /api/v1/reporting/hours-registration/{startDate}/{endDate}/?token=xxxxxxxx-xxx-xxxx-xxxx-xxxxxxxxxxxx

Response voorbeeld

{
    "[request]": {
        "path": "/api/v1/reporting/hours-registration/2026-11-02/2026-11-08/",
        "arguments": {
            "startDate": "2026-11-02",
            "endDate": "2026-11-08"
        },
        "date": "2026-09-05 10:10:35",
        "status": "success"
    },
    "[hoursRegistration]": [
        {
            "firstName": "Willem",
            "lastName": "Willink",
            "externalReference": "123456",
            "contractType": "vast",
            "locationName": "Vestiging Haarlem",
            "departmentName": "Service desk",
            "shiftName": "Middagdienst",
            "date": "2026-11-06",
            "scheduledStart": "15:00",
            "scheduledEnd": "17:00",
            "scheduledHours": 2,
            "scheduledCosts": 46,
            "actualStart": "15:00",
            "actualEnd": "17:00",
            "actualHours": 2,
            "actualCosts": 46,
            "differenceHours": 0,
            "travelTime": "0",
            "travelDistance": "0",
            "travelExpenses": "0.00",
            "generalExpenses": "0.00",
            "notes": "",
            "status": "verwerkt"
        }
    ]
}

Veldbeschrijving

Veld	Beschrijving
firstName	Voornaam medewerker
lastName	Achternaam medewerker
externalReference	Externe referentie / medewerkernummer
contractType	Contractsoort: vast of flex
locationName	Naam vestiging (bedrijf)
departmentName	Naam afdeling
shiftName	Naam dienst/blok
date	Datum van de dienst (jjjj-mm-dd)
scheduledStart	Geplande starttijd
scheduledEnd	Geplande eindtijd
scheduledHours	Aantal geplande uren
scheduledCosts	Geplande loonkosten
actualStart	Werkelijke starttijd volgens urenregistratie (of geplande tijd indien geen registratie aanwezig is)
actualEnd	Werkelijke eindtijd volgens urenregistratie (of geplande tijd indien geen registratie aanwezig is)
actualHours	Aantal gewerkte uren
actualCosts	Werkelijke loonkosten
differenceHours	Verschil tussen gewerkte en geplande uren
travelTime	Geregistreerde reistijd
travelDistance	Geregistreerde reisafstand
travelExpenses	Geregistreerde OV kosten
generalExpenses	Geregistreerde onkosten
notes	Notitie bij de urenregistratie
status	Status van de urenregistratie: open (nog niet ingediend), ingediend (door medewerker ingediend) of verwerkt (uren zijn verwerkt/afgesloten)