Tanınmayan tedarikçi XML'inin alanlarını eşleyin

Her tedarikçi Ticimax, T-Soft, Google ya da Akakçe biçimini kullanmaz. Başka bir ürün XML’inde hangi elementin bir ürünü taşıdığını ve her değerin nerede olduğunu Buinbu’ya siz söylersiniz; bundan sonra kaynak diğerleri gibi çalışır: deneme çalıştırması (dry run), aktarım ve otomatik güncelleme.

Eşleme kartı ne zaman görünür

Kaynağı her zamanki gibi ekleyin: İçe aktarma, Kaynak ekle, XML adresi’ni yapıştırın ve Kaydet ve deneme çalıştır’ı seçin. Biçim tanınmazsa çalıştırma “Çalıştırma başarısız: XML tanınmadı…” ile biter ve kaynak sayfasında Alan eşleme kartı görünür. Formda girdiğiniz fiyat kuralları eşlenen kaynakta da geçerlidir.

1. Dosyayı inceleyin

Dosyayı incele’yi seçin. Buinbu dosyanın yalnızca ilk 256 KB’ını indirir ve tekrar eden, alt elementleri olan bir element arar. Bulamazsa kart “Dosyada tekrar eden bir ürün kaydı bulunamadı. Adresin ürün XML’i olduğundan emin olun.” der.

2. Ürün kaydını seçin

Ürün kaydı altında Her ürünün (veya varyantın) bulunduğu element adayları <Urun> · 3 kayıt biçiminde, en sığ olan önce listeler. Sayı dosyanın tamamını değil, yalnızca incelenen kısmı kapsar. Tam bir ürünü saran elementi seçin; tedarikçi her beden ya da renk için ayrı kayıt yazıyorsa bir varyantı saran elementi. Elementi değiştirmek dosyayı yeniden inceler.

3. Alanları eşleyin

Alanlar altında her hedef alanın listesinde ilk beş kayıtta bulunan yollar örnek değerleriyle yer alır: Fiyatlar/Satis — 749,90 TL. Yol adı tanıdık görünen alanlar (barkod, stok, marka, price) sizin için doldurulur; her birini kontrol edin ve gerekmeyenlerde — Kullanılmıyor —‘u seçin. Zorunlu alanlar * ile işaretlidir.

Alan	Zorunlu	Not
Ürün / varyant kodu	Evet	Kayıt başına tekil; SKU eşlenmezse SKU olarak da kullanılır
Ürün adı	Evet
Satış fiyatı	Evet	749,90, 1.249,90 TL ve 349.90 TRY okunur; değerdeki para birimi kullanılır
Liste (indirimsiz) fiyat		Yalnızca satış fiyatından yüksekse karşılaştırma fiyatı olur
Stok		Eşlenmezse stok bilinmiyor sayılır: yeni ürünler takipsiz oluşur, mevcut stok korunur
Barkod, SKU		Eşleştirmede kullanılır: önce barkod, sonra SKU
Marka, Kategori, Açıklama		Kategori seviyeleri > ile ayrılır; son seviye ürün türü olur
Ana görsel, Ek görseller		Ek görseller tekrar eden yolun tüm değerlerini alır
Varyant grup kodu		Aynı kodu taşıyan kayıtlar tek ürünün varyantları olur
1. seçenek değeri, 2. seçenek değeri		Yalnızca grup içinde farklılaşınca seçenek olur
Alış fiyatı		Para birimi mağazanınkiyle aynıysa birim maliyet olarak yazılır
Para birimi alanı		Fiyattaki para biriminin yerine geçer
KDV oranı		20, %20 ve 0.2 hepsi %20 demektir

Zorunlu bir alan boşken Eşlemeyi kaydet ve deneme çalıştır kapalı kalır ve kart bunları “Zorunlu alanlar eksik: …” olarak listeler.

Yollar, öznitelikler ve iç içe elementler

Yollar kayıt elementine göredir:

Yol	Okuduğu
Ad	<Ad> alt elementinin metni
Fiyatlar/Satis	<Fiyatlar> içindeki <Satis>
@kod	Kaydın kendi kod özniteliği
Resimler/Resim/@url	Her <Resim>’in url özniteliği

