Coolblue Integratie: Marketplace API en gecentraliseerd technologiebeheer

Over Coolblue: oprichting, eigendom en marktpositie

Oprichting en geschiedenis (1999 – nu)

Coolblue werd opgericht in 1999 door drie studievrienden van de Erasmus Universiteit Rotterdam: Pieter Zwart, Bart Kuijpers en Paul de Jong. Wat begon als een online winkel voor MP3-spelers, groeide in 25 jaar tijl uit tot dé Nederlandse autoriteit op het gebied van consumentenelektronica, witgoed en — sinds 2022 — duurzame energieoplossingen zoals warmtepompen en zonnepanelen.

De motor onder die groei is de cultuur: "alles voor een glimlach". Elke beslissing — van bezorgmoment tot retourbeleid — wordt teruggebracht naar één vraag: wordt de klant hier vrolijk van? Het hoofdkantoor staat aan de Weena in Rotterdam, met aanvullende kantoren in Antwerpen en Düsseldorf. Coolblue is nog steeds privaat in handen van de oprichters en investeerders; in 2024 waren er overnamegesprekken, maar het bedrijf koos ervoor onafhankelijk te blijven.

Eigendomsstructuur (2026)

• Pieter Zwart — Medeoprichter en CEO, nog steeds grootaandeelhouder
• Bart Kuijpers & Paul de Jong — Medeoprichters, betrokken aandeelhouders
• HAL Investments — Strategische minderheidsaandeelhouder sinds 2018
• Management en medewerkers — Via participatieplan
• Coolblue B.V. — Moederonderneming, gevestigd in Rotterdam

Positie binnen de Nederlandse en Belgische e-commerce

Coolblue is in 2024 met een geconsolideerde omzet van €3,2 miljard+ (NL + BE) een van de top-3 retailers in de Benelux op het gebied van elektronica en witgoed. De combinatie van eigen voorraad (1P), het Coolblue Marketplace platform (3P) en de eigen Coolblue Bezorgservice maakt het ecosysteem uniek: weinig partijen in Europa combineren retail, marktplaats, last-mile bezorging én installatieservice onder één dak.

Coolblue omzet en bereik (cijfers 2023–2025)

Coolblue is decennialang gegroeid met dubbele cijfers, mede dankzij sterke klantloyaliteit, een hoog rendement aan herhaalaankopen en de uitbreiding richting energie. De Marketplace, gelanceerd in 2021, voegt extra schaal toe zonder voorraadrisico voor Coolblue zelf.

Jaar	Omzet NL+BE	Actieve klanten	Marketplace verkopers	Markten
2020	~€2,0 miljard	6M	n.v.t.	NL · BE
2022	~€2,7 miljard	7,5M	~500	NL · BE · DE
2024	~€3,2 miljard	9M+	1.500+	NL · BE · DE
2025 (prognose)	~€3,6 miljard	10M+	2.000+	NL · BE · DE

Deze groei is mede te danken aan Coolblue Energie (warmtepompen, zonnepanelen, laadpalen sinds 2022), de uitrol van 14+ ervaringswinkels en de eigen Coolblue Bezorgservice die ook 's avonds en in het weekend levert — een doorslaggevende factor voor witgoed- en TV-aankopen.

Verkoper worden op Coolblue Marketplace (selectieproces 2026)

1. Juridische en fiscale voorwaarden

Coolblue Marketplace is bewust selectief: het merk wil dat elke verkoper het Coolblue-kwaliteitsniveau aanhoudt. Voor toelating heb je nodig:

• KvK-inschrijving (eenmanszaak, VOF, B.V. — allemaal toegestaan)
• Btw-nummer (Belastingdienst) en correcte 21% / 9% btw-afhandeling
• IBAN-bankrekening waarop Coolblue uitbetaalt
• Nederlandstalige (en bij voorkeur ook Vlaamse) klantenservice
• Productafbeeldingen van professionele kwaliteit, witte achtergrond, minimaal 1000×1000 px
• CE/REACH-conformiteit voor elektronica, WEEE-aanmelding bij Wecycle
• Aantoonbare leverbetrouwbaarheid (orderbevestigingsbewijs of bestaande webshop-historie)

