Coolblue Integration: Marketplace API & Centralized Tech-Retail Management

About Coolblue: Founding, Ownership and Market Position

Founding and Timeline (1999 – Today)

Coolblue was founded in 1999 in Rotterdam by three Erasmus University students — Pieter Zwart, Bart Kuijpers and Paul de Jong — who started as a webshop selling MP3 players. From day one, the company built its identity around a single principle: "alles voor een glimlach" — everything for a smile. That obsession with customer service became the durable moat that helped Coolblue out-execute generic price-led competitors throughout the 2000s and 2010s.

By the 2010s, Coolblue had expanded from a single-category webshop into a multi-category tech retailer, opened its first physical "experience stores", and built Coolblue Bezorgservice — its own last-mile delivery network covering evening and weekend windows. In 2021, Coolblue launched its curated Marketplace, opening the platform to ~1,500 carefully vetted third-party sellers. In 2022, the company pivoted into sustainable energy with Coolblue Energie, selling heat pumps, solar panels and home batteries — fully aligned with the Dutch energy transition.

Coolblue Ownership Structure (2026)

• Coolblue B.V. — Private Dutch company headquartered at Weena, Rotterdam
• Pieter Zwart — Co-founder and CEO, still actively leading the company
• Bart Kuijpers and Paul de Jong — Co-founders, long-term shareholders
• HAL Investments — Minority investor (acquired stake to fuel European expansion)
• No listed parent group — Coolblue has remained an independent, founder-led private company

Position in Dutch and Benelux Tech-Retail

Coolblue is the #1 tech-retailer brand for trust and customer satisfaction in the Netherlands and Belgium, consistently ranking ahead of bol., Amazon.nl and MediaMarkt in Net Promoter Score surveys. Its competitive edge isn't lowest price — it's the experience: clear product advice, transparent stock, Coolblue Bezorgservice evening delivery, in-store installation help, and a 14-store retail footprint across Rotterdam, Amsterdam, Antwerp, Düsseldorf and beyond. For sellers, this means Coolblue customers convert at higher AOVs and return at lower rates than generic marketplaces.

Coolblue Sales Volume and Scale (2024–2025 Data)

Coolblue's combined Netherlands and Belgium GMV crossed €3.2 billion in 2024, with double-digit YoY growth driven by the marketplace launch, German expansion and the energy category. Unlike generic marketplaces, Coolblue's customer base skews toward higher-AOV tech and white-goods buyers — the average basket size is meaningfully larger than the European e-commerce median.

Year	NL+BE GMV (EUR)	Active Customers	3P Sellers	Physical Stores
2020	~€2.0B	5M	—	9
2022	~€2.6B	7M	~600	11
2024	~€3.2B+	9M+	~1,500	14+
2025 (forecast)	~€3.6B	10M+	~2,000	16

This growth is powered by Coolblue Bezorgservice's evening/weekend windows, the German market entry (with the Würselen warehouse), and the brand's high repeat-purchase rate. For marketplace sellers, joining Coolblue means access to a customer base that already trusts the platform — but it also means meeting Coolblue's selective onboarding bar.

Coolblue Marketplace Seller Application (2026 Rules)

1. Legal and Financial Requirements

To sell on Coolblue Marketplace, you need an EU-registered business with a valid VAT number. Dutch entities (B.V., eenmanszaak), Belgian companies and other EU sellers are all eligible — but you must be ready to invoice in Peppol UBL format and handle Dutch consumer law (14-day withdrawal, 2-year statutory warranty).

• VAT number (Dutch BTW or other EU VAT ID)
• KvK / Chamber of Commerce registration extract
• Dutch IBAN or EU SEPA bank account for settlements
• Brand authorization letters for branded products
• CE / WEEE / REACH compliance documentation for electronics
• Wecycle registration (WEEE compliance partner in NL)
• Peppol e-invoicing capability (UBL via certified Peppol access point)

2. Applying via the Coolblue Partner Portal

You apply through coolblue.nl/marketplace. Approval is genuinely selective — most marketplaces auto-approve within days, but Coolblue takes 14–28 days while the category team reviews your brand authorization, product range, EU compliance and service KPIs. Once approved, you receive a seller ID, OAuth 2.0 client ID and client secret for the Marketplace API. Documentation lives at developers.coolblue.nl.

3. Product Listing and Content Rules

Coolblue enforces strict content standards because the platform's brand promise depends on accurate product information:

• Title: 40–120 characters, format "Brand + Product + Key Spec"
• Images: White background, minimum 1500×1500px, up to 10 photos, no watermarks
• Description: Structured HTML, minimum 250 characters, written in Dutch (NL/BE) and German (DE)
• EAN / GTIN: Mandatory for catalog matching — this is non-negotiable
• Attributes: Coolblue uses detailed category-specific attribute sets (energy class, screen size, capacity)
• Compliance docs: CE declaration, energy label PDF for white goods/TVs

