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.

Rajesh Raval

namicargo

<p>Nami Cargo Shipping is a WooCommerce plugin designed to provide dynamic shipping options for your store. It integrates seamlessly with the Nami Cargo API to calculate shipping rates, estimated times of arrival (ETA), and more.</p>
<h3>Features</h3>
<ul>
<li>Dynamic shipping rate calculation using the Nami Cargo API.  </li>
<li>Support for multiple warehouses and product stock validation.  </li>
<li>Configurable shipping options through WooCommerce settings.</li>
</ul>
<h3>External Services</h3>
<p>This plugin connects to the <strong>Nami Cargo Shipping API</strong> to fetch warehouse details, product stock availability, and customer shipping information. It then retrieves shipping charges and estimated delivery time (ETA) based on the provided data.</p>
<p><strong>What data is sent and when?</strong><br />
Whenever an order is placed or shipping details are needed, the plugin sends the following information to the Nami Cargo Shipping API:</p>
<ul>
<li><strong>Warehouse Data:</strong> Warehouse name, address, city, country, and available product stock.  </li>
<li><strong>Product Data:</strong> SKU, product name, quantity, dimensions (width, height, depth), and price.  </li>
<li><strong>Customer Data:</strong> Shipping address, first name, last name, phone number, email, city, country, and optional delivery instructions.  </li>
<li><strong>Order Details:</strong> Order ID, order type, total value, payment method, and shipping preferences set by the admin.  </li>
</ul>
<p><strong>Where is this data sent?</strong><br />
The data is sent to <strong>Nami Cargo Shipping</strong> servers: <a href="https://www.nami.la/cargo" rel="nofollow ugc">https://www.nami.la/cargo</a></p>
<p><strong>Why is this data sent?</strong><br />
The data is required to calculate accurate shipping costs, determine available delivery options, and manage warehouse stock updates.</p>
<p><strong>Links to Terms of Service and Privacy Policy:</strong><br />
– <strong>Terms and Conditions:</strong> <a href="https://cdn.prod.website-files.com/6697efb919e7ec45f4ee44f4/66b278cdbe9d67bffd94be64_TERMINOS%20Y%20CONDICIONES%20SERVICIOS%20NAMI.pdf" rel="nofollow ugc">https://cdn.prod.website-files.com/6697efb919e7ec45f4ee44f4/66b278cdbe9d67bffd94be64_TERMINOS%20Y%20CONDICIONES%20SERVICIOS%20NAMI.pdf</a><br />
– <strong>License and Agreement:</strong> <a href="https://www.nami.la/licencia-y-acuerdo" rel="nofollow ugc">https://www.nami.la/licencia-y-acuerdo</a></p>
<p>By using this plugin, users agree to share this data with Nami Cargo Shipping to facilitate order fulfillment.</p>
<h3>Support</h3>
<p>For support, please contact <a href="mailto:info@nami.la" rel="nofollow ugc">info@nami.la</a>.</p>


Nami Cargo Shipping

A custom WooCommerce shipping plugin that dynamically calculates shipping rates using the Nami Cargo API.

Kargola Nakliye – WooCommerce Entegrasyonu vs Nami Cargo Shipping