Shopify Kargo Entegrasyonu: Güncel Rehber (2026)

Shopify kargo entegrasyonu, Türkiye'deki e-ticaret mağazalarının sipariş-lojistik süreçlerini otomatikleştiren ve manuel kargo yönetiminin yol açtığı zaman kaybı ile hata maliyetlerini ortadan kaldıran kritik bir altyapı adımıdır. Doğru kurulmuş bir entegrasyon; sipariş onaylandığı andan kargo etiketinin oluşmasına, takip numarasının müşteriye iletilmesine ve teslimat bildirimlerine kadar tüm süreci otomatik yönetir.

Bu rehberde Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo ve PTT Kargo'nun Shopify entegrasyon yollarını, entegrasyon öncesi hazırlık adımlarını, fiyatlandırma modellerini ve yaygın sorunların çözümlerini Türkiye e-ticaret gerçekliğiyle ele alıyoruz.

Shopify Kargo Entegrasyonu Nedir ve Neden Gereklidir?

Shopify kargo entegrasyonu; mağazanızın sipariş yönetim sistemi ile kargo firmasının API altyapısı arasında gerçek zamanlı veri akışı kuran bir bağlantıdır. Bu bağlantı kurulmadan her sipariş için kargo etiketini elle oluşturmak, adresi kargo sistemine girmek ve takip numarasını kopyalayıp müşteriye iletmek gerekir sipariş başına 3–6 dakika süren tekrarlayan bir süreç.

Türkiye'de günlük 100 sipariş işleyen bir mağaza, entegrasyon olmadan kargo operasyonlarına günde ortalama 2–3 saat harcamaktadır. Doğru kurulmuş bir Shopify kargo entegrasyonu bu süreyi %85 oranında azaltır. Manuel veri girişinden kaynaklanan hata oranı entegrasyon öncesinde %3–5 civarındayken entegrasyon sonrasında %0,2'nin altına iner.

Türkiye e-ticaret pazarı 2024 yılında 1,3 trilyon TL işlem hacmine ulaştı. Bu ölçekteki bir pazarda operasyonel hız ve doğruluk, doğrudan müşteri memnuniyetini ve tekrar satın alma oranını etkiler. Yanlış adrese giden bir kargo ortalama 180–250 TL ek maliyet yaratırken, gecikme bildirimi almayan bir müşteri büyük olasılıkla olumsuz yorum bırakır ve bir daha sipariş vermez.

Kargo entegrasyonu yalnızca operasyonel bir kolaylık değil; ölçekleme döneminde geliri koruyan stratejik bir yatırımdır.

Türkiye'deki Kargo Firmaları ve Shopify Uyumluluğu

Türkiye'de Shopify mağazalarıyla entegre çalışabilecek beş ana kargo firması mevcuttur: Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo ve PTT Kargo. Bu firmalar arasındaki Shopify uyumluluk düzeyi, entegrasyon yolu, API erişim koşulları ve minimum hacim gereksinimleri birbirinden önemli ölçüde farklılaşmaktadır.

Yurtiçi Kargo

Yurtiçi Kargo, Shopify App Store'da resmi uygulamasıyla yer alan büyük Türk kargo firmalarından biridir. OAuth 2.0 tabanlı API entegrasyonu, günlük 10.000 API çağrısına kadar limit tanır. Minimum hacim şartı bulunmadığından yeni açılan mağazalar için de kolaylıkla kurulabilir. Türkiye genelindeki 780+ şube ağıyla Anadolu'nun ikinci ve üçüncü kademe şehirlerine erişimde öne çıkar.

Adım adım kurulum için Yurtiçi Kargo Shopify Entegrasyonu Kurulum Rehberi'ni inceleyebilirsiniz.

Aras Kargo

Aras Kargo'nun hem resmi Shopify uygulaması hem de üçüncü taraf middleware üzerinden entegrasyon seçeneği mevcuttur. API erişimi için müşteri numarası ve API şifresi gereklidir; bu bilgiler kurumsal sözleşme imzalandıktan sonra B2B portalı ya da temsilci aracılığıyla iletilir. Türkiye'nin en geniş kargo ağlarından biri olan Aras, 900+ şubesiyle özellikle hızlı teslimat kapasitesiyle bilinir. API şifresi güvenlik politikası gereği her 90 günde bir yenilenebilir; bu durum entegrasyon sonrasında düzenli kontrol gerektiren bir noktadır.

