Aras Kargo Shopify Entegrasyonu Nasıl Yapılır? (2026 Güncel Rehber)

Aras Kargo Shopify entegrasyonu, mağazanızın sipariş yönetim sistemi ile Aras Kargo'nun API altyapısını birbirine bağlayarak kargo etiketlerini otomatik oluşturur ve takip numaralarını müşteriye anında iletir. Bu rehberde Aras Kargo'nun Shopify App Store'daki resmi uygulamasından özel API entegrasyonuna kadar tüm yöntemleri adım adım açıklıyoruz.

Aras Kargo Shopify Entegrasyonu Neden Önemlidir?

Aras Kargo, Türkiye'nin en geniş dağıtım ağına sahip kargo firmalarından biridir ve yılda 500 milyonun üzerinde gönderi taşımaktadır. Shopify mağazanızı Aras Kargo ile entegre etmek; sipariş başına harcanan manuel etiket süresini 3–5 dakikadan sıfıra indirirken hata oranını da %4'ten %0,2'nin altına çeker.

Türkiye'de e-ticaret yapan ve aylık 50'nin üzerinde sipariş işleyen her mağaza için Aras Kargo entegrasyonu operasyonel açıdan zorunlu bir adımdır. Manuel kargo sürecinde bir çalışan günde yaklaşık 80 etiketi elle yazdırıp yapıştırabilirken, entegrasyon kurulduktan sonra aynı kişi bu süreyi 10 dakikanın altına indirir ve zamanını müşteri hizmetleri ile büyümeye odaklanmak için kullanır.

Aras Kargo'nun Shopify uyumu, hem küçük ölçekli mağazalar için App Store uygulaması hem de kurumsal ihtiyaçlar için doğrudan API erişimi sağlaması bakımından rakip kargo firmalarına göre avantajlıdır.

Entegrasyon Öncesi Gereksinimler

Aras Kargo Shopify entegrasyonuna başlamadan önce üç temel gereksinim tamamlanmış olmalıdır: Aras Kargo kurumsal sözleşmesi, API erişim bilgileri ve Shopify mağaza ön hazırlığı. Bu adımlardan herhangi biri eksik olduğunda entegrasyon kurulum aşamasında veya ilk siparişlerde hata verir.

1. Aras Kargo Kurumsal Sözleşmesi

Aras Kargo API'sine erişebilmek için önce Aras'ın kurumsal müşteri sözleşmesini imzalamanız gerekir. Sözleşme için aras.com.tr üzerinden kurumsal müşteri temsilcisi talep formu doldurulur. Süreç genellikle 3–5 iş günü alır. Bireysel kargo gönderimi yapan sıradan bireysel hesaplar API erişimine kapalıdır.

Aylık ortalama gönderi hacminizi ve teslimat bölgelerinizi temsilciye önceden bildirirseniz anlaşmalı kargo fiyatı müzakeresi daha hızlı tamamlanır. Türkiye'nin batı illerine (İstanbul, İzmir, Bursa) yapılan gönderimlerde Aras'ın hacim iskontosu %15–30 aralığında olabilmektedir.

2. API Erişim Bilgilerini Temin Edin

Sözleşme imzalandıktan sonra Aras kurumsal portali (b2b.araskargo.com.tr) üzerinden API bilgilerinize erişirsiniz. Aşağıdaki tablo entegrasyon için gereken API parametrelerini özetlemektedir:

⚠️ DİKKAT: Aras Kargo API şifresi güvenlik politikası gereği her 90 günde bir yenilenebilir. Şifre yenilendiğinde Shopify uygulamasındaki API ayarlarını güncellemeyi unutmayın; aksi hâlde kargo etiketleri oluşturulamaz.

3. Shopify Mağaza Ön Hazırlığı

Entegrasyon öncesinde Shopify admin panelinde şu iki ayarı doğrulayın: Birincisi, tüm ürünlerin ağırlık bilgisinin girilmiş olması (Settings > Products > Weight unit). Ağırlık girilmemiş ürünler için Aras API'si varsayılan 0,5 kg kullanır; bu durum yanlış fiyat hesaplamasına yol açar. İkincisi, teslimat bölgelerinin (Shipping zones) Türkiye için tanımlanmış olması.

Entegrasyon Yöntemi Seçimi

