Trendyol Entegrasyonu Rehberi 2026: REST API, XML Bağlantısı ve Tek Panelden Mağaza Yönetimi

2026 Trendyol Entegrasyon Mimarisine Genel Bakış

Trendyol API'sine bağlanmak için doğru yolu seçmek; SKU sayınız, sipariş hacminiz, kullandığınız e-ticaret altyapısı ve marjlarınıza bağlıdır. Aşağıdaki üç yol, Türkiye'deki satıcıların %95'inin tercih ettiği yapılandırmaları kapsar — okurken kendi profilinize en yakın olanı işaretleyin.

1. Trendyol API Mimarisi 2026

Base URL ve Endpoint Yapısı

Trendyol API'sinin tüm production endpoint'leri tek bir base URL altında toplanmıştır: https://api.trendyol.com/sapigw/. SAPIGW kısaltması "Seller API Gateway" anlamına gelir; 2026 itibarıyla SAPIGW v2'ye geçilmiş ve eski v1 endpoint'leri (api.trendyol.com/marketplace/) 1 Mart 2026'da emekliye ayrılmıştır. Yeni entegrasyonlar zorunlu olarak v2 üzerinden gider; legacy v1 kullanan satıcılar 1 Şubat 2026'ya kadar Trendyol'dan migration uyarısı almıştır.

Endpoint'ler şu mantıkla yapılandırılır:

• /suppliers/{supplierId}/products — ürün listele, ekle, güncelle
• /suppliers/{supplierId}/products/price-and-inventory — stok ve fiyat batch güncelleme
• /suppliers/{supplierId}/orders — sipariş listele, durum güncelle
• /suppliers/{supplierId}/shipment-packages/{packageId} — kargo paketi yönetimi
• /suppliers/{supplierId}/returns — iade akışları
• /product-categories — kategori treesi (auth gerektirmez)
• /product-categories/{categoryId}/attributes — kategori başına zorunlu attribute listesi

{supplierId}, Trendyol satıcı panelinden alacağınız 5-6 haneli sayısal Mağaza ID'dir; her API çağrısında URL'de yer alır.

Authentication — Basic Auth + OAuth 2.0 Hibriti

2026 itibarıyla Trendyol API iki katmanlı authentication modeli kullanır: ürün/sipariş/stok endpoint'leri için klasik HTTP Basic Auth, Trendyol Partner Programı kapsamındaki bağımsız entegratörler için ek olarak OAuth 2.0 client_credentials flow. Standart satıcı entegrasyonunda Basic Auth yeterlidir:

POST /sapigw/suppliers/123456/products HTTP/1.1
Host: api.trendyol.com
Authorization: Basic <base64(apiKey:apiSecret)>
User-Agent: 123456 - SelfIntegration
Content-Type: application/json

{
  "items": [
    {
      "barcode": "ZUNA-001-RED-M",
      "title": "Pamuklu Bisiklet Yaka Tişört",
      "productMainId": "ZUNA-001",
      "brandId": 7651,
      "categoryId": 411,
      "quantity": 50,
      "listPrice": 199.90,
      "salePrice": 149.90,
      "vatRate": 20,
      "images": [
        { "url": "https://cdn.example.com/products/001-red-m.jpg" }
      ],
      "attributes": [
        { "attributeId": 47, "attributeValueId": 6927 },
        { "attributeId": 338, "attributeValueId": 4294 }
      ]
    }
  ]
}

Önemli detay: User-Agent header'ı zorunlu ve özel formattadır — {supplierId} - SelfIntegration ya da entegratör adı (örn. 123456 - Zunapro). Bu header eksik olursa Trendyol istek başarısız olur ve hata mesajı vermez; sessiz fail yaşanır. 2026 yenilikleri arasında bu header artık her istekte zorunlu hale geldi.

Rate Limit Sistemi

Trendyol rate limit'leri endpoint bazlıdır ve "sliding window" algoritmasıyla uygulanır. 2026 itibarıyla geçerli üst sınırlar:

• Ürün listele / ekle: 600 istek / dakika / supplier
• Stok-fiyat güncelle (batch): 1000 istek / dakika / supplier
• Sipariş listele: 100 istek / dakika / supplier
• Sipariş durum güncelle: 600 istek / dakika / supplier
• Kategori / attribute meta (public): 60 istek / dakika / IP

Limit aşımında HTTP 429 Too Many Requests döner ve Retry-After header'ında bekleme süresi (saniye) gelir. Üst üste 3 kez 429 alırsanız Trendyol IP'nizi 5 dakika geçici banlar — bu nedenle exponential backoff (1s, 2s, 4s, 8s, 16s) ve token bucket pattern endüstri standardıdır. Zunapro tüm Trendyol çağrılarını Redis tabanlı bir rate-limit kuyruğundan geçirir ve batch boyutunu 1000'in altında tutarak limit aşımını yapısal olarak engeller.

Webhook Modeli

Trendyol API'si, sipariş yaşam döngüsündeki değişiklikleri webhook üzerinden push'lar. 2026 itibarıyla desteklenen webhook event tipleri:

• order.created — yeni sipariş geldi
• order.cancelled — sipariş iptal edildi (müşteri / satıcı / sistem)
• order.shipped — kargo bilgisi girildi
• order.delivered — kargo teslim edildi
• order.returned — iade talebi açıldı
• product.approved — ürün onaylandı, listede yayında
• product.rejected — ürün reddedildi (sebep mesajı ile birlikte)

Webhook handler'ınızın HTTP 200 OK yanıtı 5 saniye içinde dönmesi gerekir; aksi halde Trendyol 15dk → 1sa → 6sa retry zinciri uygular. 3 retry sonrası başarısız olursa event "webhook miss" olarak işaretlenir ve siparişi manuel polling ile çekmeniz gerekir. Idempotency kritik: aynı event ID iki kere gelebilir, handler'ınızın bunu db-level unique constraint ile koruması şart.

2. REST API ile Bağlanma — Adım Adım

Adım 1 — Trendyol Satıcı Hesabı Açılışı

Trendyol satıcı olmak için partner.trendyol.com üzerinden başvuru yapılır. Gereken belgeler:

• Vergi levhası (şahıs şirketi veya tüzel kişilik)
• İmza sirküleri (ltd./a.ş. için)
• Faaliyet belgesi (Ticaret Odası / Esnaf Odası)
• ETBİS kayıt belgesi (Elektronik Ticaret Bilgi Sistemi — Ticaret Bakanlığı)
• Banka hesap bilgileri (IBAN, ödeme hesabı)
• e-Fatura mükellefiyeti (GİB kaydı)

Onay süreci 2026 itibarıyla ortalama 3-7 iş günü sürer. Yabancı satıcılar (Global Seller programı) için ek olarak Türkiye'de vergi temsilcisi atama belgesi istenir; onay süresi 2-4 haftaya çıkabilir.

Adım 2 — API Anahtarı Oluşturma

Satıcı hesabınız aktifleştikten sonra partner.trendyol.com → Hesabım → Entegrasyon Bilgileri menüsüne gidin. Burada:

• Supplier ID (Mağaza ID): Otomatik atanır, değiştirilemez
• API Key: Auto-generate; her hesap için tek
• API Secret: Auto-generate; saklanması zorunlu (görüntüleme bir defalıktır)
• Webhook URL: Sipariş ve ürün event'lerini alacağınız endpoint
• IP Whitelist: (opsiyonel) Production endpoint'lere erişimi belirli IP'lere kısıtlamak için

Anahtarlar oluşturulduktan sonra Zunapro panelindeki Trendyol tile'a yapıştırmanız yeterlidir — handshake ve ilk senkron 2-3 dakikada otomatik tamamlanır.

Adım 3 — İlk Ürün POST Request

API anahtarı doğrulamasının ardından, ilk gerçek istek genellikle tek ürünlü bir test POST'u olur:

curl -X POST 'https://api.trendyol.com/sapigw/suppliers/123456/v2/products' \
  -H 'Authorization: Basic eW91ckFwaUtleTp5b3VyU2VjcmV0' \
  -H 'User-Agent: 123456 - SelfIntegration' \
  -H 'Content-Type: application/json' \
  -d '{
    "items": [{
      "barcode": "TEST-ZUNA-001",
      "title": "Test Ürün — Pamuklu Tişört",
      "productMainId": "TEST-ZUNA",
      "brandId": 7651,
      "categoryId": 411,
      "quantity": 10,
      "stockCode": "TEST-ZUNA-001",
      "dimensionalWeight": 1,
      "description": "Test ürün açıklaması.",
      "currencyType": "TRY",
      "listPrice": 99.90,
      "salePrice": 79.90,
      "vatRate": 20,
      "cargoCompanyId": 17,
      "images": [{"url": "https://cdn.example.com/test.jpg"}],
      "attributes": [
        {"attributeId": 47, "attributeValueId": 6927},
        {"attributeId": 338, "attributeValueId": 4294}
      ]
    }]
  }'

Başarılı response — batch request ID dönen — bir asenkron iş başlatır. Trendyol ürünü 24 saat içinde inceler ve product.approved ya da product.rejected webhook'u tetikler. Bu süre 2026'da yeni satıcılar için 48 saate kadar uzayabilir.

3. Ürün Senkronizasyonu — Bulk Upload, Kategori, Attribute

Bulk Upload — 1000 Ürün/Seferinde

Trendyol API'si tek POST request'inde maksimum 1000 ürün kabul eder. Daha büyük katalogların batch'lere bölünmesi gerekir. Zunapro bu işlemi otomatik chunk'lar:

• 10,000 SKU için 10 batch — her biri 1000 ürün
• Batch'ler arası 600ms uyku — rate limit güvenliği
• Her batch ID'si Redis kuyruğunda takip edilir
• Trendyol'un async response'u (batchRequestId) ile durum sorgulanır

Tipik bir 10K ürünlü katalog ilk senkronda ~12 dakikada Trendyol'a yüklenir; sonraki delta senkronlar (sadece değişen alanlar) 1-2 dakikada tamamlanır.

