Keskintech Marketplaces WordPress Eklentisi Dokümantasyonu

Keskintech Marketplaces eklentisi ile WordPress WooCommerce mağazanızı birden fazla pazaryeriyle tek panel üzerinden kolayca entegre edebilirsiniz. Bu dokümanda; ürün aktarımı, kategori ve marka eşleştirme, stok ve fiyat güncellemeleri ile ürünlerin karşılıklı senkronizasyonu gibi tüm entegrasyon süreçlerini adım adım ve anlaşılır bir şekilde öğrenebilirsiniz.

Eklenti Kurulumu

Keskintech Marketplaces eklentisini kurmak için WordPress admin panelinize giriş yapın. Ardından Eklentiler → Yeni Ekle menüsüne gidin.

Sağ üst köşede bulunan arama alanına "Keskintech Marketplaces" yazarak eklentiyi bulun. Eklenti listede göründüğünde "Şimdi Kur" butonuna tıklayın ve kurulumun tamamlanmasını bekleyin.

Kurulum işlemi tamamlandıktan sonra "Etkinleştir" butonuna tıklayarak eklentiyi aktif hale getirin. Artık Keskintech Marketplaces eklentisi kullanıma hazırdır.

Eklenti Ayarları

Eklentiyi kurduktan sonra ilk adım olarak ayarları yapılandırmanız gerekir. Bunun için WordPress admin panelinde Pazaryerleri → Ayarlar menüsüne gidin.

Aktivasyon Kodu

Ürün işlemlerini API üzerinden gerçekleştirmek istiyorsanız geçerli bir lisansa sahip olmanız gerekir. Yalnızca CSV ve XLSX formatında manuel çıktı alacaksanız bu adımı atlayabilirsiniz.

Aktivasyon kodunun geçerli olabilmesi için:

  • En az bir lisansa sahip olmanız,
  • Lisansınıza bir site atamış olmanız gerekir.

Bunun için Profil panelinizde (Kontrol Paneli) yer alan Sitelerim menüsünden sitenizi ekleyebilirsiniz. Ardından Lisanslarım menüsünden eklediğiniz siteyi mevcut lisansınıza atayabilirsiniz.

Önemli: Bir siteyi lisansa atama işlemi geri alınamaz.

Aktivasyon kodunu almak için Profil → API Bilgileri sekmesine gidin. Buradan aktivasyon kodunuzu kopyalayarak ilgili alana yapıştırın.

Marka Ayarları

Eğer WooCommerce mağazanızdan pazaryerlerine ürün gönderimi yapacaksanız marka ayarlarını aktif hale getirmelisiniz.

Marka kaynağını iki farklı şekilde belirleyebilirsiniz:

  • Sabit Marka: Mağazanızdaki tüm ürünler aynı markaya sahipse bu seçeneği tercih edin ve marka adını ilgili alana girin.
  • Terim (Taksonomi): Marklarınızı WooCommerce veya farklı eklentiler ile yönetiyorsanız bu seçeneği kullanın. Bu durumda alt bölümde, yayında olan son ürününüze ait taksonomi bilgileri görüntülenir. Markayı temsil eden taksonomiyi Marka Taksonomisi alanına girmeniz gerekir.

Varsayılan "Stokta" Değeri

Bu ayar, stok yönetimi aktif olmayan ürünler için kullanılır. Pazaryerleri ürünlerin stok durumunu değil, stok adedini talep eder.

Eğer bir üründe stok yönetimi kapalıysa:

  • Stokta olarak işaretlenen ürünler için burada belirlediğiniz varsayılan stok adedi gönderilir.
  • Stokta yok olan ürünler ise otomatik olarak 0 stok ile iletilir.

Varsayılan Desi Değeri

Pazaryerlerine ürün gönderiminde, ürünlerin hacimsel ağırlık (desi) bilgisi zorunludur.

Eğer ürünlerinizde ağırlık ve boyut bilgileri tanımlıysa, sistem bu değerleri otomatik olarak hesaplar ve gönderir. Ancak bu bilgiler eksikse, burada belirlediğiniz varsayılan desi değeri kullanılır.

