Kargola Nakliye – WooCommerce Entegrasyonu vs OrderKrab for WooCommerce

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 Eklenti klasörünü wp-content/plugins/kargola-nakliye dizinine yükleyin veya ZIP dosyasını WordPress yönetim panelinden kurun. WordPress yönetim panelinden eklentiyi etkinleştirin. WooCommerce > Kargola sayfasına gidin. Kargola API anahtarınızı ve varsayılan gönderi ayarlarınızı girin. 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 WooCommerce sipariş detay ekranındaki Kargola gönderi kutusu. 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.

OrderKrab for WooCommerce is a thin integration between WooCommerce and the OrderKrab fulfillment platform. It lets a WooCommerce store offer carrier-driven shipping rates and parcel locker selection at checkout, then keeps order state in sync with OrderKrab as the order moves through fulfillment. What it does Adds a shipping method that returns rates from the OrderKrab API, including parcel locker pricing per carrier. Renders a parcel locker search field at checkout (native or Shopify-style block). Syncs newly created and updated WooCommerce orders to OrderKrab. Provides an hourly batch reconciliation for any orders that didn’t sync in real time. Receives webhooks from OrderKrab for order, product, and connection status updates. Embeds the hosted OrderKrab return portal on any page — via a Gutenberg block or the [orderkrab_return_portal] shortcode — so customers can register returns without leaving the store. Emails customers their return shipping label as a real WooCommerce email when a return is approved in OrderKrab, and records the return on the order. Optionally adds the shipment tracking number and a “Track your shipment” button to the customer’s “Completed order” email when OrderKrab fulfils the order (one switch under OrderKrab → Emails). Who it’s for Stores that already use (or plan to use) the OrderKrab fulfillment platform to manage shipping with carriers like DPD, LP Express, Omniva, InPost, FedEx, DHL, and others. External services This plugin connects to the OrderKrab API (https://api.orderkrab.com) — the configured base URL is shown in the plugin’s Connection settings and can be overridden by store administrators. What is sent and when: When a customer reaches checkout, the plugin sends the shipping destination (country, postcode, city) and cart contents to OrderKrab to retrieve available shipping methods and prices. When a customer searches for a parcel locker, the plugin sends the search query plus destination country/city to OrderKrab to retrieve matching locker locations. When an order is created or updated in WooCommerce, the plugin sends the order details (line items, shipping address, totals, selected shipping method) to OrderKrab so fulfillment can be coordinated. The plugin authenticates each request using an access token that the store administrator pastes into the plugin’s Connection tab. When a visitor opens a page containing the return portal block or shortcode, their browser loads the hosted OrderKrab return portal (https://returns.orderkrab.com) in an iframe. The store’s portal token, the display language, and any theme colors configured under OrderKrab → Returns are passed as URL parameters so the portal can identify the store and match its styling. Why an external service is required: carrier rate calculation, parcel locker availability lookups, and label/tracking generation depend on real-time data from carriers, which is aggregated by OrderKrab and cannot be performed locally by the plugin. Provider links: OrderKrab website: https://orderkrab.com Terms of Service: https://orderkrab.com/terms Privacy Policy: https://orderkrab.com/privacy