# Snelstart

Deze walkthrough brengt een gloednieuw bedrijf van leeg naar verkopend: één product, werkende belastingen en verzending, een API-sleutel voor je storefront en de eerste bestelling die op je dashboard binnenkomt. We gaan ervan uit dat de Commerce-module voor je bedrijf is ingeschakeld; staat er geen **Webshop**-item in de zijbalk, vraag dan je platformbeheerder.

## 1. Maak je eerste product aan

1. Open in de zijbalk **Catalogus** → **Producten**. Bij een vers bedrijf staat er "Nog geen producten" in de lijst.
2. Klik op **Nieuw product**. Het scherm vraagt **Wat verkoop je?**: kies **Product** (verkocht zoals het is, eventueel met opties zoals maat of kleur). **Op maat** wordt alleen aangeboden als de module Configurator is ingeschakeld.
3. Typ een **Naam** en klik op **Opslaan**. Het product wordt als concept aangemaakt en de productpagina opent.
4. Vul op de productpagina de basisgegevens in en klik één keer op **Opslaan** voor alles samen:

   | Veld | Waar | Omschrijving |
   | --- | --- | --- |
   | **Prijs** | Prijzen | Ingevoerd in hoofdeenheden (bijv. `19.99` of `19,99`); varianten kunnen hem overschrijven. |
   | **Eenheid** | Prijzen | **Stuk**, tenzij je per gewicht, lengte, oppervlakte, volume of tijd verkoopt. |
   | **SKU** | Voorraad & verzending | Je interne artikelnummer. |
   | **Voorraad bijhouden** / **Voorraad** | Voorraad & verzending | Met de module Voorraad: hoeveel je er hebt. Laat het aantal leeg om onbeperkt te verkopen. |
   | **Status** | Zijbalk | `Draft`, `Active` of `Archived`. Zet hem alleen op **Actief** als het product verkoopbaar moet zijn. |

   Opties zoals Maat met de waarden `S, M, L` voeg je toe in de kaart **Opties & varianten**; daar worden ook de varianten gegenereerd. De volledige rondleiding staat in [Producten beheren](/nl/docs/products/index).

De Aan-de-slag-checklist op het dashboard linkt hier ook naartoe via **Maak je eerste product aan**.

## 2. Stel belastingen en verzending in

Voordat een storefront kan afrekenen, heeft je bedrijf minstens een btw-klasse en een verzendmethode nodig.

1. Open **Instellingen** → **Belastingen**. Een nieuw bedrijf heeft al **Standaard 21%**, **Verlaagd 9%** en **Nultarief 0%**; voeg met **Nieuwe BTW-klasse** een eigen klasse toe als je die nodig hebt. Eén klasse is de standaard; producten gebruiken die tenzij je een andere kiest.
2. Open **Webshop** → **Instellingen** → **Verzending** en voeg een methode toe met **Nieuwe verzendmethode**. Prijzen zijn in je winkelvaluta; laat de drempel voor gratis verzending leeg als je geen gratis verzending aanbiedt.

Tip: het checklist-item **Belastingen & verzending instellen** op het dashboard opent direct de verzendpagina uit stap 2.

Alle details over belastingen staan in [Belastingen](/nl/docs/workspace/settings#belastingen); verzending en de overige winkelinstellingen staan in [Winkelinstellingen](/nl/docs/selling/store-settings).

## 3. Maak een API-sleutel voor je storefront aan

Je storefront (website, app of integratie) praat met Borkol via een API-sleutel die aan dit bedrijf is gekoppeld.

1. Open **Instellingen** in de sectie **Werkruimte** van de zijbalk en kies **API-sleutels** in de lijst met secties (of ga direct naar `/settings/api-keys`).
2. Voer in de kaart **Sleutel aanmaken** een sleutelnaam in (bijvoorbeeld `storefront`) en selecteer minstens één scope-pil. Scopes komen van je ingeschakelde modules: `tenant:read` plus een `:read`- en `:write`-scope per module (bijv. `commerce:read`, `commerce:write`).
3. Klik op **Aanmaken**. Het token verschijnt eenmalig in leesbare vorm, in een kaart met de titel "Kopieer dit token nu. Wordt maar één keer getoond."
4. Kopieer het token en bewaar het op een veilige plek. Het kan nooit meer worden bekeken; ben je het kwijt, trek de sleutel dan in en maak een nieuwe aan.

Meer over scopes en intrekken in [API-sleutels](/nl/docs/workspace/api-keys). Wie de storefront bouwt, gebruikt dit token zoals beschreven in de API-referentie onder [Authenticatie](/nl/api/getting-started/authentication).

## 4. Zie de eerste bestelling binnenkomen

Zodra je storefront live is en een klant afrekent:

- Het dashboard-startscherm toont de bestelling onder **Recente bestellingen**, en de kaarten **Bestellingen (14 dagen)**, **Bestellingen deze maand** en, zodra hij betaald is, **Omzet (14 dagen)** en **Omzet** worden bijgewerkt.
- De volledige lijst staat onder **Webshop** → **Bestellingen**; klik op een rij om de besteldetails te openen.
- Nieuwe bestellingen beginnen als `pending_payment` en doorlopen `paid`, `shipped` en `completed` (of `cancelled` / `refunded`).

Moet je integratie automatisch op bestellingen reageren in plaats van dat jij het dashboard ververst, voeg dan een webhook-endpoint toe onder **Instellingen** → **Webhooks**; dat kan `order.created`- en `order.status_changed`-gebeurtenissen ontvangen zodra ze plaatsvinden.