E-Ticarette Kargo ve Lojistik API Entegrasyonu

Yurt içinde Yurtiçi Kargo, Aras, MNG, Sürat, PTT ve Hepsijet, Sendeo gibi yeni nesil dağıtım firmaları API sunar; yurt dışı gönderiler için DHL, FedEx ve UPS bağlanır. Birden fazla firma aynı sistemde tek soyutlama katmanında birleştirilebilir; hangi siparişin hangi firmadan çıkacağı bölge, desi veya fiyat kuralıyla otomatik belirlenir.

Doğrudan API erişimi için kargo firmasıyla kurumsal gönderi anlaşması gerekir; müşteri numarası, kullanıcı adı veya token gibi kimlik bilgileri bu anlaşma üzerine tanımlanır. Henüz anlaşmanız yoksa entegratör platformlar üzerinden anlaşmasız gönderiyle başlayıp, hacim büyüyünce kendi anlaşmanıza ve doğrudan entegrasyona geçmek yaygın ve makul bir yoldur.

Evet. Her sipariş için bağlı firmaların API'lerinden desi ve bölgeye göre anlık fiyat sorgulanır; kural motoru fiyat, teslim süresi ve geçmiş performansa göre firmayı otomatik seçer, isterseniz manuel onay adımı eklenir. Çoklu kargo kurgusu hem tek firmaya bağımlılığı kaldırır hem de firma bazlı performans raporuyla fiyat pazarlığında elinizi güçlendirir.

Kargo firması webhook destekliyorsa durum değişimi anında sisteminize düşer; bu en verimli yöntemdir. Desteklemeyen firmalarda açık gönderiler zamanlanmış aralıklarla sorgulanır (polling) ve teslim edilenler sorgu kuyruğundan çıkarılır. İki modelde de sipariş ekranı, müşteri hesabı ve bildirimler aynı anda güncellenir; yöntem farkı müşteriye hiç yansımaz.

Dayanıklı mimaride sipariş kaybolmaz: istek artan bekleme süreleriyle otomatik tekrar denenir (retry), sonuç alınamazsa gönderi kuyruğa alınır veya alternatif firmaya yönlendirilir (fallback). Kesinti süresince kuyruk birikir, bağlantı dönünce kendiliğinden işlenir. Başarısız çağrılar hata koduyla loglanır ve eşik aşıldığında yöneticiye uyarı gider; arıza görünmez kalmaz.

Entegratör platformlar düşük hacimde hızlı ve pratiktir; ancak gönderi başına işlem maliyeti, veri üzerinde sınırlı kontrol ve özel akışlarda (çoklu depo, iade kuralları, ERP bağlantısı) kısıtlar getirir. Kendi kargo anlaşmaları olan ve günlük hacmi büyüyen işletmelerde doğrudan entegrasyon birim maliyeti düşürür; kaynak kod ve veri sizde kalır. Doğru seçim hacme, anlaşma avantajınıza ve akışınızın özgünlüğüne göre yapılır.

Evet. Sipariş anında adres, Google Maps veya Başarsoft gibi harita API'leriyle otomatik tamamlanıp doğrulanır; il-ilçe-mahalle uyumsuzluğu daha ödeme adımında yakalanır. Koordinat kaydedilirse şehir içi hızlı teslimatta en yakın şube veya kurye otomatik atanabilir. Adres doğrulama, iade kargo maliyetini ve teslimat gecikmesini kaynağında azaltan en yüksek getirili adımlardan biridir.

Evet. DHL, FedEx ve UPS entegrasyonlarında ürün açıklaması, GTİP/HS kodu, değer ve fatura bilgileri gönderi açılırken API'ye otomatik iletilir; eksik beyan kaynaklı gümrük beklemeleri ve iadeler belirgin azalır. Ülke bazlı adres ve posta kodu format doğrulaması da sipariş anında yapılır, hatalı uluslararası adres baştan engellenir.

Evet. Pazaryerlerinden gelen siparişler tek panelde toplanır; barkod, etiket ve takip tüm kanallar için aynı akıştan yönetilir. Pazaryerinin kendi dağıtım ağıyla gönderilen siparişler ayrıştırılır, kendi kargo anlaşmanızla çıkanlar entegrasyondan geçer. Böylece çok kanallı operasyonda hangi gönderinin nereden çıktığı tek ekranda görünür ve stok-kargo senkronu bozulmaz.

Evet. Kargo API'si tahsilatlı gönderiyi destekliyorsa kapıda ödeme tutarı barkodla birlikte otomatik iletilir ve tahsilat durumu gönderi bazında takip edilir. Kargo firmasından gelen toplu ödemelerin siparişlerle eşleştirilmesi ise ayrı bir mutabakat sürecidir; bu tarafın otomasyonunu banka entegrasyonu ve otomatik mutabakat rehberinde ayrıntılı anlattık.

Evet. Sevkiyat, teslimat ve maliyet verisi ERP'nizle çift yönlü senkronize edilir; irsaliye ve stok düşümü kargo akışıyla aynı anda işler. Kurumsal tarafta SAP kullanıyorsanız sevkiyat verisinin SAP'a nasıl bağlandığını SAP entegrasyonu rehberinde anlattık. ERP'deki gönderici, depo ve ürün kartları entegrasyonun veri kaynağı olarak kullanılır; çift kayıt oluşmaz.

Evet, en verimli kurgu budur: sipariş kargoya verildiğinde GİB e-fatura entegrasyonuyla fatura otomatik kesilir; sevkiyat ve kargo maliyeti Logo, Mikro veya Netsis gibi muhasebe programınıza otomatik aktarılır. Böylece sipariş-kargo-fatura-muhasebe zinciri tek akışta tamamlanır; ay sonunda elle fiş girme ve mutabakat yükü büyük ölçüde ortadan kalkar.

Evet. Müşteri iade talebi açtığında sistem otomatik iade barkodu üretip müşteriye iletir; iade gönderisi de aynı takip akışından izlenir. Depoya ulaşan iade, barkod okutmayla siparişe eşleşir; stok girişi ve iade onayı otomatik tetiklenir. Tersine lojistiğin dijitalleşmesi, iade sürecindeki "kargo nerede, param ne zaman iade edilir" çağrılarını ciddi ölçüde azaltır.

Tek firmayla temel barkod ve takip genellikle 1-3 haftada, çoklu firma, fiyat karşılaştırma ve raporlama içeren tam sistem 6-10 haftada devreye alınır. Maliyeti belirleyen kalemler; firma sayısı, uluslararası ihtiyaç, kuyruk/webhook altyapısı ve panel derinliğidir. Edge Bilişim bu projelerde çekirdek akışı (barkod + takip) önce canlıya alıp kalan modülleri sprint sprint ekleyerek yatırımın erken dönmesini sağlar.

Hazır eklentiler tek firmalı temel barkod ve takipte çoğu zaman yeterlidir; sınır, çoklu firma seçimi, retry/fallback, çoklu depo ve ERP bağlantısı gibi ihtiyaçlarda başlar. Bu noktaya gelen işletmelerde eklentinin üzerine kural yamamak yerine özel yazılım geliştirmeyle kendi entegrasyon katmanınızı kurmak, esneklik ve veri sahipliği açısından daha sağlıklıdır. Küçük hacimde eklentiyle başlamak ise tamamen makuldür.