Kargo Entegrasyonu Rehberi: Tek Tıkla Gönderi, Etiket, Takip ve İade Kodu

Kargo entegrasyonu, e-ticaret operasyonunun en çok zaman kazandıran parçasıdır: siparişten tek tıkla gönderi, termal yazıcıdan etiket, müşteriye otomatik takip numarası, teslimat durumunun panele düşmesi, iade kodu üretimi. Entegrasyonsuz sitede her gönderi kargo firmasının paneline elle girilir; sipariş başına 3 ile 5 dakika, adres hatası ve yanlış desi riski. Bu yazı, kargo entegrasyonunun nasıl çalıştığını, kurulum için gerekenleri, gönderi oluşturma ve etiket akışını, takip ve bildirimleri, iade kodunu, birden fazla firma yönetimini, pazaryeri kargolarını, tahsilatlı gönderiyi, hata ve istisnaları ve ölçümü anlatıyor.

Nasıl çalışır?

1. Sözleşme ve API: Kargo firmasıyla kurumsal sözleşme; firma API kullanıcı adı, şifre ve müşteri kodu verir. Bunlar sistemde kargo ayarlarına girilir; test gönderisiyle doğrulanır.
2. Gönderi oluşturma: Sipariş ekranında "kargo oluştur": sistem alıcı adı, telefon, adres (il, ilçe, açık adres), paket sayısı, desi ve ağırlık, ödeme türü (gönderici ödemeli ya da tahsilatlı) bilgisini firmaya iletir; firma takip numarası ve etiket verisi döner.
3. Etiket: Termal etiket yazıcısından (10x10 ya da 10x15 cm) barkodlu etiket; pakete yapıştırılır. Toplu seçimle onlarca etiket tek seferde basılır.
4. Bildirim: Takip numarası siparişe yazılır; müşteriye "kargoya verildi" e-postası ve SMS'i takip bağlantısıyla gider.
5. Takip: Sistem belirli aralıkla (ya da firmanın bildirimiyle) gönderi durumunu sorgular: dağıtımda, teslim edildi, teslim edilemedi, iade. Sipariş durumu buna göre güncellenir; teslim edildi durumu sipariş kapanışını ve yorum isteğini tetikler.
6. İade: Müşteri iade talebi açınca sistem firmadan iade kodu alır; müşteri şubeye kodu verir, gönderi işletmeye gelir; iade takip numarası siparişe bağlanır.

Kurulum için gerekenler

• Kurumsal sözleşme ve API bilgileri (her firma için ayrı)
• Gönderici adresi ve iletişim bilgisi (firmaya kayıtlı)
• Termal etiket yazıcısı (birkaç bin TL) ve etiket ruloları
• Tartı (desi ve ağırlık için; ürün kartına önceden girilirse tartı gerekmez)
• Ürün kartlarında paketlenmiş ölçü ve ağırlık (desi otomatik hesaplanır)
• Sistemde firma seçim kuralları (bölge, desi, tutar, ürün tipi)

Ürün kartına ölçü girmek entegrasyonun görünmez ön şartı: desi yanlışsa fatura yanlış çıkar; sistem desiyi ürün ölçüsünden hesaplar, çoklu üründe birleştirir.

Birden fazla firma

İki firmayla çalışan işletmede sistem, gönderiyi kurala göre atar: bölgeye (bir firma belirli illerde hızlı ve ucuz), desiye (ağır kargoda farklı firma), tutara (yüksek tutarda imzalı teslim veren firma), ürün tipine (kırılgan), tahsilatlı gönderiye (aktarımı hızlı firma). Kural yoksa elle seçim. Her firmanın etiket formatı farklıdır; sistem hepsini basar. Firma performans raporu (teslim süresi, hasar, teslim edilemeyen oranı) sözleşme yenilemede kullanılır.

Pazaryeri siparişlerinin kargosu

Pazaryeri siparişleri çoğunlukla pazaryerinin anlaşmalı kargosuyla ve pazaryerinin ürettiği etiketle gönderilir; satıcının kendi sözleşmesi kullanılmaz. Sistem, pazaryeri entegrasyonu üzerinden bu etiketi çeker ve aynı yazıcıdan basar; sipariş kargoya verildi bilgisi pazaryerine geri bildirilir. Bazı pazaryerlerinde satıcı kendi kargosunu seçebilir; kural sistemde tanımlanır.

Tahsilatlı gönderi (kapıda ödeme)

Kapıda ödeme sunuluyorsa kargo firmasıyla tahsilatlı gönderi sözleşmesi; gönderi oluştururken tahsilat tutarı ve ödeme türü (nakit, kart) iletilir. Firma tahsilatı belirli sürede aktarır; sistem tahsilat raporunu siparişlerle eşleştirir (hangi kapıda ödeme siparişinin parası geldi). Aktarım süresi ve hizmet bedeli kargo anlaşması yazısında.

Hata ve istisnalar

• Adres hatası: Firma API'si il/ilçe eşleşmezse gönderi reddeder; sistem adresi il ilçe seçiciyle aldığı için hata azalır, kalan hatalar panelde görünür ve düzeltilir.
• API kesintisi: Firma sistemi çalışmıyorsa gönderi kuyruğa alınır, sonra tekrar denenir; acil durumda ikinci firma.
• Desi uyuşmazlığı: Firma gönderiyi tartınca farklı desi çıkarsa fatura farklı olur; aylık fatura kontrolü.
• Teslim edilemeyen: Firma iki üç deneme sonrası şubede bekletir; sistem müşteriye bilgilendirme gönderir; süresinde alınmayan gönderi iade döner, kapıda ödemede kayıp.
• Hasar ve kayıp: Panelde ayrı liste; firmaya açılan kayıt numarası siparişe yazılır; tazmin süreci kargo hasar ve kayıp yazısında.

Operasyon akışı

Sabah: gece gelen siparişler seçilir, toplu kargo oluşturulur, etiketler basılır, toplama listesiyle paketlenir. Öğleden sonra: kurye alımı, sistemde "kargoya verildi" toplu güncelleme (etiket basımıyla otomatik olabilir). Akşam: teslimat durumları ve teslim edilemeyen liste. Haftalık: firma performans raporu. Aylık: kargo faturası ile sistem gönderi listesi karşılaştırması (yanlış desi, mükerrer ücret).

Ölçüm

Gönderi başına hazırlık süresi, kargoya verilme süresi (siparişten kargoya kaç saat), teslim süresi (firma ve bölge bazlı), teslim edilemeyen oranı, hasar ve kayıp oranı, iade kodu kullanım oranı, kargo faturası hata oranı.

Bir müşterimiz (ev ürünleri, günlük 120 gönderi) entegrasyon öncesi kargo paneline elle giriş için günde 6 saat harcıyordu; entegrasyon ve termal yazıcı sonrası toplu etiket 20 dakika, adres hatası kaynaklı iade gönderileri aylık 14'ten 2'ye düştü.

Sık hatalar

• Ürün kartına ölçü girmeden desi tahmini
• Test gönderisi yapmadan canlıya geçmek
• Tek firma; API kesintisinde gönderi durur
• Kapıda ödeme tahsilat raporunu siparişlerle eşleştirmemek
• Pazaryeri siparişini kendi kargosuyla göndermek (pazaryeri kuralı ihlali olabilir)
• Aylık kargo faturasını kontrol etmemek
• Termal yazıcı yerine ofis yazıcısı ve makas

Yaygın kargo firmalarıyla entegrasyon e-ticaret sistemimizde hazır; özellikler sayfası. İlgili: kargo anlaşması, desi optimizasyonu. Terimler: kargo entegrasyonu, kargo takibi.