Shopify aan bol.com koppelen: de complete gids

Verkopen op bol naast je eigen Shopify-webshop verdubbelt je bereik en je werk. Voorraad die op twee plekken moet kloppen, productdata die bol anders wil dan Shopify, en orders die uit twee systemen komen. Deze pagina gaat over de drie manieren om dat op te lossen, en over welke bij jou past.

Wat wij doen, in één zin: een maatwerkkoppeling rechtstreeks op de bol Retailer API, tussen Shopify, je voorraad en je ERP of WMS, zonder tussenpartij.

Wat een koppeling eigenlijk doet

Vier stromen, en ze zijn los van elkaar aan of uit te zetten.

Producten van Shopify naar bol. Je artikelen worden aanbiedingen op bol. Hiervoor heeft elk artikel een EAN nodig, en de productdata moet voldoen aan wat bol per categorie verplicht stelt.

Voorraad, beide kanten op. Verkoop je op bol, dan daalt je Shopify-voorraad mee, en andersom. Dit is het onderdeel waar de meeste fouten in zitten.

Orders van bol naar je eigen systeem. Bestellingen komen binnen waar je ze al verwerkt, met het kanaal erbij zodat de juiste regels erop toegepast worden.

Retouren en verzendbevestigingen terug naar bol. Verplicht om je kwaliteitsscore op peil te houden, en de basis onder elke retouranalyse later.

De drie routes

Route 1: een Shopify-app

Je installeert een app uit de Shopify App Store die de koppeling voor je regelt. Je betaalt maandelijks, meestal naar het aantal producten of orders.

Voordelen: binnen een dag draaiend, geen technische partij nodig, de leverancier vangt API-wijzigingen op.

Nadelen: je zit vast aan wat de app kan. Prijsregels zijn eenvoudig, je inkoopprijzen kent hij niet, en koppelen aan een ERP of WMS gaat meestal niet.

Geschikt voor: webshops met een overzichtelijk assortiment, standaard producten met EAN's die al kloppen, en geen eigen logica die per productgroep verschilt.

Route 2: een middlewareplatform

Een channel manager als tussenlaag, die naast bol ook Amazon, Kaufland en advertentiekanalen aankan.

Voordelen: één plek voor alle kanalen, feedformaten worden voor je bijgehouden, en het schaalt mee als je kanalen toevoegt.

Nadelen: duurder, en je koopt capaciteit die je pas gebruikt vanaf kanaal drie. De grens ligt op hetzelfde punt als bij de app: het platform kent je inkoopprijs niet.

Geschikt voor: verkopers op drie of meer kanalen die vooral formaat- en feedwerk uit handen willen geven. Waar zo'n platform ophoudt staat in Channel manager of eigen koppeling.

Route 3: een maatwerkkoppeling

Een koppeling rechtstreeks op de bol Retailer API, gebouwd op jouw proces. Eenmalige investering, daarna alleen hosting en onderhoud.

Voordelen: hij doet precies wat jij nodig hebt. Je eigen inkoopprijzen in de prijslogica, koppelen aan het ERP of WMS dat je toevallig draait, regels per productgroep, en geen maandbedrag dat meegroeit met je omzet.

Nadelen: hogere investering vooraf, je hebt een technische partner nodig, en API-wijzigingen zijn jouw onderhoud in plaats van dat van een leverancier.

Geschikt voor: webshops met een groot of afwijkend assortiment, eigen inkoopprijzen die in de prijsstelling horen, of een ERP of WMS dat niet op de koppelingenlijst van de standaardpakketten staat.

Wat het kost, en wanneer het zichzelf terugverdient

Op deze site staat bewust geen bedrag, omdat de prijs volledig afhangt van het aantal koppelingen en van hoe goed de systemen aan de andere kant zijn gedocumenteerd. Wat je wél kunt uitrekenen is de vórm van de kosten, en dat is waar de beslissing op valt.

De vergelijking die telt is niet app tegen maatwerk, maar wat je nu per maand kwijt bent aan handwerk tegen wat een oplossing per maand kost. Tel daarvoor drie dingen op:

1. de uren die iemand nu besteedt aan voorraad bijwerken, orders overtypen en productdata aanpassen, maal een realistisch uurtarief;
2. wat je nu aan tools betaalt die je zou vervangen;
3. wat annuleringen je kosten, in directe omzet én in je kwaliteitsscore.

