Bir e-ticaret mağazasında müşteri deneyimi, “Satın Al” düğmesine bastığı anda bitmez; asıl sınav paket kapıya ulaşana kadar sürer. Kargo süreci yavaş, belirsiz ya da hatalı yürüdüğünde müşteri memnuniyeti düşer, destek talepleri artar ve iade oranı yükselir. SoftCrafter Navlungo Yurt İçi Kargo eklentisi, CS-Cart siparişinizi tek tıkla gerçek bir Navlungo gönderisine dönüştürür; kargo firması seçimini, barkod üretimini, takip bilgisini ve iptali sipariş ekranından yönetmenizi sağlar.
Eklenti bir fiyat hesaplama aracı değildir: Navlungo’nun yurt içi servisinde fiyat teklifi uç noktası bulunmadığı için nakliye ücretleri CS-Cart’taki kendi nakliye yöntemlerinizden gelir. Yurt dışı gönderi ise farklı bir ürün ve farklı bir servistir; bu eklenti yalnızca yurt içi gönderiler içindir.
Siparişten gönderiye: tek ekranda akış
Eklenti kullanımı bilinçli olarak sade tutulmuştur. Bir siparişte alışılmış şekilde gönderi eklersiniz, “bu gönderiyi şimdi Navlungo’da oluştur” kutusunu işaretler, kargo firmasını seçer ve gerekirse paket boyutunu düzenlersiniz. Siparişin Navlungo sekmesi her gönderiyi durumu, geçmişi, barkod düğmesi ve iptal düğmesiyle listeler.
Toplu işlem için sipariş listesinden birden çok sipariş seçilebilir. Gönderiler tek tek oluşturulur ve her hata, sipariş numarası ve nedeniyle ayrı ayrı raporlanır; böylece yüz siparişlik bir toplu işlemde tek bir hatalı adres yüzünden tüm işin durduğunu görmezsiniz.
Zaman aşımı durumunda mükerrer gönderi oluşmaz. Her gönderinin sabit bir referansı vardır. İstek zaman aşımına uğrarsa aynı referansla yapılan tekrar denemede Navlungo gönderinin zaten var olduğunu bildirir ve eklenti mevcut gönderi numarasını geri alır. Mevcut gönderi okunamıyorsa eklenti ikinci bir gönderi oluşturmak yerine durur ve sorunu bildirir.
Kargo firmaları ve sözleşmeler
Kargo listesini yeniledikten sonra müşteriye sunmak istediğiniz firmaları işaretlersiniz. Her firma şu durumlardan birinde görünür:
- Sözleşme listenizde: Seçilebilir.
- Listede değil: Nedeniyle birlikte görünür ama seçilemez.
- Navlungo liste döndürmedi: Tüm firmalar seçilebilir kalır ve doğrulanmamış olarak işaretlenir; varsa Navlungo’nun reddi gönderi denemesinde döner ve reddedilen deneme ücretlendirilmez.
Aras Kargo ve PTT Kargo, Navlungo’nun takip adresine takip numarası alamadığı için bu firmalarda müşteri takip bağlantısı Navlungo’nun takip sayfasına yönlendirilir.
Burada kritik bir koşul vardır: Navlungo hesabınızda en az bir kargo sözleşmesi etkin olmalıdır. Sözleşme yoksa her gönderi reddedilir. Kargo firmalarıyla sözleşmeler, ücretler ve teslimat performansı sizinle Navlungo ve kargo firmaları arasındadır; eklentinin bunları çözmesi mümkün değildir.
Adres doğrulama: sorunu gönderiden önce yakalamak
Kargo operasyonunda en pahalı hata, yanlış ya da eksik adrestir: geri dönen paket, tekrar gönderim, gecikme ve memnuniyetsiz müşteri. Navlungo yalnızca ilgili alanların dolu olup olmadığını denetler, yerin gerçekten var olup olmadığını denetlemez. Bu yüzden eklenti adresi göndermeden önce, sipariş ekranında doğrular ve bu denetim varsayılan olarak açıktır.
CS-Cart alanları şöyle eşlenir: eyalet İl’e, şehir İlçe’ye, adres ise açık adres satırına karşılık gelir. Ödeme sayfasında 81 il ve 973 ilçeyi kapsayan il ve ilçe seçicileri bulunur; böylece müşteri serbest metinle yanlış yazım yapamaz. Eklentiyi kurmadan önce verilmiş siparişler değiştirilmez; mevcut adres birkaç yolla okunmaya çalışılır ve tek anlamlı sonuç çıkmazsa tahmin yürütmek yerine kararı size bırakır. “Merkez” gibi birden çok ilde bulunan ilçe adları hiçbir zaman otomatik çözülmez.
Desi hesabı
Kargo firmaları, gerçek ağırlık ile hacimsel ağırlığın (desi) büyüğü üzerinden ücretlendirir. Hacimsel bölen “Desi hesabı” ayarında tanımlanır; genellikle 3000’dir, ancak bazı sözleşmelerde 4000 ya da 5000 olabilir. Boyutlar ürünlerden alınır; kutu boyutu girilmişse öncelik kutu ölçülerinindir ve gönderi formunda rakamı her zaman elle düzeltebilirsiniz; sizin değeriniz kazanır. Boyutu tanımsız ürün hiçbir zaman sıfır sayılmaz; sonuç tahmin olarak işaretlenir ve ya siz onaylarsınız ya da eklenti gönderi oluşturmayı reddeder. Bu, desi hatasından doğan kargo fiyat farklarını baştan önler.
Barkod ve etiket
Barkodu sipariş sekmesinden ya da gönderi listesinden yazdırabilirsiniz. Barkod bir kez alınır ve saklanır; yeniden yazdırmak Navlungo’ya erişilebilir olmanıza bağlı değildir. Format seçenekleri şunlardır: PDF (tüm kargo firmaları destekler), ZPL (etiket yazıcıları için, Navlungo Aras Kargo ile çalıştığını belirtir) ve ZPL 10x10 (HepsiJet için). Kargo firması istenen formatı üretemezse Navlungo PDF döndürür. Barkod, gönderi oluşturulduktan yaklaşık 20 saniye sonra hazır olur; erken istek “kargo firması bu barkodu henüz üretmedi” yanıtı verir ve bu bir hata değil, bekleme durumudur.
Durum eşitleme ve müşteri takibi
Navlungo bildirim göndermediği için mağazanın durumu periyodik olarak sorgulaması gerekir. Eşitleme görevi her 15 dakikada bir çalışacak şekilde zamanlanır ve cron parolası URL’de değil başlıkta gönderilir; böylece parola günlüklere sızmaz. Durum kodları şöyle eşlenir:
| Durum | Anlamı | Son durum mu? |
|---|---|---|
| Teslim Alınacak | Kargo firması gönderiyi alacak | Hayır |
| Teslim Alındı | Paket kargo firmasında | Hayır |
| Transfer Aşamasında | Aktarma yolunda | Hayır |
| Dağıtıma Çıktı | Kurye yolda | Hayır |
| Teslim Edildi | Müşteriye ulaştı | Evet |
| İade Edilecek | İade başladı | Hayır (personel incelemesi gerekir) |
| İade Edildi / Depoya İade Edildi | Göndericiye döndü | Evet |
| İptal | Gönderi iptal edildi | Evet |
Tanınmayan durum kodları ham adıyla gösterilir ve hiçbir zaman “son durum” sayılmaz; böylece yolda olan bir gönderinin takibi kendiliğinden durdurulmaz. Müşteri, sipariş sayfasında takip numarasını, güncel durumu, geçmişi ve takip bağlantısını görür. Sayfa mağaza tarafından üretilir; müşterinin tarayıcısı Navlungo ile hiç konuşmaz ve JavaScript kapalıyken de çalışır. “Son kontrol” zaman damgası, durumun ne kadar güncel olduğunu gösterir.
Kapıda ödeme ve iade gönderisi
Kapıda ödeme: “Henüz ödenmedi” anlamına gelen ödeme yöntemi numaralarını siz tanımlarsınız. Liste boşsa hiçbir sipariş uygun sayılmaz; bu bilinçlidir, çünkü ödenmiş bir sipariş için kapıda ödemeli gönderi açmak parayı iki kez tahsil etmek demektir. Yalnızca nakit tahsilatı sunan kargo firmaları bu seçenekte görünür. İade gönderileri müşteriden depoya doğru kurulur, yalnızca iade toplayan kargo firmaları sunulur ve kapıda ödeme kullanılamaz.
Gereksinimler ve kurulum
| Gereksinim | Ayrıntı |
|---|---|
| CS-Cart | 4.19.0 ve üzeri (Ultimate, Multi-Vendor, Multi-Vendor Plus) |
| PHP | 7.4+; curl ve openssl etkin |
| Navlungo | En az bir kargo sözleşmesi etkin hesap |
| Güvenlik | config.local.php içinde özel bir crypt_key (varsayılanla eklenti kimlik bilgisini kaydetmez) |
| Yetkiler | “Navlungo gönderilerini görüntüle” ve “oluştur ve iptal et” yetkileri elle verilir |
Test ve canlı ortamlar ayrı sistemlerdir: ayrı hesap, ayrı adres defteri ve ayrı kargo sözleşmesi içerirler. Ortam değiştirildiğinde önbellekteki oturum, kargo listesi ve gönderici adresi temizlenir. Oturum jetonları sekiz saat geçerlidir; eklenti bunları şifreli saklar ve otomatik yeniler. Gönderici adresi Navlungo adres defterinizden seçilir; serbest metin kabul edilmez.
Gizlilik ve veri
Alıcının adı, telefonu ve adresi teslimat için Navlungo’ya iletilir. Bu, kişisel verinin bir işleyiciye aktarılmasıdır ve gizlilik metninizde belirtilmelidir. Kimlik bilgileri ve oturum jetonları mağazanın şifreleme anahtarıyla şifrelenir; kayıtlarda, hata mesajlarında ya da HTTP yanıtlarında görünmez. Bir müşterinin verisi silindiğinde gönderilerindeki kişisel alanlar temizlenir; gönderi numaraları ve durumlar korunur.
Bilinen sınırlar
- Nakliye ücreti hesaplamaz; fiyatı kendi nakliye yöntemleriniz belirler.
- Aynı gün teslimat desteklenmez.
- Webhook yoktur; durum, son eşitleme kadar günceldir.
- Navlungo yalnızca birkaç durum kodunu belgelediğinden diğerleri temkinli ele alınır.
- Gönderiler tek tek oluşturulur; toplu işlemde Navlungo’nun parti davranışına güvenilmez.
- İptal ve düzenleme yalnızca gönderi “Teslim Alınacak” ya da “Önizleme” durumundayken mümkündür; kargo firması etiketi ürettikten (yaklaşık bir dakika sonra) değişiklik reddedilir.
Proje nasıl ilerler?
Kargo entegrasyonu, teknik kurulumdan çok operasyon tasarımıdır. Tipik akış şöyledir:
- Operasyon analizi: Günlük sipariş hacmi, kullanılan kargo firmaları, kapıda ödeme oranı, iade sıklığı ve depodaki etiket yazıcısı gibi koşullar konuşulur.
- Navlungo hesabı ve sözleşmeler: Test hesabıyla başlanır; canlı geçişte ayrı kimlik bilgileri ve etkin kargo sözleşmeleri gerekir.
- Eklenti kurulumu ve yetkiler: Paket yüklenir, özel şifreleme anahtarı doğrulanır, iki yetki ilgili gruplara verilir.
- Adres ve desi ayarları: İl-ilçe seçicileri, adres doğrulama ve hacimsel bölen yapılandırılır; ürün boyutları kontrol edilir.
- Barkod formatı ve yazıcı testi: PDF ya da ZPL seçilir, etiket yazıcısıyla deneme baskıları alınır.
- Durum eşitleme: 15 dakikalık görev kurulur, parola başlıkla iletilir.
- Pilot gönderiler: Gerçek siparişlerle birkaç gönderi oluşturulur, takip ve iptal akışı denenir.
Maliyeti ne belirler?
Çalışma kalem kalem tekliflendirilir. Fiyatı etkileyenler: kullanılacak kargo firması sayısı, kapıda ödeme ve iade gönderisi kurulum ihtiyacı, mevcut sipariş adreslerinin ayrıştırılması (eski siparişlerdeki serbest metin adresler daha çok emek ister), barkod yazıcısı entegrasyonu ve ekibin eğitimi. Kargo ücretlerinin kendisi (Navlungo ve kargo firmalarıyla yaptığınız sözleşme) bu çalışmanın dışındadır; yalnızca eklentinin kurulumu ve operasyonun kurgusu tekliflendirilir.
Operasyon ekibine öneriler
- Gönderi oluşturmadan önce sipariş ekranındaki adres uyarılarına bakın; adres düzeltmesi paket yola çıkmadan çok daha ucuzdur.
- Desi tahminli (ürün boyutu eksik) gönderileri onaylamadan önce kutu ölçüsünü kontrol edin.
- Gün sonunda “durumu güncellenmemiş” ve “iade edilecek” gönderilerin listesini gözden geçirin.
- Yeni ürün eklerken boyut ve ağırlık alanlarını doldurmayı iç prosedür haline getirin; desi hatalarının çoğu buradan kaynaklanır.
- Müşteri verisinin Navlungo’ya iletildiğini gizlilik metninizde belirtin.
Gönderi maliyetini yönetmek
Kargo maliyeti, e-ticaret marjını en çok fark edilmeden etkileyen kalemlerden biridir. Desi ve ağırlık hesabını doğru yapmak, paket ölçülerini ürün kartında tutmak ve uygun boyutta koli kullanmak maliyeti düşürür. Kargo ücretini müşteriye nasıl yansıtacağınıza (sabit, ağırlığa göre, belirli tutarın üzerinde ücretsiz) bilinçli karar verin ve bu kararın sepet tutarına etkisini izleyin. Hasar ve iade kargosu maliyetlerini de ayrı kalem olarak takip edin.
Sık sorulan sorular
Kargo ücretini eklenti hesaplar mı?
Hayır. Navlungo’nun yurt içi servisi fiyat teklifi vermez; müşteriye gösterilen nakliye ücreti, CS-Cart’taki kendi nakliye yöntemlerinizden gelir. Genellikle sözleşmeli fiyatlarınıza göre bölge ya da desi tablosu kurulur.
Aynı gün teslimat yapabilir miyim?
Hayır; test edilen hesaptaki kargo firmalarından hiçbiri aynı gün teslimatı desteklemediği için bu özellik yoktur.
Gönderiyi yanlış oluşturdum, iptal edebilir miyim?
Gönderi “Teslim Alınacak” ya da “Önizleme” durumundayken sipariş ekranından iptal edilebilir ya da düzenlenebilir. Yaklaşık bir dakika sonra kargo firması etiketi ürettiğinde Navlungo değişiklikleri reddeder; bu aşamadan sonra iptal, Navlungo ile kargo firması arasındaki bir konudur.
Yurt dışına gönderi yapabilir miyim?
Hayır; bu eklenti yalnızca yurt içi gönderiler içindir. Yurt dışı gönderi Navlungo’da farklı bir ürün ve farklı bir servistir.
Kapıda ödemeli sipariş nasıl işaretlenir?
Ayarlarda “henüz ödenmedi” anlamına gelen ödeme yöntemi numaralarını girersiniz. Liste boşsa hiçbir sipariş kapıda ödemeli sayılmaz; bu bilinçlidir, çünkü ödenmiş bir sipariş için kapıda ödemeli gönderi açmak parayı iki kez tahsil etmek demektir.
Teklif ve ön görüşme
Kargo entegrasyonu; sözleşmelerin, adres standardının, desi kurallarının, barkod yazıcısının ve eşitleme görevinin birlikte doğru kurulmasını gerektirir. SoftCrafter, CS-Cart’ın resmi partneri olarak bu parçaları sizin için tek bir proje olarak yürütür: eklenti kurulumu, il-ilçe seçicileri, yetkiler, cron kurulumu ve test gönderileri. Çalışma kalem kalem tekliflendirilir; teklifiniz ön görüşmeden sonra 1 iş günü içinde hazır olur ve formu bıraktığınızda sizi 15 dakika içinde ararız. Başka kargo çözümleri için Mr.Courier Kargo Takibi eklentimize ve genel kargo entegrasyonu sayfamıza bakabilir, eklentinin Türkçe dokümantasyonunu inceleyebilirsiniz.