Teknik kurulum adımları için Aras Kargo Shopify Entegrasyonu Rehberi'ni okuyabilirsiniz.

MNG Kargo

MNG Kargo, Shopify App Store'da resmi uygulamaya sahip değildir, fakat app’ler ile kullanılabilir veya middleware platformları ya da özel API geliştirmesi üzerinden sağlanır. Aylık 500 gönderinin altında kalan mağazalar için standart API erişimi kısıtlı kalabileceğinden hacim eşiği sorgulanmadan sözleşme imzalanmamalıdır. İstanbul, Ankara ve İzmir başta olmak üzere büyük şehirlerde güçlü bir dağıtım ağına sahiptir.

Middleware kurulum adımları için MNG Kargo Shopify Entegrasyonu Rehberi'ni inceleyebilirsiniz.

Sürat Kargo

Sürat Kargo'nun Shopify entegrasyonu üçüncü taraf uygulamalar veya middleware üzerinden kurulur. Aylık 300 gönderi taahhüdü anlaşmalı fiyat için genellikle beklenen minimum eşiktir. İstanbul ve Ankara'da aynı gün teslimat seçeneği sunan nadir kargo firmalarından biridir.

PTT Kargo

PTT Kargo'nun resmi Shopify uygulaması ve gelişmiş API altyapısı bulunmamaktadır. Entegrasyon ancak özel API geliştirmesi ya da manuel süreçlerle mümkündür. Minimum hacim şartı olmaması ve bireysel tarife erişilebilirliği küçük mağazalar için avantaj sağlasa da kısıtlı API desteği nedeniyle otomasyonu sınırlıdır. Yüksek hacimli mağazalar için Yurtiçi veya Aras daha uygun bir seçenek olmaya devam etmektedir.

Shopify Kargo Entegrasyonu Öncesi Hazırlık

Kargo entegrasyonuna başlamadan önce tamamlanması gereken üç temel hazırlık adımı vardır: kargo firmasıyla kurumsal sözleşme imzalamak, API erişim bilgilerini temin etmek ve Shopify mağaza ayarlarını entegrasyona uygun hale getirmek. Bu adımlardan herhangi biri eksik bırakıldığında kurulum sırasında veya ilk siparişlerde kritik hatalar ortaya çıkar.

1. Kurumsal Sözleşme ve API Erişimi

Kargo firmasının API'sine erişmek için önce kurumsal müşteri sözleşmesi imzalanmalıdır. Süreç Yurtiçi ve Aras'ta 3–5 iş günü alırken MNG ve Sürat'ta 5–10 iş gününe uzayabilir. Sözleşme tamamlandıktan sonra firmanın kurumsal portalı veya müşteri temsilcisi aracılığıyla şu bilgiler temin edilir: müşteri numarası (customer code), API anahtarı/şifresi, şube kodu (bazı firmalar için zorunlu), sandbox ve production endpoint URL'leri.

⚠️ DİKKAT: API anahtarlarını asla üçüncü kişilerle paylaşmayın ve Shopify admin panelinde açık metin olarak saklamaktan kaçının. Shopify'ın Metafields yapısı ya da çevre değişkenleri bu bilgileri güvenli saklamak için kullanılabilir.

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

Entegrasyon öncesinde Shopify admin panelinde şu üç ayarın doğrulanması gerekir: Birincisi, Settings → Shipping and delivery bölümünde Türkiye için teslimat bölgelerinin tanımlanmış olması. İkincisi, tüm ürünlerin ağırlık bilgisinin eksiksiz girilmiş olması ağırlık eksikliği etiket üretimini engeller ya da yanlış fiyat hesaplar. Üçüncüsü, vergi ayarlarında KDV yapılandırmasının tamamlanmış olması. 500'den fazla ürünü olan mağazalar için toplu ağırlık güncellemesini CSV export/import yöntemiyle yapabilirsiniz.

3. Sandbox Test Ortamı Kurulumu

Üretim ortamına geçmeden önce kargo firmasının sandbox API'sini kullanarak en az 10 test siparişi oluşturun. Bu süreçte kargo etiketinin doğru üretilip üretilmediğini, takip numarasının Shopify sipariş detayına düşüp düşmediğini ve webhook bildirimlerinin tetiklenip tetiklenmediğini doğrulayın. Sandbox erişimi için kurumsal temsilcinizden ayrıca talep etmeniz gerekebilir; bu adımı sözleşme görüşmesinde önceden belirtin.