Dat derde punt wordt bijna altijd vergeten en is bij verkopers met snellopers vaak de grootste post. Komt daar een bedrag uit dat in de buurt komt van een maandelijks abonnement, dan is de app de goedkoopste route. Ligt het er ver boven, dan verdient maatwerk zich terug en is de enige vraag hoe snel.

Hoe zo'n traject loopt

Bij ons in vier fases, en de eerste is de belangrijkste.

Voorbereiding. Toegang regelen, de API-client aanmaken, en vooral: je productdata nalopen. Welke artikelen hebben een EAN, welke categorieën vraagt bol om welke velden, welke producten wil je uitsluiten. Dit is het deel dat uitloopt als je het overslaat.

Bouwen. Eerst producten en voorraad, dan orders, dan retouren. Elke stroom apart opgeleverd en apart te testen, zodat je niet drie dingen tegelijk aan het debuggen bent.

Testen. Met een kleine selectie echte artikelen, niet met de demo-omgeving alleen. Die gebruikt vaste voorbeelddata en bootst geen echte orderstroom na.

Live, en bewaken. Een controle die aanslaat als er een uur niets is gesynchroniseerd. Een koppeling zonder alarm is geen koppeling maar een aanname.

Waar het in de praktijk misgaat

Drie dingen die wij bij bijna elk traject tegenkomen.

Ontbrekende of dubbele EAN-codes. Zonder EAN kan een artikel niet op bol staan. Bij assortimenten met varianten blijkt vaak dat de helft er geen heeft, of dat dezelfde code op twee artikelen zit. Dat is geen technisch probleem maar datawerk, en het bepaalt je doorlooptijd meer dan het bouwen.

Het gat tussen twee synchronisaties. Je koppeling draait elk kwartier; bol verkoopt in dat kwartier door. Bij een snelloper met twee stuks levert dat een annulering op. De oplossing is een veiligheidsdrempel op lage voorraad, of abonnementen zodat bol jou een seintje geeft in plaats van dat jij blijft vragen.

Retouren die nergens landen. Overgeslagen omdat je zonder kunt verkopen. Zes maanden later klopt je voorraad niet en weet je niet welk product hoe vaak terugkomt, terwijl dat een van de weinige getallen is waar je marge echt aan hangt.

Welke route past bij jou

Vier vragen, en meestal is het na de tweede al duidelijk.

1. Hebben al je artikelen een kloppende EAN? Zo niet, dan begint elk traject daar, ongeacht welke route je kiest.
2. Zit je marge in iets specifieks? Eigen inkoopprijzen, staffels, regels per productgroep. Ja betekent maatwerk; nee betekent dat een app volstaat.
3. Draai je een ERP of WMS? Staat dat niet op de koppelingenlijst van de standaardpakketten, dan is er niets te kopen.
4. Hoeveel handwerk blijft er ná je oplossing over? Blijft dat onder twee uur per week, laat het dan zo. Loopt het naar een dag, dan verdient maatwerk zich binnen enkele maanden terug.

Weet je het antwoord op vraag vier niet, doe dan eerst de scan hieronder. Die rekent op basis van je eigen antwoorden uit hoeveel uren en euro's er per maand weglekken. Dat is een concreter startpunt dan een offerte.

Veelgestelde vragen

Heb ik een bol verkoopaccount nodig voordat ik kan koppelen?

Ja. Je hebt een zakelijk verkoopaccount op het bol Partnerplatform nodig, en daarbinnen maak je onder de API-instellingen een client aan met een client ID en secret. Zonder die twee kan geen enkele koppeling iets, ook een kant-en-klare app niet. Reken erop dat het aanmaken en goedgekeurd krijgen van het account een paar dagen kost; dat is vaker de vertraging dan het bouwen zelf.

Kan ik dezelfde prijzen hanteren op bol als in mijn eigen webshop?

Technisch wel, financieel meestal niet verstandig. Op bol betaal je een vaste bijdrage per verkocht artikel plus een percentage dat per productcategorie verschilt. Reken je met je webshopprijs, dan lever je dat verschil in op je marge. De meeste verkopers hanteren daarom een aparte prijsregel per kanaal, en dat is precies een van de dingen die een standaardapp niet voor je uitrekent.