Kategori Eşleştirme — Trendyol Tree

Trendyol kategori ağacı 6,000+ alt kategori içerir ve her kategori farklı zorunlu attribute seti talep eder. Yanlış kategori seçimi anında ürünün "Onay Bekleniyor" durumunda donmasına yol açar. Doğru kategori bulma stratejileri:

• Manuel arama — /product-categories response'unu indir, ürün adında geçen anahtar kelimelerle eşleştir (basit ama yavaş)
• ML tabanlı öneri — ürün başlık + açıklama + brand text'ini bir sınıflandırıcıya ver (Zunapro yaklaşımı, %94 doğruluk)
• Trendyol "Kategori Öneri" API'si — beta, sadece seçili satıcılar için 2026'da açıldı; başlık verince top-3 kategori önerir

Attribute Validation

Her kategorinin zorunlu (required) ve opsiyonel attribute listesi vardır. Örneğin "Kadın Tişört" kategorisi (categoryId 411) için zorunlu attribute'lar:

• Renk (attributeId 47) — sabit liste, free-text kabul edilmez
• Beden (attributeId 338) — XS, S, M, L, XL, XXL liste
• Materyal (attributeId 5723) — pamuk, polyester, viskon vb.
• Cinsiyet (attributeId 14) — Kadın / Erkek / Unisex
• Yaka tipi (attributeId 122) — Bisiklet / V / O / Polo
• Koleksiyon (attributeId 200) — varyant grup ID için

Bir alanı eksik gönderirseniz response: {"errors": [{"key": "attributes.materyal", "message": "Materyal alanı zorunludur."}]} şeklinde 422 Unprocessable Entity döner. Zunapro her kategori için zorunlu attribute'ları üst panelde göstererek master katalog hazırlanırken eksik alanları "kırmızı uyarı" olarak işaretler.

Image Upload — URL veya Base64

Trendyol görselleri kendi CDN'ine kopyalar; sizin sunucunuza ait public URL veya base64-encoded inline image gönderebilirsiniz:

• URL yöntemi (önerilen) — public, HTTPS, 1500×1500 minimum, JPG/PNG, max 5MB
• Base64 yöntemi — payload boyutu 5x artar, sadece düşük SKU'lu kataloglar için
• Çoklu görsel — ürün başına 8'e kadar görsel, images array'inde sırayla
• Beyaz arka plan — moda ve elektronik kategorilerinde zorunlu, aksi reddedilir

4. Sipariş Yönetimi — Webhook, Durum Akışı, Trendyol Express

Sipariş Yaşam Döngüsü

Trendyol siparişi 2026 itibarıyla şu durum geçişlerinden geçer:

• Created — müşteri sipariş verdi, ödeme onaylandı
• Picking — satıcı hazırlığa başladı (manuel veya FBA otomatik)
• Invoiced — e-Fatura kesildi, ETTN sisteme işlendi
• Shipped — kargo paketi teslim alındı, takip numarası girildi
• InTransit — kargo aracında, müşteriye gidiyor
• Delivered — müşteriye teslim edildi
• UnDelivered / UnSupplied — teslim alınamadı (geri dönüş)
• Returned — iade talebi açıldı / tamamlandı
• Cancelled — müşteri/satıcı/sistem iptal etti

Webhook Konfigürasyonu

Sipariş webhook URL'sini Trendyol satıcı paneli → Entegrasyon Bilgileri → Webhook Ayarları menüsünden tek bir HTTPS endpoint olarak tanımlarsınız. 2026 itibarıyla webhook için HMAC-SHA256 signature doğrulama zorunlu hale geldi:

POST https://yourdomain.com/webhooks/trendyol HTTP/1.1
Content-Type: application/json
X-Trendyol-Signature: sha256=a3f4b1c2d5e6...
X-Trendyol-Event: order.created
X-Trendyol-Event-Id: evt_8f2a91...

{
  "orderId": 982374521,
  "orderNumber": "TY-20260609-58271",
  "supplierId": 123456,
  "status": "Created",
  "totalPrice": 449.80,
  "currencyCode": "TRY",
  "customerEmail": "[email protected]",
  "shipmentAddress": { ... },
  "lines": [ { "productCode": "ZUNA-001-RED-M", "quantity": 2, ... } ]
}

Signature doğrulaması: HMAC-SHA256(webhook_secret, raw_body) ile X-Trendyol-Signature header'ı karşılaştırılır. Eşleşmezse 401 dönmeli, log'a yazmalı, asla işlememeli — bu adım sahte webhook saldırılarını engeller.

Durum Güncellemeleri

Satıcı tarafında manuel durum güncellemesi için:

PUT /sapigw/suppliers/123456/shipment-packages/8273645 HTTP/1.1
Authorization: Basic ...
Content-Type: application/json

{
  "lines": [ { "lineId": 12345678, "quantity": 2 } ],
  "params": {
    "cargoTrackingNumber": "TY9876543210",
    "cargoProviderId": 17
  },
  "status": "Picking"
}

