XML ile Trendyol'a Ürün Aktarma: Kategori, Özellik ve Stok Rehberi

Kısa cevap

XML dosyasındaki ürünleri Trendyol'a doğrudan kopyalamak yeterli değildir. Kaynak alanlar Trendyol kategori, marka, ürün kimliği ve zorunlu özellik modeliyle eşleştirilmeli; gönderim sonucu ayrıca takip edilmelidir.

XML ile Trendyol'a Ürün Aktarma neden önemli?

XML'de kategori adı 'Kulaklık' olabilir; pazaryerinde ise ürünün farklı bir kategori ID'si ve zorunlu teknik özellikleri vardır. Entegrasyon bu dönüşümü yapmadan toplu gönderim başlatılırsa çok sayıda ürün aynı nedenle reddedilebilir.

XML veya Excel bir veri kaynağıdır; pazaryerinin katalog şeması değildir. Kaynak alanları temizlemek, normalize etmek ve kanalın kategori/özellik modeline çevirmek entegrasyonun asıl işidir.

2026 itibarıyla pazaryerleri katalog ve sipariş servislerini düzenli olarak güncelliyor. Bu nedenle entegrasyon kararını yalnız bir kez yapılan kurulum gibi değil, izlenen ve güncellenen bir operasyon sistemi gibi ele almak daha sağlıklıdır.

Doğru çalışma mantığı nasıl kurulmalı?

Sağlam akış kaynak veriyi önce yerel ürün modeline alır. Ardından kategori, marka, varyant, fiyat ve stok kuralları uygulanır; son aşamada kanal özelindeki payload üretilir. Böylece bir pazaryerindeki değişiklik ana ürün verisini bozmaz.

Ürün veya sipariş kaydında yerel kimlik ile pazaryerinin uzak kimliğini birlikte saklamak, tekrar deneme ve durum sorgularında kritik önem taşır. İşlem geçmişi kaybolmadığında aynı kaydın neden beklediği veya reddedildiği daha hızlı bulunur.

Adım adım uygulama planı

XML'deki benzersiz ürün anahtarını barkod veya SKU bazında belirleyin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Kaynak kategori adlarını Trendyol kategori kimlikleriyle eşleştirin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Marka ve zorunlu kategori özelliklerini pazaryeri sözlüğüne dönüştürün. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Varyant gruplarında ana ürün ve alt SKU ilişkisini koruyun. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
XML fiyatını satış fiyatına dönüştürürken KDV, kâr marjı ve yuvarlama kuralını açık tanımlayın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
İlk gönderimi küçük ürün grubuyla yapıp ürün sonucunu/batch sonucunu kontrol edin. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.
Onaylanan ürünlerde stok-fiyat senkronunu ayrı iş akışı olarak çalıştırın. Bu adımın sonucunu ekran görüntüsü, işlem kimliği veya kısa kontrol notuyla doğrulayın; sonraki aşamaya doğrulama tamamlandıktan sonra geçin.

Kontrol ve ölçüm noktaları

İlk toplu aktarımda başarı oranı, eşleşmeyen marka/kategori sayısı, zorunlu özellik eksikleri ve batch sonucu izlenmelidir. Sonraki senkronlarda yalnız değişen ürünleri göndermek API yükünü ve hata yüzeyini azaltır.

İşlem hangi mağaza ve kanal için çalıştı?
Yerel SKU/barkod ile uzak ürün kimliği eşleşiyor mu?
Son durum ilk API yanıtından mı, nihai sonuç servisinden mi geliyor?
Başarısız işlem için kullanıcıya anlaşılır hata nedeni gösteriliyor mu?
Tekrar deneme mükerrer ürün veya sipariş oluşturmadan çalışıyor mu?
Canlı kanalda örnek ürün/sipariş ile sonuç doğrulandı mı?

Sık yapılan hatalar ve düzeltme yaklaşımı

XML kategori adını pazaryeri kategori ID'si sanmak.

Bu durum görüldüğünde önce etkilenen kayıtları ayırın, otomatik kuyruğu gerekirse durdurun ve kök nedeni netleştirin. Veri düzeltildikten veya geçici API sorunu sona erdikten sonra yalnız ilgili kayıtları kontrollü biçimde yeniden deneyin.

Zorunlu özellikleri tüm kategorilerde aynı kabul etmek.

Aynı barkodu birden fazla varyantta kullanmak.

Ürün gönderim yanıtı almayı ürünün satışa açıldığı şeklinde yorumlamak.

2026 için güncellik notları

Pazaryeri API dokümanları, endpoint sürümleri, zorunlu alanlar ve işlem limitleri zaman içinde değişebilir. Bu yazıdaki operasyon mantığını uygularken ilgili kanalın güncel geliştirici veya satıcı destek dokümanını esas alın. Özellikle ürün oluşturma, toplu güncelleme ve sipariş durum servislerinde sürüm notlarını takip etmek gerekir.

Canlı sistemlerde değişiklik yapmadan önce küçük ürün grubu, düşük riskli stok-fiyat değeri ve test edilebilir sipariş senaryosu kullanmak; geniş kataloğa geçmeden önce hata davranışını görmeyi sağlar.

3E Entegrasyon tarafında hangi akışlar değerlendirilebilir?

3E Yazılım’ın pazaryeri entegrasyonu sayfasında XML, Excel, manuel ürün ekleme, desteklenen bağlantılardan ürün alma, tekil/toplu ürün gönderimi, kategori-özellik eşleştirme, stok-fiyat senkronizasyonu ve sipariş takibi gibi operasyon başlıkları yer alıyor. İhtiyacınız bu akışlardan biriyse önce gerçek ürün verinizle demo senaryosu oluşturmak en sağlıklı karşılaştırma yöntemidir.

Pazaryeri entegrasyonu özelliklerini inceleyin veya demo talebi oluşturun.

Sık sorulan sorular

XML linkini eklemek ürünleri otomatik olarak Trendyol'a gönderir mi?

Hayır. Önce ürün verisi okunur, kategori/marka/özellik eşleştirmeleri tamamlanır ve pazaryeri formatında gönderim yapılır.

XML fiyatına otomatik kâr eklenebilir mi?

Entegrasyon yazılımı fiyat kuralı destekliyorsa sabit veya yüzde bazlı kural uygulanabilir.

Ürün neden gönderildiği halde görünmeyebilir?

Katalog incelemesi, zorunlu özellik, marka, barkod veya batch sonucu gibi aşamalar nedeniyle ürün henüz yayınlanmamış olabilir.

Resmî ve güvenilir kaynaklar

Trendyol Developers