> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wisepim.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bol.com-integratie

> Koppel bol.com aan WISEPIM met client credentials voor de Retailer API. Stuur prijs, voorraad en productcontent per EAN. Alleen export, in beta.

Koppel je bol.com-verkopersaccount aan WISEPIM om aanbiedingen en productcontent naar de marktplaats te sturen vanuit de catalogus die je al bijhoudt. WISEPIM stelt de prijs en voorraad van elke aanbieding in op EAN en uploadt de titel, beschrijving, het merk en de hoofdafbeelding.

De connector is in beta en werkt maar in één richting: WISEPIM stuurt naar bol.com en importeert er nooit producten uit.

**Wat je ermee kunt bereiken:** verrijkte producten op bol.com publiceren zonder ze opnieuw in te typen in het Verkopersdashboard, terwijl nieuwe aanbiedingen in de wacht blijven tot je ze hebt gecontroleerd.

**Waar vind je het:** **Instellingen** > **Integraties**, daarna de tegel **bol.com**.

> [!NOTE]
>
> Je hebt een bol.com-verkopersaccount nodig met toegang tot het Verkopersdashboard, en een WISEPIM-project waarvan de producten een EAN hebben. De koppeling gebruikt OAuth-client credentials, dus je hoeft geen winkel-URL in te vullen.

## Client credentials aanmaken in het bol Verkopersdashboard

**1. Open de API-instellingen**

Log in op het bol Verkopersdashboard. Ga naar **Instellingen**, dan **Diensten**, dan **API instellingen**.

**2. Sla een technisch contactpersoon op**

bol vraagt om een technisch contactpersoon voordat het credentials uitgeeft. Vul die in als je dat nog niet hebt gedaan.

**3. Maak de credentials aan**

Kies onder **Client credentials voor de Retailer API** voor **Aanmaken**. bol toont een **Client ID** en een **Client secret**.

**4. Kopieer beide waarden**

Kopieer ze nu. WISEPIM slaat ze allebei versleuteld op en toont ze nooit meer, dus bewaar zelf een kopie op een veilige plek.

## Je credentials toevoegen aan WISEPIM

**1. Open Integraties**

Log in op WISEPIM en ga naar **Instellingen** > **Integraties**.

**2. Selecteer bol.com**

Zoek de tegel **bol.com** en klik erop. Die heeft een chip **Beta**.

**3. Vul de koppeling in**

* **Profielnaam**: een naam voor deze koppeling, zoals "bol NL".
* **Client ID** en **Client secret**: de waarden uit het Verkopersdashboard.
* **Send price and stock (offers)**: standaard aan. Zet het uit om je aanbiedingen met rust te laten.
* **Send product content (title, description, brand, main image)**: standaard aan.
* **Put offers up for sale (off keeps them on hold)**: standaard uit. Lees hieronder verder voordat je het aanzet.
* **Auto-create products on export**: maak een bol-aanbieding aan voor een EAN die er op je account nog geen heeft. Laat het uit om alleen bestaande aanbiedingen bij te werken.
* **Contenttaal**: `nl` wordt getoond in Nederland en Vlaanderen. Ook mogelijk: `nl-BE`, `fr` of `fr-BE`.
* **Primaire taal voor export**: de projecttaal waaruit WISEPIM de content leest. Leeg gebruikt de primaire taal van het project.

**4. Stel de standaardwaarden voor aanbiedingen in**

