Kargola Nakliye – WooCommerce Entegrasyonu

Description

WooCommerce siparişlerinden Kargola gönderisi oluşturun; takip numarası, barkod, etiket ve webhook güncellemelerini siparişe otomatik işleyin.

Açıklama

Kargola Nakliye – WooCommerce Entegrasyonu, WooCommerce mağazalarının Kargola kargo altyapısı ile çalışmasını sağlar.

Bu eklenti, Kargola’nın resmi WooCommerce entegrasyonudur.

Mağaza yöneticileri bu eklenti ile:

• WooCommerce sipariş listesinden Kargola tekliflerini hızlıca alabilir.
• WooCommerce sipariş detay ekranında kargo firması/servis tekliflerini karşılaştırabilir.
• Seçtiği Kargola teklifi ile gönderi oluşturabilir.
• Kargola sipariş ID, kargo barkodu, takip numarası ve etiket bağlantısını WooCommerce siparişinde saklayabilir.
• Gönderi oluştuğunda WooCommerce siparişini Kargoya Verildi durumuna taşıyabilir.
• Kargola tarafından gönderilen imzalı webhook güncellemelerini WooCommerce sipariş notlarına işleyebilir.
• Her WooCommerce siparişi için Idempotency-Key kullanarak aynı siparişten yanlışlıkla birden fazla gönderi oluşmasını önleyebilir.

Bu eklentiyi kullanmak için bir Kargola hesabı ve aktif Kargola API anahtarı gerekir. Gönderi verileri yalnızca yetkili mağaza yöneticisi sipariş detay ekranından gönderi oluşturduğunda veya Kargola mağazanıza imzalı webhook güncellemesi gönderdiğinde işlenir.

Dış servisler

Bu eklenti, WooCommerce siparişlerinden kargo kaydı oluşturmak ve gönderi durumlarını yönetmek için Kargola tarafından sağlanan Kargola API servisine bağlanır.

Eklenti, yetkili mağaza yöneticisi WooCommerce sipariş detay ekranından Kargola gönderisi oluşturduğunda https://kargola.net/api/v1/external adresine gönderi verisi gönderir. Gönderilen veriler alıcı adı, teslimat veya fatura adresi, telefon numarası, e-posta adresi, paket ölçüleri, seçilen kargo firması/servis, WooCommerce sipariş referansı, tanımlı gönderici adres ID değeri ve isteği doğrulamak için kullanılan Kargola API anahtarını içerebilir.

Eklenti ayrıca gönderi durumu, takip numarası, barkod veya etiket URL güncellemeleri oluştuğunda Kargola’dan sitenizin wp-json/kargola/v1/webhook endpoint’ine gelen imzalı webhook isteklerini alır. Bu güncellemeler, WooCommerce sipariş notlarına ve sipariş meta alanlarına yazılmadan önce tanımlı webhook secret ile doğrulanır.

Bu servis Kargola tarafından sağlanır:

• Kullanım şartları: https://kargola.net/legal/terms
• Gizlilik politikası: https://kargola.net/legal/kvkk

Gereksinimler

• WordPress 6.9 veya üzeri.
• WooCommerce 8.0 veya üzeri.
• PHP 7.4 veya üzeri.
• Kargola hesabı ve aktif API anahtarı.
• WordPress sitenizden Kargola API servisine HTTPS erişimi.

Kurulum

1. Eklenti klasörünü wp-content/plugins/kargola-nakliye dizinine yükleyin veya ZIP dosyasını WordPress yönetim panelinden kurun.
2. WordPress yönetim panelinden eklentiyi etkinleştirin.
3. WooCommerce > Kargola sayfasına gidin.
4. Kargola API anahtarınızı ve varsayılan gönderi ayarlarınızı girin.
5. Ekranda gösterilen webhook URL değerini Kargola panelindeki webhook ayarlarına ekleyin ve aynı webhook secret değerini iki tarafta da kullanın.

Sıkça Sorulan Sorular

API anahtarını nereden alırım?

Kargola hesabınızdaki API ayarları sayfasından API anahtarı oluşturabilirsiniz.

Kapıda ödeme destekleniyor mu?

