Carrefour İspanya Entegrasyonu: Marketplace API, Carrefour Pro ve Omnikanal Satış

Carrefour İspanya Hakkında: Tarihçe, Sahiplik ve Pazar Konumu

Kuruluş ve Tarihçe (1959 – Günümüz)

Carrefour Group, 1959'da Fransa'nın Annecy şehrinde Marcel Fournier ve Denis Defforey ile Jacques Defforey kardeşler tarafından kuruldu; hipermarket kavramının öncüsü olarak dünyanın ilk gerçek hipermarketini 1963'te Sainte-Geneviève-des-Bois'te açtılar. Carrefour España, 1973'te Prat de Llobregat (Barcelona)'da İspanya'nın ilk hipermarketiyle faaliyete başladı; başlangıçta "Pryca" (Precio y Calidad) markası altında hizmet veriyordu. 1999'da Promodès ile birleşmesi ve 2000'de Pryca/Continente'yi Carrefour olarak yeniden markalaması sonrasında grup, İspanya'nın lider hipermarket zinciri olarak konumunu pekiştirdi.

CEO Alexandre Bompard (2017'de atandı) döneminde Carrefour Group geniş çaplı bir dijital dönüşüm başlattı — Carrefour Marketplace 2018'de İspanya'da açıldı, ardından Pasarela Carrefour aynı gün eve teslimat, tüm mağaza filosunda Click&Collect, Carrefour Bio organik özel markası ve Carrefour Pass finansman kartı yatırımları hızlandı. Grup Euronext Paris'te Carrefour SA (EPA:CA) olarak işlem görüyor.

Carrefour İspanya Sahiplik Yapısı (2026)

• Carrefour SA — Ana şirket, Carrefour España SA'nın (Madrid) %100 sahibi
• Euronext Paris (EPA:CA) — Halka açık kotasyon; başlıca kurumsal hissedarlar arasında Peninsula Capital, Galfa ve BlackRock bulunuyor
• Alexandre Bompard — 2017'den beri Carrefour Group Yönetim Kurulu Başkanı ve CEO'su
• Kurucu mirası: Marcel Fournier, Denis Defforey, Jacques Defforey (1959)
• İspanya ülke liderliği: Madrid Genel Merkez (Calle Campezo) merkezli Ülke Direktörü

İspanyol Perakende ve E-Ticaretindeki Konumu

Carrefour, 200+ büyük formatlı hipermarketi ile İspanya'nın mağaza sayısına göre #1 hipermarket zinciridir; Carrefour Market süpermarketleri ve Carrefour Express bakkalları bu yapıyı tamamlar. Gıda perakendesinde Mercadona, Lidl ve Eroski ile, omnikanal ve gıda dışı kategorilerde ise en yakın rakibi olan Hipercor (El Corte Inglés grubu) ile rekabet eder. 17M+ Mi Club Carrefour sadakat üyesiyle — yaklaşık her üç İspanyol hanesinden birinde — Carrefour, saf online oyuncuların ulaşamayacağı CRM, tekrarlayan sipariş ve kanallar arası atıf alanlarında yapısal bir avantaja sahiptir.

Carrefour İspanya Pazar Büyüklüğü ve Online Büyüme (2024–2026)

Carrefour España, Carrefour Group'un Güney Avrupa ayak izindeki dijital büyüme lideridir. Online GMV, 2020 ile 2024 arasında yaklaşık üç katına çıktı — 200+ mağazada Click&Collect, Mi Club Carrefour sadakat motoru ve üçüncü taraf pazaryeri tarafından desteklendi.

Yıl	Online GMV (İspanya)	Sipariş	Mi Club Üyesi	3P Satıcı
2020	~€700M	14M	12M	1,5K
2022	~€1,4B	26M	15M	3K
2024	~€2B	38M	17M+	5K+
2026 (tahmin)	~€2,7B	52M	19M	7K

Bu ivme; Pasarela Carrefour aynı gün şehir içi teslimat, Carrefour Bio organik hattının genişlemesi ve HORECA alıcılarının Carrefour Pro B2B bölümüne istikrarlı geçişi tarafından sürdürülüyor. SaaS odaklı satıcılar için Carrefour İspanya Marketplace, İber Yarımadası'nın en hızlı büyüyen premium perakende kanalıdır.

Carrefour İspanya Marketplace Mağazası Açma (2026 Kuralları)

1. Yasal ve Vergi Gereklilikleri

Carrefour İspanya Marketplace'te listelemek için aktif bir İspanyol veya AB vergi kimliğine ve AEAT (Agencia Tributaria) nezdinde temiz bir alta census kaydına ihtiyacınız vardır. AB sınır ötesi satıcılar KDV için OSS üzerinden kayıt yaptırabilir; İspanya mukimleri genellikle NIF/CIF kullanır.

• NIF / CIF / EU-VAT numarası (autónomo, S.L. veya S.A. kabul edilir)
• Modelo 036 / 037 — perakende faaliyetini onaylayan alta census kaydı (CNAE kodu)
• IBAN — İspanyol veya SEPA bölgesindeki bir bankada hesap
• Facturae düzenleyicisi (B2B zorunlu) ve AEAT tetikleyicileri geçerli olduğunda SII payload yeteneği
• Marka yetkilendirmesi — kozmetik, gıda, elektronik, oyuncak ve markalı moda için gereklidir
• Ürün uygunluğu — CE işareti, AB gıda etiketleme, GDPR/AEPD gizlilik bildirimi, SIGRE/Ecoembes ambalaj kaydı, elektronik için RAEE kaydı

2. Carrefour Satıcı Portalına Başvuru

Başvurunuzu marketplacevendor.carrefour.es üzerinden iletin. Onay tipik olarak 14–21 iş günü sürer. Onay aldığınızda bir Shop ID, Mirakl API anahtarı ve OAuth 2.0 client credentials alırsınız — Zunapro'nun entegrasyonu uçtan uca yürütmek için ihtiyaç duyduğu üç sır budur.

📥 Resmi Carrefour İspanya Satıcı Başvurusu marketplacevendor.carrefour.es — ücretsiz başvuru, 14–21 iş günü onay →

3. Listeleme İçeriği ve Uygunluk Kuralları

Carrefour, kendi özel markasıyla paritetik kalabilmek için süpermarket düzeyinde katı içerik standartları uygular:

• Başlık: 60–180 karakter, marka + ürün + temel öznitelik (İspanyolca; B2B nişleri için İngilizce kabul edilir)
• Görseller: Beyaz arka plan, minimum 1000×1000 piksel, en fazla 10 fotoğraf, filigran veya katman yok
• Açıklama: HTML izinli, minimum 250 karakter; gıda, güzellik ve tekstilde içerik/malzeme listesi zorunlu
• Kategori eşleştirme: Carrefour kategori kimliği + Mirakl öznitelik seti (beden, renk, alerjen, enerji etiketi)
• GTIN / EAN barkodu: Zorunlu — Carrefour katalog eşleştirmesini öncelikle GTIN üzerinden yapar
• İçerik skoru: Görünürlük için 80+ gerekli; daha düşük skorlar genel katalogdan tutulur

Carrefour İspanya Komisyon Oranları (2026)

Carrefour İspanya pazaryeri komisyonları 2026'da kategoriye bağlı olarak %6 ile %22 arasında değişir. Tüm komisyonlara üzerine %21 İspanya KDV'si eklenir; bunun yanı sıra opsiyonel Carrefour Delivery / SEUR / MRW kargo ücretleri ve kullanıldığında Carrefour Logistics fulfillment uygulanır. Oranları okunması kolay üç banda grupladık:

Net marj formülü: Satış fiyatı − Carrefour komisyonu − komisyon üzerine %21 KDV − Kargo maliyeti − Carrefour Logistics ücreti (kullanılıyorsa) − Mal maliyeti = Net kâr. Zunapro fiyatlandırma modülü bu hesaplamayı SKU ve kategori bazında çalıştırır, negatif marjlı SKU'ları işaretler ve yeniden fiyatlandırma kurallarının fiyatları minimum kâr tabanınızın altına itmesini engeller.

Carrefour İspanya Marketplace API — Teknik Detaylar

Carrefour İspanya Marketplace API, Click&Collect, Carrefour Delivery ve Mi Club Carrefour sadakat verileri için özel Carrefour uç noktalarıyla genişletilmiş, Mirakl tabanlı RESTful bir arayüzdür. Base URL: https://api.carrefour.es/marketplace/. Geliştirici dokümantasyonu marketplacevendor.carrefour.es adresinde yayınlanır.

API Yetkilendirme

Carrefour İspanya Marketplace OAuth 2.0 client credentials kullanır. client_id ve client_secret'ınız, her aramada Authorization: Bearer <token> başlığında iletilen kısa ömürlü bir bearer token (tipik olarak 1 saatlik TTL) ile değiştirilir. Mirakl'a özgü uç noktalar, geriye dönük uyumlu akışlar için ayrıca bir X-API-KEY mağaza anahtarını da kabul eder.

Temel Uç Nokta Grupları

• Products / Offers API — Carrefour kataloguna GTIN ile teklif oluşturun, fiyat/stok/durum güncelleyin, içerik skoru doğrulaması çalıştırın
• Inventory API — Toplu stok ve fiyat senkronizasyonu (istek başına 100 teklife kadar)
• Orders API — Click&Collect teslim alımları dahil pazaryeri siparişlerini listeleyin, kabul edin, gönderin ve güncelleyin
• Shipments API — Carrefour Delivery, SEUR, Correos ve MRW için takip numaralarını iletin
• Returns / Claims API — 14 günlük yasal cayma ve 3 yıllık garanti taleplerini yönetin
• Invoices / Settlements API — Komisyon faturalarını, ödeme dökümlerini ve mutabakat raporlarını çekin
• Webhooks — Yeni siparişler, iadeler ve teklif durumu değişiklikleri için gerçek zamanlı push

Rate Limit'ler ve Hata Yönetimi

Varsayılan rate limit satıcı başına saniyede yaklaşık 10 istektir; toplu uç noktalar daha sık çağrı yerine daha büyük payload kabul eder. Yaygın hata kodları: 400 (geçersiz teklif payload'ı), 401 (süresi dolmuş bearer token — OAuth ile yenileyin), 404 (GTIN/kategori bulunamadı), 429 (rate limit), 5xx (Carrefour tarafındaki olay — yeniden dene). Zunapro'nun konnektörü üstel backoff, dead-letter kuyruğu ve otomatik token yenileme uygular.

Click&Collect + Pasarela Carrefour — Omnikanal Üstünlüğü

Saf online bir pazaryeri yerine Carrefour İspanya'da satış yapmanın en büyük tek nedeni fiziksel mağaza ağıdır. Click&Collect aracılığıyla müşteriler carrefour.es'ten sipariş verip 200+ hipermarket, Carrefour Market veya Carrefour Express mağazasının herhangi birinden aynı veya ertesi gün teslim alabilir — kendileri için sıfır kargo maliyetiyle. Çoğu kategori için bu, yalnızca teslimat sunan listelemelere kıyasla dönüşümü %10–20 artırır.

Pasarela Carrefour (Aynı Gün Eve Teslimat)

• Madrid, Barselona, Valencia, Sevilla, Bilbao, Málaga ve 20+ başka şehirde aynı gün ve 2 saatlik teslimat slotları
• Market ve taze ürünler için Carrefour Delivery kendi son mil filosu
• Pazaryeri SKU'ları, Carrefour 1P market ürünleriyle aynı sepete katılır — çapraz satışın doruğu
• Ödeme sırasında Carrefour Pass finansman kartı kullanılabilir — beyaz eşya ve elektronikte tipik AOV artışı

Mi Club Carrefour Sadakat Programı (17M+ Üye)

17M+ aktif üyesiyle Mi Club Carrefour, Avrupa'nın en derin gıda perakende sadakat programlarından biridir. Pazaryeri satıcıları kişiselleştirilmiş teklif sayfalarında görünürlük kazanır, puan çarpanı kampanyalarına katılabilir ve yüksek LTV'li hanelere CRM odaklı push bildirimlerden faydalanır — bu, saf pazaryerlerinin yapısal olarak sahip olmadığı bir kanaldır.

Fulfillment Seçenekleri — Carrefour Logistics, 3PL ve Sınır Ötesi

Carrefour İspanya Marketplace üç fulfillment modelini destekler. AOV, ağırlık kategorisi ve stok devir hızınıza göre seçim yapın:

1. Satıcı Tarafından Gönderim (FBM)

Kendi deponuzdan SEUR, Correos, MRW veya mevcut 3PL'iniz aracılığıyla gönderin. Düşük hacimli satıcılar, büyük boy ürünler ve siparişe göre üretilen kategoriler için en iyisi.

2. Carrefour Logistics (3PL Fulfillment)

• Stok girişini Madrid ve Barselona'daki Carrefour işletimindeki fulfillment merkezlerine yapın
• Carrefour toplama, paketleme, gönderim, iade ve müşteri hizmetlerini yönetir
• "Bugün sipariş ver, yarın teslim" rozetine uygun — %15–25 dönüşüm artışı
• Aylık 500+ sipariş alan ve tahmin edilebilir talebi olan SKU'lar için en iyisi

3. Mağaza Ağı Üzerinden Click&Collect

Stok, 200+ mağaza filosunun içinde veya yakınında konumlandırılır (Carrefour'un ürün yelpazesiyle zaten uyumlu pazaryeri kategorileri için tipik — küçük ev aletleri, mutfak gereçleri, temel oyuncaklar). Müşteriler genellikle aynı gün, sıfır kargo maliyetiyle mağazadan teslim alır. Kargo maliyetinin birim ekonomisini öldüreceği yüksek hacimli, düşük marjlı SKU'lar için idealdir.

Carrefour Fransa Marketplace ile Sınır Ötesi

Onaylı İspanyol satıcılar, aynı Mirakl satıcı hesabıyla Carrefour Fransa Marketplace'e erişim talep edebilir — ayrı bir onboarding olmadan daha büyük Fransa pazarına hızlı bir geçit. Zunapro; katalog, EAN, Fransızca çeviri, Fransız KDV'si (standart %20) ve Chorus Pro e-faturalamayı otomatik eşler.

Carrefour İspanya Satıcı Performans Skorlaması

Carrefour İspanya, süpermarket düzeyinde katı bir performans karnesi uygular. Performansı düşük satıcıların listelemeleri arama ve Buy Box atamasında kısıtlanır:

• İptal oranı — Stok yetersizliği nedeniyle iptaller en büyük eksi puandır; >%2 uyarı tetikler, >%5 mağaza askıya alma riski oluşturur
• Geç gönderim oranı — SLA penceresi içinde kargoya teslim edilmeyen siparişler
• İade oranı — Norm üstü iadeler (moda doğal olarak ~%30 ile izinli)
• Müşteri puanı — 4.0/5 yıldız ve altı algoritmik debost tetikler
• Yanıt süresi — Müşteri mesajları 24 saat içinde, hafta sonları için en fazla 48 saatte yanıtlanmalı

Zunapro'nun otomatik stok senkronizasyonu (3–5 saniye yayılım) iptal riskini yaklaşık %90 azaltır — bir SKU sitenizde, başka bir pazaryerinde veya herhangi bir depodan satıldığında Carrefour teklifi anında güncellenir.

Carrefour Ads, Mi Club Promosyonları ve Repricer

Carrefour İspanya Reklam Yüzeyleri

• Sponsored Products — carrefour.es arama sonuçlarının üst kısmında CPC bazlı yerleşim
• Mi Club Carrefour kişiselleştirilmiş teklifler — 17M+ üyeye sadakat odaklı promosyon push'ları
• Brand Store banner'ları — Carrefour uygulaması ve webinde display kreatif
• Pasarela Carrefour aynı gün promosyonu — 2 saatlik teslimata uygun SKU'larda flash indirim

Akıllı Repricing (Mirakl Buy Box)

Carrefour İspanya, Mirakl'ın teklif sıralama mantığını kullanır — en iyi fiyat + en iyi içerik skoru + en iyi satıcı performansı Buy Box'ı kazanır. Paylaşılan GTIN'lerde rekabet eden 5K+ üçüncü taraf satıcıyla, Buy Box ile ikinci teklif arasındaki fark çoğu zaman birkaç sent olur. Zunapro repricer modülü, minimum kâr tabanınıza dokunmadan canlı rakip verilerine karşı saniyeler içinde yeniden fiyatlandırma yapar.

Carrefour Pro — HORECA ve Profesyoneller için B2B Kanalı

Carrefour Pro, Carrefour İspanya'nın HORECA (oteller, restoranlar, catering), küçük ofisler, okullar, sağlık tesisleri ve serbest meslek sahiplerini hedefleyen B2B bölümüdür. Liste fiyatları KDV hariçtir, minimum sipariş miktarları daha yüksektir ve siparişler tipik olarak tüketici sepetlerinin 2–4 katı AOV'ye sahiptir. Onaylı pazaryeri satıcıları Mirakl satıcı paneli içinden Carrefour Pro dağıtımına katılabilir.

Zunapro çift fiyatlandırma modelini tek yerden yönetir — aynı katalog, iki vitrin, iki KDV mantığı, iki Facturae şablonu.

Carrefour Satıcıları için Facturae, SII ve AEAT Uyumluluğu

İspanyol pazaryeri satıcıları AEAT (Agencia Tributaria) çerçevesinde faaliyet göstermek zorundadır. Carrefour İspanya siparişleri için iki uyumluluk sütunu önemlidir:

• Facturae — B2B ve belirli B2C durumları için zorunlu XML fatura formatı. Alıcı bir kamu kuruluşu olduğunda (FACe üzerinden) ve Carrefour Pro B2B siparişlerinde gereklidir.
• SII (Suministro Inmediato de Información) — Yıllık cirosu 6M Avro'nun üzerinde olan mükellefler için zorunlu, altında ise gönüllü olarak kullanılabilen gerçek zamanlı KDV veri raporlama. Fatura defterleri 4 iş günü içinde AEAT'a gönderilmelidir.
• GDPR ve AEPD — Müşteri verileri AB GDPR ve İspanyol LOPDGDD kapsamında işlenmelidir; AEPD ulusal denetleyici otoritedir.
• 14 günlük yasal cayma — AB tüketici hakkı; tüm B2C siparişlerde uyulmalıdır.
• 3 yıllık garanti — Yeni ürünler için İspanyol mal garanti yükümlülüğü.
• Ambalaj Yasası (SIGRE / Ecoembes) — Ambalaj atığı geri kazanımı için üretici/ithalatçı kaydı.
• RAEE Atık Yasası — Elektrikli ve elektronik ekipman üreticileri/ithalatçıları için zorunlu kayıt.
• CE işareti + AB gıda etiketleme — Geçerli olduğu yerlerde zorunlu; gıda alerjenleri listelemede beyan edilmelidir.

Zunapro Facturae ve SII modülü:

• Bir Carrefour siparişi kargolandığı anda uyumlu Facturae XML'i otomatik düzenler
• Gerçek zamanlı SII payload üretimi ve AEAT'a iletim
• Carrefour Pro B2B ve B2C KDV oranı yönlendirmesi (%21 / %10 / %4 / %0) — gıda için %4 indirimli KDV destekli
• İade ve caymalarda otomatik kredi notu (factura rectificativa) düzenleme
• Aylık Modelo 303 / 390 KDV özet raporları
• İspanyolca veya Türkçe müşteri PDF faturası otomatik e-posta gönderimi

Kargo Entegrasyonu — Carrefour Delivery, SEUR, Correos, MRW

Carrefour İspanya Marketplace siparişleri varsayılan olarak Carrefour Delivery (kendi son mil filosu; market, taze ürünler ve Pasarela Carrefour ile aynı gün şehir teslimatı için optimal) üzerinden gönderilir. Carrefour tarafından gönderilmeyen siparişler için satıcılar üç ana İspanyol kargoyu entegre eder: SEUR (parça + B2B lojistik), Correos (ulusal posta operatörü, geniş kırsal kapsama) ve MRW (yurt içi express).

Zunapro'nun çoklu kargo modülü, koli ağırlığı, hedef posta kodu ve SLA taahhüdü başına en ucuz uyumlu kargoyu otomatik seçer, etiketleri tek tıkla yazdırır ve takip numaralarını Carrefour satıcı paneline geri iletir — manuel kargo portalı girişine gerek yoktur.

İade ve Müşteri Hizmetleri Yönetimi

İspanyol tüketici hukuku alıcılara 14 günlük yasal cayma hakkı ve yeni ürünlerde 3 yıllık garanti tanır. İade oranları kategoriye göre farklılık gösterir: moda %25–35, elektronik %4–8, ev/mutfak %8–12, market bozulma dışında sıfıra yakındır.

Carrefour İspanya iade akışı:

1. Müşteri carrefour.es üzerinden iade açar (teslimattan sonraki 14 gün içinde)
2. Carrefour Delivery veya SEUR, müşteriye ücretsiz olarak koliyi alır (1–3 iş günü)
3. Carrefour deposu inceler ve satıcıya geri yönlendirir ya da iadeyi doğrudan kabul eder
4. Satıcı 1–3 iş günü içinde onaylar veya reddeder
5. Onaylanırsa, iade müşterinin ödeme yöntemine (veya Carrefour cüzdanına) iade edilir
6. Zunapro otomatik olarak Facturae rectificativa (kredi notu) düzenler ve SII kaydını işler

Zunapro Carrefour İspanya Entegrasyonu — Yayına Çıkış için 4 Adım (10 Dakika)

1. Carrefour satıcı kimlik bilgilerinizi girin — Zunapro panelinde Pazaryeri → Carrefour İspanya'ya gidin ve Shop ID, OAuth 2.0 client_id/client_secret ile Mirakl API anahtarınızı yapıştırın.
2. E-ticaret backend'inizi bağlayın — Shopify, WooCommerce, PrestaShop, Magento, BigCommerce ve özel REST API'ler için hazır konnektörler. Mağaza URL'nizi ve erişim token'ınızı girin.
3. Kategori ve öznitelik eşleştirme sihirbazı — Katalog kategorilerinizi sürükle bırak ile Carrefour'un Mirakl kategori ağacına eşleyin. AI önerileri dakikalar içinde eşleştirmelerin %90'ını halleder; EAN/GTIN eşleştirmesi otomatiktir.
4. İlk senkronizasyon — Ürünler, stok, fiyatlar, siparişler, Facturae, SII ve kargo senkronize olmaya başlar. 10 dakika içinde Carrefour İspanya mağazanız tamamen Zunapro panelinden yönetilir hale gelir.

Carrefour İspanya Entegrasyonu — Sıkça Sorulan Sorular