# Bol.com WordPress plugin

# Introductie

Welkom bij de handleiding van de Bol.com WordPress plugin.

## Features

- Koppeling met Bol.com.
- Uitbreidbaar met add-ons voor passend gebruikt.
- Bestellingen, verzendingen en retouren in WordPress beheren.
- Verzendlabels van Bol. downloaden.
- Inzicht in winkel statistieken van de afgelopen 7 dagen.

**WooCommerce addon**

- Verwerken van Bol. orders in de WooCommerce bestellingen.
- Product koppeling op basis van EAN of SKU.
- Automatisch verzendingen aanmaken in Bol. vanuit jouw fulfilment partij.
- Voorraad synchronisatie.

**Facturen addon**

- Automatische facturen voor Bol. orders.
- Beheer van opmaak van de facturen.

<div id="bkmrk-"><div>  
</div></div>## Installatie

<p class="callout warning">Als je een versie gelijk aan, of nieuwer dan v1.1.0 installeert heb je de PDO Extensie nodig voor PHP en de bijbehorende MySQL driver. Als je niet weet wat dit inhoud, neem dan contact op met je hosting partij.</p>

Vereisten

- **WordPress**: 5.9.3 of hoger
- **PHP:** 8.1 of hoger

Installeer de plugin door de plugin bestanden naar `/wp-content/plugins` te uploaden. Activeer de plugin vervolgens vanuit de WordPress admin.

<p class="callout info">Bij de aanschaf van de plugin heb je een licentiecode verkregen. Het is van belang dat deze wordt ingevoerd om de plugin zonder restricties te laten werken en bij te kunnen blijven werken naar de meest recente versie.</p>

---

Tussendoor Internet &amp; Marketing