Die gelden voor aanbiedingen die WISEPIM aanmaakt, zie [Instellingen voor aanbiedingen](#instellingen-voor-aanbiedingen) hieronder.

**5. Test de verbinding**

Klik op **Integratie testen** om te bevestigen dat bol de credentials accepteert.

**6. Opslaan**

Als de test slaagt, klik je op **Opslaan**.

> [!TIP]
>
> Je bol.com-account is gekoppeld. Selecteer producten en exporteer ze naar bol.com zoals naar elk ander kanaal.

> [!WARNING]
>
> Het client secret geeft schrijftoegang tot je bol-aanbiedingen. Deel het nooit openbaar en zet het niet in versiebeheer. Denk je dat het is gelekt? Verwijder de credentials dan in het Verkopersdashboard en maak nieuwe aan.

## Wat een export doet

Elke export voert per product twee stappen uit. Zet een van beide uit in de koppeling als je alleen de andere nodig hebt.

| Stap | Wat WISEPIM verstuurt | Hoe bol het koppelt |
| - | - | - |
| **Aanbiedingen** | Prijs, voorraad en de wachtstatus. De prijs is de verkoopprijs na prijsregels, inclusief btw: de actieprijs als die actief is, anders de reguliere prijs. | Op EAN. De aanbiedings-ID die bol teruggeeft, wordt voor de volgende run op het product opgeslagen. |
| **Content** | Titel, beschrijving, merk en de hoofdafbeelding | Op EAN, als productcontent in de **Contenttaal** die je hebt gekozen. |

Een paar regels om te weten:

* **Een EAN is verplicht.** Een product zonder EAN, of met een fout controlecijfer, wordt geweigerd voordat WISEPIM bol aanroept. EAN-8- en UPC-codes worden aangevuld tot 13 cijfers, zoals bol vraagt.
* **Nieuwe aanbiedingen blijven in de wacht.** Staat **Put offers up for sale** uit, dan wordt elke aanbieding die WISEPIM aanmaakt of bijwerkt in de wacht gehouden, zodat er niets wordt verkocht voordat je het in het Verkopersdashboard hebt gecontroleerd. Zet je de schakelaar aan, dan zet elke export de aanbiedingen te koop.
* **Een nieuwe aanbieding verschijnt alleen met automatisch aanmaken aan.** Zonder die instelling wordt een EAN die op je account nog geen aanbieding heeft, overgeslagen.
* **De conditie is altijd nieuw.** Tweedehands en refurbished aanbiedingen horen niet bij deze connector.
* **Beschrijvingen worden teruggebracht tot de tags die bol toestaat.** Alinea's, regeleinden, vet, `h3`-koppen en lijsten blijven staan; andere HTML wordt verwijderd.
* **FAQ's staan standaard uit.** Het FAQ-formaat voor bol.com staat standaard op **Uit** onder **Instellingen** > **FAQ's**, dus de beschrijving bevat alleen producttekst.
* **Content wordt geaccepteerd en daarna verwerkt.** bol controleert geüploade content aan zijn eigen kant. Een product dat bol nog niet heeft verwerkt, staat als geaccepteerd gemeld, en de volgende export controleert het in plaats van opnieuw te uploaden.

> [!NOTE]
>
> Het ophalen van bestellingen van bol.com, dat [Analytics](https://docs.wisepim.com/nl/analytics/overview.md) gebruikt, is iets anders dan deze exportconnector. De exportkoppeling leest geen bestellingen, en de bestelfeed verandert je aanbiedingen niet.

## Instellingen voor aanbiedingen

De onderste helft van de koppeling bevat de waarden die bol voor je aanbiedingen nodig heeft. Fulfilment, levering en de landen worden verstuurd wanneer WISEPIM een aanbieding aanmaakt. De voorraadinstelling en de marktdeelnemer worden bij elke export verstuurd. Het formulier controleert elke waarde bij het opslaan, zodat een waarde die bol zou weigeren al voor de export wordt opgemerkt.

| Veld | Wat het doet |
| - | - |
| **Fulfilment** | `FBR`: jij verstuurt de bestellingen. `FBB`: bol verstuurt ze en beheert de voorraad. |
| **Delivery schedule (FBR)** | `BOL_DELIVERY_PROMISE`, `MY_DELIVERY_PROMISE` of `SHIPPING_VIA_BOL`. |
| **Delivery promise in days** | `0-1`, `1-2`, `2-3`, `3-5`, `4-8` of `1-8`. Voor `0-1` is een uiterste besteltijd nodig. |
| **Latest order time for next-day delivery** | Een heel uur tussen `12:00` en `23:00`, bijvoorbeeld `22:00`. Verplicht voor de belofte `0-1`. |
| **Delivery promise profile ID** | Alleen voor **My delivery promise**. Plak de ID precies zoals bol hem toont. |
| **I correct stock for open orders myself** | Standaard uit. Uit betekent dat bol openstaande bestellingen aftrekt van de voorraad die je stuurt, wat oververkoop voorkomt. |
| **Sell new offers in** | `NL`, `BE` of `NL_BE`. Laat leeg om de standaard van je bol-account te gebruiken. |
| **Economic operator ID** | bol houdt aanbiedingen offline tot er een marktdeelnemer (economic operator) is gekoppeld. |

## Niet in deze versie

De beta dekt aanbiedingen en productcontent. Dit hoort er nog niet bij:

* Producten of aanbiedingen van bol.com importeren in WISEPIM
* Bestellingen lezen via deze koppeling (zie de opmerking hierboven)
* Retouren en FBB-inzendingen
* Tweedehands of refurbished aanbiedingen
* Bundelprijzen: elke aanbieding krijgt één stukprijs
* Afbeeldingen naast de hoofdafbeelding
* Een aanbieding verwijderen vanuit WISEPIM

## Actie ondernemen op wat je vindt

> **Een product is mislukt met een EAN-fout**
>
> Open het product en controleer de EAN: die moet aanwezig zijn en slagen voor de controle op het controlecijfer. Herstel hem en exporteer daarna opnieuw. Producten zonder GTIN kunnen niet op bol worden aangeboden.

> **De aanbieding staat in bol, maar is niet te koop**
>
> Dat is de standaard. Open de aanbieding in het Verkopersdashboard om hem te controleren, en haal hem daar uit de wacht of zet **Put offers up for sale** aan in de koppeling en exporteer opnieuw.

> **Er is niets aangemaakt voor een nieuwe EAN**
>
> **Auto-create products on export** staat uit, dus WISEPIM werkt alleen aanbiedingen bij die al bestaan. Zet het aan en exporteer opnieuw.

> **De content lijkt geaccepteerd, maar is op bol niet veranderd**
>
> bol verwerkt content-uploads aan zijn eigen kant, wat even kan duren. De volgende export controleert de openstaande upload in plaats van hem opnieuw te sturen. Komt de content nooit aan, kijk dan in het Verkopersdashboard bij het product of er een reden voor afwijzing staat.

> **Opslaan van de koppeling mislukt op een instelling voor aanbiedingen**
>
> Het formulier noemt het veld. Een leverbelofte `0-1` heeft een uiterste besteltijd nodig, en de profiel-ID en de ID van de marktdeelnemer moeten precies worden geplakt zoals bol ze toont.

## Gerelateerd

> **[Producten exporteren](https://docs.wisepim.com/nl/essentials/exporting-products.md)**
>
> Stuur een selectie naar bol.com zoals naar elk ander kanaal.

> **[Kanaalregels](https://docs.wisepim.com/nl/quality-guard/channel-rules.md)**
>
> Gebruik het bol-regelpakket om ontbrekende EAN's en afbeeldingen te vinden voordat je exporteert.

> **[Producten verrijken met AI](https://docs.wisepim.com/nl/essentials/enriching-products.md)**
>
> Verbeter titels en beschrijvingen voordat ze de marktplaats bereiken.

> **[Ondersteunde platformen](https://docs.wisepim.com/nl/integrations/supported-platforms.md)**
>
> Bekijk elk platform waarmee WISEPIM koppelt.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.