Bu ayar, ölçü bilgisi bulunmayan ürünlerin gönderim sürecinde referans alınan değer olarak kullanılır.

Pazaryeri Ekleme ve Düzenleme

WordPress admin panelinde Pazaryerleri menüsüne giderek mevcut pazaryerlerini listeleyebilirsiniz. Bu sayfa üzerinden pazaryeri ekleme, düzenleme ve silme işlemlerini kolayca gerçekleştirebilirsiniz.

Yeni bir pazaryeri eklemek için sayfanın sol üst kısmında bulunan "Yeni Ekle" butonuna tıklayın.

Genel Alan

  • İsim: Oluşturduğunuz pazaryerini tanımlamak için açıklayıcı bir ad girin.
  • Pazaryeri Tipi: Eklediğiniz pazaryerinin hangi entegrasyon türünde çalışacağını seçersiniz. Bu alanda yalnızca lisansınıza tanımlı pazaryerleri listelenir ve sahip olduğunuz lisansa göre seçim yapabilirsiniz.

API Bilgileri Alanı

Bu alana, ilgili pazaryerinden temin ettiğiniz API bilgilerini eksiksiz olarak girmeniz gerekmektedir. Doğru API bilgileri, entegrasyonun sorunsuz çalışması için kritik öneme sahiptir.

Pazaryeri Ayarları Alanı

Bu bölümde ilgili pazaryeri için temel ayarları yapılandırabilirsiniz:

  • Para birimi
  • Kargo firması
  • Varsayılan vergi oranı

Varsayılan Vergi Oranı:
Ürünlerin vergi oranını talep eden pazaryerleri için, tüm ürünlerde kullanılmak üzere varsayılan bir vergi değeri belirleyebilirsiniz.

Sipariş Çekme Ayarları Alanı

  • Siparişleri otomatik getir: Pazaryerinde oluşan siparişleri otomatik olarak sitenize aktarmak için bu seçeneği aktif hale getirin.
  • Tekrar Aralığı: Siparişlerin hangi sıklıkla kontrol edilip çekileceğini belirler.
  • Stoktan Düş: Pazaryerinden gelen siparişlerde yer alan ürünlerin stoklarının sitenizde otomatik olarak düşmesini sağlar.
  • İptalleri kontrol et: Pazaryerinde iptal edilen siparişlerin, sitenizde de "iptal edildi" durumuna güncellenmesini sağlar.
  • İadeleri kontrol et: Pazaryerinde iade edilen ve iadesi onaylanan siparişler sitenizde "iade edildi" olarak güncellenir. Reddedilen veya ihtilaflı iadeler bu kapsama dahil edilmez.

Fiyatlandırma

Fiyatlandırma menüsü sayesinde pazaryerlerine özel fiyatlar belirleyebilir veya otomatik fiyatlandırma kuralları oluşturabilirsiniz.

Sistem, pazaryerlerine gönderilecek ürün fiyatlarını belirlerken aşağıdaki öncelik sırasına göre çalışır:

  1. Ürün için özel bir fiyat tanımlandıysa, bu fiyat kullanılır.
  2. Pazaryeri için geçerli bir fiyatlandırma kuralı varsa, kurallar sonucunda hesaplanan fiyat baz alınır.
  3. Her ikisi de yoksa, WooCommerce mağazanızdaki ürün fiyatı kullanılır.

Bir ürün fiyatının hangi kaynağa göre belirlendiğini, fiyat alanının sol üstünde bulunan durum göstergesi (indikatör) üzerine gelerek görüntüleyebilirsiniz.

Fiyatlandırma ayarlarına ulaşmak için Pazaryerleri → Fiyatlandırma menüsüne gidin. Bu alanda fiyatları iki farklı yöntemle belirleyebilirsiniz:

Ürüne Göre Fiyatlandırma

Bu yöntemde, her ürün için pazaryerlerine özel fiyatları manuel olarak girebilirsiniz. Toplu işlem desteği sayesinde birden fazla ürünü aynı anda düzenleyebilirsiniz. Ayrıca varyasyonlu ürünler için de ayrı ayrı fiyat tanımlayabilirsiniz.

