Trendyol XML Entegrasyonu Nasıl Yapılır? Tedarikçi XML'inden Trendyol'a Adım Adım

Tedarikçinizden ya da kendi stok programınızdan aldığınız bir XML dosyası var ve bu ürünleri Trendyol'da satmak istiyorsunuz. "Trendyol XML entegrasyonu" olarak bilinen bu süreç, aslında XML'deki ürün verisinin okunması, Trendyol'un istediği yapıya dönüştürülmesi ve satıcı API'si üzerinden Trendyol'a gönderilmesidir. Bu rehberde süreci uçtan uca, sık yapılan hatalarla birlikte anlatıyoruz.

Önce bir netleştirme: Trendyol XML'i doğrudan okumaz

Pek çok satıcının ilk sorusu "XML linkimi Trendyol'a nereye yapıştıracağım?" olur. Trendyol, satıcılardan ürünleri genel bir XML bağlantısıyla almaz; ürün oluşturma, fiyat ve stok güncelleme işlemleri satıcı paneli, Excel şablonları veya Trendyol'un satıcılara sunduğu API üzerinden yapılır.

Dolayısıyla XML entegrasyonu üç parçadan oluşur:

1. Okuma: Tedarikçi XML'inin belirli aralıklarla indirilmesi ve ürünlerin ayrıştırılması.
2. Dönüştürme: Tedarikçi kategorilerinin, alan adlarının ve değerlerinin Trendyol'un kategori ve özellik (attribute) yapısına eşleştirilmesi.
3. Gönderme: Ürünlerin, fiyatların ve stokların Trendyol API'sine iletilmesi ve sonuçların takip edilmesi.

Bu üç adımı elle yürütmek, ürün sayısı birkaç düzineyi geçtiğinde sürdürülebilir olmaktan çıkar. Bu yüzden genellikle bir entegrasyon yazılımı kullanılır.

1. Adım: XML kaynağınızı tanıyın

Her tedarikçinin XML yapısı farklıdır. Birinde ürün adı `<name>`, diğerinde `<urun_adi>` etiketiyle gelir; varyantlar bazen ayrı ürün, bazen alt düğüm olarak tanımlanır. Entegrasyona başlamadan önce şunları kontrol edin:

• Barkod (GTIN/EAN) var mı? Trendyol'da her ürün ve varyant için benzersiz barkod gerekir. Barkodu olmayan ürünler için kendi barkod sisteminizi kurmanız gerekebilir.
• Varyant yapısı nasıl? Renk ve beden gibi seçenekler ayrı satırlar mı, yoksa tek ürünün altında mı?
• Görseller erişilebilir mi? Görsel bağlantıları herkese açık ve kalıcı olmalı; tedarikçinin sunucusu yavaşsa aktarım da yavaşlar.
• Stok ve fiyat ne sıklıkla güncelleniyor? XML'in kaç dakikada bir yenilendiğini tedarikçinize sorun.
• Marka bilgisi doğru mu? Trendyol'da marka, sistemde tanımlı marka listesinden seçilir.

2. Adım: Trendyol API bilgilerinizi alın

API üzerinden çalışmak için satıcı panelinizdeki entegrasyon bilgileri bölümünden satıcı kimliğinizi (Supplier ID) ve API anahtarlarınızı almanız gerekir. Bu bilgileri yalnızca güvendiğiniz yazılımlarla paylaşın; anahtarlar mağazanızda işlem yapma yetkisi verir. Güncel adımlar için Trendyol'un satıcı dokümanlarını kontrol edin.

3. Adım: Kategori ve özellik eşleştirme

Entegrasyonun en çok emek isteyen kısmı budur. Tedarikçinizin "Kadın > Elbise" kategorisini Trendyol'daki doğru alt kategoriye bağlarsınız. Ardından o kategorinin zorunlu özelliklerini (ör. renk, beden, kumaş tipi, kalıp) tedarikçi verisindeki alanlarla eşleştirirsiniz.

İyi bir eşleştirme için:

• Kategori eşleştirmesini en alt seviyede yapın; üst kategoriye atılan ürünler reddedilebilir veya aramada kaybolur.
• Değer eşleştirmesi tanımlayın: Tedarikçide "Lacivert" yazan değer Trendyol'da hangi renk değerine karşılık geliyor?
• Zorunlu bir özellik tedarikçi verisinde hiç yoksa, kategori bazında sabit bir varsayılan değer atanabilir; ancak bunun ürünün gerçeğini yansıttığından emin olun.

Bu konuyu daha ayrıntılı ele aldığımız tedarikçi XML kategori ve alan eşleştirme rehberi yazımıza da göz atabilirsiniz.

4. Adım: Fiyat kurallarını belirleyin

Tedarikçi XML'inde genellikle bayi alış fiyatı veya önerilen satış fiyatı bulunur. Trendyol'a gönderilecek satış fiyatını bir kural setiyle hesaplamak gerekir:

• Alış fiyatı + kâr marjı (yüzde veya tutar)
• Kategori komisyonu
• Kargo maliyeti ve varsa hizmet bedelleri
• KDV
• Yuvarlama kuralı (ör. ,90 ile bitir)

Komisyon oranları kategoriye göre değiştiği için tek bir marjı tüm ürünlere uygulamak, bazı ürünlerde zarar etmenize neden olabilir. Kategori veya marka bazlı kurallar tanımlamak daha güvenlidir. Hesabın mantığı için pazaryeri komisyonu ile doğru fiyatlandırma yazımızı okuyabilirsiniz.

