Coolblue Entegrasyonu: Marketplace API ve Tek Panelden Teknoloji-Perakende Yönetimi

Coolblue Hakkında: Kuruluş, Sahiplik ve Pazar Konumu

Kuruluş ve Zaman Çizelgesi (1999 – Bugün)

Coolblue, 1999'da Rotterdam'da üç Erasmus Üniversitesi öğrencisi — Pieter Zwart, Bart Kuijpers ve Paul de Jong — tarafından MP3 çalar satan bir webshop olarak kuruldu. İlk günden itibaren şirket kimliğini tek bir prensip üzerine inşa etti: "alles voor een glimlach" — her şey bir gülümseme için. Müşteri hizmetlerine bu takıntı, Coolblue'nun 2000'ler ve 2010'lar boyunca jenerik fiyat odaklı rakiplerini geride bırakmasını sağlayan kalıcı bir savunma hattı oldu.

2010'lara gelindiğinde Coolblue, tek kategorili bir webshop'tan çok kategorili bir teknoloji perakendecisine dönüştü, ilk fiziksel "deneyim mağazalarını" açtı ve akşam ile hafta sonu pencerelerini kapsayan kendi son-mil teslimat ağı Coolblue Bezorgservice'i kurdu. 2021'de Coolblue, dikkatle elenmiş ~1.500 üçüncü taraf satıcıya platformu açan seçici Marketplace'ini başlattı. 2022'de şirket, ısı pompası, güneş paneli ve ev pillerini satan Coolblue Energie ile sürdürülebilir enerjiye yöneldi — Hollanda enerji geçişiyle tamamen uyumlu.

Coolblue Sahiplik Yapısı (2026)

• Coolblue B.V. — Genel merkezi Weena, Rotterdam'da olan özel Hollanda şirketi
• Pieter Zwart — Kurucu ortak ve CEO, hâlâ şirketi aktif olarak yönetiyor
• Bart Kuijpers ve Paul de Jong — Kurucu ortaklar, uzun vadeli hissedarlar
• HAL Investments — Azınlık yatırımcısı (Avrupa genişlemesini finanse etmek için pay aldı)
• Listelenmiş bir ana grup yok — Coolblue, bağımsız, kurucu liderliğinde özel bir şirket olarak kaldı

Hollanda ve Benelüks Teknoloji-Perakendesindeki Konumu

Coolblue, Hollanda ve Belçika'da güven ve müşteri memnuniyetinde 1 numaralı teknoloji perakendeci markasıdır ve Net Promoter Score anketlerinde tutarlı bir şekilde bol., Amazon.nl ve MediaMarkt'ın önünde yer alır. Rekabet avantajı en düşük fiyat değil — deneyimdir: net ürün tavsiyesi, şeffaf stok, Coolblue Bezorgservice akşam teslimatı, mağaza içi kurulum yardımı ve Rotterdam, Amsterdam, Antwerp, Düsseldorf ve ötesinde 14 mağazalık perakende ağı. Satıcılar için bu, Coolblue müşterilerinin jenerik pazaryerlerine kıyasla daha yüksek sepet tutarlarıyla satın aldığı ve daha düşük oranlarda iade ettiği anlamına gelir.

Coolblue Satış Hacmi ve Ölçeği (2024–2025 Verileri)

Coolblue'nun Hollanda ve Belçika birleşik GMV'si 2024'te 3,2 milyar Euro'yu aştı; pazaryeri lansmanı, Almanya genişlemesi ve enerji kategorisinin sürüklediği çift haneli yıllık büyümeyle birlikte. Jenerik pazaryerlerinin aksine, Coolblue'nun müşteri tabanı daha yüksek sepet tutarlı teknoloji ve beyaz eşya alıcılarına yöneliktir — ortalama sepet boyutu, Avrupa e-ticaret medyanından anlamlı ölçüde daha büyüktür.

Yıl	NL+BE GMV (EUR)	Aktif Müşteri	3P Satıcı	Fiziksel Mağaza
2020	~€2,0B	5M	—	9
2022	~€2,6B	7M	~600	11
2024	~€3,2B+	9M+	~1.500	14+
2025 (tahmin)	~€3,6B	10M+	~2.000	16

