Tedarikçi Ürün Aktarma (XML, CSV, JSON)
Hazırlayan Ersin DorlakSon güncelleme:
Bu Sayfa Ne Yapar
Tedarikçi Ürün Aktarma, tedarikçinizin size bayi olarak verdiği XML, CSV ya da JSON ürün listesini düzenli aralıklarla okur ve WooCommerce mağazanıza fiyat, stok ve gerekirse yeni ürün olarak aktarır. Yüzlerce ürünün fiyat ve stoğunu tedarikçi listesinden elle güncellemek hem zaman alır hem de satılamayan ürünün sitede stokta görünmesine yol açar; bu ekran eşleşmeyi stok koduyla kendiliğinden yapar.
Ekranın başlığı Tedarikçi Ürün Aktarma'dır. Üstteki Yalnız yetkili olduğunuz kaynaklar bandı botun yalnız size verilen liste adresini okuduğunu hatırlatır. Altında Hedef mağaza kartı, Tedarikçi kaynakları (1/3) formu ve eklenen her kaynağın kartı bulunur. Kaynak kartında kaynak bilgisi satırı, kural satırı, son senkron satırı ve Önizle, Kuralları düzenle, Şimdi senkronize et, Duraklat / Sürdür, Kaynağı sil düğmeleri yer alır.
Ürünler mağazaya SKU (stok kodu) ile eşleşerek Otopilot WordPress eklentisi üzerinden yazılır; eklentinin 1.6.0 ya da üstü sürümü kurulu ve projeye bağlı olmalıdır. Senkron 6, 12 ya da 24 saatte bir kendiliğinden çalışır; ilk senkron kaynak eklendikten sonra en geç 30 dakika içinde yapılır. Bir listede ilk 5.000 satır işlenir, 20 MB'tan büyük listeler indirilmez; her çalışma değişiklikleri 50'şerlik partilerle gönderir ve bir çalışmada işlenemeyenler sonraki çalışmaya kalır. En çok 3 tedarikçi kaynağı eklenebilir.
Fiyat kuralları kaynak başına tanımlanır: Kâr marjı (%), Sabit ekleme (TL), KDV ekle (%), Yuvarlama ve En düşük fiyat (TL). Şu an yalnız WooCommerce desteklenir; OpenCart ve Shopify aktarımı yakında olarak işaretlidir ve henüz kullanılamaz.
Ekran, tedarikçi listesiyle çalışan e-ticaret siteleri ve bayi ağına ürün aktaran mağazalar içindir. Bot başka sitelerin sayfalarından ürün, fiyat, görsel ya da açıklama kazımaz ve bunun için kullanılamaz; listedeki görsel ve açıklamaları kullanma hakkınız olmalıdır. Sık yanlış anlama, Kaynağı sil düğmesinin mağazadaki ürünleri de sileceğini düşünmektir; kaynak silinse de mağazadaki ürünler yerinde kalır.
Anlatılan sayfayı panelde aç(giriş yapınca açılır)
Ön Koşullar
- Hesabınızda etkin bir Tedarikçi Ürün Aktarma Botu lisansı olmalıdır.
- Mağazanız panelde proje olarak ekli olmalı ve Otopilot WordPress eklentisinin 1.6.0 ya da üstü sürümü kurulu ve projeye bağlı olmalıdır.
- Tedarikçinizin verdiği ürün listesi adresi (https://…) ve listede her ürün için bir SKU (stok kodu) alanı bulunmalıdır.
- Listeyi kullanmaya yetkili olduğunuzu onaylamanız gerekir; listedeki görsel ve açıklamaları kullanma hakkınız olmalıdır.
Adım Adım Kullanım
- Lisanslarım'daki Tedarikçi Ürün Aktarma Botu kartından Panelde aç ile ekrana geçin ve önce Hedef mağaza kartına bakın. Mağazanızın yanında "hazır (eklenti 1.6.2)" yazıyorsa devam edin; "WordPress eklentisi bağlı değil" ya da sürüm uyarısı varsa eklentiyi kurup güncelleyin.
- Tedarikçi kaynakları formunda Kaynak adı alanına tanıyacağınız bir ad (ör. "ABC Toptan bayi listesi") yazın, Hedef mağaza listesinden mağazayı seçin ve Ürün listesi adresi alanına tedarikçinin verdiği adresi yapıştırın. Adres şifreli bağlantı anahtarı içeriyorsa ekranda gizlenir.
- Biçim alanında Otomatik algıla seçeneğini bırakın; liste yanlış algılanırsa XML, CSV ya da JSON seçin. Senkron sıklığı olarak 6, 12 ya da 24 saati seçin: stok sık değişiyorsa 6 saat, fiyatlar haftalık güncelleniyorsa 24 saat yeterlidir.
- Yetki onay kutusunu ("Bu ürün listesini kullanmaya yetkiliyim…") işaretleyip Kaynağı ekle'ye basın. "Kaynak eklendi. Önizle ile alan eşleşmesini kontrol edin; ilk senkron en geç 30 dakika içinde yapılır." mesajı çıkar.
- Kaynağın kartında Önizle'ye basın. "Biçim XML: 1.240 satır okundu, SKU'su olan 1.236 ürün." gibi özeti ve örnek satırlarda SKU, Ad, Alış, Satış, Stok ve Kategori sütunlarını kontrol edin; satış sütunu kurallarınız uygulanmış fiyatı gösterir.
- "SKU alanı eşleşmedi." uyarısı çıkarsa alan seçicilerden SKU / stok kodu (zorunlu), Ürün adı, Alış fiyatı, Stok, Barkod, Açıklama, Görsel adresi ve Kategori için listedeki doğru alanı seçin ve Eşleşmeyi kaydet'e basın; SKU olmadan senkron yapılmaz.
- Kuralları düzenle ile Kâr marjı (%), Sabit ekleme (TL), KDV ekle (%), Yuvarlama (Yuvarlama yok, Tam sayıya, …,90 ile bitir, …,99 ile bitir) ve En düşük fiyat (TL) alanlarını girin. Kartta "Örnek: 100 TL alış fiyatı → 154,90 TL satış fiyatı." biçiminde hesap görünür.
- Aynı kuralda davranışı seçin: Yalnız stok güncelle fiyatlara dokunmaz; Mağazada olmayan ürünleri oluştur yeni ürün açar ve Yeni ürün durumu olarak Taslak ya da Yayında seçilir; Yeni ürünlerde görseli listeden indir ve Mevcut ürünlerin adını, açıklamasını ve kategorisini de güncelle isteğe bağlıdır. Birden çok tedarikçide aynı kodlar varsa SKU ön eki girin ve Kuralları kaydet deyin.
- Beklemeden çalıştırmak için Şimdi senkronize et'e basın. Son senkron satırında geçerli ürün, değişiklik, oluşturulan, güncellenen, hatalı ve sonraki çalışmaya kalan ürün sayıları yazar; durum Başarılı, Kısmen ya da Başarısız olarak işaretlenir.
- Tedarikçi listesini geçici olarak durdurmak için Duraklat, devam etmek için Sürdür kullanın. Kaynağı tamamen kaldırmak için Kaynağı sil düğmesine basıp onaylayın; mağazanızdaki ürünler silinmez.
Fiyat nasıl hesaplanır
- Alış fiyatına önce kâr marjı yüzdesi, sonra sabit ekleme uygulanır.
- KDV ekle alanı doluysa KDV eklenir.
- Seçilen yuvarlama uygulanır ve sonuç en düşük fiyatın altındaysa en düşük fiyat kullanılır.
- Kuralları kaydetmeden önce kartta gösterilen örnek alış → satış fiyatıyla hesabı kontrol edin.
Ekrandaki öğeler
- Yalnız yetkili olduğunuz kaynaklar bandı — Botun yalnız size verilen listeyi okuduğunu ve kazıma yapmadığını anlatır.
- Hedef mağaza kartı — WooCommerce mağazalarınızın eklenti durumu: "hazır (eklenti 1.6.2)", sürüm uyarısı ya da "WordPress eklentisi bağlı değil"; OpenCart ve Shopify yakında.
- Tedarikçi kaynakları (1/3) formu — Kaynak adı, Hedef mağaza, Ürün listesi adresi, Biçim, Senkron sıklığı, yetki onay kutusu ve Kaynağı ekle.
- Kaynak bilgi satırı — Liste adresi, hedef mağaza, sıklık ve biçim; duraklatılmışsa duraklatıldı.
- Kural satırı — "Kural: %40 marj + 5 TL, KDV %20, …,90 ile bitir" biçiminde özet.
- Son senkron satırı — Geçerli ürün, değişiklik, oluşturulan, güncellenen, hata ve sonraki çalışmaya kalan sayıları; henüz çalışmadıysa "Henüz senkron yapılmadı."
- Durum etiketleri — Başarılı, Kısmen, Başarısız, Henüz çalışmadı.
- Önizle — Satır özeti, örnek satırlar, alan eşleştirme seçicileri ve Eşleşmeyi kaydet.
- Kuralları düzenle / Kuralları kaydet — Fiyat kuralları, davranış seçenekleri, Yeni ürün durumu ve SKU ön eki.
- Şimdi senkronize et, Duraklat, Sürdür, Kaynağı sil — Kaynak işlemleri.
Sonuçları nasıl yorumlarsınız
Son senkron satırında "geçerli ürün" listede SKU'su olan satır sayısıdır; okunan satır sayısından belirgin biçimde azsa listenin bir kısmında stok kodu boştur. "değişiklik" önceki senkrondan bu yana fiyat ya da stoğu değişen ürünleri sayar; listede değişiklik yoksa 0 olması normaldir. "hata" sayısı mağazaya yazılamayan ürünleri gösterir; sürekli artıyorsa eklenti bağlantısını ve ürün tipini (değişkenli ürünler gibi) kontrol edin. "sonraki çalışmaya kaldı" sayısı tek çalışmada işlenemeyen değişikliklerdir ve bir sonraki çalışmada gönderilir. Kısmen durumu bazı ürünlerin yazıldığını, bazılarının hata verdiğini; Başarısız ise listenin okunamadığını ya da mağazanın hazır olmadığını gösterir ve başarısız senkron için bildirim gelir. Önizlemedeki Satış sütunu, kurallarınızın gerçek ürünlerde ne fiyat üreteceğini kayıttan önce görmenin yoludur.
Örnek senaryo
örnek.com WooCommerce üzerinde çalışan bir hırdavat mağazasıdır ve iki toptancıdan ürün almaktadır. Mağaza sahibi önce Hedef mağaza kartında mağazanın "hazır (eklenti 1.6.2)" göründüğünü doğrular. Birinci toptancının XML adresini "Toptancı A" adıyla 12 saatlik sıklıkla ekler, Önizle ile 2.300 satırın 2.296'sında SKU olduğunu görür.
Kuralları düzenle'de kâr marjını %35, KDV'yi %20 ve yuvarlamayı …,90 ile bitir olarak girer; en düşük fiyatı 25 TL yapar ve kartta örnek hesabı kontrol eder. Yeni ürünlerin önce incelenmesi için Mağazada olmayan ürünleri oluştur seçeneğini açar ve Yeni ürün durumu olarak Taslak seçer. İkinci toptancı aynı stok kodlarını kullandığı için onu "Toptancı B" adıyla ekler ve SKU ön eki olarak "TB-" yazar.
Şimdi senkronize et sonrası son senkron satırı 2.296 geçerli ürün, 2.296 değişiklik, 180 oluşturulan, 1.900 güncellenen, 16 hatalı ve 200 sonraki çalışmaya kalan ürün gösterir. Kalanlar 12 saat sonraki çalışmada gönderilir. Sahip taslak ürünleri inceleyip yayımlar; hatalı ürünlerin değişkenli ürün olduğunu fark eder ve onları elle günceller.
İpuçları
- İlk kurulumda Mağazada olmayan ürünleri oluştur açıkken Yeni ürün durumunu Taslak seçin; listeden gelen ad ve açıklamaları yayımlamadan önce gözden geçirirsiniz.
- Birden çok tedarikçi kullanacaksanız SKU ön ekini ilk senkrondan önce belirleyin; sonradan değiştirmek ürün eşleşmelerini bozar.
- Kuralları kaydetmeden önce Önizle penceresindeki Satış sütununu birkaç üründe kontrol edin; yuvarlama ve en düşük fiyat etkisi burada görünür.
- Yalnız stok takibi yapıyorsanız Yalnız stok güncelle seçeneğini açın; kendi belirlediğiniz fiyatlara dokunulmaz.
- Tedarikçi liste adresini değiştirdiğinde kaynağı silmek yerine yeni adresle ekleyip eskisini kaldırın; mağazadaki ürünler silinmez.
Sık yapılan hatalar
- Başka bir sitenin ürün sayfası adresini liste adresi olarak girmek; bot yalnız XML, CSV veya JSON listeleri okur ve kazıma yapmaz.
- SKU eşleşmesini kontrol etmeden senkron başlatmak; stok kodu olmayan ürünler aktarılmaz.
- KDV'yi hem tedarikçi fiyatında hem kurallarda eklemek; liste KDV dahilse KDV ekle (%) alanını boş bırakın.
- OpenCart ya da Shopify mağazası için kaynak eklemeye çalışmak; bu platformlar şu an yalnız yakında olarak listelenir.
Sık Karşılaşılan Sorunlar
- Hedef mağaza hazır değil: WordPress eklentisi bağlı değil ya da sürümü eski. Senkron yapılamaz.: Eklenti bağlı değil ya da 1.6.0'dan eski. Eklentiyi güncelleyip projeye bağlayın; Hedef mağaza kartında "hazır" yazdıktan sonra senkron yeniden çalışır.
- Liste okunamadı: geçerli bir XML, CSV ya da JSON değil.: Adres bir ürün listesi değil, örneğin giriş sayfası ya da hata sayfası döndürüyor olabilir. Adresi tarayıcıda açıp kontrol edin; gerekirse Biçim alanında listenin türünü elle seçin.
- Liste indirilemedi (403).: Tedarikçinin sunucusu isteği reddetti ya da adres süresi dolmuş olabilir. Tedarikçinizden güncel liste adresini isteyin; bazı tedarikçiler adrese anahtar ekler.
- Liste 20 MB'tan büyük; tedarikçinizden daha küçük bir liste ya da parçalı adres isteyin.: 20 MB'tan büyük listeler indirilmez. Tedarikçinizden kategori ya da marka bazlı ayrı adresler isteyip her birini ayrı kaynak olarak ekleyin; en çok 3 kaynak eklenebilir.
- Liste 5.000 satırdan uzun; ilk 5.000 satır işlenir.: Uzun listelerde yalnız ilk 5.000 satır işlenir ve kalan ürünler güncellenmez. Tedarikçinizden listeyi bölmesini isteyin.
- Ürünlerin bir kısmı "sonraki çalışmaya kaldı": Her çalışma sınırlı sayıda değişikliği işler; kalanlar bir sonraki çalışmada gönderilir. Şimdi senkronize et ile süreci hızlandırabilirsiniz.
- Aynı SKU iki tedarikçide var: Kurallardaki SKU ön eki alanına tedarikçiye özel bir ön ek (ör. ABC-) yazın; böylece iki tedarikçinin ürünleri birbirinin üstüne yazılmaz. Ön ek değiştiğinde mağazadaki eşleşme de değişir, bu yüzden en başta belirleyin.
- Kaynağı kullanmaya yetkili olduğunuzu onaylamanız gerekir.: Yetki onay kutusu işaretlenmeden kaynak eklenmez. Listeyi tedarikçiniz size verdiyse ya da kendi kaynağınızsa kutuyu işaretleyin; başka sitelerden kazınmış veri bu botla kullanılamaz.
İlgili Kılavuzlar
Bu adımları kendi sitenizde uygulayın
Önce ücretsiz site analiziyle sitenizdeki sorunları görün. Hesabınız varsa rehberde anlatılan sayfayı panelde açın.