> 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/ai-analyses/vacature-zzp-validatie.md).

# Vacature ZZP Validatie

AI laten beoordelen of een opdracht door een zzp'er mag worden uitgevoerd, en de vacaturetekst laten verbeteren.

Met de zzp-validatie laat je AI beoordelen of een opdracht door een zelfstandige (zzp'er) mag worden uitgevoerd. Je kunt de tekst van de vacature daarna door AI laten herschrijven, zodat de opdracht beter bij zelfstandig werk past.

| Wat                    | Aanroep                                     | Vereist recht         |
| ---------------------- | ------------------------------------------- | --------------------- |
| Vacature beoordelen    | `POST /recruiter/vacancies/validate-zzp`    | Alle vacatures inzien |
| Tekst laten verbeteren | `POST /recruiter/vacancies/improve-for-zzp` | Alle vacatures inzien |

Beide aanroepen slaan niets op. De vacature hoeft ook nog niet in Cootje te staan: je stuurt de gegevens mee in het verzoek.

## Vacature beoordelen

* **Aanroep:** `POST /recruiter/vacancies/validate-zzp`
* **Vereist recht:** Alle vacatures inzien

De beoordeling kijkt naar zes punten: de gezagsverhouding, de zelfstandigheid en vrijheid, het ondernemersrisico, het gebruik van eigen materialen en middelen, de duur van de opdracht en het tarief.

### Verplichte velden

Geen. De API controleert de invoer niet. Hoe meer je meestuurt, hoe beter de beoordeling; stuur in elk geval de titel en de omschrijving mee.

### Optionele velden

| Veld                             | Soort  | Toelichting                                                                                          |
| -------------------------------- | ------ | ---------------------------------------------------------------------------------------------------- |
| `title`                          | tekst  | De titel van de vacature                                                                             |
| `description`                    | tekst  | De omschrijving van de opdracht                                                                      |
| `expectedOutcome`                | tekst  | Het beoogde resultaat                                                                                |
| `assignmentRequirements`         | tekst  | De eisen aan de kandidaat                                                                            |
| `preferredRequirements`          | tekst  | De wensen, naast de eisen                                                                            |
| `competencies`                   | tekst  | De gevraagde competenties                                                                            |
| `assignmentRequirementsKnockOut` | ja/nee | `true` als de eisen een harde voorwaarde zijn                                                        |
| `startDate`, `endDate`           | datum  | Start- en einddatum van de opdracht, in de vorm `2027-03-01T00:00:00`. Hiermee beoordeelt AI de duur |
| `hourPrice`                      | getal  | Het uurtarief. Hiermee beoordeelt AI of het tarief past bij een zelfstandige                         |

Dit zijn dezelfde velden als van een vacature. Je kunt dus ook een vacature die je hebt opgehaald in zijn geheel meesturen; de overige velden worden niet gebruikt.

### Voorbeeld

```bash
curl -X POST "https://mijn.cootje.com/api/recruiter/vacancies/validate-zzp" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Projectleider zorg",
    "description": "Leiding geven aan de invoering van een nieuw roostersysteem.",
    "expectedOutcome": "Het nieuwe roostersysteem is op alle afdelingen in gebruik.",
    "assignmentRequirements": "Minimaal 5 jaar ervaring als projectleider in de zorg.",
    "startDate": "2027-03-01T00:00:00",
    "endDate": "2027-08-31T00:00:00",
    "hourPrice": 85
  }'
```

### Wat je terugkrijgt

```json
{
  "analysis": "De opdracht is afgebakend en heeft een duidelijk eindresultaat: de invoering van een nieuw roostersysteem. De opdrachtnemer bepaalt zelf hoe hij het werk inricht en er is geen sprake van leiding en toezicht zoals bij een werknemer. De looptijd van zes maanden past bij een project. Het tarief van 85 euro per uur is passend voor een zelfstandige.",
  "conclusion": "De opdracht kan door een zzp'er worden uitgevoerd.",
  "state": 1
}
```

* `analysis` is de beoordeling per punt, in het Nederlands.
* `conclusion` is de samenvatting.
* `state` is de uitkomst: `1` de opdracht kan door een zzp'er worden uitgevoerd, `2` onzeker, `3` de opdracht kan niet door een zzp'er worden uitgevoerd.

## Tekst laten verbeteren

* **Aanroep:** `POST /recruiter/vacancies/improve-for-zzp`
* **Vereist recht:** Alle vacatures inzien

AI herschrijft de tekst van de vacature, zodat de opdracht beter past bij zelfstandig werk. De verbeteringen staan in de tekst zelf verwerkt; je krijgt geen lijst met tips.

### Verplichte velden

Geen. De API controleert de invoer niet. Stuur in elk geval de omschrijving mee.

### Optionele velden

| Veld                             | Soort  | Toelichting                                   |
| -------------------------------- | ------ | --------------------------------------------- |
| `title`                          | tekst  | De titel van de vacature                      |
| `description`                    | tekst  | De omschrijving van de opdracht               |
| `expectedOutcome`                | tekst  | Het beoogde resultaat                         |
| `assignmentRequirements`         | tekst  | De eisen aan de kandidaat                     |
| `preferredRequirements`          | tekst  | De wensen, naast de eisen                     |
| `competencies`                   | tekst  | De gevraagde competenties                     |
| `assignmentRequirementsKnockOut` | ja/nee | `true` als de eisen een harde voorwaarde zijn |

### Voorbeeld

```bash
curl -X POST "https://mijn.cootje.com/api/recruiter/vacancies/improve-for-zzp" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Projectleider zorg",
    "description": "Leiding geven aan de invoering van een nieuw roostersysteem.",
    "expectedOutcome": "Het nieuwe roostersysteem is op alle afdelingen in gebruik.",
    "assignmentRequirements": "Minimaal 5 jaar ervaring als projectleider in de zorg."
  }'
```

### Wat je terugkrijgt

De nieuwe tekst, als platte tekst en zonder de titel van de vacature:

```
De opdrachtnemer is verantwoordelijk voor de invoering van een nieuw roostersysteem en levert als resultaat op dat het systeem op alle afdelingen in gebruik is. De opdrachtnemer bepaalt zelf de aanpak, de planning en de werktijden, en stemt alleen de mijlpalen af met de opdrachtgever.
```

Wil je de tekst bewaren, zet hem dan in het veld `description` van de vacature en sla de vacature op.

## Antwoorden

| Code  | Betekenis                                        |
| ----- | ------------------------------------------------ |
| `200` | De beoordeling, of de nieuwe tekst               |
| `401` | Geen geldig token, of het account mist het recht |
