E-Ticarette Kargo Entegrasyonu Nasıl Kurulur?

Kargo entegrasyonu siparişin hazırlandıktan sonra manuel olarak kargo paneline yeniden girilmesini önler ve tracking bilgisini merkezi sisteme taşır.

Sağlıklı entegrasyon yalnız barkod üretmek değil; paket, taşıyıcı, takip numarası ve teslimat statüsünü sipariş yaşam döngüsüyle ilişkilendirmektir.

Shipment Modeli

Bir sipariş bir veya birden fazla pakete bölünebilir. Bu nedenle shipment entity siparişten ayrı modellenmelidir.

Kargo Barkodu

Paket oluşturulduğunda taşıyıcıdan barkod veya shipment number alınabilir ve depo çıktısında kullanılabilir.

Adres Validation

Eksik şehir, ilçe veya telefon bilgisi entegrasyon hatası yaratabilir. Kargoya gönderilmeden önce adres alanları doğrulanmalıdır.

Tracking Number

Takip numarası müşteriye ve satış kanalına otomatik aktarılabilir.

Status Update

Kargoya verildi, transferde, dağıtımda ve teslim edildi gibi durumlar API veya webhook ile alınabilir.

Retry ve Hata Yönetimi

Kargo servisi geçici erişilemez olduğunda barkod oluşturma işlemi kontrollü retry edilmelidir.

Kargo Reconciliation

Sistemde gönderilmiş görünen fakat taşıyıcıda kayıt bulunmayan paketler dönemsel kontrolle tespit edilebilir.

Operasyon KPI’ları

• Barkod üretme hatası
• Kargoya teslim süresi
• Teslimat süresi
• Başarısız teslimat
• Kayıp paket
• Tracking uyuşmazlığı

Operasyon Mimarisi Nasıl Kurulmalı?

E-Ticarette Kargo Entegrasyonu Nasıl Kurulur? konusu gerçek bir e-ticaret operasyonunda ele alınırken Shipment Modeli, Kargo Barkodu ve Adres Validation birbirinden bağımsız modüller olarak düşünülmemelidir. Sipariş, ürün, müşteri, ödeme, stok ve shipment kayıtlarının hangi sistemde authoritative olduğu açıkça tanımlanmalıdır. Aynı bilgi birden fazla sistemde değiştirilebiliyorsa conflict ve veri tutarsızlığı riski oluşur. Bu nedenle her ana veri alanı için system of record belirlenmesi ve diğer kanalların bu kaynaktan beslenmesi önemlidir.

Entegrasyon katmanında başarılı senaryolar kadar hata davranışı da tasarlanmalıdır. Pazaryeri veya ödeme API’sinin yanıt vermemesi, kargo servisine ulaşılamaması, duplicate sipariş, stok uyuşmazlığı veya geç gelen webhook gibi olaylar normal production senaryolarının parçasıdır. Geçici hatalar queue ve kontrollü retry ile yönetilebilir; yan etkili işlemlerde idempotency veya benzersiz business key kullanılması duplicate kayıt riskini azaltır. Belirli deneme sayısından sonra çözülemeyen işler ise operasyon ekibinin görebileceği exception kuyruğuna taşınmalıdır.

Operasyonun sağlığı yalnız toplam satışla ölçülmemelidir. Sipariş işleme süresi, stok uyuşmazlığı, ödeme başarısı, fulfillment gecikmesi, API hata oranı, iade süresi ve manuel müdahale sayısı birlikte izlenmelidir. Teknik log ile business metriğinin aynı dashboard’da ilişkilendirilebilmesi, örneğin siparişlerin ERP’ye neden aktarılmadığını veya belirli kanalda stok hatasının neden yükseldiğini daha hızlı açıklamayı sağlar. Bu yapı e-ticareti kanal bazlı manuel işlerden çıkarıp ölçülebilir ve ölçeklenebilir operasyon sistemine dönüştürür.

E-Ticaret Teknik Kontrol Listesi

• System of record tanımlandı mı?
• Sipariş ve stok idempotent işleniyor mu?
• API timeout ve retry politikası var mı?
• Entegrasyon hataları merkezi loglanıyor mu?
• Reconciliation kontrolü yapılıyor mu?
• Operasyon exception kuyruğu var mı?
• Kritik KPI’lar dashboard’da izleniyor mu?

Reconciliation ve Exception Yönetimi

E-Ticarette Kargo Entegrasyonu Nasıl Kurulur? kapsamında production sisteminin sağlıklı çalıştığını yalnız başarılı API response veya panelde görünen sipariş sayısıyla değerlendirmek yeterli değildir. Özellikle Shipment Modeli, Kargo Barkodu ve Adres Validation arasında periyodik reconciliation yapılmalıdır. Kaynak sistemde bulunan sipariş, stok, ödeme, iade veya shipment kayıtlarının hedef sistemde doğru ID, tutar ve durumla karşılığı olup olmadığı otomatik kontrollerle karşılaştırılabilir. Böylece entegrasyon teknik olarak hata üretmese bile eksik aktarım, duplicate kayıt veya yanlış status mapping gibi silent failure türleri tespit edilebilir.

Exception yönetiminde her problemin aynı kuyruğa düşmesi yerine ticari etkisine göre sınıflandırılması daha verimlidir. Ödeme alınmış fakat ERP’ye aktarılmamış sipariş, negatif stok, yanlış fiyat, kargo etiketi üretilememesi veya refund uyuşmazlığı yüksek öncelikli vaka olabilir. Geçici teknik hatalar otomatik retry edilebilirken veri veya iş kuralı kaynaklı problemler insan incelemesine yönlendirilmelidir. Her exception kaydında ilgili sipariş veya SKU, kaynak sistem, hata nedeni, son deneme zamanı ve yapılan aksiyon tutulduğunda operasyon ekibi aynı problemi tekrar araştırmak zorunda kalmaz.

Finansal ve operasyonel doğrulama birlikte ele alınmalıdır. Sipariş toplamı ile ödeme tahsilatı, refund ile iade kaydı, satılan adet ile stok hareketi ve shipment ile kargo statüsü dönemsel olarak karşılaştırılabilir. Bu kontroller dashboard üzerinde yalnız toplam hata sayısı olarak değil çözülmemiş kritik vaka, ortalama çözüm süresi, tekrar eden hata ve kanal bazlı uyuşmazlık şeklinde izlenirse yönetim hangi sürecin gelir veya müşteri deneyimi açısından risk ürettiğini daha hızlı görebilir.

Sıkça Sorulan Sorular

Her kargo firması aynı API yapısını mı kullanır?

Hayır. Adapter katmanı farklı taşıyıcıları ortak modele bağlamak için kullanılabilir.

Takip numarası otomatik gönderilebilir mi?

Entegrasyon destekliyorsa e-ticaret sitesi ve pazaryerlerine aktarılabilir.

Sipariş ile shipment aynı şey midir?

Hayır. Tek sipariş birden fazla shipment içerebilir.

Kargo entegrasyonu için queue gerekli mi?

Yüksek hacim ve retry gerektiren sistemlerde faydalıdır.

İlgili İçerikler

• API-First Geliştirme: Backend’i Ayrıştırmak, Uygulamayı Çoklu Kanal Yapmak
• Marketplace Intelligence Nedir? Satıcı, Fiyat, Yorum ve Marka Riskini Tek Ekranda Ölçmek
• Web Sitesi Yenileme Stratejileri: Audit, Refactor, Incremental Migration