Fiyat belirlemek için:

  • Fiyatını düzenlemek istediğiniz ürünleri seçin
  • "Ürün Fiyatlarını Düzenle" butonuna tıklayın

Açılan ekranda Ürün Sabiti ve pazaryerlerine ait fiyat alanları sütunlar halinde listelenir.

Eğer birden fazla ürün seçtiyseniz, ürünlerin ilgili pazaryerinde ortak bir fiyatı varsa alanlar otomatik doldurulur; ortak fiyat yoksa alanlar boş gelir.

Uyarı: Bu ekranda yalnızca değişiklik yaptığınız alanlar güncellenir. Değişiklik yapmadığınız fiyatlar aynen korunur.

Ürün Sabiti

Ürün sabiti, ürün için belirlediğiniz özel bir referans değerdir. Bu alanı ürün maliyeti gibi kullanarak fiyatlandırma kuralları bölümünde bu değer üzerinden işlemler tanımlayabilir ve fiyat stratejinizi oluşturabilirsiniz.

Bir ürün için tanımladığınız özel fiyatı kaldırmak isterseniz ilgili ürünleri seçin, fiyat düzenleme ekranında alanları temizleyin ve kaydedin.

Fiyatlandırma Kuralları

Bu bölümde her pazaryeri için ayrı ayrı fiyatlandırma kuralları oluşturabilirsiniz. Tanımladığınız kurallar sayesinde ürün fiyatları otomatik olarak hesaplanır. Toplama, çıkarma, çarpma ve bölme işlemlerini istediğiniz sıraya göre tanımlayarak fiyatlandırmayı tamamen otomatik hale getirebilirsiniz.

Baz Alınan Değer

Fiyat hesaplamasının başlangıç noktasını belirler: Ürün site fiyatı veya Ürün sabiti. Ürün sabiti değerini Ürüne Göre Fiyatlandırma alanından belirleyebilirsiniz.

Fiyat Kuralları

Bu alanda yeni kurallar ekleyebilir, mevcut kuralları düzenleyebilir veya gereksiz kuralları silebilirsiniz. Tanımlanan işlemler belirlediğiniz sıraya göre uygulanır ve nihai fiyat bu işlemler sonucunda oluşur.

Yuvarlama

Hesaplanan fiyatı, belirlediğiniz yuvarlama tipi ve değerine göre düzenleyebilirsiniz. Örneğin; yuvarlama tipi Ondalık, değer 90 ise sonuç 324.452 iken yuvarlama sonrası 324.90 olur. Bu özellik sayesinde pazaryeri fiyatlarınızı daha stratejik ve düzenli hale getirebilirsiniz.

Vergi Ayarları

WooCommerce mağazanızdaki ürünleri API aracılığıyla pazaryerlerine göndermek istiyorsanız, bazı pazaryerleri ürünler için vergi oranı belirtmenizi zorunlu kılar. Eğer tüm ürünleriniz için tek bir vergi oranı kullanıyorsanız, bu bölümde ayar yapmak yerine pazaryeri ayarlarında yer alan varsayılan vergi oranı seçeneğini kullanmanız daha hızlı ve pratik olacaktır.

Detaylı vergi yönetimi için Pazaryerleri → Ayarlar → Vergi sekmesine gidin. Bu alanda vergi sınıflarını oluşturabilir, düzenleyebilir veya silebilirsiniz.

Yeni bir vergi sınıfı eklemek için sol üstte bulunan "Vergi Sınıfı Ekle" butonuna tıklayın.

Vergi Sınıfı Tanımlama

  • İsim: Vergi sınıfını tanımlayan açıklayıcı bir ad girin.
  • Alt bölümde, tanımlı pazaryerleriniz için ayrı ayrı vergi oranları belirleyebilirsiniz.

Ürünler İçin Vergi Oranı Belirleme

Ürün bazlı vergi ayarlarını yapmak için:

  • Ürün düzenleme sayfasında Genel sekmesine gidin ve ilgili ürün için vergi sınıfını seçin.
  • Varyasyonlu ürünlerde, varyasyonlar varsayılan olarak ana ürünün vergi sınıfını devralır.

