N11 Integration: API, XML, 3PL Logistics and Single-Panel Store Management

About N11: Founding, Investors and Market Position

Founding and History (2013 – Today)

N11 was founded in 2013 as a 50-50 joint venture between Doğuş Holding (Turkey) and SK Planet (the technology company within South Korea's SK Group). The launch-era investment was reported at approximately USD 100 million. By combining Turkish retail experience with Korea's advanced e-commerce know-how, N11 quickly rose to the top tier of the Turkish marketplace landscape.

Through the 2010s, the trio of Trendyol, Hepsiburada and N11 shared leadership of Turkey's e-commerce marketplace sector. Following strategic shifts in 2018, SK Planet exited the partnership and Doğuş Holding acquired the remaining shares. In recent years, N11 has pursued a strategy of focusing on a niche market share and high-margin categories rather than aggressive growth, maintaining a loyal user base in the electronics, home & living and fashion verticals. Today, recognized for its purple brand identity, N11 remains one of Turkey's most familiar marketplace brands.

N11 Ownership Structure (2025)

• Doğuş Holding — Sole shareholder (100%, since 2018)
• Ferit Şahenk — Chairman of Doğuş Holding, ultimate owner
• SK Planet (South Korea) — Founding partner (2013-2018), transferred its shares to Doğuş in 2018
• No institutional investors — Family-holding structure

Position in Turkish E-Commerce

As of 2024, N11 holds approximately 5%-7% of the Turkish e-commerce market, making it the third-largest domestic marketplace after Trendyol and Hepsiburada. Known for its purple brand identity and its "Smart Shopping" slogan, N11 is particularly strong in electronics, home & living and fashion categories. Thanks to years of brand recognition, it enjoys a loyal user base.

N11 Sales Volume and Scale (2024–2025 Data)

Over the past five years, N11 has pursued a niche growth strategy, preserving its base of quality sellers and loyal customers. Gross Merchandise Value (GMV) has grown 30%-40% year over year, while the seller count has been kept controlled in line with the niche strategy.

Year	GMV (TRY)	Active Customers	Active Sellers	Strategy
2020	~₺2.5 billion	5M	22K	Broad category
2022	~₺8 billion	4M	20K	Consolidation
2024	~₺18 billion	4M+	25K+	Niche & quality sellers
2025 (projected)	~₺25 billion	4.5M	28K	High-margin categories

This growth has been driven by N11's strength in the electronics and home & living verticals, Doğuş Holding's institutional capital, and the "N11 Premium Seller" program. Compared with giant marketplaces such as Trendyol with 30M users, N11 — as a niche marketplace with less competition — makes it especially easier for new sellers to win the Buy Box.

How to Open an N11 Store (2026 Current Rules)

1. Legal and Financial Requirements

To become a seller on N11, you must have active tax registration in Turkey. Whether you operate as a sole proprietorship, limited company or joint-stock company does not matter; however, you must be an e-Invoice taxpayer and able to issue e-Archive invoices.

• Tax certificate (current year)
• Tax number and Turkish ID number (for sole proprietorships)
• Trade registry gazette (for Ltd./JSC.)
• Signature circular
• Bank account (IBAN) — payouts are sent to this account
• e-Invoice/e-Archive private integrator or GİB portal
• Trademark registration certificate (for protected categories such as cosmetics, food and toys)

2. Applying to the N11 Seller Panel

You submit your application through magaza.n11.com. The approval window is typically 3–5 business days. After approval you receive a seller username, an API key (apiKey) and an API secret (apiSecret) — these are critical for integration. You can access your keys from the N11 panel via Store Info → API Keys.

📥 Official N11 Seller Application magaza.n11.com — free application, 3–5 business days approval →

3. Product Upload and Content Rules

N11 enforces specific content rules for product listings:

• Title: 50–150 characters, brand + product name + key attribute
• Image: white background, minimum 800×800px, up to 8 photos, watermarks/text prohibited
• Description: HTML-supported, minimum 200 characters
• Category mapping: N11 category ID + attributes (color, size, material)
• Barcode (GTIN/EAN): when available, significantly increases match speed
• Stock code: unique SKU required

N11 Commission Rates (2026)

N11 2026 commission rates vary by category between 5% and 20%. 20% VAT plus service fees and shipping costs are added on top of commission. Pricing without computing gross-to-net is the most common seller mistake. Below we summarize the three main commission tiers in an easy-to-understand format:

Net profit formula: Sale price − Commission − VAT − Service fee − Shipping fee − Product cost = Net profit. The Zunapro pricing module performs this calculation automatically for each product and category, ensuring you never sell below your minimum profit threshold.

N11 API Integration — Technical Details

The N11 API is a SOAP + REST hybrid interface that lets sellers programmatically synchronize product, stock, order, price, shipping and return data with N11's systems. API base URL: https://api.n11.com/ws. The N11 API provides product and order operations through classic SOAP services (WSDL), and auxiliary data (categories, cities, etc.) through REST endpoints.

API Authorization

The N11 API uses API key + secret hash-based authorization. With every SOAP request, appKey and appSecret are sent within an auth block. There is no token expiry; however, for security, rotation every 6–12 months is recommended. The official WSDL and documentation are accessible via https://api.n11.com/ws.

Main Endpoint (Service) Categories

• ProductService — Product creation, updates, category mapping, stock and price updates
• CategoryService — Category tree and category attribute queries
• OrderService — Order listing, status updates, package creation
• ShipmentService — Carrier, tracking number and shipping status management
• SettlementService — Payout, invoice and reconciliation data
• CityService — City, district and neighborhood codes
• ClaimService — Return and complaint management

Rate Limits and Error Handling

The N11 API rate limit is approximately 60 requests per minute per seller (SOAP). When exceeded, requests are rejected and errorCode: SERVER_BUSY is returned. Common error codes: INVALID_AUTH (authentication error), PRODUCT_NOT_FOUND (product not found), CATEGORY_NOT_FOUND (category mapping error), SERVER_ERROR (N11 system error — retry). The Zunapro integrator handles these automatically with exponential backoff retry and a dead-letter queue.

N11 XML Integration — Bulk Product Transfer

N11 XML integration is a system that automatically reads the product catalog from a supplier or your own e-commerce site in XML format and transfers it into the N11 seller panel. N11 supports the classic N11 XML format — as an alternative to manual product entry, it lets you upload thousands of products within minutes.

N11 XML Schema Structure

Core fields of the XML uploaded to N11:

• productSellerCode — Seller product code (groups variants)
• brand, title, subtitle, productCode, barcode
• categoryId (N11 category), attributes (color, size, material)
• stockItems (stock), price, currencyType, discount
• shipmentTemplate, preparingDay
• images (1–8 URLs), description (HTML)

Transferring from a Supplier XML to N11

Most wholesalers/suppliers in Turkey (particularly in the Bursa, Konya and İstanbul Laleli/Merter districts) share product catalogs as XML. The Zunapro XML module:

1. Reads the supplier XML URL (hourly/daily cron)
2. Learns category mappings (first mapping is manual, then automatic)
3. Normalizes attributes such as brand, material and size
4. Adds profit margin + commission to the price
5. Tracks stock — automatically deactivates items the supplier runs out of
6. Uploads to N11 via the SOAP API

N11 Logistics and 3PL — N11 Has No Fulfillment Program

Unlike Trendyol's TGF or Hepsiburada's HepsiLojistik, N11 does not operate its own fulfillment program. N11 sellers either ship from their own warehouse or use 3PL (Third Party Logistics) alternatives. This makes N11 less appealing to sellers who want integrated FBA-style logistics, but offers lower commission and service fee advantages for sellers who prefer to manage their own logistics.

3PL Logistics Alternatives

• Hepsijet — Hepsiburada's carrier, also providing 3PL services to N11 sellers
• MNG Lojistik — Combined fulfillment + shipping solution
• Aras Lojistik — Warehousing + packing + shipping
• Independent 3PL providers — Dozens of local 3PLs based in İstanbul, Ankara and İzmir

3PL Costs (approximate, 2025)

• Storage: ₺70–140 per m³/month (3PL provider price range)
• Order processing: ₺5–10 per item
• Return processing: ₺7–12 per return
• Commission advantage: N11 has no fulfillment commission — only the category commission applies

3PL usage becomes cost-effective for N11 sellers with 300+ orders per month. Lower-volume sellers should prefer shipping from their own warehouse.

N11 Store Performance Score and Cancellation Rates

N11 assigns each seller a store rating between 1 and 5 stars; this score directly affects storefront visibility. Meeting certain performance criteria is required for the N11 Premium Seller program. The main factors that lower the score:

• Cancellation rate — Out-of-stock cancellations are the biggest penalty; above 2% triggers warnings, above 5% risks store closure
• Late shipping — Orders not shipped within the preparation window
• Return rate — Returns above the expected level (30%+ is considered natural in fashion)
• Customer reviews — Must stay above 4.5 stars (for Premium)
• Response time — Messages must be answered within 24 hours

With Zunapro's automatic stock synchronization, you reduce cancellation risk by 90%; the moment an item is sold on your site, in your warehouse or on another marketplace, it is instantly deactivated on N11. This significantly improves your chances of being included in the N11 Premium Seller program.

N11 Advertising, Promotions and Smart Pricing

N11 Advertising Platforms

• N11 Sponsored Products — Top placements in search results (CPC-based, TRY/click)
• N11 Smart Marketing — Algorithmic campaign management and budget optimization
• N11 Banner ads — Banners on the homepage and category pages
• Coupons and discount campaigns — N11's seasonal mega-campaigns

Smart Pricing (Repricer)

Buy Box competition on N11 is not as fierce as on Trendyol, but it still matters. When the same product is sold by 5+ sellers, the one with the lowest price (or the highest store rating) wins the Buy Box. The Zunapro repricer module automatically adjusts prices against competitors within seconds — and never drops below your minimum profit threshold. The less competitive environment on N11 makes it easier for new sellers to win the Buy Box compared with other marketplaces.

N11 E-Invoice and E-Archive Integration (GİB Compliance)

All sellers on N11 are required to issue an e-Archive invoice to B2C customers and an e-Invoice to B2B customers (GİB regulation). Manual invoicing is not feasible at 50+ orders per day.

The Zunapro e-Invoice module:

• Automatically issues e-Archive/e-Invoice the moment N11 order data arrives
• Integrated with GİB-approved private integrators (Logo, Mikro, Uyumsoft, Foriba, Veriban, etc.)
• Automatic return invoice in case of returns
• Monthly VAT1 and VAT2 reporting
• Automatic e-Archive PDF delivery to customers via email + SMS

N11 Shipping Integration — Contracted Carriers

N11 does not operate its own carrier. Sellers pick from N11's contracted carriers: Yurtiçi Kargo, Aras Kargo, MNG Kargo, PTT Kargo, Sürat Kargo. The carrier choice can be made per order; the seller determines the best price-speed combination.

The Zunapro multi-carrier module automatically selects the optimal carrier based on order weight, destination city and customer preference; it prints the label and automatically pushes the tracking number to N11. This lets you improve your store rating on N11 through shipping time optimization.

N11 Returns and Customer Service Management

In Turkish e-commerce, return rates are 30%–40% in fashion, 5%–10% in electronics and 10%–15% in home & living. If returns aren't handled correctly, store ratings drop.

N11 Standard Return Process:

1. The customer opens a return request from the N11 panel (within 14 days of delivery)
2. The contracted carrier picks up the item free of charge (1–3 business days)
3. The seller receives and inspects the item
4. The seller approves or rejects the return within 1–3 business days
5. If approved, the customer is refunded to the N11 wallet

The Zunapro returns module tracks all of these steps automatically; it notifies the seller in the panel and automatically issues return invoices for customer returns.

N11 Integration with Zunapro — 4-Step Setup (10 Minutes)

1. Enter your N11 store details — In the Zunapro panel, go to Marketplace → N11 and enter your seller username, API key and API secret.
2. Connect your existing site — Ready-made connectors for Shopify, WooCommerce, OpenCart, İkas, Ticimax, PrestaShop and Magento. Enter the API URL + access key.
3. Category Mapping Wizard — Drag and drop to map your site's categories to N11 categories. AI suggestions complete the process in minutes.
4. Initial Synchronization — Products, stock, prices, orders and shipping — all start syncing automatically. Within 10 minutes, your N11 store is managed from the Zunapro panel.

Frequently Asked Questions About N11 Integration (FAQ)