Shopify için Cosmetic Wholesale Sync kataloğu aktarır, stok ve fiyatı güncel tutar ve ödemesi alınmış siparişleri dropship fulfilment için Cosmetic Wholesale'a gönderir.
1. Kurulum
Cosmetic Wholesale Sync uygulamasını Shopify App Store'dan kurun (veya Unlisted / önizleme derlemesi için gönderdiğimiz kurulum bağlantısını kullanın). yourshop.myshopify.com mağazanız için açın ve istenen izinleri onaylayın.
Uygulama ardından Shopify yönetim panelinizde Apps (Uygulamalar) altında görünür.
2. Yapılandırma
Uygulamayı açın ve şunları doldurun:
| Ayar | Değer |
|---|---|
| Token | Cosmetic Wholesale hesap token'ınız. Kaydedildikten sonra bir daha gösterilmez — değiştirmek için yenisini yapıştırın. |
| Margin % | Yüzde cinsinden satış marjınız. |
| Margin fixed | Üzerine eklenen sabit tutar, euro cinsinden. |
Katalog feed host'u sunucu tarafında sabittir. Uygulamada Feed URL alanı yoktur.

Satış fiyatı şöyle hesaplanır:
price = round(cost × (1 + margin% / 100) + fixed, 2)
0 ve 0 değerleri ürünleri B2B maliyetimizden satar.
Saatlik güncellemeyi etkin bırakın.
İsteğe bağlı: Import only these brands — satır başına bir marka (feed brand ile birebir, büyük/küçük harf duyarsız). Boş bırakırsanız tüm katalog gelir. First import öncesi Save edin.
3. İlk aktarım
First import'u (ilk aktarım) çalıştırın. Henüz mevcut olmayan ürünleri oluşturur ve EAN'ı her varyantın hem SKU hem de barkod alanına yazar. Feed brand / category Shopify Vendor / Product type alanlarına yazılır.

Bu önemlidir: sipariş satırları SKU üzerinden eşleştirilir, dolayısıyla SKU'su EAN olmayan bir ürün, sipariş bize geri gönderildiğinde tanınmayacaktır.
Görseller ilk aktarımın parçası değildir. Kataloğun kendisi yerine oturduktan sonra başlatabileceğiniz ayrı bir images (görseller) işi vardır.
İlerleme sayaçları (oluşturulan, güncellenen, atlanan, başarısız) iş çalışırken güncellenir. Devam eden bir aktarımı iptal edip yeniden başlatabilirsiniz — ürünleri çoğaltmaz, kaldığı yerden devam eder.
58.000+ ürünlük tam katalog ilk çalışmada genellikle birkaç saat sürer. Sonraki saatlik güncellemeler çok daha hızlıdır. Shopify geliştirme mağazaları çoğu zaman ~50 ürünle sınırlıdır.
4. Mağazanızda yayına alma
Aktarılan ürünler Online Store'unuzda (online mağazanızda) otomatik olarak görünmez. Aktarılan SKU'ları satış kanalınızda kullanılabilir yapmak için uygulamadaki Publish'i (yayımla) kullanın.

5. Saatlik senkronizasyon
Saatlik iş, hâlihazırda var olan ürünlerin stok ve fiyatını günceller. Asla ürün oluşturmaz ve bir feed isteği başarısız olduğunda kataloğunuzu boşaltmaz.

6. Görseller
Katalog yerine oturduktan sonra Images işini ayrı çalıştırın. Feed'deki image_url değerlerini mevcut ürünlere yazar; yeni SKU oluşturmaz.

7. Siparişler
Bir siparişin ödemesi alındığında Shopify orders/paid webhook'unu gönderir ve uygulama siparişi Cosmetic Wholesale hesabınıza aktarır: kargo adresi, ayrıca satır başına EAN ve adet.
Yalnızca uygulamanın SKU haritasındaki Cosmetic Wholesale EAN satırları gönderilir. Aynı sepetteki başka tedarikçi (ör. giyim) satırları atılır; böylece bilinmeyen SKU tüm push’u düşürmez. Kargo takibi yazılırken de yalnızca CW satırları fulfill edilir; diğer satırlar kendi uygulamasına kalır.
Karışık sepet (kozmetik + giyim / başka tedarikçi)
Varsayılan mağaza kurulumu olarak önerilmez. Aynı Shopify checkout’ta iki tedarikçi, ancak her uygulama kendi satırlarını filtreliyorsa çalışır (bu uygulama SkuMap ile yapar). Ara yazılım / satır filtresi yoksa karışık sepet başarısız olur veya tracking karışır. İkisini satıyorsanız ayrı checkout veya net müşteri ayrımı tercih edin.
Cüzdanınız boşsa, siparişi kabul eder ve beklemeye alırız. Uygulama tekrar dener; Shopify siparişi olduğu gibi kalır. İptal etmeyin — iptal etmek yalnızca mutabakatı bozar, sipariş bizim tarafımızda zaten rezerve edilmiştir.
Sorun giderme
Uygulama ekranı boş. Uygulama URL'ini doğrudan açmak yerine sayfayı Shopify yönetim panelinden yeniden yükleyin. Boş kalmaya devam ederse bize bildirin — bu genellikle sizin tarafınızda değil, bizim tarafımızdaki bir oturum sorunudur.
Sipariş satırları tanınmıyor. Varyant SKU'sunun EAN olduğundan emin olun. Elle oluşturduğunuz veya başka bir kaynaktan aktardığınız ürünler eşleşmeyecektir.
Ürünler aktarıldı ama kimse göremiyor. Publish'i çalıştırın (adım 4).
Stok güncellenmiyor. Saatlik güncellemenin etkin olduğunu ve hesap token'ınızın hâlâ geçerli olduğunu kontrol edin — iptal edilmiş bir token hem kataloğu hem siparişleri durdurur.