Eğer bir varyasyon için farklı bir vergi oranı uygulamak isterseniz:

  • Varyasyonlar sekmesine gidin,
  • İlgili varyasyonu açın,
  • Üst kısımda yer alan Pazaryeri Vergisi alanından istediğiniz vergi sınıfını seçin.

Bu yapı sayesinde ürün ve varyasyon bazlı esnek vergi yönetimi sağlayabilirsiniz.

Ürün Gönderme

WooCommerce mağazanızda bulunan ürünleri pazaryerlerine API üzerinden hızlı ve pratik bir şekilde gönderebilirsiniz. Bu sürecin sorunsuz ilerlemesi için ürünlerinizi göndermeden önce bazı önemli adımları tamamlamanız gerekir.

Ürünleri Göndermeden Önce

1. Ürün Bilgileri

Gönderim öncesinde ürün bilgilerinin eksiksiz olması gerekir. Aşağıdaki alanların doğru şekilde doldurulduğundan emin olun: ürün başlığı, açıklama, kategori, nitelikler, stok bilgileri ve ürün görselleri.

Kategori: Seçilen kategorinin en alt seviye kategori (leaf kategori) olması zorunludur. Yani seçtiğiniz kategorinin altında başka bir alt kategori bulunmamalıdır. Ürünlerinizi mutlaka leaf (yaprak) kategorilere eklemelisiniz.

Stok Kodu (SKU): Tüm pazaryeri işlemleri stok kodu üzerinden yürütülür. Basit ürünlerde stok kodu doğrudan ürün için tanımlanmalıdır. Varyasyonlu ürünlerde ise her varyasyon için ayrı stok kodu bulunmalıdır. Varyasyonlu ürünlerde ana ürünün stok kodu, model kodu olarak değerlendirilir.

Ürün Görselleri:
Basit Ürünler: Öne çıkan görsel ilk resim olarak, galeri görselleri ise diğer resimler olarak gönderilir.
Varyasyonlu Ürünler: Ana görsel, varyasyon satırında sol üstte yer alan görseldir. Diğer görseller ise varyasyon satırının alt kısmındaki pazaryeri görselleri alanından alınır.

Nitelikler: Ürünlere detaylı nitelik eklemek arama sonuçlarında görünürlüğü artırır ve müşterilere daha fazla bilgi sunar. Bazı pazaryerleri belirli kategoriler için nitelikleri zorunlu tutar; zorunlu nitelikler eklenmeden yapılan gönderimlerin başarısız olacağını unutmayın.

Eşleştirme

Ürünlerinizi göndermeden önce; kategori, marka, nitelik ve nitelik terimlerini pazaryeri ile eşleştirmeniz gerekir. Bu işlem, sitenizdeki verilerin pazaryerindeki karşılık gelen alanlarla doğru şekilde ilişkilendirilmesini sağlar. Eşleştirme işlemleri için Pazaryerleri → Eşleştirme menüsüne gidin.

İpucu: Bir kategori ve ona bağlı nitelik/terimleri bir kez eşleştirdiğinizde, aynı yapıdaki diğer ürünler için tekrar eşleştirme yapmanız gerekmez. Eşleştirmeler kategori bazlı çalışır.

Kategori Eşleştirmesi: Kategoriler sekmesinde sitenizdeki leaf kategoriler listelenir. Eşleştirmek istediğiniz kategorinin yanındaki "Kategoriyi Eşleştir" bağlantısına tıklayın, açılan pazaryeri sütununda "Eşleştir" butonuna basın ve açılan pencerede karşılığını seçip kaydedin.

Marka Eşleştirmesi: Marka ayarlarına göre tespit edilen markalar listelenir. "Markayı Eşleştir" bağlantısına tıklayın ve ilgili pazaryeri sütununda "Eşleştir" butonuna basın. Bazı pazaryerlerinde marka adını aratabilir, bazılarında ise doğrudan metin olarak girebilirsiniz.

