Carrefour Spain Integration: Marketplace API, Carrefour Pro & Omnichannel Sales

About Carrefour Spain: History, Ownership and Market Position

Founding and History (1959 – Today)

The Carrefour Group was founded in 1959 in Annecy, France, by Marcel Fournier and the brothers Denis Defforey and Jacques Defforey, who pioneered the hypermarket concept — the world's first true hypermarket opened in Sainte-Geneviève-des-Bois in 1963. Carrefour España launched in 1973 with Spain's first hypermarket in Prat de Llobregat (Barcelona), originally under the "Pryca" (Precio y Calidad) banner. After merging with Promodès in 1999 and rebranding Pryca/Continente as Carrefour in 2000, the group consolidated its position as Spain's leading hypermarket chain.

Under CEO Alexandre Bompard (appointed 2017), Carrefour Group launched a sweeping digital pivot — the Carrefour Marketplace opened in Spain in 2018, followed by accelerated investment in Pasarela Carrefour same-day home delivery, Click&Collect across the full store fleet, the Carrefour Bio organic private label, and the Carrefour Pass financing card. The group is listed on Euronext Paris as Carrefour SA (EPA:CA).

Carrefour Spain Ownership Structure (2026)

• Carrefour SA — Parent company, 100% owner of Carrefour España SA (Madrid)
• Euronext Paris (EPA:CA) — Public listing; major institutional holders include Peninsula Capital, Galfa, and BlackRock
• Alexandre Bompard — Chairman & CEO of Carrefour Group since 2017
• Founding heritage: Marcel Fournier, Denis Defforey, Jacques Defforey (1959)
• Country leadership Spain: Country Director based at Madrid HQ (Calle Campezo)

Position in Spanish Retail and E-Commerce

Carrefour is Spain's #1 hypermarket chain by store count with 200+ large-format hypermarkets, complemented by Carrefour Market supermarkets and Carrefour Express convenience stores. In food retail it competes with Mercadona, Lidl and Eroski; in omnichannel and non-food categories its closest rival is Hipercor (El Corte Inglés group). With 17M+ Mi Club Carrefour loyalty members — roughly one in three Spanish households — Carrefour holds a structural advantage in CRM, repeat orders and cross-channel attribution that pure online players cannot match.

Carrefour Spain Market Size and Online Growth (2024–2026)

Carrefour España is the digital growth leader inside the Carrefour Group's southern European footprint. Online GMV roughly tripled between 2020 and 2024 — driven by Click&Collect from 200+ stores, the Mi Club Carrefour loyalty engine and the third-party marketplace.

Year	Online GMV (Spain)	Orders	Mi Club Members	3P Sellers
2020	~€700M	14M	12M	1.5K
2022	~€1.4B	26M	15M	3K
2024	~€2B	38M	17M+	5K+
2026 (forecast)	~€2.7B	52M	19M	7K

The pace is propelled by Pasarela Carrefour same-day urban delivery, expansion of the Carrefour Bio organic line and steady migration of HORECA buyers to the Carrefour Pro B2B section. For SaaS-driven sellers, Carrefour Spain Marketplace is the fastest-growing premium retail channel in Iberia.

Opening a Carrefour Spain Marketplace Shop (2026 Rules)

1. Legal and Tax Requirements

To list on the Carrefour Spain Marketplace you need an active Spanish or EU tax identity and clean alta census registration with the AEAT (Agencia Tributaria). EU cross-border sellers can register via OSS for VAT; Spanish residents typically use NIF/CIF.

• NIF / CIF / EU-VAT number (autónomo, S.L. or S.A. all accepted)
• Modelo 036 / 037 — alta census registration confirming retail activity (CNAE code)
• IBAN — settlement bank account at a Spanish or SEPA-zone bank
• Facturae issuer (B2B mandatory) and SII payload capability when AEAT triggers apply
• Brand authorisation — required for cosmetics, food, electronics, toys and branded fashion
• Product compliance — CE marking, EU food labelling, GDPR/AEPD privacy notice, SIGRE/Ecoembes packaging registration, RAEE registration for electronics

2. Apply at the Carrefour Vendor Portal

