> 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/bedrijf-registreren.md).

# Bedrijf registreren

Het bedrijf van een zzp'er registreren als leverancier, met het KvK-nummer.

Een zzp'er werkt vanuit zijn eigen bedrijf. Dat bedrijf registreer je in Cootje als leverancier. Staat het er al in, dan hoef je het niet opnieuw te registreren.

* **Vereist recht:** Bedrijfsinformatie bewerken (voor het zoeken volstaat Bedrijfsinformatie inzien)

## Stap 1: controleren of het bedrijf al bestaat

* **Aanroep:** `POST /organizations/companies/query`
* **Verplicht:** niets
* **Optioneel:** `filter`, `sortBy`, `top` en `select`

Een KvK-nummer met hetzelfde vestigingsnummer kan maar één keer in een omgeving voorkomen. Zoek daarom eerst op het KvK-nummer:

```bash
curl -X POST "https://mijn.cootje.com/api/organizations/companies/query" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "filter": {
        "field": "kvkNummer",
        "op": "eq",
        "value": "23456789"
      }
    }
  }'
```

Een voorwaarde in `filter` bestaat uit `field` (het veld), `op` (de vergelijking, hier `eq` voor "gelijk aan") en `value` (de waarde).

Bestaat het bedrijf al, dan krijg je een lijst met dat bedrijf terug, in de vorm die je onderaan deze pagina ziet. Gebruik dan het `_id` uit dat antwoord en sla stap 2 over. Bestaat het nog niet, dan is de lijst leeg:

```json
[]
```

## Stap 2: het bedrijf registreren

* **Aanroep:** `POST /organizations/companies`

Naam, rechtsvorm en adres haalt Cootje zelf op bij de KvK.

### Verplichte velden

| Veld             | Soort  | Toelichting                               |
| ---------------- | ------ | ----------------------------------------- |
| `kvK`            | tekst  | Het KvK-nummer: 8 cijfers, zonder spaties |
| `phone`          | tekst  | Telefoonnummer                            |
| `billingAddress` | tekst  | Het e-mailadres voor facturen             |
| `genericAddress` | tekst  | Het algemene e-mailadres                  |
| `isSupplier`     | ja/nee | `true`: het bedrijf is leverancier        |

### Verplicht in bepaalde gevallen

| Situatie                                          | Dan verplicht                       |
| ------------------------------------------------- | ----------------------------------- |
| Je stuurt een bankrekening mee (`bankAccount`)    | `iban` (een geldig IBAN) en `type`  |
| Je stuurt `wtta` mee met `status` `1` (toelating) | `wtta.number`, het toelatingsnummer |

### Optionele velden

| Veld               | Soort           | Toelichting                                                                                                                                  |
| ------------------ | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| `vestigingsNummer` | tekst           | Het vestigingsnummer. Laat je het weg, dan kiest Cootje de eerste vestiging die bij het KvK-nummer hoort                                     |
| `btw`              | tekst           | Het btw-nummer. Cootje controleert het en zet `btwValidated`                                                                                 |
| `bankAccount`      | object          | Bankrekening van het bedrijf: `iban` en `type` (`1` gewone rekening, `2` G-rekening)                                                         |
| `isCustomer`       | ja/nee          | `true` als het bedrijf ook klant is                                                                                                          |
| `wtta`             | object          | Vastlegging voor de Wet toelating terbeschikkingstelling van arbeidskrachten: `status` (`0` geen, `1` toelating, `2` ontheffing) en `number` |
| `departments`      | lijst met tekst | Namen van afdelingen                                                                                                                         |

### Voorbeeld

```bash
curl -X POST "https://mijn.cootje.com/api/organizations/companies" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "kvK": "23456789",
    "phone": "0301234567",
    "billingAddress": "facturen@devriesprojecten.nl",
    "genericAddress": "info@devriesprojecten.nl",
    "isSupplier": true,
    "bankAccount": {
      "iban": "NL91ABNA0417164300",
      "type": 1
    }
  }'
```

### Wat je terugkrijgt

Het aangemaakte bedrijf, met het nieuwe `_id` en de gegevens van de KvK:

```json
{
  "kvkNummer": "23456789",
  "indNonMailing": "Nee",
  "naam": "De Vries Projecten",
  "formeleRegistratiedatum": "20150622000000000",
  "materieleRegistratie": {
    "datumAanvang": "20150601"
  },
  "totaalWerkzamePersonen": 1,
  "handelsnamen": [
    {
      "naam": "De Vries Projecten",
      "volgorde": 0,
      "isStatutaireNaamFallback": false
    }
  ],
  "sbiActiviteiten": [
    {
      "sbiCode": "70221",
      "sbiOmschrijving": "Organisatie-adviesbureaus",
      "indHoofdactiviteit": "Ja"
    }
  ],
  "_id": "b1c2d3e4-5f6a-4b7c-8d9e-0a1b2c3d4e5f",
  "btw": "",
  "btwValidated": false,
  "phone": "0301234567",
  "statutaireNaam": "De Vries Projecten",
  "legalName": "De Vries Projecten",
  "genericAddress": "info@devriesprojecten.nl",
  "billingAddress": "facturen@devriesprojecten.nl",
  "vestigingsNummer": "000023456789",
  "departments": [],
  "rechtsvorm": 4,
  "address": {
    "street": "Voorbeeldlaan",
    "houseNumber": "100",
    "houseNumberAddition": "",
    "city": "Utrecht",
    "zipcode": "3584 CX",
    "country": "NL"
  },
  "kvkAddress": {
    "isBezoekAdres": true,
    "type": "bezoekadres",
    "indAfgeschermd": "Nee",
    "volledigAdres": "Voorbeeldlaan 100 3584CX Utrecht",
    "straatnaam": "Voorbeeldlaan",
    "huisnummer": 100,
    "huisnummerToevoeging": null,
    "huisletter": null,
    "toevoegingAdres": null,
    "postcode": "3584CX",
    "plaats": "Utrecht",
    "straatHuisnummer": "Voorbeeldlaan 100",
    "postcodeWoonplaats": "3584CX Utrecht",
    "regio": "Utrecht",
    "land": "Nederland",
    "postbusnummer": null,
    "isHidden": false,
    "isEmpty": false
  },
  "isAddressIncomplete": false,
  "isSupplier": true,
  "isCustomer": false,
  "snaCertified": false,
  "wtta": {
    "status": 0,
    "number": ""
  },
  "isForeign": false,
  "isValidated": true
}
```

* `billingAddress` en `genericAddress` zijn e-mailadressen: het adres voor facturen en het algemene adres. Het postadres staat in `address`.
* De velden bovenaan (`kvkNummer` tot en met `sbiActiviteiten`) en `kvkAddress` komen rechtstreeks van de KvK, in de vorm waarin de KvK ze levert.
* `rechtsvorm` is een getal, bijvoorbeeld `1` voor een bv, `2` voor een nv, `3` voor een vof, `4` voor een eenmanszaak en `5` voor een stichting.
* `wtta.status` is `0` (geen), `1` (toelating) of `2` (ontheffing).
* `btwValidated` is `true` als het btw-nummer is bevestigd.

Klopt de invoer niet, dan is het antwoord een lijst met fouten:

```json
[
  {
    "propertyName": "Phone",
    "errorMessage": "Telefoonnummer is verplicht"
  }
]
```

## Nodig voor een contract

Een contract met een zzp'er kan pas definitief worden als het bedrijf aan deze punten voldoet:

* Er is minstens één gewone bankrekening aan het bedrijf gekoppeld. Die geef je mee in `bankAccount`, of voeg je later toe met `POST /organizations/companies/{companyId}/bankaccounts`.
* Het adres van het bedrijf is volledig (`isAddressIncomplete` is `false`).
* Het btw-nummer van het bedrijf is bevestigd (`btwValidated` is `true`). Zonder bevestigd btw-nummer kunnen de urenstaten van het contract niet worden gefactureerd.

Staat in het antwoord `isAddressIncomplete` op `true`, dan kon Cootje het adres van de KvK niet omzetten. Vul het adres dan zelf aan met `PUT /organizations/companies/{companyId}/address`. Daarvoor is het recht **Contracten kunnen bewerken** nodig.

```bash
curl -X PUT "https://mijn.cootje.com/api/organizations/companies/b1c2d3e4-5f6a-4b7c-8d9e-0a1b2c3d4e5f/address" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "street": "Voorbeeldlaan",
      "houseNumber": "100",
      "houseNumberAddition": "",
      "zipcode": "3584 CX",
      "city": "Utrecht",
      "country": "NL"
    }
  }'
```

In die aanroep zijn `street`, `zipcode`, `city` en `country` verplicht, en bij een Nederlands adres ook `houseNumber`. Het antwoord is het bijgewerkte bedrijf, in dezelfde vorm als hierboven.

## Antwoorden

| Code  | Betekenis                                                      |
| ----- | -------------------------------------------------------------- |
| `200` | Bij zoeken: de lijst. Bij registreren: het aangemaakte bedrijf |
| `400` | De invoer klopt niet. Het antwoord is de lijst met fouten      |
| `401` | Geen geldig token, of het account mist het recht               |
