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'e kargo eklentisinin nasıl kurulduğunu ve bu döngünün nasıl kırıldığını anlatıyor — hangi yöntemi seçeceğinizden, WordPress'e özgü çakışma ve güncelleme risklerine kadar.
Kurulumu doğrudan yapmak isterseniz WooCommerce kargo entegrasyonu sayfamızda desteklenen firmalar ve bağlantı akışı yer alıyor. Bu yazı ise üç yöntem arasında karar vermenize yardımcı olmak için yazıldı.
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 — eşiği doğru kurmak burada belirleyicidir
- 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.
Ayrımı net koymak faydalı: WooCommerce'in kargo ayarları müşteriye ne kadar ücret göstereceğinizi belirler. Kargo eklentisi ise gönderinin kargo firmasında nasıl oluşacağını belirler. İkisi farklı işlerdir ve biri diğerinin yerine geçmez.
Türkiye'de WooCommerce İçin 3 Yol
| Yöntem | Kurulum süresi | Teknik ekip | Fiyat karşılaştırma | En uygun hacim |
|---|---|---|---|---|
| Tek firma eklentisi | 15-30 dk | Gerekmez | Yok | Günde <10 gönderi |
| Kendi API entegrasyonunuz | 2-8 hafta | Gerekli | Yazdığınız kadar | 1.000+ sipariş/ay |
| Platform eklentisi | 10-20 dk | Gerekmez | Tüm firmalar arası | 50+ sipariş/ay |
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.
Buradaki asıl maliyet görünmez olandır: fiyat karşılaştırması yapmadığınız her gönderide, o parsel için daha uygun olabilecek firmayı hiç bilmezsiniz. Çoklu kargo firması stratejisinin tasarruf tarafını ayrı bir yazıda ele aldık.
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 aya yakın bir süre. Bakım da ayrı bir iş.
Kendin mi yazmalı, satın mı almalı sorusunu ayrı bir yazıda rakamlarla ele aldık.
Bakım kalemini küçümsemeyin: üç firmayla çalışıyorsanız üç ayrı dokümantasyonu, üç ayrı hata kodu setini ve yıl içindeki değişiklikleri takip etmeniz gerekir. Çoğu ekip entegrasyonu bir kez yazıp bir daha açmaz — sonra bir firma endpoint'ini değiştirir ve gönderiler sessizce başarısız olmaya başlar.
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 kendine özgü bazı 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 — standart durumları bekleyen kargo eklentisini yanıltarak hatalı davranışa yol açabilir.
- Cache eklentileriyle çakışma: WP Rocket, W3 Total Cache gibi eklentiler API isteklerini cache'leyebilir — kargo fiyat sorguları cache'den gelirse müşteriye yanlış fiyat gösterilir.
Pratik tavsiye: Yeni kargo eklentisi kurmadan önce mutlaka staging ortamında test edin. WordPress → 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.
HPOS Uyumluluğu
Bu, son yıllarda WooCommerce eklentilerini en çok bozan tek değişiklik. WooCommerce siparişleri geleneksel olarak WordPress'in posts tablosunda tutuyordu; HPOS bunları kendi tablolarına taşır. Eklenti hâlâ eski yapıyı okuyorsa siparişleri "bulamaz" — hata vermez, sadece boş döner ve bunu fark etmeniz günler alabilir.
Kontrol etmeniz gerekenler:
- WooCommerce → Ayarlar → Gelişmiş → Özellikler bölümünde hangi depolama yapısında olduğunuzu görün
- Aynı ekran, kurulu eklentilerin uyumluluk durumunu da listeler — kargo eklentiniz uyumsuz işaretliyse geçiş yapmayın
- Geçişi önce staging ortamında yapın ve bir test siparişinin uçtan uca aktığını doğrulayın
Yeni kurulan mağazalar genellikle doğrudan yeni yapıyla başlar; yıllardır çalışan mağazalar ise hâlâ eski yapıda olabilir. Hangisinde olduğunuzu bilmeden eklenti seçmek risklidir.
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 Öncesi Kontrol Listesi
Eklentiyi kurmadan önce beş dakikanızı bunlara ayırın — kurulum sonrası sorunların çoğu buradan çıkar:
- Staging ortamı hazır mı? Canlı sitede ilk kurulumu yapmayın.
- Permalink yapısı "Düz" değil. WooCommerce REST API pretty permalink gerektirir; "Düz" ayarda entegrasyon hiç çalışmaz.
- Ürün ağırlık ve boyutları girili. Boşsa fiyat karşılaştırması anlamsızlaşır ve kargo firmasından desi farkı faturası gelir.
- PHP sürümü güncel. Eski PHP sürümlerinde modern eklentiler kurulmaz veya uyarı üretir.
- Yedek alındı. Veritabanı ve dosya yedeği, HPOS geçişi yapacaksanız zorunlu.
- Mevcut eklenti listesi çıkarıldı. Çakışma yaşarsanız hangi eklentiyi devre dışı bırakacağınızı bilmek için.
Kurulum: WooCommerce + Shipink
1. Eklentiyi Kurun
WordPress → Eklentiler → Yeni Eklenti Ekle → "Shipink" aratın → Kur ve Etkinleştir.
Alternatif: tr.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. Bildirimleri Kurun
Bu adım en çok atlanan ama destek yükünü en çok düşüren adımdır. Markalı takip sayfası ve otomatik bildirimleri aktif ettiğinizde "siparişim nerede?" talepleri belirgin şekilde azalır — çünkü müşteri sormadan önce cevabı almış olur.
5. 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)
- HPOS geçişi yaptıysanız eklenti uyumlu mu?
"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'te sabit/ağırlık bazlı ücret tanımlamak, Shipink'i ise sipariş sonrası etiket oluşturma ve takip için kullanmak.
"İade etiketi oluşturamıyorum"
WooCommerce'in yerleşik iade akışı yoktur; iade talepleri genelde eklenti veya e-posta üzerinden yönetilir. İade kargo etiketini kargo panelinizden üretmek en pratik yoldur — iade yönetimi rehberinde süreci baştan sona ele aldık.
Sonuç
WooCommerce kargo entegrasyonunun en pratik yolu hazır bir eklenti + API bazlı platform kullanmaktır. Bu sayede eklenti çakışma riskini minimize edersiniz, WordPress güncelleme sorunlarından korunursunuz ve tek panelden birden fazla kargo firmasıyla çalışabilirsiniz.
Birden fazla kanalda satıyorsanız aynı mantık orada da geçerli: tüm kanalları tek panelde toplamak, ölçeklenirken en çok fark yaratan karardır.
WordPress eklenti dizininden Shipink eklentisini kurarak ya da WooCommerce entegrasyon sayfasından başlayabilirsiniz. Kurulum yaklaşık 10 dakika sürer.