Submit your application via marketplacevendor.carrefour.es. Approval typically takes 14–21 business days. On approval you receive a Shop ID, Mirakl API key and OAuth 2.0 client credentials — the three secrets Zunapro needs to drive the integration end-to-end.

3. Listing Content and Compliance Rules

Carrefour applies strict, supermarket-grade content standards to keep parity with its own private label:

• Title: 60–180 characters, brand + product + key attribute (in Spanish; English allowed for B2B niches)
• Images: White background, minimum 1000×1000px, up to 10 photos, no watermarks or overlays
• Description: HTML allowed, minimum 250 characters, ingredient/material list mandatory for food, beauty and textiles
• Category mapping: Carrefour category ID + Mirakl attribute set (size, colour, allergens, energy label)
• GTIN / EAN barcode: Required — Carrefour matches catalog primarily on GTIN
• Content score: 80+ required for visibility; lower scores get held back from the public catalog

Carrefour Spain Commission Rates (2026)

Carrefour Spain marketplace commissions range from 6% to 22% in 2026, depending on the category. All commissions are subject to 21% Spanish VAT on top, plus optional Carrefour Delivery / SEUR / MRW shipping fees and Carrefour Logistics fulfillment when used. We've grouped the rates into three easy-to-read bands:

Net margin formula: Sale price − Carrefour commission − 21% VAT on commission − Shipping cost − Carrefour Logistics fee (if used) − Cost of goods = Net profit. The Zunapro pricing module runs this calculation per SKU and per category, flags negative-margin SKUs and prevents repricer rules from pushing prices under your minimum-profit floor.

Carrefour Spain Marketplace API — Technical Details

The Carrefour Spain Marketplace API is a Mirakl-based RESTful interface extended with custom Carrefour endpoints for Click&Collect, Carrefour Delivery and Mi Club Carrefour loyalty data. Base URL: https://api.carrefour.es/marketplace/. Developer documentation is published at marketplacevendor.carrefour.es.

API Authorization

Carrefour Spain Marketplace uses OAuth 2.0 client credentials. Your client_id and client_secret are exchanged for a short-lived bearer token (typically 1 hour TTL), passed in the Authorization: Bearer <token> header on every call. Mirakl-specific endpoints additionally accept an X-API-KEY shop key for backward-compatible flows.

Core Endpoint Groups

• Products / Offers API — Create offers against the Carrefour catalog by GTIN, update price/stock/condition, run content-score validation
• Inventory API — Bulk stock and price sync (up to 100 offers per request)
• Orders API — List, accept, ship and update marketplace orders, including Click&Collect pickups
• Shipments API — Push tracking numbers for Carrefour Delivery, SEUR, Correos and MRW
• Returns / Claims API — Manage 14-day legal withdrawal and 3-year warranty claims
• Invoices / Settlements API — Pull commission invoices, payout statements and reconciliation reports
• Webhooks — Real-time push for new orders, returns and offer status changes

Rate Limits and Error Handling

Default rate limit is around 10 requests per second per seller; bulk endpoints accept larger payloads instead of more frequent calls. Common error codes: 400 (invalid offer payload), 401 (expired bearer token — refresh via OAuth), 404 (GTIN/category not found), 429 (rate limit), 5xx (Carrefour-side incident — retry). Zunapro's connector applies exponential backoff, dead-letter queueing and automatic token refresh.

Click&Collect + Pasarela Carrefour — The Omnichannel Edge

The single biggest reason to sell on Carrefour Spain instead of a pure online marketplace is the physical store network. Through Click&Collect, customers can order on carrefour.es and pick up the same or next day from any of 200+ hypermarkets, Carrefour Market or Carrefour Express stores — at zero shipping cost to them. For most categories that lifts conversion 10–20% versus delivery-only listings.

Pasarela Carrefour (Same-Day Home Delivery)

• Same-day & 2-hour slots in Madrid, Barcelona, Valencia, Sevilla, Bilbao, Málaga and 20+ other cities
• Carrefour Delivery own last-mile fleet for groceries and fresh items
• Marketplace SKUs join the same checkout cart as Carrefour 1P groceries — cross-sell at its peak
• Carrefour Pass financing card available at checkout — typical AOV uplift on appliances and electronics