Aras Kargo Shopify entegrasyonu üç farklı yöntemle kurulabilir. Doğru yöntemi seçmek; aylık sipariş hacminize, teknik altyapınıza ve bütçenize göre değişir. Yanlış yöntem seçimi gereksiz maliyet ya da yetersiz otomasyon anlamına gelir.

İPUCU: Aylık 200'den az sipariş işliyorsanız resmi Aras Kargo Shopify uygulaması tamamen yeterlidir ve ücretsizdir. 500+ siparişe ulaştığınızda özel API çözümüne geçişi planlayın.

Adım Adım Aras Kargo Shopify Kurulumu (Resmi Uygulama)

Aras Kargo'nun resmi Shopify uygulaması, standart bir e-ticaret mağazası için gerekli tüm özellikleri sunar: otomatik etiket, takip numarası ve bildirim. Kurulum 1–3 saat içinde tamamlanabilir.

Adım 1: Uygulamayı Yükleyin

1. Shopify admin panelinizde Apps → App Store'a gidin.
2. Arama kutusuna 'Aras Kargo' yazın.
3. Resmi Aras Kargo uygulamasını bulun, 'Add app' butonuna tıklayın.
4. Uygulama izin ekranında 'Install app' ile onaylayın.

Adım 2: API Bilgilerini Girin

5. Uygulama ayarlar ekranı açılır. 'Bağlantı Ayarları' veya 'API Settings' bölümüne gidin.
6. CustomerCode alanına Aras kurumsal müşteri numaranızı girin.
7. Password alanına API şifrenizi girin (kurumsal portaldan aldığınız şifre).
8. 'Bağlantıyı Test Et' butonuna tıklayın — yeşil onay görünüyorsa bağlantı başarılıdır.

⚠️ UYARI: Test butonundan 'Bağlantı başarısız' hatası alıyorsanız önce CustomerCode'un baş ve sonundaki boşlukları silin. Kopyala-yapıştır işleminde gizli boşluk karakterleri sık karşılaşılan bir sorundur.

Adım 3: Kargo Bölgelerini Tanımlayın

1. Shopify admin → Settings → Shipping and delivery → Manage bölümüne gidin.
2. 'Turkey' bölgesi için Aras Kargo'yu kargo sağlayıcısı olarak ekleyin.
3. Kargo fiyatlandırmasını yapılandırın: sabit fiyat (örn. tüm siparişler 49,90 TL), ağırlık bazlı veya koşullu ücretsiz kargo (örn. 500 TL üzeri).

Adım 4: Test Siparişi Oluşturun

4. Shopify admin → Orders bölümünden 'Create order' ile bir test siparişi oluşturun.
5. Sipariş onaylandıktan sonra Fulfillment ekranında 'Create shipping label' butonunun göründüğünü doğrulayın.
6. Etiketi oluşturun ve Aras takip sisteminde (kargo.aras.com.tr) takip numarasının çalışıp çalışmadığını kontrol edin.

Yaygın Sorunlar ve Çözümleri

Aras Kargo Shopify entegrasyonunda en sık karşılaşılan dört sorun API kimlik doğrulama hatası, etiket oluşturulamaması, yanlış ağırlık hesabı ve takip numarasının düşmemesidir. Bu sorunların tamamı birkaç dakika içinde çözülebilir.

Sorun: 'Authentication Failed' Hatası

Çözüm: API şifrenizin süresi dolmuş olabilir. Aras kurumsal portalına girin, API şifrenizi yenileyin ve Shopify uygulamasındaki Password alanını güncelleyin. Aras, güvenlik güncellemelerinde şifreyi otomatik olarak yeniler ve eski şifreyi geçersiz kılar.

Sorun: Kargo Etiketi Oluşturulmuyor

Çözüm: Siparişteki ürünlerden en az birinin ağırlık bilgisi eksik olabilir. Products → [ilgili ürün] → Shipping sekmesinden ağırlık bilgisini doldurun. Ayrıca teslimat adresi Türkiye dışında bir ülkeye ait ise Aras API'si etiket üretmez; shipping zone ayarlarını kontrol edin.

Sorun: Takip Numarası E-postada Görünmüyor

Çözüm: Settings → Notifications → Shipping confirmation şablonunda {{ fulfillment.tracking_number }} değişkeninin mevcut olduğunu doğrulayın. Özelleştirilmiş e-posta şablonlarında bu değişken silinmiş olabilir; orijinal Shopify şablonuyla karşılaştırarak kontrol edin.

