Dochterorganisaties¶

Een dochterorganisatie is een organisatie onder de jouwe: een klant van je, als je partner bent, of een afdeling van je eigen organisatie. Deze pagina laat zien hoe je ze terugvindt, een nieuwe aanmaakt, met of zonder pakket, en hoe je er een opschort, hervat of verwijdert. Wat organisaties en partners zijn, staat in Personen en organisaties.

Je werkt in een dochterorganisatie met de rollen die je in je eigen organisatie hebt met bereik descendants, zonder daar lid te hoeven zijn (Partners). Je opent haar zoals elke organisatie: alles binnen haar, zoals haar instellingen, huisstijl, leden en pakketten, beheer je op haar eigen pagina's.

Wie wat mag¶

De knop Nieuwe dochterorganisatie aanmaken zie je alleen als je er een mag aanmaken. Het menu van een rij toont alleen wat je met die organisatie mag.

De lijst¶

Open Organisatiebeheer en dan Dochterorganisaties. Dit onderdeel staat in het menu zodra je organisatie dochterorganisaties heeft die je ziet, of zodra je er een mag aanmaken.

• Zoek op naam houdt de organisaties waarvan de naam je tekst bevat, hoofdletters of niet.
• Ook de niveaus daaronder toont ook de organisaties onder je dochterorganisaties, tot de diepste laag. Zo vind je een klant op naam zonder eerst zijn partner te openen.
• Wissel naar deze organisatie in het menu van een rij, of een klik op de naam, opent die organisatie.

Een dochterorganisatie aanmaken¶

1. Kies Nieuwe dochterorganisatie aanmaken.
2. Vul de Naam in. Die is uniek onder je organisatie.
3. Kies wie de eerste beheerder wordt. Vink Ik word zelf de eerste beheerder aan om dat zelf te zijn, of vul het E-mailadres van de eerste beheerder in. Die krijgt de rol org-admin met bereik descendants.
4. Kies de Scheiding van gegevens: Gedeeld, gescheiden per organisatie (de standaard) of Een eigen schema. Dit ligt vast zodra de organisatie bestaat.
5. Geef, als je wilt, Labels: een label en een waarde per regel. Regels over organisaties lezen ze (Regels).
6. Kies, als je pakketten mag geven, een Pakket, en voor een proefperiode de datum waarop die eindigt (Proefperiode eindigt op). Zonder pakket krijgt de organisatie de dienst van je eigen organisatie.
7. Vul, als je pakketten mag geven en een demo wilt, Demo tot in. Na die dag wordt de organisatie opgeschort, en dertig dagen later gewist, tenzij je haar omzet. Laat het leeg voor een gewone organisatie.
8. Kies Dochterorganisatie aanmaken.

OS maakt de organisatie, de uitnodiging en het pakket in één keer: wordt het pakket geweigerd, dan wordt er niets aangemaakt. Ben je zelf de eerste beheerder, dan is er geen uitnodiging: je bent lid en beheerder zodra de organisatie is ingericht. Je eigen adres intypen werkt hetzelfde, als het bij je account bevestigd is. Een ander adres krijgt een uitnodiging, en wordt pas lid als die persoon haar accepteert. De nieuwe organisatie staat in de lijst als Wordt ingericht tot ze klaar is, en is daarna Actief.

Opschorten, hervatten en verwijderen¶

• Schort deze organisatie op zet haar stil, met alle organisaties eronder: verzoeken daarin worden geweigerd tot je haar hervat.
• Hervat deze organisatie zet een opgeschorte organisatie weer aan.
• Verwijder deze organisatie vraagt eerst om bevestiging. Een organisatie met eigen dochterorganisaties verwijder je pas als die weg zijn. Daarna wordt ze gewist en staat ze als Wordt verwijderd in de lijst tot dat klaar is.

Lid worden en verlaten¶

Je hebt geen lidmaatschap nodig om in een dochterorganisatie te werken, maar je kunt er lid van worden: dan staat zij in je eigen lijst van organisaties, werk je erin met haar eigen rechten en zien haar beheerders je bij haar leden.

• Word lid van deze organisatie in het menu van een rij maakt je lid, met de rol member en verder niets. Je rollen van boven blijven gelden; wat je in die organisatie meer krijgt, geven haar eigen beheerders je. Haar beheerders horen dat je lid bent geworden.
• Verlaat deze organisatie in het menu van een rij waar je lid bent vraagt om bevestiging en beëindigt dan je lidmaatschap. Wat je erin hebt gemaakt blijft bewaard. De laatste beheerder van een organisatie kan haar niet verlaten; geef eerst een ander lid org-admin.

Je kunt zo niet opnieuw lid worden zolang een beheerder je lidmaatschap heeft gedeactiveerd, en ook niet tijdens een ondersteuningssessie. Een organisatie die haar bedrijfslogin verplicht stelt, neemt je alleen op als je via die login bent ingelogd. Wacht er een uitnodiging van die organisatie op je, dan accepteert Word lid van deze organisatie die meteen, met wat erin staat; daarvoor moet je adres bij je account bevestigd zijn.