Kargola API, hesabınızda gerekli PTT hesap numarası tanımlı olduğunda kapıda ödeme gönderilerini destekler. WooCommerce siparişi kapıda ödeme ise eklenti tahsilat tutarını Kargola API’ye gönderir.

Kargo firması seçebilir miyim?

Evet. Sipariş detayında Kargola tekliflerini getirdikten sonra listelenen kargo firması/servis seçeneklerinden istediğiniz teklifi seçerek gönderi oluşturabilirsiniz.

Aynı sipariş yanlışlıkla iki kez kargolanabilir mi?

Eklenti, WooCommerce sipariş ID değerinden üretilen bir Idempotency-Key gönderir. Bu yapı ağ tekrarları veya yanlışlıkla tekrarlanan gönderimlerde mükerrer gönderi oluşmasını önlemeye yardımcı olur.

Webhook istekleri doğrulanıyor mu?

Evet. Webhook istekleri X-Kargola-Timestamp ve X-Kargola-Signature başlıkları kullanılarak HMAC SHA-256 ile doğrulanır.

Ekran Görüntüleri

1. WooCommerce sipariş detay ekranındaki Kargola gönderi kutusu.
2. WooCommerce altındaki Kargola ayar ekranı.

Gizlilik

Bu eklenti, gönderi oluşturulduğunda alıcı adı, adres, telefon, e-posta, paket ölçüleri, seçilen kargo firması/servis ve WooCommerce sipariş referansını Kargola API servisine gönderir. API anahtarı ve webhook secret WordPress seçeneklerinde saklanır. Kargola tarafından gönderilen imzalı webhook güncellemeleri takip numarası, barkod, etiket URL ve durum bilgisini WooCommerce sipariş notlarına yazabilir.

Değişiklik Geçmişi

0.2.1

• WooCommerce HPOS ve klasik sipariş listesine görünür Kargola kolonu eklendi.
• Kapıda ödeme siparişlerinde tüm kargo tekliflerinin görünmesi sağlandı.
• Kapıda ödeme tahsilatı yalnızca seçilen servis PTT kapıda ödeme olduğunda Kargola API’ye gönderilir.

0.2.0

• Sipariş listesine Kargola teklif alma aksiyonu eklendi.
• Sipariş detayında kargo firması/servis teklifleri listelenir ve seçilen teklif ile gönderi oluşturulur.
• Başarılı gönderiler WooCommerce tarafında Kargoya Verildi durumuna taşınır.
• Seçilen kargo firması, servis ve fiyat sipariş metasına kaydedilir.
• Sipariş ekranındaki Kargola kutusu daha açıklayıcı hale getirildi.

0.1.6

• Türkiye adreslerinde WooCommerce il/ilçe alanları Kargola API’ye daha doğru eşlenir.

0.1.5

• WooCommerce HPOS sipariş ekranında Kargola gönderisi oluşturma aksiyonunun sayfa yenilemede kaybolması düzeltildi.
• Gönderi oluşturma sonrası sipariş ekranına dönüş bağlantısı HPOS ve klasik sipariş ekranlarıyla uyumlu hale getirildi.

0.1.4

• WooCommerce gönderi oluşturma hataları artık sipariş notuna yazılır.
• Kapıda ödeme gönderilerinde Kargola API’ye tahsilat tutarı gönderilir.
• PTT kapıda ödeme için firma ve servis kodları otomatik normalize edilir.

0.1.3

• WordPress.org eklenti sayfasındaki açıklama ve kurulum metinleri Türkçeleştirildi.
• Plugin URI başlığı, Author URI ile aynı olmaması için kaldırıldı.

0.1.2

• WordPress.org incelemesi için resmi Kargola eklenti ve geliştirici bağlantıları eklendi.

0.1.1

• WordPress.org incelemesi için Kargola API dış servis kullanımı belgelendi.
• Webhook secret değerlerinin metin alanı sanitizasyonu ile bozulması engellendi.

0.1.0

• İlk beta sürüm yayınlandı.
• WooCommerce siparişlerinden Kargola gönderisi oluşturma eklendi.
• Takip numarası, barkod ve etiket URL bilgisini WooCommerce siparişinde saklama eklendi.
• Kargola imzalı webhook güncellemelerini alma eklendi.