> 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/zzp/professional-toevoegen.md).

# Professional toevoegen

De zzp'er vastleggen als eigenaar, tekenbevoegde en professional van zijn eigen bedrijf.

De zzp'er zelf leg je vast als persoon bij zijn eigen bedrijf. Hij is daar eigenaar, tekenbevoegde en professional tegelijk.

* **Vereist recht:** Personen kunnen bewerken

Bestaat de persoon nog niet in Cootje, gebruik dan de eerste aanroep. Staat de persoon er al in, bijvoorbeeld bij een ander bedrijf, gebruik dan de tweede.

## Nieuwe persoon toevoegen

* **Aanroep:** `POST /organizations/persons`

Je maakt de persoon aan en koppelt hem in dezelfde aanroep aan zijn eigen bedrijf.

### Verplichte velden

| Veld                   | Soort | Toelichting                                                                              |
| ---------------------- | ----- | ---------------------------------------------------------------------------------------- |
| `person.firstName`     | tekst | Voornaam                                                                                 |
| `person.lastName`      | tekst | Achternaam                                                                               |
| `person.initials`      | tekst | Voorletters                                                                              |
| `person.email`         | tekst | Een geldig e-mailadres dat nog niet bij een andere persoon in de omgeving voorkomt       |
| `membership.companyId` | tekst | Het `_id` van het bedrijf                                                                |
| `membership.roles`     | lijst | De rol van de persoon bij het bedrijf: `1` eigenaar, `2` tekenbevoegde, `3` professional |

### Verplicht in bepaalde gevallen

| Situatie                                                  | Dan verplicht                                           |
| --------------------------------------------------------- | ------------------------------------------------------- |
| Je vult een deel van het adres in (`person.address`)      | `street`, `houseNumber`, `zipcode` en `city`, alle vier |
| De nationaliteit is Nederlands en je vult `person.bsn` in | Een geldig burgerservicenummer                          |

### Optionele velden

| Veld                     | Soort             | Toelichting                                                                                                                                                       |
| ------------------------ | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `membership.permissions` | lijst             | De rechten van de persoon bij het bedrijf, als getallen. Laat je dit weg, dan heeft de persoon de rol maar geen rechten. Zie de tabel hieronder                   |
| `person.tussenvoegsel`   | tekst             | Tussenvoegsel, zoals "van der"                                                                                                                                    |
| `person.gender`          | getal             | `1` man, `2` vrouw                                                                                                                                                |
| `person.phoneNumber`     | tekst             | Telefoonnummer                                                                                                                                                    |
| `person.address`         | object            | Adres: `street`, `houseNumber`, `houseNumberAddition`, `zipcode`, `city` en `country`                                                                             |
| `person.dateOfBirth`     | tekst             | Geboortedatum                                                                                                                                                     |
| `person.nationality`     | tekst             | Nationaliteit                                                                                                                                                     |
| `person.bsn`             | tekst             | Burgerservicenummer                                                                                                                                               |
| `person.maritalStatus`   | tekst             | Burgerlijke staat                                                                                                                                                 |
| `person.function`        | tekst             | Functie                                                                                                                                                           |
| `person.isApiAccount`    | ja/nee            | `true` voor een account dat alleen voor een koppeling is bedoeld. Standaard `false`                                                                               |
| `bankAccount`            | object            | Bankrekening van de persoon: `iban` (een geldig IBAN) en `type` (`1` gewone rekening, `2` G-rekening). Beide velden zijn verplicht als je dit onderdeel meestuurt |
| `acceptAddressWarnings`  | ja/nee, in de URL | `true` om de persoon ook op te slaan als het adres niet bevestigd kan worden                                                                                      |

Zonder `country` in het adres wordt het land `NL`.

### Rechten bij deze rol

Cootje kent de rechten niet vanzelf toe. Stuur ze mee in `membership.permissions`. Dit zijn de rechten die Cootje zelf bij deze rol gebruikt:

| Getal | Recht                                             |
| ----- | ------------------------------------------------- |
| `300` | Bedrijfsinformatie inzien                         |
| `305` | Documenten inzien                                 |
| `306` | Documenten aanleveren                             |
| `308` | Bankgegevens inzien                               |
| `309` | Bankgegevens bewerken                             |
| `400` | Alle personen van het bedrijf inzien              |
| `403` | Eigen profiel bewerken                            |
| `500` | Alle contracten van het bedrijf inzien            |
| `310` | Facturen inzien                                   |
| `505` | Alle urenstaten van het bedrijf inzien            |
| `503` | Contracten inzien waaraan de persoon gekoppeld is |
| `506` | Urenstaten inzien waaraan de persoon gekoppeld is |
| `402` | Eigen profiel lezen                               |

### Voorbeeld