Shopify Kargo Entegrasyon Yöntemleri

Shopify kargo entegrasyonu üç farklı yöntemle kurulabilir: resmi Shopify App Store uygulaması, üçüncü taraf middleware platformu ve özel API geliştirmesi. Doğru yöntemi seçmek sipariş hacminize, teknik altyapınıza ve kaç farklı kargo firmasıyla çalışacağınıza bağlıdır.

💡 İPUCU: Aylık 200'den az sipariş işliyorsanız resmi Shopify uygulaması ücretsiz ve yeterlidir. 500+ sipariş hacmine veya birden fazla kargo firmasına ihtiyaç duyuyorsanız middleware ya da özel API entegrasyonu çok daha verimli bir çözüm sunar.

Yöntem A: Resmi Shopify Uygulaması ile Kurulum

Yurtiçi ve Aras Kargo'nun resmi Shopify uygulamaları App Store'dan ücretsiz yüklenebilir. Kurulum adımları her iki firmada da benzer bir akışı izler:

1. Shopify admin → Apps → App Store'a gidin, kargo firmasının adını arayın.
2. 'Add app' butonuyla uygulamayı yükleyin ve gerekli izinleri onaylayın.
3. Uygulama ayarlarında API bilgilerini (müşteri no., şifre, şube kodu) girin.
4. 'Bağlantıyı Test Et' ile API bağlantısını doğrulayın; yeşil onay bağlantının başarılı olduğunu gösterir.
5. Shipping zones bölümünden Türkiye için kargo bölgelerini ve fiyatlandırma kurallarını tanımlayın.
6. Test siparişi oluşturun, etiketi üretin ve takip numarasının siparişe düştüğünü doğrulayın.

Yöntem B: Middleware ile Kurulum

MNG Kargo, Sürat Kargo veya birden fazla firmayı tek panelden yönetmek isteyenler için Geliver, Entegrasyonum.com veya Netgsm gibi middleware platformları gereklidir. Bu platformlar aylık 20–80$ abonelik ücreti karşılığında çoklu firma desteği, otomatik kurye seçimi, ERP/WMS entegrasyonu ve gelişmiş raporlama araçları sunar.

Middleware kurulumunda temel akış şöyledir: Platform üzerinden Shopify mağazası OAuth ile bağlanır; ardından her kargo firması için API bilgileri platforma girilir. Sipariş geldiğinde belirlediğiniz kurala göre (bölge, ağırlık, maliyet) platform ilgili kargo firmasını otomatik seçer ve etiketi oluşturur.

Yöntem C: Özel API Geliştirmesi

Aylık 2000'den fazla sipariş işleyen, ERP veya WMS ile entegre çalışması gereken ya da tamamen özelleştirilmiş depo iş akışlarına ihtiyaç duyan kurumsal mağazalar için en esnek çözümdür. Kargo firmasının REST API'si doğrudan Shopify webhook'larına bağlanır; middleware maliyeti ortadan kalkar ve iş akışı sınırsız özelleştirilebilir. Nodus Works olarak bu tür kurumsal entegrasyon projelerini de yönetiyoruz.

Shopify'da Kargo Fiyatlandırması ve Otomatik Hesaplama

Shopify kargo fiyatlandırması iki modelle yapılandırılır: sabit fiyat ve ağırlık bazlı hesaplama. Her modelin hangi koşulda uygun olduğu sipariş profilinize ve Shopify plan seçiminize göre değişir.

Sabit Fiyat ve Koşullu Ücretsiz Kargo

En yaygın kullanılan modeldir. Settings → Shipping and delivery → Shipping zones bölümünden tüm siparişler için sabit kargo ücreti tanımlanır; belirli bir sipariş tutarı aşıldığında ücretsiz kargo devreye girer. Türkiye'deki KOBİ'lerin büyük çoğunluğu 300–600 TL arasında ücretsiz kargo eşiği kullanmaktadır. Ücretsiz kargo eşiğini doğru belirlemek için ortalama sepet tutarınızı baz alın ve eşiği %15–20 üzerine koyun; bu oran müşterileri ek ürün eklemeye teşvik ederken dönüşüm oranını korur.

Ağırlık Bazlı Fiyatlandırma