Instellingen per dochterorganisatie¶

Vanaf een breed scherm zet je in elke rij een paar dingen voor die organisatie, zoals in Artific Platform. Wie een waarde niet mag wijzigen, ziet haar als label.

• Demo: kies een andere einddatum, of haal haar weg met het kruisje. Weghalen zet de demo om in een gewone organisatie (De einddatum van een demo).
• Kosteninzicht: het verst dat de organisatie kosten en tokengebruik mag tonen. Zij kiest zelf wie ze ziet, maar nooit verder dan dit, en dat geldt ook voor de organisaties onder haar. Zet je het op Niemand, dan ziet daar niemand kosten, ook als haar beheerders iets anders kozen; hun keuze blijft bewaard voor als je het weer ruimer zet.
• Sessie logs: uit betekent dat niemand in die organisatie, haar beheerders ook niet, de chats van een ander met een assistent kan lezen, wat haar regels ook zeggen. Iedereen ziet in de sessielogs dan alleen de eigen chats. Dat geldt ook voor de organisaties onder haar, en ook voor wie Core rechtstreeks aanroept. Zolang het uit staat, weigert OS een regel of rol die het weer zou openzetten.
• Pakketten: vink een pakket aan om het vanaf nu te geven, vink het uit om het terug te nemen. Een pakket dat een organisatie boven jou gaf, staat aangevinkt en vast: alleen die kan het terugnemen. Bij een proefperiode staat de einddatum erbij.
• Beperkingen voor beheerders in het menu van een rij: wat de beheerders van die organisatie zelf niet mogen, namelijk Het verbruik inzien, De audittrail inzien en Sleutels beheren. OS leest de huidige waarde als je het venster opent.

Elke wijziging komt op de audittrail van die organisatie, met wie haar maakte, en nooit met de waarde.

Via de API¶

De voorbeelden gebruiken $OS, $TOKEN en $ORG zoals in Groepen beheren.

curl -s "$OS/api/v1/organisations/$ORG/organisations?scope=descendants&q=acme" \
    -H "Authorization: Bearer $TOKEN"

{"items": [{"id": "org_...", "name": "Acme", "parent_id": "org_...", "status": "active",
            "child_count": 2, "reach": "from_above", "plans": ["Basis"],
            "primary_colour": "#287deb", "may_join": true,
            "parent_allowed_actions": ["see", "write", "delete"],
            "child_allowed_actions": ["see", "write", "delete"]}],
 "next_cursor": null}

• scope is children (de standaard: alleen direct eronder) of descendants (alle niveaus).
• q houdt de namen die de tekst bevatten; status houdt één status.
• De lijst is gesorteerd op naam en komt in pagina's: geef next_cursor mee als cursor voor de volgende. Een pagina kan minder rijen hebben dan limit terwijl next_cursor doorgaat.
• reach is member of from_above; plans is leeg als je de dienst van die organisatie niet mag zien. parent_allowed_actions zegt of je haar mag opschorten en hervatten (write) en verwijderen (delete).
• child_allowed_actions staat op elke organisatie: staat write erin, dan mag je eronder een organisatie aanmaken.
• primary_colour is de kleur in de lijst, null voor de eigen kleur van het platform; may_join zegt of je er lid van mag worden.

Een organisatie aanmaken, met een pakket voor een proefperiode:

curl -s -X POST "$OS/api/v1/organisations/$ORG/organisations" \
    -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
    -d '{"name": "Acme", "first_admin_email": "beheer@acme.example",
         "plan_id": "pln_...", "plan_ends_at": "2026-12-31T00:00:00Z"}'

Geef "first_admin_self": true in plaats van first_admin_email om zelf de eerste beheerder te zijn; één van de twee is verplicht. isolation (shared of schema) en labels zijn optioneel. Welke pakketten je kunt geven, lees je met GET /api/v1/organisations/$ORG/assignable-plans (Pakketten en uitzonderingen). Opschorten, hervatten en verwijderen zijn POST …/organisations/{id}/suspend, POST …/resume en DELETE /api/v1/organisations/{id}. Lid worden is POST …/organisations/{id}/join en verlaten POST …/organisations/{id}/leave.

Een demo aanmaken: geef "demo_ends_at": "2027-01-31T00:00:00Z" mee bij het aanmaken. Elke rij van de lijst heeft ook demo_ends_at, cost_visibility_limit, session_logs_readable, plan_assignments (elk pakket met id, ends_at en may_take_back) en service_parent_actions. Kosteninzicht en sessie logs lees je met GET /api/v1/organisations/{id}/limits en wijzig je met PATCH, naast het kostenplafond en admin_restrictions:

curl -s -X PATCH "$OS/api/v1/organisations/$KLANT/limits" \
    -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
    -d '{"cost_visibility_limit": "off", "session_logs_readable": false}'

Als OS weigert¶