Kargo API Entegrasyonu: Yurtiçi, Aras, MNG, Sürat ve PTT
Özet
Kargo API entegrasyonu, anlaşmalı olduğunuz kargo firmasının web servislerini sitenize ya da sipariş sisteminize bağlayarak gönderi kaydı, barkod, takip numarası ve iptal işlemlerini otomatikleştirmektir. API erişimi herkese açık değildir: kurumsal müşteri olarak şubenizden veya satış temsilcinizden web servis kullanıcı bilgisi istenir ve önce test ortamında çalışılır. Yurtiçi ve Aras Kargo'nun web servisleri SOAP tabanlıdır; MNG Kargo REST tabanlı ApiZone platformunu kullanır. Tipik akış: sipariş onayında gönderi kaydı oluşturulur, firmanın döndürdüğü kargo anahtarı/takip numarası siparişe yazılır, durum sorgusuyla sipariş güncellenir, iptal gerektiğinde iptal servisi çağrılır. Tek firma entegrasyonu genellikle 3–7 iş günü sürer.
Kargo API Entegrasyonu Nasıl Yapılır?
- 1
Web servis erişimi isteyin
Şubenizden veya kurumsal satış temsilcinizden web servis kullanıcı bilgisi ve test ortamı erişimi talep edin; kullanacağınız ödeme tiplerinin hesabınıza tanımlandığından emin olun.
- 2
Test ortamında gönderi oluşturun
Sipariş başına benzersiz anahtarla test gönderisi oluşturun ve dönen takip bilgisini doğrulayın.
- 3
Takip ve durum güncellemesini bağlayın
Takip numarasını siparişe yazın, müşteriye iletin ve durum sorgusunu periyodik çalışacak şekilde kurun.
- 4
İptal ve hata senaryolarını deneyin
İptal, hatalı adres, tekrar gönderim ve servis kesintisi durumlarında sistemin nasıl davrandığını test edin.
- 5
Canlıya geçin ve izleyin
Canlı kullanıcı bilgilerine geçin, ilk günlerin gönderilerini yakından izleyin ve hata kayıtlarını (log) açık tutun.
Kargo API Erişimi Nasıl Alınır?
Kargo firmaları web servislerini yalnızca anlaşmalı (kurumsal) müşterilerine açar. İlk adım, çalıştığınız şubeden veya kurumsal satış temsilcinizden web servis/API kullanıcı bilgisi talep etmektir. Bu bilgiler, gönderinin hangi müşteri hesabına ve hangi ödeme tipine (gönderici ödemeli, alıcı ödemeli) yazılacağını da belirler.
- Kurumsal müşteri numarası ve web servis kullanıcı adı/şifresi
- Test (sandbox) ortamı bilgileri — canlıya geçmeden önce tüm senaryolar burada denenir
- Kullanacağınız ödeme tiplerinin hesabınıza tanımlanması
- Firmanın güncel teknik dokümanı (alan adları ve zorunlu alanlar firmaya ve sürüme göre değişir)
Yurtiçi Kargo API
Yurtiçi Kargo'nun gönderi servisleri SOAP tabanlıdır: gönderi oluşturma, gönderi sorgulama ve iptal işlemleri ayrı servis metotlarıyla yapılır. Gönderi oluştururken sizin ürettiğiniz benzersiz bir kargo anahtarı ve fatura/sipariş anahtarı gönderilir; takip bu anahtar üzerinden yapılır. Ödeme tipi çoğunlukla size tanımlanan web servis kullanıcısına bağlıdır, bu yüzden farklı ödeme tipleri için farklı kullanıcı bilgisi istenebilir.
Aras Kargo API
Aras Kargo da SOAP tabanlı müşteri web servisleri sunar ve canlı ile test ortamı ayrıdır. Akış üç parçadan oluşur: sipariş/gönderi bildirimi, takip ve durum sorgusu, iptal. Gönderi bildirimi yapıldıktan sonra Aras tarafında oluşan takip bilgisi sorgu servisiyle geri alınıp siparişe yazılır; durumlar toplu sorguyla periyodik olarak güncellenebilir.
MNG Kargo API
MNG Kargo, API'lerini REST tabanlı ApiZone platformu üzerinden sunar ve ayrı bir test (sandbox) ortamı vardır. Sipariş oluşturma, barkod oluşturma, takip ve il/ilçe sorguları ayrı uç noktalardır. Erişim için kurumsal müşteri temsilcisi üzerinden başvuru yapılır; istemci kimlik bilgilerinin yanında müşteri numarası da gerekir.
Sürat Kargo ve PTT Kargo
Sürat Kargo ve PTT Kargo da anlaşmalı müşterilerine gönderi oluşturma ve takip servisleri sağlar. Teknik yapı, zorunlu alanlar ve test ortamı firmanın size ileteceği güncel dokümana göre belirlenir; entegrasyon akışı (gönderi kaydı → takip numarası → durum güncellemesi → iptal) diğer firmalarla aynıdır.
Doğru Entegrasyon Sırası
Hangi firma olursa olsun sağlam bir kargo entegrasyonu aynı sırayla kurulur. Bu sıra, aynı siparişin iki kez gönderiye dönüşmesini ve takip numarası olmayan sipariş kalmasını önler.
- Sipariş onayında gönderi kaydı — sipariş başına tek, benzersiz anahtarla (tekrar gönderim aynı kaydı oluşturmaz)
- Dönen kargo anahtarı / takip numarasının siparişe yazılması ve müşteriye iletilmesi
- Barkod/etiket yazdırma (desi ve ağırlık beyanı doğru girilmeli — yanlış desi fark faturası doğurur)
- Periyodik durum sorgusu ile sipariş durumunun güncellenmesi
- İptal ve iade senaryolarının test ortamında ayrıca denenmesi
Koli ölçülerinden desiyi ve ücretlendirilen ağırlığı hesaplamak için: Desi hesaplama aracı
Sık Sorulan Sorular
Kargo API kullanmak ücretli mi?
Web servis erişiminin bir ücreti olup olmadığı firmaya ve anlaşmanıza göre değişir; erişimi talep ederken temsilcinize sorun. Entegrasyonun geliştirilmesi ise ayrı bir iştir.
Birden fazla kargo firmasını aynı sitede kullanabilir miyim?
Evet. Her firma için ayrı entegrasyon yapılır; desi, bölge veya ürün tipine göre gönderiyi uygun firmaya yönlendiren bir kural da eklenebilir.
Hazır eklenti mi, özel entegrasyon mu?
WooCommerce gibi altyapılarda kargo firmalarının veya üçüncü tarafların eklentileri vardır ve standart ihtiyaç için yeterli olabilir. Sipariş sisteminiz özelse, birden çok firma ve özel kurallar varsa ya da pazaryeri siparişleriyle aynı akışta çalışmak istiyorsanız özel entegrasyon daha uygundur.
Firmanın teknik dokümanı nereden alınır?
Kargo firmaları güncel entegrasyon dokümanını web servis erişimi verdikleri müşteriye iletir. İnternette bulunan eski dokümanlar ve topluluk kütüphaneleri fikir verir ama alan adları ve zorunlu alanlar değişebileceği için resmî dokümana göre geliştirilmelidir.
Solman Digital
Bu rehber, gerçekleştirilen projelerden derlenen doğrudan deneyime dayanmaktadır. Konuya ilişkin sorularınız için doğrudan uzman erişimi sunuyoruz.
Kargo entegrasyonu: sabit kapsam, ₺4.900'den
Ücretsiz Araçlar
Rakamları Kendiniz Hesaplayın
Entegrasyon veya geliştirme kararı vermeden önce SolmanAI'nin ücretsiz hesaplama araçlarıyla mevcut durumunuzu analiz edebilirsiniz.