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.

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; verzending en de overige winkelinstellingen staan in Winkelinstellingen.

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. Wie de storefront bouwt, gebruikt dit token zoals beschreven in de API-referentie onder Authenticatie.

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.