Bir yol kaydın en fazla dört seviye altına inebilir ve tek bir öznitelikle bitebilir. Listeler, örnek kayıtlarda değeri olan ve en fazla üç seviye derindeki yolları gösterir. Bu dosya için:

<Urun kod="K-100-S">
  <Ad>Keten Gömlek</Ad>
  <Fiyatlar><Satis>749,90 TL</Satis><Liste>899,90</Liste></Fiyatlar>
  <Stok>12</Stok><Barkod>8690000000035</Barkod>
  <Grup>K-100</Grup><Renk>Beyaz</Renk><Beden>S</Beden><Kdv>%20</Kdv>
  <Resimler><Resim url="https://example.com/1.jpg"/></Resimler>
</Urun>

Ürün / varyant kodu’nu @kod’a, Satış fiyatı’nı Fiyatlar/Satis’e, Liste (indirimsiz) fiyat’ı Fiyatlar/Liste’ye, Varyant grup kodu’nu Grup’a, 1. seçenek değeri’ni Renk’e, 2. seçenek değeri’ni Beden’e ve Ek görseller’i Resimler/Resim/@url’ye eşleyin.

4. Seçenekler ve fiyat

• 1. seçenek adı ve 2. seçenek adı: iki seçenek değerinin Shopify’daki seçenek adları, varsayılan Renk ve Beden. Tüm grupta aynı değeri taşıyan seçenek atılır; hiçbir seçenek farklılaşmıyorsa varyantlar kayıt kodunu değer alan Seçenek adlı bir seçenek alır.
• Para birimi (alan yoksa): ne para birimi alanı ne de fiyat bir para birimi taşıyorsa kullanılır; varsayılan TRY. Fiyatlar hiçbir zaman çevrilmez.
• Fiyatlar KDV dahil: varsayılan açık. Dosyada net fiyat varsa kapatın; kaynakta Kaynak fiyatları KDV hariçse KDV ekle açıksa (varsayılan) KDV oranı alanı, o yoksa Kaynakta oran yoksa KDV (%) eklenir. Örnekte 749,90 net fiyat %20 KDV ile 899,88 olur.

5. Kaydedin ve deneme çalıştırmasını okuyun

Eşlemeyi kaydet ve deneme çalıştır’ı seçin. “Eşleme kaydedildi; deneme çalıştırması başladı.” uyarısı görünür, kartta Özel eşleme rozeti çıkar ve kaynak türü Özel eşleme olur. Son rapor’u her kaynakta olduğu gibi okuyun; ücretli planda ardından Mağazaya aktar (planlar).

Eşlemeyi değiştirin ya da kaldırın

• Düzeltmek için Dosyayı incele’yi (ilk incelemeden sonra Yeniden incele) seçin: kayıt elementi aynı kaldıkça kayıtlı alanlar korunur. Değiştirip yeniden kaydedin; yeni bir deneme çalıştırması başlar.
• Eşlemeyi kaldır eşlemeyi siler ve otomatik tanımayla bir deneme çalıştırması yapar. Tedarikçi desteklenen bir biçime geçtiğinde kullanın; tanınmayan dosya yine başarısız olur ve kart geri gelir.

Sık karşılaşılan sorunlar

Belirti	Neden	Çözüm
“Dosya incelenemedi: …”	URL indirilemiyor	URL’yi tarayıcıda açın; IP ya da giriş kısıtlarını kaldırın
“Kimliksiz ürün” sorunları	Bazı kayıtlarda Ürün / varyant kodu boş	Her kayıtta bulunan bir yol seçin
Her beden ayrı ürün	Varyant grup kodu eşlenmedi	Bedenlerin ortak taşıdığı alanı eşleyin
Fiyatlar yaklaşık %20 yüksek	Zaten KDV dahil fiyata KDV eklendi	Fiyatlar KDV dahil’i açın
Bir alan listede yok	Üç seviyeden derinde ya da ilk beş kayıtta boş	Tedarikçiden daha düz bir dosya isteyin