Çiçeksepeti Integration: API, XML, Cold Chain Logistics and Single-Panel Store Management

About Çiçeksepeti: Founding, Investors and Market Position

Founding and History (2006 – Today)

Çiçeksepeti was founded by Sezer Kavurmacılar in 2006 in Istanbul under the "ÇiçekSepeti.com" brand as the first major online player in the flower and gift sector. Between 2010 and 2015, it became the leader of online flower orders in Turkey; the same-day delivery infrastructure and intra-city rapid distribution model became the company's signature.

In 2018, Esas Holding (the Şahenk family) acquired a majority stake — from that point on, Çiçeksepeti transformed from a flower-only e-commerce site into a multi-category marketplace. The same year, Çiçeksepeti Market (the rapid grocery vertical) was launched; Hediye Sepeti, Çiçeksepeti Lojistik and new mobile-app verticals followed. Today, Çiçeksepeti is a technology ecosystem spanning marketplace (3P), Çiçeksepeti Market, Çiçeksepeti Lojistik (6-hour delivery) and 30+ categories including gifts, cosmetics and toys.

Çiçeksepeti Ownership Structure (2025)

• Esas Holding — Majority shareholder (Şahenk family, 2018 acquisition)
• Sezer Kavurmacılar — Founder, strategic advisor after 2018
• Professional management team — CEO and operational leadership appointed by Esas Holding
• Employee equity program — Minority stake held by senior management and key personnel

Position in Turkish E-Commerce

As of 2024, Çiçeksepeti is the clear leader of Turkey's flower and gift category; it also competes with Trendyol, Hepsiburada and Getir in the rapid grocery (q-commerce) and gift-cosmetics verticals. 8 out of every 10 people shopping for flowers online in Turkey choose Çiçeksepeti. Its mobile app ranks among Turkey's most downloaded shopping apps, especially during Valentine's Day, Mother's Day and Father's Day periods.

Çiçeksepeti Sales Volume and Scale (2024–2025 Data)

Çiçeksepeti has become one of the fastest-growing marketplaces in Turkey under the Esas Holding era after 2018. Its Gross Merchandise Value (GMV) and order volume grew 50–80% year over year; the grocery and gift verticals pushed total revenue far beyond the flower category.

Year	GMV (TRY)	Active Customers	Active Sellers	Featured Vertical
2020	~₺2 billion	5M	5K	Flowers + Gifts
2022	~₺5.5 billion	7M	14K	+ Grocery
2024	~₺12 billion	10M+	30K+	+ Cosmetics + Home & Living
2025 (forecast)	~₺17 billion	12M	40K	+ Toys + Baby

This growth was driven by Çiçeksepeti Lojistik's 6-hour delivery infrastructure in Istanbul, Ankara and Izmir, mobile-app personalization and mega campaigns around Mother's Day and Valentine's Day. Joining Çiçeksepeti as a seller is one of the fastest growth paths in Turkey across flowers, gifts, grocery and cosmetics categories.

Opening a Store on Çiçeksepeti (2026 Current Rules)

1. Legal and Financial Requirements

To become a Çiçeksepeti seller, you must be an active taxpayer in Turkey. Sole proprietorship, limited or joint-stock company — it does not matter; however, being an e-invoice (e-Fatura) taxpayer and able to issue e-Arşiv invoices is mandatory. For flower and grocery categories, a food business registration certificate and proof of suitable storage conditions are additionally required.

• Tax certificate (current year)
• Tax number and Turkish ID number (for sole proprietorship)
• Trade registry gazette (for Ltd./JSC)
• Signature circular
• Bank account (IBAN) — payouts go to this account
• e-Invoice/e-Arşiv private integrator or GİB portal
• Trademark registration (in categories like cosmetics, perfume, toys, gifts)
• Food business registration (for grocery and fresh-product sellers)

2. Apply to the Çiçeksepeti Seller Panel

You apply via satici.ciceksepeti.com. Approval typically takes 3–5 business days. After approval, you are issued a Store ID (Seller ID), API key (apiKey) and API secret (apiSecret) — these are critical for the Zunapro integration.

