Pazaryeri XML Entegrasyonu 2026: Tedarikçi Bağlantısı, Otomatik Ürün Aktarımı ve Stok-Fiyat Senkronu Rehberi

2026 XML Entegrasyon Mimarisi — Genel Bakış

XML entegrasyonu tek bir teknolojik tercih değil; üç katmandan oluşan bir pipeline'dır. Aşağıdaki kartlar Zunapro'nun XML hub'ında dolaşan altı temel pazaryeri'ni özetler. Sonraki bölümlerde her birinin XML kurallarını detaylı işleyeceğiz.

1. XML Entegrasyonu Nedir? REST API ile Farkı

XML Feed'in Mimarisi

XML (eXtensible Markup Language), ürün verisini hiyerarşik olarak tanımlayan bir metin formatıdır. Bir XML feed, tipik olarak <urunler> kök elementinin altında her bir ürünü <urun> bloğunda taşır; içinde sku, başlık, açıklama, kategori, görseller, fiyat ve stok bilgileri vardır. Bu yapı 1998'de W3C tarafından standartlaştırıldığından beri, B2B veri alışverişinin "de facto" formatıdır — özellikle Türkiye gibi geleneksel toptan ticaretten dijitale geçen pazarlarda.

2026'da XML hâlâ Türk e-ticaret ekosisteminde en yaygın tedarikçi-pazaryeri köprüsü. Tedarikçinin web sitesi sabit bir URL'de güncel XML'i yayınlar; aggregator (Zunapro gibi) bu URL'yi belirlenen aralıklarla HTTP GET ile çeker, parse eder, master kataloğa yazar ve pazaryerine push eder.

Pull vs Push — Asenkron Mimari

REST API'lerin çoğunda veri akışı push'tur: stok değiştiğinde satıcı sistemi pazaryerine anında bir PATCH isteği gönderir. XML pipeline'da ise iki yönlü pull mantığı hakimdir:

• Tedarikçi → Zunapro pull: Saatlik (veya tedarikçi izin verirse 15 dakikalık) zamanlı görev GET /feed.xml isteği atar
• Zunapro → Pazaryeri push: Stok/fiyat değişiklikleri event-driven olarak ilgili pazaryerine REST veya XML olarak gönderilir

Sonuç olarak: tedarikçinizin XML'i ile pazaryeri arasında Zunapro bir tampon (buffer) görevi görür. Tedarikçi 5 dakika geç güncellense bile, en son sağlıklı veri pazaryerinde aktif kalır; pipeline'da kesinti olsa bile cached snapshot serve edilir.

Scheduled Job Mantığı

XML pipeline'ı bir cron job (zamanlı görev) topluluğudur. Tipik bir Zunapro tenant'ında dönen 6-8 cron şu şekildedir:

• 0 * * * * — Saat başı tedarikçi XML pull (8.000+ kaynak için ortalama 3-12 dk)
• */15 * * * * — 15 dakikada bir master → pazaryeri stok/fiyat push
• */5 * * * * — 5 dakikada bir pazaryeri sipariş pull
• 0 2 * * * — Gece 02:00'de görsel CDN re-sync + watermark kontrolü
• 0 4 * * * — Gece 04:00'te kategori ağacı + komisyon güncellemesi
• 0 6 * * * — Sabah 06:00'da feed sağlık raporu Slack/Email

2. XML Feed Yapısı 2026 — Standart Şema

Standart Ürün XML Şeması

Türkiye'de yaygın olarak kullanılan XML feed yapısı, yıllar içinde "ortak bir gelenek" haline gelmiş bir şemayı izler. Bu şemanın temel elementleri aşağıdadır:

• <sku> — Stok kodu (zorunlu, unique). Tedarikçide bu kod tek tek ürünü tanımlar.
• <barkod> — EAN-13 barkod (zorunlu, dedup için kritik)
• <baslik> — Ürün başlığı (max 80 karakter; SEO için kritik)
• <aciklama> — HTML destekli ürün açıklaması
• <kategori> — Tedarikçinin kendi kategori adı
• <marka> — Marka adı (Trendyol marka kataloğu ile eşleşmeli)
• <fiyat> — KDV durumunu belirten attribute ile (örn. kdv="dahil")
• <stok> — Mevcut adet (integer)
• <gorsel1>...<gorsel8> — Görsel URL'leri (max 8 görsel)
• <ozellikler> — Attribute alt-elementleri (renk, beden, materyal vb.)
• <desi> — Kargo desi hesabı için boyut bilgisi

Trendyol XML Şeması

Trendyol'un XML feed kuralları en katı olanıdır çünkü 35M+ müşteriye 500K+ satıcının çok büyük hacimli feed'leri Trendyol altyapısına ciddi yük bindirir. Trendyol'un gereksinimleri:

• UTF-8 encoding, maksimum 50.000 ürün/feed
• HTTPS endpoint (HTTP kabul edilmez)
• Saat başı pull (Trendyol her saat 00:00'da feed'inizi çağırır)
• Barkod zorunlu, kategori ID Trendyol kategori ağacından, marka ID Trendyol marka kataloğundan onaylı
• En az 2 görsel, min 800x800px, max 5MB/dosya
• Kategori-özel zorunlu attribute setleri (örn. tekstilde renk/beden zorunlu)

Custom Feed Mapping

Tedarikçinizin XML'i standart şemayı izlemiyorsa, Zunapro'nun field mapper arayüzü drag-and-drop ile feed alanlarını master kataloğun beklediği alanlara eşleştirir. Örneğin tedarikçinizin XML'i <urunKodu> diyorsa, bunu <sku>'ya, <urunBaslik>'ı <baslik>'a maplersiniz. Bu mapping tedarikçi başına bir kez yapılır ve kaydedilir; sonraki güncellemelerde otomatik uygulanır.

3. Pazaryerleri için XML Kuralları

Trendyol XML (Her Saat Pull)

Trendyol'un XML feed sistemi satıcı paneli > Entegrasyon > XML Yönetimi altında konfigüre edilir. Trendyol kendi sunucusundan satıcının feed URL'ine her saat 00:00'da pull yapar. Önemli ayrıntılar:

• Feed dosya boyutu max 500MB sıkıştırılmış (gzip kabul edilir)
• Yeni ürün eklendiğinde 3-6 saat içinde Trendyol tarafından kategoriye atanır ve onaylanır
• Stok push için ek REST endpoint mevcuttur — XML pull'a alternatif olarak stok düşüşü anında REST ile bildirilebilir
• Trendyol Express kullanan satıcılar için kargo barcode'u feed'de zorunlu değildir; Trendyol kendisi atar

Hepsiburada XML

Hepsiburada XML + REST hibrit yaklaşımı destekler. Hepsiburada Developer Portal'da yayınlanan feed file şeması, "HepsiJet Listing API" altında bulunur. Önemli farklılıklar:

• Asenkron submit: XML feed'i submit ettikten sonra Hepsiburada'nın işlem job ID'sini takip edersiniz
• Stok/fiyat güncellemeleri için ayrı endpoint (delta feed) — tüm katalogu tekrar yüklemenize gerek yok
• Görsel doğrulama: Hepsiburada'nın CDN'i görseli pull eder, bozuksa "GorselReject" hata kodu döner
• Hepsiburada Premium Satıcı programına dahil olanlar saatlik yerine 15 dakikalık pull penceresi kullanabilir

n11 XML

n11, 2024'te Doğuş Grubu'na geçmesiyle birlikte teknik altyapısını yeniledi. Yeni XML şeması n11 Mağaza Yönetim Sistemi (MYS) içinden tanımlanır:

• SOAP XML web servis tarihsel olarak baskındı; 2026'ten itibaren REST XML tercih edilen yöntem
• Stok-fiyat senkronu n11 Marketplace Sync API üzerinden
• n11'in kategori ağacı Türkiye'nin en derinlerinden biri (12 seviye); kategori eşlemesi en zorlayıcı kısmıdır

Amazon TR Feed Files

