Shopify Aras Kargo Entegrasyonu Nasıl Yapılır?

Shopify Aras Kargo Entegrasyonu Nedir? Shopify Aras Kargo entegrasyonu, Aras Kargo’nun kurumsal API’sini veya bir entegratör yazılımı üzerinden Shopify mağazasına bağlayarak sipariş verisinin otomatik kargo kaydına, barkoda ve teslimat etiketine dönüştürülmesini sağlayan bağlantı sürecidir.

Aras Kargo, Türkiye’de resmi bir Shopify App Store uygulaması yayınlamaz; bağlantı kurumsal API veya çok kargolu entegratör uygulamalar üzerinden kurulur (Aras Kargo Kurumsal, 2025). Bu, Yurtiçi Kargo’ya kıyasla bir ek adım gerektirir ama şube yoğunluğu büyükşehirlerde yüksek olan mağazalar için tercih edilme nedenini değiştirmez. Kurumsal anlaşma sürecinin doğru yürütülmesi, entegrasyonun teknik tarafından daha kritik bir adımdır.

Aras Kargo entegrasyonunu Yurtiçi Kargo’dan ayıran en büyük fark bağlantı yöntemidir hazır uygulama yerine ya kurumsal API ya da üçüncü parti entegratör tercih edilir. Bu rehber her iki yolu da adım adım açıklar.

Aras Kargo ile Kurumsal Anlaşma Süreci Nasıl İşler?

Aras Kargo kurumsal anlaşma süreci, mağazanın tahmini aylık gönderi hacmini beyan ederek başvuru yapması ve Aras Kargo’nun bu hacme göre birim fiyat teklifi sunmasıyla ilerler; anlaşma imzalandıktan sonra API erişimi açılır.

Bu süreç bireysel gönderi hesabından farklıdır çünkü API entegrasyonu yalnızca kurumsal müşteri koduna tanımlanır. Aylık hacim beyanı düşük yapıldığında sonradan sözleşme revizyonu gerekebilir, bu yüzden gerçekçi bir tahminle başvuru yapılmalıdır.

1. Aras Kargo Kurumsal Satış ekibiyle görüşme talebi oluşturulur.
2. Şirket evrakları (vergi levhası, imza sirküleri) ve tahmini aylık hacim beyanı sunulur.
3. Birim kargo ücreti ve ödeme vadesi üzerinde anlaşmaya varılır, sözleşme imzalanır.
4. Aras Kargo API entegrasyon ekibi müşteri kodu ve API kimlik bilgilerini iletir.
5. Test ortamında örnek kargo kaydı oluşturularak entegrasyon doğrulanır.

İpucu: Kurumsal anlaşma görüşmesinde sadece birim fiyat değil, iade kargo ücreti ve toplama (pickup) saatleri de netleştirilmelidir. Geç saatte toplama yapan bir anlaşma, aynı gün kargoya çıkan sipariş oranını doğrudan yükseltir.

Kurumsal Anlaşma Görüşmesinde Hangi Sorular Sorulmalı?

Kurumsal anlaşma görüşmesinde birim fiyatın yanı sıra iade kargo ücreti, hasar tazminatı üst limiti ve sözleşme fesih şartları sorulmalıdır; bu üç madde sözleşme imzalandıktan sonra değiştirilmesi zor kalemlerdir.

Birim fiyat pazarlığı genelde aylık hacim beyanına göre şekillenir, ancak mağaza sahiplerinin çoğu iade kargo ücretini görüşme masasına getirmez. Giyim, ayakkabı veya elektronik gibi iade oranı yüksek kategorilerde satış yapan mağazalar için bu madde birim fiyattan daha belirleyici bir maliyet kalemidir.

İpucu: Görüşme sırasında son 3 aylık örnek fatura talep etmek, teklif edilen birim fiyatın diğer mağazalara kıyasla rekabetçi olup olmadığını değerlendirmenin en somut yoludur. Aras Kargo bu bilgiyi paylaşmasa da sektördeki benzer ölçekteki mağazalardan referans almak mümkündür.

Aras Kargo Shopify’a Hangi Yöntemlerle Bağlanır?

Aras Kargo Shopify’a iki yöntemle bağlanır: doğrudan kurumsal API entegrasyonu veya birden fazla kargo firmasını tek panelde birleştiren üçüncü parti entegratör uygulama. Her iki yöntem de kurumsal anlaşmanın tamamlanmış olmasını ön koşul olarak ister.

