Amazon Turkey Integration: SP-API, XML, FBA, and Single-Panel Store Management

About Amazon Turkey: Founding, Ownership, and Market Position

Founding and History (1994 – Today)

Amazon Inc. was founded in 1994 by Jeff Bezos in Seattle, USA as an online bookstore. It went public on NASDAQ in 1997 (symbol: AMZN) and is today one of the world's largest e-commerce + cloud computing (AWS) companies — a publicly traded technology giant with a market cap of approximately $1.5 trillion. Amazon.com.tr officially launched in the Turkish market in 2018, offering local seller registration, Turkish Lira pricing, and Turkey-based warehouses.

As of 2024, Amazon Turkey has scaled operations to 5 fulfillment centers and a same-day delivery network spanning 17 cities. Globally, Amazon Inc. is a multi-vertical technology ecosystem covering marketplace (3P), private label (1P), FBA fulfillment, AWS cloud, Prime Video, Kindle, Alexa, and many other verticals.

Amazon Ownership Structure (2025)

• Amazon.com Inc. — Publicly listed on NASDAQ (symbol: AMZN), ~$1.5T market cap
• Jeff Bezos — Founder, former CEO (until 2021), Executive Chair; largest individual shareholder (~9%)
• Andy Jassy — Current CEO (since 2021), former AWS president
• Institutional investors — Vanguard, BlackRock, State Street (combined 20%+ passive institutional ownership)
• Amazon Türkiye Perakende Hizmetleri Ltd. Şti. — Turkey-based local legal entity, headquartered in Istanbul

Position in Turkey's E-Commerce

As of 2024, Amazon Turkey ranks as one of the country's leading marketplaces, positioned after Trendyol and Hepsiburada. It is particularly strong in the electronics, books, home and living, and global brand product categories. Thanks to Prime membership, same-day delivery, and the A-to-z Guarantee, it is the marketplace of choice for the premium consumer segment.

Amazon Turkey Sales Volume and Scale (2024–2025 Data)

Amazon Turkey has charted a rapid growth trajectory in Turkish e-commerce over the past 5 years. The estimated GMV (Gross Merchandise Value) and order volume figures below are based on publicly available industry reports and company disclosures.

Year	GMV (TRY)	Active Customers	Active Sellers	Fulfillment Centers
2020	~₺2 billion	3M	30K	2
2022	~₺8 billion	7M	60K	3
2024	~₺22 billion	12M+	100K+	5
2025 (forecast)	~₺32 billion	15M	130K	6

This growth was driven by Amazon's in-house logistics fleet (AMZL TR), Prime same-day delivery, FBA Turkey, and the localization of its global brand portfolio. Joining Amazon Turkey as a seller represents a fast-growth path, particularly in the electronics, books, and global products categories.

Opening a Store on Amazon Turkey (2026 Current Rules)

1. Legal and Financial Requirements

To become a seller on Amazon Turkey, you must have active tax registration in Turkey. Sole proprietorship, limited liability, or joint stock company all qualify; however, being an e-Invoice taxpayer and able to issue e-Archive invoices is mandatory.

• Tax certificate (current year)
• Tax ID and national ID number (for sole proprietorships)
• Trade registry gazette (for LLC / JSC)
• Signature circular
• Bank account (IBAN) — payouts are transferred to this account
• e-Invoice / e-Archive private integrator or the GİB portal
• Identity verification (KYC) — Amazon may conduct a video interview during approval
• Trademark registration certificate (required for Amazon Brand Registry; also required for protected categories such as cosmetics and food)

2. Amazon Seller Central Application

You submit your application through sellercentral.amazon.com.tr. Approval typically takes 5–10 business days and requires KYC and bank verification. After approval, you receive your Seller ID (Merchant Token), Marketplace ID, and SP-API credentials — LWA client_id, client_secret, refresh token — which are critical for integration.

📥 Official Amazon Turkey Seller Application sellercentral.amazon.com.tr — free application, 5–10 business days approval →

3. Product Upload and Content Rules

Amazon enforces some of the industry's strictest content rules for product listings:

• Title: 80–200 characters, brand + product name + key feature (Title Case rule)
• Imagery: Pure white background (RGB 255,255,255), main image at least 1000×1000px, product must fill 85% of the frame, watermarks/text prohibited
• Bullet points: 5 items summarizing product features
• Description / A+ Content: Rich content templates available for Brand Registry-enrolled brands
• Category mapping: Amazon Browse Node ID + attributes
• GTIN / EAN / UPC barcode: Required (except for exempt categories); brand exemption (GTIN exemption) can be requested
• ASIN matching: Requirement to attach to an existing ASIN for identical products

Amazon Turkey Commission Rates (2026)

Amazon Turkey 2026 commission rates (Referral Fee) range from 5% to 22% depending on category. 20% VAT is added to the commission, and if FBA is used, order handling + storage fees apply on top. A monthly seller account subscription fee (Professional plan) also applies. Pricing without calculating gross-to-net is the most common seller mistake. Below is a clear summary of the three main commission bands:

Net profit calculation: Sale price − Referral fee (commission) − VAT − FBA fee (if any) − Monthly subscription share − Cost of goods = Net profit. The Zunapro pricing module performs this calculation automatically for every product and category, ensuring you never sell below your minimum profit threshold.

Amazon SP-API Integration — Technical Details

The Amazon Selling Partner API (SP-API) is a modern RESTful interface (successor to the legacy MWS API) that lets sellers programmatically sync product, inventory, order, price, shipping, return, and reporting data with the Amazon system. For the EU region (including Turkey), the base URL is https://sellingpartnerapi-eu.amazon.com/ — called with the Turkey marketplace ID.

SP-API Authorization

SP-API uses a hybrid Login with Amazon (LWA) OAuth 2.0 + AWS Signature V4 authentication scheme. The flow: the seller authorizes your app → you receive a refresh token → each request generates a short-lived access token from the refresh token → you sign and send it with AWS SigV4. Official documentation: https://developer-docs.amazon.com/sp-api/.

Main Endpoint Categories

• Catalog Items API — Search ASINs in the Amazon catalog, query product attributes
• Listings Items API — Product creation, updates, price and inventory management
• Orders API — Order listing, details, status updates
• Reports API — Sales, inventory, settlement, and performance reports (asynchronous)
• Feeds API — Bulk product/price/inventory upload (XML / Flat File)
• Fulfillment Inbound API — Shipment planning to Amazon warehouses for FBA
• Fulfillment Outbound API — Cross-channel orders via MCF (Multi-Channel Fulfillment)
• Notifications API — Real-time SQS/EventBridge subscriptions to order and inventory events

Rate Limits and Error Handling

SP-API rate limits are managed per endpoint via a token bucket model: typically 1–10 requests per second (e.g., Orders API getOrders 0.0167 req/sec sustained, 20 burst). When exceeded, the API returns 429 Too Many Requests. Common error codes: 400 (invalid data), 401/403 (authentication/signature error), 404 (ASIN/order not found), 500/503 (Amazon system error — retry). The Zunapro integrator manages these errors automatically with exponential backoff retry and a dead-letter queue.

Amazon Turkey XML Integration — Bulk Product Transfer

Amazon Turkey XML integration (known in Amazon parlance as Inventory File / Flat File) is a system that automatically reads the product catalog from your supplier or your own e-commerce site — in XML or category-specific TSV templates — and transfers it into the Amazon catalog via the Feeds API. As an alternative to manual product entry, it enables you to upload thousands of products within minutes.

Flat File / XML Schema Structure (Amazon-Compatible)

Core fields of the feed file to upload to Amazon (vary by category template):

• sku — Seller SKU (unique within Amazon)
• product-id + product-id-type — EAN/UPC/GTIN/ASIN
• item-name (title), brand-name, manufacturer
• item-type / browse_node — Amazon category
• standard-price, quantity, fulfillment-channel (DEFAULT or AMAZON_TR)
• main-image-url, other-image-url1..8
• bullet-point1..5, product-description
• Category-specific attributes (color, size, material, voltage, etc.)

Supplier XML to Amazon TR Transfer

Most wholesalers/suppliers in Turkey share their product catalogs as XML. The Zunapro XML module:

1. Reads the supplier XML URL (hourly/daily cron)
2. Learns the category mapping (Amazon Browse Node — manual the first time, then automatic)
3. Attempts ASIN matching (via GTIN/EAN)
4. Normalizes attributes such as brand, material, and size
5. Adds profit margin + Referral Fee + FBA share to the price
6. Tracks inventory — automatically deactivates products that go out of stock at the supplier
7. Uploads to Amazon via the Feeds API and awaits the result report

FBA Turkey (Fulfillment by Amazon) — Logistics Solution

FBA Turkey (Fulfillment by Amazon Turkey) is the service in which storage, packaging, shipping, and returns management are entirely handled by Amazon once you deliver your products to Amazon warehouses. Globally, FBA is the most critical differentiator Amazon offers.

FBA Turkey Advantages

• Prime badge — Free 1–2 day delivery for Prime members
• Same-day / next-day shipping — Amazon's own logistics fleet (AMZL TR)
• Higher Buy Box probability — FBA products gain a clear edge in Buy Box competition
• Amazon manages customer service — returns, exchanges, A-to-z claims
• "Prime" label — boosts conversion rate by 20–35%
• Zero operational burden — no packing or shipping on your part

FBA Turkey Costs (2025, approximate)

• Storage: ₺80–180 per m³/month (higher in peak season)
• Order handling: ₺8–18 per unit (by size/weight)
• Return processing: ₺12–25 per return
• Referral fee: Standard Amazon commission (FBA does not add commission, but handling/storage are separate)
• Long-term storage fee: Extra fee on inventory older than 365 days

FBA becomes cost-efficient for sellers with 500+ monthly orders. Low-volume sellers should prefer FBM (Fulfillment by Merchant) and ship from their own warehouse.