Mi Club Carrefour Loyalty (17M+ Members)

With 17M+ active members, Mi Club Carrefour is one of Europe's deepest grocery loyalty programs. Marketplace sellers earn visibility on personalised offer pages, can opt into points-multiplier campaigns and benefit from CRM-driven push notifications to high-LTV households — a channel pure-play marketplaces structurally don't have.

Fulfillment Options — Carrefour Logistics, 3PL and Cross-Border

Carrefour Spain Marketplace supports three fulfillment models. Choose by AOV, weight category and how often you turn stock:

1. Seller-Fulfilled (FBM)

Ship from your own warehouse using SEUR, Correos, MRW or your existing 3PL. Best for low-volume sellers, oversized items and made-to-order categories.

2. Carrefour Logistics (3PL Fulfillment)

• Inbound stock to Carrefour-operated fulfillment centers in Madrid and Barcelona
• Carrefour handles pick, pack, ship, returns and customer service
• Eligible for "Today order, tomorrow delivery" badge — conversion uplift 15–25%
• Best for SKUs doing 500+ orders/month with predictable demand

3. Click&Collect via Store Network

Stock is positioned in or near the 200+ store fleet (typical for marketplace categories already aligned with Carrefour's assortment — small appliances, kitchenware, basic toys). Customers pick up in-store, often the same day, with zero shipping cost. Ideal for high-bulk, low-margin SKUs where carrier cost would kill the unit economics.

Cross-Border via Carrefour France Marketplace

Approved Spanish sellers can request access to the Carrefour France Marketplace with the same Mirakl seller account — a fast lane to the larger French market without a separate onboarding. Zunapro maps catalog, EAN, French translation, French VAT (20% standard) and Chorus Pro e-invoicing automatically.

📥 Official Carrefour Spain Seller Application marketplacevendor.carrefour.es — free application, 14–21 business days approval →

Carrefour Spain Seller Performance Scoring

Carrefour Spain applies a strict, supermarket-grade performance scorecard. Listings from underperforming sellers are throttled in search and Buy Box assignment:

• Cancellation rate — Out-of-stock cancellations are the biggest demerit; >2% triggers a warning, >5% risks shop suspension
• Late shipment rate — Orders not handed to the carrier within the SLA window
• Return rate — Above-norm returns (fashion is allowed ~30% naturally)
• Customer rating — 4.0/5 stars and below triggers algorithmic deboost
• Response time — Customer messages must be answered within 24h, 48h max for weekends

Zunapro's automatic stock synchronisation (3–5 second propagation) cuts cancellation risk by roughly 90% — whenever a SKU sells on your site, on another marketplace or out of any warehouse, the Carrefour offer is updated instantly.

Carrefour Ads, Mi Club Promotions and Repricer

Carrefour Spain Advertising Surfaces

• Sponsored Products — CPC-based placement at the top of carrefour.es search results
• Mi Club Carrefour personalised offers — Loyalty-driven promotional pushes to 17M+ members
• Brand Store banners — Display creative inside the Carrefour app and web
• Pasarela Carrefour same-day promo — Flash discounts on SKUs eligible for 2-hour delivery

Smart Repricing (Mirakl Buy Box)

Carrefour Spain uses Mirakl's offer ranking logic — best price + best content score + best seller performance wins the Buy Box. With 5K+ third-party sellers competing on shared GTINs, the gap between Buy Box and second offer is often a few cents. The Zunapro repricer module reprices within seconds against live competitor data while keeping your minimum-profit floor untouched.

Carrefour Pro — The B2B Channel for HORECA and Professionals

Carrefour Pro is Carrefour Spain's B2B section, targeting HORECA (hotels, restaurants, catering), small offices, schools, healthcare facilities and self-employed professionals. List prices are VAT-exclusive, MOQs are higher and orders typically have 2–4x the AOV of consumer baskets. Approved marketplace sellers can opt into Carrefour Pro distribution from inside the Mirakl vendor panel.

Zunapro handles the dual-pricing model — same catalog, two storefronts, two VAT logics, two Facturae templates — in one place.

Facturae, SII and AEAT Compliance for Carrefour Sellers

Spanish marketplace sellers must operate inside the AEAT (Agencia Tributaria) framework. Two compliance pillars matter for Carrefour Spain orders:

• Facturae — Mandatory XML invoice format for B2B and certain B2C cases. Required when the buyer is a public entity (via FACe) and for Carrefour Pro B2B orders.
• SII (Suministro Inmediato de Información) — Mandatory real-time VAT data reporting for taxpayers above €6M annual turnover and voluntarily available below. Invoice books must be sent to AEAT within 4 business days.
• GDPR & AEPD — Customer data must be processed under EU GDPR and Spanish LOPDGDD; AEPD is the national supervisory authority.
• 14-day legal withdrawal — EU consumer right; must be honored on all B2C orders.
• 3-year warranty — Spanish goods warranty obligation for new products.
• Packaging Law (SIGRE / Ecoembes) — Producer/importer registration for packaging waste recovery.
• RAEE Waste Law — Mandatory registration for electrical and electronic equipment producers/importers.
• CE marking + EU food labelling — Required where applicable; food allergens must be declared on the listing.

Zunapro Facturae & SII module:

• Auto-issue compliant Facturae XML the moment a Carrefour order ships
• Real-time SII payload generation and submission to AEAT
• Carrefour Pro B2B vs B2C VAT rate routing (21% / 10% / 4% / 0%) — food at 4% reduced VAT supported
• Auto-issue credit notes (factura rectificativa) on returns and withdrawals
• Monthly Modelo 303 / 390 VAT summary reports
• Customer PDF invoice auto-emailed in Spanish or English

Shipping Integration — Carrefour Delivery, SEUR, Correos, MRW

Carrefour Spain Marketplace orders ship by default through Carrefour Delivery (own last-mile fleet, optimal for groceries, fresh and same-day urban delivery via Pasarela Carrefour). For non-Carrefour-fulfilled orders, sellers integrate the three main Spanish carriers: SEUR (parcel + B2B logistics), Correos (national postal operator, broad rural coverage) and MRW (express domestic).

Zunapro's multi-carrier module auto-selects the cheapest compliant carrier per parcel weight, destination postcode and SLA promise, prints labels in a single click and posts tracking numbers back to the Carrefour seller panel — no manual carrier portal logins.

Returns and Customer Service Management

Spanish consumer law grants buyers a 14-day legal withdrawal right plus a 3-year warranty on new goods. Return rates differ by category: fashion 25–35%, electronics 4–8%, home/kitchen 8–12%, groceries near zero except spoilage.

Carrefour Spain return flow:

1. Customer opens a return in carrefour.es (within 14 days of delivery)
2. Carrefour Delivery or SEUR collects the parcel free of charge to the customer (1–3 business days)
3. Carrefour warehouse inspects and routes back to seller, or accepts the return directly
4. Seller approves or rejects within 1–3 business days
5. If approved, refund is credited to the customer's payment method (or Carrefour wallet)
6. Zunapro auto-issues the Facturae rectificativa (credit note) and books the SII entry

Zunapro Carrefour Spain Integration — 4 Steps to Launch (10 Minutes)

1. Enter your Carrefour vendor credentials — In the Zunapro panel, go to Marketplace → Carrefour Spain and paste your Shop ID, OAuth 2.0 client_id/client_secret and Mirakl API key.
2. Connect your e-commerce backend — Prebuilt connectors for Shopify, WooCommerce, PrestaShop, Magento, BigCommerce and custom REST APIs. Drop in your store URL and access token.
3. Category & attribute mapping wizard — Drag-and-drop your catalog categories to Carrefour's Mirakl category tree. AI suggestions handle 90% of mappings in minutes; EAN/GTIN matching is automatic.
4. First sync — Products, stock, prices, orders, Facturae, SII and shipping all start syncing. Within 10 minutes your Carrefour Spain shop is fully driven from the Zunapro panel.

Carrefour Spain Integration — Frequently Asked Questions