Coolblue Commission Rates (2026)

Coolblue commission rates run from 4% to 18% depending on category. On top of commission, sellers pay 21% VAT on the commission itself, plus shipping costs if not using own carrier. Doing gross-to-net math before pricing is the single most important habit for a healthy Coolblue P&L. Here are the three main bands:

Net margin formula: Sales price − Commission − VAT on commission − Shipping − Product COGS = Net profit. Zunapro's pricing module runs this calculation per SKU per category in real time, flagging any product that drifts below your minimum-margin threshold and triggering the repricer automatically.

Coolblue Marketplace API — Technical Details

The Coolblue Marketplace API is a RESTful interface that lets sellers programmatically sync products, stock, prices, orders, shipments and returns with the Coolblue platform. Base URL: https://api.coolblue.nl/marketplace/

API Authentication

The Coolblue Marketplace API uses OAuth 2.0 with the client credentials grant. You exchange your client_id and client_secret for a short-lived access token (typically 1 hour), then pass it as Authorization: Bearer <token>. Tokens auto-refresh — but you should still rotate credentials every 6–12 months for security hygiene.

Main Endpoint Groups

• Products API — Create, update, attribute mapping, catalog matching via EAN
• Offers API — Stock and price sync (bulk endpoint, up to 100 SKUs per request)
• Orders API — List orders, update statuses, manage shipments
• Shipments API — Generate labels, push tracking numbers, route via Coolblue Bezorgservice / PostNL / DHL Parcel
• Returns API — Query return requests, approve or reject
• Invoices API — Settlement, commission breakdown, monthly reconciliation
• Webhooks — Real-time callbacks for new orders, status changes and returns

Rate Limits and Error Handling

Coolblue's API rate limit is around 10 requests per second per seller. Exceeding it returns 429 Too Many Requests. Common error codes: 400 (invalid payload), 401 (token expired), 404 (EAN or category not found), 500 (Coolblue-side issue — safe to retry). Zunapro's integrator handles this with exponential backoff, a dead-letter queue and automatic token refresh, so you never lose an event.

Bulk Product Import — Catalog Sync at Scale

For sellers with large catalogs (thousands of SKUs from distributors or brand portfolios), Zunapro's bulk import reads your existing product feed — JSON, XML, CSV or direct Shopify/WooCommerce/Magento API — and pushes everything to Coolblue Marketplace in a single sync job.

Coolblue Product Schema (Key Fields)

Each Coolblue listing requires:

• productId — Your internal SKU (groups variants)
• brand, title, ean (mandatory), mpn
• categoryId (Coolblue category) and attributes (energy class, capacity, color)
• stock, price, vatRate (21% standard, 9% reduced)
• shippingMethod (Coolblue Bezorgservice / PostNL / DHL Parcel)
• images (1–10 URLs, 1500×1500+ minimum), description in NL/BE/DE
• energyLabel URL (mandatory for white goods, TVs)

From Distributor Feed to Coolblue

Most EU distributors (TechData, Also, Ingram Micro, Coolblue-authorized resellers in NL/BE) publish product catalogs as JSON or XML feeds. Zunapro's bulk-import module:

1. Reads the distributor feed URL (hourly or daily cron)
2. Maps categories (manual the first time, AI-suggested afterwards)
3. Normalizes attributes — brand, energy class, color, capacity
4. Applies margin + commission to compute the Coolblue list price
5. Tracks stock — auto-deactivates SKUs your distributor no longer carries
6. Pushes to Coolblue via the Offers API

Coolblue Fulfillment and Coolblue Bezorgservice

Coolblue's logistics model is a hybrid: Coolblue Fulfillment ships own-stock (1P) from four warehouses — Tilburg, Hoofddorp, Antwerpen and Würselen (Germany). Marketplace (3P) sellers fulfill from their own warehouse or 3PL, but can route shipments through Coolblue-friendly carriers.

Coolblue Bezorgservice — The Differentiator

• Same-day, evening, and weekend slots across NL and BE
• Installation services for white goods, TVs and heat pumps
• Old-product pickup bundled with new-product delivery
• Premium delivery rating — boosts conversion vs. generic next-day
• Coolblue Energie installs — solar panels and heat pumps delivered + installed

3P Seller Shipping Options

• PostNL — Standard NL/BE next-day, drop-off at PostNL points
• DHL Parcel — Cross-border NL→BE→DE, ServicePoints, return labels
• Own carrier — If you have a custom logistics setup

Coolblue Bezorgservice itself is generally reserved for 1P stock — but well-rated 3P sellers in NL/BE can negotiate access for premium-margin categories. Hitting Coolblue's delivery SLAs (ship within 1 business day, valid track-and-trace within 24h) is the fastest way to grow.