Ürün ağırlığına göre farklı fiyat dilimleri tanımlanır; örneğin 0–1 kg için 39,90 TL, 1–3 kg için 59,90 TL. Bu modelin çalışması için tüm ürünlerin Shopify admin panelinde ağırlık bilgisinin eksiksiz girilmiş olması zorunludur. Türk kargo firmalarının kullandığı desi (hacimsel ağırlık) hesabını da göz önünde bulundurun: kargo firması gerçek ağırlık ile hacimsel ağırlık (en × boy × yükseklik / 3000) arasındaki büyük olanı faturalar.

Entegrasyon Sonrası Test ve Doğrulama

Kargo entegrasyonu canlıya alınmadan önce en az beş senaryo üzerinde test yapılmalıdır: standart sipariş, ağır/hacimli sipariş, farklı şehirlere teslimat, iade siparişi ve iptal edilen sipariş. Bu testler atlanırsa canlı ortamda müşterileri etkileyen hatalar kaçınılmaz olur.

⚠️ UYARI: Test siparişlerini gerçek ürünler ve gerçek Türkiye adresleriyle oluşturun. Çoğu Shopify kargo uygulaması ve middleware platformu, sahte adresler için etiket üretemez veya yanlış fiyat hesaplar.

Test Kontrol Listesi

• Sipariş onaylandığında kargo etiketi otomatik oluşuyor mu?
• Takip numarası sipariş detay sayfasında ve müşteri onay e-postasında görünüyor mu?
• Kargo firmasının web sitesinde takip numarası çalışıyor mu?
• Webhook bildirimleri doğru tetikleniyor mu? (kargo alındı, yolda, teslim edildi)
• İade talebi oluşturulduğunda sistem doğru yanıt veriyor mu?
• Farklı ağırlık aralıklarında fiyat hesaplaması doğru ve tutarlı mı?
• Farklı illere yapılan teslimatlar bölge bazlı kurallara uygun mu?

Yaygın Sorunlar ve Çözümleri

Shopify kargo entegrasyonunda en sık karşılaşılan dört sorun API kimlik doğrulama hatası, etiket üretilememesi, takip numarasının siparişe düşmemesi ve yanlış kargo ücreti hesaplanmasıdır. Bu sorunların tamamı birkaç adımda çözülebilir.

Sorun 1: API Bağlantısı Kurulamıyor

Çözüm: Kargo firmasının portalından API bilgilerinin (müşteri kodu, şifre, endpoint URL) son sürümünü alın. Aras Kargo başta olmak üzere bazı firmalar güvenlik güncellemelerinde API şifresini otomatik yeniler; Shopify uygulamasındaki eski şifre bağlantı hatasına yol açar. Kopyala-yapıştır ile girilen bilgilerde gizli boşluk karakteri olup olmadığını kontrol edin.

Sorun 2: Kargo Etiketi Oluşturulmuyor

Çözüm: Siparişin içerdiği ürünlerden en az birinin ağırlık bilgisi eksik olabilir. Products → [ilgili ürün] → Shipping sekmesinden ağırlık bilgisini doldurun. Ayrıca sözleşmedeki müşteri numarasının API ayarlarında harf büyüklüğüne dikkat edilerek tam olarak girilip girilmediğini doğrulayın.

Sorun 3: Takip Numarası Müşteriye İletilmiyor

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

Sorun 4: Yanlış Kargo Ücreti Hesaplanıyor

Çözüm: Shipping zones bölümünde bölge çakışması yaşanıyor olabilir. Hem 'Türkiye' hem de 'İstanbul' için ayrı bölge tanımlandıysa Shopify her iki kuralı da uygulayabilir. En spesifik bölge tanımını öncelikli tutun ve çakışan bölgeleri temizleyin.

‍

Sık Sorulan Sorular

Shopify'da kargo entegrasyonu nasıl yapılır?

Shopify kargo entegrasyonu; kargo firmasıyla kurumsal sözleşme imzalayıp API bilgilerini temin etmek, ardından Shopify App Store'dan ilgili uygulamayı yükleyerek bu bilgileri girmek ve kargo bölgelerini tanımlamak adımlarıyla tamamlanır. Resmi uygulama olan Yurtiçi ve Aras Kargo için süreç 1–3 saat alırken MNG gibi middleware gerektiren entegrasyonlar 3–8 saat sürebilir.

Shopify Türkiye'de hangi kargo firmasıyla entegre çalışır?

