XML ile Ürün Yükleme
XML İçeri Aktarma özelliği, harici bir XML adresinde yayınlanan ürünleri Agesoft altyapınıza aktarmanızı sağlar. Aktarım; tek seferlik çalıştırılabileceği gibi belirlediğiniz periyotlarda otomatik olarak da yürütülebilir. Bu sayede tedarikçi katalogları, farklı mağaza XML’leri veya entegrasyon çıktıları düzenli şekilde güncellenir.
Ürün XML Kaynağı Oluşturma ve Ayarları
Yeni bir XML kaynağı oluşturmak için Ürünler → XML İçeri Aktar sayfasındaki Yeni XML Kaynağı butonunu kullanabilirsiniz. Mevcut bir kaynağı düzenlemek için ise listeden ilgili kaydın görüntüleme/düzenleme alanına girmeniz yeterlidir. Her kaynak, tanımladığınız kurallara göre ürünleri içeri alır ve günceller.
Bilgiler
Bu adımda XML kaynağına ait temel bilgileri ve aktarımın nasıl çalışacağını belirlersiniz. Özellikle zamanlama ve ürün kodu ön eki gibi ayarlar, sonraki güncellemelerin doğru eşleşmesi için kritiktir.
| Alan | Açıklama |
|---|---|
| Kaynak Adı / Kısa Adı | Panelde görüntülenecek tanım ve raporlamalarda kullanılacak ortak kısa addır. |
| Dosya Linki | XML kaynağının URL adresidir. |
| Zamanlama | Aktarımın çalışma periyodunu belirler (Hiçbir Zaman, Saatlik, 3 saatte bir vb.). Hiçbir Zaman seçilirse aktarım manuel olarak başlatılmalıdır. |
| Ürün Kodu / Barkodu Ön Eki |
Aktarılan ürünlerin kod ve barkodlarına eklenecek ön eklerdir.
Dikkat: Ürünler içeri aktarıldıktan sonra bu ön eki değiştirmeniz, ürünlerin tekrar yeni ürün gibi eklenmesine neden olabilir. |
| Resim CDN Linki | XML’de görsel alanı sadece dosya adı olarak geliyorsa, tam görsel URL’si oluşturmak için ana CDN adresini girmeniz gerekir. |
XML Etiket Tanımları
Standart dışı etiketler kullanıldığında, Agesoft’un XML verilerini doğru okuyabilmesi için temel etiketlerin tanımlanması gerekir.
| Etiket | Örnek |
|---|---|
| XML Ana Etiketi | root |
| XML Ürünler Etiketi | products |
| XML Ürün Etiketi | product |
Ayarlar
Bu ayarlar, hem yeni ürün eklenirken hem de mevcut ürünler güncellenirken geçerlidir. Kaynağın yapısına göre doğru kurgulandığında, aktarım daha stabil ve yönetilebilir olur.
Ortak Ürün Kodları: Aktif edilirse, XML’deki ürün kodu sitenizde mevcutsa ürün güncellenir (yeniden eklenmez).
Fiyatlar: Fiyatlara KDV eklenmesi gibi finansal dönüştürmeler yapılabilir.
Karakter Ayarları: Özel karakterleri HTML’e çevirme, varyantlarda özel karakter düzeltmeleri (örn: “/” yerine “-” kullanma) gibi düzenlemeler.
Varsayılan Durumlar: Yeni ürünleri pasif ekleme, resimsiz ürünleri pasif ekleme gibi başlangıç kuralları.
Kargo/Ödeme: Kargo ödemesi ve kapıda ödeme tipi gibi varsayılan seçenekler.
Diğer: Varyant stoklarını ana stokla eşitleme, ürünleri her zaman aktif etme, özel alan tanımlamaları.
Güncelleme Koşulları
Bu seçenekler ürünler sitenize eklendikten sonra sadece güncelleme sırasında geçerlidir. İlgili alanları pasif yaparak panelde manuel yaptığınız değişikliklerin, XML’den gelen veriyle üzerine yazılmasını engelleyebilirsiniz.
| Güncellenecek Bilgi | Ne etkiler? |
|---|---|
| Meta Bilgileri | Ürün adı, desi, barkod, ön detay, açıklama, marka, nitelikler gibi temel bilgiler güncellenir. |
| Stok | Stok miktarı güncellenir. |
| Fiyat | Ürün fiyatları güncellenir. |
| Kategori | Ürün kategorileri güncellenir. |
| Resim | Ürün resimleri güncellenir. (Örn: “Resimleri 3 günde bir yenile” gibi bir seçenek aktifse periyodik güncelleme yapılabilir.) |
| Varyant | Varyant bilgileri güncellenir. |
| Ürün Durumu | XML kaynağındaki stok durumuna göre ürünün yayın durumu güncellenir. |
XML’den silinen ürünler: Kaynak XML’de kaldırılan ürünlerin sitenizdeki stokları otomatik olarak sıfırlanabilir veya sabit kalacak şekilde yapılandırılabilir.
Kar Oranları
Aktarım sırasında fiyatlara otomatik kâr oranı uygulamak için bu alan kullanılır. Kâr kurgusunu fiyat aralıklarına göre ölçekleyebilir veya sabit oranlarla tanımlayabilirsiniz.
Hızlı Kâr Oranları: Ön tanımlı fiyat aralıklarına göre site satış, pazaryeri satış ve piyasa fiyatlarına kâr oranları uygulanır. İsterseniz sabit oran da ekleyebilirsiniz.
Özel Kâr Oranları: Kendi belirlediğiniz fiyat aralıklarına göre özel oranlar girmenizi sağlar. Bu alanda da sabit oranlar kullanılabilir.
Ürün Filtreleme
Aktarım sırasında ürünleri belirli koşullara göre filtrelemek ve bazı içerikleri toplu şekilde düzenlemek için kullanılır. Böylece katalog “temiz” gelir; istemediğiniz ürünler aktarılmaz veya belirlediğiniz kurallarla dönüştürülür.
| Filtreleme / Düzenleme Alanı | Açıklama |
|---|---|
| Fiyat, Stok, Desi Filtreleme | Belirlenen minimum/maksimum aralıklarına uymayan ürünler aktarılmaz veya tercihe göre stokları sıfırlanabilir. |
| Bul ve Değiştir | Başlık, marka, ön detay, açıklama, SEO alanları, ürün URL ve varyant alanlarında toplu metin değişikliği yapılır. (Büyük/küçük harf duyarlılığı yoktur.) |
| Harf Tipi Düzenleme | Ürün adı, kategori, marka, ön detay gibi alanların yazım formatı düzenlenir (Tümü büyük, sadece baş harfler büyük vb.). |
| Ürün Adı Ön Eki | Ürün adının başına otomatik metin eklenmesini sağlar (örn: “Yeni Sezon - ”). |
Eşleştirme
XML kaynağındaki verilerin Agesoft üzerindeki doğru alanlara aktarılabilmesi için bu sekmedeki eşleştirmelerin tamamlanması zorunludur. Ürün kodu, kategori ve marka gibi kritik alanlar doğru eşleşmeden aktarım sağlıklı çalışmaz.
Kaynak Etiketlerini Eşleştirme: XML’deki etiketler (productCode, name, price vb.) paneldeki karşılıklarıyla eşleştirilir (Ürün Kodu, Ürün Adı, Satış Fiyatı vb.).
Zorunlu Alanlar: Ürün kodu, Kategori ve Marka alanlarının eşleştirilmesi zorunludur.
Sabit Değer Tanımlama: XML’de karşılığı olmayan ancak zorunlu alanlar için manuel sabit değer girilebilir.
Nitelikler / Varyantlar: Bu verilerin aktarımı için XML’de iç içe (nested) etiket yapısı gerekir (örn: variants → variant → variant_name).
Kategori Filtreleme / Eşleştirme
Kategori Eşleştirme Tipi:
Sitedeki Kategoriler ile Eşleştir: XML kategorisi sitenizdeki mevcut bir kategoriye bağlanır (XML kategorisi sitenize eklenmez).
Kategorileri Kaynaktan Aktar: XML kategorileri sitenizde oluşturulur. (Kategori ayrıştırma “→”, “|” gibi ayraçlarla çoklu kategori yapısı kurmaya uygundur.)
Kategoriler Aktarılmasın: Ürünler kategorisiz aktarılır.
Marka Filtreleme
XML kaynağındaki markalar bu alanda görüntülenebilir. Markalara özel kâr oranı eklenebilir ve hangi markaların aktarılacağı Durum üzerinden yönetilebilir.
XML Aktarımını Başlatma ve Loglar
XML kaynağını yapılandırdıktan sonra Ürünleri Aktar butonu ile aktarımı başlatabilirsiniz. Zamanlama tanımladıysanız işlem otomatik olarak belirlediğiniz periyotlarda çalışır.
Aktarım başladığında, kaynak satırındaki Log butonundan süreç takibi yapılabilir. Log ekranında aktarım durumu ile birlikte Ürün Kodu ve Site Ürün Numarası gibi eşleştirme bilgileri izlenebilir.