> 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/recruitment/kandidaten/bijwerken.md).

# Bijwerken

Een bestaande kandidaat wijzigen. De aanroep vervangt de hele kandidaat.

Hiermee wijzig je een bestaande kandidaat. De aanroep vervangt de hele kandidaat door wat je meestuurt.

* **Aanroep:** `PUT /recruiter/candidates/{id}`
* **Vereist recht:** Alle kandidaten bewerken

{% hint style="warning" %}
Velden die je weglaat, worden leeggemaakt. Dat geldt ook voor vaardigheden, werkervaring, de notitie en de recruiter. Haal de kandidaat daarom eerst op, pas aan wat je wilt wijzigen en stuur het geheel terug.
{% endhint %}

## Verplichte velden

| Veld   | Soort | Toelichting                                                                                                                                           |
| ------ | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| `_id`  | tekst | Het kenmerk van de kandidaat, in de inhoud van het verzoek. Cootje gebruikt dit veld om de kandidaat te vinden; het kenmerk in de URL wordt genegeerd |
| `name` | tekst | De naam van de kandidaat                                                                                                                              |

## Verplicht in bepaalde gevallen

| Situatie                                                               | Dan verplicht                                                            |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| De kandidaat wordt aangeboden via een leverancier (`offerForm` is `2`) | `supplier` met daarin `companyName`, `contactName` en een geldig `email` |
| Je stuurt werkervaring mee (`experiences`)                             | Per regel `title` en `company`                                           |
| Je stuurt opleidingen mee (`educations`)                               | Per regel `title`                                                        |
| Je vult `zipCode` in                                                   | Een Nederlandse postcode, zoals `1234 AB`                                |

## Optionele velden

Stuur deze velden mee met hun huidige waarde als je ze wilt behouden.