Shopify, Türkiye'de Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo ve PTT Kargo ile entegre çalışabilir. Yurtiçi ve Aras, Shopify App Store'da resmi uygulamalarıyla yer alır. MNG ve Sürat için Geliver gibi middleware çözümü gereklidir. PTT Kargo ise yalnızca özel API geliştirmesiyle entegre edilebilir.

Shopify kargo entegrasyonu için hangi plan gereklidir?

Temel kargo uygulamaları Shopify'ın herhangi bir ücretli planında (Basic, Shopify, Advanced) çalışır.

Shopify'da birden fazla kargo firması kullanılabilir mi?

Evet. Shopify'da farklı teslimat bölgelerine farklı kargo firmaları atanabilir.

Shopify kargo entegrasyonu maliyeti ne kadar?

Resmi Shopify kargo uygulamaları (Yurtiçi, Aras) ücretsizdir. Middleware platformlar aylık 20–80$ arasında abonelik ücreti alır. Özel API geliştirmesi ise proje kapsamına göre tek seferlik maliyet içerir. Kargo gönderim bedelleri ise kargo firmasıyla imzalanan kurumsal sözleşmeye ve aylık hacme göre değişir.

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

MNG Kargo'nun resmi Shopify uygulaması bulunmadığından entegrasyon Geliver veya Entegrasyonum.com gibi middleware platformlar aracılığıyla kurulur. Önce MNG ile kurumsal sözleşme imzalanır ve API bilgileri alınır, ardından middleware platforma bu bilgiler girilerek Shopify bağlantısı kurulur. MNG, aylık 500 gönderi taahhüdü koşulu aradığından bu eşiği aşmayan mağazalar için önce Yurtiçi veya Aras tercih edilmesi önerilir.

Shopify kargo entegrasyonu ne kadar sürer?

Shopify kargo entegrasyon süresi seçilen yönteme göre farklılaşır. Resmi uygulama üzerinden kurulan entegrasyon (Yurtiçi, Aras) 1–3 saat içinde tamamlanır; ancak API erişim sözleşmesi önceden imzalanmış olmalıdır. Middleware gerektiren entegrasyonlar (MNG, Sürat) 3–8 saat alır. Özel API geliştirmesi ise 2–5 iş günü sürer. Kurumsal sözleşme süreci tüm yöntemler için ayrıca 3–10 iş günü gerektirir.

Shopify kargo entegrasyonu için hangi kargo firması önerilir?

Türkiye'de Shopify mağazaları için genel öneri: aylık 200'den az sipariş için Yurtiçi veya Aras Kargo'nun ücretsiz resmi uygulaması yeterlidir. Aylık 500+ sipariş ve geniş bölgesel kapsam gerekiyorsa Aras ve Sürat anlaşmalı fiyat avantajı sağlar. Anadolu'nun küçük yerleşim yerlerine erişimde Yurtiçi'nin 780+ şube ağı öne çıkar.

Shopify'da kargo firması değiştirmek zor mu?

Shopify'da kargo firması değiştirmek teknik olarak basittir: mevcut uygulamayı kaldırıp yeni firmanın uygulamasını kurmak yeterlidir. Zorlu olan operasyonel geçiştir: yeni firmayla sözleşme imzalanması, API bilgilerinin temin edilmesi ve depo personelinin yeni etiket sürecine alışması genellikle 1–2 haftalık uyum süreci gerektirir.

Shopify Kargo Entegrasyonunuzu Doğru Kurun

Shopify kargo entegrasyonu doğru yapılandırıldığında sipariş başına harcanan manuel süreyi saatlerden dakikalara indirir, müşteri memnuniyetini artırır ve operasyonel hatalardan kaynaklanan maliyetleri önler. Yanlış veya eksik kurulumlar ise ilk bakışta sorunsuz görünse de ölçeklenme döneminde kritik problemler üretir.

Nodus Works olarak Türkiye'nin en deneyimli Shopify ajansı sıfatıyla yüzlerce mağazanın kargo altyapısını sıfırdan kuruyoruz. Yurtiçi, Aras, MNG ve Sürat Kargo entegrasyonlarını hem teknik hem operasyonel olarak yönetiyoruz.

Platform geçişi yapıyorsanız Shopify'a Taşıma hizmetimize göz atabilirsiniz.

Kargo entegrasyonunuzu Nodus Works ile kurmak için bizimle iletişime geçin. İlk görüşme ücretsizdir; mağazanıza özel entegrasyon planı hazırlıyoruz.

Ücretsiz Danışmanlık Görüşmesi Talep Edin

‍