> For the complete documentation index, see [llms.txt](https://docs.cootje.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cootje.com/cootje-api/timesheets.md).

# Timesheets

Timesheets via de API: ophalen, uren registreren, urenstaten bijvoegen, verlof en onkosten vastleggen, goedkeuren en afkeuren.

Een timesheet is de urenregistratie van één periode van een contract: een week, vier weken of een maand. Op een timesheet staan de uren, het verlof, de kilometers en de onkosten van de professional, met de urenstaat als bijlage. Na goedkeuring wordt de timesheet gefactureerd.

## In dit onderdeel

| Pagina                                                                                        | Wat je er doet                                                       | Aanroep                              |
| --------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | ------------------------------------ |
| [Timesheets ophalen](https://docs.cootje.com/cootje-api/timesheets/timesheets-ophalen.md)     | De timesheets van een contract of één timesheet ophalen, of zoeken   | `GET /timesheets/list/{contractIds}` |
| [Goedkeuren / Afkeuren](https://docs.cootje.com/cootje-api/timesheets/goedkeuren-afkeuren.md) | Een ingediende timesheet beoordelen                                  | `PUT /timesheets/{id}/approve`       |
| [Uren registreren](https://docs.cootje.com/cootje-api/timesheets/uren-registreren.md)         | De juiste tarieven ophalen, uren vastleggen en de timesheet indienen | `PUT /timesheets/{id}/hours`         |
| [Urenstaten bijvoegen](https://docs.cootje.com/cootje-api/timesheets/urenstaten-bijvoegen.md) | Een urenstaat als bestand bij de timesheet voegen                    | `POST /timesheets/{id}/attachments`  |
| [Verlof & Onkosten](https://docs.cootje.com/cootje-api/timesheets/verlof-en-onkosten.md)      | Verlof, kilometers en onkosten met een bon vastleggen                | `POST /timesheets/{id}/declarations` |

## Hoe een timesheet verloopt

| `status` | Betekenis   | Wat kan er                                                   |
| -------- | ----------- | ------------------------------------------------------------ |
| `1`      | Open        | Uren, verlof, onkosten en urenstaten vastleggen, en indienen |
| `2`      | Ingediend   | Goedkeuren of afkeuren                                       |
| `3`      | Goedgekeurd | Wacht op de nachtelijke facturatie                           |
| `4`      | Afgekeurd   | Aanpassen en opnieuw indienen                                |
| `5`      | Verwerkt    | De timesheet is gefactureerd                                 |

Cootje maakt de timesheets zelf aan. Zodra een contract definitief is, staat er voor elke periode van het contract een timesheet klaar.

## Wie mag wat

| Handeling                                                    | Wie                                                                                                                                  |
| ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |
| Timesheets bekijken                                          | Een account met het recht Geregistreerde uren inzien, en de professional van het contract                                            |
| Uren, verlof, onkosten en urenstaten vastleggen, en indienen | Een account met het recht Contracten kunnen bewerken, de professional van het contract en de urenverantwoordelijken van het contract |
| Goedkeuren en afkeuren                                       | Een account met het recht Contracten kunnen bewerken, en de urenverantwoordelijken                                                   |

## Goed om te weten

* Tijdstippen zijn getallen: milliseconden sinds 1970. Een dag geef je op als het tijdstip om 00:00 uur UTC.
* Opslaan is nog niet indienen. Na het vastleggen van de uren dien je de timesheet apart in.
* Een urenstaat is het document dat de uren onderbouwt. Of hij verplicht is, staat op het contract.
