Ticimax XML Ürün Entegrasyonu

14 Ekim 2026 · 7 dk · Burak Oğuz

XML ne işe yarar, ne işe yaramaz

XML ürün entegrasyonu, tedarikçinin veya başka bir sistemin ürün listesini Ticimax kataloğuna taşır. Amaç her sabah elle Excel yapıştırmamaktır. Amaç, fiyat ve stokun hangi dosyadan geleceğini sabitlemektir. XML, pazaryeri siparişi değildir. Trendyol veya Hepsiburada bağlantısı ayrı bir iştir ve pazaryeri entegrasyonu sayfasında durur.

Dosya açılıyor diye entegrasyon bitmiş sayılmaz. Alanlar yanlış eşlendiyse ürün yanlış kategoride, yanlış fiyatta veya görselsiz oluşur. Bir sonraki tur da aynı hatayı yazar. İlk iş, dosyanın gerçekten o tedarikçiye ait olduğunu ve hangi sıklıkla yenilendiğini yazmaktır.

Paketinizde XML veya entegrasyon hakkı olmayabilir. Hak adı sürüme göre değişir. Menü yolu uydurulmaz. Hak yoksa dosyayı panele zorlamak yerine kapsamı özel yazılım veya tedarikçi yöntemi olarak ayırın.

Örnek ürünle eşleme

Tüm dosyayı ilk turda içeri almayın. İçinden üç kayıt seçin: tek varyant, bedenli veya renkli, birden fazla görselli. Bu üçü Ticimax'ta doğru kod, fiyat, stok ve kategoriyle durmadan zamanlamayı açmayın.

Eşlenecek alanlar en az şunlardır: ürün kodu, ad, fiyat, stok, kategori, görsel adresi, varyant kodu ve barkod. Tedarikçi alanı ile panel alanı aynı isimde olmak zorunda değildir. 'price' ile 'fiyat'ı elle eşlersiniz. Eşlemeden emin değilseniz boş bırakın; yanlış alana basmak, bir sonraki turda doğru veriyi de ezer.

Ürün kodu sabittir. Tedarikçi her turda kodu değiştiriyorsa Ticimax her seferinde yeni ürün açar ve eski kayıt hayalet kalır. Kodun değişmediğini tedarikçiye sorun. Değişiyorsa entegrasyonu büyütmeyin.

Stok ve fiyat kaynağı

XML stok yazıyorsa panelde elle girdiğiniz stok bir sonraki turda kaybolur. Tek kaynak seçin. Kaynak XML ise depo sayımı XML'e işlenir. Kaynak panel ise XML'in stok alanını eşlemeyin. İkisini birden açık bırakmak, sabah ile öğlen arasında iki farklı rakam üretir.

Fiyat için de aynı kural vardır. Tedarikçi KDV hariç gönderiyor, siz dahil sanıyorsanız vitrin yanlış rakam basar. Dahil mi hariç mi, dosyadaki bir örnekle ve vitrindeki aynı ürünle yan yana yazılır. Bu rehber oran vermez.

Kampanya fiyatı XML'den gelen liste fiyatının üstüne panelden biniyorsa kampanya her turda silinebilir. Kampanyayı ayrıca not edin. Ayrıntı kampanya ve kupon rehberindedir.

Görsel ve kategori

Görsel adresi dış sitede duruyorsa o adres kapanınca ürün görselsiz kalır. Adresin tarayıcıda açıldığını örnek üründe deneyin. Açılmıyorsa entegrasyon değil, dosya barındırma bozuktur.

Tedarikçi kategorisi sizin menünüzle aynı değildir. Eşleme tablosu yoksa bütün ürünler tek kategoriye düşer. Tabloyu örnek üç üründe kurun, sonra dosyayı büyütün. Kategori kapalıysa ürün panelde durur, vitrinde görünmez. O belirti ürün sitede görünmüyor sırasıyla ayrılır.

Varyant XML'de ayrı satırsa her satırın ana ürüne bağlanması gerekir. Bağ yoksa her beden ayrı ürün olur. Müşteri listede aynı ürünü dört kez görür, stok da bölünür.

Zamanlama ve hata kaydı

Aktarımın ne zaman çalıştığı yazılır. Elle düzeltme ile otomatik tur çakışmasın. Tur sırasında paneli o üründe elle kaydetmek, turun yazdığı alanı geri alabilir.

Hata listesini okumadan dosyayı yeniden çekmeyin. Aynı ret, aynı eşlemeyle tekrar eder. Ret nedeni kod, fiyat veya görsel diye ayrılır. Ayrılmadan 'XML bozuk' demek, tedarikçiyi de sizi de yanlış yere bakar.

