Kargo Entegrasyonu ile Sipariş Sürecini Hızlandırma

Kargo entegrasyonu, e-ticaret panelinizden kargo firmalarının sistemlerine doğrudan bağlanarak; etiket oluşturma, takip numarası atama, stok düşme ve müşteriye SMS/e-posta bildirimi gönderme işlemlerinin elle müdahale olmadan gerçekleşmesini sağlar. Bu yazıda, entegrasyonun nasıl kurulduğunu, hangi süreçleri otomatize ettiğini ve işletmeniz için doğru çözümü nasıl seçeceğinizi anlatıyoruz.

Kısaca: Kargo entegrasyonu, sipariş aldığınız anda kargo firması sistemine veri gönderir, etiket basar ve takip numarasını paneline yazar. Elle veri girişi, yazdırma ve takip sürelerini dakikalara indirerek hata oranını minimize eder.

Kargo entegrasyonu ne işe yarar?

Entegrasyon, panelinizdeki "Kargoya Ver" butonuna bastığınızda arka planda şu zinciri tetikler: sipariş verileri (alıcı adresi, boyut, ağırlık, ödeme türü) kargo firmasının API servisine gönderilir, firma barkodlu etiketi ve takip numarasını döndürür, sistem bu numarayı siparişe işler ve müşteriye otomatik bildirim gider. Böylece her sipariş için kargo firmasının portalına girip form doldurmak, etiketi indirip yazdırmak, takip numarasını kopyalayıp paneline yapıştırmak zorunda kalmazsınız.

Hangi kargo firmaları ve özellikler desteklenir?

Türkiye pazarında yaygın kullanılan Yurtiçi Kargo, Aras Kargo, MNG Kargo, UPS ve Kargonomi gibi firmaların API altyapıları entegre edilebilir. Her firmanın sunduğu servis farklılıkları (kapıda ödeme limiti, kutu boyut kısıtlamaları, teslimat süresi, iade entegrasyonu) panelde önceden tanımlanır. Örneğin kapıda ödeme (nakit/kart) sunan firmalarda tahsilat limiti ve komisyon oranı firmana özel olarak girilir; bu sayede müşteri ödeme yöntemini seçtiğinde sistem uygun kargo firmasını otomatik önerir veya atar.

Otomatize edilen adım adım süreç

Sipariş onayı: Ödemesi tamamlanan sipariş "Hazırlanıyor" statüsüne alınır.
Veri hazırlığı: Ürün ağırlık/ebatları, varyant bilgileri ve adres doğrulaması (il/ilçe/semot mahalle eşleşmesi) yapılır.
API isteği: Sistem kargo firmasına JSON/XML formatında istek atar.
Etiket ve takip no: Firma barkodlu PDF/PNG etiketi ve takip numarası döndürür.
Panel güncelleme: Sipariş "Kargoda" statüsüne geçer, takip numarası yazılır.
Müşteri bildirimi: SMS (Netgsm vb.) ve/veya e-posta ile takip linki gönderilir.
Manifest/Toplu kapatma: Gün sonu kuryeye teslim edilecek paket listesi (manifest) tek tıkla alınır.

Manuel süreçle entegrasyonun farkı

İşlem	Manuel (Portal)	Entegre (API)
Etiket oluşturma	Dakikalar (giriş, form, yazdırma)	Saniyeler (tek tık / otomatik)
Adres hatası riski	Yüksek (kopyalama yanlışı)	Düşük (doğrulama kuralları)
Takip numarası girişi	Elle, ayrı adım	Otomatik yazılır
Gün sonu manifest	Portaldan indirme	Panelden tek tıkla
İade/Değişim etiketi	Yeni sipariş gibi açılır	Mevcut siparişten üretilir

Sık yapılan hatalar ve önleme yolları

Ürün ağırlık/ebat girilmemiş: Kargo firması "hatalı boyut" hatası döndürür. Çözüm: Ürün girişinde zorunlu alan yapın veya varsayılan paket tanımla.
Adres bileşenleri eksik: Mahalle/sokak bilgisi olmadan API hata verir. Çözüm: Adres doğrulama (PTT/Google API) entegrasyonu veya en az il/ilçe/mahalle zorunluluğu.
Kapıda ödeme limiti aşıldı: Müşteri nakit seçti ama tutar firma limitinin üzerinde. Çözüm: Panelde limit kontrolü koyun, aşıldığında kredi kartı/BKM yönlendirmesi yapın.
Test modunda canlıya geçiş unutuldu: API anahtarları (client_id, secret, endpoint) testten canlıya değiştirilmezse etiket gelmez. Çözüm: Canlıya alma kontrol listesine bu maddeleri ekleyin.

Kargo entegrasyonu kurulum checklist