Amazon Account Health and Performance Metrics

Amazon assigns every seller an Account Health Rating (AHR) score from 1 to 1,000; this Account Health score determines your storefront visibility and whether your account is "Healthy / At Risk / At-Risk." The primary factors that lower the score:

• Order Defect Rate (ODR) — Defective order rate; must remain below 1%; above that risks account suspension
• Late Shipment Rate — Orders not shipped within the handling time; below 4%
• Pre-Fulfillment Cancel Rate — Cancellations due to stock-outs; below 2.5%
• A-to-z Guarantee claims — Complaints opened by the customer directly with Amazon; the heaviest metric for the account
• Policy violations — Counterfeit, authenticity, intellectual property complaints
• Customer response time — Messages must be answered within 24 hours

With Zunapro's automated inventory synchronization, you reduce cancellation risk by 90%; products sold on your website, in your warehouse, or on another marketplace are instantly deactivated on Amazon Turkey, preserving your ODR and cancellation metrics.

Amazon Turkey Advertising, Promotions, and Smart Pricing

Amazon Advertising Platforms

• Sponsored Products — CPC-based ads in search results and on product detail pages (TRY per click)
• Sponsored Brands — Top banner; brand logo + featured product carousel (Brand Registry required)
• Sponsored Display — On-site and off-site retargeting
• Amazon Brand Registry — A+ Content, Storefront, and brand protection for trademark owners
• Coupons & Promotions — Green "coupon" badge in search results

Smart Pricing (Buy Box Repricer)

The Buy Box battle on Amazon is among the most intense competitions in the industry: when 5+ sellers offer the same ASIN, the Buy Box rotates dynamically based on a combination of price + FBA + Account Health + Prime. The Zunapro Buy Box repricer module auto-adjusts prices against your competitors within seconds — never falling below your minimum profit threshold.

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

All sellers operating on Amazon Turkey are required to issue e-Archive invoices to B2C customers and e-Invoices to B2B customers (a regulation of the Turkish Revenue Administration — GİB). Issuing invoices manually is not feasible at 100+ orders per day.

The Zunapro e-Invoice module:

• Automatically issues e-Archive / e-Invoice the moment Amazon TR order data arrives via SP-API
• Works with GİB-approved private integrators (Logo, Mikro, Uyumsoft, Foriba, Veriban, etc.)
• Issues automatic return invoices on returns
• Monthly VAT1 and VAT2 reporting
• Automatic PDF e-Archive delivery to customers via email + SMS

Amazon Turkey Shipping Integration — AMZL TR + Others

If FBA is enabled, Amazon Turkey orders are shipped by default through Amazon's own logistics fleet, AMZL TR (Amazon Logistics Turkey), offering same-day delivery in 17 cities and 1–2 day delivery nationwide. For FBM (ship by yourself), Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo, and PTT Kargo can be integrated.

The Zunapro multi-carrier module automatically selects the most suitable carrier based on order weight, destination city, and customer preference; it prints the label and reports the tracking number back to Amazon via SP-API automatically.

Amazon Turkey Returns and A-to-z Guarantee Management

In Turkish e-commerce, return rates run at 30–40% in fashion, 5–10% in electronics, and 10–15% in home and living. Amazon's A-to-z Guarantee is a global policy that backs customer satisfaction — if mishandled, it can lead all the way to account closure.

Amazon Turkey Standard Return Process:

1. The customer opens a return request from their Amazon account (typically within 30 days of delivery)
2. For FBA products, Amazon auto-approves; for FBM, seller approval is required
3. The carrier collects the return free of charge (FBA); under FBM, return shipping policy is up to the seller
4. The product returns to the seller / Amazon warehouse; the seller inspects within 2 business days
5. If approved, the refund is issued to the customer (Amazon may pre-emptively refund for quick resolution)
6. If the customer is not satisfied, they can open an A-to-z Guarantee claim — this metric directly impacts Account Health

The Zunapro returns module automatically tracks all these steps; it pushes panel notifications to the seller, auto-issues return invoices for customer returns, and provides early warnings on A-to-z risk.

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

1. Enter Your Amazon TR Store Details — In the Zunapro panel, go to Marketplace → Amazon TR and enter your Seller ID, Marketplace ID, and SP-API client_id, client_secret, and refresh token.
2. Connect Your Existing Site — Ready-made connectors for Shopify, WooCommerce, OpenCart, İkas, Ticimax, PrestaShop, and Magento. Just enter the API URL + access key.
3. Category & ASIN Mapping Wizard — Maps your site categories to Amazon Browse Nodes and automatically matches ASINs via GTIN/EAN. New listings are created for unmatched products.
4. First Synchronization — Products, inventory, prices, orders, shipments — all sync automatically via the Feeds API + Listings API. Within 10 minutes, your Amazon Turkey store is fully manageable from the Zunapro panel.

Frequently Asked Questions About Amazon Turkey Integration (FAQ)