WooCommerce entegrasyonu

WooCommerce entegrasyonu, WooCommerce çevrimiçi mağazanızı Gem Logic’e bağlamanıza olanak tanır. Bağlandıktan sonra Gem Logic’ten WooCommerce mağazanıza ürünleri gönderebilir ve WooCommerce’ten Gem Logic’e siparişleri çekebilirsiniz. Bu, ürün kataloğunuzu ve sipariş yönetiminizi her iki platformda da senkronize tutar.

Konfigürasyon

WooCommerce’te API anahtarları oluşturma

WooCommerce’i Gem Logic’e bağlamadan önce WooCommerce mağazanızda API anahtarları oluşturmanız gerekir.

  1. WordPress yönetici panelinize giriş yapın.

  2. WooCommerce ‣ Ayarlar ‣ Gelişmiş ‣ REST API yolunu izleyin.

  3. Anahtar ekle’ye tıklayın.

  4. Detayları doldurun:

    • Açıklama: bu anahtarı tanımlamak için bir ad girin (örn. Gem Logic Entegrasyonu).

    • Kullanıcı: API bağlantısı için kullanılacak WordPress kullanıcısını seçin.

    • İzinler: Okuma/Yazma’yı seçin. Bu, Gem Logic’in hem siparişleri okuyabilmesi hem de mağazanızda ürünleri oluşturabilmesi/güncelleyebilmesi için gereklidir.

  5. API anahtarı oluştur’a tıklayın.

  6. Consumer key ve Consumer secret değerlerini kopyalayın. Bunlar yalnızca bir kez gösterilir, bu yüzden güvenli bir yere kaydettiğinizden emin olun.

Önemli

Consumer secret yalnızca bir kez görüntülenir. Kaybederseniz, anahtarı iptal edip yeni bir tane oluşturmanız gerekecektir.