Wat gebeurt er als ik op beide kanalen tegelijk uitverkoop?

Dan krijg je een order die je niet kunt leveren, en een annulering telt mee in je kwaliteitsscore op bol. Het probleem is de tussentijd: de meeste koppelingen synchroniseren elk kwartier tot elk uur, en in dat gat verkoopt bol door. Bij artikelen met lage voorraad los je dat niet op door vaker te synchroniseren maar met een veiligheidsdrempel: onder een ingesteld aantal stuks meld je bewust minder voorraad dan er ligt.

Hoe snel is de voorraadsynchronisatie echt?

Het endpoint voor voorraad mag vijftig keer per seconde aangeroepen worden, dus daar zit de rem niet. De vertraging zit in het asynchrone model van bol: je krijgt een processStatus terug en de wijziging staat pas echt als die op SUCCESS staat, meestal binnen een halve minuut. Een koppeling die dat niet nabelt, denkt te synchroniseren zonder dat het gebeurt.

Ondersteunt een koppeling varianten zoals maten en kleuren?

Bij bol is elke variant een eigen artikel met een eigen EAN. Een Shopify-product met acht maten wordt op bol dus acht aanbiedingen. Dat werkt prima zolang elke variant een eigen EAN heeft. Heeft hij die niet, dan is dat het eerste wat opgelost moet worden, en dat is handwerk of inkoop bij GS1.

Kan ik bepaalde producten uitsluiten van bol.com?

Ja, en dat wil je vrijwel zeker. Producten met een lage marge, hoge retourkans of veel varianten kunnen op bol geld kosten terwijl ze in je eigen webshop winstgevend zijn. Elke fatsoenlijke koppeling laat je selecteren op collectie, tag of productgroep. Begin klein: een selectie die je kent, uitbreiden kan altijd.

Wat als bol de API verandert?

Dat gebeurt regelmatig. bol versiebeheert tegenwoordig per resource in plaats van de hele API in één keer, dus er verandert vaker iets en kleiner tegelijk. Bij een app of platform vangt de leverancier dat op. Bij maatwerk hoort dat in je onderhoudsafspraak te staan. Wij houden de wijzigingen bij op onze pagina met alle rate limits.

Hoe zit het met retouren?

Retouren komen via de API binnen en moeten in je eigen administratie landen, anders klopt je voorraad niet en weet je na een half jaar niet welk product hoe vaak terugkomt. Dit is het onderdeel dat bij zelfbouwtrajecten het vaakst wordt overgeslagen, omdat je zonder kunt verkopen. Zes maanden later is het een gat in je cijfers.

Kan ik Logistiek via bol gebruiken in combinatie met Shopify?

Ja. Je voorraad ligt dan bij bol en zij verzenden; je koppeling houdt dan bij wat er nog ligt en zorgt dat je eigen webshop niet verkoopt wat daar niet meer is. Let op dat je twee voorraadposities krijgt die niet automatisch één geheel zijn: dat is een ontwerpkeuze die je vooraf moet maken en niet achteraf.

Mijn bol-koppeling valt regelmatig stil zonder dat ik het merk. Hoe los ik dat op?

Door een controle te bouwen die schreeuwt in plaats van te logeren. De gebruikelijke oorzaken zijn een token dat niet ververst, een resource die van versie wisselde, of een FAILURE op een asynchrone actie die niemand nabelde. Wat ze gemeen hebben is dat de koppeling niet crasht maar stilletjes niets doet. Minimaal nodig is een melding als er een uur lang niets is gesynchroniseerd, en die moet naar iemand die hem leest, niet naar een logbestand. Een koppeling zonder alarm is geen koppeling maar een aanname.

Wat kost een maatwerkkoppeling?

Daar staat op deze site bewust geen bedrag bij, omdat het volledig afhangt van het aantal koppelingen en de kwaliteit van de systemen aan de andere kant. Wat wij wel doen: in de eerste fase zetten we de prijs op papier voordat er iets gebouwd wordt, naast wat je nu per maand kwijt bent aan het handwerk dat de koppeling vervangt. Zo vergelijk je twee getallen in plaats van een offerte met een gevoel.