Bir tedarikçinin dosyası diğerine örnek olmaz. Alan adları benzese de KDV, stok ve varyant düzeni değişir. İkinci dosyayı birincinin eşlemesine yapıştırmayın.

Erişim

XML adresinin içinde şifre varsa bu adresi herkese açık bir sayfaya koymayın. İlk destek mesajında dosya şifresini yapıştırmayın. Örnek ürün kodu ve mağaza adresi yeter.

Entegrasyon çalışıyor diye katalog satışa hazır değildir. Yayındaki fiyatı ve stoğu örnek siparişle bir kez doğrulayın. Doğrulama, danışmanlık veya kurulum kabulünün parçası olarak konuşulabilir.

İkinci turdan önce

XML katalog besler. Pazaryeri siparişi başka iştir ve aynı düğmeyle açılmaz.

  • Kod sabitliği. Tedarikçi kodu her turda değişiyorsa yeni kart açılır.
  • Üç örnek. Tek varyant, çok varyant ve çok görsel doğrulanmadan zaman açmayın.
  • Fiyat yönü. KDV dahil mi hariç mi, vitrindeki rakamla yan yana yazın.
  • Stok yönü. XML stok yazıyorsa elle stok girmeyin.
  • Kategori tablosu. Tedarikçi kategorisi menünüze eşlenmeden tüm ürün tek listeye düşer.
  • Görsel adresi. Adres tarayıcıda açılmıyorsa eşleme değil barındırma bozuktur.
  • Varyant satırı. Her beden ayrı ürün oluyorsa bağ alanı eksiktir.
  • Hata listesi. Aynı reti okumadan dosyayı yeniden çekmeyin.
  • Çakışma. Tur sırasında o üründe elle kaydetmeyin.
  • İkinci tedarikçi. İlk dosyanın eşlemesini ikinciye yapıştırmayın.
  • Kampanya. Liste fiyatı her turda yazılırsa panel kampanyası silinir.
  • Hak. Paketinizde bu aktarım yoksa menü aramak yerine kapsamı ayırın.

Örnek üç ürün vitrinde doğru durmuyorsa dosyayı büyütmek hatayı da büyütür.

Kalıcı düzeltme kaynak dosyadadır. Paneldeki tek seferlik kayıt sonraki turda gider.

Aynı gün içinde not

Kod sabitliği. Tedarikçi kodu her turda değişiyorsa yeni kart açılır. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Üç örnek. Tek varyant, çok varyant ve çok görsel doğrulanmadan zaman açmayın. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Fiyat yönü. KDV dahil mi hariç mi, vitrindeki rakamla yan yana yazın. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Stok yönü. XML stok yazıyorsa elle stok girmeyin. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Kategori tablosu. Tedarikçi kategorisi menünüze eşlenmeden tüm ürün tek listeye düşer. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Görsel adresi. Adres tarayıcıda açılmıyorsa eşleme değil barındırma bozuktur. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Varyant satırı. Her beden ayrı ürün oluyorsa bağ alanı eksiktir. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Hata listesi. Aynı reti okumadan dosyayı yeniden çekmeyin. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Çakışma. Tur sırasında o üründe elle kaydetmeyin. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

İkinci tedarikçi. İlk dosyanın eşlemesini ikinciye yapıştırmayın. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Kampanya. Liste fiyatı her turda yazılırsa panel kampanyası silinir. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Hak. Paketinizde bu aktarım yoksa menü aramak yerine kapsamı ayırın. Kontrolü tek örnek kayıtta yapın. Örnek beklediğiniz sonucu veriyorsa aynı koşulu gruba uygulayın. Vermiyorsa ayarı veya dosyayı büyütmeyin. Sonucu bir satır olarak yazın; ertesi gün aynı yeri yeniden aramak, asıl kuralı gizler. Bu satırda saat ve örnek kod bulunsun, şifre veya kart bilgisi bulunmasın.

Sık sorulan sorular

XML bağlayınca pazaryeri de açılır mı?

Hayır. XML kataloğu besler. Pazaryeri ayrı hesap, kategori ve stok kuralı ister. İkisini aynı iş sanmayın.

Elle düzelttiğim fiyat neden geri dönüyor?

XML fiyat alanını eşliyorsa her tur liste fiyatını yeniden yazar. Ya kaynağı XML yapın ya da fiyat alanını eşlemeden çıkarın.

Tüm dosyayı ilk gün almalı mıyım?

Hayır. Üç örnek ürün doğru oluşmadan zamanlamayı açmayın. Hatalı eşleme dosya büyüdükçe çoğalır.

Görseller panelde boş.

Önce görsel adresini tarayıcıda açın. Açılmıyorsa sorun eşlemeden önce dosyanın barındığı yerdedir.