Kargo firmasından API kullanıcı adı/şifre, client_id, secret ve endpoint (test/canlı) bilgilerini alın.
Panelde "Kargo Ayarları" alanına bu kimlikleri girin, bağlantı test edin.
Her ürün/ varyant için ağırlık (kg) ve kutu boyutları (cm) girin; yoksa varsayılan paket atayın.
Kapıda ödeme (nakit/kart) kullanacaksanız firma limit ve komisyon oranlarını tanımlayın.
İade/değişim senaryosu için "İade Etiketi" şablonunu test edin.
SMS şablonunda takip linki değişkeni ({tracking_url}) doğru geliyormu kontrol edin.
İlk 10-20 siparişte uçtan uca akışı (etiket basım → kurye teslim → takip güncelleme) izleyin.

Pazaryeri siparişlerinde kargo entegrasyonu

Trendyol, Hepsiburada ve N11 gibi pazaryerleri kendi kargo sözleşmeleriyle (Trendyol Express, HB Lojistik vb.) çalışır. Bu siparişler için panelinizden etiket basamazsınız; pazaryeri panelinden etiket alıp kargoya verirsiniz. Ancak kendi web sitenizden gelen siparişlerde yukarıdaki entegrasyon tam otomatizasyon sağlar. Çok kanallı satış yapan işletmelerde; pazaryeri siparişleri panele çekildikten sonra, kendi kargo sözleşmenizle gönderim yapacaksanız (ör. marka mağazası modeli) entegrasyon yine işinizi görür.

AS Dijital altyapısında kargo entegrasyonu

Hazır e-ticaret paketimizde Yurtiçi, Aras, MNG, UPS ve Kargonomi için hazır API entegrasyonları standart gelir. Tek paket fiyatına (yıllık 40.000 TL, KDV dahil; 3 ve 6 aylık paketler de mevcut) dahil olan modülle; ürün ağırlık/ebat tanımı, kapıda ödeme limitleri, manifest alma, iade etiketi üretimi ve SMS bildirimi (Netgsm) tek panelden yönetilir. Mevcut Ideasoft, Ticimax veya ikas altyapınızdan taşıma yaparsanız kargo ayarlarınız da tek tıkla aktarılır.

Sonuç: Hangi aşamada entegrasyona geçmelisiniz?

Günlük 20-30 siparişin üzerindesiniz ve etiket basmak, takip numarası girmek iş gücünüzün büyük kısmını alıyorsa entegrasyona geçme vakti gelmiştir. Hata oranını sıfıra indirmek, kurye bekletme süresini kısaltmak ve müşteriye anlık bilgi vermek için API entegrasyonu artık bir lüks değil, operasyonel bir zorunluluktur. Altyapınız bu yeteneği sunmuyorsa, entegrasyonlu bir çözüme geçiş planlamak karlılığınızı doğrudan etkiler.

İlgili içerikler: Ayakkabı e-ticaret sitesi, Gıda e-ticaret sitesi, Trendyol Entegrasyonu: Stok ve Sipariş Senkronu Nasıl Çalışır?, Paket ve fiyat bilgisi (hemen satın al).

Sık sorulan sorular

Kargo entegrasyonu için teknik bilgi gerektir mi?

Hayır. AS Dijital gibi hazır altyapılarda API anahtarlarını panele girmek yeterlidir. Kod yazmaya veya sunucu ayarı yapmaya gerek kalmaz; entegrasyon arayüzünden test ve canlı mod seçimi yapılır.

Birden fazla kargo firmasını aynı anda kullanabilir miyim?

Evet. Panelde birden fazla kargo firması tanımlayıp; ödeme yöntemine (kapıda ödeme/kredi kartı), bölgeye veya ürün türüne göre otomatik atama kuralları oluşturabilirsiniz.

Kapıda ödeme (nakit/kart) entegrasyonu nasıl çalışır?

Kargo firmasının API'si, sipariş tutarı ve ödeme tipi gönderildiğinde tahsilat limitini ve komisyonu kontrol eder. Limite uygunysa etiket üretir, uygun değilse hata döndürür; panel bu hatayı yakalayıp müşteriye alternatif ödeme yönlendirmesi yapabilir.

İade sürecinde de entegrasyon işler mi?

Evet. Müşteri iade talebi oluşturduğunda, panelden "İade Etiketi Oluştur" denildiğinde aynı kargo firması API'si üzerinden iade barkodu ve takip numarası üretilir. Müşteriye otomatik SMS gider.

Kargo firması API'si değişirse entegrasyon bozulur mu?

Kargo firmaları API versiyonlarını güncellediklerinde (yılda bir iki kez) altyapı sağlayıcısının (AS Dijital vb.) güncelleme yapması gerekir. Hazır paketlerde bu güncellemeler yıllık paket kapsamında otomatik yapılır, sizden bir işlem istenmez.

Uluslararası kargo (DHL, UPS, FedEx) entegrasyonu da var mı?

UPS entegrasyonu hazır pakette mevcuttur. DHL ve FedEx için de API dokümantasyonu uygun olursa eklenti olarak geliştirilebilir; standart pakette UPS uluslararası servisleri (UPS Standard, Express) desteklenir.