API-endpoint reporting/hours-registration: geplande en gewerkte uren

Het endpoint reporting/hours-registration geeft het rapport Ingeroosterde uren (incl. urenregistratie): de geplande versus de gewerkte uren en kosten per medewerker, blok en dag, voor een gegeven periode.

Request

Methode	`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 de veldbeschrijving), `order` (optioneel, `asc` of `desc`, standaard `asc`)

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

Voorbeeld van een antwoord

{
    "[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 van de vestiging (het bedrijf)
`departmentName`	Naam van de afdeling
`shiftName`	Naam van de dienst (het 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 de urenregistratie (of de geplande tijd als er geen registratie is)
`actualEnd`	Werkelijke eindtijd volgens de urenregistratie (of de geplande tijd als er geen registratie 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 de medewerker ingediend) of verwerkt (uren zijn verwerkt of afgesloten)

Lees in Roosterplaats API hoe u de API inschakelt en hoe de antwoorden zijn opgebouwd.

Laatst bijgewerkt: 18-10-2026

API-endpoint reporting/hours-registration: geplande en gewerkte uren

Request

Voorbeeld van een antwoord

Veldbeschrijving

Meer artikelen in Endpoint-specificaties