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

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

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.