Hindistan'da kargo entegrasyonları: CSV yüklemeleri ile kurye API'lerini karşılaştırarak neyi otomatikleştirip neyi manuel bırakacağınızı belirleyin; ayrıca takip olayları için pratik bir kontrol listesi içerir.

Sipariş hacmi küçükken, kargo güncellemeleri hızlı kontroller, bir elektronik tablo ve kurye ile birkaç mesajla halledilebilir. Siparişler büyüdükçe, küçük aksaklıklar toplanır: etiketler geç oluşturulur, alımlar kaçırılır ve takip statüsü güncel kalmaz.
Denklem tanıdık: müşteriler "Siparişim nerede?" diye sorar. Destek operasyonu sorar. Operasyon bir portala bakar. Birisi otomatik güncellenmesi gereken bir durumu elle günceller.
Entegrasyon, sisteminizin gönderi verilerini (adres, ağırlık, COD, fatura değeri) gönderebilmesi ve gönderiye ait verileri (AWB numarası, alım onayı, takip taramaları, teslimat sonuçları) güvenilir şekilde geri çekebilmesi demektir. "Güvenilir" önemli çünkü bu her gün çalışmalı, sadece biri dosya yüklemeyi hatırladığında değil.
İşte bu yüzden bu karşılaştırma önemli:
Çoğu ekip "daha fazla teknoloji" istemez. Daha az gecikme, daha az manuel düzenleme ve herkesin güvenebileceği bir takip isterler. Takip taleplerini azaltırsanız (müşterilerden ve dahili ekiplerden), genellikle iadeleri, yeniden deneme maliyetlerini ve destek biletlerini de azaltırsınız.
Çoğu ekip basit bir rutinle başlar: alımları ayarla, etiketleri yazdır, takip ID'lerini bir tabloya yapıştır ve müşterilere güncelleme isteyince yanıt ver. Düşük hacimde işler ama Hindistan'da özellikle birden fazla kurye, COD ve tutarsız adres kalitesiyle uğraştığınızda çatlaklar hızlıca görünür.
Manuel adımlar tek başına büyük görünmez. Birisi bir kurye seçer, gönderiyi oluşturur, etiketleri indirir ve doğru paketin doğru airway bill (AWB) ile eşlendiğinden emin olur. Sonra bir başkası sipariş durumunu günceller, takibi paylaşır ve COD için teslim kanıtlarını kontrol eder.
En yaygın hata noktaları şunlardır:
NDR, Non-Delivery Report (Teslim Edilememe Raporu) demektir. Teslimat başarısız olduğunda (yanlış adres, müşteri müsait değil, reddetme, ödeme sorunu) oluşur. NDR ekstra iş yaratır çünkü kararlar gerektirir: müşteriyi aramak, adresi güncellemek, yeniden denemeyi onaylamak veya iadeye işaretlemek.
Operasyon ilk baskıyı hisseder. Destek öfkeli mesajları alır. Finans COD mutabakatında takılır. Durumlar değişmediğinde müşteriler sessizliği hisseder.
CSV yükleme, Hindistan'daki birçok kargo kurulumu için varsayılan başlangıç noktasıdır. Mağazanızdan veya ERP'den bir grup ödenmiş siparişi dışa aktarır, bunları bir kurye veya toplayıcı şablonuna uyarlar ve sonra dashboard'da dosyayı yükleyerek AWB ve etiketleri üretirsiniz.
Elde ettiğiniz şey sadeliktir. Genellikle mühendislik çalışması gerekmez ve bir gün içinde yayında olabilirsiniz. Düşük hacim veya öngörülebilir gönderimler (aynı alım adresi, az sayıda SKU, az istisna) için günlük bir CSV "yeterli" ve eğitmesi kolay olabilir.
Sorun, yüklemeden sonraki her şeydir. Çoğu ekip her gün aynı temizleme işlerini yapar: pin kodu veya telefon formatı şablona uymadığı için başarısız satırları düzeltmek, düzeltilmiş dosyaları tekrar yüklemek, kazara çoğaltmaları kontrol etmek ve takip numaralarını mağaza yönetimine geri kopyala‑yapıştır yapmak.
Sonra karmaşık kısım gelir: istisnaları (adres sorunları, ödeme problemleri, RTO riski) e‑posta, arama ve kurye portalları arasında kovalama ve durumu birden çok yerde güncelleme, çünkü kurye panosu sizin kayıt sisteminiz değildir.
Gizli maliyet zaman ve tutarsızlıktır. Farklı kuryeler farklı sütunlar ve kurallar bekler, bu yüzden "tek CSV" birden fazla versiyona ve spreadsheet geçici çözümlerine dönüşür. Ve güncellemeler gerçek zamanlı olmadığı için, destek genellikle gecikmeleri sadece bir müşteri şikayet ettiğinde öğrenir.
Tam bir kurye API kurulumu, sisteminiz ile kurye sistemlerinin doğrudan konuşması demektir. Dosya yüklemek yerine sipariş ve adres detaylarını otomatik gönderirsiniz, bir etiket alırsınız ve kimse birçok portalı kontrol etmeden takip güncellemelerini çekmeye devam edersiniz. Bu genellikle kargonun günlük bir operasyon görevi olmaktan çıkıp güvenilir altyapı gibi davranmaya başladığı noktadır.
Çoğu ekip kurye API entegrasyonuna üç temel işlem için başlar: rezervasyon, etiketler ve takip. Tipik yetenekler arasında gönderi oluşturup anında AWB almak, kargo etiketi ve fatura verisi üretmek, alım talep etmek (destekleniyorsa) ve takip taramalarını neredeyse gerçek zamanlı çekmek bulunur.
Bu temel işlemlerden sonra NDR durumu ve adres sorunları gibi istisnaları da daha temiz ele alabilirsiniz.
Getiri basittir: daha hızlı sevk, daha az kopyala‑yapıştır hatası ve daha net müşteri güncellemeleri. Bir sipariş saat 14:00'te ödendiyse, sisteminiz siparişi otomatik olarak rezerve edebilir, etiketi yazdırabilir ve dakikalar içinde takip numarasını gönderebilir; CSV dışa aktarma ve yeniden yükleme beklemeden.
API entegrasyonları "kur ve unut" değildir. Kurulum, test ve devamlı bakım için zaman planlayın.
Yaygın emek kaynakları:
Bu tuhaflıklara erken plan verirseniz, kurulum düzgün ölçeklenir. Vermezseniz, rezervasyon yapılmış ama alınmamış gönderiler veya izleme olayları yanlış eşlendiği için müşterilerin kafa karışıklığı yaşadığı durumlar oluşabilir.
Basit bir kural işe yarar: günde birçok kez gerçekleşen ve küçük bir hatanın büyük yeniden iş yaratmasına neden olduğu görevleri otomatikleştirin.
Hindistan'da bu genellikle rezervasyon, etiket ve takip güncellemeleri anlamına gelir. Bir yazım hatası veya kaçırılan bir tarama, takip eden birçok iletişime yol açabilir.
Manuel adımların hala yeri vardır. Hacim düşük olduğunda, istisnalar sık olduğunda veya kurye süreçleri otomasyon için yeterince tutarlı değilse bir şeyi manuel bırakın.
İş akışına göre pratik bir ayrım:
Bir kararı hızlıca vermek için tablo:
| Faktör | Manuel için uygun olduğu durum | Otomasyonun avantaj sağladığı durum |
|---|---|---|
| Günlük sipariş hacmi | ~20/gün altı | 50+/gün veya sık dalgalanmalar |
| Kurye sayısı | 1 kurye | 2+ kurye veya sık değişim |
| SLA baskısı | 3–5 günlük teslimat kabul edilebilir | Aynı/ertesi gün taahhütler, yüksek cezalar |
| Ekip büyüklüğü | Adanmış operasyon personeli | Operasyon/destek rollerini paylaşan ekip |
Basit bir kontrol noktası: ekibiniz aynı veriye iki kez dokunuyorsa (siparişi kurye portalına kopyala‑yapıştır, sonra tekrar tabloya), o adım güçlü bir otomasyon adayıdır.
Daha az "siparişim nerede?" mesajı istiyorsanız, takibi tek bir durum olarak değil bir olay zaman çizelgesi olarak ele alın. Bu Hindistan'da önemlidir; aynı gönderi hub'lar, yeniden denemeler ve iadeler arasında gidip gelebilir.
Ekip ve müşterilerin aynı hikayeyi görmesi için bu aşamaları yakalayın:
Her olay için aynı temel alanları saklayın: timestamp, location (şehir ve hub varsa), raw status text, normalized status, reason code ve courier reference/AWB. Hem ham hem normalleştirilmiş değerleri saklamak denetimler ve kurye itirazlarında işleri kolaylaştırır.
Birçok kargo entegrasyonu sıkıcı nedenlerle başarısız olur: eksik telefon numaraları, tutarsız ağırlıklar veya hangi sistemin "gerçeğin kaynağı" olduğuna dair net karar eksikliği. Bir API'ye dokunmadan önce, her sipariş için her zaman sahip olacağınız asgari verileri kilitleyin.
CSV ile de çalışacak bir tabanla başlayın. Bu alanları güvenilir şekilde dışa aktaramazsanız, bir API yalnızca hataların daha hızlı olmasını sağlar:
Sonra kuryeden ne beklediğinizi tanımlayın, çünkü bunlar her şeyin "kulp"ları olur. En azından saklayın: gönderi ID'si, AWB numarası, kurye adı veya kodu, etiket referansı ve alım tarihi veya penceresi.
Bir kararı netleştirmek haftalarca süren karışıklığı önler: gönderi durumu için tek bir doğruluk kaynağı seçin. Ekip kurye portalını kontrol edip sisteminizi geçersiz kılarsa, müşteriler bir şeyi görürken destek başka bir şeyi söyleyecektir.
Herkesi hizada tutacak basit bir eşleme planı:
Bunu Koder.ai gibi bir araç içinde inşa ediyorsanız, bu alanları ve eşlemeleri erken aşamada birinci sınıf modeller olarak ele alın ki dışa aktarım, takip ve geri alma ikinci kurye eklediğinizde bozulmasın.
En güvenli yükseltme yolu, tek bir büyük kesinti yerine bir dizi küçük geçiştir. Entegrasyon sıkılaşırken operasyon gönderimi yürütmelidir.
Gerçekten kullanacağınız kuryeleri seçin, sonra hangi eylemlere şimdi ihtiyaç duyduğunuzu ve hangilerinin sonra geleceğini doğrulayın: gönderi rezervasyonu, takip, NDR yönetimi ve iadeler (RTO). Bu önemli çünkü her kurye durumları farklı adlandırır ve farklı alanlar sağlar.
Rezervasyon veya etiket oluşturmadan önce takip olaylarını sisteminize çekin ve sipariş yanında gösterin. Bu düşük risklidir çünkü paketlerin nasıl oluşturulduğunu değiştirmez.
AWB ile olayları çekebildiğinizden emin olun ve AWB eksik veya yanlış olduğunda ne yapacağınızı yönetin.
Küçük bir iç durum modeli oluşturun (pickup, in‑transit, NDR, delivered) ve kurye durumlarını buna eşleyin. Ayrıca alınan her ham olay yükünü tam olarak olduğu gibi kaydedin.
Müşteri "teslim gösteriyor ama almadım" dediğinde, ham olaylar desteğin hızlı yanıt vermesine yardımcı olur.
Kolay kısımları otomatikleştirin: NDR'ı tespit edin, bir kuyruğa atayın, müşteriyi bilgilendirin ve yeniden deneme pencereleri için zamanlayıcılar ayarlayın.
Adres değişiklikleri ve özel durumlar için manuel geçersiz kılma bırakın.
Takip kararlı hale geldikten sonra API rezervasyonunu, etiket üretimini ve alım isteklerini ekleyin. Bunu kurye bazında yayınlayın ve birkaç hafta CSV yolunu bir yedek olarak bırakın.
Gerçek senaryolarla test edin:
Çoğu kargo bileti sadece "siparişim nerede?" değildir. Bunlar uyuşmayan beklentilerdir: sisteminiz bir şey söylüyor, kurye başka bir şey, müşteri üçüncü bir şeyi görüyor.
Yaygın bir tuzak durum metninin standart olduğunu varsaymaktır. Aynı kilometre taşı bölgeler, hizmet tipleri veya hub ifadeleri boyunca farklı ifadelerle görünebilir. Tam metne göre eşleme yaparsanız, gösterge panonuz ve müşteri mesajlarınız sapar.
Gecikme ve ekstra takip yaratan hatalar:
Basit bir örnek: bir müşteri paketin "iade edildiğini" söylüyor. Sisteminiz sadece "NDR" gösteriyorsa, NDR sebebini ve yeniden deneme geçmişini saklamış olsaydınız müşteri temsilcisi tek bir mesajla cevap verebilirdi.
Başarı ilan etmeden önce entegrasyonu operasyon ve destek ekibinin yoğun kullandığı şekilde test edin. Bir kurye durum güncellemesi gecikmeli gelirse veya doğru detayları içermeden gelirse, güncelleme olmamasıyla aynı sorunu yaratır.
Farklı pincode ve ödeme tiplerinde en az 10 gerçek siparişte "bir gönderi, uçtan uca" tatbikatı yapın. Bir sipariş seçin ve şu soruların yanıtlanma süresini ölçün:
Çoğu boşluğu yakalayan hızlı kontrol listesi:
İç ekranlar inşa ediyorsanız, ilk versiyonu sıkıcı tutun: bir gönderi arama kutusu, temiz bir zaman çizelgesi ve iki buton (manuel not ve geçersiz kılma).
Koder.ai gibi araçlar bu operasyon panosunu hızlıca prototiplemenize ve hazır olduğunuzda kaynak kodunu dışa aktarmanıza yardımcı olabilir. Eğer sonra keşfetmek isterseniz, koder.ai olarak görünür.
Orta ölçekli bir D2C marka günde yaklaşık 20 siparişle başlar, çoğunlukla bir metro bölgesine gönderim yapar. İki kurye ortağı kullanırlar. Süreç basittir: siparişleri dışa aktar, CSV'yi günde iki kez yükle, ardından takip numaralarını mağaza yönetimine kopyala‑yapıştır yap.
150 sipariş/gün ve üç kurye ile bu rutin çatlamaya başlar. Müşteriler "paketim nerede?" diye sorar ve destek üç portalı kontrol etmek zorunda kalır.
En kötü kısım NDR'lar. Teslimat denemesi başarısız olur, kurye birisi arar ve takip WhatsApp zincirine dönüşür. Yeniden denemeler kaçırılır ve küçük bir gecikme iptaller ve iadelerle sonuçlanır.
Otomatik olarak olayları senkronize eden bir kurulumla değişirler. Artık her gönderi güncellemesi tek bir yerde iner ve ekip ekran görüntüleri yerine tek bir kuyruğun üzerinden çalışır.
Günlük değişiklikler:
Her şey otomatik değil. Kenar PIN kodlar veya yoğun sezonda kapasite sorunları için hâlâ manuel kurye değiştirme yaparlar. Müşteri adres düzeltmesi için aradığında, bir insan doğrulama yapar ve sonra yeniden deneme tetiklenir.
İlk 2–4 hafta içinde neye ihtiyacınız olduğunu kararlaştırın. En büyük kazanç genellikle güvenilir takip ve daha az "siparişim nerede?" biletinden gelir, her özelliği ilk günde yapmak değil.
Ağrılarınızla eşleşen bir başlangıç kapsamı seçin:
Kod yazmadan önce dahili olarak kullanacağınız dili kilitleyin. Olay kontrol listenizi yazın (pickup, in‑transit, NDR, delivered) ve her kurye durumunu kendi durumlarınızdan birine eşleyin. Bunu atlarsanız, beş farklı "in transit" varyantı ve müşteri bildirimleri, NDR görevleri veya sipariş tamamlama kuralları için net olmayan kurallar elde edersiniz.
Güvenli bir yayım şöyle görünür: bir kurye, bir hat (veya bir depo), sonra genişletme.
Yeni akışınızı kısa süre CSV ile paralel çalıştırın ki operasyon AWB, etiket ve takip güncellemelerini karşılaştırabilsin. Basit bir geri dönüş planı tutun: API çağrısı başarısız olursa, dispatch'i engellemek yerine manuel rezervasyon için bir görev oluşturun.
Hızlı ilerlemek isterseniz, kurye API entegrasyonunu Koder.ai ile prototipleyin: olay depolama tablosunu, durum eşleme kurallarını ve küçük bir operasyon panosunu (sipariş veya AWB ile arama, son olay, sonraki aksiyon) tanımlayın. Ekip beklendiği şekilde davranınca kaynak kodunu dışa aktarın ve yeniden denemeler, loglama ve erişim kontrolleri ile sertleştirin.
İyi bir ilk versiyon "tam" olan değil. Tek kuryeyle uçtan uca çalışan, temiz olayları olan, NDR için net sahiplik belirlenmiş ve operasyonun şu anda neye dikkat etmesi gerektiğini gösteren günlük bir görünümü olan sürümdür.
CSV yüklemeleri, hacim düşükse (örneğin günde ~20 sipariş altında), tek kurye kullanılıyorsa ve istisnalar nadiren gerçekleşiyorsa yeterli olabilir. Ayrıca bir API kapalıyken iyi bir yedek yol olarak iş görür. Risk şudur: her kaçırılan adım (gecikmiş yükleme, yanlış şablon, kopyala‑yapıştır hatası) destek takiplerine ve gecikmiş sevkiyata dönüşür.
Genellikle günde 50+ sipariş, 2+ kurye kullanımı veya sık NDR/yeniden deneme gördüğünüzde bir kurye API'sine geçmek kendini amorti eder. Daha hızlı rezervasyon ve etiketleme, neredeyse gerçek zamanlı takip ve daha az manuel güncelleme sağlarsınız. Ana maliyet, kurye farklılıkları ve durum eşlemesi için kurulum ve sürekli bakım olacaktır.
Başlangıçta standartlaştırmanız gerekenler:\n\n- Tekil sipariş ID'si (hiçbir zaman yeniden kullanılmamalı)\n- Tam teslimat adresi (isim, pincode, şehir, eyalet, eğer topluyorsanız landmark)\n- Doğrulanmış formatta telefon numarası (e‑posta isteğe bağlı)\n- Ürün/gönderi bilgileri (SKU, adet, ağırlık; varsa ebatlar)\n- Ödeme bilgileri (COD miktarı, ön ödemeli bayrağı)\n\nBu alanlar dışa aktarımda tutarsızsa, bir API CSV'den daha hızlı ve daha sık hata verir.
En az şunları saklayın:\n\n- Kurye adı/kodu\n- Kurye gönderi ID'si (varsa)\n- AWB numarası\n- Etiket referansı/metadatası\n- Alım tarihi/penceresi (alım talep ettiyseniz)\n\nBunlar takibi çekmek, sorunları uzlaştırmak ve desteğe hızlı cevap vermek için kullandığınız “saplardır.”
Tek bir durum yerine bir zaman çizelgesi takip edin:\n\n- Alım planlandı/denendi/onaylandı (ve başarısızsa sebep)\n- Taşınma içi taramalar (ilk tarama, hub taramaları, istisnalar, dağıtıma çıkıyor)\n- NDR oluştu (sebep kodu, yapılan işlem, sonraki deneme/iadeye karar)\n- Teslim edildi (zaman ve varsa delil detayları)\n\nHer olay için zaman damgası, konum, ham durum metni, normalleştirilmiş durum, sebep kodu ve AWB saklayın.
NDR'ı bir süreç gibi ele alın:\n\n- NDR sebep kodunu ve oluştuğu zamanı kaydedin\n- Gönderiyi bir iç kuyruğa atayın ve sahibini belirleyin\n- Alınan kararı (müşteriyi arama, adres düzeltme, yeniden deneme veya iade) kaydedin\n- Bir sonraki deneme tarih/saatini ve sonuçlarını takip edin\n\nAdres değişiklikleri ve riskli COD yeniden denemeleri için manuel bir müdahale seçeneği bırakın, böylece otomasyon zararlı tekrarlar yaratmasın.
Küçük bir iç durum seti tanımlayın (Created, Picked Up, In Transit, Out for Delivery, Delivered, NDR, Returned). Her kurye olayını bunlardan birine eşleyin, ama ham kurye durum metnini ayrı saklayın. Sadece tam metne göre eşleme yapmayın—kuryeler bölge, hizmet tipi ve hub ifadelerinde farklılık gösterir.
Aşamalar halinde yapın:\n\n1. Takip olaylarını sisteminize çekin (salt okunur)\n2. Durumları normalleştirin ve denetimler için ham yükleri saklayın\n3. NDR tespiti + kuyruk + bildirim ekleyin (manuel müdahale ile)\n4. Ancak bundan sonra rezervasyon, etiket ve alım isteklerini otomatikleştirin\n\nCSV'yi birkaç hafta yedekte tutun ki sevkiyat hiç aksamasın.
Hatalar için varsayılan olarak plan yapın:\n\n- Geçici hatalar için geri çekilme (retry) stratejileri kullanın\n- Oran limitlerini yönetin (istekleri yavaşlatın, spam yapmayın)\n- Geç veya sıra dışı gelen olayları uzlaştırın\n- Her isteği/yanıtı kaydedin ve idempotent davranış sağlayın ki çoğaltma olmasın\n- Bir operasyon yedeği belirleyin (manuel rezervasyon görevi veya geçici CSV çalıştırma)\n\nBu, sessiz takip boşluklarının destek biletlerine dönüşmesini engeller.
Süreçte ve veri tarafında önlemler alın:\n\n- Sipariş/parça başına benzersiz bir gönderi anahtarı oluşturun ve zorunlu kılın\n- Yeniden denemeler ikinci bir gönderi yaratmasın diye rezervasyonu idempotent yapın\n- Baskı/tarama iş akışları: AWB'nin pakete eşlendiğini sevkiyat öncesi doğrulayın\n- AWB yeniden kullanımını engelleyin ve çoğulları otomatik olarak işaretleyin\n\nBirçok “kayıp” gönderi aslında bir kimlik karışmasından kaynaklanır, kurye hatasından değil.