Amazon Türkiye, global Amazon altyapısının bir parçası — bu nedenle XML şeması diğer pazaryerlerinden tamamen farklıdır. Selling Partner API (SP-API) kullanılır; eski adıyla MWS Feed Files:

• POST_FLAT_FILE_INVLOADER_DATA — Stok feed
• POST_FLAT_FILE_PRICEANDQUANTITYONLY_UPDATE_DATA — Hızlı fiyat-stok
• POST_PRODUCT_DATA — Tam ürün bilgisi (Amazon-spesifik XSD şema)
• Feed submission asenkrondur — processing report 5-30 dakika sonra hazır olur
• ASIN matching: Amazon mevcut katalogda eşleşme bulursa kendi listing'inize bağlar, bulamazsa yeni ürün oluşturur

Çiçeksepeti XML

Çiçeksepeti, "hediye odaklı" konseptiyle özel kategori şemaları kullanır — örneğin "çiçek + kart + paketleme" üçlüsü tek SKU'da tanımlanır. XML feed'inizde "HediyeSec" ve "PaketlemeSec" alanlarını işlemeniz gerekir. Çiçeksepeti satıcı paneli "Toplu İşlemler" altında XML upload ve "Otomatik Pull URL" iki yöntemi de destekler.

Pazarama XML

Pazarama, Hepsiburada altyapısı üzerine kurulu olduğundan XML şeması Hepsiburada ile çok benzerdir; aynı XSD dosyalarını paylaşırlar. Avantaj: aynı feed'i sadece endpoint değişikliğiyle her ikisine de gönderebilirsiniz. 2026 Q2'ye kadar komisyonsuz dönem devam ediyor — XML entegrasyonu yapan satıcılar için cazip bir kanal.

4. Tedarikçiden XML Alma

B2B Tedarikçi XML Feed

Türkiye'de B2B XML feed sunan tedarikçi sayısı son 5 yılda patladı — 2019'da yaklaşık 800 olan sayı, 2026'da 8.000+ tedarikçiye ulaştı. Bunun nedeni dropshipping iş modelinin büyümesi: tedarikçiler XML feed sunarak yüzlerce dropshipper'ı tek seferde sisteme dahil edebiliyor. Yaygın B2B XML kaynakları:

• Topbas Toptan — 50.000+ SKU, standart XML şeması, REST endpoint, IP whitelist + token auth
• toptansatis.com — Beyaz eşya, kozmetik, ev tekstili dahil 30+ tedarikçi, tek API'den XML feed
• IKAS — Türk e-ticaret altyapısı; kullanıcılar kendi mağazalarının XML feed'ini "Pazaryeri Export" olarak alabilir
• Doğrudan üretici XML — Marka sahibi/üretici kendi sitesinden XML yayınlar; auth genellikle username/password

IKAS XML — E-Ticaret Altyapısından Feed

IKAS, 2017'de kurulan Türk e-ticaret altyapı şirketi. IKAS kullanan satıcılar, mağaza yönetim panelinden "Pazaryeri Senkronu" > "XML Export" menüsünden hazır XML feed alabilir. Bu feed:

• IKAS standart XML şemasını kullanır
• Saatlik otomatik güncellenir
• Token tabanlı auth ile korunur
• Görseller IKAS CDN'inden serve edilir (hızlı, güvenilir)

IKAS kullanıcıları Zunapro'ya bağlandığında, tek bir feed URL tüm pazaryerlerine yayıldığı için entegrasyon süreci 10 dakikaya iner.

Topbas Toptan XML

Topbas Toptan, Türkiye'nin en köklü B2B XML sağlayıcılarından. Özellikleri:

• 50.000+ aktif SKU, gıda dışı tüketim ağırlıklı
• XML feed boyutu ortalama 120-180MB (gzip sonrası ~20MB)
• Saatlik refresh, kategori bazlı filtreleme imkanı
• Dropship modeli: sipariş tedarikçide hazırlanır, kargo barkodu Zunapro üzerinden pazaryerine geri yazılır

FTP/HTTP/API Endpoint

