Yoox Integration: Boutique API, Luxury Fashion & End-of-Season Inventory Management

About Yoox: Founders, Ownership and Market Position

Foundation and Brand History (2000 – Today)

Yoox was founded in 2000 in Bologna, Italy by Federico Marchetti, a Bocconi and Columbia Business School graduate widely regarded as the architect of European online luxury retail. Yoox launched with a then-radical thesis: sell previous-season designer fashion at deep discounts through an editorial, magazine-quality digital experience — protecting brand equity in a market where luxury houses feared the internet would cheapen their image.

By 2009 Yoox had IPO'd on Borsa Italiana. In 2015 Yoox merged with Net-a-Porter (founded by Natalie Massenet) to form the YOOX NET-A-PORTER Group (YNAP), instantly creating the world's largest online luxury fashion retailer. In 2018 Swiss luxury conglomerate Richemont acquired full control of YNAP, and in 2025 Richemont executed a strategic demerger: Net-a-Porter, Mr Porter and The Outnet were divested separately, while Yoox itself was sold to Germany-Switzerland luxury e-tailer Mytheresa Group (NYSE-listed: MYTE). Yoox today is a sister brand of Mytheresa under the same parent organization.

Yoox Ownership Structure (2026)

• Mytheresa Group (NYSE:MYTE) — Parent company since the 2025 YNAP demerger
• Federico Marchetti — Founder; transitioned to strategic and sustainability roles after the Richemont era
• Richemont — Historical owner (2018–2025), exited via demerger
• Bologna / Milan operations — Headquarters split: commercial team in Milan, logistics and tech in Bologna and Zola Predosa

Position in European Online Luxury

Yoox sits in a specialized segment of European luxury e-commerce that includes Mytheresa, Farfetch, Matchesfashion (historically) and 24S. Where Mytheresa focuses on current-season full-price luxury, Yoox dominates the off-price / previous-season segment, with annual Italy-only GMV of approximately €400 million on Yoox.com IT. Pre-split, the YNAP perimeter generated over €2 billion in annual revenue. Yoox.com is the destination of choice for designer-aware consumers in Italy, France, Germany, the United States, Japan and South Korea who want authenticated luxury at 30–70% below boutique price.

Yoox Market Size and Volume (2024–2025 Data)

While Yoox does not break out the same scale numbers as a mass-market platform like Amazon or Trendyol, its average order value (AOV) is among the highest in European e-commerce — typically €280–€420 per order versus €40–€70 for mass marketplaces. The economics of online luxury are driven by margin, not volume.

Year	Revenue (YNAP / Yoox)	Active Customers	Brand Partners	Markets
2015 (YNAP merger)	€1.7 billion	2.2M	~800	180+
2020	€2.7 billion	4.1M	~1,000	180+
2024 (YNAP perimeter)	~€2 billion+	5M+	1,000+	180+
2025 (post-demerger, Yoox only)	Yoox.com IT ~€400M	Yoox-perimeter ~3.5M	~1,000	180+

The 2025 demerger means revenue is now reported under Mytheresa Group consolidated accounts. For brands evaluating channel mix, the critical fact is that Yoox remains the largest dedicated online off-price luxury destination globally, with category leadership in Italian-made designer fashion, cashmere outerwear and Italian leather goods.

Becoming a Yoox Brand Partner (2026 Application Rules)

1. Legal and Brand Requirements

Yoox is not an open marketplace. To sell on Yoox you must be approved as an official Brand Partner — typically a fashion house, an authorized distributor, or a curated boutique group holding documented distribution rights. Yoox enforces strict brand and intellectual-property verification to protect its luxury positioning and shield itself from counterfeit risk.

• Trademark registration (EUIPO and/or WIPO) under your legal entity
• Italian Partita IVA or EU equivalent VAT identification
• Chamber of Commerce extract (Visura Camerale or equivalent)
• FatturaPA-capable accounting via the Sistema di Interscambio (SdI)
• Distribution agreement if you are not the brand owner directly
• High-resolution lookbook and editorial product imagery (Yoox typically reshoots in Bologna)
• Sustainability and traceability documentation — increasingly mandatory under EU rules and Yoox's own boutique-tier standards

2. Brand Partnership Application