2. Aanmelding bij Coolblue Marketplace

Je vraagt toegang aan via coolblue.nl/marketplace. De aanvraag is uitgebreid: assortimentstoelichting, voorbeelden van productpagina's, retourbeleid en operationele capaciteit. De doorlooptijd van aanvraag tot goedkeuring ligt typisch tussen 14 en 28 dagen. Na goedkeuring ontvang je een Seller ID, OAuth 2.0 client ID en client secret voor de Marketplace API.

📥 Officieel Coolblue Partner Aanmelden coolblue.nl/marketplace — gratis aanmelding, 14–28 werkdagen goedkeuring →

3. Productlisting en contentregels

Coolblue stelt hoge contenteisen om de uniforme ervaring vast te houden:

• Producttitel: 60–150 tekens, format "Merk + Model + Belangrijkste kenmerk"
• Hoofdafbeelding: witte achtergrond, geen watermerken, minimaal 1000×1000 px, max. 8 foto's
• Beschrijving: minimaal 250 tekens, in correct Nederlands, voordelen helder
• Categorie-mapping: Coolblue categorie ID + verplichte attributen per categorie
• EAN/GTIN: verplicht voor merkproducten — versnelt matching met bestaande catalogus
• Energielabel: verplicht voor witgoed, TV's, monitors en lampen (EU-regelgeving)
• Garantie: minimaal de wettelijke garantie van 2 jaar conform Nederlands consumentenrecht

Coolblue commissiepercentages (2026)

De commissies bij Coolblue Marketplace lopen — afhankelijk van de categorie — van 4% tot 18%. Bovenop het commissietarief komen optionele kosten voor de Coolblue Bezorgservice en betalingskosten. Ter vereenvoudiging splitsen we het op in drie hoofdbanden:

Nettowinst-berekening: Verkoopprijs − Commissie − 21% btw − Bezorgkosten − Inkoop = Nettowinst. Met de Zunapro prijsmodule wordt deze berekening per product en per categorie automatisch uitgevoerd. Producten die onder je minimummargedrempel komen, krijgen direct een waarschuwing en de automatische repricer past de prijs aan binnen jouw veilige bandbreedte.

Coolblue Marketplace API — technische diepgang

De Coolblue Marketplace API is een moderne REST API met OAuth 2.0 authenticatie. Hiermee synchroniseer je producten, voorraad, prijzen, orders, verzendingen en retouren. Base URL: https://api.coolblue.nl/marketplace/. Volledige documentatie staat op developers.coolblue.nl.

API authenticatie (OAuth 2.0)

Authenticatie verloopt via een OAuth 2.0 client credentials flow. Je wisselt je client_id en client_secret in voor een access token (TTL 1 uur), dat je meegeeft als Authorization: Bearer <token> bij elke request. Refresh wordt door Zunapro automatisch afgehandeld; jij hoeft daar niets voor te doen.

Belangrijkste endpoint-categorieën

• Products API — Aanbieden van offers op bestaande Coolblue artikelen of nieuwe productvoorstellen indienen
• Inventory API — Voorraad- en prijsupdates (bulk endpoint, tot 200 items per request)
• Orders API — Orders ophalen, statusupdates, annuleringen verwerken
• Shipments API — Verzendlabels via PostNL of DHL Parcel, tracking nummer terugkoppelen
• Returns API — Retouraanvragen ophalen en beoordelen (binnen 14-dagen herroepingsrecht)
• Payouts API — Uitbetalingen, overzicht commissies en btw-specificaties
• Webhooks — Real-time notificaties voor nieuwe orders, annuleringen en retouren

Rate limits en foutafhandeling