Doğrudan API entegrasyonu, mağazanın kendi geliştirici kaynağıyla Shopify webhook’larını Aras Kargo API’sine bağlamasını gerektirir; entegratör uygulama ise bu bağlantıyı hazır bir arayüzle sunar ve genelde aylık abonelik ücretiyle çalışır.

Kritik Not: Entegratör uygulama seçilirken uygulamanın Aras Kargo API’sinin güncel sürümünü desteklediği teyit edilmelidir. Eski API sürümüne bağlı kalan bazı entegratörler, Aras Kargo’nun barkod formatı güncellemelerinde geçici kesinti yaşayabilir.

Entegratör Uygulama Seçerken Hangi Sorular Sorulmalı?

Entegratör uygulama seçerken sorulması gereken üç soru şunlardır: uygulamanın Aras Kargo ile resmi API ortaklığı var mı, durum güncellemesi (webhook) ne sıklıkla geliyor ve destek ekibi Türkçe teknik destek sunuyor mu?

Resmi API ortaklığı olmayan bazı entegratörler, verileri manuel olarak periyodik senkronize eder bu da gerçek zamanlı bildirim yerine saatlik veya günlük gecikmeli güncellemeye yol açar. Yüksek hacimli bir mağaza için bu gecikme, müşteri memnuniyetsizliğine dönüşebilir.

Destek ekibinin teknik yeterliliği de kritik bir kriterdir. API hatası yaşandığında İngilizce dokümantasyona yönlendiren bir destek ekibi, Türkçe konuşan bir operasyon ekibi için çözüm süresini uzatır.

Barkod ve Etiket Entegrasyonu Nasıl Çalışır?

Barkod ve etiket entegrasyonu, Aras Kargo API’sinin her kargo kaydı için benzersiz bir barkod numarası üretip bu numarayı PDF etiket formatına gömmesiyle çalışır; etiket Shopify sipariş paneline yansıtılır ve doğrudan yazdırılabilir.

Bu mekanizma, şubede elle barkod yapıştırma ihtiyacını ortadan kaldırır. Barkod, Aras Kargo’nun kendi tarama sistemiyle uyumlu bir formatta (genelde Code 128) üretilir ve şube tarama cihazlarıyla doğrudan okunur.

Peki bu teknik detay neden önemli? Barkod formatı uyumsuzsa şube personeli elle kayıt girmek zorunda kalır, bu da teslimat süresini bir gün uzatabilir bu yüzden entegratör seçiminde barkod format uyumluluğu öncelikli kontrol maddesi olmalıdır.

Uzak Durulması Gereken Risk: Etiket PDF’inin çözünürlüğü düşükse veya termal yazıcı ayarına uygun boyutlandırılmamışsa barkod şubede okunamaz hale gelir. Etiket şablonunun termal yazıcı standardına (genelde 10x15 cm) uygun olduğu ilk kurulumda mutlaka test edilmelidir.

Aras Kargo Entegrasyonu Kaç Günde Devreye Alınır?

Aras Kargo entegrasyonunun toplam süresi, kurumsal anlaşma görüşmesinden canlı kargo kaydına kadar geçen süreçtir ve entegratör uygulama tercih edildiğinde ortalama 1-2 hafta, özel API geliştirmesi tercih edildiğinde 3-4 haftaya kadar uzayabilir.

Bu süre tahmini üç aşamadan oluşur: anlaşma ve evrak süreci, API kimlik bilgisi teslimi ve teknik entegrasyon kurulumu. En uzun aşama genelde anlaşma sürecidir çünkü Aras Kargo’nun kurumsal satış ekibi hacim ve fiyat pazarlığını birkaç görüşme turunda tamamlar.

Kritik Not: Sezonsal kampanya dönemleri (11.11, yılbaşı) öncesi entegrasyon başlatılacaksa süreç en az 4 hafta önceden planlanmalıdır. Kampanya dönemine yakın başvurularda kurumsal satış ve API ekiplerinin yoğunluğu nedeniyle onay süreleri uzayabilir.

Aras Kargo Entegrasyonunda Sipariş İptali ve İade Nasıl Yönetilir?