5. Adım: Ürünleri gönderin ve sonucu takip edin

Ürün oluşturma istekleri Trendyol tarafında toplu olarak işlenir; gönderdiğiniz isteğin sonucu ayrıca sorgulanır. Bu nedenle "gönderdim, bitti" demek yetmez. Her ürün için şu durumları takip edin:

• Başarıyla oluşturuldu ve onay bekliyor
• Hata ile döndü (eksik özellik, geçersiz barkod, hatalı kategori vb.)
• Onaylandı ve satışta
• Reddedildi (içerik veya görsel kuralları)

Hata mesajlarını okuyup eşleştirmeyi düzeltmek ilk birkaç turda zaman alır; eşleştirmeler oturduktan sonra yeni ürünler çok daha az hata ile geçer.

6. Adım: Stok ve fiyat senkronizasyonu

Ürünler yayına girdikten sonra işin asıl kritik kısmı başlar: Tedarikçide tükenen ürünün Trendyol'da da hızla sıfırlanması gerekir. Aksi halde stokta olmayan ürün satılır, sipariş iptal edilir ve satıcı performansınız etkilenir.

Senkronizasyon için dikkat edilmesi gerekenler:

• Güncelleme sıklığı: XML kaç dakikada bir yenileniyorsa, stok güncellemesi de ona yakın sıklıkta çalışmalı.
• Tampon stok: Tedarikçi stoğu 2 ise Trendyol'a 0 göndermek gibi güvenlik kuralları, birden fazla kanalda satış yaparken iptal riskini azaltır.
• Yalnızca değişeni gönderin: Her seferinde tüm kataloğu göndermek yerine, değişen fiyat ve stokları göndermek API sınırları açısından daha verimlidir.
• Ani değişim koruması: XML'de bir hata sonucu tüm fiyatlar sıfır gelirse bunu yayına almadan yakalayacak bir kontrol olmalı.

Sık yapılan hatalar

1. Barkodun sonradan değiştirilmesi: Barkod, ürünün kimliğidir. Değiştirildiğinde ürün eşleşmesi bozulur.
2. Görsel boyutlarının ve sayısının kontrol edilmemesi: Görsel kurallarına uymayan ürünler reddedilebilir.
3. Varyantların ayrı ürün olarak gönderilmesi: Aynı modelin renk ve bedenleri tek ürün grubunda toplanmalıdır.
4. Kampanya dönemlerinde fiyat kuralının unutulması: Kampanyaya katıldığınız ürünlerde otomatik fiyat güncellemesinin kampanyayı bozmadığından emin olun.
5. Hataları biriktirmek: Hata listesine düzenli bakılmazsa yüzlerce ürün sessizce yayın dışı kalabilir.

Entegrasyon sonrası bakım: haftalık kontrol rutini

Entegrasyon kurulduktan sonra kendi kendine çalışır gibi görünse de, düzenli küçük kontroller büyük sorunların önüne geçer. Haftada bir şu kontrolleri yapmanızı öneririz:

• Hata listesi: Son bir haftada hata alan ürünleri ve tekrar eden hata türlerini inceleyin. Aynı hata çok sayıda üründe görülüyorsa sorun genellikle tek bir eşleştirme kuralındadır.
• Yeni kategoriler: Tedarikçi XML'ine yeni bir kategori eklendiyse, bu kategorinin henüz eşleştirilmediği için ürünlerin aktarılmamış olabileceğini unutmayın.
• Fiyat sapmaları: Satış fiyatı ile alış fiyatı arasındaki farkı ürün bazında gözden geçirin. Beklenmedik derecede düşük marjlı ürünler, kural hatasının veya tedarikçi fiyat değişikliğinin işaretidir.
• Satıştan düşen ürünler: Daha önce satışta olup kapanan ürünlerin nedenini kontrol edin: stok mu bitti, yoksa içerik mi reddedildi?
• XML erişimi: Tedarikçi XML adresi değişti mi, erişim süresi uzadı mı? XML'e ulaşılamadığında entegrasyonun stokları nasıl ele aldığını bilin.

Trendyol'un kategori yapısı ve zorunlu özellikleri zaman zaman güncellenir. Bu güncellemeler sonrasında daha önce sorunsuz geçen ürünler hata vermeye başlayabilir; hata mesajlarını düzenli okumak bu değişiklikleri erken fark etmenizi sağlar. Satışa yeni başlıyorsanız Trendyol'da satışa başlama rehberi yazımız da faydalı olacaktır.

Tuvisoft ile Trendyol XML entegrasyonu

Tuvisoft Pazaryeri Entegrasyonu, tedarikçi XML'lerini zamanlanmış olarak okuyan XML ürün içe aktarımı, kategori ve alan eşleştirme ekranları ve Trendyol entegrasyonu ile bu adımların tamamını tek panelde toplar. Ani fiyat ve stok değişimlerini yayına çıkmadan yakalamak için Stok & Fiyat Kalkanı modülünü ekleyebilirsiniz.

Kendi XML kaynağınızla nasıl çalıştığını görmek için ücretsiz demo talep edebilir, paket seçeneklerini fiyatlar sayfasında inceleyebilirsiniz.