> 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/klant-inlener/personen-toevoegen/tekenbevoegde.md).

# Tekenbevoegde

Een tekenbevoegde toevoegen aan een klant: velden, rechten en voorbeelden.

De tekenbevoegde is de persoon die namens de klant contracten ondertekent. Hiermee voeg je een tekenbevoegde toe aan de klant.

* **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 de klant waarvoor hij tekent.

### 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: `2` tekenbevoegde                           |

### 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                                             |
| ----- | ------------------------------------------------- |
| `503` | Contracten inzien waaraan de persoon gekoppeld is |
| `310` | Facturen inzien                                   |

### 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": "Pieter",
      "lastName": "Jansen",
      "initials": "P.",
      "email": "pieter@voorbeeld.nl",
      "function": "Directeur"
    },
    "membership": {
      "companyId": "0b7c2f6e-3d1a-4f5b-9a8e-1c2d3e4f5a6b",
      "roles": [
        2
      ],
      "permissions": [
        503,
        310
      ]
    }
  }'
```

### Wat je terugkrijgt

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

```json
{
  "_id": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
  "createdAt": 1799746200000,
  "firstName": "Pieter",
  "tussenvoegsel": "",
  "lastName": "Jansen",
  "initials": "P.",
  "gender": null,
  "email": "pieter@voorbeeld.nl",
  "phoneNumber": "",
  "address": {
    "street": "",
    "houseNumber": "",
    "houseNumberAddition": "",
    "city": "",
    "zipcode": "",
    "country": "NL"
  },
  "bsn": "",
  "dateOfBirth": "",
  "nationality": "",
  "maritalStatus": "",
  "function": "Directeur",
  "isApiAccount": false,
  "displayName": "Pieter Jansen",
  "displayLastName": "Jansen"
}
```

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: `2` tekenbevoegde |

### 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/0b7c2f6e-3d1a-4f5b-9a8e-1c2d3e4f5a6b/persons/1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "roles": [
      2
    ],
    "permissions": [
      503,
      310
    ]
  }'
```

### Wat je terugkrijgt

De koppeling tussen de persoon en het bedrijf:

```json
{
  "_id": "4e5f6a7b-8c9d-4e0f-9a1b-3c4d5e6f7a8b",
  "companyId": "0b7c2f6e-3d1a-4f5b-9a8e-1c2d3e4f5a6b",
  "personId": "1b2c3d4e-5f6a-4b7c-8d9e-0f1a2b3c4d5e",
  "roles": [
    2
  ],
  "permissions": [
    503,
    310
  ]
}
```

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 [Klant registreren](https://docs.cootje.com/cootje-api/klant-inlener/klant-registreren.md).
* In een contract verwijs je naar deze persoon in het veld `authorizedSignatoriesHirer`.
* Geef bij een tekenbevoegde ook de functie mee (`person.function`). Die staat bij de ondertekening.
* Voor een contract moet de persoon een naam en een e-mailadres hebben.
* Dezelfde persoon kan meerdere rollen hebben. Stuur dan alle rollen mee in `roles`, bijvoorbeeld `[2, 4]` voor iemand die tekent en uren goedkeurt.

## 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 |