Sipariş iptali ve iade, kargo kaydı oluşturulduktan sonra Aras Kargo API’sinin “iptal” uç noktasına istek gönderilerek veya paket şubeye ulaşmadan önce durdurularak yönetilir; kargo şubeden çıktıktan sonra iptal işlemi mümkün olmaz, yalnızca iade süreci başlatılabilir.

Bu ayrım, mağaza sahibinin sipariş iptal taleplerini hızlı işlemesi gerektiğini gösterir. Sipariş onaylandıktan hemen sonra müşteri iptal talebi iletirse, kargo kaydı henüz şubeye teslim edilmemişse iptal API çağrısı sorunsuz sonuçlanır; teslim edilmişse süreç iadeye döner ve ek kargo maliyeti doğar.

Peki bu fark pratikte ne anlama geliyor? Müşteri hizmetleri ekibinin sipariş iptal taleplerini saatler içinde değil, mümkünse dakikalar içinde işleme alması, gereksiz iade kargo maliyetini önleyen tek etkin yöntemdir.

Aras Kargo Entegrasyonunda Test Süreci Nasıl Yürütülmeli?

Test süreci, canlıya geçmeden önce sandbox ortamında en az 5-10 örnek sipariş oluşturularak barkod üretimi, etiket formatı ve durum güncellemesinin uçtan uca doğrulanmasıyla yürütülmelidir; tek bir test siparişi çoğu hatayı ortaya çıkarmaya yetmez.

Test sürecinde farklı senaryolar denenmelidir: standart bir sipariş, birden fazla ürün içeren bir sipariş, farklı bir şehre giden sipariş ve iade senaryosu. Her senaryo farklı bir API parametresini tetiklediği için yalnızca tek bir basit sipariş testi, çok ürünlü siparişlerde çıkabilecek hataları gizleyebilir.

Peki bu kapsamlı test neden atlanıyor? Mağaza sahipleri genelde “bir sipariş çalıştıysa hepsi çalışır” varsayımıyla hareket eder, oysa API’nin farklı veri kombinasyonlarında farklı davranması yaygın bir entegrasyon riskidir.

Uzak Durulması Gereken Risk: Yalnızca tek ürünlü basit bir sipariş test edilip canlıya geçilmesi, kampanya döneminde gelen çok ürünlü siparişlerde barkod hatasının ilk kez gerçek müşteri siparişinde ortaya çıkmasına neden olabilir. Test senaryoları canlıya geçmeden önce mutlaka çeşitlendirilmelidir.

Aras Kargo Yurtiçi Kargo’dan Hangi Noktalarda Farklıdır?

Aras Kargo ile Yurtiçi Kargo arasındaki temel fark Shopify bağlantı yöntemidir; Yurtiçi Kargo’nun resmi App Store uygulaması varken Aras Kargo bağlantısı kurumsal API veya entegratör gerektirir.

Bu fark, teknik kaynağı olmayan küçük mağazalar için karar sürecini etkiler. Genel kargo firması karşılaştırması ve entegrasyon yöntemi seçim kriterleri Shopify kargo entegrasyonu rehberinde daha geniş kapsamda ele alınır; Yurtiçi Kargo’nun adım adım kurulum süreci ise Shopify yurtiçi kargo entegrasyonu rehberinde anlatılır.

Entegrasyon tamamlandıktan sonra takip numarasının müşteriye otomatik SMS veya e-posta ile ulaştırılması ayrı bir kurulum adımıdır ve kargo takip numarası otomatik oluşturma rehberinde işlenir.

Aras Kargo Entegrasyonunda Sık Karşılaşılan Teknik Hatalar Nelerdir?

En sık karşılaşılan teknik hata, API kimlik bilgilerinin süresinin dolması veya şifre değişikliği sonrası entegrasyon ayarlarının güncellenmemesidir; bu durumda kargo kaydı oluşturma isteği “yetkisiz erişim” hatasıyla reddedilir.

İkinci yaygın hata, sipariş verisindeki telefon numarası formatının Aras Kargo API’sinin beklediği formatla uyuşmamasıdır. Shopify checkout’ta uluslararası format (+90) ile girilen bir numara, API’nin yerel format (0 ile başlayan 10 haneli) beklentisiyle çakışabilir ve kargo kaydı oluşurken hata verebilir.

Üçüncü hata kaynağı, mağazanın birden fazla depo kullanması durumunda hangi depodan gönderim yapılacağının API isteğinde belirtilmemesidir. Depo bilgisi eksik gönderildiğinde Aras Kargo sistemi varsayılan depoyu kullanır, bu da yanlış depodan gönderim yapılmasına yol açabilir.

