WooCommerce (kendi siteniz) bağlama

WooCommerce sitenizi bağlamak için WordPress yönetim panelinden bir API anahtar çifti üretmeniz gerekir.

Anahtar üretme

1. WordPress paneli > WooCommerce > Ayarlar > Gelişmiş > REST API.
2. Anahtar ekle deyin.
3. Açıklama yazın (örn. "Senkronia"), kullanıcı olarak yönetici bir hesap seçin ve izni Okuma/Yazma yapın.
4. Üretilen Consumer key (ck_…) ve Consumer secret (cs_…) değerlerini kopyalayın. Bu değerler bir daha gösterilmez.

Panelde Entegrasyonlar > WooCommerce > Bağla deyip mağaza adresinizi (https ile) ve iki anahtarı girin.

Bağlamadan önce: SKU'larınızı doldurun

WooCommerce ürünlerinde barkod alanı yoktur ve pek çok mağazada SKU (stok kodu) boş bırakılır. Panel, aynı ürünün pazaryerindeki karşılığını eşleştirirken önce koda bakar. SKU boşsa eşleştirme ada göre tahmin edilmek zorunda kalır.

En sağlıklı kurulum: WooCommerce'teki SKU alanına, pazaryerinde kullandığınız stok kodunun aynısını yazın. Böylece ürünler kendiliğinden ve doğru şekilde eşleşir.

Kategorileri mağazayla eşitleme

Kanal > Yönet ekranındaki "Kategorileri mağazayla eşitle" düğmesi, mağazanızdaki kategori düzenini alt kategoriler dahil panele kurar:

• Paneldeki aynı adlı kategoriler doğru üst kategorinin altına taşınır (kopyalanmaz, ürün atamaları bozulmaz), eksik kategoriler açılır.
• Ürünler mağazadaki en alt (en özel) kategorisine alınır. Bir ürüne panelde elle farklı bir kategori seçtiyseniz ona dokunulmaz — yalnız üst kategoriden alt kategoriye daraltma yapılır.
• Mağazanızda hiçbir şey değişmez; bu tek yönlü bir okumadır. İşlem bittiğinde bildirim alırsınız.

Yeni bağlanan kanalda buna genelde gerek yoktur — içe aktarım kategori ağacını zaten hiyerarşiyle kurar. Bu düğme, kanalı daha önce bağlamış ve kategorileri düz kalmış mağazalar içindir.

Durum eşlemesi

Kanal > Yönet ekranında iki yönlü eşleme yapılır.

Mağaza durumu → panel durumu (siparişler panele nasıl düşsün). WooCommerce'te eklentiler kendi durumlarını ekleyebilir: "Kargoya Verildi", "Paketleniyor" gibi. Panel bunları tanımazsa sipariş "Yeni" olarak düşer — yani kargoya verdiğiniz bir sipariş panelde bekliyormuş gibi görünür ve stoğunuzu boşuna rezervde tutar.

• "Mağazadan durumları getir" düğmesine basın: mağazanızdaki bütün durumlar adıyla ve sipariş sayısıyla listelenir, her birinin şu an hangi panel durumuna alındığını görürsünüz.
• Panel, adından anlaşılan durumları (içinde "kargo", "teslim", "iptal" geçenler) kendiliğinden eşler. Emin olamadıklarını "TANINMIYOR" diye işaretler ve size bildirim gönderir — o satırlarda doğru karşılığı listeden seçin.
• İade süreçleri bilerek tahmin edilmez: "iade talebi alındı" ile "iade tamamlandı" aynı kelimeyi taşır, yanlış tahmin stoğunuza olmayan malı ekler. Bunları siz seçersiniz.

Eşlemeyi değiştirdiğinizde geçmiş siparişler eski durumlarında kalır. Aynı ekrandaki "Geçmiş sipariş durumlarını tazele" düğmesi son 30 günün siparişlerini mağazanızdan yeniden okur ve panelde günceller (mağazanızdaki hiçbir bilgi değişmez). Kanal bağlanırken çekilen geçmiş siparişlerde stoğunuz düşürülmez; yanlış tutulan rezervler serbest bırakılır.

