Ticimax XML'inden ürün aktarma

Bu rehber bir Ticimax kataloğunu Shopify’a taşır: Ticimax XML URL’sini yapıştırırsınız, Buinbu Urunler/Urun yapısını tanır ve alanları kendisi eşler, deneme çalıştırmasından (dry run) sonra yeni ürünleri taslak olarak oluşturur. Süre: 10 dakika artı çalıştırmanın kendisi. Deneme çalıştırması her planda vardır; aktarımı uygulamak ve zamanlamak ücretli plan ister (planlar).

Başlamadan önce

• Ticimax’tan XML çıktı URL’si: Ticimax panelinde Entegrasyonlar → Gelişmiş Xml Ayarları altında yerel Ticimax yapısında, “KDV Dahil” açık ve IP kısıtı olmayan bir çıktı oluşturun. Buinbu izin listesi için sabit çekme adresleri yayınlamaz. URL deseni ve yenileme sıklığı Ticimax tarafından belgelenmemiştir (doğrulanmadı).
• Aktarılan ürünlerin mevcut Shopify ürünlerini güncellemesini istiyorsanız Shopify ürünlerinde barkod ya da SKU.
• Yeni ürünler her zaman taslak oluşturulur; yayınlamadan önce inceleyebilirsiniz.

1. Kaynağı ekleyin

1. İçe aktarma’yı açın ve Kaynak ekle’yi seçin.
2. Kaynak adresi altında Ticimax linkini XML adresi’ne yapıştırın. Ad isteğe bağlıdır; boş kalırsa kaynak URL’nin alan adıyla adlandırılır.
3. Fiyat kuralları altında kaynaktaki satış fiyatına eklenen Kâr marjı (%)‘nı girin (indirim için eksi değer). Kaynak fiyatları KDV hariçse KDV ekle’yi açık bırakın: yalnızca KDVDahil değeri false olan varyantlara KdvOrani ya da Kaynakta oran yoksa KDV (%) ile KDV ekler. İsterseniz Fiyatları .90’a yuvarla’yı işaretleyin.
4. T-Soft seçenek adları’nı olduğu gibi bırakın: Ticimax’ta seçenek adları dosyadan okunur.
5. Kaydet ve deneme çalıştır’ı seçin. Kaynak sayfası açılır ve kendiliğinden yenilenir; çalıştırma bitince başlıkta Ticimax yazar.

Çalıştırma “XML tanınmadı” ile biterse çıktı yerel Ticimax yapısında değildir. Ticimax’ta bu yapıyı seçin ya da alanları kendiniz eşleyin (Tanınmayan XML’in alanlarını eşleyin). Fiyat kuralları ve seçenek adları sonradan düzenlenemez; değiştirmek için kaynağı silip yeniden ekleyin.

Alanlar nasıl eşleşir

Ticimax eşlemesi sabittir; ayrı bir eşleme adımı yoktur.

Shopify alanı	Ticimax elementi	Not
Başlık	UrunAdi
Açıklama	Aciklama	CDATA ya da kaçırılmış HTML; script ve formlar atılır
Satıcı (marka)	Marka
Ürün türü	KategoriTree’nin son seviyesi, yoksa Kategori	/ seviyeleri ayırır; iki yanı boşluklu / kategori adının parçası kalır
Görseller	Resimler/Resim ve varyant görselleri	Ürün başına en fazla 20
Varyantlar	UrunSecenek/Secenek	Aktif değeri false olan varyantlar atlanır
Seçenek adları ve değerleri	EkSecenekOzellik/Ozellik Tanim ve Deger, ayrıca Renk ve Beden elementleri	Yalnızca varyantlar arasında değeri değişen özellikler; en fazla üç
SKU	StokKodu
Barkod	Barkod
Fiyat	0’dan büyükse IndirimliFiyat, değilse SatisFiyati	Ondalık virgül ya da nokta, ikisi de kabul edilir
Karşılaştırma fiyatı	İndirim varsa SatisFiyati
Birim maliyet	AlisFiyati	Asla satış fiyatı olarak kullanılmaz
KDV oranı, KDV dahil mi	KdvOrani, KDVDahil	KDV kuralını belirler
Para birimi	ParaBirimiKodu, yoksa ParaBirimi	Fiyatlar çevrilmez
Stok	StokAdedi	Varyant seviyesi; birincil konumunuza yazılır
Kaynak ürün ID’si	UrunKartiID	Aktif değeri false olan ürünler “Kaynakta pasif” olarak atlanır

Bedenleri adet ve barkod öznitelikleriyle BedenlerTekli/Beden altında veren dosyalarda her beden kendi stoğu ve barkoduyla ayrı varyant olur.

2. Deneme çalıştırmasını okuyun

Son rapor Kayıt, Oluşturulacak, Güncellenecek, Değişmeyen, Atlanan, Fiyat değişimi ve Stok değişimi sayılarını verir. Altındaki not değiştirilemeyen eşleştirme sırasını açıklar: mağazanızın senkronlanmış kataloğuna göre önce barkod, sonra SKU. Örnekler her türden en fazla 20 ürünü değişiklikle birlikte listeler, örneğin “Fiyat 349.90 → 379.90”; Sorunlar TAX_RATE_DEFAULTED ya da AMBIGUOUS_MATCH gibi kodları ürünle birlikte gösterir. Atlanan ürünlerin nedeni yazar: kaynakta pasif, fiyat yok, daha önce taslak olarak oluşturuldu ya da birden çok mağaza varyantıyla eşleşiyor. Henüz hiçbir şey yazılmadı.

3. Uygulayın

Mağazaya aktar’ı seçin. Ücretli planlarda, başarılı bir deneme çalıştırmasından sonra kullanılabilir; o zamana kadar sayfa “Önce başarılı bir deneme çalıştırın.” der. Onay sorusu sayıları yineler: “N taslak ürün oluşturulacak, M ürünün fiyat ve stoğu güncellenecek.” Çalıştırma arka planda sürer.

Çalıştığını doğrulayın

• Çalıştırmalar çalıştırmayı Aktarım türüyle ve “Aktarıldı: 120 oluşturuldu, 0 güncellendi, 0 stok yazıldı, 0 başarısız” gibi bir sonuçla listeler.
• Shopify’da Ürünler’i taslak durumuna göre filtreleyin; aktarılan ürünleri inceleyip yayınlayın. Her biri Ticimax ürün ID’sini taşıyan buinbu_feed.source_ref metafield’ına sahiptir.

Sık karşılaşılan sorunlar

Belirti	Neden	Çözüm
“Kaynak indirilemedi”	Ticimax çıktısında IP kısıtı	Kısıtı kaldırın
Fiyatlar yaklaşık %20 yüksek	Fiyatlar KDV dahil olduğu hâlde KDVDahil false	Ticimax çıktısında “KDV Dahil”i açın
“Kaynakta KDV oranı yok; varsayılan oran kullanıldı”	KdvOrani boş	Kaynakta oran yoksa KDV (%) değerini kontrol edin
“Kaynak para birimi mağazanınkinden farklı”	ParaBirimiKodu mağaza para biriminiz değil	Çıktıyı mağazanızın para biriminde oluşturun

Sonraki adımlar

• Aynı kaynakla fiyat ve stoğu senkron tutun: İçe aktarma kaynağını otomatik güncel tutun.
• T-Soft’tan da mı geçiyorsunuz? T-Soft XML’inden ürün aktarma.