Trendyol'un kargo şirketi ID listesi 20 kadar firma içerir: Yurtiçi (17), Aras (10), MNG (19), PTT (4), Trendyol Express (30) ana olanlar. cargoTrackingNumber mutlaka kargo firmasının ana sistemine de girilmiş olmalı — aksi halde "izlenemeyen kargo" alert'i tetiklenir ve satıcı puanı düşer.

İptal ve İade Akışı

Sipariş iptali iki taraflıdır:

• Müşteri iptali — Trendyol panelinden müşteri iptal ettiğinde webhook ile bildirilir; satıcı sadece onaylar
• Satıcı iptali — Stok yok / hatalı listeleme durumlarında satıcı iptal eder; Trendyol bunu hesap puanına yansıtır
• Sistem iptali — Ödeme reddedildiğinde otomatik

İade akışı 14 günlük cayma hakkı (TKHK m. 48) çerçevesinde işler. Müşteri "İade Talebi Aç" dediğinde order.returned webhook'u tetiklenir; satıcının 3 iş günü içinde onay/red yanıtı gerekir. Reddedilen iade Trendyol satıcı temsilcisine eskalasyon hakkı doğurur — kötüye kullanım satıcı puanını sert düşürür.

Trendyol Express Barkod

2026 itibarıyla Trendyol Express seçen siparişlerde otomatik barkod üretimi aktiftir. /shipment-packages/{id}/cargo-label endpoint'i PDF formatında etiket döner; etiket üzerinde kargo takip kodu, müşteri adresi, paket boyutu ve QR kodu bulunur. Etiketi yazıcıdan basıp paket üzerine yapıştırırsınız; Trendyol Express kuryesi QR'ı okutarak tek tıkla teslim alır.

5. Stok ve Fiyat Güncellemesi — Gerçek Zamanlı Senkron

Real-Time Stok Push

Stok güncellemesi Trendyol entegrasyonunun en kritik akışıdır — yanlış stok = aşırı satış (over-sell) = sipariş iptali = satıcı puanı düşüşü. Doğru mimari:

• Event-driven push — yerel envanterde her stok değişikliği bir event tetikler, anında Trendyol'a PUT atılır
• Batch dakikalık fallback — event miss'lere karşı 60 saniyede bir tam senkron
• Multi-marketplace race condition koruması — aynı SKU 5 farklı pazaryerinde varsa "son satılan kazanır" değil "rezerve kuyruk" mantığı çalışır

Endpoint:

POST /sapigw/suppliers/123456/products/price-and-inventory HTTP/1.1
Authorization: Basic ...
Content-Type: application/json

{
  "items": [
    { "barcode": "ZUNA-001-RED-M", "quantity": 47, "salePrice": 149.90, "listPrice": 199.90 },
    { "barcode": "ZUNA-001-RED-L", "quantity": 23, "salePrice": 149.90, "listPrice": 199.90 },
    { "barcode": "ZUNA-001-BLUE-M", "quantity": 0, "salePrice": 149.90, "listPrice": 199.90 }
  ]
}

Tek istekte 1000 SKU'ya kadar batch update. Response asenkron batchRequestId döner; /products/batch-requests/{id} endpoint'inden 30 saniye sonra sonuç çekilir.

Fiyat Kuralları — KDV Dahil Kuralı

Trendyol fiyatları KDV dahil gönderilir. 2026 KDV oranları:

• %20 — standart oran (elektronik, giyim, ev eşyası, kozmetik)
• %10 — indirimli oran (gıda, hijyen, kitap, dergiler)
• %1 — özel oran (un, ekmek, süt, taze sebze-meyve)

vatRate alanı her ürün için zorunlu; salePrice alanı KDV dahildir. Yanlış oran beyanı, GİB cezasına ve geriye dönük komisyon düzeltmesine yol açar.

Trendyol Hızlı Satış (Fast Selling) Kuralları

"Hızlı Satış" rozeti — listede ürünün yanında turuncu "Hızlı Satış" etiketi — ürünün dönüşüm oranını %25-40 artırır. Kuralları:

• Son 7 günde minimum 10 satış
• Stok > 20 birim
• Satıcı puanı > 9.0 / 10
• Kargo süresi ortalama < 24 saat
• Müşteri iade oranı < %5

Kampanya Senkronu

Trendyol periyodik kampanyalar düzenler: Trendyol Günleri (Mayıs, Kasım), Black Friday, 11.11, Yılbaşı vb. Satıcı bu kampanyalara /promotions endpoint'inden katılır; özel indirim oranı tanımlar (örn. baz fiyat üzerinden %15 ek indirim). Zunapro kampanya takvimini master kataloga eşleyip otomatik fiyat snapshot'ı alır — kampanya bitince eski fiyata geri döner.

6. XML/CSV Entegrasyon Alternatifi

Ne Zaman XML Tercih Edilir?

REST API her zaman birinci tercihtir; ama bazı senaryolarda XML/CSV daha pratik olur:

• < 500 SKU statik katalog — fiyatlar nadir değişir, gerçek zamanlı senkron gereksiz
• Düşük teknik kapasite — REST API entegrasyonu için yazılım ekibi yok, sadece bir SaaS feed üretici var (örn. Shopify CSV export)
• Geçici / sezonluk kataloglar — promosyon dönemi ürünleri, 1-2 ay sonra kaldırılacak
• Toptan-perakende ayrımı — sadece belli ürünleri Trendyol'a açan kataloglar