Bu büyüme; Coolblue Bezorgservice'in akşam/hafta sonu pencereleri, Alman pazarına giriş (Würselen deposuyla) ve markanın yüksek tekrar satın alma oranıyla destekleniyor. Pazaryeri satıcıları için Coolblue'ya katılmak, platforma zaten güvenen bir müşteri tabanına erişim demektir — ancak aynı zamanda Coolblue'nun seçici onboarding çıtasını karşılamak anlamına gelir.

Coolblue Marketplace Satıcı Başvurusu (2026 Kuralları)

1. Yasal ve Finansal Gereksinimler

Coolblue Marketplace'te satış yapmak için geçerli KDV numarasına sahip AB kayıtlı bir işletmeye ihtiyacınız vardır. Hollandalı tüzel kişiler (B.V., eenmanszaak), Belçikalı şirketler ve diğer AB satıcılarının tümü uygundur — ancak Peppol UBL formatında fatura kesmeye ve Hollanda tüketici hukukunu (14 gün cayma, 2 yıl yasal garanti) yönetmeye hazır olmalısınız.

• KDV numarası (Hollanda BTW veya diğer AB KDV ID'si)
• KvK / Ticaret Odası kayıt belgesi
• Ödeşmeler için Hollanda IBAN'ı veya AB SEPA banka hesabı
• Markalı ürünler için marka yetki belgeleri
• Elektronik için CE / WEEE / REACH uyumluluk dokümantasyonu
• Wecycle kaydı (NL'de WEEE uyumluluk ortağı)
• Peppol e-faturalama yetkinliği (sertifikalı Peppol erişim noktası üzerinden UBL)

2. Coolblue Partner Portalı Üzerinden Başvuru

Başvuruyu coolblue.nl/marketplace üzerinden yaparsınız. Onay gerçekten seçicidir — çoğu pazaryeri günler içinde otomatik onay verir, ancak Coolblue'da kategori ekibi marka yetkinizi, ürün yelpazenizi, AB uyumluluğunuzu ve hizmet KPI'larınızı incelerken 14–28 gün sürer. Onaylandıktan sonra Marketplace API için bir seller ID, OAuth 2.0 client ID ve client secret alırsınız. Dokümantasyon developers.coolblue.nl adresindedir.

📥 Resmi Coolblue Partner Satıcı Başvurusu coolblue.nl/marketplace — ücretsiz başvuru, 14–28 iş günü onay →

3. Ürün Listeleme ve İçerik Kuralları

Coolblue, platformun marka vaadi doğru ürün bilgisine bağlı olduğu için katı içerik standartları uygular:

• Başlık: 40–120 karakter, "Marka + Ürün + Anahtar Özellik" formatı
• Görseller: Beyaz arka plan, minimum 1500×1500px, en fazla 10 fotoğraf, watermark yok
• Açıklama: Yapılandırılmış HTML, minimum 250 karakter, Hollandaca (NL/BE) ve Almanca (DE) yazılmış
• EAN / GTIN: Katalog eşleştirmesi için zorunlu — bu pazarlık konusu değildir
• Öznitelikler: Coolblue, kategoriye özgü ayrıntılı öznitelik setleri kullanır (enerji sınıfı, ekran boyutu, kapasite)
• Uyumluluk belgeleri: Beyaz eşya/TV için CE beyanı, enerji etiketi PDF'i

Coolblue Komisyon Oranları (2026)

Coolblue komisyon oranları kategoriye bağlı olarak %4 ile %18 arasında değişir. Komisyona ek olarak, satıcılar komisyonun kendisinde %21 KDV öder, kendi kuryesini kullanmıyorsa kargo masrafları eklenir. Fiyatlamadan önce brüt-net hesabı yapmak, sağlıklı bir Coolblue P&L için en önemli alışkanlıktır. İşte üç ana bant:

Net marj formülü: Satış fiyatı − Komisyon − Komisyon KDV'si − Kargo − Ürün COGS = Net kâr. Zunapro'nun fiyatlama modülü bu hesaplamayı SKU başına, kategori başına gerçek zamanlı çalıştırır; minimum-marj eşiğinizin altına düşen herhangi bir ürünü işaretler ve repricer'ı otomatik olarak tetikler.

Coolblue Marketplace API — Teknik Detaylar

Coolblue Marketplace API, satıcıların Coolblue platformuyla ürünleri, stoğu, fiyatları, siparişleri, sevkiyatları ve iadeleri programatik olarak senkronize etmesini sağlayan RESTful bir arayüzdür. Base URL: https://api.coolblue.nl/marketplace/

API Kimlik Doğrulama

Coolblue Marketplace API, client credentials grant ile OAuth 2.0 kullanır. client_id ve client_secret'inizi kısa ömürlü bir erişim token'ı (genellikle 1 saat) ile değiştirir, ardından Authorization: Bearer <token> olarak geçirirsiniz. Token'lar otomatik yenilenir — ancak güvenlik hijyeni için kimlik bilgilerinizi her 6–12 ayda bir döndürmelisiniz.

Ana Endpoint Grupları

• Products API — EAN üzerinden oluşturma, güncelleme, öznitelik haritalama, katalog eşleştirme
• Offers API — Stok ve fiyat senkronu (toplu endpoint, istek başına 100 SKU'ya kadar)
• Orders API — Siparişleri listeleme, durum güncelleme, sevkiyatları yönetme
• Shipments API — Etiket üretme, takip numaralarını gönderme, Coolblue Bezorgservice / PostNL / DHL Parcel üzerinden yönlendirme
• Returns API — İade taleplerini sorgulama, onaylama veya reddetme
• Invoices API — Ödeşme, komisyon dökümü, aylık mutabakat
• Webhooks — Yeni siparişler, durum değişiklikleri ve iadeler için gerçek zamanlı geri çağrımlar

Hız Limitleri ve Hata Yönetimi

Coolblue'nun API hız limiti satıcı başına saniyede yaklaşık 10 istektir. Bunun aşılması 429 Too Many Requests döndürür. Yaygın hata kodları: 400 (geçersiz payload), 401 (token süresi doldu), 404 (EAN veya kategori bulunamadı), 500 (Coolblue tarafı sorun — yeniden denemek güvenlidir). Zunapro'nun entegratörü bunu üstel geri çekilme, dead-letter kuyruğu ve otomatik token yenileme ile yönetir, böylece hiçbir olayı kaçırmazsınız.

Toplu Ürün İçe Aktarma — Ölçekte Katalog Senkronu

Büyük kataloglu satıcılar için (distribütör veya marka portföylerinden binlerce SKU), Zunapro'nun toplu içe aktarımı mevcut ürün feed'inizi — JSON, XML, CSV veya doğrudan Shopify/WooCommerce/Magento API'si — okur ve her şeyi tek bir senkron işinde Coolblue Marketplace'e gönderir.

Coolblue Ürün Şeması (Ana Alanlar)

Her Coolblue listelemesi şunları gerektirir:

• productId — Dahili SKU'nuz (varyantları gruplar)
• brand, title, ean (zorunlu), mpn
• categoryId (Coolblue kategorisi) ve attributes (enerji sınıfı, kapasite, renk)
• stock, price, vatRate (%21 standart, %9 indirimli)
• shippingMethod (Coolblue Bezorgservice / PostNL / DHL Parcel)
• images (1–10 URL, minimum 1500×1500+), NL/BE/DE dillerinde description
• energyLabel URL'si (beyaz eşya, TV'ler için zorunlu)

Distribütör Feed'inden Coolblue'ya

Çoğu AB distribütörü (TechData, Also, Ingram Micro, NL/BE'deki Coolblue yetkili bayileri) ürün kataloglarını JSON veya XML feed'leri olarak yayınlar. Zunapro'nun toplu içe aktarma modülü:

1. Distribütör feed URL'sini okur (saatlik veya günlük cron)
2. Kategorileri eşleştirir (ilk seferde manuel, sonrasında AI önerili)
3. Öznitelikleri normalize eder — marka, enerji sınıfı, renk, kapasite
4. Marj + komisyon uygular ve Coolblue liste fiyatını hesaplar
5. Stoğu takip eder — distribütörünüzün artık taşımadığı SKU'ları otomatik devre dışı bırakır
6. Offers API üzerinden Coolblue'ya gönderir

Coolblue Fulfillment ve Coolblue Bezorgservice

Coolblue'nun lojistik modeli hibrittir: Coolblue Fulfillment, kendi stoğunu (1P) dört depodan — Tilburg, Hoofddorp, Antwerpen ve Würselen (Almanya) — sevk eder. Marketplace (3P) satıcıları kendi depolarından veya 3PL'lerinden sevkiyat yapar, ancak gönderileri Coolblue dostu kuryeler üzerinden yönlendirebilir.

Coolblue Bezorgservice — Farklılaştırıcı

• NL ve BE genelinde aynı gün, akşam ve hafta sonu zaman dilimleri
• Beyaz eşya, TV ve ısı pompaları için kurulum hizmetleri
• Yeni ürün teslimatıyla birleştirilen eski ürün alma
• Jenerik ertesi gün teslimata karşı dönüşümü artıran premium teslimat puanı
• Coolblue Energie kurulumları — güneş panelleri ve ısı pompaları teslim + kurulum

3P Satıcı Kargo Seçenekleri

• PostNL — Standart NL/BE ertesi gün, PostNL noktalarına bırakma
• DHL Parcel — Sınır ötesi NL→BE→DE, ServicePoint'ler, iade etiketleri
• Kendi kuryeniz — Özel bir lojistik kurulumunuz varsa

Coolblue Bezorgservice'in kendisi genel olarak 1P stoğu için ayrılmıştır — ancak NL/BE'de iyi puanlı 3P satıcılar, premium-marj kategorilerinde erişim için müzakere yapabilir. Coolblue'nun teslimat SLA'larını (1 iş günü içinde sevkiyat, 24 saat içinde geçerli takip-izleme) tutturmak büyümenin en hızlı yoludur.

Coolblue Satıcı Skoru ve Hizmet KPI'ları

Coolblue her satıcıya 1 ile 10 arasında bir hizmet skoru atar. Bu skor, ürün detay sayfalarında ve arama sıralamalarında görünürlüğü doğrudan yönlendirir. Aşağı çeken faktörler:

• İptal oranı — Stok-yokluk iptalleri en büyük cezadır; %2'nin üzeri uyarı tetikler, %5'in üzeri hesap askıya alma riski taşır
• Geç sevkiyat — Vaat edilen işleme penceresinde sevk edilmeyen siparişler
• İade oranı — Kategori ortalamasının üzerindeki iadeler skoru aşağı çeker
• Müşteri yorumları — 4.0 yıldız üzerinde kalmalı; Coolblue yorumları ciddiye alır
• Yanıt süresi — Müşteri mesajları 24 saat içinde yanıtlanmalıdır

Zunapro'nun gerçek zamanlı stok senkronu iptal riskini ~%90 azaltır — webshop'unuzda, bol.'da veya Amazon'da bir satış olduğu anda Coolblue stoğu saniyeler içinde güncellenir, satıcı skorlarına zarar veren fazla satışı önler.

Coolblue Reklam, Promosyon ve Akıllı Fiyatlama

Coolblue Reklam Seçenekleri

• Sponsored Products — Arama ve kategori sayfalarında üst yerleşimler (CPC modeli)
• Brand Store sayfaları — Portföy satıcıları için seçilmiş marka iniş sayfaları
• Coolblue's Choice rozeti — Algoritmik olarak verilir; büyük dönüşüm artışı sağlar
• Sezonsal kampanyalar — Black Friday, Sinterklaas, Energy Week (ısı pompaları/güneş)

Akıllı Fiyatlama (Repricer)

Coolblue'nun ürün detay sayfası birden çok satıcı teklifini gösterir. "En iyi fırsat" pozisyonu yalnızca en düşük fiyata değil; fiyat, satıcı skoru ve teslimat vaadi temelinde verilir. Zunapro'nun repricer'ı fiyatlarınızı rakip hareketlerine göre saniyeler içinde ayarlar, ancak her zaman taban marjınıza saygı gösterir, böylece maliyetin altına asla satmazsınız.

Coolblue E-Faturalama — Peppol UBL ve Belastingdienst Uyumluluğu

Coolblue Marketplace'teki tüm satıcılar uyumlu faturalar düzenlemelidir: B2B siparişler için Peppol UBL e-faturalar, B2C tüketiciler için standart PDF/e-posta faturalar — hepsi Hollanda vergi otoritesi (Belastingdienst) kurallarına ve AP (Autoriteit Persoonsgegevens / Hollanda DPA) gizlilik gereksinimlerine uygun. Bunu günde 100 siparişin üzerinde manuel yapmak imkânsızdır.

Zunapro'nun Peppol modülü:

• Bir Coolblue siparişi geldiği anda otomatik Peppol UBL e-fatura üretir
• Sertifikalı Peppol erişim noktaları (Storecove, TIE Kinetix, Pagero ve diğerleri) üzerinden gönderir
• İade ve geri ödemeler için otomatik alacak dekontu düzenler
• Üç aylık KDV (BTW) raporlarını Belastingdienst'e iletir
• Tüketiciye NL, BE-NL, BE-FR veya DE dilinde PDF fatura e-postalar

Coolblue Kargo — Bezorgservice + PostNL + DHL Parcel

Coolblue Marketplace siparişleri üç ana kanal üzerinden sevk edilir: Coolblue Bezorgservice (Coolblue'nun kendi akşam/hafta sonu son-mil ağı, öncelikle 1P ancak en iyi 3P satıcılara da açık), PostNL (Hollanda posta standardı) ve DHL Parcel (sınır ötesi NL/BE/DE). Würselen'den çıkan Alman siparişleri için DHL Parcel ve kendi-filo yönlendirmesi baskındır.

Zunapro'nun çoklu kurye modülü, ağırlık, varış şehri ve müşteri tercihine göre sipariş başına en iyi kuryeyi seçer; etiketi basar ve takip numarasını Coolblue'ya otomatik geri gönderir. Müşteriler Coolblue hesaplarında canlı takip görür — markanın ünlü olduğu "gülümseme" deneyiminin tam karşılığı.

Coolblue İade ve Müşteri Hizmetleri Yönetimi

Hollanda tüketici hukuku alıcılara 14 günlük cayma hakkı ve 2 yıllık yasal garanti verir. Kategori bazlı iade oranları tipik olarak moda tarzı aksesuarlarda %20–25, beyaz eşyada %3–6 ve tüketici elektroniğinde %5–10 seviyesindedir. İadeleri yanlış yönetmek, satıcı skorunuzu batırmanın en hızlı yoludur.

Coolblue Standart İade Akışı:

1. Müşteri, Coolblue hesabında bir iade talebi açar (teslimattan sonra 14 gün içinde)
2. Coolblue, alıcıya ücretsiz bir iade etiketi (PostNL veya DHL Parcel) verir
3. Ürün, satıcı deposuna (veya en iyi 3P ortakları için Coolblue'nun kabul noktasına) ulaşır
4. Satıcı, duruma göre 1–3 iş günü içinde onaylar veya reddeder
5. Onaylanan iadeler, Coolblue ödemeleri üzerinden müşteriye geri ödeme tetikler

Zunapro'nun iade modülü her adımı takip eder, panel bildirimleri gönderir, alacak dekontu Peppol faturasını otomatik düzenler ve Coolblue Returns API'sini günceller. Ayrıca arızalı elektroniklerin WEEE uyumlu imhası için Wecycle ile entegre çalışır.

Zunapro × Coolblue Entegrasyonu — 4 Adımlı Kurulum (15 Dakika)

1. Coolblue Marketplace Kimlik Bilgilerinizi Girin — Zunapro panelinde Pazaryeri → Coolblue'ya gidin ve developers.coolblue.nl'den Seller ID, OAuth 2.0 client ID ve client secret'inizi girin.
2. Webshop'unuzu Bağlayın — Shopify, WooCommerce, Magento, Lightspeed, PrestaShop ve özel REST API'ler için hazır konektörler. API URL'nizi ve erişim anahtarınızı girin.
3. Kategori Eşleştirme Sihirbazı — Webshop kategorilerinizi sürükle-bırak ile Coolblue kategori ağacına atayın. AI önerileri çoğu eşleştirmeyi dakikalar içinde tamamlar; enerji etiketi PDF'leri otomatik iliştirilir.
4. İlk Senkron — Ürünler, stok, fiyatlar, siparişler ve kargo otomatik senkronize olmaya başlar. 15 dakika içinde Coolblue mağazanız Zunapro panelinden tamamen yönetilebilir hale gelir.

Coolblue Entegrasyonu Hakkında Sıkça Sorulan Sorular