Sorun: Yanlış Kargo Ücreti Müşteriye Yansıyor

Çözüm: Shipping zones bölümünde birden fazla çakışan kural olabilir. Tüm kargo kurallarını listeleyin, gereksiz veya çakışan kuralları silin. En spesifik kural (örn. İstanbul) genel kuralın (Türkiye) önüne geçmelidir.

Sık Sorulan Sorular

Aras Kargo Shopify entegrasyonu ücretsiz mi?

Resmi Aras Kargo Shopify uygulaması ücretsiz indirilir ve kurulabilir. Kargo gönderim bedellerini ise Aras ile imzaladığınız kurumsal sözleşme belirler.

Aras Kargo API bilgilerini nereden alabilirim?

Aras Kargo API bilgilerini kurumsal müşteri sözleşmesi imzalandıktan sonra b2b.araskargo.com.tr kurumsal portali üzerinden veya size atanan kurumsal müşteri temsilcisi aracılığıyla alabilirsiniz. Bireysel gönderici hesapları API erişimine kapalıdır.

Shopify'da Aras Kargo ile aynı gün teslimat sunabilir miyim?

Aras Kargo, İstanbul içi bazı bölgelerde aynı gün teslimat (AYS) hizmeti sunar. Bu hizmet API üzerinden ServiceType parametresi 'AY' olarak belirlenerek aktifleştirilebilir. Ancak mağazanızın sözleşmesinde bu hizmetin tanımlı olması ve kargo teslim saatlerinin (genellikle 14:00'a kadar) gözetilmesi gerekir.

Aras Kargo entegrasyonu WooCommerce'den geçişten sonra da çalışır mı?

Evet. Shopify'a geçiş tamamlandıktan sonra Aras Kargo entegrasyonu sıfırdan kurulur; WooCommerce'deki eski entegrasyon Shopify'a taşınmaz. Geçiş sürecinde sipariş geçmişiniz korunur ancak kargo entegrasyonu yeni mağaza üzerinden yeniden yapılandırılmalıdır.

Aras Kargo Shopify entegrasyonu nasıl yapılır?

Aras Kargo Shopify entegrasyonu, Shopify App Store'dan resmi Aras Kargo uygulaması yüklenerek ve Aras kurumsal müşteri bilgileri (müşteri numarası + API şifresi) uygulamaya girilerek yapılır. Bunun için önce Aras Kargo ile kurumsal sözleşme imzalanmış ve API erişimi talep edilmiş olmalıdır. Tüm süreç 1–3 saat içinde tamamlanabilir.

Aras Kargo'nun Shopify uygulaması var mı?

Evet, Aras Kargo'nun Shopify App Store'da yayımlanmış resmi bir uygulaması mevcuttur. Uygulama temel kargo etiket oluşturma, takip numarası entegrasyonu ve bildirim gönderme özelliklerini içerir. Büyük hacimli operasyonlar için ise özel API entegrasyonu tercih edilmeli.

Aras Kargo API şifresi neden çalışmıyor?

Aras Kargo API şifresi her 90 günde bir güvenlik politikası gereği yenilenebilir. Şifre yenilendiğinde Shopify uygulamasındaki bağlantı kesilir. Çözüm için Aras kurumsal portalından yeni API şifresini alın ve uygulamanın bağlantı ayarlarını güncelleyin.

‍

Aras Kargo Shopify entegrasyonu, doğru kurulduğunda mağazanızın lojistik süreçlerini büyük ölçüde otomatikleştirir. Resmi uygulama küçük ve orta ölçekli mağazalar için güçlü bir başlangıç noktasıdır; ölçeklendikçe middleware veya özel API çözümlerine geçiş kolaylıkla yapılabilir.

Shopify'da kargo firmalarını karşılaştırmalı değerlendirmek için Shopify Kargo Entegrasyonu: Eksiksiz Rehber yazımıza göz atabilirsiniz.

Diğer platformlardan Shopify'a geçiş yapıyorsanız Shopify'a Geçiş Teknik Rehberi kaçırmamanız gereken bir kaynak.

Aras Kargo entegrasyonunuzu Nodus Works ile kurmak için bizimle iletişime geçin. İlk görüşme ücretsizdir.

Şimdi Ücretsiz Entegrasyon Danışmanlığı Talep Edin

‍