XML Feed Şeması

Trendyol XML feed'i Trendyol'un beklediği standart şemaya uyar — UTF-8 encoding, kök eleman <products>, her ürün <product> içinde:

<?xml version="1.0" encoding="UTF-8"?>
<products>
  <product>
    <barcode>ZUNA-001-RED-M</barcode>
    <title><![CDATA[Pamuklu Bisiklet Yaka Tişört]]></title>
    <productMainId>ZUNA-001</productMainId>
    <brandName>Zuna</brandName>
    <categoryName>Kadın > Giyim > Tişört</categoryName>
    <quantity>50</quantity>
    <listPrice>199.90</listPrice>
    <salePrice>149.90</salePrice>
    <vatRate>20</vatRate>
    <currencyType>TRY</currencyType>
    <images>
      <image>https://cdn.example.com/products/001-red-m.jpg</image>
    </images>
    <attributes>
      <attribute name="Renk">Kırmızı</attribute>
      <attribute name="Beden">M</attribute>
    </attributes>
  </product>
</products>

Pull Frekansı ve Sınırlamalar

Trendyol XML feed'i saatlik pull yapar — yani stok-fiyat güncellemeleri ortalama 30 dakika gecikir. Karşılaştırma:

• REST API push: ortalama 2-5 saniye gecikme
• XML feed pull: ortalama 30 dakika (en kötü 60 dk)
• Sipariş yönetimi: XML modeli sadece ürün senkronu içindir — sipariş + stok güncellemesi yine REST API gerekir

Hibrit model: Bazı satıcılar büyük katalogları XML ile gönderir (ilk yükleme), günlük operasyonu REST ile yapar. Zunapro her iki yolu da destekler, otomatik geçiş öğretebilir.

7. Trendyol Express FBA — Lojistik Entegrasyon

FBA Trendyol Nedir?

Trendyol Express FBA (Fulfillment by Trendyol), Amazon FBA'nın Türkiye karşılığıdır. Stoğunuzu Trendyol'un lojistik merkezlerine (Gebze, Ankara, İzmir) gönderirsiniz; Trendyol pick&pack, kargolama, müşteri iadeleri ve müşteri hizmetlerini üstlenir. Avantajlar:

• "Aynı Gün Kargo" rozeti — dönüşüm %35-50 artar
• "Yarın Teslim" rozeti — özellikle İstanbul/Ankara/İzmir için
• Hızlı Satış kriterlerini otomatik karşılar
• Müşteri hizmetleri Trendyol tarafından — sizin destek yükünüz düşer
• İade operasyonu otomatik — Trendyol kalite kontrolünden geçirip stoğa geri ekler

FBA Başvuru Süreci

FBA başvurusu satıcı panelinden "Trendyol Express FBA" sekmesinden yapılır. 2026 itibarıyla başvuru kriterleri:

• En az 3 ay aktif satıcı geçmişi
• Satıcı puanı > 9.0 / 10
• Aylık ortalama 200+ sipariş
• Aktif iade oranı < %8
• e-Fatura entegrasyonu tam çalışır durumda

Onay 5-10 iş günü içinde gelir; akabinde Trendyol size depo randevu URL'si paylaşır. İlk gönderi minimum 50 SKU × 20 birim = 1000 birim önerilir; daha küçük gönderiler ekonomik değildir.

FBA Fee Yapısı 2026

FBA komisyon dışında ek üç ücret kalemi vardır:

• Aylık m³ depolama: 65-90 TL / m³ / ay (kategori bazlı)
• Pick&pack: 8-18 TL / sipariş (paket boyutuna göre)
• Kargo: Trendyol Express tarifesi — genelde piyasanın %15-25 altında
• İade işleme: 12 TL / iade (kalite kontrolü + stoğa ekleme)

Toplam: tipik bir SKU için FBA, self-shipping'e göre %8-15 daha pahalı; ancak "Aynı Gün Kargo" rozetinden gelen ek satış bunu fazlasıyla telafi eder.

8. e-Fatura Entegrasyonu — GİB Uyumu

Yasal Zorunluluk

2026 itibarıyla Türkiye'de tüm marketplace siparişleri için e-Fatura veya e-Arşiv Fatura kesilmesi zorunludur (GİB Vergi Usul Kanunu Tebliği No. 509, 526, 535). Mükellefiyet sınırı:

• 5 milyon TL ve üzeri yıllık ciro: e-Fatura zorunlu (B2B faturalar)
• 500 bin TL ve üzeri yıllık ciro: e-Arşiv Fatura zorunlu (B2C faturalar)
• Internet satışı yapan tüm satıcılar: ciro fark etmeksizin e-Arşiv zorunlu (2026 güncel)

Entegratör Seçimi

e-Fatura kesimi için GİB lisanslı bir özel entegratör kullanırsınız. 2026'da en yaygın olanlar:

• Logo İşbaşı / Logo e-Fatura — büyük işletmeler için tam ERP entegrasyonlu
• Mikro Yazılım — küçük-orta ölçek, ön muhasebe entegre
• Uyumsoft — bulut tabanlı, marketplace satıcıları için popüler
• Foriba (QNB Foriba) — kurumsal müşteriler, banka entegrasyonu
• Veriban — esnek tarifeli, KOBİ odaklı
• Edoksis, İzibiz, Nesbilgi — diğer aktif entegratörler

Otomatik Fatura Akışı

Trendyol siparişi geldiğinde Zunapro otomatik şu adımları çalıştırır:

1. Webhook ile sipariş datası alınır
2. Müşteri TC kimlik / vergi numarası kontrol edilir (B2B mi B2C mi)
3. Entegratör API'sine UBL 2.1 formatında fatura XML push'lanır
4. Dönen ETTN (Evrensel Tekil Tanımlama Numarası) Trendyol siparişine işlenir
5. Fatura PDF'i müşteriye e-mail ile gönderilir
6. Trendyol panelinde "Faturalandırıldı" durumuna geçer

Tüm süreç ortalama 8-15 saniye sürer. 7 gün içinde fatura kesilmezse Trendyol satıcı puanınızı düşürür ve haftalık ödemeyi bloke edebilir.

UBL XML Örnek

<Invoice xmlns="urn:oasis:names:specification:ubl:schema:xsd:Invoice-2">
  <UUID>F47AC10B-58CC-4372-A567-0E02B2C3D479</UUID>
  <IssueDate>2026-06-09</IssueDate>
  <InvoiceTypeCode>SATIS</InvoiceTypeCode>
  <DocumentCurrencyCode>TRY</DocumentCurrencyCode>
  <AccountingSupplierParty>
    <Party>
      <PartyIdentification>
        <ID schemeID="VKN">1234567890</ID>
      </PartyIdentification>
      <PartyName><Name>Zuna Tekstil A.Ş.</Name></PartyName>
    </Party>
  </AccountingSupplierParty>
  <AccountingCustomerParty>...</AccountingCustomerParty>
  <InvoiceLine>
    <ID>1</ID>
    <InvoicedQuantity unitCode="C62">2</InvoicedQuantity>
    <LineExtensionAmount currencyID="TRY">249.83</LineExtensionAmount>
    <Item><Name>Pamuklu Bisiklet Yaka Tişört</Name></Item>
    <Price><PriceAmount currencyID="TRY">124.92</PriceAmount></Price>
  </InvoiceLine>
  <TaxTotal>
    <TaxAmount currencyID="TRY">49.97</TaxAmount>
  </TaxTotal>
  <LegalMonetaryTotal>
    <PayableAmount currencyID="TRY">299.80</PayableAmount>
  </LegalMonetaryTotal>
</Invoice>

9. Yaygın Hatalar ve Çözümler

Kategori Mismatch — "Ürün Reddedildi"

En sık görülen sorun: ürün yanlış kategoriye yerleştirilince Trendyol kategori uzmanı reddeder. Çözüm: ML tabanlı kategori öneri motoru kullanın; manuel eşleştirmede deneme-yanılma yerine başlık + açıklama text'ini sınıflandırıcıya verin.

Attribute Eksik — "Zorunlu Alan Hatası"

Kategori için tanımlı bir zorunlu attribute (örn. Renk, Materyal) eksik gönderildiğinde 422 hatası alırsınız. Çözüm: /product-categories/{id}/attributes endpoint'inden kategori başına zorunlu listeyi çekip ürün payload'ında zorunlu pre-flight check uygulayın.

Stok Senkron Gecikmesi — "Aşırı Satış"

Stok güncellemesinin Trendyol'a yansıması normal koşullarda 2-5 saniyedir; ama rate limit kuyruğuna takılırsa 30-60 saniyeye çıkabilir. Aynı SKU'yu birden çok pazaryerinde satıyorsanız bu pencerede yarış koşulu oluşur. Çözüm: event-driven push + her satıştan sonra anlık delta update + rezerve kuyruk mekanizması.

Webhook Miss — "Sipariş Geldi Ama Sistemde Yok"

Webhook 3 retry sonrası başarısız olursa sipariş "webhook miss" işaretlenir. Çözüm: 1) Her 60 saniyede bir /orders?orderByField=PackageLastModifiedDate&orderByDirection=DESC&size=50 ile polling fallback çalıştırın 2) Eksik siparişleri webhook tablosuyla cross-check edin 3) Webhook handler'ınızın 200 OK dönüş süresini 2sn altına çekin.

SSL Sertifika Hatası — Webhook Çalışmıyor

Trendyol webhook'u sadece geçerli SSL sertifikasıyla çalışır. Self-signed veya süresi geçmiş sertifika 525 hatasına yol açar. Çözüm: Let's Encrypt veya Cloudflare SSL kullanın; sertifika yenileme cron'unu shadow domain ile test edin.

e-Fatura Reddi — "ETTN Üretilemedi"

