Werkruimte

Werkruimte-instellingen

Bewerk je accountgegevens, wijzig je wachtwoord en bekijk het activiteitenlog van de werkruimte.

Bekijk als Markdown

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.
VeldBeschrijving
NaamJe weergavenaam. Verplicht.
E-mailAlleen-lezen. Het veld is uitgeschakeld; neem contact op met support om je e-mailadres te wijzigen.
TelefoonOptioneel. Wordt gewist als je het leegmaakt.
BedrijfsnaamOptioneel. Wordt gewist als je het leegmaakt.
BedrijfstypeOptionele 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:

PilCompleet wanneer
Juridische identiteitJuridische naam, straat, postcode, plaats, land en registratienummer zijn allemaal ingevuld.
OndertekeningNaam ondertekenaar én een handtekeningafbeelding zijn beide ingesteld.
AfzenderAfzender-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):

VakVelden
Juridische identiteitJuridische naam, Handelsnaam
AdresStraat, Nummer, Postcode, Plaats, Land (2-letterige code, bijv. NL)
Fiscale nummersKvK-nummer, BTW-nummer, Loonheffingennummer
BankIBAN, BIC, Banknaam
OndertekeningNaam ondertekenaar, Handtekening
AfzenderNaam afzender, E-mail afzender, E-mail, Telefoon, Website
DocumentstandaardenGeldigheid offerte (dagen), Betaaltermijn (dagen), Documenttaal, Valuta, Algemene voorwaarden, Voettekst factuur
ContenttalenDe talen waarin je Objecten-content is geschreven; zie hieronder
Sociale linksPlatform, 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).

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 voor wat dit in Objecten verandert.

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)).

VeldRegels
PlatformInstagram, Facebook, X, LinkedIn, YouTube, TikTok, Pinterest, Threads, Bluesky, Snapchat, WhatsApp, Telegram, GitHub, Behance, Dribbble, Vimeo, Reddit, Discord, Mastodon, Twitch, Spotify, Medium of Overig.
URLMoet 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.
LabelOptioneel, 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:

PlatformToegestane hosts
Instagraminstagram.com
Facebookfacebook.com, fb.com
Xx.com, twitter.com
LinkedInlinkedin.com
YouTubeyoutube.com, youtu.be
TikToktiktok.com
Pinterestpinterest.com, pin.it, pinterest.nl, pinterest.co.uk, pinterest.de
Threadsthreads.net, threads.com
Blueskybsky.app
Snapchatsnapchat.com
WhatsAppwa.me, whatsapp.com
Telegramt.me, telegram.me
GitHubgithub.com
Behancebehance.net
Dribbbledribbble.com
Vimeovimeo.com
Redditreddit.com
Discorddiscord.gg, discord.com
Twitchtwitch.tv
Spotifyopen.spotify.com, spotify.com
Mediummedium.com
Mastodon, Overigelke host

De links bereiken je website via het openbare endpoint voor het bedrijfsprofiel (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.
VeldOmschrijving
NaamVrije tekst, maximaal 100 tekens.
Voorvoegsel1 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.

VeldOmschrijving
Geldt voorOffertes, Facturen, Creditnota's of Bestellingen.
DocumenttypeEen documenttype, of Elk type voor een reeks die niet aan een type vastzit.
VoorvoegselOptioneel, 1 tot 8 tekens (A-Z, 0-9, -). Overschrijft het voorvoegsel van het documenttype.
FormaatHet nummersjabloon. Moet {SEQ} bevatten. Andere tokens: {PREFIX}, {YYYY}, {YY}, {MM}.
Aantal cijfers1 tot 8. Hoe breed {SEQ} met nullen wordt aangevuld.
HerstartNooit, Jaarlijks of Maandelijks. Wanneer de teller opnieuw begint.
WeergaveNormaal, of Maandelijkse offset (verbergt volume) zodat de nummers niet verraden hoeveel documenten je uitgeeft. Maandelijkse offset vereist een maandelijkse herstart.
StandaardDe 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:

KolomBeschrijving
WanneerDatum en tijd van de actie.
ActieWat er is gebeurd, in gewone taal.
DoelHet 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.