XML Etiket Kılavuzu: Ulu İthalat XML Alanları ve Anlamları

Bu kılavuz, Ulu İthalat XML dosyasındaki her etiketin ne anlama geldiğini ve entegrasyon programınızda hangi alanla eşleştirilmesi gerektiğini anlatır. XML'i ilk kez bağlayan bayilerimiz ve entegrasyonu kuran yazılım ekipleri için hazırlanmıştır.

• Format: Standart XML, UTF-8 karakter kodlaması.
• Yapı: <urunler> kök etiketi içinde her ürün için bir <urun> bloğu.
• Güncelleme: Ürün, fiyat ve stok genellikle 3 ile 4 saatte bir.
• Erişim: Bayilik başvurusu onaylandığında size özel XML bağlantısı açılır.

XML'in ne olduğunu ve verilerin nasıl aktarıldığını öğrenmek isterseniz önce XML Entegrasyonu Nedir rehberimize göz atın.

Örnek XML Kaydı

Aşağıda XML dosyasındaki tek bir ürünün örnek kaydı yer alıyor. Fiyat değerleri örnek amaçlıdır; görsel adresleri kısaltılmıştır.

<urunler>
  <urun>
    <urun_ID>20223</urun_ID>
    <ozel_urun_kodu>F840E18E</ozel_urun_kodu>
    <urun_ad>Köpük Tabancası</urun_ad>
    <urun_fiyat>199.90</urun_fiyat>
    <urun_fiyat_bayi_ozel>199.90</urun_fiyat_bayi_ozel>
    <urun_stok>131</urun_stok>
    <urun_marka_ad>Ulu İthalat</urun_marka_ad>
    <urun_kategori_path><![CDATA[ Banyo Yapı & Hırdavat/Hırdavat/Manuel El Aletleri/Silikon Tabancası ]]></urun_kategori_path>
    <urun_tedarikci_ad>Ulu İthalat</urun_tedarikci_ad>
    <tedarikci>Ulu İthalat</tedarikci>
    <supplier>Ulu İthalat</supplier>
    <urun_aciklama>Köpük tabancasıdır. İlk görsel yapay zekâ ile üretilmiştir.</urun_aciklama>
    <urun_resim1>https://www.uluithalat.com/storage/feed-import/products/....webp</urun_resim1>
    <urun_resim2>https://www.uluithalat.com/storage/feed-import/products/....webp</urun_resim2>
    <renk>Çok renkli</renk>
    <urun_aktif>1</urun_aktif>
  </urun>
</urunler>

XML Etiketleri ve Anlamları

urunler

Kök etiket. Dosyadaki tüm ürünler bu etiketin içindedir.

urun

Tek bir ürünün kaydı. Her ürün kendi <urun> bloğu içinde yer alır.

urun_ID

Ürünün sistemimizdeki sayısal kimliği. Her ürün için benzersizdir ve değişmez. Sipariş iletirken ve ürünleri eşleştirirken bu numarayı kullanabilirsiniz.

ozel_urun_kodu

Ürüne özel stok kodu (örneğin F840E18E). Entegrasyon programınızda stok kodu alanıyla eşleştirin. Birden fazla tedarikçiyle çalışıyorsanız çift ürün oluşmasını bu kodla önlersiniz.

urun_ad

Ürün adı. Pazaryerine göndermeden önce başlığı kendi mağaza dilinize göre düzenleyebilirsiniz.

urun_fiyat

Ürünün XML'deki fiyatı. Ondalık ayırıcı olarak nokta kullanılır (örneğin 199.90).

urun_fiyat_bayi_ozel

Hesabınıza tanımlı bayi fiyatı. Alış maliyetinizi ve satış fiyatınızı bu alana göre hesaplayın. Bu alan size özel olduğu için XML bağlantınızı kimseyle paylaşmayın.

urun_stok

Satılabilir stok adedi. 0 olduğunda ürünü satışa kapatın. Güvenli satış için stok eşiği kullanmanızı öneririz.

urun_marka_ad

Ürünün markası. Pazaryerinde marka alanıyla eşleştirilir.

urun_kategori_path

Ana kategoriden en alt kategoriye kadar tam kategori yolu. Seviyeler eğik çizgi (/) ile ayrılır ve değer CDATA içinde gelir. En sondaki seviye ürünün asıl kategorisidir.

urun_tedarikci_ad, tedarikci, supplier

Tedarikçi adı. Üç etiket de aynı bilgiyi taşır; farklı entegrasyon programları farklı etiket adı aradığı için birlikte gönderilir. Hangisini kullandığınız fark etmez.

urun_aciklama

Ürün açıklaması. Bazı ürünlerde "İlk görsel yapay zekâ ile üretilmiştir." ibaresi yer alır; bu ifade ürün görseliyle ilgili bilgilendirmedir ve açıklamadan silinmemelidir.

urun_resim1, urun_resim2, ...

Ürün görsellerinin tam adresleri (webp formatında). urun_resim1 ana görseldir; ürüne göre urun_resim2, urun_resim3 gibi ek görseller gelir. Bazı ürünlerde tek görsel bulunur.

renk

Ürünün renk bilgisi (örneğin Çok renkli, Siyah). Pazaryerinin zorunlu renk alanıyla eşleştirebilirsiniz.

urun_aktif

