XML entegrasyonu, tedarikçinin XML dosyasındaki ürün verisinin (ad, açıklama, görsel, fiyat, stok, varyant, barkod) satış kanalınızdaki ürün kayıtlarına otomatik aktarılması ve düzenli aralıklarla güncellenmesidir. Doğru kurulmuş bir entegrasyonla binlerce ürünü elle girmeden listeler, fiyat ve stok değişikliklerini satış kanalınıza kendiliğinden yansıtırsınız.
Bu rehber, XML Bayi Merkezi'nin bayilere verdiği XML bağlantısını farklı satış kanallarına nasıl aktaracağınızı anlatır. XML alanları sabit ve belgelidir; XML içe aktarabilen yazılımlarla kullanılabilir. Platformun aşağıda adı geçen pazaryerleri veya altyapılarla resmî bir ortaklığı ya da sertifikalı "hazır entegrasyonu" yoktur; anlatılanlar bu yazılımların genel XML içe aktarma yöntemleridir.
İki temel aktarım yolu
- E-ticaret altyapınızın XML içe aktarma özelliği: Kendi sitenizi kurduğunuz altyapının panelinde "XML ile ürün aktarımı", "tedarikçi XML'i" veya benzeri bir bölüm varsa bağlantıyı doğrudan buraya eklersiniz.
- Entegrasyon yazılımı (entegratör): Pazaryerlerine ürün göndermek için genellikle pazaryerinin API'siyle çalışan bir entegrasyon yazılımı kullanılır. Yazılım XML'inizi okur, ürünleri pazaryeri kategorilerine eşleştirir ve gönderir. Birden fazla pazaryerini tek yerden yönetmek için de bu yol tercih edilir.
Satış kanallarına göre tipik yöntem
| Satış kanalı | Tipik aktarım yolu | Dikkat edilecekler |
|---|---|---|
| Trendyol, Hepsiburada, N11, Amazon Türkiye | Pazaryeri API'siyle çalışan entegrasyon yazılımı veya altyapınızın pazaryeri modülü | Kategori ve özellik eşleştirme, marka onayı, barkod zorunluluğu, kargoya teslim süresi |
| ÇiçekSepeti, Pazarama, PTTAVM, İdefix | Entegrasyon yazılımı veya altyapı modülü | Pazaryerine özgü zorunlu alanlar ve kategori ağacı |
| ikas, Ticimax, IdeaSoft, T-Soft | Altyapının XML/tedarikçi ürün aktarma özelliği, uygulaması veya entegratör | Alan eşleştirme, fiyat kuralı, güncelleme zamanlaması |
| Shopify | XML içe aktarma uygulamaları veya entegratör | Varyant yapısı, görsel sayısı, para birimi |
| WooCommerce | XML içe aktarma eklentileri veya entegratör | Sunucu kaynakları, zamanlanmış görevler (cron), varyasyonlar |
Menü adları yazılımdan yazılıma değişir; kullandığınız yazılımın güncel yardım belgelerini esas alın.
Adım adım XML entegrasyonu
- Bağlantıyı oluşturun: Bayi panelinde XML bağlantılarım bölümünden yeni bir bağlantı oluşturup kopyalayın. Farklı yazılımlar için ayrı bağlantılar (en fazla 5 aktif bağlantı) açabilirsiniz; böylece birini yenilemeniz diğerlerini etkilemez.
- Biçimi seçin: İç içe yapıyı okuyabilen yazılımlar için standart biçim (
productetiketi), tek seviyeli alan eşleştirme ekranları için düz biçim (itemetiketi,format=flat). - Gerekirse filtreleyin: Yalnızca belirli kategorileri veya stoktaki ürünleri almak için bağlantıya parametre ekleyin (tablo aşağıda).
- Yazılımınıza ekleyin: Bağlantıyı XML içe aktarma bölümüne yapıştırın, ürün etiketini seçin.
- Alanları eşleştirin: Ad, açıklama, fiyat, stok, barkod, görsel ve kategori alanlarını aşağıdaki tabloya göre eşleştirin.
- Fiyat kuralınızı tanımlayın: Satış fiyatınızı yazılımınızdaki kâr kuralıyla oluşturun.
- Kategori eşleştirin: Pazaryerine gönderiyorsanız XML'deki kategori yolunu pazaryerinin kategori ağacına eşleyin.
- Güncelleme sıklığını ayarlayın: Tam XML'i makul aralıklarla, ara güncellemeleri değişen ürün akışıyla çekin.
- Küçük bir denemeyle başlayın: Önce tek kategoriyle aktarın, birkaç ürünü kontrol edin, sonra tamamını açın.
Alan eşleştirme tablosu
| Satış kanalındaki alan | Standart biçim | Düz biçim |
|---|---|---|
| Ürün kodu / stok kodu | sku | sku (varyant), group_code (ana ürün) |
| Barkod | barcode, varyantta variants/variant/barcode | barcode |
| Ürün adı | name | name + variant_name |
| Açıklama | description | description |
| Marka | brand (boş — markasız ürün) | Kendi markanız veya pazaryerinin "markasız" seçeneği |
| Kategori | category (yol), category_tree | category, category_1 … category_5 |
| Alış fiyatı (KDV dahil) | price | price |
| Alış fiyatı (KDV hariç) | price_excl_vat | price_excl_vat |
| KDV oranı | vat_rate | vat_rate |
| Stok | stock (varyantta ayrıca) | stock |
| Görseller | images/image | image1 … image10 |
| Varyant seçenekleri | variants/variant/options/option | option1_name/option1_value … option3 |
| Desi | weight | weight_desi |
| Son güncelleme | updated_at | updated_at |
KDV'yi iki kez eklemeyin: price alanı KDV dahil bayi fiyatınızdır. Kâr kuralınızı KDV hariç tutar üzerinden kurmak isterseniz price_excl_vat alanını kullanın.
Bağlantı parametreleri
| Parametre | Örnek | Ne işe yarar? |
|---|---|---|
format | ?format=flat | Düz biçim (her varyant ayrı satır) |
category | ?category=kategori-adi | Kategori ve tüm alt dalları |
in_stock | ?in_stock=1 | Yalnızca stoktaki ürünler |
since | ?since=2026-11-04T10:00:00+03:00 | Belirli zamandan sonra değişen ürünler (değişen ürün akışı) |
Parametreler birlikte kullanılabilir; birden fazla kategori virgülle ayrılır. Kategori kısa adı (slug), ürün kategorileri sayfalarının adresindeki son bölümdür. Tüm parametrelerin açıklaması bayi panelindeki XML kullanım kılavuzunda yer alır.
Güncelleme sıklığı ve sınırlar
- Tedarikçi stok ve fiyatları 45 dakikada bir sisteme çekilir.
- Tam XML dosyası performans için en fazla 5 dakikalık önbellekten sunulur; katalog veya fiyat kuralları değişince yenilenir.
- Her bağlantı için saatlik istek sınırı vardır; filtresiz tam XML'in saatte çekilme sayısı daha sınırlıdır. Sınır aşılırsa
429yanıtı ve tekrar deneme süresi döner. - Sık güncelleme için tam XML'i saatte bir veya birkaç kez, aradaki değişiklikleri
sinceparametresiyle çekmek en verimli yöntemdir.
Sık yapılan hatalar
pricealanının üzerine yeniden KDV eklemek,- Varyantlı ürünlerde ana ürün barkodunu tüm varyantlara yazmak (varyant barkodunu kullanın),
- Tam XML'i birkaç dakikada bir çekip istek sınırına takılmak,
- XML bağlantısını ekip dışındaki kişilerle paylaşmak (fiyatlarınız görünür hale gelir),
- Pazaryerinin zorunlu ürün özelliklerini eşleştirmeden toplu gönderim yapmak.
XML siparişleri taşımaz
XML entegrasyonu ürün verisini sizin tarafınıza taşır; siparişleri platforma aktarmaz. Satış kanalınıza gelen siparişi bayi panelinden verirsiniz: teslimatı müşterinize (dropshipping) veya kendi adresinize seçer, pazaryeri siparişlerinde kargo etiketini PDF olarak yüklersiniz. Süreç için Nasıl çalışır? sayfasına bakın.
Sık sorulan sorular
XML bağlantısı hangi yazılımlarla çalışır?
XML içe aktarabilen e-ticaret altyapıları ve entegrasyon yazılımlarıyla kullanılabilir. Alan adları sabit ve belgelidir; belirli bir yazılımla resmî entegrasyon iddiası yoktur.
Standart mı, düz biçim mi seçmeliyim?
Yazılımınız iç içe varyant ve görsel listelerini okuyabiliyorsa standart biçimi, alanları tek seviyeli bir tabloda eşleştiriyorsa düz biçimi seçin. İkisi de aynı ürün verisini taşır.
Stok sıfırlanan ürünler XML'den kalkar mı?
Stoğu biten ürünler varsayılan olarak stok 0 ile yer alır, böylece satış kanalınızda satışa kapanır. Yalnızca stoktakileri almak için in_stock=1 parametresini kullanabilirsiniz. Değişen ürün akışında pasife alınan ürünler stok 0 ve pasif durumuyla gelir.
Bağlantım sızarsa ne yapmalıyım?
Bayi panelindeki XML bağlantılarım bölümünden bağlantıyı yenileyin; eski bağlantı anında geçersiz olur. Yeni bağlantıyı yazılımınıza tekrar ekleyin.