| Veld                                        | Soort           | Toelichting                                                                                                                                                                     |
| ------------------------------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `email`                                     | tekst           | E-mailadres                                                                                                                                                                     |
| `phone`                                     | tekst           | Telefoonnummer                                                                                                                                                                  |
| `title`                                     | tekst           | Functietitel van de kandidaat                                                                                                                                                   |
| `address`, `houseNumber`, `zipCode`, `city` | tekst           | Adres: straat, huisnummer, postcode en plaats                                                                                                                                   |
| `linkedIn`                                  | tekst           | Adres van het LinkedIn-profiel                                                                                                                                                  |
| `gender`                                    | getal           | `1` man, `2` vrouw                                                                                                                                                              |
| `skills`                                    | lijst met tekst | Vaardigheden. Standaard een lege lijst                                                                                                                                          |
| `experiences`                               | lijst           | Werkervaring. Per regel `title`, `company` en optioneel `startDate`, `endDate`, `location` en `description`                                                                     |
| `educations`                                | lijst           | Opleidingen. Per regel `title` en optioneel `institution`, `kind` en `graduationDate`                                                                                           |
| `isAvailable`                               | ja/nee          | Of de kandidaat beschikbaar is. Standaard `true`                                                                                                                                |
| `expectedAvailabilityDate`                  | getal           | Wanneer de kandidaat beschikbaar komt, in milliseconden sinds 1970                                                                                                              |
| `hoursPerWeek`                              | geheel getal    | Gewenst aantal uren per week                                                                                                                                                    |
| `priceLow`, `priceHigh`                     | getal           | Onder- en bovengrens van het uurtarief                                                                                                                                          |
| `contractForms`                             | lijst           | Gewenste contractvormen: `1` zzp, `3` loondienst, `4` tijdelijke arbeidsovereenkomst                                                                                            |
| `offerForm`                                 | getal           | `1` de kandidaat biedt zichzelf aan (standaard), `2` aangeboden via een leverancier                                                                                             |
| `supplier`                                  | object          | Gegevens van de leverancier: `companyName`, `contactName`, `email` en optioneel `phone`                                                                                         |
| `kvkNumber`, `kvkCompanyName`               | tekst           | KvK-nummer en naam van het eigen bedrijf van een zzp'er                                                                                                                         |
| `companyId`                                 | tekst           | Het `_id` van het bedrijf waar de kandidaat bij hoort, bijvoorbeeld de leverancier. Zie [Bedrijf registreren](https://docs.cootje.com/cootje-api/inhuur/bedrijf-registreren.md) |
| `recruiterId`                               | tekst           | Het `_id` van de recruiter, uit `GET /recruiter/recruiters`                                                                                                                     |
| `plannedHolidays`                           | tekst           | Geplande vakanties                                                                                                                                                              |
| `memo`                                      | tekst           | Interne notitie                                                                                                                                                                 |
| `notificationsEnabled`                      | ja/nee          | Of er meldingen over deze kandidaat worden verstuurd. Standaard `true`                                                                                                          |

## Wat Cootje zelf doet

* `company` wordt opnieuw gevuld met de naam van het bedrijf. Wat je in dit veld meestuurt, wordt genegeerd.
* Zet je `isAvailable` van `false` op `true`, dan wordt `expectedAvailabilityDate` leeggemaakt.

## Voorbeeld

In dit voorbeeld krijgt de kandidaat een extra vaardigheid. De rest van de kandidaat gaat ongewijzigd mee.

```bash
curl -X PUT "https://mijn.cootje.com/api/recruiter/candidates/9e8d7c6b-5a4f-4e3d-a2c1-0a9f8e7d6c5b" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "_id": "9e8d7c6b-5a4f-4e3d-a2c1-0a9f8e7d6c5b",
    "name": "Sanne de Vries",
    "companyId": "",
    "company": "",
    "email": "sanne@voorbeeld.nl",
    "zipCode": "3511 AB",
    "title": "Projectleider",
    "houseNumber": "12",
    "city": "Utrecht",
    "address": "Voorbeeldstraat",
    "phone": "0612345678",
    "linkedIn": "https://www.linkedin.com/in/sannedevries",
    "isAvailable": true,
    "expectedAvailabilityDate": null,
    "hoursPerWeek": 32,
    "plannedHolidays": "",
    "memo": "",
    "recruiterId": "",
    "priceLow": 80,
    "priceHigh": 95,
    "gender": 2,
    "skills": [
      "projectmanagement",
      "zorg",
      "verandermanagement"
    ],
    "offerForm": 1,
    "supplier": null,
    "contractForms": [
      1
    ],
    "kvkNumber": "",
    "kvkCompanyName": "",
    "experiences": [
      {
        "title": "Projectleider",
        "company": "Voorbeeld Zorg B.V.",
        "companyId": "",
        "startDate": "2022-01-01",
        "endDate": null,
        "location": "Utrecht",
        "description": "Invoering van een nieuw roostersysteem."
      }
    ],
    "educations": [
      {
        "title": "Bedrijfskunde",
        "institution": "Hogeschool Utrecht",
        "kind": "hbo",
        "graduationDate": "2015-07-01"
      }
    ],
    "notificationsEnabled": true
  }'
```

Wil je alleen de recruiter wijzigen, gebruik dan `POST /recruiter/recruiters/assignments/candidates`. Die aanroep laat de rest van de kandidaat ongemoeid.

## Wat je terugkrijgt

Niets: bij een geslaagde wijziging heeft het antwoord geen inhoud. Klopt de invoer niet, dan is het antwoord een lijst met fouten:

```json
[
  {
    "propertyName": "Name",
    "errorMessage": "Naam is verplicht."
  }
]
```

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

## Antwoorden

| Code  | Betekenis                                                  |
| ----- | ---------------------------------------------------------- |
| `204` | De kandidaat is bijgewerkt. Het antwoord heeft geen inhoud |
| `400` | De invoer klopt niet. Het antwoord is de lijst met fouten  |
| `401` | Geen geldig token, of het account mist het recht           |