WooCommerce’i Gem Logic’e bağlama

  1. Gem Logic’te Configuration ‣ Sales channels bölümüne gidin.

  2. WooCommerce’e bağlamak istediğiniz satış kanalını açın veya yeni bir kanal oluşturun.

  3. WooCommerce kutusunu işaretleyin.

  4. Aşağıdaki alanları doldurun:

    • URL: WooCommerce mağazanızın tam URL adresi (örn. https://www.magazaniz.com). Sonuna eğik çizgi eklemeyin.

    • WooCommerce Key: daha önce oluşturduğunuz Consumer key anahtarını yapıştırın.

    • WooCommerce Secret: daha önce oluşturduğunuz Consumer secret anahtarını yapıştırın.

  5. WooCommerce mağazanızda Perfect WooCommerce Brands eklentisini kullanıyorsanız WooCommerce brands plugin kutusunu işaretleyin. Bu, Gem Logic’in ürün markalarını WooCommerce ile senkronize etmesini sağlar.

  6. Satış kanalını kaydedin.

Tüyo

WooCommerce mağazanızın HTTPS kullandığından emin olun. API kimlik bilgileri şifrelenerek Gem Logic’te güvenli bir şekilde saklanır.

Ürünleri satış kanalına atama

Ürünlerin WooCommerce’e gönderilmesi için WooCommerce satış kanalına atanmış olmaları gerekir.

  1. Products bölümüne gidin.

  2. Bir ürünü açın ve sales channels bölümüne gidin.

  3. WooCommerce satış kanalını ürüne ekleyin.

  4. Ürünün bu satış kanalı için yapılandırılmış bir pricing rule kuralına sahip olduğundan emin olun; böylece WooCommerce’e gönderildiğinde bir fiyatı olur.

Ürün gönderme

Gem Logic’ten WooCommerce mağazanıza ürün gönderebilirsiniz. Bu işlem, Gem Logic’teki verilere dayanarak WooCommerce’te ürünler oluşturur veya günceller.

Tek bir ürün gönderme

Tek bir ürün göndermek için Gem Logic’te ürünü açın ve ürünün satış kanalları bölümünden gönderme eylemini kullanın. Ürün henüz mevcut değilse WooCommerce’te oluşturulur; zaten bir WooCommerce kimliği varsa güncellenir.

Tüm ürünleri gönderme

Bir WooCommerce satış kanalına atanmış tüm ürünleri aynı anda göndermek için:

  1. Configuration ‣ Sales channels bölümüne gidin.

  2. WooCommerce satış kanalını açın.

  3. Push all products to WooCommerce düğmesine tıklayın.

Bu işlem arka plan görevi olarak çalışır. İlerlemeyi push history sayfasından takip edebilirsiniz.

Neler gönderilir

Bir ürün WooCommerce’e gönderildiğinde aşağıdaki veriler senkronize edilir:

  • SKU (iki sistem arasında ürünleri eşleştirmek için kullanılır)

  • İsim ve açıklama (satış kanalının diline göre)

  • Normal fiyat ve indirimli fiyat (bu satış kanalı için fiyatlandırma kuralından)

  • Görseller (yalnızca değişiklik olduğunda yeniden yüklenir)

  • Kategoriler ve koleksiyonlar (WooCommerce’te mevcut değilse oluşturulur)

  • Özellikler (global WooCommerce özellikleri olarak oluşturulur)

  • Etiketler

  • Stok miktarı

  • Markalar (WooCommerce brands eklentisi etkinse)

  • Ürün türü: basit veya değişken (varyantlarla birlikte)

Değişken ürünler ve varyantlar

Gem Logic’te bir ürün ana ürün olarak işaretlenmişse, WooCommerce’te değişken bir ürün olarak gönderilir. Tüm alt ürünleri (varyantları) ürün varyasyonları olarak gönderilir. Her varyant kendi fiyatını, SKU’sunu, görselini ve özellik değerlerini (örneğin beden, renk) içerir.

Ürün devre dışı bırakma

Gem Logic’ten bir ürünü WooCommerce’te devre dışı bırakabilirsiniz. Bu işlem ürün durumunu WooCommerce’te taslak olarak ayarlayarak ürünü silmeden mağaza vitrininde görünmez hale getirir.

Gönderim geçmişi

Her gönderim işlemi kaydedilir. Gönderim geçmişini satış kanalı detay sayfasından görüntüleyebilirsiniz. Her geçmiş kaydı şunları gösterir:

  • Başlangıç ve bitiş zamanı

  • Durum (başlatıldı, tamamlandı, başarısız veya kısmi başarı)

  • Toplam ürün, başarılı ve başarısız sayıları

  • Başarı oranı ve süre

  • Ürün bazında detaylı sonuçlar (hangi ürünlerin başarılı veya başarısız olduğunu görmek için Detayları görüntüle’ye tıklayın)

Ürünleri çekme

WooCommerce mağazanızdan Gem Logic’e ürünleri çekebilirsiniz. Bu özellikle mağazanızı ilk kez bağladığınızda başlangıç aktarımı için kullanışlıdır.

  1. Configuration ‣ Sales channels bölümüne gidin.

  2. WooCommerce satış kanalını açın.

  3. WooCommerce’ten ürünleri çek’e tıklayın.

Bu işlem arka planda çalışır ve her ürün için aşağıdaki verileri içe aktarır:

  • SKU, ad ve açıklama

  • Normal fiyat ve indirimli fiyat

  • Kategoriler ve markalar

  • Görseller (indirilir ve Gem Logic’te saklanır)

  • Etiketler

  • Stok miktarları

  • Özellikler ve metaller

  • Ürün varyantları (değişken ürünler için)

Not

Gem Logic’te halihazırda mevcut olan ürünler (WooCommerce ID veya SKU ile eşleşen) içe aktarma sırasında atlanır. Yalnızca yeni ürünler oluşturulur.

Siparişleri çekme

Tamamlanan siparişleri WooCommerce’ten Gem Logic’e çekebilirsiniz.

Siparişleri manuel olarak çekin

  1. Configuration ‣ Sales channels bölümüne gidin.

  2. WooCommerce satış kanalını açın.

  3. WooCommerce’ten siparişleri çek seçeneğine tıklayın.

Bu işlem arka plan görevi olarak çalışır. Çekim geçmişi sayfasına yönlendirileceksiniz ve burada ilerlemeyi gerçek zamanlı olarak takip edebilirsiniz.

Otomatik sipariş çekimi

Siparişler, arka plan görev sistemi kullanılarak bir programa göre otomatik olarak da çekilebilir. Bu, yeni tamamlanan siparişlerin manuel işlem gerektirmeden düzenli olarak içe aktarılmasını sağlar.

Neler içe aktarılır

Siparişler WooCommerce’ten çekildiğinde aşağıdaki veriler içe aktarılır:

  • Sipariş anahtarı (benzersiz sipariş tanımlayıcısı olarak kullanılır)

  • Müşteri iletişim bilgileri (ad, adres, e-posta, telefon) — CRM’de bir iletişim kişisi oluşturulur veya güncellenir

  • Sipariş tarihi ve para birimi

  • Satır kalemleri: her sipariş satırı ürünü (WooCommerce kimliği veya SKU ile eşleştirilir), miktarı, fiyatları (KDV hariç ve KDV dahil) ve KDV oranını içerir

  • Stok düşümü: her sipariş satır kalemi için stok otomatik olarak düşülür

Not

Yalnızca tamamlandı durumundaki siparişler içe aktarılır. Diğer durumlardaki siparişler (örneğin işleniyor, beklemede, askıda) atlanır.

Not

Daha önce içe aktarılmış siparişler (sipariş anahtarıyla eşleştirilerek) tekrarları önlemek için atlanır.

Çekim geçmişi

Her çekim işlemi kaydedilir. Çekim geçmişini satış kanalı detay sayfasından görüntüleyebilirsiniz. Her geçmiş kaydı şunları gösterir:

  • Başlangıç ve bitiş zamanı

  • Durum (başlatıldı, tamamlandı, başarısız veya kısmi başarı)

  • İşlenen toplam sipariş sayısı, oluşturulan yeni sipariş, atlanan ve başarısız olan sayılar

  • Süre ve varsa hata mesajları