Nitelik ve Terim Eşleştirmesi: Terimler sekmesinde sitenizde tanımlı tüm nitelikler listelenir. Nitelik → Terim şeklinde iki aşamalı eşleştirme yapılır. Bir nitelik için birden fazla kural tanımlayabilir; böylece farklı kategoriler için farklı eşleştirmeler yapabilirsiniz. İlk oluşturulan kural varsayılan kural olarak tüm kategoriler için geçerli olur.

Ürün Gönderme Adımı

Ürün gönderimi için Pazaryerleri → Ürün Gönder menüsüne gidin. Gönderim yapmak istediğiniz pazaryerini seçin. Geçerli bir lisansınız varsa "Online Gönder" butonu görüntülenir.

Seçim Türü: Belirli bir kategorideki tüm ürünleri gönderebilir veya listeden seçtiğiniz ürünleri gönderebilirsiniz. Varyasyonlu ürünlerde tüm varyasyonları veya sadece belirli varyasyonları seçebilirsiniz. Gönderime uygun olmayan ürünlerde uyarı simgesi görüntülenir.

Gönderim Süreci: Ürün seçimlerinizi yapın, Devam/Gönder adımına ilerleyin ve "İşlemi Başlat" butonuna tıklayın. Sistem ürünleri gönderime hazırlar ve hatalı ürünleri tespit eder. Eğer bir ürün gönderilemezse hata detayları listelenir; gerekli düzeltmeleri yaparak işlemi tekrar başlatabilirsiniz.

Ürün Güncelleme

Pazaryerlerine gönderdiğiniz ürünlerin fiyat, stok ve diğer bilgilerini toplu veya seçili olarak güncellemek için Pazaryerleri → Ürün Güncelle menüsüne gidin.

Güncelleme yapmak istediğiniz pazaryerini seçin. Geçerli bir lisansınız varsa "Online Gönder" butonu görüntülenir. Açılan sayfada güncellenecek alanları (fiyat, stok vb.) seçin ve ürünleri kategori veya ürün bazında belirleyin. Varyasyonlu ürünler de desteklenmektedir.

Not: Pazaryerlerinin güncelleme kuralları farklılık gösterebilir. Bazıları tek istekte birden fazla alan güncellemesine izin verirken bazıları ayrı ayrı istekler gerektirir. Sistem bu tür durumlarda sizi uyarır.

Tüm seçimlerinizi tamamladıktan sonra "İşlemi Başlat" butonuna tıklayarak güncelleme isteğini gönderin. İşlem tamamlandığında bu işlemi otomatikleştirme seçeneği sunulur: göreve bir isim verin, tekrar aralığını belirleyin ve kaydedin.

Zamanlanmış Görevler

Oluşturduğunuz görevleri yönetmek için Pazaryerleri → Zamanlanmış Görevler menüsüne gidin. Bu sayfada ürün güncelleme ve sipariş çekme gibi tüm zamanlanmış görevlerinizi liste halinde görüntüleyebilirsiniz.

Bir görevi düzenlemek için "Düzenle" bağlantısına tıklayın. Üst bölümdeki toggle ile görevi duraklatabilir veya aktif hale getirebilirsiniz. "Başlat" butonu ile görevi anında çalıştırabilir, "Sil" butonu ile tamamen kaldırabilirsiniz.

Günlükler

Eklenti üzerinden gerçekleştirilen tüm işlemleri görüntülemek için Pazaryerleri → Günlükler → İşlemler sekmesine gidin. Bu alanda gönderdiğiniz tüm istekler, işlem durumları ve pazaryerlerinden dönen yanıtlar liste halinde sunulur.

Gönderilen istekler genellikle 1 ila 5 dakika içerisinde tamamlanır. İşlem durumu "Yanıt bekleniyor" olarak görünüyorsa kısa bir süre sonra tekrar kontrol edin; işlem tamamlandığında durum otomatik olarak güncellenir.

Bir işlemin detaylarını incelemek için ilgili kayda tıklayın ve "Cevap" sekmesine gidin. Başarısız kayıtların üzerine tıklayarak hata detaylarını görüntüleyebilir ve gerekli düzeltmeleri yapabilirsiniz.