E-ticaret operasyonunun en zayıf halkası genellikle kargo aşamasıdır. Sipariş gelir, müşteri adresini paylaşır, sen bunu manuel olarak kargo firmasının paneline yazarsın, fiyatı kontrol edersin, barkodu basarsın, takip numarasını müşteriye iletirsin. Bu döngü her sipariş için 5–10 dakika alır. Aylık 300 sipariş yapan bir işletme için bu, 25–50 saatlik ek iş yükü demektir.
Bu rehberde, e-ticaret kargo entegrasyonunu sıfırdan nasıl kuracağını, hangi mimari seçeneklerin olduğunu ve günümüzde Türkiye'de en pratik çözümün ne olduğunu adım adım anlatıyoruz.
Kargo Entegrasyonu Tam Olarak Nedir?
Kargo entegrasyonu, sipariş bilgisinin (alıcı adresi, ürün, paket boyutu) bir yazılım sistemi üzerinden kargo firmasına otomatik iletilmesi ve karşılığında takip numarası + barkod PDF'inin geri alınması sürecidir.
Manuel akış:
Sipariş → Excel/defter → Kargo paneli → Adres yaz → Fiyat kontrol → Barkod indir → Yapıştır → Takip no kopyala → Müşteriye iletme
Entegre akış:
Sipariş → Sistem otomatik → Barkod PDF + takip no anında hazır → Müşteriye otomatik bildirim
Entegrasyon Seçenekleri
Türkiye'de e-ticaret işletmesinin önünde 3 ana yol var:
1. Kargo Firmasıyla Doğrudan API Entegrasyonu
Aras, Yurtiçi, MNG, PTT, Sürat, UPS gibi büyük firmaların her biri kendi REST/SOAP API'sini sunar. Avantajı: birebir veri akışı. Dezavantajı:
- Her firma farklı kimlik doğrulama, payload, hata kodu kullanır.
- Fiyat karşılaştırması yapamazsın — tek firmaya kilitlenirsin.
- Yeni firma ekleme = yeni entegrasyon = haftalarca dev iş.
- Webhook'lar her firmada ayrı şekilde, status enum'ları farklı.
Bir e-ticaret bütçesini bu kadar mühendislik için harcayamaz — özellikle başlangıç aşamasındaysan.
2. Çoklu-Firma Aracı Servisi (Aggregator)
Türkiye'de en yaygını Kargonomi. Tek API ile 6+ kargo firmasına gönderi açar, fiyat karşılaştırması yapar, barkod üretir, webhook ile durum güncellemesi gönderir. Detaylı tanıtım için Kargonomi nedir, nasıl kullanılır? yazısına bak.
Avantajları:
- Tek token, tek payload formatı, tek webhook.
- Otomatik en ucuz seçimi → her gönderide cebinde para.
- Kullandığın fiyat zaten Kargonomi'nin firmalarla yaptığı toplu anlaşmadan geliyor — perakende fiyatın altında.
- Barkod PDF anında, takip URL'si hazır.
Dezavantajı: Servisin uptime'ı senin uptime'ın olur. Ama Kargonomi gibi yerleşik servisler için bu pratik bir risk değil.
3. SaaS + Aggregator (Tam Otomasyon)
Aggregator entegrasyonu API'yi çözer ama hâlâ:
- Müşteriden adresi nasıl alacaksın? (WhatsApp sipariş yönetimi)
- Veriyi sisteme nasıl gireceksin? (Sipariş takip sistemi kurma)
- Müşteriye barkod/takip nasıl ileteceksin? (Kargo bildirimi şablonları)
Bu son adımda Kargopilot gibi SaaS çözümleri devreye girer: WhatsApp'tan gelen mesajı otomatik adrese çözer, Kargonomi'ye paslar, barkodu hazırlar, müşteriye geri "kargonuz hazır" mesajı atar.
Toplam müdahale: 0 saniye.
Bir Entegrasyonda Olması Gereken Çekirdek Bileşenler
Mimariden bağımsız olarak, sağlam bir kargo entegrasyonu şunları içermeli:
- Token yönetimi — Kargonomi gibi servislerin API key'i. Düz metin saklamak ölümcül risk; Postgres + pgsodium AEAD şifreleme veya benzeri sırlama altyapısı şart.
- Adres normalize katmanı — il/ilçe ID eşleme. "Maltepe/İstanbul" string'i yetmez, kargo API'si numerik ID ister.
- Sender (depo/warehouse) yapısı — gönderici bilgisi her seferinde gönderilmemeli; depo ID'si referansıyla tek noktadan yönetilmeli.
- Webhook handler — kargo durumu güncellemesi sana push edilmeli; siz polling yapmamalısınız.
- İdempotency — aynı siparişin yanlışlıkla iki kere açılmaması için unique key (sipariş no + tarih hash'i vb.) ile koruma.
- Fiyat karşılaştırma cache'i — her gönderide tüm firmalara sormaktan kaçın; dakikalık önbellek.
- Barkod depolama — PDF'i Supabase Storage / S3'e yükle, signed URL ile sun.
WhatsApp + Kargo: Yeni Standart
2024'ten itibaren Türkiye e-ticaretinde küçük-orta ölçek satıcılar için adres alma kanalı %80 WhatsApp. Bu da yeni bir entegrasyon ihtiyacı doğurdu: WhatsApp mesajını kargoya çevirme.
İdeal akış:
Müşteri WhatsApp → "Ad: ..., Tel: ..., Adres: ..., İlçe: ..., İl: ..."
↓
Sistem mesajı parse eder → Kargonomi'ye paslar
↓
Barkod PDF + takip no oluşur
↓
Müşteriye "Kargonuz {firma} ile yola çıktı, takip: {no}" otomatik gider
Bu akışın elle yapılan versiyonunda her sipariş 8–12 dakika sürer. Otomatik versiyonda 5 saniye. Ayda 200 sipariş için yıllık geri kazanım: yaklaşık 400 saat.
Adım Adım: Kendi İşletmen İçin Kurulum
- Kargonomi hesabı aç. Vergi numaranı gir, depo (warehouse) bilgini ekle.
- API token oluştur (Profil → API anahtarı). Bu token sadece backend'inde saklanmalı.
- WhatsApp Business hesabı bağla. Cloud API (resmi) veya Baileys (dev) seçeneği var.
- Bir adres formatı belirle ve müşterilerine duyur:
Ad: ... Tel: ... Adres: ... İlçe: ... İl: ... - Otomasyon kuralı kur: mesaj geldiğinde otomatik mi gönderi açılsın, yoksa onay mı bekletilsin?
- Bildirim şablonlarını yaz: "Yola çıktı", "Teslim edildi" durumlarında müşteriye ne mesaj gitsin?
- Test et. Kendine bir test mesajı at, baştan sona akışı doğrula.
Sonuç
Kargo entegrasyonu artık opsiyonel değil; manuel kalan işletmeler hem zaman kaybediyor hem de müşteri deneyimi konusunda geride kalıyor. Doğru aggregator + WhatsApp otomasyon kombinasyonu ile aylık operasyon yükünü 30 dakikanın altına indirmek mümkün.
Kargopilot tam olarak bu boşluğu kapatıyor: WhatsApp → Kargonomi → barkod → müşteri bildirimi zincirini tek panelde yönetiyor. Anasayfadan detayları inceleyebilir, deneme planıyla 14 gün ücretsiz test edebilirsin.