Documentatie

Overzicht

Koppel verbindt één Shopify-winkel met de Bol-marktplaats (primair Nederland, secundair België). De app synchroniseert aanbiedingen, voorraad en prijzen naar Bol, importeert Bol-bestellingen in Shopify, stuurt tracking terug en toont je retouren. Shopify blijft de bron van waarheid voor je catalogus en voorraad.

Alle communicatie met Bol verloopt op de achtergrond via een taakwachtrij. Na elke schrijfactie naar Bol controleert Koppel de verwerkingsstatus tot die klaar is, zodat je altijd een betrouwbaar beeld hebt.

Bol verbinden

Je verbindt je Bol-verkoopaccount met je eigen Bol API-sleutels (Client ID en secret) uit je Bol-verkoopomgeving. Koppel wisselt deze veilig in voor een toegangstoken en vernieuwt dat automatisch. Je kunt kiezen tussen de demo- en productie-omgeving van Bol.

Economic operator

Sinds 1 februari 2025 verplicht Bol een geldige economic operator (verantwoordelijke marktdeelnemer) bij elke aanbieding. Je stelt deze eenmalig in met naam, adres en contactgegevens. Bol valideert de gegevens; pas bij status geldig kun je publiceren. Zolang er geen geldige operator is, blokkeert Koppel publiceren.

EAN & aanbiedingen

Een aanbieding op Bol vereist een geldige EAN (het barcodeveld van je Shopify-variant). Op de pagina Producten naar Bol toont Koppel per variant of de EAN Klaar is of ontbreekt. Publiceren gebeurt door een aanbieding te koppelen aan een bestaand Bol-catalogusitem op basis van de EAN.

Producten zonder geldige EAN worden geblokkeerd voor publicatie, zodat je geen ongeldige aanbiedingen aanmaakt.

Voorraad

Shopify is leidend voor voorraad. Wanneer de voorraad van een gepubliceerde variant in Shopify wijzigt, werkt Koppel de bijbehorende Bol-aanbieding bij. Met een voorraadbuffer houd je een marge aan (Koppel trekt de buffer af voordat het aantal naar Bol gaat). Koppel voorkomt echo-loops, zodat een terugkomende wijziging niet opnieuw wordt weggeschreven.

Prijzen & btw

Bol-prijzen zijn consumentenprijzen en dus inclusief btw. Koppel bepaalt eerst of je Shopify-prijs netto of bruto is (op basis van je Shopify-instelling of een handmatige override), past je prijsregel toe en telt waar nodig het btw-tarief erbij (standaard 21% voor NL/BE).

Een prijsregel bestaat uit: type (doorgeven, percentage-opslag of vast bedrag), afronding (bijv. eindigend op .99 of .95) en een optionele bodem- en plafondprijs. Zo houd je grip op je marge.

Bestellingen

Bol-bestellingen worden precies één keer geïmporteerd als een normale Shopify-order, met de klant- en verzendgegevens. FBR-bestellingen verlagen je Shopify-voorraad (die is leidend). FBB-bestellingen worden alleen ter inzage geïmporteerd — Bol beheert die voorraad zelf, dus Koppel raakt je Shopify-voorraad daarvoor niet aan.

Verzending & tracking

Maak je in Shopify een verzending aan met een track & trace-code, dan zet Koppel de bijbehorende vervoerder om naar de juiste Bol-transporteur en meldt de zending met tracking bij Bol. In v1 wordt de hele bestelling in één keer verzonden; deelverzendingen volgen later.

Retouren

Open Bol-retouren verschijnen onder Retouren, met reden en aantal. Per retour kies je goedkeuren (retour ontvangen) of afwijzen (voldoet niet aan de voorwaarden). Koppel geeft je beslissing door aan Bol en toont afgehandelde retouren met het resultaat.

Synchronisatie

Alle Bol-acties lopen via een taakwachtrij die op de achtergrond wordt verwerkt. Op de pagina Synchronisatie zie je hoeveel taken in de wachtrij staan, welke zijn mislukt (met een begrijpelijke foutmelding en het aantal pogingen) en wanneer er voor het laatst is gesynchroniseerd. Mislukte taken probeer je per stuk of allemaal opnieuw. Mislukkingen worden automatisch opnieuw geprobeerd met oplopende wachttijd.

Repricer

De repricer (beschikbaar op Pro) past je Bol-prijs automatisch aan binnen grenzen die jij bepaalt. Per aanbieding stel je een minimum- en maximumprijs in, en met hoeveel je de laagste concurrent wilt onderbieden. De repricer gaat nooit onder je minimumprijs en prijst op je maximum wanneer er geen concurrentie is.

Abonnementen

• Free — alleen-lezen. Verbind Bol, bekijk bestellingen en retouren, controleer EAN-gereedheid. De sync staat uit.
• Starter ($19/mnd) — zet de automatische sync aan: publiceren, voorraad- en prijssync, tracking, retouren afhandelen, prijs- en btw-regels, tot 1.000 SKU's, 1 Bol-account.
• Pro ($39/mnd) — alles uit Starter, plus de repricer, onbeperkt SKU's, tot 5 Bol-accounts en geavanceerde prijsregels.

Vaste prijs per maand, geen kosten per bestelling of per artikel. Starter en Pro hebben 14 dagen gratis proberen. Zie de prijzenpagina.

Privacy & beveiliging

Je Bol-tokens worden versleuteld opgeslagen (AES-256-GCM). Koppel draait op Europese hosting met versleutelde back-ups. Koppel honoreert de verplichte Shopify-privacywebhooks (data-inzage, verwijdering en het wissen bij deïnstallatie). Lees meer in ons privacybeleid en op de beveiligingspagina.