Applications are submitted via yoox.com/brand-partnership. The Yoox merchandising team reviews brand fit, IP ownership, distribution channel conflict and aesthetic alignment. Approval timelines run 28 to 56 days — significantly longer than mass-market marketplaces because Yoox performs in-depth legal and editorial due diligence. Approved partners receive Brand Partner API credentials, an EDI SFTP account and a dedicated commercial contact.

📥 Official Yoox Seller Application yoox.com/brand-partnership — free application, 28–56 business days approval →

3. Catalog Onboarding and Editorial Standards

Yoox maintains an editorial, magazine-grade product page standard. Most brand partners ship physical samples to Bologna where Yoox's in-house photo studio reshoots every SKU:

• Title: brand + product type + key material (e.g. "Fendi Calfskin Shoulder Bag")
• Imagery: studio reshoots in Bologna, minimum 6 angles, on-model + flat-lay
• Description: bilingual (IT/EN minimum), editorial tone, materials and country of origin
• Category and attributes: Yoox taxonomy with size grid normalized to IT, EU, US, UK, JP
• EAN / GTIN: required for inventory matching and anti-counterfeit traceability
• Sustainability tags: organic, recycled, vintage, GOTS, Yoox X eligibility

Yoox Commission Structure (2026)

Yoox commissions sit at a meaningfully higher band than mass-market marketplaces — reflecting the platform's curated positioning, Bologna fulfillment, in-house photography and global customer base. Expect 30% to 40% commission per sale, plus 22% Italian VAT applied on top of services and any logistics fees. The Yoox.com platform is free for end customers, including free returns in most markets.

Net margin formula: List price − Commission − Italian VAT (22%) − FatturaPA/SdI processing − Bologna fulfillment fee − COGS = Net profit. Because Yoox commissions are materially higher than open marketplaces, Zunapro's pricing module automatically computes the wholesale-equivalent price you need to quote to hit your target margin, and flags SKUs that fall below your minimum profitability threshold.

Yoox Brand Partner API — Technical Architecture

Yoox exposes a hybrid integration architecture combining a modern REST API for transactional flows (orders, returns, shipments, settlement) with traditional EDI feeds (XML / CSV over SFTP) for bulk catalog and inventory updates. This dual model reflects Yoox's enterprise heritage — most luxury houses already operate EDI systems and Yoox does not force a re-platforming.

API Authentication

The Yoox Brand Partner API uses OAuth 2.0 client-credentials. Brand partners receive a client_id and client_secret at onboarding, exchange them for a bearer access_token with a typical TTL of one hour, and include the token in the Authorization header on every request. EDI feeds authenticate via SSH key on the Yoox SFTP endpoint.

Core Endpoint Categories

• Catalog API — SKU creation, attribute updates, editorial copy and image metadata
• Inventory feed (EDI) — Bulk stock and price files, typically refreshed every 15–60 minutes
• Orders API — Order retrieval, status updates, packing slip generation
• Shipments API — Carrier label requests, tracking numbers, proof of delivery
• Returns API — Return authorizations, condition grading, refund triggers
• Settlement API — Monthly reconciliation, commission statements, FatturaPA cross-references
• Webhooks — Order, return and settlement event notifications

Rate Limits and Resilience

The Yoox Brand Partner API enforces per-tenant rate limits to protect the platform. When exceeded, the API returns 429 Too Many Requests with a Retry-After header. Common error codes you need to handle: 400 (invalid SKU payload), 401 (expired OAuth token — refresh and retry), 404 (unknown EAN or category), 409 (concurrent stock conflict), 500 (platform error — exponential backoff). The Zunapro Yoox connector implements OAuth token rotation, exponential backoff with jitter, a dead-letter queue and idempotency keys on every write.

Yoox EDI Catalog Feeds — Bulk Operations at Scale

For high-SKU brand partners, the Yoox EDI channel remains the workhorse for catalog and inventory operations. EDI feeds — typically XML or CSV files dropped on Yoox's SFTP endpoint — are the most efficient way to push thousands of SKUs simultaneously without consuming REST rate budget.

EDI Schema (Yoox-Compliant)

Core fields in the Yoox EDI catalog feed:

• brandCode — Yoox-assigned brand identifier
• modelCode, colorCode, sizeCode, ean
• categoryId (Yoox taxonomy), attributes (material, country of origin, season, gender)
• quantity, retailPrice, discountedPrice, currency (EUR/USD/GBP/CHF/JPY)
• fulfillmentMode (BOLOGNA / DROPSHIP)
• sustainabilityFlags, traceabilityData