📥 Official Çiçeksepeti Seller Application satici.ciceksepeti.com — free application, 3–5 business days approval →

3. Product Upload and Content Rules

Çiçeksepeti enforces strict content rules on product listings — especially in flowers, grocery and gifts:

• Title: 40–120 characters, brand + product name + quantity/size (e.g., "25-Stem Red Rose Bouquet")
• Image: White or natural background, minimum 1000×1000px, up to 8 photos, watermark/text prohibited; packaging detail mandatory for flower products
• Description: HTML-supported, minimum 200 characters; shelf life, allergen and storage condition information for flowers/grocery
• Category mapping: Çiçeksepeti category ID + attributes (shelf life, cold chain requirement, allergens)
• Barcode (GTIN/EAN): Mandatory for gift and grocery products
• Content score: Must be 80+; otherwise the product will not appear in the storefront

Çiçeksepeti Commission Rates (2026)

Çiçeksepeti 2026 commission rates vary by category between 7% and 22%. 20% VAT (KDV), service fees and shipping costs are added on top of the commission. Commissions are relatively low on fresh products such as flowers and grocery; they move into the high band for gifts, perfume and jewelry. Pricing without running a gross-to-net calculation is the most common mistake sellers make. Below is an easy-to-understand summary of the three main commission bands:

Net profit calculation: Sale price − Commission − VAT − Service fee − Shipping fee − Product cost = Net profit. For fresh products, you must also factor in the waste rate. The Zunapro pricing module automates this calculation for every product and category; it prevents you from selling below your minimum profit threshold.

Çiçeksepeti API Integration — Technical Details

The Çiçeksepeti API is a RESTful interface that allows sellers to programmatically sync product, stock, order, price, shipping and return data with the Çiçeksepeti system. API base URL: https://apis.ciceksepeti.com/

API Authorization

The Çiçeksepeti API uses API Key + Secret based authorization. The apiKey and apiSecret values are sent in the HTTP Authorization header (or a custom x-api-key header). There is no token expiry; however, rotating them every 6–12 months is recommended for security. Official documentation: https://apis.ciceksepeti.com/docs

Main Endpoint Categories

• Products API — Product creation, update, category mapping, content score query
• Inventory API — Stock and price synchronization (bulk endpoint; real-time stock is critical for fresh products)
• Orders API — Order listing, status update, package creation, 6-hour delivery window management
• Categories API — Querying the 30+ category tree (including flowers, grocery, gifts) and attributes
• Cancellations API — Query and approve/reject cancellation and return requests
• Settlements API — Earnings, invoices and reconciliation

Rate Limit and Error Handling

The Çiçeksepeti API rate limit is approximately 50 requests per minute per seller. When exceeded, it returns 429 Too Many Requests. Common error codes: 400 (invalid product data), 401 (authentication error), 404 (category/barcode not found), 500 (Çiçeksepeti system error — retry). The Zunapro integrator automatically manages these errors with exponential backoff retry and a dead-letter queue.

Çiçeksepeti XML Integration — Bulk Product Transfer

Çiçeksepeti 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 to the Çiçeksepeti seller panel. As an alternative to manual product entry, it lets you upload thousands of products within minutes; it also supports shelf life and cold chain attributes in flower and grocery categories.

XML Schema Structure (Çiçeksepeti-Compatible)

The core fields of the XML to be uploaded to Çiçeksepeti:

• productMainId — Main product code (groups variants)
• brand, title, productCode, stockCode, barcode
• categoryId (Çiçeksepeti category), attributes (size, color, scent, quantity)
• quantity (stock), listPrice, salePrice, vatRate
• shelfLife (shelf life, days), coldChain (true/false), allergens — mandatory in flower and grocery categories
• cargoCompanyId, shipmentAddressId, fastDelivery (eligible for 6-hour)
• images (1–8 URLs), description (HTML)

Transferring from Supplier XML to Çiçeksepeti