e-Fatura entegratörü XML'i reddedebilir (eksik alan, geçersiz VKN, yanlış KDV oranı). Çözüm: Validation katmanını entegratör çağrısından önce çalıştırın; XML kütüphanesi (örn. Java JAXB, Python lxml) ile UBL 2.1 schema'ya karşı pre-validate edin.

10. Trendyol Komisyon ve Vendor Fee 2026

Trendyol komisyon yapısı kategori bazlıdır ve 2026 itibarıyla üç ana banda ayrılır. Sabit ücret veya aylık abonelik yoktur — sadece kategori başına satış komisyonu + opsiyonel reklam ücretleri.

Ek Ücret Kalemleri

• Trendyol Reklam (Ads): CPC modeli, %5-15 ek bütçe önerilir; ürün listesinde "Sponsorlu" rozeti
• Kampanya Komisyonu: Trendyol Günleri, Black Friday gibi dönemlerde +%2-5 ek komisyon (opsiyonel katılım)
• Trendyol Premium Mağaza: seçili yüksek-hacimli satıcılar için ayrı tarife
• Çoklu Ödeme / Taksit Ücreti: 0% — Trendyol absorb eder, satıcıya geçirmez

Türkiye Yasal Çerçeve 2026 — Ne Değişti?

KDV (PTU) ve GİB

Türkiye KDV oranları 2024 sonu reformuyla şu şekildedir: %20 standart, %10 indirimli (gıda, hijyen, kitap), %1 özel (un, ekmek, taze gıda). Marketplace satıcıları KDV mükellefiyeti için yıllık ciro 500 bin TL'yi geçtikten sonra zorunlu kaydolur; daha düşük ciroda esnaf muafiyeti uygulanabilir (sınırlı kategoriler).

e-Fatura ve e-Arşiv (GİB)

2026 itibarıyla internet satışı yapan tüm satıcılar için e-Arşiv Fatura zorunludur. 5M TL üstü ciroda B2B faturalar için e-Fatura; B2C için e-Arşiv kullanılır. Her marketplace siparişine 7 gün içinde fatura kesilmesi gerekir; aksi halde Trendyol satıcı puanı düşer ve cezai yaptırım uygulanır.

ETBİS Kaydı

Elektronik Ticaret Bilgi Sistemi (ETBİS) Ticaret Bakanlığı'na bağlı zorunlu kayıt sistemidir. Tüm internet satıcıları faaliyete başlamadan önce ETBİS'e kayıt olmak zorundadır; kayıt numarası web sitenizde / mağaza sayfanızda görünür olmalıdır. Marketplace satıcıları için Trendyol ETBİS kontrolü hesap onayı aşamasında yapar.

KVKK — Türk GDPR'ı

Kişisel Verilerin Korunması Kanunu (KVKK, Kanun No. 6698) Türk GDPR'ı sayılır. Trendyol müşteri verilerini anonimize ederek paylaşır (e-mail yerine [email protected] formatı, gerçek telefon yerine geçici numara). Satıcı olarak müşteri verilerini sadece sipariş işlemek için kullanabilirsiniz; pazarlama amaçlı kullanım açık rıza gerektirir ve büyük ihtimalle KVKK ihlali doğurur.

14 Günlük Cayma Hakkı (TKHK)

6502 sayılı Tüketicinin Korunması Hakkında Kanun'un 48. maddesi gereği mesafeli sözleşmelerde tüketici 14 gün içinde sebep göstermeksizin iade hakkına sahiptir. Trendyol bu hakkı default olarak entegre eder; satıcının 3 iş günü içinde iadeyi onaylama yükümlülüğü vardır.

Sektörel Düzenlemeler

• Sağlık Bakanlığı izinleri — kozmetik, gıda takviyesi, medikal cihaz satıcıları için
• TSE / CE belgesi — elektronik ürünler, oyuncak, kişisel koruma ekipmanı
• Tarım Bakanlığı izinleri — gıda, tohum, gübre, hayvansal ürünler
• EPDK / TMO — enerji, akaryakıt, hububat tedarik ürünleri

Lojistik & Kargo — Trendyol Express + Türk Kargo Stack'i

Trendyol Express — Kendi Lojistik Ağı

Trendyol Express, Trendyol'un kendi lojistik markası — 2018'de kurulmuş ve 2026 itibarıyla 50,000+ teslimat noktası (Trendyol Express kasaları + ev teslimatı), 200+ aktarma merkezi ve günlük 5M+ paket kapasitesine sahip. Satıcının üç temel avantajı: piyasanın %15-25 altı tarife, Hızlı Satış rozetiyle bütünleşme, Trendyol panelinden tek tıkla etiket basımı.

Entegre Diğer Kargo Firmaları

Trendyol Express dışında 5 büyük kargo firması platforma entegre — satıcı seçim yapabilir:

• Yurtiçi Kargo (cargoProviderId 17) — Türkiye'nin en yaygın ağı, B2B + B2C dengeli
• Aras Kargo (10) — şehir içi hızlı, esnaf kanalı güçlü
• MNG Kargo (19) — büyük hacim, kurumsal satıcılar
• PTT Kargo (4) — devlet ağı, kırsal teslimat
• Sürat Kargo / HepsiJet — niche, rakip pazaryerleri için

