kargola

<p>WooCommerce siparişlerinden Kargola gönderisi oluşturun; takip numarası, barkod, etiket ve webhook güncellemelerini siparişe otomatik işleyin.</p>
<h3>Açıklama</h3>
<p>Kargola Nakliye – WooCommerce Entegrasyonu, WooCommerce mağazalarının Kargola kargo altyapısı ile çalışmasını sağlar.</p>
<p>Bu eklenti, Kargola’nın resmi WooCommerce entegrasyonudur.</p>
<p>Mağaza yöneticileri bu eklenti ile:</p>
<ul>
<li>WooCommerce sipariş listesinden Kargola tekliflerini hızlıca alabilir.</li>
<li>WooCommerce sipariş detay ekranında kargo firması/servis tekliflerini karşılaştırabilir.</li>
<li>Seçtiği Kargola teklifi ile gönderi oluşturabilir.</li>
<li>Kargola sipariş ID, kargo barkodu, takip numarası ve etiket bağlantısını WooCommerce siparişinde saklayabilir.</li>
<li>Gönderi oluştuğunda WooCommerce siparişini Kargoya Verildi durumuna taşıyabilir.</li>
<li>Kargola tarafından gönderilen imzalı webhook güncellemelerini WooCommerce sipariş notlarına işleyebilir.</li>
<li>Her WooCommerce siparişi için Idempotency-Key kullanarak aynı siparişten yanlışlıkla birden fazla gönderi oluşmasını önleyebilir.</li>
</ul>
<p>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.</p>
<h3>Dış servisler</h3>
<p>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.</p>
<p>Eklenti, yetkili mağaza yöneticisi WooCommerce sipariş detay ekranından Kargola gönderisi oluşturduğunda <code>https://kargola.net/api/v1/external</code> 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.</p>
<p>Eklenti ayrıca gönderi durumu, takip numarası, barkod veya etiket URL güncellemeleri oluştuğunda Kargola’dan sitenizin <code>wp-json/kargola/v1/webhook</code> 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.</p>
<p>Bu servis Kargola tarafından sağlanır:</p>
<ul>
<li>Kullanım şartları: https://kargola.net/legal/terms</li>
<li>Gizlilik politikası: https://kargola.net/legal/kvkk</li>
</ul>
<h3>Gereksinimler</h3>
<ul>
<li>WordPress 6.9 veya üzeri.</li>
<li>WooCommerce 8.0 veya üzeri.</li>
<li>PHP 7.4 veya üzeri.</li>
<li>Kargola hesabı ve aktif API anahtarı.</li>
<li>WordPress sitenizden Kargola API servisine HTTPS erişimi.</li>
</ul>
<h3>Kurulum</h3>
<ol>
<li>Eklenti klasörünü <code>wp-content/plugins/kargola-nakliye</code> dizinine yükleyin veya ZIP dosyasını WordPress yönetim panelinden kurun.</li>
<li>WordPress yönetim panelinden eklentiyi etkinleştirin.</li>
<li>WooCommerce > Kargola sayfasına gidin.</li>
<li>Kargola API anahtarınızı ve varsayılan gönderi ayarlarınızı girin.</li>
<li>Ekranda gösterilen webhook URL değerini Kargola panelindeki webhook ayarlarına ekleyin ve aynı webhook secret değerini iki tarafta da kullanın.</li>
</ol>
<h3>Sıkça Sorulan Sorular</h3>
<h4>API anahtarını nereden alırım?</h4>
<p>Kargola hesabınızdaki API ayarları sayfasından API anahtarı oluşturabilirsiniz.</p>
<h4>Kapıda ödeme destekleniyor mu?</h4>
<p>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.</p>
<h4>Kargo firması seçebilir miyim?</h4>
<p>Evet. Sipariş detayında Kargola tekliflerini getirdikten sonra listelenen kargo firması/servis seçeneklerinden istediğiniz teklifi seçerek gönderi oluşturabilirsiniz.</p>
<h4>Aynı sipariş yanlışlıkla iki kez kargolanabilir mi?</h4>
<p>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.</p>
<h4>Webhook istekleri doğrulanıyor mu?</h4>
<p>Evet. Webhook istekleri <code>X-Kargola-Timestamp</code> ve <code>X-Kargola-Signature</code> başlıkları kullanılarak HMAC SHA-256 ile doğrulanır.</p>
<h3>Ekran Görüntüleri</h3>
<ol>
<li>WooCommerce sipariş detay ekranındaki Kargola gönderi kutusu.</li>
<li>WooCommerce altındaki Kargola ayar ekranı.</li>
</ol>
<h3>Gizlilik</h3>
<p>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.</p>
<h3>Değişiklik Geçmişi</h3>
<h4>0.2.1</h4>
<ul>
<li>WooCommerce HPOS ve klasik sipariş listesine görünür Kargola kolonu eklendi.</li>
<li>Kapıda ödeme siparişlerinde tüm kargo tekliflerinin görünmesi sağlandı.</li>
<li>Kapıda ödeme tahsilatı yalnızca seçilen servis PTT kapıda ödeme olduğunda Kargola API’ye gönderilir.</li>
</ul>
<h4>0.2.0</h4>
<ul>
<li>Sipariş listesine Kargola teklif alma aksiyonu eklendi.</li>
<li>Sipariş detayında kargo firması/servis teklifleri listelenir ve seçilen teklif ile gönderi oluşturulur.</li>
<li>Başarılı gönderiler WooCommerce tarafında Kargoya Verildi durumuna taşınır.</li>
<li>Seçilen kargo firması, servis ve fiyat sipariş metasına kaydedilir.</li>
<li>Sipariş ekranındaki Kargola kutusu daha açıklayıcı hale getirildi.</li>
</ul>
<h4>0.1.6</h4>
<ul>
<li>Türkiye adreslerinde WooCommerce il/ilçe alanları Kargola API’ye daha doğru eşlenir.</li>
</ul>
<h4>0.1.5</h4>
<ul>
<li>WooCommerce HPOS sipariş ekranında Kargola gönderisi oluşturma aksiyonunun sayfa yenilemede kaybolması düzeltildi.</li>
<li>Gönderi oluşturma sonrası sipariş ekranına dönüş bağlantısı HPOS ve klasik sipariş ekranlarıyla uyumlu hale getirildi.</li>
</ul>
<h4>0.1.4</h4>
<ul>
<li>WooCommerce gönderi oluşturma hataları artık sipariş notuna yazılır.</li>
<li>Kapıda ödeme gönderilerinde Kargola API’ye tahsilat tutarı gönderilir.</li>
<li>PTT kapıda ödeme için firma ve servis kodları otomatik normalize edilir.</li>
</ul>
<h4>0.1.3</h4>
<ul>
<li>WordPress.org eklenti sayfasındaki açıklama ve kurulum metinleri Türkçeleştirildi.</li>
<li>Plugin URI başlığı, Author URI ile aynı olmaması için kaldırıldı.</li>
</ul>
<h4>0.1.2</h4>
<ul>
<li>WordPress.org incelemesi için resmi Kargola eklenti ve geliştirici bağlantıları eklendi.</li>
</ul>
<h4>0.1.1</h4>
<ul>
<li>WordPress.org incelemesi için Kargola API dış servis kullanımı belgelendi.</li>
<li>Webhook secret değerlerinin metin alanı sanitizasyonu ile bozulması engellendi.</li>
</ul>
<h4>0.1.0</h4>
<ul>
<li>İlk beta sürüm yayınlandı.</li>
<li>WooCommerce siparişlerinden Kargola gönderisi oluşturma eklendi.</li>
<li>Takip numarası, barkod ve etiket URL bilgisini WooCommerce siparişinde saklama eklendi.</li>
<li>Kargola imzalı webhook güncellemelerini alma eklendi.</li>
</ul>