Panelden mağazaya (panelde durum değişince mağazada ne yazsın). Genelde dokunmanıza gerek yoktur: yukarıda eşlediğiniz durumlar bu yönde de kullanılır — mağazanızın "Kargoya Verildi" durumunu bir kez tanıttıysanız, panelde siparişi kargoya verdiğinizde mağazaya o durum yazılır. Farklı bir durum yazılmasını istiyorsanız aynı karttan seçebilir ya da "elle yaz" ile kodu kendiniz girebilirsiniz. Hiç dokunulmazsa varsayılan geçerlidir (hem "Kargoda" hem "Teslim edildi" → completed).

Ödeme bekleyen siparişler

Mağazanız, ödemesi tamamlanmayan siparişi bir süre bekletip (çoğu kurulumda 60 dakika) kendisi iptal eder. Bu siparişler varsayılan olarak panele alınmaz — alınsaydı hayalet sipariş olarak görünür, stok boşuna rezerve edilir ve müşteriye "siparişiniz alındı" bildirimi gidebilirdi.

• Havale/EFT bekleyen siparişler ("Beklemede" durumu) bu ayardan bağımsız olarak alınır; onlar sizin bilerek beklettiğiniz gerçek siparişlerdir.
• Ödeme bekleyenleri de görmek istiyorsanız: Kanal > Yönet > "Ödeme bekleyen siparişleri de al".
• Sipariş ödemesi tamamlandığı anda zaten normal şekilde panele düşer.

Fatura bilgileri (TC kimlik / vergi no) nasıl gelir?

WooCommerce'in kendisinde TC kimlik, vergi no ve vergi dairesi alanı yoktur; mağazalar bu alanları ödeme adımına eklentiyle ekler ve bilgiler siparişin meta alanlarında saklanır.

Senkronia bu alanları kendiliğinden tanır: anahtar adında "vergi no", "tc kimlik", "vergi dairesi", "firma unvanı", "tax number" gibi ifadeler geçen meta alanları okunur ve siparişin fatura bilgisine + müşteri kartına yazılır. e-Fatura keserken alıcı VKN/TCKN, unvan ve vergi dairesi kutuları hazır gelir.

Firma unvanı doluysa faturada alıcı olarak isim-soyisim yerine unvan kullanılır; boşsa isim-soyisim devam eder. Vergi no / TC kimlik boşsa fatura bireysel e-Arşiv olarak (11 haneli "1" kimliğiyle) kesilir; vergi dairesi boşsa boş kalır — ikisi de fatura kesimini engellemez.

Hangi alanın eşleştiğini görmek ya da düzeltmek için: Kanal > Yönet > Fatura alanı eşleme bölümünde Mağazadan alanları getir deyin. Son siparişlerinizdeki gerçek alan adları örnek değerleriyle listelenir; otomatik tanımanın hangi alanla eşleştiği her kutunun altında yazar. Eşleşme hatalıysa doğru alanı listeden seçip kaydedin — seçiminiz otomatik tanımayı ezer, boş bırakırsanız otomatik tanıma sürer.

Eklentiniz TC kimlik ile vergi numarasını tek kutuda soruyorsa sorun olmaz: değerin hane sayısına bakılır (10 hane = vergi no, 11 hane = TC kimlik), fatura doğru şemayla kesilir. TC kimlik ve vergi no için aynı alanı seçebilirsiniz.

Şarta bağlı alanlar: bazı eklentiler bir alanı yalnız belli seçimde doldurur — örneğin "Kurumsal Fatura" seçilince ortaya çıkan vergi dairesi. Liste son 100 siparişe bakar; alan o siparişlerin hiçbirinde geçmiyorsa listede görünmeyebilir. Bu durumda "Alan listede yok mu? Elle yazın" bağlantısıyla anahtarı kendiniz yazın (ör. billing_vergi_dairesi) — alan dolu geldiği ilk siparişte çalışmaya başlar.

Gelen vergi bilgisi sipariş detayındaki Müşteri kartında "Fatura bilgileri" başlığıyla görünür — neyin eşleştiğini oradan da kontrol edebilirsiniz.