Coolblue Seller Score and Service KPIs

Coolblue assigns each seller a service score from 1 to 10. This score directly drives visibility in product detail pages and search rankings. The factors that push it down:

• Cancellation rate — Out-of-stock cancellations are the biggest penalty; >2% triggers warnings, >5% risks account suspension
• Late shipments — Orders not shipped within the promised handling window
• Return rate — Above-category-average returns drag the score
• Customer reviews — Must stay above 4.0 stars; Coolblue takes reviews seriously
• Response time — Customer messages must be answered within 24 hours

Zunapro's real-time stock sync cuts cancellation risk by ~90% — the moment a sale happens on your webshop, bol. or Amazon, Coolblue stock is updated in seconds, preventing the overselling that hurts seller scores.

Coolblue Advertising, Promotions and Smart Pricing

Coolblue Advertising Options

• Sponsored Products — Top placements on search and category pages (CPC model)
• Brand Store pages — Curated brand landing pages for portfolio sellers
• Coolblue's Choice badge — Algorithmically awarded; drives big conversion lifts
• Seasonal campaigns — Black Friday, Sinterklaas, Energy Week (heat pumps/solar)

Smart Pricing (Repricer)

Coolblue's product detail page shows multiple seller offers. The "best deal" position is awarded based on price, seller score and delivery promise — not just lowest price. Zunapro's repricer adjusts your prices in seconds based on competitor moves, but always respects your floor margin so you never sell below cost.

Coolblue E-Invoicing — Peppol UBL and Belastingdienst Compliance

All sellers on Coolblue Marketplace must issue compliant invoices: Peppol UBL e-invoices for B2B orders, and standard PDF/email invoices for B2C consumers — all aligned with Dutch tax authority (Belastingdienst) rules and AP (Autoriteit Persoonsgegevens / Dutch DPA) privacy requirements. Doing this manually past 100 orders/day is impossible.

Zunapro's Peppol module:

• Auto-generates Peppol UBL e-invoices the moment a Coolblue order arrives
• Sends via certified Peppol access points (Storecove, TIE Kinetix, Pagero and others)
• Issues automatic credit notes for refunds and returns
• Files quarterly VAT (BTW) reports to the Belastingdienst
• Emails the consumer a PDF invoice in NL, BE-NL, BE-FR or DE language

Coolblue Shipping — Bezorgservice + PostNL + DHL Parcel

Coolblue Marketplace orders ship through three main channels: Coolblue Bezorgservice (Coolblue's own evening/weekend last-mile, primarily 1P but available to top 3P sellers), PostNL (the Dutch postal standard) and DHL Parcel (cross-border NL/BE/DE). For German orders out of Würselen, DHL Parcel and own-fleet routing dominate.

Zunapro's multi-carrier module picks the best carrier per order based on weight, destination city and customer preference; prints the label, and pushes the tracking number back to Coolblue automatically. Customers see live tracking inside their Coolblue account — exactly the "smile" experience the brand is famous for.

Coolblue Returns and Customer Service Management

Dutch consumer law gives buyers a 14-day right of withdrawal and a 2-year statutory warranty. Return rates by category typically sit at fashion-style accessories 20–25%, white goods 3–6% and consumer electronics 5–10%. Mishandling returns is the fastest way to torpedo your seller score.

Coolblue Standard Return Flow:

1. Customer opens a return request in their Coolblue account (within 14 days of delivery)
2. Coolblue issues a return label (PostNL or DHL Parcel) free to the buyer
3. Item arrives at the seller warehouse (or Coolblue's intake for top 3P partners)
4. Seller approves or rejects within 1–3 business days based on condition
5. Approved returns trigger refund to the customer via Coolblue payments

Zunapro's returns module tracks every step, sends panel notifications, auto-issues the credit-note Peppol invoice and updates the Coolblue Returns API. Plus it integrates with Wecycle for WEEE-compliant disposal of broken electronics.

Zunapro × Coolblue Integration — 4-Step Setup (15 Minutes)

1. Enter Your Coolblue Marketplace Credentials — In the Zunapro panel, go to Marketplace → Coolblue and enter your Seller ID, OAuth 2.0 client ID and client secret from developers.coolblue.nl.
2. Connect Your Webshop — Pre-built connectors for Shopify, WooCommerce, Magento, Lightspeed, PrestaShop and custom REST APIs. Drop in your API URL and access key.
3. Category Mapping Wizard — Drag-and-drop your webshop categories onto Coolblue's category tree. AI suggestions complete most mappings in minutes; energy-label PDFs auto-attach.
4. First Sync — Products, stock, prices, orders and shipping start syncing automatically. Within 15 minutes, your Coolblue store is fully manageable from the Zunapro panel.

Frequently Asked Questions About Coolblue Integration