Kargola Nakliye – WooCommerce Entegrasyonu

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

ilhanaydinli

<p>With the WooCommerce cargo tracking plugin, you can add as many cargo companies as you want, show cargo tracking links on the front and admin side, and send cargo tracking emails to users.</p>
<h3>Plugin Functionality</h3>
<ul>
<li>“Order Shipped” status for WooCommerce.</li>
<li>Ability to add unlimited shipping companies.</li>
<li>Ability to enter shipping date.</li>
<li>Changing order status when shipping information is entered.</li>
<li>Ability to send e-mail containing order information when shipping information is entered.</li>
<li>Customizing e-mail content.</li>
<li>Being able to see the cargo tracking link on the My Account page.</li>
<li>Being able to see the cargo tracking links in the admin orders table.</li>
<li>Ability to change the status of orders to a different state when you remove the plugin.</li>
<li>Ability to delete all data of the add-on when you remove the add-on.</li>
</ul>
<h3>Contribute To Development</h3>
<p>Development happens <a href="https://github.com/ilhanaydinli/cargo-tracking-for-woocommerce" rel="nofollow ugc">on GitHub</a>.</p>


Cargo Tracking for WooCommerce

With the WooCommerce cargo tracking plugin, you can add as many cargo companies as you want, show cargo tracking links on the front and admin side, an …

Kargola Nakliye – WooCommerce Entegrasyonu vs Cargo Tracking for WooCommerce