XML feed'in fiziksel olarak nasıl alındığı da önemli. Üç ana yöntem var:

• HTTP(S) URL Pull — En yaygın yöntem; Zunapro GET https://supplier.com/feed.xml ile çeker
• FTP/SFTP Pull — Eski geleneksel B2B tedarikçilerde hâlâ yaygın; Zunapro SFTP credential ile login olur, son dosyayı indirir
• REST/JSON Endpoint — Modern tedarikçilerde JSON da destekleniyor; Zunapro JSON-to-XML otomatik dönüştürür

5. Kategori Eşleme

Tedarikçi Kategorisinden Pazaryeri Kategori Treesine

Kategori eşleme, XML pipeline'ın en kritik manuel adımıdır. Çünkü her pazaryerinin kendi kategori ağacı var; Trendyol'un "Kadın > Giyim > Bluz > Şifon Bluz" kategorisi, Hepsiburada'da "Moda > Kadın > Bluz > Şifon" olabilir. Tedarikçinizin XML'i ise sadece "Bluz" diyebilir.

Otomatik Mapping (ML Destekli)

Zunapro'nun kategori mapper'ı, ürün başlığı + tedarikçi kategorisi + attribute setleri kombinasyonuyla pazaryeri kategori ağacında en yakın eşleşmeyi bulur. ML modeli:

• Türkçe + İngilizce ürün başlığı semantik benzerliği
• Tedarikçi kategorisi + pazaryeri kategorisi cosine similarity
• Attribute setlerinin overlap oranı (renk, beden, materyal)
• Marka kodu ile pazaryeri marka kataloğu eşleşmesi

Bu kombinasyon, ilk pass'te %85+ doğrulukla eşleşme önerir. Geri kalan ~%15 kategorinin manuel onayı gereklidir; ama bir kez onaylanan mapping aynı tedarikçi için sürekli yeniden kullanılır.

Manuel Override

Bazı kategorilerin otomatik eşlemesi güvenilir değildir — örneğin "Aksesuar" tedarikçide bilezik anlamına gelirken pazaryerinde "Telefon Aksesuarı" olarak yorumlanabilir. Bu durumlarda manuel override şarttır. Zunapro'nun mapping UI'sı:

• Tedarikçi kategorisi sol panelde
• Pazaryeri kategori ağacı sağ panelde, arama + filtre destekli
• Mapping kuralı kaydedildiğinde aynı tedarikçinin sonraki feed'lerinde otomatik uygulanır
• Bulk operation: tüm "Aksesuar" kategorisini tek tıkla "Telefon > Aksesuar"'a maple

Kategori Komisyon Karşılaştırması 2026

Kategori eşleme komisyon optimizasyonunun da kapısıdır. Aynı SKU farklı kategorilere konulduğunda komisyon ciddi farklılaşabilir:

6. Attribute Haritalama

Beden / Renk / Cinsiyet Attribute Eşleştirme

Attribute (özellik), kategori eşlemesinin altındaki en zorlu katmandır. Her pazaryeri attribute'leri farklı isim ve farklı value seti ile bekler. Örnek: Trendyol "Renk" attribute'üne "Açık Mavi" kabul ederken, Hepsiburada "Renk" yerine "Ana Renk" ve "Detay Renk" iki ayrı alan ister. Tedarikçinin XML'i ise sadece <renk>Mavi</renk> diyor olabilir.

Dinamik Attribute Set

Zunapro her kategori için dinamik attribute set tutar:

• "Kadın Bluz" kategorisi: Renk, Beden, Kol Tipi, Yaka, Kumaş Cinsi, Desen
• "Cep Telefonu" kategorisi: Marka, Model, Renk, Bellek, RAM, Ekran Boyutu, Garanti
• "Çocuk Bisikleti" kategorisi: Yaş Grubu, Cinsiyet, Tekerlek Çapı, Vites Sayısı

Bu set'lere tedarikçi attribute'ü drag-and-drop ile eşlenir. Bir kez eşlenen attribute, aynı tedarikçinin sonraki tüm ürünleri için otomatik uygulanır.