```bash
curl -X POST "https://mijn.cootje.com/api/organizations/persons" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "person": {
      "firstName": "Sanne",
      "tussenvoegsel": "de",
      "lastName": "Vries",
      "initials": "S.",
      "email": "sanne@voorbeeld.nl",
      "phoneNumber": "0612345678"
    },
    "membership": {
      "companyId": "b1c2d3e4-5f6a-4b7c-8d9e-0a1b2c3d4e5f",
      "roles": [
        1,
        2,
        3
      ],
      "permissions": [
        300,
        305,
        306,
        308,
        309,
        400,
        403,
        500,
        310,
        505,
        503,
        506,
        402
      ]
    }
  }'
```

### Wat je terugkrijgt

De aangemaakte persoon, met het nieuwe `_id`. De koppeling met het bedrijf staat niet in het antwoord:

```json
{
  "_id": "5a1e9c3b-7f2d-4b6a-8e0c-9d4f1a2b3c4d",
  "createdAt": 1799746200000,
  "firstName": "Sanne",
  "tussenvoegsel": "de",
  "lastName": "Vries",
  "initials": "S.",
  "gender": null,
  "email": "sanne@voorbeeld.nl",
  "phoneNumber": "0612345678",
  "address": {
    "street": "",
    "houseNumber": "",
    "houseNumberAddition": "",
    "city": "",
    "zipcode": "",
    "country": "NL"
  },
  "bsn": "",
  "dateOfBirth": "",
  "nationality": "",
  "maritalStatus": "",
  "function": "",
  "isApiAccount": false,
  "displayName": "Sanne de Vries",
  "displayLastName": "de Vries"
}
```

Klopt de invoer niet (`400`) of kan het adres niet bevestigd worden (`422`), dan is het antwoord een lijst met bevindingen en is de persoon niet opgeslagen:

```json
[
  {
    "propertyName": "FirstName",
    "errorMessage": "Voornaam is verplicht"
  }
]
```

## Bestaande persoon koppelen

* **Aanroep:** `POST /organizations/memberships/companies/{companyId}/persons/{personId}`

### Verplichte velden

| Veld        | Soort            | Toelichting                                                                              |
| ----------- | ---------------- | ---------------------------------------------------------------------------------------- |
| `companyId` | tekst, in de URL | Het `_id` van het bedrijf                                                                |
| `personId`  | tekst, in de URL | Het `_id` van de persoon                                                                 |
| `roles`     | lijst            | De rol van de persoon bij het bedrijf: `1` eigenaar, `2` tekenbevoegde, `3` professional |

### Optionele velden

| Veld          | Soort | Toelichting                                                                                                                                    |
| ------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| `permissions` | lijst | De rechten van de persoon bij het bedrijf, als getallen uit de tabel hierboven. Laat je dit weg, dan heeft de persoon de rol maar geen rechten |

### Voorbeeld

```bash
curl -X POST "https://mijn.cootje.com/api/organizations/memberships/companies/b1c2d3e4-5f6a-4b7c-8d9e-0a1b2c3d4e5f/persons/5a1e9c3b-7f2d-4b6a-8e0c-9d4f1a2b3c4d" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "roles": [
      1,
      2,
      3
    ],
    "permissions": [
      300,
      305,
      306,
      308,
      309,
      400,
      403,
      500,
      310,
      505,
      503,
      506,
      402
    ]
  }'
```

### Wat je terugkrijgt

De koppeling tussen de persoon en het bedrijf:

```json
{
  "_id": "4e5f6a7b-8c9d-4e0f-9a1b-3c4d5e6f7a8b",
  "companyId": "b1c2d3e4-5f6a-4b7c-8d9e-0a1b2c3d4e5f",
  "personId": "5a1e9c3b-7f2d-4b6a-8e0c-9d4f1a2b3c4d",
  "roles": [
    1,
    2,
    3
  ],
  "permissions": [
    300,
    305,
    306,
    308,
    309,
    400,
    403,
    500,
    310,
    505,
    503,
    506,
    402
  ]
}
```

Bestaat het bedrijf of de persoon niet, dan is het antwoord een lijst met fouten:

```json
[
  {
    "propertyName": "PersonId",
    "errorMessage": "Persoon bestaat niet"
  }
]
```

## Goed om te weten

* Het bedrijf moet al in Cootje staan. Zie [Bedrijf registreren](https://docs.cootje.com/cootje-api/zzp/bedrijf-registreren.md).
* Een zzp'er krijgt alle drie de rollen, omdat hij het bedrijf bezit, het contract tekent en het werk uitvoert.
* Voor een contract moet de persoon een naam en een e-mailadres hebben.
* Een nieuwe persoon kan nog niet inloggen. Een uitnodiging om een wachtwoord in te stellen verstuur je met `POST /iam/credentials/{personId}/send`. Bij het definitief maken van een contract maakt Cootje vanzelf een inlog aan als die er nog niet is.

## Antwoorden

| Code  | Betekenis                                                                                 |
| ----- | ----------------------------------------------------------------------------------------- |
| `200` | De aangemaakte persoon, of de koppeling                                                   |
| `400` | De invoer klopt niet. Het antwoord is de lijst met fouten                                 |
| `401` | Geen geldig token, of het account mist het recht                                          |
| `422` | Het adres van een nieuwe persoon kon niet bevestigd worden. De persoon is niet opgeslagen |
