WooCommerce kullanıyorsanız muhtemelen şu döngüyü yaşıyorsunuzdur: sipariş gelir, kargo firmasının paneline gidersiniz, bilgileri elle girersiniz, etiket basarsınız, takip numarasını kopyalayıp WooCommerce'e yapıştırırsınız. Günde 5 sipariş için idare eder. 50 sipariş için sürdürülemez.
Bu rehber, WooCommerce'i Türkiye kargo firmalarına nasıl bağlayacağınızı ve bu döngüyü nasıl kıracağınızı anlatıyor.
WooCommerce'in Kargo Konusunda Sunduğu ve Sunamadığı
WooCommerce'in yerleşik kargo sistemi temel ihtiyaçları karşılar:
- Kargo bölgeleri: İl, ülke veya posta koduna göre farklı ücretler
- Sabit ücret / Ücretsiz kargo: Sepet tutarına göre koşullar
- Sınıflar: Ürün grubuna göre farklı kargo kuralları
Ama etiket basımı, takip numarası geri yazımı, kargo firması API bağlantısı — bunların hiçbiri WooCommerce'te yok. Bunlar için eklenti veya harici entegrasyon gerekir.
Türkiye'de WooCommerce İçin 3 Yol
1. Tek Firma Eklentileri
Bazı kargo firmaları kendi WooCommerce eklentilerini sunar. Aras Kargo'nun ve Yurtiçi Kargo'nun WordPress eklentileri mevcut.
Avantaj: Firma tarafından desteklenir, ücretsiz.
Gerçek sorunlar:
- Sadece o firmayla çalışır — fiyat karşılaştırma yapılamaz
- Eklenti güncelleme sıklığı düşük olabilir — WooCommerce büyük sürüm atladığında eklenti bozulabilir
- Toplu etiket basımı genellikle desteklenmez
- Firma değiştirmek istediğinizde eklenti de değişir, ayarlar sıfırlanır
Ne zaman uygun: Sadece tek firmayla çalışıyorsanız ve günde 10'dan az gönderi yapıyorsanız.
2. Kendi API Entegrasyonunuz
WooCommerce açık kaynak olduğu için her şeyi kendiniz kodlayabilirsiniz. Kargo firmalarının API'lerini doğrudan WooCommerce'e entegre etmek mümkün.
Gereksinimler:
- PHP ve WordPress hook sistemi bilgisi
- Her firma için ayrı API entegrasyonu (Aras SOAP, MNG REST, Yurtiçi SOAP — protokoller bile farklı)
- Webhook endpoint'leri veya cron job'lar kurma
woocommerce_order_status_changedgibi hook'lara bağlanma
Dürüst değerlendirme: Bu yol teknik ekibi olan firmalar için mantıklıdır. Ama bir kargo firmasının API entegrasyonu 2-3 hafta sürer — 3 firma istiyorsanız 2-3 ay. Bakım da ayrı bir iş.
3. Çoklu Kargo Yönetim Platformu + WooCommerce Eklentisi
Üçüncü yol: bir kargo yönetim platformunun hazır WooCommerce eklentisini kurarak tüm firmalara tek seferde erişmek.
Örneğin Shipink'in WooCommerce entegrasyonu WordPress eklenti dizinindeki Shipink eklentisi üzerinden çalışır. Eklentiyi kurarsınız, API anahtarınızı girersiniz, siparişler otomatik akmaya başlar.
Bu yöntemde ne olur:
- WooCommerce'e gelen sipariş → otomatik olarak kargo platformuna aktarılır
- Platformdan firma seçip etiket basarsınız (veya otomatik kural tanımlarsınız)
- Takip numarası WooCommerce siparişine otomatik yazılır
- Müşteriye e-posta/SMS bildirimi gider
WooCommerce'e Özgü Teknik Gerçekler
Shopify veya Ticimax'tan farklı olarak WooCommerce'in bazı kendine özgü konuları var:
Eklenti Çakışmaları
WooCommerce ekosisteminin en büyük sorunu budur. Ortalama bir WooCommerce sitesinde 15-25 eklenti çalışır. Kargo eklentisi eklediğinizde:
- Ödeme eklentileriyle çakışma: iyzico, PayTR gibi ödeme gateway'leri
checkouthook'larını kullanır. Kargo eklentisi de aynı hook'lara bağlanırsa sipariş oluşturma sırasında hata olabilir. - Sipariş yönetimi eklentileriyle çakışma: WooCommerce Order Status Manager gibi eklentiler sipariş durumlarını özelleştirir — kargo eklentisi standart durumları bekler ve karışır.
- Cache eklentileriyle çakışma: WP Rocket, W3 Total Cache gibi eklentiler API isteklerini cache'leyebilir — kargo fiyat sorgularının cache'den gelmesi yanlış fiyat gösterir.
Pratik tavsiye: Yeni kargo eklentisi kurmadan önce mutlaka staging ortamında test edin. WooCommerce → Araçlar → Site Sağlığı'ndan çakışma kontrolü yapın.
WordPress Güncelleme Riski
WordPress, WooCommerce ve eklentiler birbirinden bağımsız güncellenir. Bu üçlü güncelleme döngüsü sorun kaynağıdır:
- WordPress 6.x çıkar → bazı eklentiler henüz uyumlu değildir
- WooCommerce HPOS (High Performance Order Storage) geçişi → eski eklentiler bozulur
- PHP sürümü güncellenir → eski eklentilerin deprecated fonksiyonları hata verir
API bazlı entegrasyonlar bu sorundan daha az etkilenir çünkü WordPress iç yapısına değil, REST API'ye bağlıdır. REST API daha stabil bir katmandır.
Performans Etkisi
Her eklenti her sayfa yüklemesinde yüklenir. Kargo eklentileri genellikle admin panelinde ağırdır ama frontend'e de etki edebilir:
- Checkout sayfasında gerçek zamanlı fiyat sorgusu yapılıyorsa sayfa yavaşlar
- JavaScript dosyaları tüm sayfalara yükleniyorsa site hızı düşer
- Veritabanı sorguları artarsa (her sipariş için ek meta data) admin paneli yavaşlar
Test edin: Eklenti kurmadan önce ve sonra Google PageSpeed Insights ile checkout sayfasını karşılaştırın.
Kurulum: WooCommerce + Shipink
1. Eklentiyi Kurun
WordPress → Eklentiler → Yeni Eklenti Ekle → "Shipink" aratın → Kur ve Etkinleştir.
Alternatif: wordpress.org/plugins/shipink adresinden indirip manuel yükleyin.
2. API Bağlantısını Yapın
Shipink panelinden WooCommerce entegrasyon sayfasına gidin. İki yöntem var:
- Otomatik (önerilen): Eklenti ayarlarından Shipink hesabınızla bağlantı kurun — OAuth ile tek tık
- Manuel: WooCommerce → Ayarlar → Gelişmiş → REST API → Yeni anahtar oluştur (Okuma/Yazma). Consumer Key ve Secret'ı Shipink'e girin.
3. Kargo Firmalarını Aktif Edin
16 kargo firmasından istediğinizi aktif edin:
- Kendi anlaşmanız varsa → firma API bilgilerinizi girin
- Anlaşmanız yoksa → Shipink anlaşmasını aktif edin (taahhütsüz, hemen başlar)
4. Test Edin
Canlıya almadan önce:
- Bir test siparişi oluşturun (WooCommerce → Siparişler → Yeni Sipariş)
- Shipink'ten etiket basın
- Takip numarasının WooCommerce siparişine geri yazıldığını doğrulayın
- Müşteriye giden bildirim e-postasını kontrol edin
Sık Karşılaşılan Sorunlar ve Çözümleri
"Siparişler Shipink'e aktarılmıyor"
Kontrol edin:
- Eklenti aktif mi? (WordPress → Eklentiler)
- API anahtarı doğru mu? (Shipink → Entegrasyonlar → WooCommerce)
- WooCommerce REST API etkin mi? (Permalink yapısı "Düz" olmamalı — Pretty permalink gerekir)
"Takip numarası WooCommerce'e yazılmıyor"
Kontrol edin:
- WooCommerce API anahtarının yazma yetkisi var mı?
- Sipariş durumu "İşleniyor" mu? (Tamamlanmış siparişlere yazılmayabilir)
- Eklenti güncel mi?
"Checkout'ta kargo ücreti gösteremiyorum"
WooCommerce'in kargo ücreti hesaplaması ve Shipink'ten gerçek zamanlı fiyat çekme farklı şeylerdir. Şu an en pratik yol: WooCommerce'de sabit/ağırlık bazlı ücret tanımlamak, Shipink'i ise sipariş sonrası etiket oluşturma ve takip için kullanmak.
Sonuç
WooCommerce kargo entegrasyonunun en pratik yolu hazır bir eklenti + API bazlı platform kullanmaktır. Bu sayede eklenti çakışma riskini minimize eder, WordPress güncelleme sorunlarından korunur ve tek panelden birden fazla kargo firmasıyla çalışabilirsiniz.
WordPress eklenti dizininden Shipink eklentisini kurarak başlayabilirsiniz. Kurulum yaklaşık 10 dakika sürer.