From PIM to Yoox via Zunapro

Most luxury brands run a central PIM (Akeneo, Salsify, Pimcore) or ERP (SAP, Stealth Retail) as the source of truth. Zunapro's EDI module:

1. Reads from your PIM/ERP on a configurable cron (every 15 minutes for stock, hourly for prices, daily for new SKUs)
2. Translates your taxonomy into the Yoox category tree with AI-assisted mapping
3. Normalizes size grids (IT → EU → US → UK → JP) per Yoox requirements
4. Applies pricing rules (markdown calendar, MAP enforcement, currency conversion)
5. Generates the EDI file and uploads to the Yoox SFTP endpoint
6. Confirms acknowledgment via the Yoox return feed and surfaces rejections in the panel

Bologna Mega-Warehouse — Yoox Fulfillment Operations

At the heart of Yoox's value proposition is its 600,000 sqm robotic mega-warehouse in Zola Predosa, on the outskirts of Bologna. It is one of the largest dedicated fashion logistics complexes in the European Union and serves global outbound shipping for Yoox.com. The facility houses intake, condition grading, in-house photography studios, robotic put-walls, packing and global carrier integration with TNT-FedEx, DHL, BRT and GLS.

Why Bologna Fulfillment Matters

• Editorial photography — Yoox reshoots inventory in-house, ensuring uniform brand presentation across all SKUs
• Authentication and quality grading — every item is inspected on intake (critical for previous-season and vintage)
• Global outbound — 180+ markets served from a single hub with consolidated customs flows
• Returns processing — Yoox handles end-customer returns, condition re-grading and restock at Bologna
• Operational lift removed — brand partners ship once to Bologna and let Yoox operate the channel

Indicative Bologna Fulfillment Costs (2025–2026)

• Inbound and intake: agreed per Brand Partner contract; typically free for pre-approved seasonal drops
• Storage: included in commission for active SKUs; aged inventory may incur a storage line
• Outbound pick/pack: included in commission for standard SKUs
• Returns processing: included for in-policy returns; out-of-policy returns billed back
• Photography: included for standard product pages; bespoke editorials negotiated separately

For brands with global reach but no in-house European 3PL, Bologna fulfillment is genuinely transformative. Where independent EU fulfillment costs €3–€8 per parcel plus storage, Yoox absorbs operational cost inside its commission — the trade-off being a higher commission band than self-fulfilled marketplaces.

Brand Partner Performance and Quality Standards

Yoox does not publish a public 1–10 seller score the way mass marketplaces do, but every Brand Partner is evaluated quarterly by the merchandising team. Visibility on Yoox.com, homepage placement and editorial features are directly tied to these factors:

• Cancellation and stock-out rate — anything above 1.5% triggers review; chronic stock-outs jeopardize partner status
• On-time inbound to Bologna — seasonal drops must arrive within agreed windows or homepage placement is lost
• Return rate — luxury fashion returns run 25–35% structurally; outliers above 45% require investigation
• Editorial quality — imagery, copy and product accuracy reviewed by the Yoox curation team
• MAP compliance — pricing below contracted minimums on other channels can pause your Yoox visibility

Zunapro real-time stock synchronization reduces Yoox cancellation risk by 90%+ — the moment a unit sells on Mytheresa, Farfetch, your DTC site or a physical boutique, the Yoox stock count drops in seconds.

Yoox Merchandising, Markdown Calendar and Yoox X Sustainability

Editorial and Merchandising Levers

• Homepage placement — negotiated per drop with the merchandising team
• Editorial stories — magazine-style features that drive demand for designated capsules
• Markdown calendar — Yoox runs structured discounting waves (typically −20% → −40% → −60%) timed to season transitions
• Yoox X — the 2018 sustainability boutique focused on organic, recycled, vintage and craft-certified items; preferred placement for eligible SKUs
• Cross-brand capsules — Yoox curates designer collaborations and limited drops with editorial budget behind them

Smart Pricing Without Breaking MAP

Unlike mass marketplaces where a naive repricer races to the bottom, the Yoox luxury repricing problem is to hold MAP on full-price channels while monetizing aged inventory on Yoox. The Zunapro pricing engine respects per-brand MAP windows, markdown calendars and contracted Yoox commission tiers — it reprices only within explicitly authorized markdown waves.