De Coolblue API hanteert een rate limit van ongeveer 10 requests per seconde per seller. Bij overschrijding krijg je een 429 Too Many Requests. Veelvoorkomende statuscodes: 400 (validatiefout in productdata), 401 (verlopen token), 404 (onbekende EAN of order), 409 (voorraadconflict), 500 (server error — opnieuw proberen). Zunapro gebruikt exponential backoff, dead-letter queues en automatische token-refresh, zodat je in de praktijk nooit met deze foutcodes te maken krijgt.

Catalogussynchronisatie — bulk product upload vanuit je webshop

Coolblue werkt niet met losse XML-feeds zoals sommige andere marktplaatsen, maar met directe API-uploads. Zunapro pakt dat slim aan: we lezen je bestaande webshop (Shopify, WooCommerce, Magento 2, Lightspeed, CCV Shop, Shopware, Prestashop) elk uur uit en pushen alle wijzigingen via batches naar de Coolblue Marketplace API.

Hoe de Zunapro catalogussync werkt

1. Webshop wordt uitgelezen (uurlijkse of realtime cron, naar keuze)
2. Categorie-mapping wordt eenmalig opgezet en daarna onthouden voor nieuwe producten
3. EAN-matching — Coolblue koppelt aanbiedingen aan bestaande artikelen via EAN
4. Energielabels en CE/REACH-compliance worden gevalideerd vóór upload
5. Prijsmarge en commissie worden toegepast op de inkoopprijs
6. Voorraadbewaking — voorraad uit verkoop op andere kanalen wordt direct verrekend
7. Upload naar Coolblue via de Marketplace API, met automatische retries bij fouten

Coolblue Fulfillment en de Coolblue Bezorgservice

Coolblue heeft voor zijn eigen voorraad (1P) vier eigen distributiecentra: Tilburg en Hoofddorp in Nederland, Antwerpen in België en Würselen in Duitsland. Voor marketplace 3P-verkopers werkt Coolblue voornamelijk met seller-fulfilled modellen, ondersteund door eigen bezorging en 3PL-partners.

Coolblue Bezorgservice — het geheime wapen

• Eigen last-mile vloot — Coolblue Bezorgservice rijdt zelf in NL en BE
• Avond- en weekendbezorging — bezorgvensters die geen enkele concurrent zo biedt
• Installatieservice — vooral relevant voor wasmachines, vaatwassers, TV's
• Oude apparaat retour — direct meenemen bij bezorging, ideaal voor witgoedverkopers
• Hoge bezorgscore — verhoogt je seller rating en conversie

Verzendkosten en bezorgopties (indicatief 2026)

• PostNL standaard: vanaf €3,95 per pakket (klein, <5 kg)
• DHL Parcel: vanaf €4,50 per pakket, ook voor BE-bezorging
• Coolblue Bezorgservice (klein): vanaf €5,95
• Coolblue Bezorgservice (groot/wit): €19,95 – €49,95, incl. installatie en retour oud apparaat

Voor witgoed, grote TV's en zonnepaneel-toebehoren is de Coolblue Bezorgservice dé conversie-aanjager: de avondbezorging met installatie zorgt voor 15–25% hogere conversie dan standaard pakketverzending.

Coolblue Seller Score en kwaliteitseisen

Coolblue meet elke verkoper continu via de Seller Score (0–10). Deze score bepaalt of je hoog in de Buy Box komt en is direct gekoppeld aan de "alles voor een glimlach"-belofte. De belangrijkste factoren:

• Annuleringspercentage — boven 2% krijg je een waarschuwing, boven 5% riskeer je een schorsing
• Levertijd-nakoming — beloofde verzendtijd halen is essentieel
• Retourpercentage — vergeleken met de categoriegemiddelden
• Klantbeoordelingen — minimaal 4,0 sterren handhaven
• Reactietijd — klantvragen binnen 24 uur (werkdagen) beantwoorden
• NPS / glimlachscore — Coolblue meet expliciet of klanten lachen na een 3P-aankoop

Met de automatische voorraadsynchronisatie van Zunapro reduceer je het annuleringsrisico met ongeveer 90%: zodra een artikel elders verkocht of bijgewerkt wordt, is je Coolblue-voorraad binnen seconden aangepast.