Pratik Kargo Stack'i 2026

Tipik bir Trendyol satıcısının 2026 kargo stack'i: Trendyol Express default (hızlı + uygun + rozet entegre), Yurtiçi Kargo backup (Trendyol Express kapasitesinin dolduğu bölgelerde), PTT kırsal ZIP'ler için (genelde ek 2-3 TL anlaşmalı tarife), MNG 30+ kg büyük paketlerde. Zunapro logistics modülü her siparişi ağırlık + posta kodu + müşteri tercihine göre optimal kargoyu otomatik seçer.

Sınır Ötesi: Trendyol Global Seller Programı

Trendyol'un Uluslararası Hamlesi

Alibaba 2018 satın alımından sonra Trendyol Türkiye sınırlarını aşan agresif bir uluslararasılaşma stratejisi izledi. 2026 itibarıyla aktif pazarlar:

• Trendyol DE (Almanya) — 2022 launch, Türk diasporası odaklı, 1M+ aktif kullanıcı
• Trendyol UK (Birleşik Krallık) — 2023 launch, moda odaklı, hızlı büyüyor
• Trendyol GCC (Suudi Arabistan, BAE, Kuveyt, Bahreyn, Umman, Katar) — 2024 entry, Mübadele Stratejisi
• Trendyol Azerbaycan + Orta Asya — pilot fazda, 2026 sonu açılış planı

Global Seller Olmak

Türk satıcılar otomatik olarak Trendyol DE/UK/GCC'ye listeleme yapabilir — tek hesap, çoklu pazaryeri. Trendyol otomatik translation, multi-currency pricing (EUR, GBP, SAR, AED) ve yerel KDV (DE %19, UK %20, BAE %5) hesabı yapar. Lojistik için Trendyol Express'in uluslararası ağı veya UPS/DHL entegrasyonu kullanılır.

Sınır Ötesi Satış Stack'i

• Katalog: Zunapro master SKU'ları, Trendyol TR/DE/UK/GCC'ye aynalı
• Fiyatlama: çoklu para birimi kuralları (TRY, EUR, GBP, SAR) günlük TCMB / ECB döviz senkronu
• Uyum: TR için e-Fatura, AB için VAT IOSS, GCC için VAT registration
• Lojistik: TR depodan AB/GCC'ye UPS/DHL + local fulfillment
• İade: çoklu dilli müşteri hizmetleri (TR/EN/DE/AR)

Trendyol'a Başlama — 5 Adımda 2026 Onboarding

1. Trendyol Satıcı Hesabı

partner.trendyol.com üzerinden başvuruyu tamamlayın. Şahıs şirketi (vergi levhası + ETBİS yeterli) veya tüzel kişilik (ek olarak imza sirküleri + faaliyet belgesi) açabilirsiniz. Onay süreci 3-7 iş günü; bu süreçte vergi mükellefiyetini ve banka hesap doğrulamasını paralel hazırlayın.

2. ETBİS Kaydı ve Vergi Mükellefiyeti

İnternet satışı yapacaksanız ETBİS kaydı yasal olarak zorunludur — Ticaret Bakanlığı'nın etbis.gtb.gov.tr portalından 1-2 günde tamamlanır. KDV mükellefi olmasanız bile e-Arşiv Fatura mükellefiyeti yıllık 500 bin TL ciro üstünde aktiflenir; daha düşük cirolu satıcılar için Trendyol kendi e-Arşiv hizmetini sunar.

3. API Token ve Webhook URL

Satıcı hesabınız aktif olduktan sonra "Entegrasyon Bilgileri" menüsünden Supplier ID, API Key, API Secret değerlerini ve webhook URL'sini alın. Webhook URL'si geçerli SSL sertifikalı bir HTTPS endpoint olmalı; HTTP veya self-signed kabul edilmez.

4. e-Fatura Entegratörü Seçimi

Logo / Mikro / Uyumsoft / Foriba / Veriban arasından bir entegratör seçin. Aylık tarifeler 150-500 TL aralığında (gönderim hacmine göre). Entegratör API anahtarınızı Zunapro Trendyol kartına yapıştırın; otomatik fatura kesimi aktiflenir.

5. Zunapro Panel'e Bağlanma — 10 Dakikada Test Sipariş

1. Zunapro'ya giriş yapın ve Türkiye modülünü açın
2. Trendyol kartına API Key + Secret + Supplier ID yapıştırın
3. e-Fatura entegratörünü ekleyin (tek API token)
4. Master kataloğunuzu Trendyol'a eşleyin — kategori öneri motoru %94 doğrulukla otomatik eşleştirir
5. Test sipariş oluşturup uçtan uca akışı doğrulayın (sipariş gel → fatura kesil → kargo etiketi bas → durum güncelle)

Tipik bir 5,000 SKU'lu katalog ilk senkronda ~10 dakikada Trendyol'a yüklenir; e-Fatura akışı ilk siparişle birlikte test edilir.

Trendyol Entegrasyonu SSS 2026