Most flower growers in Turkey (especially in Antalya, Izmir and Yalova), gift wholesalers and grocery suppliers share their product catalogs as XML. The Zunapro XML module:

1. Reads the supplier XML URL (hourly/daily cron; every 15 minutes for fresh products)
2. Learns category mapping (first mapping is manual, then automatic)
3. Normalizes attributes such as brand, color, size and shelf life
4. Adds profit margin + commission to price
5. Tracks stock — automatically deactivates products that are out of stock at the supplier or have reached their shelf-life expiration
6. Uploads to Çiçeksepeti via API

Çiçeksepeti Logistics — 6-Hour Delivery and Cold Chain

Çiçeksepeti Lojistik is a fulfillment service in which, after sellers deliver their products to Çiçeksepeti's central warehouses in Istanbul, Ankara and Izmir, storage, cold chain logistics, packaging, shipping and return management are handled entirely by Çiçeksepeti. It is similar to Amazon FBA / Trendyol TGF; however, it stands out in flower and grocery categories with integrated cold chain and a 6-hour delivery commitment. It may be mandatory in some categories for flower and grocery sellers.

Çiçeksepeti Logistics Advantages

• Delivery within 6 hours — Istanbul, Ankara, Izmir; 1 day in other provinces
• Cold chain — Uninterrupted +4°C / +8°C logistics for fresh flowers and grocery products
• High visibility — Products with "Today's Delivery" and "Super Seller" badges appear more prominently in the storefront
• Çiçeksepeti manages customer service — returns, exchanges, fresh-product complaints
• "At your door in 6 hours" label — Boosts Valentine's Day and Mother's Day conversion by 25–40%
• Zero operational load — you handle no packaging, shipping or cold chain tracking

Çiçeksepeti Logistics Costs (2025 approximate)

• Storage (dry): ₺100–180 per m³/month
• Storage (cold chain): ₺250–450 per m³/month
• Order processing: ₺8–15 per product
• Return processing: ₺10–18 per return
• Commission: Standard Çiçeksepeti commission + 1–2% logistics fee

Çiçeksepeti Logistics becomes cost-efficient for sellers with 300+ orders per month, especially those operating in flower/grocery/gift categories. Sellers with lower volume or categories that do not require cold chain may prefer to ship from their own warehouse.

Çiçeksepeti Store Performance Score and Super Seller Program

Çiçeksepeti assigns each seller a store score from 1 to 10; this score directly impacts storefront visibility and eligibility for the Çiçeksepeti Super Seller badge. Main factors that lower your score:

• Fresh-product cancellation rate — Stock-out or damaged-item cancellations in flower and grocery categories are the biggest penalty driver; above 1.5% triggers a warning, above 3% risks store closure
• Late delivery — Orders that miss the 6-hour delivery window cause significant score loss
• Cold chain violation — Fresh products shipped without temperature tracking, if complained about, put both your score and store at risk
• Return rate — In gifts/cosmetics, 10%+ triggers a warning; in flowers, fresh-product complaints are critical
• Customer reviews — Must not fall below 4.2 stars (especially on special days)
• Response time — Messages must be answered within 12 hours; 4 hours during special-day campaigns

The Çiçeksepeti Super Seller program offers storefront priority, campaign invitations and lower logistics fees to high-scoring sellers. With Zunapro's automatic stock synchronization, you reduce your fresh-product cancellation risk by 90%; products sold on your site, in your warehouse or on another marketplace become unavailable on Çiçeksepeti instantly.

Çiçeksepeti Ads, Promotions and Seasonal Campaigns

Çiçeksepeti Advertising Platforms

• Sponsored Products — Top positions on search and category pages (CPC-based, ₺ per click)
• Çiçeksepeti Banner Ads — Homepage and category banner placements, display ads
• Brand store ads — For gift, cosmetics and perfume brands
• Seasonal mega campaigns — Valentine's Day, Mother's Day, Father's Day, Birthday, Teachers' Day

Seasonality and Annual Sales Peaks

