# 02.01. Organisatie Onboarding

_Laatst bijgewerkt: 25 augustus 2026_

**Van toepassing op**: C5P platform, multi-tenant versie  
**Doelgroep**: Nieuwe gebruikers, Managers, Organisatie Eigenaren, C5P-beheerders

Zie ook [03.05. Uitnodigingen en Teamleden](03_05_uitnodigingen.md) — deze twee flows leven naast elkaar en delen dezelfde status **Wachtend op goedkeuring** en dezelfde goedkeuringsschermen.

---

## Inhoudsopgave

1. [Overzicht](#1-overzicht)
2. [Wanneer zie je het onboardingscherm?](#2-wanneer-zie-je-het-onboardingscherm)
3. [Automatisch gekoppeld op basis van e-maildomein](#3-automatisch-gekoppeld-op-basis-van-e-maildomein)
4. [Zelf een organisatie zoeken en een verzoek indienen](#4-zelf-een-organisatie-zoeken-en-een-verzoek-indienen)
5. [Een nieuwe organisatie aanmaken](#5-een-nieuwe-organisatie-aanmaken)
6. [Als organisatie: een verzoek beoordelen](#6-als-organisatie-een-verzoek-beoordelen)
7. [Wat gebeurt er bij afwijzing?](#7-wat-gebeurt-er-bij-afwijzing)
8. [Beslissingsboom](#8-beslissingsboom)
9. [Veelgestelde vragen (FAQ)](#9-veelgestelde-vragen-faq)

---

## 1. Overzicht

Als je inlogt bij C5P (via Microsoft-login of met e-mail/wachtwoord) en je bent nog aan geen
organisatie gekoppeld, zie je **verplicht** een onboardingscherm voordat je de rest van de
applicatie kunt gebruiken. Dit scherm kun je niet wegklikken of overslaan.

> **Belangrijk uitgangspunt:** het kiezen of aanvragen van een organisatie is altijd een
> **verzoek**. Je wordt **nooit automatisch lid** van een organisatie zonder dat die organisatie
> (of, als niemand daar nog beheert, een C5P-beheerder) dit heeft goedgekeurd. De enige
> uitzondering: als je zelf een **nieuwe** organisatie aanmaakt, word je daar direct eigenaar van
> — er is dan namelijk niemand anders die dat zou kunnen goedkeuren.

Er zijn drie manieren waarop je bij een organisatie terechtkomt:

| Manier | Wat gebeurt er? |
|---|---|
| **Automatische koppeling op e-maildomein** | Systeem herkent je e-maildomein en dient namens jou een verzoek in bij de bijbehorende organisatie |
| **Zelf zoeken en verzoek indienen** | Jij zoekt de organisatie op en dient zelf een verzoek in |
| **Nieuwe organisatie aanmaken** | Jij maakt een nieuwe organisatie aan en wordt direct eigenaar |

Het eerste scherm dat je te zien krijgt, is deze keuze:

![Onboardingscherm: kies zoeken of aanmaken](assets/onboarding-choose.png)

## 2. Wanneer zie je het onboardingscherm?

Je ziet het onboardingscherm zodra:
- je (nog) bij geen organisatie hoort, **of**
- je wacht op goedkeuring van een verzoek dat je zelf hebt ingediend, of dat automatisch is
  ingediend op basis van je e-maildomein.

Dit geldt voor **alle** nieuwe gebruikers (Microsoft-login én zelfregistratie), en ook voor
gebruikers die al langer een account hebben maar nog nooit aan een organisatie gekoppeld zijn.

> **ℹ️ Info:** Ben je uitgenodigd door iemand via een uitnodigingsmail? Dan doorloop je een ander
> proces — zie [03.05. Uitnodigingen en Teamleden](03_05_uitnodigingen.md). Daar wacht je ook op
> goedkeuring, maar je weet al voor welke organisatie, dus je krijgt dit scherm niet.

## 3. Automatisch gekoppeld op basis van e-maildomein

Als jouw e-maildomein (bijvoorbeeld `@bedrijfb.nl`) al bekend staat bij een organisatie in C5P,
koppelt het systeem je automatisch aan die organisatie zodra je inlogt — **maar dit is nog geen
lidmaatschap**. Je krijgt een informatiescherm:

> *"Je bent op basis van je e-maildomein (…@bedrijfb.nl) gekoppeld aan **Bedrijf B.V.** en wacht op
> goedkeuring van een beheerder van die organisatie."*

Je kunt hier niets aan wijzigen — er wordt automatisch een verzoek verstuurd naar de beheerders
van die organisatie (zie §6). Denk je dat dit een fout is? Neem contact op met de C5P-ondersteuning.

![Informatiescherm bij automatische koppeling op e-maildomein](assets/onboarding-domain-match.png)

## 4. Zelf een organisatie zoeken en een verzoek indienen

Herkent het systeem je e-maildomein niet, dan kun je zelf zoeken:

1. Boven het zoekveld staan **standaard al een paar organisaties die op je e-maildomein lijken**
   (fuzzy match, maximaal 5) — vaak staat de juiste er al bij, zonder dat je iets hoeft te typen.
2. Typ de naam van je organisatie in het zoekveld om breder te zoeken.
3. Organisaties die al een beheerder hebben, tonen dat ("verzoek gaat naar een beheerder van deze
   organisatie"). Organisaties zonder beheerder (bijv. een net vanuit KLIC aangemaakte
   netbeheerder-organisatie) tonen dat een C5P-beheerder je verzoek beoordeelt. KLIC-organisaties
   krijgen een apart badge.
4. Staat je organisatie er niet bij (ook niet na zoeken)? Onder de lijst staat altijd de link
   **"Maak een nieuwe organisatie aan"** — dit is je escape hatch, zie §5.
5. Klik op **"Verzoek tot lidmaatschap versturen"**.
6. Je ziet een bevestiging:

   > *"Je verzoek is verstuurd naar [organisatie]. Je krijgt pas toegang zodra een beheerder van
   > die organisatie het heeft goedgekeurd."*

7. Je blijft op het onboardingscherm ("wachten op goedkeuring") totdat het verzoek is beoordeeld.

![Zoekscherm met organisaties die op je e-maildomein lijken](assets/onboarding-search.png)

> **⚠️ Let op:** Er is geen knop "Word direct lid". Elk verzoek moet eerst worden goedgekeurd —
> ook als je toevallig de juiste organisatie kiest.

Na het versturen zie je het wachtscherm. De tekst verschilt licht op basis van wie je verzoek
beoordeelt:

| Beoordelaar | Scherm |
|---|---|
| Manager/Organisatie Eigenaar van de gekozen organisatie | ![Wachtscherm, verzoek naar organisatiebeheerder](assets/onboarding-waiting-manager.png) |
| C5P-beheerder (organisatie heeft nog geen beheerder) | ![Wachtscherm, verzoek naar C5P-beheerder](assets/onboarding-waiting-admin.png) |

## 5. Een nieuwe organisatie aanmaken

Bestaat je organisatie nog niet in C5P? Dan kun je er zelf één aanmaken:

1. Klik op **"Nieuwe organisatie aanmaken"** (via Screen C, of via de link onderaan het
   zoekscherm — zie §4).
2. Vul de naam (en eventueel type, website, KvK-nummer) in.
3. Klik op **"Organisatie aanmaken"**.
4. Je wordt **direct** **Organisatie Eigenaar** van deze nieuwe organisatie — geen wachttijd, geen
   goedkeuring nodig (jij bent immers de enige die er op dat moment bij hoort).

![Formulier om een nieuwe organisatie aan te maken](assets/onboarding-create.png)

## 6. Als organisatie: een verzoek beoordelen

**Wie kan dit doen?** Manager of Organisatie Eigenaar van de organisatie waar het verzoek naartoe gaat.

Verzoeken van §3 en §4 komen op **hetzelfde scherm** terecht als wachtende leden
van uitnodigingen (zie [03.05. Uitnodigingen — hoofdstuk 4](03_05_uitnodigingen.md#4-wachtend-op-goedkeuring--goedkeuren-of-afwijzen)).
Elke regel toont waar het verzoek vandaan komt:

| Badge | Betekenis |
|---|---|
| "via uitnodiging" | Iemand met beheerrechten heeft deze persoon uitgenodigd |
| "via e-maildomein" | Automatisch gekoppeld op basis van e-maildomein (§3) |
| "verzoek van gebruiker" | Gebruiker heeft zelf de organisatie gezocht en een verzoek gestuurd (§4) |

Goedkeuren werkt exact zoals bij uitnodigingen: rol kiezen, **Goedkeuren** klikken (of via de
directe knop in de notificatiemail — zie [hoofdstuk 4 van de uitnodigingenhandleiding](03_05_uitnodigingen.md#4-wachtend-op-goedkeuring--goedkeuren-of-afwijzen)).

Als Manager of Organisatie Eigenaar zie je dit blok boven je normale teamoverzicht op de
**Contacten**-pagina, met per verzoek de herkomst-badge, een rolkeuze en **Goedkeuren**/**Afwijzen**:

![Wachtende verzoeken op de Contacten-pagina, met herkomst-badges](assets/team-pending-requests.png)

**Heeft de organisatie nog géén beheerder** (bijv. een zojuist vanuit KLIC aangemaakte
netbeheerder-organisatie, of een handmatig aangemaakte organisatie waar nog niemand bij hoort)?
Dan kan er ook nog niemand dit scherm gebruiken — in dat geval beoordeelt een **C5P-beheerder**
het verzoek in een apart beheerscherm. De eerste persoon die zo wordt goedgekeurd, wordt
automatisch **Organisatie Eigenaar** van die organisatie.

## 7. Wat gebeurt er bij afwijzing?

Dit is het belangrijkste verschil met de bestaande uitnodigingsflow:

| Situatie | Bij afwijzing |
|---|---|
| Uitnodiging afgewezen (bestaand gedrag) | Account wordt **gedeactiveerd** — kan niet meer inloggen |
| Zelf-aangevraagd verzoek afgewezen (§4) of automatische e-maildomein-koppeling afgewezen (§3) | Account blijft **actief** — je komt terug op het onboardingscherm en kunt een andere organisatie kiezen |

Je account wordt dus **niet** geblokkeerd als jouw eigen verzoek wordt afgewezen — je krijgt
gewoon de kans om een andere organisatie te zoeken of zelf een nieuwe aan te maken.

## 8. Beslissingsboom

```
Start: gebruiker logt in, needs_organization_onboarding = true
│
├── Matcht e-maildomein een bestaande organisatie? (en geen actieve uitnodiging)
│   └── JA ──► Automatisch verzoek aangemaakt (§3)
│               Informatiescherm, geen actie mogelijk
│               └── Ga naar "wacht op beoordeling"
│
└── NEE ──► Gebruiker kiest zelf:
    │
    ├── Zoeken + "Verzoek tot lidmaatschap versturen" (§4)
    │   └── Verzoek aangemaakt, bevestiging getoond
    │       └── Ga naar "wacht op beoordeling"
    │
    └── "Nieuwe organisatie aanmaken" (§5)
        └── Organisatie direct aangemaakt
            Gebruiker wordt direct Organisatie Eigenaar
            └── KLAAR — geen goedkeuring nodig

"Wacht op beoordeling":
│
├── Heeft de doelorganisatie al een actieve beheerder?
│   ├── JA ──► Verschijnt bij Contacten van die organisatie
│   │           Manager of Organisatie Eigenaar keurt goed of wijst af
│   └── NEE ──► Verschijnt in C5P-beheerder-wachtrij
│               C5P-beheerder keurt goed (vaak als Organisatie Eigenaar) of wijst af
│
├── Goedgekeurd ──► Gebruiker krijgt toegewezen rol + volledige toegang. KLAAR ✅
│
└── Afgewezen ──► Account blijft actief
                    Gebruiker terug naar onboardingscherm, kan opnieuw kiezen
```

## 9. Veelgestelde vragen (FAQ)

**V: Ik log in en zie meteen dit scherm — is dat normaal?**
A: Ja, als je nog aan geen organisatie gekoppeld bent, is dit verplicht. Je kunt de rest van de
applicatie pas gebruiken nadat je een organisatie hebt gekozen (of aangemaakt) en, tenzij je zelf
een nieuwe organisatie aanmaakt, nadat een beheerder je verzoek heeft goedgekeurd.

**V: Ik ben per ongeluk automatisch aan de verkeerde organisatie gekoppeld op basis van mijn
e-maildomein. Wat nu?**
A: Neem contact op met de C5P-ondersteuning — dit is niet zelf terug te draaien vanuit het
onboardingscherm.

**V: Wordt mijn verzoek automatisch goedgekeurd als ik lang wacht?**
A: Nee. Net als bij uitnodigingen is er geen automatische vervaltermijn — een Manager,
Organisatie Eigenaar of C5P-beheerder moet altijd actief goedkeuren of afwijzen.

**V: Kan ik zomaar bij een andere organisatie inloggen door hun naam te zoeken en te bevestigen?**
A: Nee. Het zoeken en indienen van een verzoek geeft je **geen** toegang. Alleen een beheerder van
die organisatie (of een C5P-beheerder, als er nog geen beheerder is) kan je verzoek goedkeuren.

**V: Wat is het verschil tussen dit scherm en de bestaande "Wachtende leden" (uitnodigingen)?**
A: Voor de organisatie die het verzoek beoordeelt: geen verschil in het goedkeuren zelf — het is
hetzelfde scherm, met een extra badge die de herkomst toont. Het verschil zit in wat er gebeurt
bij **afwijzing** (zie §7): bij een zelf ingediend verzoek blijft het account van de aanvrager
actief, bij een afgewezen uitnodiging wordt het account gedeactiveerd.

**V: Ik ben de eerste persoon van mijn organisatie die zich aanmeldt via een geïmporteerde
KLIC-organisatie (netbeheerder/gemeente) zonder beheerder. Wat gebeurt er?**
A: Je verzoek gaat naar een C5P-beheerder (er is nog niemand binnen jouw organisatie die het kan
goedkeuren). Zodra een C5P-beheerder je goedkeurt, word je automatisch **Organisatie Eigenaar** van die
organisatie en kun je zelf verdere collega's beheren via de normale Team-pagina.

---

## Gerelateerde onderwerpen

- [02. Login en Navigatie](02_login_en_navigatie.md) - Inloggen voordat het onboardingscherm verschijnt
- [03.05. Uitnodigingen en Teamleden](03_05_uitnodigingen.md) - Uitnodigen, wachten op goedkeuring en goedkeuren
- [03.01. Rollen en Permissies](03_01_rollen_en_permissies.md) - Organisatierollen, inclusief Wachtend op goedkeuring
- [03.03. Contacten Overzicht](03_03_contacten_overzicht.md) - Gebruikersbeheer op globaal niveau
- [03.04. Organisaties Overzicht](03_04_organisaties_overzicht.md) - Organisaties beheren
- [04.15. Team Beheer](04_15_team_beheer.md) - Teamleden binnen een initiatief

---

### Metadata
- **Versie:** 1.1
- **Laatst gewijzigd:** 25 augustus 2026
- **Gerelateerde use cases**: UC-1-010 (Self-Onboard with Organization Selection), UC-1-011 (Claim
  KLIC Organization)
- **Screenshots**: geproduceerd vanuit de productiecomponenten in `c5p.app-frontend` (Nuxt UI Pro),
  met voorbeelddata — niet uit een live omgeving