"e-Fatura mükellefi misiniz?" ya da "bireysel/kurumsal" gibi seçim alanlarının bağlanması gerekmez: mükellefiyet zaten fatura kesilirken entegratörünüzden sorgulanır.

Durum değişiklikleri de gelir

Panel, siparişleri son değişiklik tarihine göre tarar. Yani mağazada bir siparişin durumu sonradan değişirse (iptal, iade, kargoya verildi) bu değişiklik panele de yansır ve iptal edilen siparişin stoğu serbest kalır.

KDV davranışı

Mağazanızı bağlarken varsayılan KDV oranı sorulur ve zorunludur. Mağazanız vergi hesaplıyorsa oran zaten mağazanızdan okunur; hesaplamıyorsa çekilen ürünlere bu oran uygulanır. Eskiden sorulmuyor, sessizce %20 uygulanıyordu — ürünler geldikten sonra tek tek düzeltmek gerekiyordu. Sonradan Kanal > Yönet ekranından değiştirebilirsiniz.

Panelde tüm fiyatlar KDV dahildir. WooCommerce'te vergi açık ve fiyatlar KDV hariç girilmişse panel, çekerken KDV ekler ve gönderirken KDV'yi ayırır — çifte KDV oluşmaz. Mağazanızda vergi kapalıysa sipariş satırındaki oran %0 sayılmaz, ürün kartındaki KDV oranınız kullanılır.

Mağazanızda vergi kapalıysa ürün çekerken okunacak bir oran yoktur. Bu durumda kanalın Yönet ekranındaki "Bu mağazanın KDV oranı" alanı, o da boşsa firma varsayılanınız (Ayarlar) uygulanır ve ürünler "KDV oranı doğrulanmadı" işaretlenir. Farklı oranlı ürünlerinizi Ürünler ekranındaki uyarıdan toplu düzeltebilirsiniz.

Normal ve indirimli fiyat ayrı gelir

WooCommerce'teki normal fiyat panelde o kanalın satış fiyatı, indirimli fiyat ise indirimli fiyatı olarak saklanır; gönderimde ikisi de aynen korunur. Mağazadaki indirimi panel silmez. Bkz. Kanal bazlı fiyat.

Daha önce eşleşmiş ama panelde fiyatı boş kalmış ürünler için Yönet > "Kanal bilgilerini panele çek" düğmesini kullanın — mağazadaki ad, açıklama ve iki fiyat panele indirilir, mağazada hiçbir şey değişmez.

Stok takibi yapmayan mağazalar

Sitenizde stok takibi yapmıyorsanız (her zaman "stokta" görünsün istiyorsanız) kanalın Yönet ekranındaki "Bu mağaza stok takibi yapmıyor" kutusunu işaretleyin. Aksi hâlde pazaryerinden gelen bir satış panelin stoğunu düşürür ve sitenizde ürün "tükendi" görünebilir.

Varyasyonlu üründe stok "ana üründen" yönetiliyorsa

WooCommerce'te varyasyonlu bir üründe stok iki yerden yönetilebilir: ana üründen (Ürün verisi > Envanter > Stok yönetimi) ya da her varyasyondan ayrı ayrı.

Panel stoğu varyasyona yazar. Ana üründe stok yönetimi açıksa WooCommerce varyasyon adedini yok sayar ve ürünün satılabilirliğini ana üründeki adede göre belirler. Ana üründe adet 0 ise, panel varyasyona kaç yazarsa yazsın ürün sitede satılamaz — üstelik gönderim başarılı görünür.

Panel bunu artık kendisi fark eder: gece mutabakatı bu ürünlere boşuna stok göndermez, bunun yerine size "stok ana üründen yönetiliyor" uyarısı düşürür. Kalıcı çözüm: ürünlerinizde stok yönetimini varyasyon seviyesinde kullanın (ana üründeki "Stok yönetimi" kutusunu kapatıp her varyasyonda açın). Ara çözüm olarak ana ürünün adedini sıfırdan farklı bir değere çekebilirsiniz, ama o zaman da gerçek adet varyasyonlarda takip edilmez.

Kategori, ad ve açıklama mağazaya nasıl gider?

