# Werkruimte-instellingen

Alles rond je werkruimte vind je onder **Instellingen**: werkruimtegegevens, API-toegang en activiteit. De pagina heeft negen secties, onder elkaar aan de linkerkant: **Algemeen**, **Bedrijf**, **E-mail**, **Nummering**, **Belastingen**, **Team**, **API-sleutels**, **Webhooks** en **Activiteit**. Op een klein scherm is de lijst een rij boven de pagina die je opzij kunt scrollen. Elke sectie heeft een eigen adres, `/settings/{section}` (bijvoorbeeld `/settings/api-keys` of `/settings/business`), dus je kunt een link naar een specifieke sectie opslaan of delen. `/settings` zonder meer opent **Algemeen**, en oudere links die eindigen op `?tab=` (zoals `/settings?tab=email`) openen nog steeds de juiste sectie.

Instellingen vereist een actief bedrijf. Heb je er nog geen gekozen, dan toont de pagina **Selecteer eerst een bedrijf.** in plaats van de secties; kies een bedrijf via de bedrijfswisselaar bovenaan de zijbalk en kom terug.

## Wijzigingen opslaan

Formulieren op een instellingenpagina hebben geen eigen opslaanknop. Zodra je een veld wijzigt, verschijnt onderaan het scherm een balk met **Niet-opgeslagen wijzigingen**, **Wijzigingen negeren** en **Opslaan**:

- **Opslaan** slaat elk formulier op dat je op de pagina hebt gewijzigd, van boven naar beneden. Zolang dat loopt, staat er **Opslaan…** op de knop. Elk formulier toont zijn eigen bevestiging. Mislukt er een, dan staan de fouten onder de betreffende velden en worden de formulieren eronder nog niet opgeslagen: los de fout op en klik opnieuw op **Opslaan**.
- **Wijzigingen negeren** zet elk veld terug naar wat het laatst is opgeslagen.
- Klik je met niet-opgeslagen wijzigingen op een andere sectie in de lijst, dan vraagt de pagina eerst **Niet-opgeslagen wijzigingen** ("Je wijzigingen zijn niet opgeslagen."): **Wijzigingen negeren** gooit de wijzigingen weg en opent de sectie, **Annuleren** laat je blijven waar je bent. Sluit of herlaad je het tabblad, dan vraagt de browser het ook.

Een paar dingen zijn acties en geen instellingen, en houden hun eigen knop of schakelaar: **Wachtwoord wijzigen**, een handtekening uploaden of verwijderen, de schakelaar **Prijzen inclusief BTW**, en items in lijsten toevoegen, bewerken of verwijderen (documenttypes, nummerreeksen, BTW-klassen, e-mailaccounts, teamleden, API-sleutels, webhooks). Die worden meteen opgeslagen en laten de balk nooit verschijnen.

## Algemeen

De sectie **Algemeen** toont het geselecteerde bedrijf, je eigen accountgegevens en een wachtwoordformulier.

### Bedrijf

Het vak **Bedrijf** is alleen-lezen. Het toont de **Naam**, **Slug** en **Tenant-ID** van het actieve bedrijf. Deze kun je hier niet bewerken; een waarde die niet is ingesteld wordt als een streepje weergegeven.

### Je accountgegevens bijwerken

1. Open **Instellingen** en blijf op **Algemeen**.
2. Bewerk de velden in het vak **Account**.
3. Klik op **Opslaan** in de balk onderaan. Als het lukt, verschijnt **Opgeslagen.** onder het laatste veld.

| Veld | Beschrijving |
| --- | --- |
| Naam | Je weergavenaam. Verplicht. |
| E-mail | Alleen-lezen. Het veld is uitgeschakeld; neem contact op met support om je e-mailadres te wijzigen. |
| Telefoon | Optioneel. Wordt gewist als je het leegmaakt. |
| Bedrijfsnaam | Optioneel. Wordt gewist als je het leegmaakt. |
| Bedrijfstype | Optionele vrije tekst. Wordt gewist als je het leegmaakt. |

Is iets ongeldig, dan verschijnt de foutmelding direct onder het veld waar die bij hoort.

### Je wachtwoord wijzigen