Adverteren op Coolblue en slim prijzen (repricer)

Coolblue advertising opties

• Sponsored Products — CPC-gebaseerde plaatsing bovenaan zoekresultaten en categoriepagina's
• Featured offers — gepromoot in de Coolblue nieuwsbrief en op de homepage
• Display banners — voor merkpartners op productpagina's
• Black Friday & Cyber Monday campagnes — selectieve deelname, mits Seller Score > 8,5

Buy Box en repricing

Bij Coolblue draait de Buy Box om de combinatie van scherpe prijs, hoge Seller Score en snelle levertijd. Coolblue's eigen 1P-aanbod heeft vaak voorrang, maar bij producten waar Coolblue niet zelf voorraad heeft, gaat de Buy Box naar de beste 3P-verkoper. De Zunapro repricer past je prijs automatisch en in seconden aan op je concurrentie — en stopt altijd bij je minimummargedrempel.

E-facturatie via Peppol UBL — Nederlandse btw-compliance

Voor B2C-orders op Coolblue is een PDF-factuur of e-mailbevestiging meestal voldoende. Voor zakelijke en B2B-orders is Peppol UBL e-facturatie steeds vaker verplicht — Nederlandse overheidsinstellingen en grote bedrijven accepteren alleen nog UBL via Peppol. Vanaf 2026/2027 wordt e-facturatie binnen de EU breder verplicht (ViDA-richtlijn).

Zunapro e-facturatie module:

• Automatische UBL 2.1 facturatie zodra een Coolblue order de status "verzonden" krijgt
• Direct versturen via het Peppol netwerk naar zakelijke afnemers
• Correcte toepassing van 21% en 9% btw-tarieven per artikelregel
• Automatische creditfacturen bij retouren binnen het 14-dagen herroepingsrecht
• Maandelijkse export voor Belastingdienst btw-aangifte en ICP-opgave
• AVG-conforme opslag (7 jaar bewaartermijn) met logging voor de Autoriteit Persoonsgegevens

Retouren en het 14-dagen herroepingsrecht

Nederland kent het wettelijke 14-dagen herroepingsrecht voor consumenten en een wettelijke garantie van 2 jaar. Coolblue handhaaft deze regels strikt en verwacht van marketplace verkopers identiek beleid — anders daalt je Seller Score snel.

Standaard retourflow op Coolblue:

1. Klant start retour via het Coolblue account (binnen 14 dagen na ontvangst)
2. Coolblue genereert het retourlabel (PostNL of DHL Parcel)
3. Pakket arriveert bij jou of bij een Coolblue retourpunt
4. Je verwerkt de retour binnen 1–3 werkdagen (akkoord of betwist)
5. Coolblue boekt het terug op de klant; bij creditering wordt automatisch een creditfactuur gegenereerd

De Zunapro retourmodule volgt al deze stappen automatisch, stuurt jou een notificatie en genereert de Peppol UBL creditfactuur. Voor witgoed-retouren waarbij Coolblue Bezorgservice het oude apparaat ophaalt, wordt ook de WEEE-registratie bij Wecycle correct vastgelegd.

Zunapro × Coolblue integratie — in 4 stappen live (10 minuten)

1. Voer je Coolblue gegevens in — In het Zunapro panel ga je naar Marketplace → Coolblue, en voer je Seller ID, OAuth client ID en client secret in.
2. Verbind je webshop — Selecteer een van de kant-en-klare connectors: Shopify, WooCommerce, Magento 2, Lightspeed, CCV Shop, Shopware of Prestashop. Voor maatwerk webshops gebruik je onze REST API.
3. Doorloop de categorie-mapping wizard — Sleep je webshop-categorieën naar Coolblue categorieën. De AI-suggesties dekken meestal 80%+ in één klik.
4. Eerste synchronisatie — Producten, voorraad, prijzen, orders en verzendingen — alles synchroniseert automatisch. Binnen 10 minuten beheer je je Coolblue verkoop vanuit Zunapro.

Veelgestelde vragen over de Coolblue integratie