Ürün kartında seçtiğiniz kategori, Entegrasyonlar > WooCommerce > Kategori eşle ekranında mağazadaki bir kategoriye eşliyse mağazaya o kategori yazılır — yeni ürün açılırken de, mevcut ürünün kategorisi/adı/açıklaması değiştirilip kaydedilince de (değişiklik kendiliğinden kanala gider, "kanala gönder" demeniz gerekmez). Eşleme yoksa kategori alanı gönderilmez, mağazadaki mevcut kategori korunur. Fiyat ve stok bu güncellemeden etkilenmez. Basit ürünü panelde varyasyonluya çevirdiğinizde de mağazadaki ana ürün aynı kategoride kalır/eşlenir.

Ürünü bir kategoriden başkasına aldığınızda (ör. Avokado → Paketler) mağazada ürün yeni kategoriye eklenir ve eski kategoriden çıkarılır — eski kategorinin kendisi ve içindeki diğer ürünler olduğu gibi kalır. Mağazada ürün birden çok kategoride duruyorsa (ör. Tüm Ürünler, Kampanyalar) panelin bilmediği o kategorilere dokunulmaz; panel yalnız kendi eski ve yeni kategorisini yönetir. İki koşul var: eski ve yeni kategorinin ikisi de Kategori eşle ekranında eşlenmiş olmalı; yeni kategori eşli değilse ürün mağazada eski kategorisinde bırakılır (kategorisiz kalmasın diye); eşlemeyi yaptıktan sonra ürünü listeden Kanala gönder ile gönderdiğinizde taşınır.

Sık karşılaşılanlar

Ürünler geldi ama görseller gelmedi. İçe aktarma görselleri de indirir, ancak panelde zaten görseli olan ürüne dokunmaz. Görselsiz ürünler için içe aktarmayı bir kez daha çalıştırın. Mağazadaki galeride aynı fotoğrafın birden çok kopyası varsa panel bunları tek görsel olarak alır.

Mağazanın medya kitaplığında aynı resimden çok sayıda kopya var. Panel bir görseli mağazaya yalnız bir kez yükler; sonraki gönderimlerde mağazadaki mevcut dosyayı kullanır ve galeri zaten doğruysa hiç yazmaz. Daha önce oluşmuş kopyalar mağazanızda kalır — bunlar ürün sayfasında görünmez, yalnız medya kitaplığında yer kaplar; WordPress yöneticinizden temizleyebilirsiniz.

Aynı ürün panelde iki kez var. Muhtemelen bir kanaldan SKU'suz, diğerinden SKU'lu geldi. Bkz. Mükerrer ürünleri birleştirme.

Varyasyonlu ürünler tek üründe toplanır

WooCommerce'de bir ürünün varyasyonları (beden, renk…) varsa panel bunları tek ürün + çok varyant olarak açar; her beden ayrı ürün olmaz. Varyasyon nitelikleriniz ("Beden: L") varyantın seçeneği olarak yazılır, ürünün adı ana ürün adı olur.

Ayrıntı: Kanaldan ürün çekme.

Siparişler anında düşer

Mağazanızda bir sipariş oluştuğu an panele haber gelir (webhook). Kurulumu panel kendisi yapar — WooCommerce yönetim panelinde bir şey ayarlamanız gerekmez.

Neden önemli: siparişler yalnız 5 dakikada bir taransaydı, aynı son ürünü o pencerede birden çok kanal satabilirdi. Anlık bildirimle bu pencere saniyelere iner.

5 dakikalık tarama yine de çalışmaya devam eder — bildirim kaçarsa sipariş yine gelir.

Mağazada düzenlediğiniz sipariş panele yansır

WooCommerce yönetim panelinden bir siparişi düzenlerseniz — ürün ekleme/çıkarma, adet ya da fiyat değişikliği, telefon/adres düzeltme — panel güncel hâli kendiliğinden alır: kalemler ve tutarlar tazelenir, stok rezervi farka göre düzeltilir. Kalem eşitlemesi yalnız kargo öncesi siparişlerde yapılır; faturası kesilmiş sipariş değişirse panel size bildirim düşürür (kesilen belge kendiliğinden değişmez). Panelde elle düzelttiğiniz müşteri iletişim bilgisi korunur — mağazadan gelen güncelleme onu ezmez.