Value Mapping (Eş Anlamlılar)

Aynı renk birden çok isimle geçebilir: "Açık Mavi" / "Bebek Mavi" / "Light Blue" / "Pastel Mavi". Zunapro'nun value synonym map tablosu bu varyasyonları tek bir kanonik değere indirger. Türkçe pazaryerleri Türkçe kanonik değer ister; Amazon TR ise hem Türkçe hem İngilizce çift dilli kabul eder.

7. Image (Görsel) Yönetimi

URL Referansı vs CDN Kopyası

XML feed'lerinde görseller genellikle URL olarak referans verilir (örn. <gorsel1>https://supplier.com/img/123.jpg</gorsel1>). Bu yaklaşımın iki büyük riski var:

• Ölü link: Tedarikçi görseli silerse pazaryerindeki listing görsel-siz kalır
• Rate limit / bot bloğu: Pazaryeri CDN'i tedarikçi sunucusundan binlerce kez aynı görseli çekmeye çalışır, bloklanırsınız

Çözüm: Zunapro CDN kopyası. Her görsel ilk feed pull'da Zunapro CDN'ine kopyalanır, ölü kalmaz, hızlı serve edilir.

Resize ve Watermark

Trendyol min 800x800, Hepsiburada min 750x750, Amazon TR min 1000x1000 ister. Zunapro her görseli farklı pazaryeri spec'ine göre otomatik resize eder:

• Resize: Aspect ratio korunur, boş alan beyaz fill ile doldurulur
• WebP dönüşümü: %30 daha küçük dosya, aynı kalite
• Watermark: Köşede %30 opaklık brand logosu (opsiyonel, kategori bazlı kapatılabilir)
• Auto-crop: Beyaz background tespit edilip ürüne sıkı crop yapılır

Çoklu Görsel Stratejisi

2026'da tek görsellik listing'lerin conversion oranı %40 daha düşük. Zunapro her ürün için min 4, ideal 6-8 görsel hedefler:

• Ana görsel: Beyaz background, ürün ortalanmış
• Yan/arka görseller: 3D his
• Kullanım görseli: Ürün gerçek hayatta
• Ölçek görseli: Ölçü/boyut karşılaştırması
• Etiket/garanti görseli: Trust signal

8. Stok-Fiyat Senkronu

Saatlik / Yarım Saatlik Push

Stok senkronu XML pipeline'ın can damarıdır. Stoğun gerçek envanterle yanlış senkronize olması iki kötü senaryoya yol açar:

• Oversell (gerçekten yok ama listing'de var): Sipariş gelir, gönderemezsiniz, pazaryeri ceza puanı verir, hesap askıya alınır
• Undersell (var ama listing'de yok): Gereksiz envanter ölü yatar, satış kaybı

Zunapro'nun stok senkron politikası:

• 15 dakika cron + event-driven push (sipariş anında stok düşürür)
• Mükerrer listing varsa MIN-stok dedup (2026-06 fix): aynı SKU iki kez listelenmişse, en düşük stoğa göre senkronlanır
• Black Friday / kampanya dönemlerinde 5 dakika'ya iner
• Tedarikçi feed'i 60 dakikadan eski ise pazaryeri push'u durdurulur, alarm gönderir

Fiyat Marjı Kuralları

Tedarikçi fiyatı, pazaryeri fiyatına dönüşürken birkaç katman geçer:

• Marj kuralı: Tedarikçi fiyatı + %15 marj (tedarikçi başına ayarlanabilir)
• Komisyon kompenasyonu: Pazaryeri komisyonu otomatik fiyatın üstüne eklenir
• Kargo dahil/hariç kararı: Müşteri gözünde "ücretsiz kargo" istiyorsanız, kargo bedeli fiyata gömülür
• Rakip fiyat takibi: Zunapro her saat aynı SKU'nun rakip satıcılarındaki fiyatını çeker, sizin fiyatınız belirlediğiniz min-max bandında tutar

KDV Hesabı 2026

Türkiye'de standart KDV oranı %20'dir (Temmuz 2023 değişikliği sonrası). Düşük orana giren kategoriler:

• %1 KDV: Temel gıda maddeleri, ekmek, tarım ürünleri
• %10 KDV: Kitap, dergi, gıda hizmeti, eğitim materyali, ilaç
• %20 KDV: Standart oran — elektronik, tekstil, kozmetik, ev eşyası, mobilya, oyuncak

Tedarikçi XML'i KDV durumunu mutlaka belirtmelidir. Zunapro'nun KDV motoru:

• KDV dahil fiyat: olduğu gibi pazaryerine push edilir
• KDV hariç fiyat: kategoriye göre KDV otomatik eklenir
• e-Fatura kesiminde GİB'e KDV ayrıştırılarak gönderilir (FA(2) muadili Türk şeması)

Kampanya Fiyatı

Black Friday, Efsane Cuma, sezon sonu kampanyaları için Zunapro'nun scheduled price campaigns modülü:

• Başlangıç-bitiş tarihi tanımlanır
• İndirim oranı (%) veya sabit indirim TL
• Pazaryeri başına ayrı kampanya (Trendyol'da kampanya, Hepsiburada'da normal fiyat)
• Stok limiti (örn. ilk 100 alıcıya kampanya fiyatı)

9. Hata Yönetimi

XML Parse Hatası

En yaygın XML hatası: tedarikçi feed'ine geçersiz karakter (örn. & escape edilmemiş) veya bozuk encoding (Windows-1254 yerine UTF-8 bekleniyor). Zunapro:

• Lenient parser: Küçük hataları otomatik düzeltir (örn. &'i & yapar)
• Encoding detection: Feed'in gerçek encoding'ini tespit eder, UTF-8'e dönüştürür
• Partial parse: Bir ürün bozuksa, geri kalan 49.999 ürünü işlemeye devam eder
• Error log: Hangi SKU, hangi satır, ne hata — Slack/Email bildirim

Kategori Miss (Eşleşme Bulamama)

Tedarikçi yeni kategori eklediğinde, ML modeli %50 confidence'in altında bir öneri yapabilir. Bu durumda:

• Ürün geçici olarak "Pending Category Mapping" kuyruğuna alınır
• Operasyon ekibine bildirim düşer
• Manuel mapping yapıldığında ürün otomatik publish'lenir
• Tedarikçi feed'inden silinmediği sürece kuyrukta kalır

Attribute Eksik

Trendyol bir kategoride "Renk" attribute'ünü zorunlu kıldığında ve tedarikçi feed'inde bu bilgi yoksa, ürün reject edilir. Zunapro:

• Pre-validation: Submit etmeden önce zorunlu attribute kontrolü yapar
• Auto-fill from title: Ürün başlığında "Kırmızı T-Shirt" geçiyorsa "Renk: Kırmızı" otomatik atanır
• Default value: Hâlâ bulunamazsa kategori-default uygulanır (örn. "Beden: Standart")

Image URL Ölü

Görsel URL'i 404 dönerse:

• Zunapro 3 retry yapar (1dk, 5dk, 15dk)
• Hâlâ ölü ise cached önceki sağlıklı görsel kullanılır
• Cache de yoksa placeholder + uyarı

Retry Logic

Tüm hata türleri için Zunapro'nun exponential backoff retry'ı çalışır:

• Hata 1: 1 dakika sonra retry
• Hata 2: 5 dakika sonra retry
• Hata 3: 15 dakika sonra retry
• Hata 4+: Alarm sistemine düşer, manual müdahale beklenir

Bu sırada son sağlıklı snapshot pazaryerinde aktif kalır — listing yok olmaz, satış durmaz.

10. REST API vs XML — Hangisi 2026'da Doğru?

Karşılaştırma Tablosu

İki yaklaşımın side-by-side karşılaştırması:

Kriter	XML Feed	REST API	Hibrit
Kurulum Süresi	10 dakika	2-4 hafta	2-3 gün
Geliştirici İhtiyacı	Yok (config only)	Yüksek	Orta
Gerçek Zamanlı Stok	15 dakika gecikme	Saniye altı	Event-driven
Ürün Sayısı	50K'a kadar ideal	Sınırsız	Sınırsız
Sipariş Hacmi	0-500/gün	1000+/gün	500-1000/gün
Aylık Maliyet	Düşük	Yüksek (dev cost)	Orta
Esneklik	Sınırlı	Tam kontrol	Dengeli
Bakım Yükü	Minimum	Sürekli	Orta

Kullanım Senaryoları

• Yeni başlayan dropshipper (0-200 sipariş/gün): XML — 10 dakikada başla, geliştirici gerek yok
• Orta ölçek e-ticaret (200-1000 sipariş/gün): Hibrit — ürün yönetimi XML, stok-fiyat REST
• Büyük marka / üretici (1000+ sipariş/gün): Saf REST — gerçek zamanlı kontrol şart
• Tedarikçi-ağırlıklı iş modeli: XML hâkim — tedarikçi REST sunmuyor
• Kampanya odaklı satıcı: REST — dakikalık fiyat değişikliği

Hibrit Yaklaşım

2026'da en sık karşılaşılan kombinasyon hibrittir:

• Ürün katalog yönetimi: XML feed (tedarikçi → master katalog → pazaryeri ilk publish)
• Stok güncellemesi: REST API (sipariş geldiğinde anında düşür)
• Fiyat değişikliği: REST API (kampanya başlat/bitir anında uygula)
• Sipariş çekme: REST API (5 dakikada bir poll)

Zunapro her iki yöntemi de aynı anda destekler; tenant başına hangi event'in hangi protokolle çalışacağı konfigüre edilir.

Türkiye Yasal Çerçeve 2026 — XML Pipeline'ı Etkileyen Düzenlemeler

KDV (Katma Değer Vergisi) 2026

Türkiye'de standart KDV %20'dir (Temmuz 2023 değişikliği). XML pipeline'da KDV iki kritik noktada işlenir:

• Pazaryeri push: Pazaryeri her zaman KDV dahil son tüketici fiyatını ister
• e-Fatura kesimi: GİB'e gönderilirken KDV ayrıştırılarak ayrı satır olarak gösterilir

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

GİB (Gelir İdaresi Başkanlığı) e-Fatura sistemi, 2026'da pazaryeri satıcıları için tamamen zorunludur. Cironuz 3M TL'yi aşmasa bile, e-Arşiv Fatura yükümlülüğü devam eder. Zunapro her marketplace siparişini otomatik e-Fatura/e-Arşiv'e dönüştürür:

• Sipariş Trendyol/Hepsiburada/Amazon TR'den gelir
• Müşteri TC No / Vergi No bilgisi pazaryerinden çekilir
• GİB API'ına UBL-TR formatında XML fatura gönderilir
• UUID + ETTN (Elektronik Tebliğ Takip Numarası) saklanır
• Müşteriye PDF + XML kopya gönderilir

Tüketici Koruma — Cayma Hakkı, Garanti

• 14 gün cayma hakkı: Mesafeli Satış Yönetmeliği gereği, müşteri 14 gün içinde sebepsiz iade edebilir
• 2 yıl yasal garanti: 6502 sayılı Tüketicinin Korunması Hakkında Kanun gereği
• Üretici garantisi: Üretici 2 yılın üstünde garanti sunabilir

KVKK ve Pazaryeri Veri Sorumluluğu

KVKK (Kişisel Verilerin Korunması Kanunu) kapsamında pazaryerinden gelen müşteri verisi (ad, adres, telefon) "veri sorumlusu" sıfatıyla saklanır. XML pipeline'da:

• Müşteri verisi şifrelenerek (AES-256) at-rest saklanır
• Veri Sorumluları Sicili (VERBİS) kaydı zorunlu
• Sipariş tamamlandıktan 10 yıl sonra otomatik silme cron'u
• Müşteri "verimi sil" talebi geldiğinde 30 gün içinde işlenir

Performans ve Ölçeklenebilirlik

50.000 SKU'ya Kadar XML Pipeline

50K SKU ile çalışan bir tenant'ta tipik feed işlem süresi:

• HTTP Pull: 8-15 saniye (gzip'li feed, ~25MB)
• XML Parse: 6-12 saniye (streaming parser)
• Diff hesaplama: 4-8 saniye (sadece değişen ürünler)
• Master katalog write: 8-15 saniye (PostgreSQL upsert)
• Pazaryeri push: 2-5 dakika (12 pazaryeri paralel)
• Toplam: 3-6 dakika

100K+ SKU İçin Stratejiler

100K'nın üstüne çıkan tenant'lar için ek optimizasyonlar:

• Delta sync: Tüm feed değil, sadece son güncellenen ürünler
• Sharding: SKU range'leri farklı worker'lara dağıtılır
• Background queue: Stok-kritik push'lar yüksek öncelikli kuyrukta
• Compression: Feed gzip + brotli kombosu

Sipariş Akışı Tersine

XML, ürün/stok için pull yönlü; ama sipariş için tam tersi yön çalışır:

• 5 dakikada bir pazaryeri sipariş poll'u (REST tercih edilir)
• Yeni sipariş Zunapro'ya yazılır, tedarikçiye XML/REST ile bildirim gider
• Tedarikçi siparişi hazırlar, kargo barkodunu Zunapro'ya bildirir
• Zunapro pazaryerine kargo barkodunu push eder, sipariş "Kargoya Verildi" statüsüne döner
• Otomatik e-Fatura kesimi tetiklenir

Nasıl Başlanır — 5 Adımda Pazaryeri XML Entegrasyonu

1. XML Kaynağınızı Seçin

• Kendi IKAS / Shopify / WooCommerce mağazanız var → mağaza panelinden "Pazaryeri XML Export" alın
• Dropshipper olarak tedarikçi seçiyorsunuz → Topbas Toptan, toptansatis.com veya doğrudan üretici XML
• Üretici/markanız var → ERP/PIM sisteminizden XML export yapın, FTP'ye yükleyin
• XML'iniz yok → Zunapro CSV/Excel importer ile başlayın, 2-3 ay içinde XML'e geçin

2. Tedarikçi Anlaşması ve Kategori Strateji

Tedarikçinizle dropship anlaşması yapın:

• Komisyon / fiyat marjı (genelde %10-20)
• Kargo sorumluluğu (genellikle tedarikçi gönderir, dropship)
• İade politikası (müşteriye 14 gün cayma hakkı zorunlu)
• Stok güncelleme sıklığı (saatlik talep edin)
• XML credential'ları (URL + auth bilgisi yazılı protokolde)

3. Pazaryeri Hesabı ve Komisyon Kontrolü

Hangi pazaryerlerine açacağınızı kategori-komisyon kıyasıyla seçin. Trendyol her zaman zorunlu (reach açısından); ikinci olarak Hepsiburada / Pazarama; özellikli kategori varsa Çiçeksepeti veya n11.

4. e-Fatura Mükellefiyeti

Şirket kurulduktan sonra ilk 30 gün içinde:

• GİB üzerinden e-Fatura mükellefiyetine geçiş
• e-İmza / Mali Mühür temini
• e-Arşiv Fatura entegrasyonu
• VERBİS (KVKK) kaydı

5. Zunapro ile Bağlantı (10 Dakika)

1. Zunapro panelinize giriş yapın ve XML Hub modülünü açın
2. Tedarikçi feed URL'ini ekleyin — Zunapro otomatik şema tespiti yapar, ürünleri ön-izler
3. Pazaryeri credential'larını girin — Trendyol, Hepsiburada, n11, Amazon TR, Çiçeksepeti, Pazarama vb.
4. Kategori + attribute mapping — ML önerileri onaylayın, manuel override gerekenleri ayarlayın
5. GİB e-Fatura ve KDV %20 ayarlarını tek toggle ile aktif edin
6. Yayına alın — İlk senkron 10-15 dakikada tamamlanır

Pazaryeri XML Entegrasyonu SSS 2026