Tedarikçiniz ürün listesini XML bağlantısı üzerinden yayınlıyorsa o bağlantıyı bir kez tanımlarsınız; fiyat, stok ve görsel değişiklikleri günde iki kez kendiliğinden kataloğunuza yansır.
Ön koşullar
- Tedarikçinizin XML feed adresi; bağlantı korumalıysa kullanıcı adı/şifre, token veya API anahtarı.
- XML dosyası 50 MB'ı aşmamalı ve boş bağlantı slotunuz olmalı: feed'ler pazaryeri bağlantılarıyla aynı paket limitinden düşer.
Adım adım: feed ekleme
- Entegrasyonlar → Pazaryeri Ayarları sayfasında XML Feed sekmesine geçin; bilgi kutusu aktif feed sayınızı ve bağlantı kullanımınızı gösterir.
- Yeni XML Feed kartına tıklayın; üstte üç adımlı gösterge belirir: 1. Bağlantı, 2. Eşleştirme, 3. Önizleme.
- Feed Adı alanına tedarikçinin adını, Feed URL alanına XML adresini yazın. Adreste kullanıcı:şifre@sunucu biçiminde kimlik bilgisi varsa otomatik ayrıştırılır.
- Bağlantı korumalıysa Kimlik Doğrulama yöntemini seçin: Yok (Herkese Açık), Basic Auth (Kullanıcı Adı / Şifre), Bearer Token veya Query Parametre (API Key).
- İçe Aktarım Ayarları bölümünü doldurun:
- Kategori Seviye Sayısı — kategori XML'de kaç alanda tutuluyor (1 = tek alan, 2-5 = kategori_1, kategori_2 gibi).
- Tanımlayıcı Alan — mevcut ürünleri eşleştirir: Barkod, SKU, Model Numarası veya Sistem ID (Reimport). Mevcut ürünleri güncelle eşleşenleri günceller, Yeni ürün oluştur eşleşmeyenleri ekler.
- Stok davranışı — Mevcut ürünlerin stoğunu da güncelle (önerilen — stok senkronu), Sadece yeni ürünlerde stok al veya Stok alma (sadece eşleştir).
- KDV oranı — tedarikçiler KDV'yi 10 (yüzde) ya da 0,10 (oran) biçiminde gönderir. Otomatik algıla her ürüne tek tek bakıp doğru oranı yazar; feed karışık biçimde gönderse bile çalışır. Feed'iniz alışılmadık bir biçim kullanıyorsa Feed'deki değer yüzde / Feed'deki değer oran ile biçimi kendiniz belirtebilir, Sabit oran kullan ile hazır oranlardan (%0, %1, %10, %20) birini veya kendi oranınızı yazabilir, KDV alma ile ürünlerinizdeki mevcut oranı koruyabilirsiniz. Eşleştirme adımında feed'den okunan örnek değerin hangi orana çevrileceği ekranda gösterilir.
- Varyant oluştur, Görselleri Pazarus'a indir (kaynak site kapansa da fotoğraflarınız kalır), SKU yoksa otomatik oluştur ve Feed'den silinen ürünleri satışa kapat anahtarlarını ihtiyacınıza göre açın; sonuncusu tedarikçi ürünü kaldırdığında stoğu 0'a çeker, ürün geri dönerse yeniden açar.
- Senkron sorunlarını e-postayla bildir — feed zaman aşımına uğrarsa ya da okunamazsa, tedarikçinin kaldırdığı ürünler güvenlik nedeniyle otomatik kapatılamazsa veya ürün limitiniz dolarsa yöneticilere sebebiyle birlikte e-posta gider (aynı sorun için en fazla 12 saatte bir; panel bildirimi her durumda gelir). Ek e-posta adresleri alanına depo veya satın alma gibi başka adresler de yazabilirsiniz.
- Kaydet ve Analiz Başlat düğmesine basın. Feed arka planda indirilip çözümlenir; sayfa "Feed analiz ediliyor…" kartına döner. İlk analiz genellikle 1-5 dakika sürer, beklemeniz gerekmez.
- Adres ürün yerine başka feed adresleri listeliyorsa "Bu bağlantı bir feed dizini" uyarısı çıkar; Hepsini ayrı feed olarak ekle düğmesi her biri için ayrı kayıt açar.
Adım adım: alan eşleştirme ve önizleme
- Pazarus XML'inizin yapısını tanıyorsa (aynı yapıyı kullanan başka bir tedarikçi için ekibimiz eşleştirmeyi daha önce kontrol ettiyse) analiz bitince Bu XML'i tanıyoruz kartı çıkar. Kartta kaç alanın hazır eşleştirildiği ve her satırda XML Etiketi, XML'inizden gelen veri ve Sistem Alanı görünür. Hazır eşleştirmeyi kullan derseniz eşleştirme uygulanır ve önizleme açılır; kaydetmeden önce istediğiniz alanı değiştirebilirsiniz. Kendim eşleştireyim derseniz aşağıdaki eşleştirme ekranına geçersiniz. Ticimax gibi Pazarus'un yerleşik tanıdığı platform XML'lerinde seçim kartı çıkmaz: eşleştirme kendiliğinden uygulanır, ekranın üstünde "… XML'i tanıdık" şeridi görünür; alanları kontrol edip Önizle ya da Kaydet'e basmanız yeterlidir.
- 2. Eşleştirme adımı Ürün görünümü ile açılır. Solda XML'inizin ilk 20 ürününden biri bölüm bölüm görünür: ürün bilgileri, görseller (XML'deki sırasıyla numaralı), kategori, marka ve varyantlar (her varyant bir satır). Her etiketin yanındaki listeden sistemdeki karşılığını seçin; varyant tablosunda sütunun altındaki seçim bütün varyantlara uygulanır. Ok düğmeleriyle ürünler arasında gezinin; Yeniden yükle XML'inizin güncel halini getirir, belirli bir ürünü aramak için Tüm ürünlerde ara bağlantısını kullanın. Bu üründe boş ve eşlenmemiş etiketler gizlidir, Boş etiketleri göster ile açılır.
- Sağdaki Pazarus'a böyle aktarılacak kartı ürünün içe aktarılınca nasıl görüneceğini gösterir: kapak ve görsel sırası, ad, kodlar (tanımlayıcı vurgulu), fiyatlar, KDV, stok, kategori, marka ve varyantlar. Kart seçim yaptıkça güncellenir ve eksiği sebebiyle yazar (örneğin Kategori boş. Bu bilgiyi taşıyan etiket eşleştirilmedi). Seçtiğiniz alan içe aktarımda ürüne yazılmıyorsa kart bunu da söyler; böyle alanlar açılır listenin en altında Ürüne aktarılmayan alanlar grubunda durur.
- Alan seçimleriniz Kaydet'e basmadan kaydedilir; sayfanın altındaki çubuk Eşleştirme kaydedildi · saat yazar. Çalışan bir feed'de seçim Ürün Adı, Kategori gibi zorunlu bir alanı ya da ürünlerin eşleştiği tanımlayıcıyı boşaltacaksa kaydedilmez ve sebebi çubukta yazar; eksik alanı seçtiğinizde kayıt devam eder. Kaydet düğmesi KDV ve varyant gibi diğer ayarları da kaydeder; yeni eklediğiniz feed'de Kaydet ve etkinleştir feed'i açıp ürünleri almaya başlatır.
- Bütün etiketleri tek listede görmek isterseniz Alan listesi sekmesine geçin: solda XML alanları, sağda sistem karşılıkları listelenir, her etiketin altında XML'inizden gelen veri görünür. Yapay zeka öneri ürettiyse AI · % rozeti çıkar. Kullanmayacağınız alanları — eşleştirilmedi — bırakın.
- Üç eşleştirme zorunludur: Ürün Adı, seçtiğiniz Tanımlayıcı ve Kategori. Tanımlayıcınız eşleşmiyor ama alternatifi eşleşiyorsa Pazarus uyarır ve kaydederken tanımlayıcıyı o alana çevirir.
- Önizle düğmesine basın; 3. Önizleme adımında ilk satırlar tablo halinde gösterilir ve her sütun başlığında XML alanı ile sistem karşılığı yan yana görünür.
- Feed'de varyant varsa Varyant Etkisi kutusu kaç ürünün kaç varyanta dönüşeceğini tahmin eder; Varyant Özellikleri · neye göre? listesinde nitelik adını düzeltebilir veya anahtarı kapatıp o niteliği gizleyebilirsiniz. Varyantlar ürün kotanıza sayılmaz.
- Ürün özellik listeleri varyant değildir. XML'iniz ürünün özelliklerini ad/değer listesi halinde veriyorsa (örneğin her öğede Uyumlu Marka = Xiaomi, Uyumlu Model = Redmi Note 12, Renk = Siyah) ve öğelerin kendi barkodu, stoğu ya da fiyatı yoksa bu liste ürünün kendi özellikleridir. Listenin ad etiketini Ürün Niteliği — Ad (ad/değer listesi), değer etiketini Ürün Niteliği — Değer (ad/değer listesi) olarak eşleştirin; her özellik ürüne nitelik olarak yazılır ve önizlemede ürünün altında Ürün nitelikleri olarak görünür. Ürün kartında elle değiştirdiğiniz bir değer sonraki senkronda ezilmez; tedarikçinin listeden kaldırdığı, sizin değiştirmediğiniz özellik üründen de kalkar.
- Çift her zaman birlikte seçilir. Yalnız ad ya da yalnız değer seçiliyse, ya da aynı listede iki etiket aynı alana bağlıysa liste içe aktarılmaz; önizlemede ve kaydettiğinizde eksik tarafı adıyla yazan bir uyarı çıkar.
- Böyle bir listeyi Varyant Özellikleri (JSON) alanına bağlarsanız varyant açılmaz ve özellikler de alınmaz; önizlemede ve kaydettiğinizde hangi etiketin hangi alana bağlanması gerektiği yazar.
- Yalnızca belirli kategorileri almak istiyorsanız Kategori Sınırlaması (opsiyonel) düğmesine basın. Kategoriler iki seviyeli bir ağaç halinde listelenir; üst kategori seçerseniz altındakiler de dahil olur, hiçbir şey seçmezseniz tümü aktarılır. Sonra İçe Aktarmayı Başlat deyin.
- Kategori sınırlaması istemiyorsanız Kaydet & Kapat yeterlidir; feed aktifleşir ve ilk indirme başlar.
Pazarus ekibinden yardım isteme
- XML'inizi tanımıyorsak eşleştirme ekranının üstünde Bu XML'i henüz tanımıyoruz kutusu çıkar. Kutudaki Pazarus ekibinden yardım iste düğmesine basın. Düğme eşleştirme ekranının sağ üstünde ve analiz başarısız olduğunda bağlantı ekranında da bulunur.
- Açılan pencerede Özellikle belirtmek istediğiniz alan var mı? listesinden takıldığınız XML alanlarını işaretleyin (her alanın altında XML'inizden gelen veri yazar) ve isterseniz not bırakın. Talebi gönder deyin.
- Talebiniz alındığında feed sayfasının üstünde tarihiyle birlikte gösterilir. Bu sırada kendiniz eşleştirmeye devam edebilirsiniz.
- Ekibimiz eşleştirmeyi hazırladığında bildirim alırsınız. Bildirimdeki Eşleştirmeyi gör bağlantısı feed sayfasını açar; henüz senkronize edilmemiş feed'de Hazır eşleştirmeyi kullan ile tek tıkla uygularsınız. Feed zaten çalışıyorsa Hazır eşleştirmeyi yükle düğmesi eşleştirmeyi ekrana getirir, siz kontrol edip kaydedene kadar uygulanmaz.
Feed'i sonradan yönetme
- Her feed Pazaryeri Ayarları → XML Feed sekmesindeki kartında durumunu (Başarılı, Hata, Hiç çalışmadı), son senkronizasyon zamanını ve son koşudaki sayıları gösterir. Aktif feed'ler her gün 06:00 ve 18:00'de kendiliğinden senkronize edilir.
- Karta tıklayınca açılan sayfada Şimdi Senkronize Et, Ürün Etiketleri, Son Log ve silme düğmeleriyle Kategori Sözlüğü ve Kategori Sınırlaması kartları bulunur.
- Ürün Etiketleri düğmesi (eşleştirme ekranındaki Bir ürünün tüm etiketlerini gör bağlantısı da aynı yere gider) XML'inizdeki bir ürünün bütün etiketlerini ve özniteliklerini değerleriyle yeni sekmede açar. XML sunucumuz üzerinden indirildiği için tedarikçinin IP kısıtı olan XML'ler de görüntülenir. Her satırda eşleştirmede kullanılan yol (örneğin Pictures.Picture@Path, yanındaki düğmeyle kopyalanır) ve değerin sistemde hangi alana yazıldığı görünür. Eşli ama bu üründe boş, Eşleştirilmemiş ve Eşleştirme listenizde yok satırları renkle işaretlenir. Aynı sistem alanına birden çok etiket bağlıysa (örneğin beş fiyat etiketinin hepsi Alış Fiyatı'na) satırın altında Bu alana N etiket eşli uyarısı çıkar: içe aktarımda yalnız biri yazıldığı için doğru etiketi bırakıp diğerlerini boşaltın; Yalnız bakılması gereken satırlar kutusu diğerlerini gizler. Ürünler arasında ileri geri gidebilir, SKU, barkod ya da ürün adıyla arayabilir, Ham XML sekmesinden ürünün XML'ini kopyalayabilirsiniz. İndirilen XML 2 saat saklanır; daha yenisi için XML'i yeniden indir deyin.
- Pazarus ekibi feed'inizin XML yapısı için eşleştirme kontrol ettiyse ve sizinki ondan farklıysa eşleştirme ekranında Ekibimizin önerisi kartı çıkar; ekip bu durumda size bildirim de gönderebilir. Kartta her farklı alan için XML Etiketi, XML'inizden gelen veri, Sizin eşleştirmeniz ve Ekibin önerisi yan yana görünür. Önerileri yükle farkları eşleştirme ekranına getirir; kontrol edip Kaydet'e basana kadar hiçbir şey değişmez. İstemiyorsanız Şimdilik kalsın deyin; ekip eşleştirmeyi güncellerse kart yeniden görünür.
- Tedarikçiniz kataloğunu birden çok XML parçası halinde veriyorsa (part-1.xml, part-2.xml gibi) eşleştirme ekranında Bu feed N parçalı bir grubun parçası kutusu çıkar ve parçalar arasında farklı eşlenmiş alanları listeler; aynı ürünün markası ya da kategorisi hangi parçadan geldiğine göre farklı alana yazılmasın. Bir parçanın eşleştirmesini kaydedip Diğer parçalara uygula ile hepsine aktarın (parçaların tanımlayıcısı ve kategori sınırlaması değişmez; zorunlu alanı eksik kalacak parça atlanır ve sebebi yazılır). Yeni bir parça eklediğinizde Başka parçanın eşleştirmesini al ile mevcut bir parçanın eşleştirmesini ekrana yükleyip kaydedebilirsiniz.
- Pazarus Asistan'a XML eşleştirmenizi sorabilirsiniz: eksik veya yanlış görünen alanları XML'inizden gelen verilerle gösterir, hazır eşleştirme varsa sizi ona yönlendirir, yoksa onayınızla Pazarus ekibine yardım talebi iletir.
Sık karşılaşılan sorunlar
- Belirti: Analiz "başarısız" kalıyor veya "XML içinde tekrarlayan element bulunamadı" hatası çıkıyor. Çözüm: Adres genellikle ürün listesi yerine hata sayfası döndürür. Adresi tarayıcıda açıp ürün etiketlerini gördüğünüzü doğrulayın, sonra yeniden Kaydet ve Analiz Başlat deyin. Analiz 10 dakikayı aşarsa başarısız işaretlenir.
- Belirti: Feed'e hiç erişilemiyor. Çözüm: Bazı tedarikçiler feed'i yalnızca izin verilen IP adreslerine açar; bağlantı ekranındaki Sunucu IP Adresi kutusundaki adresi tedarikçinize iletin.
- Belirti: "Feed boyutu plan limitini aşıyor" veya "Bağlantı limiti aşıldı" bildirimi. Çözüm: Tedarikçinizden filtrelenmiş bir adres isteyin; 50 MB üzeri feed'ler hiçbir pakette kabul edilmez. Bağlantı limitinde kullanmadığınız bir bağlantıyı kaldırın ya da paketinizi yükseltin.
- Belirti: Aktarım özetinde "Ürün limitiniz dolu" uyarısı var. Çözüm: Mevcut ürünlerin stok ve fiyatı güncellenmeye devam eder, yalnızca yeni ürünler eklenmez. Kategori sınırlamasıyla gelen ürün sayısını azaltın, kullanmadığınız ürünleri silin ya da paketinizi yükseltin.
- Belirti: Tedarikçi bir ürünün barkodunu değiştirdi. Çözüm: Bir şey yapmanız gerekmez; ürün tedarikçinin ürün koduyla eşleşmeye devam eder, stok ve fiyatı güncellenir. Ürününüzün barkodu değişmez, pazaryeri ilanlarınız etkilenmez.
- Belirti: Hangi XML alanının satış fiyatı, hangisinin alış fiyatı olduğundan emin değilsiniz. Çözüm: Eşleştirme ekranında etiketin altındaki XML'inizden gelen veri satırlarını karşılaştırın; yine emin değilseniz Pazarus ekibinden yardım iste ile ilgili alanları işaretleyip gönderin.
- Belirti: Hazır eşleştirmeyi yükledikten sonra ürün tanımlayıcısının değişeceği uyarısı çıktı. Çözüm: Çalışan bir feed'de tanımlayıcı değişirse mevcut ürünler eşleşmeyebilir ve tekrar oluşabilir. Emin değilseniz Tanımlayıcı Alan'ı eski haline getirip kaydedin.
- Belirti: Ürünler görselsiz, markasız ya da bedensiz geliyor; eşleştirme ekranında ilgili etiket var ama altında veri görünmüyor. Çözüm: Bazı XML'ler bilgiyi etiketin içinde değil özniteliğinde taşır (örneğin <Picture Path="…"/>). Eşleştirme ekranının Ürün görünümünde bu etiket kırmızıyla Bu üründe boş; bu alan dolmaz diye işaretlenir ve değer aynı etiketin bir özniteliğindeyse altında Değer … içinde, onu kullan düğmesi çıkar; basın, sağdaki kartta görselin geldiğini görün, kaydedip Şimdi Senkronize Et deyin. Öznitelik satırları ürün görünümünde doğrudan seçilebilir; alan listesine de eklemek isterseniz Ürün Etiketleri ekranındaki Yeniden analiz et düğmesine basın, mevcut eşleştirmeniz korunur.
- Belirti: Ürünler içi boş varyantlara bölünmüş görünüyor (varyantların barkodu ve stoğu yok, tek özellikleri "Xiaomi" gibi bir değer), ana ürünün barkodu boş ve pazaryerlerindeki ilanlarınız bu ürünle eşleşmiyor. Çözüm: XML'deki ürün özellik listesi varyant özelliklerine bağlanmış. Eşleştirme ekranında listenin ad etiketini Ürün Niteliği — Ad (ad/değer listesi), değer etiketini Ürün Niteliği — Değer (ad/değer listesi) olarak seçip kaydedin; özellikler ürüne nitelik olarak yazılır, yeni gelen ürünler bölünmez. Daha önce bu şekilde bölünmüş ürünlerinizi tek ürüne toplamak için destek ekibimize yazın.
- Belirti: Eşleştirmeyi kaydettiniz ama ürünlere yansımadı. Çözüm: Devam eden koşu eski eşleştirmeyle biter; bitince Şimdi Senkronize Et ile yeniden başlatın.
- Belirti: Ürünlerin KDV oranı %0 görünüyor. Çözüm: Feed'de KDV alanının eşleştirildiğini doğrulayın ve KDV oranı ayarındaki örnek değer önizlemesine bakın; yazılacak oran orada görünür. Yanlışsa biçimi elle seçin veya sabit oran verin, ardından Şimdi Senkronize Et ile mevcut ürünlerin oranını güncelleyin.
İpuçları
- İlk kurulumda küçük bir kategoriyi aktarıp sonucu kontrol edin, sonra sınırlamayı genişletin.
- Feed sonuçlarını Pazaryerleri → Dağıtım Geçmişi → Ürün Logları sayfasının İçe Aktarma sekmesinden takip edin; Kaynak filtresinden XML Feed'i seçin, satır bazında hata sayılarını görürsünüz. Kategorileri pazaryeri kategorilerine bağlamak için "Kategori ve Nitelik Eşleştirme" rehberine bakın.