The sales curve on Çiçeksepeti is tightly linked to special days. Valentine's Day (February 14), Mother's Day (second Sunday of May), Father's Day (third Sunday of June) and birthday gifts make up 40–55% of annual revenue. During these periods, stock, cold chain capacity and order preparation time become critical. The Zunapro panel helps you prepare ahead of special days with seasonal stock projection and automatic pricing.

Smart Pricing (Repricer)

Competition is intense on Çiçeksepeti in the gift and cosmetics categories. When 10+ sellers list the same product, the seller with the best price (or highest store score + 6-hour delivery) wins the storefront. The Zunapro repricer module adjusts prices against your competitors within seconds — never below your minimum profit threshold; it applies dynamic pricing rules during special-day campaigns.

Çiçeksepeti E-Invoice and E-Arşiv Integration (GİB Compliance)

All sellers selling on Çiçeksepeti are required to issue e-Arşiv invoices to B2C customers and e-Invoices to B2B customers (GİB — Turkish Revenue Administration regulation). It is impossible to issue invoices manually during periods like Valentine's Day and Mother's Day, when 1,000+ orders arrive per day.

The Zunapro e-Invoice module:

• Automatically issues e-Arşiv/e-Invoice the moment Çiçeksepeti order data arrives
• Works with GİB-approved private integrators (Logo, Mikro, Uyumsoft, Foriba, Veriban, etc.)
• Automatic return invoice for returns
• Monthly VAT (KDV1, KDV2) reporting
• Automatic PDF e-Arşiv delivery to the customer via email + SMS

Çiçeksepeti Shipping Integration — Çiçeksepeti Logistics + Others

Çiçeksepeti orders are shipped by default via Çiçeksepeti Lojistik (6-hour delivery in Istanbul, Ankara and Izmir over its own cold-chain-enabled logistics network). For categories other than flowers and grocery, the following can be integrated additionally: Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo, PTT Kargo.

The Zunapro multi-carrier module automatically selects the best shipping company based on order weight, destination city, cold chain requirement and customer preference; it prints labels and automatically sends the tracking number to Çiçeksepeti.

Çiçeksepeti Returns and Customer Service Management

Return rates on Çiçeksepeti are 5–8% in the flower/fresh-product category (usually "arrived damaged/wilted" complaints), 10–15% in gifts/cosmetics and 8–12% in home & living. If the fresh-product return process is not managed correctly, the store score and Super Seller status drop.

Çiçeksepeti Standard Return Process:

1. The customer files a return request via the Çiçeksepeti panel or call center (24 hours for flowers/fresh products, 14 days for other categories)
2. Çiçeksepeti Logistics or the partner carrier picks up the product for free (1–3 business days)
3. The Çiçeksepeti warehouse inspects the item and either routes it to the seller or approves the return
4. The seller approves/rejects the return within 1–3 business days
5. If approved, the customer's money is refunded to the Çiçeksepeti wallet

The Zunapro returns module tracks all of these steps automatically; it sends panel notifications to the seller, issues automatic return invoices for customer returns, and runs special SLA tracking for fresh-product complaints.

Çiçeksepeti Integration with Zunapro — 4-Step Setup (10 Minutes)

1. Enter Your Çiçeksepeti Store Information — In the Zunapro panel, go to Marketplace → Çiçeksepeti and enter your Store ID (Seller ID), API key and API secret.
2. Connect Your Existing Site — Ready-made connectors for Shopify, WooCommerce, OpenCart, İkas, Ticimax, PrestaShop and Magento. You enter the API URL + access key.
3. Category Mapping Wizard — Map your site's categories to Çiçeksepeti categories via drag-and-drop; shelf life / cold chain / allergen attributes for flowers, grocery and gifts are auto-mapped. AI suggestions finish the job within minutes.
4. First Synchronization — Product, stock, price, order, shipping — all start syncing automatically. Within 10 minutes, your Çiçeksepeti store is manageable from the Zunapro panel.

Frequently Asked Questions About Çiçeksepeti Integration (FAQ)