Adım adım
- Geliver token’ını alın. Geliver panelinde Ayarlar → API Tokenları bölümünden bir token oluşturun.
- Eklentiyi doldurun. Eklentiler → Geliver Kargo. “API Token” ve “Gönderici adresi ID” zorunludur; “İade adresi ID” ve kendi kargo anlaşmanız varsa “Kendi kargo anlaşmanız (providerAccountID)” isteğe bağlıdır. “Geliver bağlantısını dene (adresleri listeler)” kayıtlı adreslerinizi ve ID’lerini gösterir.
- İlk denemede test modunu açın. “Test modu (gerçek etiket kesilmez)” işaretliyken gönderi oluşturulur ama gerçek etiket kesilmez. Akışı gördükten sonra işareti kaldırın.
- Kargo firmalarını eşleyin. Kargo → Kargo Firmaları’nda her firmanın “Kod” alanı gönderinin hangi firmaya gideceğini belirler (yurtici, aras, surat, ptt gibi). Listede olmayan firma için eklentideki “Listede olmayan firma için servis kodu” alanını kullanın.
- Gönderiyi oluşturun. Sipariş detayındaki “Durum ve kargo” kartında kargo firmasını seçip “Güncelle”ye basın, sonra “API ile gönderi oluştur (N desi)” deyin. Takip numarası yazılır ve “Kargo etiketi (PDF)” düğmesi çıkar.
- Siparişi Kargoda yapın. Gönderi oluşturmak sipariş durumunu değiştirmez. Paketi kargoya verince durumu “Kargoda” yapın; otomatik takip yalnızca bu durumdaki siparişlerde çalışır.
- Takibi izleyin. “Takibi güncelle” hareketleri anında çeker. Hareketler müşterinin sipariş sayfasında ve sipariş takip ekranında da görünür.
Otomatik ayarlar
- Gönderiyi kendiliğinden açmak: Kargo Ayarları → “Ne zaman oluşturulsun?”. Kapalı (düğmeyle elle), ödeme alındığında, sipariş “Hazırlanıyor” yapıldığında ya da “Kargoda” yapıldığında seçilebilir. Başarısız olursa panele “Otomatik gönderi oluşturulamadı” bildirimi düşer.
- Otomatik takip: kargodaki siparişler 2 saatte bir, her turda en fazla 25 sipariş sorgulanır. Bu iş sunucudaki görev zamanlayıcısıyla çalışır.
- Kendiliğinden teslim: “Kargo firması teslim edildi derse siparişi kendiliğinden Teslim Edildi yap” kutusu varsayılan olarak açıktır.
Desi nasıl hesaplanıyor?
Ürün desisi en × boy × yükseklik ÷ “Desi bölen” (varsayılan 3000) ile bulunur; ürüne desi yazdıysanız o kullanılır. Ağırlık için önce varyanttaki gram bilgisi (“500 gr” gibi), sonra ürün ağırlığı, ikisi de yoksa “Ağırlığı girilmemiş ürün için varsayılan kg” (0,5) alınır. Hacim desisi ile ağırlıktan büyük olan faturalanır, en az 1 desi. Takip numarası yokken sipariş ekranındaki “Desi” ve “Ağırlık (kg)” alanlarına yazıp “Ölçüyü kaydet” ile elle düzeltebilirsiniz.
Sık karşılaşılan hatalar
- “Alıcı adı, adresi ve telefonu eksik”: kargo firması eksik bilgili gönderiyi kabul etmez; siparişteki adresi tamamlayın.
- İl ya da ilçe tanınmadı: Geliver il ve ilçeyi ayrı ister; adresteki şehir “İl / İlçe” biçiminde olmalıdır.
- Firma değişti ama gönderi eski firmayla açıldı: firmayı değiştirdikten sonra önce “Güncelle”ye basın.
- Gönderiyi iptal etmek: “Gönderiyi iptal et” Geliver’da gönderiyi iptal eder ve takip bilgisini temizler; sonra firmayı seçip yeniden oluşturabilirsiniz.