Als je je wachtwoord wijzigt, word je uitgelogd op al je andere sessies. Het apparaat waarop je de wijziging doorvoert blijft ingelogd; elke andere browser of elk ander apparaat moet opnieuw inloggen.

1. Scrol op **Algemeen** naar het vak **Wachtwoord wijzigen**.
2. Vul **Huidig wachtwoord**, **Nieuw wachtwoord** en **Bevestig nieuw wachtwoord** in.
3. Klik op **Wachtwoord wijzigen**. Bij succes zie je **Wachtwoord bijgewerkt.** en worden de velden leeggemaakt.

Als het nieuwe wachtwoord en de bevestiging verschillen, krijg je **Wachtwoorden komen niet overeen.** te zien voordat er iets wordt verzonden.

## Bedrijfsprofiel

De sectie **Bedrijf** bevat de juridische identiteit die op offertes, facturen en uitgaande e-mails komt: juridische naam, adres, fiscale nummers, bankgegevens, handtekening en documentstandaarden. Alleen de accounteigenaar kan die wijzigen; andere leden zien de velden grijs en de melding "Alleen de eigenaar van de werkruimte kan het bedrijfsprofiel wijzigen."

Bovenaan tonen drie statuspillen wat er nog ontbreekt:

| Pil | Compleet wanneer |
| --- | --- |
| Juridische identiteit | Juridische naam, straat, postcode, plaats, land en registratienummer zijn allemaal ingevuld. |
| Ondertekening | Naam ondertekenaar én een handtekeningafbeelding zijn beide ingesteld. |
| Afzender | Afzender-e-mail of e-mail is ingevuld. |

Het formulier is verdeeld in vakken, elk veld met het label links en het veld rechts (op een klein scherm staat het label boven het veld):

| Vak | Velden |
| --- | --- |
| Juridische identiteit | Juridische naam, Handelsnaam |
| Adres | Straat, Nummer, Postcode, Plaats, Land (2-letterige code, bijv. `NL`) |
| Fiscale nummers | KvK-nummer, BTW-nummer, Loonheffingennummer |
| Bank | IBAN, BIC, Banknaam |
| Ondertekening | Naam ondertekenaar, Handtekening |
| Afzender | Naam afzender, E-mail afzender, E-mail, Telefoon, Website |
| Documentstandaarden | Geldigheid offerte (dagen), Betaaltermijn (dagen), Documenttaal, Valuta, Algemene voorwaarden, Voettekst factuur |
| Contenttalen | De talen waarin je Objecten-content is geschreven; zie hieronder |
| Sociale links | Platform, URL, Label per link; zie hieronder |

