Kargonomi Nedir, Nasıl Kullanılır? E-ticaret İçin Tam Rehber

Türkiye'de e-ticaret yapan herkesin er ya da geç karşılaştığı bir karar var: hangi kargo firmasıyla anlaşmalı, fiyatları nasıl pazarlık etmeli? Tek tek altı firmayla görüşmek hem zaman kaybı hem de operasyonel karmaşıklık yaratır. Kargonomi tam burada devreye giriyor.

Kargonomi Nedir?

Kargonomi, Türkiye'deki büyük kargo firmalarını tek API ve tek panel üzerinden birleştiren bir aggregator servisidir. Hangi kargo firmasının hangi durumda öne çıktığını Aras vs Yurtiçi vs MNG vs PTT karşılaştırmasında detaylandırdık. 2018'den beri faaliyette; 100 binin üzerinde aktif kullanıcısı var.

Kapsadığı kargo firmaları (2026):

• Aras Kargo
• Yurtiçi Kargo (kısmi)
• MNG Kargo
• PTT Kargo
• Sürat Kargo
• Hepsijet
• UPS Kargo
• Kolay Gelsin (Sendeo)

Pazaryeri (Trendyol, Hepsiburada) ile değil, doğrudan kargo firmalarıyla anlaşmalı çalışır.

Kargonomi'nin Avantajları

1. Toplu Pazarlık Tarifesi

Kargonomi'nin firmalarla yaptığı toplu anlaşmalar sayesinde küçük satıcı bile kurumsal tarifeye erişir. Tek başına Aras ile pazarlık yapsanız 130 ₺ olan gönderi, Kargonomi üzerinden 86 ₺.

2. Anlık Fiyat Karşılaştırması

Her gönderide 6 firmanın fiyatını gerçek zamanlı görürsünüz. Manuel seçim yapabilir veya "en ucuz" parametresiyle sistem otomatik karar verir.

3. Tek API, Tek Webhook

Kendi yazılımınızdan 6 firmaya entegre olmak yerine tek REST API ile tüm firmalara gönderi açabilirsiniz. Status güncellemeleri tek webhook'la gelir.

4. Bakiye Sistemi

Kargonomi'ye TL bakiye yüklersiniz; her gönderi otomatik bakiyeden düşer. Aylık fatura, ek dönem ödemesi yok.

5. Türkçe Destek

Resmi destek hattı, panel ve dokümantasyon Türkçe. API dokümanları açık ve sade.

Kargonomi Nasıl Açılır?

Adım 1: Hesap Açma

app.kargonomi.com.tr → Kayıt ol. Vergi numarası zorunlu — bireysel kullanım yok, işletme/şahıs şirketi gerekiyor. Kayıt sonrası e-posta doğrulama yapılır.

Adım 2: Bakiye Yükleme

Panel → Bakiye → minimum 100 TL. Havale/EFT veya kart ile yüklenir. Otomatik fatura kesilir.

Adım 3: Gönderici (Warehouse) Adresi

Panel → Depolar → "Yeni depo ekle". Burada:

• Yetkili adı, telefonu
• Açık adres
• İl/ilçe
• Vergi numarası ve vergi dairesi

bilgilerini girersiniz. Bu bilgiler her gönderide sistem tarafından otomatik kullanılır.

Adım 4: API Token (Opsiyonel)

Eğer kendi sisteminizden veya Kargopilot gibi bir SaaS'tan otomatik gönderi açacaksanız:

Panel → Profil → API → "Token oluştur". Bu token'ı şifreli saklayın. Kargopilot bu token'ı pgsodium AEAD ile sunucuda şifreleyip saklar.

Adım 5: İlk Gönderi

Panel → Yeni gönderi → alıcı bilgisi + paket bilgisi → fiyat karşılaştırması açılır → firma seç → barkod PDF üretilir → yazdır → kargoya ver.

Kargonomi API Üzerinden Otomasyon

Manuel kullanım küçük hacim için yeterli. Aylık 50+ gönderi yapan satıcılar için otomasyon kaçınılmaz. Temel akış:

POST /api/v1/shipments
{
  "shipment": {
    "buyer_name": "...",
    "buyer_phone": "5XX...",
    "buyer_address": "...",
    "buyer_state_id": 34,
    "buyer_city_id": 1077,
    "warehouse_id": 109615,
    "packages": [{ "desi": 1, "content": "..." }]
  }
}
↓
{ "data": { "id": 2497450, ... } }

Sonra:

GET /api/v1/shipment-price-comparison/2497450
↓
{
  "user_credit": 106.15,
  "shipping_provider_with_price": [
    { "id": 4, "name": "Aras Kargo", "price": 86.54 },
    { "id": 6, "name": "Hepsijet", "price": 87 },
    ...
  ]
}

POST /api/v1/confirm-shipping-price
{ "shipment_id": 2497450, "shipping_provider_id": -1 }  ← -1 = otomatik en ucuz
↓
Barkod PDF + takip numarası hazır.

Kargonomi'nin Sınırlamaları

Dürüst olmak gerekirse, mükemmel servis yok. Bilinmesi gerekenler:

1. Yurtiçi Kargo kısmi entegrasyon — bazı tarife paketleri görünmüyor.
2. API tutarsızlıkları — bazı endpoint'ler {data: [...]} döner, bazıları bare array. Entegre yazılım yapanlar bu farkları handle etmeli.
3. Dağıtım hız sözü vermez — fiyat ve operasyon Kargonomi'de, teslimat hız ve kalitesi kargo firmasında.
4. Yurtdışı gönderim sınırlı — sadece PTT KEPP üzerinden, gelişmiş seçenek yok.
5. Bakiye yetersizliği = anında durma — kart limiti gibi otomatik krediden çekme yok; bakiye sıfırlandı mı yeni gönderi açılmaz.

Kargopilot + Kargonomi Kombinasyonu

Kargopilot, Kargonomi'nin sunduğu API'nin üzerine WhatsApp katmanı ekler:

1. Müşteriden WhatsApp ile gelen adres mesajı parse edilir.
2. Kargonomi API'ye otomatik draft gönderi açılır.
3. Fiyat karşılaştırması alınır, otomatik en ucuz veya tercih edilen firma seçilir.
4. Barkod PDF üretilir, Supabase Storage'a yüklenir, signed URL ile sunulur.
5. Müşteriye WhatsApp'tan otomatik "Kargonuz hazır" mesajı gider.
6. Status değiştikçe (yola çıktı, teslim edildi) yeni bildirimler otomatik gönderilir.

Yani Kargonomi tek başına teknik altyapıyı sunar; Kargopilot bu altyapıyı operasyon zincirinin tamamına entegre eder. Tam akışın nasıl kurulduğunu e-ticaret kargo entegrasyonu rehberinde bulabilirsin.

Sonuç

Kargonomi, Türkiye e-ticaret operasyonunun olmazsa olmazı haline gelmiş bir aggregator. Doğrudan kargo firmasıyla çalışmaya kıyasla:

• Fiyatlar %30-50 daha düşük
• Entegrasyon 6 kat daha basit (tek API)
• Pazarlık yükü sıfır

Kendi başınıza Kargonomi panelinden manuel açmaktan, otomasyon katmanı eklemeye geçmek operasyonel olarak büyük sıçrama yaratır. Kargopilot bunu sağlayan SaaS çözümlerinden biridir; 14 gün deneme planıyla risksiz test edebilirsiniz.