**e.** <info@tussendoor.nl>  
**w.** [http://www.tussendoor.nl](http://www.tussendoor.nl)

# Snelle Start

**Stap 1 - Basis instellen**

1. Activeer de hoofdplugin
2. Vul Client ID en Client Secret van Bol.com in
3. Sla instellingen op

**Stap 2 - Orders en retouren**

1. Zet orderimport aan
2. Zet retourimport aan als je retouren wilt bijhouden
3. Kies of je alleen gewijzigde orders wilt ophalen

**Stap 3 - WooCommerce koppeling (optioneel)**

1. Activeer WooCommerce Add-on
2. Zet Bol orders in WooCommerce opslaan aan
3. Stel productkoppeling in op SKU of EAN
4. Controleer verzending- en stock-sync instellingen

**Stap 4 - Voorraadbeheer (optioneel)**

1. Activeer Voorraad Add-on
2. Zet voorraadmonitoring aan
3. Vul e-mailadres in voor lage voorraadmeldingen
4. Stel per product de drempelwaarden in

**Stap 5 - Facturen (optioneel)**

1. Activeer Invoice Add-on
2. Vul verplichte shopvelden in
3. Kies thema en stijl
4. Test met preview
5. Gebruik handmatige of automatische upload

# Instellingen

De Bol.com plugin voor WordPress heeft één dashboard waar je de hele plugin kunt beheren. Navigeer binnen WordPress naar het menu item **bol.com** en je zal het dashboard zien.

Plugin voorbeeld

[![afbeelding.png](https://doc.tussendoor.nl/uploads/images/gallery/2024-12/scaled-1680-/h1Aafbeelding.png)](https://doc.tussendoor.nl/uploads/images/gallery/2024-12/h1Aafbeelding.png)

Account

Om jouw WordPress website toegang te geven dien je toegangsgegevens op te slaan binnen de instellingen van onze plugin. Deze gegevens worden veilig opgeslagen in de database van jouw website waardoor anderen daar niet bij kunnen. Het aanmaken van deze gegevens doe je binnen Bol.com. Ga daarvoor naar het partner platform van Bol:  
[https://partner.bol.com/sdd/home/](https://partner.bol.com/sdd/home/)

En navigeer naar de instellingen van je account. Onder Diensten -&gt; API instellingen kan je vervolgens de gegevens aanmaken die benodigd zijn. Klik daarvoor onder "Client credentials voor de Retailer API" op "aanmaken" en geef daar een naam op waarmee jij kan herkennen dat de gegevens worden aangemaakt voor jouw WordPress website.

**Client ID**  
Na het aanmaken van de nieuwe gegevens zie je onder "Client credentials voor de Retailer API" jouw nieuwe credentials achter de naam die je in de vorige stap hebt opgegeven. De "Client ID" kan je overnemen uit de tabel.

**Client Secret**  
Na het aanmaken van de nieuwe gegevens zie je onder "Client credentials voor de Retailer API" jouw nieuwe credentials achter de naam die je in de vorige stap hebt opgegeven. De "Client Secret" kan je overnemen door op "toon secret" te klikken in de tabel.

Algemeen

**Persoonsgegevens**  
De persoonsgegevens van jouw klanten worden opgeslagen in de database van jouw WordPress website. Met deze instelling kan je aangegeven na welk termijn je de persoonsgegevens wil verwijderen. De bestellingen worden wél bewaard voor het kunnen tonen van juiste statistieken, puur de persoonsgegevens worden verwijderd.

**Belangrijkste instellingen uitgelegd**

**Hoofdplugin instellingen**

1. Client ID en Client Secret: nodig voor API-koppeling met Bol.com
2. Bewaartijd persoonsgegevens: na deze periode worden persoonsgegevens geanonimiseerd
3. Importeer orders: zet orderimport aan of uit
4. Importeer alleen gewijzigde: haalt alleen nieuwe/gewijzigde orders op
5. Import status: bepaalt welke orderstatussen worden opgehaald
6. Importeer retouren: zet retourimport aan of uit
7. Verwijder data bij deactivatie: verwijdert plugingegevens bij deactiveren

**WooCommerce instellingen**

1. Bol orders in WC opslaan: maakt WooCommerce-orders van Bol-bestellingen
2. Update Woo status from Bol: houdt orderstatus gelijk met Bol-status
3. WC notificaties uitschakelen: voorkomt standaard WooCommerce ordermails
4. Splits FBB/FBR items: splitst gemixte orders in aparte Woo-orders
5. Koppel op basis van: niet koppelen, SKU of EAN
6. EAN locatie: waar de plugin de EAN moet zoeken
7. Automatisch verzendingen maken: maakt verzending op Bol bij gekozen Woo-status
8. Stock synchronisation: stuurt voorraadwijzigingen naar Bol.com
9. Product Import: haalt Bol-producten naar WooCommerce
10. Product Export: stuurt WooCommerce-producten naar Bol.com

**Voorraad instellingen**

1. Voorraad producten bijhouden: zet monitoring aan/uit
2. Notificatie e-mail: adres voor lage voorraadmeldingen
3. Onderwerp lage voorraad: onderwerpregel van meldingsmail
4. Koppel op basis van EAN: productmatching met WooCommerce
5. Per product lage voorraad drempel: wanneer melding wordt verstuurd
6. Per product fulfilment drempel: wanneer van FBB naar FBR wordt geschakeld
7. Levertijd per product: FBR delivery code per product

**Factuur instellingen**

1. Velden verbergen: kies welke velden niet op de PDF komen
2. Thema kiezen: selecteer factuurtemplate
3. Logo uploaden: eigen logo op factuur
4. Header/footer kleuren: stijl van de PDF
5. Shopgegevens: bedrijfsdata op de factuur
6. Automatic invoicing: automatisch uploaden na verzending
7. Automation preference: 
    1. Always: altijd factuur uploaden
    2. Business: alleen wanneer btw-nummer aanwezig is
    3. Consumers: alleen wanneer btw-nummer ontbreekt

Orders

**Importeer orders**  
Met deze checkbox kan je aangeven of je wil dat de plugin orders gaat verwerken vanuit Bol. in jouw WordPress website.

**Importeer alleen gewijzigde**  
Wanneer deze checkbox wordt geactiveerd dan worden alleen orders geïmporteerd die:

- Nieuw zijn;
- Een verzonden item bevatten;
- Een annuleringsverzoek bevatten.

**Import status**  
Bepaalt de status van de orders die opgehaald worden. "Alle" haalt zowel behandelde als onbehandelde orders op vanuit Bol.com

<p class="callout info">We adviseren om deze instelling op "Alle" te laten staan, zo voorkom je dat je orders mist die behandeld zijn voordat deze geïmporteerd zijn.</p>

Retouren

**Importeer retouren**  
Met deze checkbox kan je aangeven of je wil dat de plugin retouren gaat verwerken vanuit Bol. in jouw WordPress website.

Geavanceerd

**Verwijder data**  
Met deze checkbox kan je aangeven of je wil dat alle plugin data wordt opgeschoond bij **deactivatie** van de plugin.

<p class="callout info">Standaard wordt de plugin data opgeschoond wanneer de plugin wordt **verwijderd** via de WordPress admin.</p>

# WooCommerce addon

Vereisten

- **WordPress**: 5.9.3 of hoger
- **PHP:** 8.0

De WooCommerce addon voor de Bol.com WordPress plugin haakt in op de hoofd plugin. Zowel qua functionaliteiten als met de instellingen. Zo heeft de WooCommerce addon niet een eigen plugin pagina binnen WordPress maar worden er nieuwe instellingen binnen het bestaande dashboard ingeladen.

Voorbeeld instellingen

[![afbeelding.png](https://doc.tussendoor.nl/uploads/images/gallery/2024-12/scaled-1680-/bNOafbeelding.png)](https://doc.tussendoor.nl/uploads/images/gallery/2024-12/bNOafbeelding.png)

WooCommerce instellingen

**Bol orders in WC opslaan**  
Met deze checkbox bepaal je simpelweg of je wil dat de bestellingen uit Bol. in het WooCommerce bestel overzicht wil verwerken. Bij normaal gebruik van deze addon zal deze checkbox altijd aan staan, maar mocht je wat willen testen dan kan het handig zijn om het verwerken van de bestellingen (tijdelijk) uit te zetten.

**WC notificaties uitschakelen**  
WooCommerce stuurt standaard e-mails naar het e-mailadres dat is gekoppeld aan de bestelling, maar Bol. doet dit ook. Met het activeren van deze instelling voorkom je dat WooCommerce e-mail stuurt en voorkom je dat de eindklant te veel mails ontvangt omtrent de bestelling.

**Splits FBB/FBR items**  
Binnen één Bol. bestelling kan het voorkomen dat het ene item FBB betreft en een ander item FBR. Dit betekent dat het ene item door Bol. verwerkt wordt (FBB) en dat het andere item door jou (de verkoper) verwerkt dient te worden (FBR). Met deze instelling kan je de items van 1 bestelling splitsen in 2 bestellingen in WooCommerce. In combinatie met de **FBB order status** instelling wordt het dan eenvoudiger om te zien welke bestellingen je zelf (of je fulfilment partner) nog moet verwerken.

**FBB order status**  
Deze instelling is alleen beschikbaar wanneer de instelling **Splits FBB/FBR items** wordt gebruikt. Met deze instelling bepaal je de status van de FBB bestelling in WooCommerce. Aangezien Bol. alles voor je afhandelt voor een FBB item / bestelling adviseren we om deze in te stellen op "afgerond". Je herkent dan eenvoudig dat voor deze bestelling geen handelingen meer benodigd zijn.

Producten koppelen

Deze instellingen zijn van toepassing bij het creëren van een WooCommerce bestelling. Bij het toevoegen van de items geven we de voorkeur aan het koppelen van een WooCommerce product aan de bestelling omdat WooCommerce dan de informatie in de bestelling bepaalt. Dit kan natuurlijk alleen wanneer er een WooCommerce product bestaat die exact overeenkomt met het product dat besteld is in Bol. Met de instellingen kunnen we dynamisch het juiste product zoeken in WooCommerce. Wanneer er geen match gevonden wordt dan wordt de informatie uit de Bol. bestelling overgenomen en in de WooCommerce bestelling geplaatst.

**Koppel o.b.v.**  
Met deze instelling bepaal je op basis van welke waarde in WooCommerce de product koppeling opgezet kan worden tussen het Bol. product en het WooCommerce product.

- SKU: Op basis van de **interne referentie** in Bol. wordt er in WooCommerce een product gezocht met deze SKU.
- EAN: Op basis van de **EAN** in Bol.wordt er in WooCommerce een product gezocht met deze EAN.

**Kies EAN locatie**  
Vóór versie 9.1.0 had WooCommerce geen specifiek EAN veld en was er dus geen mogelijkheid om een product koppeling op te zetten op basis van deze waarde. Toch willen we deze functionaliteit vanuit de plugin aanbieden en daar komt deze instelling bij kijken. Je hebt de mogelijkheid uit 3 opties:

- Plugin EAN veld: Onze plugin creëert en verwerkt een nieuwe veld bij producten die specifiek gebruikt kan worden om de EAN in op te slaan.
- WooCommerce SKU veld: Hiermee geef je als gebruiker aan dat je de EAN waarde opslaat in het SKU veld van WooCommerce.
- Custom product meta: Met deze optie geef je aan dat de EAN al wordt opgeslagen in de product data. Mogelijk doe je dit met een andere plugin of met het native WooCommerce veld (&gt;= 9.1.0). Na het kiezen van deze optie kan je de meta\_key opgeven waarmee de plugin de EAN kan vinden in de database.

<p class="callout info">Sla de key <span class="code">\_global\_unique\_id</span> op als custom EAN meta key om het nieuwe WooCommerce veld te gebruiken.</p>

Order verzending

**Ik maak gebruik van FBR**  
Met deze instelling kan je aangeven of je (een deel van) je eigen bestellingen zelf verwerkt. Door deze checkbox aan te vinken maak je meer instellingen beschikbaar.

**Automatisch verzendingen maken** Met deze instelling bepaal je of automatisch verzendingen wil aanmaken in Bol. op basis van informatie die gevonden wordt in de WooCommerce bestelling. Denk hierbij bijvoorbeeld aan een Track and Trace code. De plugin kan hiervoor koppelen met verschillende fulfilment partners.

**Maak verzending in Bol op status** Bepaalt het moment dat de automatische actie van de plugin wordt ingezet om een verzending aan te maken in Bol. voor een bestelling binnen WooCommerce. De plugin luistert hiervoor naar de bestelstatus van de bestelling.

**Eigen kenmerk**  
Deze instelling bepaalt wat de plugin verwerkt als "eigen kenmerk" binnen de data van de verzending. Hiermee kan je in Bol. een verzending eenvoudig herkennen.

Mijn fulfilment partner(s)

Geef met een checkbox aan van welke fulfilment partners je binnen jouw WooCommerce shop al gebruik maakt. Door dit aan te geven kan de plugin automatisch de juiste gegevens ophalen om daarmee een verzending aan te maken.

Onder "Beta" vind je "MyParcel". Deze fulfilmentpartner biedt uitgebreide functionaliteiten en we hebben nog niet alle mogelijke scenario's kunnen testen. Gebruik deze dus op eigen risico. Feedback op het gebruik van deze fulfilmentpartner is gewenst.

Voorraad synchronisatie

Bij het gebruik van deze instellingen zorg je er voor dat de voorraad vanuit WooCommerce gesynchroniseerd blijft met de voorraad in Bol. De instellingen onder **Product koppeling** worden gebruikt om het juiste product in Bol. bij te werken.

Let op. We kunnen alleen van WooCommerce náár Bol. communiceren, maar omdat de plugin wél orders ontvangt en verwerkt vanuit Bol in WooCommerce kan de voorraad synchronisatie wel beide kanten op werken.

Bijvoorbeeld: Wanneer een Bol. bestelling een product bevat die in WooCommerce bestaat (opnieuw wordt voor deze koppeling de instellingen onder **Product koppeling** gebruikt), dan wordt de voorraad van dat product bijgewerkt in WooCommerce. De bijgewerkte voorraad in WooCommerce wordt later weer gesynchroniseerd in Bol. met onderstaande instellingen.

**Sync tijd** Met deze instelling geef je aan op welk moment van de dag de voorraad van de WooCommerce producten worden gesynchroniseerd richting Bol. Dit wordt alleen gedaan voor WooCommerce producten waarvan de voorraad daadwerkelijk is gewijzigd.

<p class="callout info">We werken op 1 moment van de dag de voorraad bij om de server van de webshop niet te veel te belasten.</p>

**Voorraad sync prioriteit** Slechts op 1 moment van de dag de voorraad in Bol. bijwerken kan voor problemen zorgen op het moment dat de voorraad te laag (of nul) wordt. Om te voorkomen dat je in Bol. een bestelling krijgt voor een product waar je geen voorraad meer van hebt kan je deze instelling gebruiken.

Met deze instelling geef je aan of de voorraad van een product met prioriteit moet worden bijgewerkt in Bol. op het moment dat het de **lage voorraaddrempel** overschrijdt. De lage voorraaddrempel is een [WooCommerce instelling.](https://woocommerce.com/document/configuring-woocommerce-settings/products/#:~:text=Low%20Stock%20Threshold%20%E2%80%93%20Enter%20the%20inventory%20count%20that%20will%20trigger%20a%20low%20stock%20notification.%20When%20product%20stock%20reaches%20this%20amount%20you%20will%20be%20notified%20via%20email%20if%20enabled.) Effectief houdt dit in dat de voorraad onmiddellijk wordt aangepast in Bol.

# Veelgestelde vragen

**Ik zie geen preview- of uploadknoppen bij facturen**

1. Controleer of de orderstatus SHIPPED is
2. Controleer of verplichte factuurvelden ingevuld zijn

**Automatische verzending naar Bol werkt niet**

1. Controleer of FBR aanstaat
2. Controleer of automatische verzending aanstaat
3. Controleer of een ondersteunde verzendpartner is geselecteerd

**Productkoppeling werkt niet goed**

1. Controleer of je op SKU of EAN koppelt
2. Controleer of de gekozen EAN-locatie klopt
3. Bij custom meta: controleer of de meta key exact juist is

**Lage voorraadmails komen niet binnen**

1. Controleer notificatie e-mailadres
2. Controleer of per product een drempel boven 0 staat
3. Controleer spamfolder en mailserver-instellingen

**Praktische tips**

1. Begin met alleen hoofdplugin + orderimport en test eerst klein
2. Schakel daarna pas WooCommerce ordermapping in
3. Gebruik productimport voordat je stock-sync volledig activeert
4. Test factuurpreview eerst met complete shopgegevens
5. Gebruik automatische flows pas nadat handmatige flow goed werkt