Als je een tekstveld leegmaakt en opslaat, wordt de opgeslagen waarde gewist. BTW-nummer, land en valuta worden automatisch in hoofdletters gezet; de IBAN wordt bij het opslaan gevalideerd en genormaliseerd, en de BIC wordt in hoofdletters gezet en moet uit 8 of 11 letters en cijfers bestaan. Het **Loonheffingennummer** bestaat uit negen cijfers, de letter L en twee cijfers (bijvoorbeeld `123456789L01`). Spaties en punten worden weggehaald en de letter wordt een hoofdletter; elke andere vorm geeft "The payroll tax number must look like 123456789L01." Het staat in het werkgeversblok van elke loonstrook (zie [Salarisadministratie](/nl/docs/payroll/index#voor-je-eerste-loonrun)).

### Contenttalen

Het vak **Contenttalen** ("Talen waarin je content is geschreven. De standaardtaal is altijd inbegrepen.") bepaalt in welke talen de module Objecten content kan bevatten. De standaardtaal is je **Documenttaal**, getoond als chip met het label **Standaard**; ze is altijd inbegrepen en kan niet worden uitgezet. Klik op een voorgestelde taalchip om een taal toe te voegen of te verwijderen, of typ een code zoals `en-GB` en klik op **Taal toevoegen** (een onjuiste code geeft "Gebruik een taalcode zoals nl of en-GB."). Het wordt net als de rest van het profiel opgeslagen via de opslaanbalk, en maximaal 10 talen kunnen worden ingeschakeld. Wijzig je de **Documenttaal**, dan blijft de vorige standaard in de lijst staan. Zie [Vertalingen](/nl/docs/objects/translations) voor wat dit in Objecten verandert.

### Sociale links

Het vak **Sociale links** ("Zichtbaar op je openbare website. Links moeten met https:// beginnen en bij het platform horen.") toont de sociale profielen die je website laat zien, in de volgorde die je instelt. Een link wijzigen laat de opslaanbalk verschijnen, en **Opslaan** slaat de links op samen met andere profielwijzigingen op de pagina. Alleen de accounteigenaar kan het vak bewerken: voor andere leden is het alleen-lezen en staat er "Alleen de eigenaar van de werkruimte kan sociale links wijzigen." Dezelfde lijst kun je in de mobiele app bewerken onder het bedrijfsprofiel.

1. Klik op **Link toevoegen**. Er verschijnt een rij met een keuzelijst **Platform** en een veld **URL** dat met `https://` begint.
2. Kies het **Platform**, plak het adres in **URL** en vul **Label** in als je weergavetekst wilt.
3. Wijzig de volgorde met de knoppen omhoog en omlaag of door een rij aan de greep te slepen; verwijder een rij met de prullenbakknop.
4. Klik op **Opslaan** in de balk onderaan. **Sociale links opgeslagen.** bevestigt het. Een lege lijst opslaan wist de links; een lege lijst toont "Nog geen sociale links."

Je kunt maximaal 25 links toevoegen ("Je kunt maximaal 25 links toevoegen."); bij de limiet is **Link toevoegen** uitgeschakeld. Kies **Overig** voor elke site die niet in de lijst staat (een blog, een winkel elders); het label is dan verplicht: zolang je het niet invult, toont het formulier "Vul een label van maximaal 60 tekens in." (de mobiele app noemt het veld **Label (verplicht)**).

| Veld | Regels |
| --- | --- |
| Platform | Instagram, Facebook, X, LinkedIn, YouTube, TikTok, Pinterest, Threads, Bluesky, Snapchat, WhatsApp, Telegram, GitHub, Behance, Dribbble, Vimeo, Reddit, Discord, Mastodon, Twitch, Spotify, Medium of Overig. |
| URL | Moet met `https://` beginnen ("De URL moet met https:// beginnen."). De host moet bij het platform horen ("De URL hoort niet bij dit platform."); subdomeinen zoals `www.` of `nl.` zijn prima. Mastodon en Overig accepteren elke host, omdat Mastodon-servers een eigen domein hebben. |
| Label | Optioneel, maximaal 60 tekens. Verplicht voor **Overig** ("Vul een label van maximaal 60 tekens in."). |

Een URL wordt ook geweigerd als hij spaties of andere witruimte bevat, een backslash, of een gebruikersnaam of wachtwoord vóór de host (`https://user@host`). Dezelfde regels draaien op de server, dus de API weigert wat het formulier weigert. De hosts die elk platform accepteert:

| Platform | Toegestane hosts |
| --- | --- |
| Instagram | instagram.com |
| Facebook | facebook.com, fb.com |
| X | x.com, twitter.com |
| LinkedIn | linkedin.com |
| YouTube | youtube.com, youtu.be |
| TikTok | tiktok.com |
| Pinterest | pinterest.com, pin.it, pinterest.nl, pinterest.co.uk, pinterest.de |
| Threads | threads.net, threads.com |
| Bluesky | bsky.app |
| Snapchat | snapchat.com |
| WhatsApp | wa.me, whatsapp.com |
| Telegram | t.me, telegram.me |
| GitHub | github.com |
| Behance | behance.net |
| Dribbble | dribbble.com |
| Vimeo | vimeo.com |
| Reddit | reddit.com |
| Discord | discord.gg, discord.com |
| Twitch | twitch.tv |
| Spotify | open.spotify.com, spotify.com |
| Medium | medium.com |
| Mastodon, Overig | elke host |

De links bereiken je website via het openbare [endpoint voor het bedrijfsprofiel](/nl/api/getting-started/business) (`GET /v1/api/business`).

### Handtekening uploaden

1. Open **Instellingen**, ga naar **Bedrijf** en scrol naar **Ondertekening**.
2. Klik op **Handtekening uploaden** en kies een afbeelding (PNG, JPEG, WebP of AVIF).
3. De afbeelding wordt geüpload als privé-media en direct aan het profiel gekoppeld; er is geen aparte opslagstap voor de handtekening.

De voorvertoning van de handtekening gebruikt een kortlevende ondertekende URL; het is geen publieke link. Klik op **Verwijderen** om de handtekening los te koppelen (het onderliggende bestand wordt niet verwijderd).

### De rest van het profiel opslaan

1. Bewerk velden in de andere vakken.
2. Klik op **Opslaan** in de balk onderaan. **Bedrijfsprofiel opgeslagen.** verschijnt bovenaan de sectie, boven de statuspillen. Mislukt het opslaan, dan staat de foutmelding op dezelfde plek.

Foutmeldingen op veldniveau verschijnen onder het bijbehorende veld; elke andere foutmelding verschijnt onderaan het vak **Contenttalen**.

## Nummering

De sectie **Nummering** bepaalt hoe nummers van offertes, facturen, creditnota's en bestellingen worden opgebouwd. Ze bestaat uit twee vakken: **Documenttypes** en **Nummerreeksen**.

### Documenttypes

Een documenttype is een korte naam met een voorvoegsel dat nummerreeksen kunnen overnemen. Een type `Bouw` met voorvoegsel `B` laat een factuurreeks bijvoorbeeld `B2026-0811` opleveren.

1. Open **Instellingen** en ga naar **Nummering**.
2. Vul **Naam** en **Voorvoegsel** in en klik op **Toevoegen**.
3. Gebruik **Bewerken** op een rij om het aan te passen, of **Verwijderen** om het te verwijderen.

| Veld | Omschrijving |
| --- | --- |
| Naam | Vrije tekst, maximaal 100 tekens. |
| Voorvoegsel | 1 tot 3 tekens, alleen hoofdletters en cijfers (`A-Z`, `0-9`). Uniek binnen je werkruimte. |

Een type waar een nummerreeks naar verwijst kun je niet verwijderen: je krijgt **Dit documenttype wordt gebruikt door een nummerreeks en kan niet worden verwijderd.** Wijs de reeks eerst een ander type toe. Om dezelfde reden ligt de prefix vast: zolang een reeks het type gebruikt krijg je **Dit documenttype wordt gebruikt door een nummerreeks; de prefix kan niet meer wijzigen.** Naam en sorteervolgorde blijven wel aanpasbaar.

### Nummerreeksen

Een reeks vertaalt een lopende teller naar het nummer dat een document echt draagt. Klik op **Nieuwe reeks** om er een toe te voegen, of op **Bewerken** bij een rij.

| Veld | Omschrijving |
| --- | --- |
| Geldt voor | **Offertes**, **Facturen**, **Creditnota's** of **Bestellingen**. |
| Documenttype | Een documenttype, of **Elk type** voor een reeks die niet aan een type vastzit. |
| Voorvoegsel | Optioneel, 1 tot 8 tekens (`A-Z`, `0-9`, `-`). Overschrijft het voorvoegsel van het documenttype. |
| Formaat | Het nummersjabloon. Moet `{SEQ}` bevatten. Andere tokens: `{PREFIX}`, `{YYYY}`, `{YY}`, `{MM}`. |
| Aantal cijfers | 1 tot 8. Hoe breed `{SEQ}` met nullen wordt aangevuld. |
| Herstart | **Nooit**, **Jaarlijks** of **Maandelijks**. Wanneer de teller opnieuw begint. |
| Weergave | **Normaal**, of **Maandelijkse offset (verbergt volume)** zodat de nummers niet verraden hoeveel documenten je uitgeeft. Maandelijkse offset vereist een maandelijkse herstart. |
| Standaard | De reeks die wordt gebruikt als niets specifiekers past. Eén standaard per combinatie **Geldt voor** + **Documenttype**; een nieuwe markeren degradeert de oude. |

Het formaat moet het token bevatten waarop de reset draait, anders komt hetzelfde nummer de volgende periode terug: een maandelijkse reset heeft `{MM}` plus een jaartoken (`{YYYY}` of `{YY}`) nodig, een jaarlijkse reset een jaartoken.

De tabel toont bij elke reeks het **Volgend nummer**: wat het volgende document zou krijgen, zonder het te verbruiken. Bij het bewerken van een opgeslagen reeks kies je onder **Voorbeeld** ook een datum om te zien welk nummer die datum oplevert.

### Reeksen die al nummers hebben uitgegeven

Zodra een reeks een nummer heeft uitgegeven, is hij vergrendeld: de rij toont het label **In gebruik** en in het formulier zijn alle velden behalve **Standaard** uitgeschakeld met **Er zijn al nummers uitgegeven; alleen de standaardmarkering kan nog wijzigen.** De knop **Verwijderen** is uitgeschakeld (bij hoveren zie je **Deze reeks heeft al nummers uitgegeven en kan niet worden verwijderd.**). Maak in plaats daarvan een nieuwe reeks en zet die op standaard.

## Belastingen

De sectie **Belastingen** bevat de BTW-tarieven van het bedrijf. Belastingklassen zijn core: elk bedrijf heeft ze, of de Webshop-module nu aan staat of niet. Een nieuw bedrijf begint met drie Nederlandse standaarden: **Standaard 21%** (de standaardklasse), **Verlaagd 9%** en **Nultarief 0%**. Je kunt ze hernoemen, van tarief wijzigen of verwijderen.

### Prijzen inclusief BTW

De schakelaar **Prijzen inclusief BTW**, bovenaan het vak **Belastingen**, bepaalt of catalogusprijzen bij het afrekenen als BTW-inclusief worden behandeld. Hij wordt opgeslagen zodra je hem omzet en gebruikt de opslaanbalk niet. Hij verschijnt alleen als de Webshop-module voor het bedrijf is ingeschakeld, want de instelling hoort bij het afrekenen.

### Belastingklassen

Belastingklassen definiëren de BTW-tarieven die je aan producten en offerteregels kunt toewijzen.

1. Voer in de rij **Nieuwe BTW-klasse** een **Naam** en een **Tarief %** in (0 tot 100; een komma werkt als decimaalteken).
2. Klik op **Toevoegen**.

Om een klasse te wijzigen kies je **Bewerken** in het **⋯**-menu van de rij; de rij boven de tabel wordt **BTW-klasse bewerken** met de knoppen **Opslaan** en **Annuleren**.

De standaard belastingklasse is anders: de rij toont een `standaard`-badge, heeft geen **⋯**-menu en geen selectievakje, en kan vanaf dit scherm niet worden bewerkt of verwijderd.

Niet-standaardklassen verwijder je door ze met de selectievakjes te selecteren en de bulkactie **Verwijderen** te gebruiken (vraagt om bevestiging).

## Activiteit

De sectie **Activiteit** is een alleen-lezen auditlog: een overzicht van wijzigingen in deze werkruimte, inclusief acties die Borkol-support namens jou heeft uitgevoerd.

Elke rij toont:

| Kolom | Beschrijving |
| --- | --- |
| Wanneer | Datum en tijd van de actie. |
| Actie | Wat er is gebeurd, in gewone taal. |
| Doel | Het record waarop de actie betrekking had (bijvoorbeeld een modelnaam met nummer), of een streepje. Verborgen op kleine schermen. |

Rijen die door Borkol-medewerkers namens jou zijn uitgevoerd dragen een **Borkol-support**-badge; als je erover zweeft zie je "Uitgevoerd door een Borkol-beheerder namens jou".

### Het log filteren en doorbladeren

- **Actie**-filter: typ een deel van een actienaam (bijvoorbeeld `module`) om de lijst te verfijnen. Het filter wordt toegepast terwijl je typt.
- De datumfilters **Van** en **Tot** beperken het log tot een datumbereik.
- Als je een filter wijzigt, ga je terug naar pagina 1.
- Gebruik **Vorige** en **Volgende** om door de resultaten te bladeren. De voettekst toont het totale aantal en op welke pagina je bent.

Een leeg log toont **Nog geen activiteit.**