> 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/goedkeuren-afkeuren.md).

# Goedkeuren / Afkeuren

Een ingediende timesheet goedkeuren of afkeuren, en wat er daarna gebeurt.

Een ingediende timesheet wacht op een oordeel. Met goedkeuren gaat de timesheet door naar de facturatie. Met afkeuren gaat hij terug naar de professional, die hem kan aanpassen en opnieuw indienen.

* **Vereist recht:** Contracten kunnen bewerken. Ook de urenverantwoordelijken van het contract mogen dit

Beoordelen kan alleen bij een timesheet met `status` `2` (ingediend).

## Goedkeuren

* **Aanroep:** `PUT /timesheets/{id}/approve`
* **Verplicht:** `id` in de URL, het `_id` van de timesheet
* **Optioneel:** `overwritePaymentTerm`

| Veld                   | Soort  | Toelichting                                                                                                                                                                            |
| ---------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `overwritePaymentTerm` | ja/nee | Alleen van belang bij een timesheet die na het factureren is heropend. Met `true` krijgen de nieuwe facturen de betaaltermijn van de eerdere, gecrediteerde factuur. Standaard `false` |

```bash
curl -X PUT "https://mijn.cootje.com/api/timesheets/1f2e3d4c-5b6a-4798-8a9b-0c1d2e3f4a5b/approve" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "overwritePaymentTerm": false
  }'
```

### Wat je terugkrijgt

Niets: bij een geslaagde goedkeuring heeft het antwoord geen inhoud.

### Wat er daarna gebeurt

* Keurt een urenverantwoordelijke van het contract goed, dan telt dat als zijn eigen goedkeuring. Zijn er meer urenverantwoordelijken, dan is de timesheet pas goedgekeurd als aan de afspraak op het contract is voldaan (veld `mode` op het contract: `1` één van hen volstaat, `2` allemaal, in willekeurige volgorde, `3` allemaal, na elkaar).
* Keurt iemand goed die geen urenverantwoordelijke van het contract is, zoals een API-account met het recht Contracten kunnen bewerken, dan is de timesheet meteen goedgekeurd.
* De professional krijgt een e-mail en de timesheet gaat mee in de eerstvolgende nachtelijke facturatie. Daarna is de `status` `5` (verwerkt).

## Afkeuren

* **Aanroep:** `PUT /timesheets/{id}/reject`
* **Verplicht:** `id` in de URL, en de reden als inhoud van het verzoek: een tekst tussen aanhalingstekens
* **Optioneel:** niets

```bash
curl -X PUT "https://mijn.cootje.com/api/timesheets/1f2e3d4c-5b6a-4798-8a9b-0c1d2e3f4a5b/reject" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '"De uren van vrijdag ontbreken."'
```

### Wat je terugkrijgt

Niets: bij een geslaagde afkeuring heeft het antwoord geen inhoud.

### Wat er daarna gebeurt

* De `status` wordt `4` (afgekeurd).
* De professional krijgt een e-mail met de reden.
* De timesheet is weer aan te passen en kan opnieuw worden ingediend.

## De stand van de goedkeuring bekijken

De stand staat op de timesheet zelf, in `approvals`. Je ziet hem als je de timesheet ophaalt met `GET /timesheets/{id}`. Voor een ingediende timesheet die nog op goedkeuring wacht, ziet dat veld er zo uit:

```json
[
  {
    "approverId": "3d4e5f6a-7b8c-4d9e-8f0a-2b3c4d5e6f7a",
    "approverName": "Tom Visser",
    "updatedAt": 1804089900000,
    "rejectedReason": "",
    "state": 1,
    "overwritePaymentTerm": false
  }
]
```

* `state` is `1` in afwachting, `2` goedgekeurd of `3` afgekeurd.
* `rejectedReason` bevat de reden als de timesheet is afgekeurd.

## Als het niet lukt

Bij een fout is het antwoord een lijst met de reden:

```json
[
  {
    "propertyName": "Status",
    "errorMessage": "Status moet gesloten zijn om goed te keuren"
  }
]
```

Elke fout bevat daarnaast enkele technische velden, zoals `attemptedValue` en `errorCode`.

## Antwoorden

| Code  | Betekenis                                                                         |
| ----- | --------------------------------------------------------------------------------- |
| `204` | De timesheet is goedgekeurd of afgekeurd. Het antwoord heeft geen inhoud          |
| `400` | De timesheet is niet ingediend, of het account mag deze timesheet niet beoordelen |
| `401` | Geen geldig token                                                                 |
| `404` | De timesheet bestaat niet                                                         |