Ürünün satış durumu: 1 aktif, 0 pasif. 0 gelen ürünleri mağazanızda satışa kapatın.

Entegrasyonda Alan Eşleştirme

Entegrasyon programlarının çoğu XML'i okurken hangi etiketin hangi alana gideceğini sizden ister. Önerdiğimiz eşleştirme:

• Stok kodu (SKU): ozel_urun_kodu
• Ürün kimliği / tedarikçi ürün ID: urun_ID
• Ürün başlığı: urun_ad
• Açıklama: urun_aciklama
• Alış fiyatı: urun_fiyat_bayi_ozel
• Stok: urun_stok
• Marka: urun_marka_ad
• Kategori: urun_kategori_path (son seviye)
• Görseller: urun_resim1 ana görsel, diğerleri ek görsel
• Renk: renk
• Satış durumu: urun_aktif (1 açık, 0 kapalı)

Pazaryerine göre adım adım kurulum için: Trendyol, Hepsiburada, N11, Shopify ve ikas.

Fiyat ve Stok Kuralları İçin Öneriler

• Satış fiyatını formülle kurun: Alış fiyatı (urun_fiyat_bayi_ozel) üzerine pazaryeri komisyonu, kargo ve kâr payınızı ekleyen bir kural tanımlayın. Böylece XML'deki fiyat değiştiğinde satış fiyatınız da otomatik güncellenir.
• Yuvarlama kullanın: 237,43 TL yerine 239,90 TL gibi yuvarlanmış fiyatlar daha düzenli görünür.
• Stok eşiği koyun: urun_stok belirli bir adedin (örneğin 3) altına düştüğünde ürünü satışa kapatın. Böylece aynı anda gelen siparişlerde stok yetersizliği yaşamazsınız.
• Pasif ürünleri kapatın: urun_aktif 0 gelen ürünlerin mağazanızda satışta kalmamasını sağlayın.

Ayrıntılı anlatım: XML Ürünlerinde Fiyat ve Stok Güncellemesi Nasıl Yönetilir · Kâr hesabı için: Pazaryeri Komisyonu ve Kâr Hesaplaması

Sık Karşılaşılan XML Hataları

• Fiyatlar 100 kat yanlış görünüyor: Program, nokta ayırıcıyı binlik ayırıcı olarak okuyor. Fiyat alanının ondalık ayırıcısını nokta olarak ayarlayın.
• Kategori boş geliyor: Program CDATA içindeki değeri okumuyor olabilir. CDATA desteğini açın veya değerin başındaki ve sonundaki boşlukları temizleyin.
• Görseller yüklenmiyor: Pazaryerinin görsel boyutu veya formatı kuralına takılıyor olabilir. Görsel adresinin tarayıcıda açıldığını kontrol edin.
• Aynı ürün iki kez açılmış: Eşleştirme ürün adıyla yapılıyordur. Eşleştirmeyi ozel_urun_kodu ile yapın.

Diğer hata mesajlarının anlamı için XML Entegrasyon Hata Logları Nasıl Okunur yazımıza bakın.

Sık Sorulan Sorular

Ulu İthalat XML'inde barkod alanı var mı?

XML'de ayrı bir barkod etiketi bulunmaz. Ürünleri tanımlamak için ozel_urun_kodu ve urun_ID alanlarını kullanabilirsiniz. Pazaryerinin barkod zorunluluğu için entegrasyon programınızın sunduğu çözümü kullanın.

XML'deki fiyatlar hangi formatta geliyor?

Fiyatlar ondalık ayırıcı olarak nokta kullanılarak gelir (örneğin 199.90). Entegrasyon programınızda fiyat alanının nokta ayırıcıyı doğru okuduğunu kontrol edin; aksi halde fiyatlar 100 kat yüksek veya düşük görünebilir.

Kategori yolunu pazaryeri kategorisine nasıl eşleştiririm?

urun_kategori_path değerini eğik çizgiden bölün ve en son seviyeyi esas alın. Entegrasyon programınızın kategori eşleştirme ekranında bu son seviyeyi pazaryerindeki en yakın kategoriyle bir kez eşleştirmeniz yeterlidir; aynı yoldaki tüm ürünler otomatik eşleşir.

urun_aktif 0 gelen ürünü ne yapmalıyım?

Mağazanızda satışa kapatın. Ürün silinmez; tekrar aktif olduğunda 1 olarak gelir ve yeniden satışa açabilirsiniz.

XML ne sıklıkla güncelleniyor?

Ürün, fiyat ve stok bilgileri genellikle 3 ile 4 saatte bir güncellenir. Entegrasyon programınızın da en az bu sıklıkta XML'i okumasını öneririz.

XML bağlantımı başkasıyla paylaşabilir miyim?

Hayır. XML bağlantınız size özeldir ve bayi fiyatlarınızı içerir. Entegrasyon firması dışında kimseyle paylaşmayın.

XML Erişimi Nasıl Alınır?

Ulu İthalat XML'i ücretsizdir; minimum sipariş şartı yoktur. Başvurunuz onaylandığında size özel XML bağlantınız hemen açılır. Başvuru için şirket gerekir, şahıs şirketi yeterlidir.

Ücretsiz XML bayilik başvurusu yapın → · XML Bayilik hakkında bilgi · XML Tedarikçi