Kargonomi Kargo Entegrasyonu
Kategori: Kargo Versiyon: 1.0.0
Kargonomi, birden fazla kargo şirketini tek API'den kullanmanızı sağlayan kargo agregatörüdür. Anlaşmalı kargo şirketleri arasında fiyat karşılaştırması ve gönderi oluşturma yapabilirsiniz.
Desteklenen Özellikler
- Çoklu kargo şirketi (Aras, Yurtiçi, MNG, Sürat, PTT, UPS, Kolay Gelsin, Hepsijet vb.)
- Fiyat karşılaştırma
- Gönderi oluşturma
- Takip numarası alma
- Sipariş onaylandığında otomatik kargo oluşturma
- Müşteriye kargo takip bildirimi
ℹ️ Kargonomi entegrasyonu üzerinden kargo etiketi (PDF) üretilmez. Etiketlerinizi Kargonomi panelinden alabilirsiniz.
1. Ön Hazırlık — Kargonomi Panelinden Bilgileri Alın
- app.kargonomi.com.tr üzerinden hesabınıza giriş yapın.
- Ayarlar → API bölümüne gidin.
- API Token değerini kopyalayın. Partner hesabı kullanıyorsanız X-App-Key değerini de alın.
- Depo (Warehouse) ID'sini, kullandığınız depoyu seçerek not edin.
2. Eklentiyi Yapılandırın
- Sol menüden Eklenti Mağazası sayfasına gidin ve Kargonomi kartındaki Eklentiyi Yapılandır butonuna tıklayın. (Aynı sayfaya Kargo Entegrasyonları listesinden de ulaşabilirsiniz.)
- Aşağıdaki alanları doldurun:
| Alan | Açıklama |
|---|---|
| API Token | Kargonomi API token'ı (zorunlu) |
| X-App-Key (opsiyonel) | Yalnızca partner hesapları için |
| Depo ID (Warehouse ID) | Gönderim yapılacak depo numarası (zorunlu) |
| Test ortamını kullan | Canlıya geçmeden açık |
| Sipariş onaylandığında otomatik kargo oluştur | Açıkken sipariş onaylandığında gönderi otomatik oluşturulur |
| Varsayılan Kargo Firması | Otomatik oluşturmada kullanılacak firma. Aşağıya bakın |
| Müşterilere kargo takip bildirimi gönder | Takip numarası oluştuğunda müşteriyi bilgilendirir |
- Entegrasyonu aktif et anahtarını açın, ardından Ayarları kaydet ve Bağlantıyı test et.
Varsayılan Kargo Firması
Bu ayar tüm gönderi akışınızı belirler:
| Seçenek | Davranış |
|---|---|
| Siparişte Seçim Yapın | Her sipariş için kargo firmasını siz seçersiniz (aşağıdaki akış) |
| Otomatik (En Uygun Fiyat) | En düşük fiyatlı teklif otomatik seçilir |
| Belirli bir firma (Aras, Yurtiçi, MNG, Sürat, PTT, UPS, Kolay Gelsin, Hepsijet) | Her gönderi bu firmayla oluşturulur |
3. Sipariş Üzerinde Kullanım
- Sipariş detayında Kargo firması seçimi kartına gidin.
- Teklifleri yenile butonuna tıklayın → anlaşmalı kargo firmalarının fiyat teklifleri listelenir.
- Uygun teklifte Seç ve oluştur deyin.
Takip numarası gönderi oluştuktan sonra kartta görünür.
ℹ️ Bu kart sağlayıcıdan bağımsızdır; Kargonomi ve Geliver teklifleri aynı listede gösterilir.
Sık Karşılaşılan Sorunlar
"Depo bulunamadı (404)": Depo ID yanlış girilmiş veya hesabınızda artık tanımlı değil. Kargonomi panelinden aktif depo listenizi kontrol edin.
"Fiyat dönmedi": Hedef adres bilgileri eksik. Sipariş alıcı adresinde şehir, ilçe ve posta kodunun dolu olduğundan emin olun.
Sipariş detayında teklif göremiyorum: Varsayılan Kargo Firması ayarı Siparişte Seçim Yapın dışında bir değerdeyse gönderi seçim yapmadan oluşturulur. Teklifleri görmek istiyorsanız bu ayarı Siparişte Seçim Yapın olarak değiştirin.
Etiket bulamıyorum: Kargo etiketleri panelde üretilmez; etiketlerinizi Kargonomi panelinden yazdırın. Sorun sürerse Kargonomi destek (destek@kargonomi.com.tr).