WooCommerce — Cosmetic Wholesale

Cosmetic Wholesale Sync, resmi WooCommerce eklentimizdir. Kataloğu aktarır, stok ve fiyatı güncel tutar, ödemesi alınmış siparişleri bize gönderir ve kargo takip numaralarını geri yazar. Ücretsizdir.

Gereksinimler: WordPress 6.0+, WooCommerce 7.0+, PHP 7.4+.

1. Kurulum

Ya WordPress.org eklenti dizininden kurun (Cosmetic Wholesale Sync araması yapın) ya da zip dosyasını Plugins → Add New → Upload (Eklentiler → Yeni Ekle → Yükle) altından yükleyin.

Cosmetic Wholesale Sync WordPress.org'da — WordPress.org eklenti sayfası

Önce WooCommerce'i etkinleştirin — eklenti onsuz hiçbir şey yapmaz.

2. Yapılandırma

WooCommerce → Cosmetic Wholesale menüsünü açın ve şunları doldurun:

Ayar	Değer
Catalog feed URL	Account sayfanızdan alınır. URL içinde token olmadan yapıştırın.
Token	Aynı sayfadaki hesap token'ınız.
Margin %	Yüzde cinsinden satış marjınız.
Margin fixed	Üzerine eklenen sabit tutar, euro cinsinden.

WooCommerce eklenti ayarları — Feed URL, token ve marj

Satış fiyatı şöyle hesaplanır:

regular_price = round(cost × (1 + margin% / 100) + fixed, 2)

0 ve 0 değerleri ürünleri B2B maliyetimizden satar. Eski 360 eklentisinden geçiyorsanız, fiyatlarınız sıçramasın diye aynı iki sayıyı olduğu gibi taşıyın.

Ayarları kaydedin.

3. İlk aktarım

First import'u (ilk aktarım) çalıştırın. Henüz mevcut olmayan ürünleri, EAN'ı SKU olarak kullanarak oluşturur.

İlk aktarım devam ediyor — Büyük kataloglar (60k+) genelde birkaç saat sürer

Çalışırken tarayıcı sekmesini açık tutun veya komut satırından çalıştırın: wp cw-sync import
Duraklatılır veya kesilirse Continue kullanın (wp cw-sync import, --fresh olmadan). Start over kuyruğu feed’den yeniden oluşturur.
İlk aktarımda görseller indirilmez (katalog çok büyük). “Also run images after first import finishes” kutusunu işaretleyin veya sonra Images / wp cw-sync images çalıştırın. Yalnızca öne çıkan görseli olmayan ürünlere feed image_url eklenir.
Maliyet fiyatı veya başlığı olmayan ürünler atlanır ve ayrıca sayılır.

Yaklaşık 68.000 ürünlük tam katalog ilk çalışmada genellikle birkaç saat sürer. Sonraki saatlik güncellemeler çok daha hızlıdır.

4. Görseller

Katalog yerindeyken (veya yukarıdaki kutuyu işaretleyerek) Images çalıştırın. Feed image_url değerini henüz öne çıkan görseli olmayan ürünlere yazar. Yeni SKU oluşturmaz.

Görseller işi — İlk aktarımdan ayrı; Pause / Continue desteklenir

Ayarlar ekranındaki düğmeyi veya wp cw-sync images komutunu kullanın. Kesilen çalıştırmalar ilk aktarım gibi kaydedilen offset’ten Continue ile sürer.

5. Saatlik senkronizasyon

Saatlik senkronizasyonu etkin bırakın. Saatlik iş, hâlihazırda var olan SKU'ların stok ve fiyatını günceller. Asla ürün oluşturmaz ve feed isteği başarısız olursa kataloğunuzu silmez.

Saatlik senkron kontrolleri — Dry run ve son saatlik sonuç

Buna güvenmeden önce, updated > 0 görene kadar Dry run'ı (deneme çalıştırması) kullanın ve önceki kaynağınıza karşı on EAN'ı örnekleyerek kontrol edin.

Eski 360 eklentisinden geçiyorsanız: ikisini aynı SKU'lar üzerinde birlikte çalıştırmayın. Önce bir deneme çalıştırmasını sorunsuz tamamlayın, sonra 360 cron'unu kapatın. Bir şey ters görünürse, eski feed hâlâ geri dönebileceğiniz bir seçenek olarak duruyor.

6. Siparişler

Bir WooCommerce siparişi processing (hazırlanıyor) durumuna geçtiğinde (müşteri ödemeyi yapmıştır), eklenti Cosmetic Wholesale'e bir POST isteğini kuyruğa alır. Bu, ödeme adımında değil, arka planda gerçekleşir.

Cosmetic Wholesale'e sipariş gönderimi — Ödenen siparişler kuyruğa alınır; 402 = cüzdan HOLD

Gönderdikleriniz: kargo adresi ve her satırın EAN'ı ile adedi. Başka hiçbir şey.

Cüzdanınız boşsa, sipariş tarafımızca kabul edilir ve beklemeye alınır. WooCommerce siparişi processing durumunda kalır ve bakiye yükledikten sonra eklenti yaklaşık on dakikada bir tekrar dener. Müşterinin siparişi asla iptal edilmez.

Koli kargoya verildiğinde kargo takip numaraları WooCommerce siparişine geri yazılır; siparişi o zaman tamamlayabilirsiniz.

Sorun giderme

Ödemesi alınmış siparişler hiç ulaşmıyor. Sipariş gönderimi ve cüzdan tekrar denemesi WP-Cron üzerinde çalışır. DISABLE_WP_CRON tanımlıysa ve hiçbir sistem cron'u wp-cron.php adresini tetiklemiyorsa, siparişler kuyrukta sessizce bekler. Ayarlar ekranındaki Last order retry cron (UTC) (son sipariş tekrar deneme cron'u) alanını kontrol edin — güncel değilse sorun budur.

Aktarımdan sonra fiyatlar hatalı görünüyor. Margin % ve Margin fixed değerlerini kontrol edin. Formül, önceki satış fiyatınıza değil, bizim maliyet fiyatımıza uygulanır.

Bazı ürünler atlandı. Sayaçlar "maliyet yok" ile "başlık yok" durumlarını ayırır. İkisi de o EAN için feed satırının eksik olduğu anlamına gelir; bunlar genellikle hesabınıza açık olmayan ürünlerdir.

Herhangi bir yere OMS veya depo şifresi girmem gerekiyor mu? Hayır. Eklenti yalnızca Cosmetic Wholesale ile konuşur.

Kaldırma

Eklentiyi kaldırmak, aktardığınız ürünleri silmez. Kataloğunuz olduğu gibi kalır.