FatturaPA, SdI and Italian Tax Compliance for Yoox

Every Yoox transaction destined for an Italian VAT-registered customer must produce an electronic invoice via FatturaPA submitted through the Sistema di Interscambio (SdI). The Italian Revenue Agency (Agenzia delle Entrate, AdE) is one of the strictest tax authorities in Europe for e-invoicing — manual workflows are not viable at Yoox volumes.

Zunapro FatturaPA module:

• Automatic XML invoice generation as soon as a Yoox order is confirmed
• SdI submission via certified intermediaries (Aruba, TeamSystem, Fattura24, Zucchetti)
• Automatic credit notes (nota di credito) on returns and refunds
• VAT 22% computation, exemptions and OSS/IOSS handling for EU and non-EU customers
• End-customer PDF copy via email plus archival under Italian conservazione sostitutiva rules

Yoox Shipping — TNT-FedEx, DHL, BRT, GLS

Yoox.com orders are dispatched from the Bologna mega-warehouse via a curated set of premium carriers: TNT-FedEx (international express, particularly transatlantic and APAC), DHL Express (EU and global premium tier), BRT / DPD (Italian domestic and Western Europe ground) and GLS (European domestic). The carrier is chosen automatically by Yoox based on destination, weight, customs profile and shipping option selected by the end customer.

For brand partners running their own dropship in parallel with Bologna stock, Zunapro's multi-carrier module connects directly to TNT-FedEx, DHL, BRT and GLS APIs, generates labels, pushes tracking numbers back to Yoox via the Shipments API, and surfaces unified tracking in your panel.

Returns and Customer Service for Yoox Orders

Under Italian and EU consumer law, Yoox grants a 14-day withdrawal right from delivery for all consumer purchases, plus the standard 2-year legal warranty on defects. Practical luxury fashion return rates run 25–35%; Yoox manages the end-customer touchpoint, but financial settlement flows back to the brand partner.

Standard Yoox Returns Flow:

1. Customer initiates return via their Yoox account within 14 days of delivery
2. Yoox sends a prepaid carrier label (TNT-FedEx, DHL, BRT or GLS based on region)
3. Item arrives at Bologna; quality team inspects condition and authentication
4. Approved returns are restocked or routed for second-life handling
5. Customer is refunded to original payment method; brand partner sees the reconciliation in the monthly settlement

Zunapro returns module ingests Yoox return events via webhook, generates Italian credit notes (nota di credito) automatically, updates inventory in your PIM and feeds the data into your unified P&L view.

Italian and EU Legal Framework for Yoox Brand Partners

Operating on Yoox means operating under Italian commercial and tax law plus the EU consumer-protection stack. Key obligations Zunapro automates:

• Italian VAT (IVA) 22% on standard goods, with applicable reduced rates for specific categories
• FatturaPA / SdI mandatory electronic invoicing through Agenzia delle Entrate
• GDPR compliance with the Garante per la protezione dei dati personali as supervisory authority
• 14-day right of withdrawal under the Consumer Code (Codice del Consumo)
• Two-year legal warranty on consumer goods
• REACH compliance for chemicals in textiles, leather treatments and dyes
• EU textile labelling regulation — fiber composition disclosure in all customer-facing copy
• CITES documentation for vintage and exotic-material items (python, crocodile, certain furs)

Zunapro Yoox Integration — 4-Step Setup (Under 30 Minutes)

1. Enter your Brand Partner credentials — In the Zunapro panel, navigate to Marketplace → Yoox and enter your OAuth client_id, client_secret and EDI SFTP key issued by the Yoox onboarding team.
2. Connect your source system — Pre-built connectors for Akeneo, Salsify, Pimcore, SAP, Shopify Plus, Salesforce Commerce, Magento Adobe Commerce and custom ERPs. Authenticate once.
3. Run the taxonomy mapping wizard — Your internal category tree is mapped to the Yoox taxonomy via AI-assisted suggestions; size grids and material attributes are normalized automatically.
4. Trigger first sync — Catalog, stock, prices, orders, shipments and returns synchronize automatically. Your Yoox boutique operations are live from a single panel in under 30 minutes.

Frequently Asked Questions about Yoox Integration