Aras Kargo Entegrasyonu Maliyetini Ne Belirler?

Aras Kargo entegrasyonunun toplam maliyeti üç kalemden oluşur: kurumsal anlaşma birim kargo ücreti, entegratör uygulama aboneliği (özel API tercih edilmediyse) ve olası geliştirici maliyeti. Bu üç kalem ayrı ayrı değerlendirilmeden yapılan bir karar, gerçek toplam maliyeti düşük göstermeye eğilimlidir.

Birim kargo ücreti hacme bağlı pazarlıkla belirlenirken, entegratör uygulama ücreti genelde aylık sabit bir taban ücret artı işlem başına küçük bir ek ücretten oluşur. Yüksek hacimli mağazalarda bu işlem başına ücret, aylık toplamda birim kargo ücretinden bağımsız ayrı bir maliyet kalemine dönüşür.

Özel API geliştirmesi tercih edildiğinde ise bir kerelik proje maliyeti ödenir ama aylık işlem başına ek ücret oluşmaz. Uzun vadede yüksek hacimli mağazalar için bu model, entegratör aboneliğine kıyasla toplam maliyeti düşürebilir; düşük hacimli mağazalar için ise geliştirme maliyeti amortize olmayabilir.

İpucu: Toplam maliyeti karşılaştırırken 12 aylık projeksiyon yapılmalıdır. Entegratör aboneliğinin aylık ücreti düşük görünse de yıllık toplamda özel API geliştirme maliyetine yaklaşabilir; bu noktada hacim projeksiyonu karar için belirleyici olur.

Sık Sorulan Sorular

Aras Kargo’nun resmi Shopify App’i var mı? Hayır, Aras Kargo Shopify App Store’da resmi bir uygulama yayınlamaz. Bağlantı kurumsal API veya üçüncü parti entegratör uygulama üzerinden kurulur.

Aras Kargo entegrasyonu için minimum sipariş hacmi şartı var mı? Resmi bir minimum hacim şartı yayınlanmaz, ancak birim fiyat teklifi hacme göre şekillenir. Düşük hacimli mağazalar için birim ücret daha yüksek belirlenebilir.

Entegratör uygulama mı yoksa özel API mi daha uygun? Teknik kaynağı olmayan mağazalar için entegratör uygulama daha hızlı ve düşük riskli bir çözümdür. Yüksek hacimli ve özel kural gerektiren mağazalar için özel API entegrasyonu daha esnek sonuç verir.

Aras Kargo barkodu neden şubede okunmuyor? En sık neden etiket PDF’inin termal yazıcı standardına uygun boyutlandırılmamasıdır. Etiket şablonunun 10x15 cm formatında test edilmesi bu sorunu önler.

Aras Kargo kurumsal anlaşma ne kadar sürede tamamlanır? Evrak ve hacim beyanı sonrası anlaşma genelde 3-7 iş günü içinde imzalanır. API kimlik bilgilerinin iletimi anlaşma sonrası 1-2 iş günü daha sürer.

Aras Kargo ile Yurtiçi Kargo aynı anda kullanılabilir mi? Evet, bir entegratör uygulama üzerinden iki firma da aynı mağazada tanımlanabilir. Sipariş bazında hangi firmanın kullanılacağı kural olarak ayarlanabilir.

Aras Kargo kargo kaydı oluşturulduktan sonra iptal edilebilir mi? Evet, kargo şubeye fiziksel olarak teslim edilmeden önce API üzerinden iptal edilebilir. Şubeye teslim edildikten sonra süreç iadeye döner ve ek maliyet doğar.

Aras Kargo entegrasyonu için hangi belgeler gerekir? Kurumsal anlaşma başvurusu için vergi levhası, imza sirküleri ve tahmini aylık gönderi hacmi beyanı yeterlidir. Şahıs şirketleri de bu belgelerle başvuru yapabilir.

Sonraki Adım

Aras Kargo entegrasyonu tamamlandıktan sonra kargo takip bilgisinin müşteriye otomatik ulaştırılması gerekir. Fulfillment API ve Shopify Flow kullanılarak bu bildirim akışının nasıl kurulacağı kargo takip numarası otomatik oluşturma rehberinde adım adım anlatılır.