Shopify MNG Kargo Entegrasyonu: Kurulum ve Gönderi Otomasyonu Rehberi 2026

Shopify MNG Kargo Entegrasyonu Nedir?
Shopify MNG kargo entegrasyonu, Shopify mağazasında oluşturulan siparişleri MNG Kargo sistemine otomatik ileten, barkod etiketini mağaza panelinden oluşturan ve müşteriye takip numarasını anında gönderen bir lojistik bağlantı altyapısıdır.

Türkiye’de faaliyet gösteren Shopify mağazalarının büyük bölümü birden fazla kargo firmasıyla çalışır. MNG Kargo, yaygın teslim ağı ve kurumsal sözleşme seçenekleriyle e-ticaret mağazaları arasında tercih edilen firmalar arasında yer alır. Bu rehber, Shopify ile MNG Kargo entegrasyonunu kurmak için izlenmesi gereken adımları, kullanılabilecek araç seçeneklerini ve sık karşılaşılan sorunları açıklar.

MNG Kargo Entegrasyonu İçin Önkoşullar

Entegrasyonu kurmadan önce iki tarafın da hazır olması gerekir. Eksik bir hazırlık, kurulum sürecini gereksiz yere uzatır.

MNG Kargo hesabınız aktif ve API erişiminiz açık olmalıdır. Shopify mağazanızda ise Orders modülüne erişim yetkisi bulunmalıdır.

MNG Kargo tarafında gerekli bilgiler:

• Kurumsal MNG Kargo müşteri kodu
• API kullanıcı adı ve şifresi (MNG Kargo kurumsal destek hattından talep edilir: 444 0 664)
• Gönderici adresi ve şube kodu
• Anlaşmalı ürün kodu (standart, kapıda ödeme, taahhütlü vb.)

Shopify tarafında gerekli izinler:

• Admin erişimi
• Üçüncü taraf uygulamaları yükleme yetkisi (veya Staff Account için ilgili izin)

MNG Kargo API erişimi otomatik olarak aktifleşmez. Kurumsal müşteri temsilcinizle görüşerek API kullanıcısı açtırın. Bu süreç genellikle 1-3 iş günü alır.

Shopify-MNG Kargo Entegrasyon Yöntemleri

Shopify’da MNG Kargo entegrasyonunu kurmanın üç yolu vardır. Her birinin avantajları ve sınırlılıkları farklıdır.

Shopify App Store’daki çok-taşıyıcılı kargo uygulamaları, tek firma entegrasyonuna kıyasla sipariş hacmi büyüdükçe çok daha ölçeklenebilir bir yapı sunar.

Yöntem	Avantaj	Dezavantaj	Uygun Profil
Shopify App Store (çok-taşıyıcılı)	MNG + diğer kargolar tek panelden	Aylık abonelik ücreti	Günlük 10+ sipariş
Shopify App Store (MNG özel)	Basit kurulum, tek kargo	Esneklik düşük	Günlük 1-10 sipariş
Özel API entegrasyonu	Tam kontrol, özelleştirme	Geliştirici gerektirir	Özel iş akışı gereken mağazalar

Yöntem 1: Çok-Taşıyıcılı Shopify Uygulaması ile Kurulum

Bu yöntem, Türkiye’de en yaygın tercih edilen yaklaşımdır. Shopify App Store’da birden fazla Türkiye kargosunu destekleyen uygulamalar mevcuttur: Easyship, ShipStation veya Türkiye’ye özel platformlar (Commeta, Kolisi, Shipentegra gibi).

Adım adım kurulum:

1. Shopify Admin panelinde Apps > App Store yolunu takip edin.
2. “MNG kargo” veya “Türkiye kargo entegrasyonu” anahtar kelimesiyle arama yapın.
3. Tercih ettiğiniz uygulamayı seçin ve Install butonuna tıklayın.
4. Uygulama açıldıktan sonra Kargo Firmaları veya Taşıyıcı Ekle bölümüne gidin.
5. MNG Kargo’yu seçin; API kullanıcı adı, şifre ve müşteri kodunu girin.
6. Test Bağlantısı veya Doğrula butonuyla API erişimini onaylayın.
7. Gönderici adres bilgilerini ekleyin (MNG Kargo şube ataması burada yapılır).
8. Kargo etiket formatını seçin: A4 veya termal (100×150 mm).
9. Otomatik bildirim ayarlarını yapılandırın: sipariş oluşturulduğunda mı, kargoya verildiğinde mi?
10. Bir test siparişi oluşturarak etiketi doğrulayın.

Şimdi bunu somut rakamlarla görelim: Kolisi gibi Türkiye odaklı platformlar, MNG dahil 10’dan fazla kargo firmasını destekler ve entegrasyon kurulumu ortalama 30-45 dakika sürer. (Kolisi, 2025)

Yöntem 2: MNG’ye Özel Shopify Uygulaması

MNG Kargo’nun doğrudan Shopify App Store’da yayınladığı veya lisanslı partnerler aracılığıyla sunulan uygulamalar daha basit bir arayüz sunar. Genellikle ücretsiz veya düşük aylık ücretle başlar.

Kurulum adımları:

1. Shopify App Store’dan uygulamayı yükleyin.
2. MNG Kargo kurumsal hesap bilgilerini (müşteri kodu, API bilgileri) girin.
3. Gönderici adresini tanımlayın.
4. Kargo ücret kuralını ayarlayın: sabit ücret mi, ağırlık bazlı mı, ücretsiz kargo eşiği mi?
5. Sipariş durumu eşlemesini yapın: Shopify “Fulfilled” durumu MNG tarafında hangi duruma karşılık gelecek?

Bazı MNG özel uygulamaları yalnızca standart gönderi tipini destekler. Kapıda ödeme, taahhütlü veya ağır kargo gönderileriniz varsa çok-taşıyıcılı bir platform tercih edin.

Yöntem 3: MNG Kargo API ile Doğrudan Entegrasyon

Bir Shopify geliştiriciniz varsa MNG Kargo’nun REST API’sini Shopify’ın Webhook sistemiyle birleştirebilirsiniz. Bu yöntem, özel iş akışları (toplu etiket basımı, otomatik şube yönlendirme, kargo karşılaştırma) gerektiren mağazalar için uygundur.

Temel entegrasyon mantığı:

1. Shopify’da orders/create webhook’u tanımla.
2. Sipariş webhook tetiklendiğinde MNG Kargo API’sine gönderim isteği gönder.
3. API’den dönen tracking numarasını Shopify siparişine yaz.
4. Müşteriye otomatik bildirim gönder (Shopify notification veya SMS servisi).
5. Etiket PDF’ini Order metafield’ına veya harici depolama alanına kaydet.

MNG Kargo API belgeleri kurumsal entegrasyon departmanından temin edilir. Açık kaynak olarak paylaşılmamakta; API kimlik bilgileriyle birlikte iletilmektedir.

Kargo Etiketi Oluşturma ve Barkod Yapısı

MNG Kargo etiketi, gönderinin tüm yaşam döngüsünü takip eden standart bilgileri içerir. Hatalı etiket, teslimat gecikmesine ve iade maliyetine yol açar.

Etikette bulunması zorunlu bilgiler:

• Gönderici adı, adresi ve telefonu
• Alıcı adı, adresi (ilçe + şehir + posta kodu) ve telefonu
• MNG Kargo barkod numarası (sistemden otomatik atanır)
• Ürün ağırlığı ve desi değeri
• Servis türü (standart, taahhütlü, kapıda ödeme)
• Kapıda ödeme tutarı (varsa)

Etiket boyutu: Termal yazıcı için 100×150 mm veya A4 üzerine 2’li ya da 4’lü format.

Alıcı adresi alanında posta kodu eksikse MNG Kargo sistemi etiketi reddedebilir. Shopify’da müşteri adresi formunu zorunlu posta kodu alanıyla güncelleyin.

Kapıda Ödeme Entegrasyonu

MNG Kargo üzerinden kapıda ödeme gönderimi, ek bir servis kodu gerektirir. Shopify tarafında ise ödeme yöntemi olarak “Kapıda Ödeme”nin aktif edilmesi ve MNG tarafıyla tutarlı biçimde eşlenmesi gerekir.

Shopify’da kapıda ödeme aktifleştirme:

1. Settings > Payments > Manual payment methods
2. “Cash on Delivery” veya “Kapıda Ödeme” ekle
3. Kargo entegrasyon uygulamasında bu siparişler için MNG kapıda ödeme servis kodunu atayın
4. Tahsilat tutarının otomatik olarak etikete yazdırıldığını doğrulayın

Kapıda ödeme siparişlerinde alıcının ödemeyi teslimatta yapıp yapmadığının takibi için MNG Kargo’nun kurumsal paneline düzenli bakın ya da entegrasyon uygulamasının bunu Shopify’a geri yazdığını kontrol edin.

Otomatik Kargo Bildirimleri

MNG Kargo takip numarası oluşturulduktan sonra müşteriye üç farklı kanaldan bildirim gönderilebilir:

Kanal	Yöntem	Kurulum
E-posta	Shopify native notification	Shopify > Notifications > Shipping confirmation
SMS	Entegrasyon uygulaması + SMS servisi	İlgili uygulama ayarları
WhatsApp	Üçüncü taraf uygulama (örn. DelightChat)	Ayrı uygulama kurulumu
MNG web sitesi	Otomatik (takip numarasıyla)	Ek kurulum gerekmez

Shopify’ın yerleşik e-posta bildirim şablonunu özelleştirerek MNG Kargo takip bağlantısını https://www.mngkargo.com.tr/gondericiye-izleme adresiyle birleştirebilirsiniz. Takip numarası değişkeni {{ fulfillment.tracking_number }} olarak şablona yerleştirilir.

Sık Karşılaşılan Sorunlar ve Çözümleri

Entegrasyon sonrasında en sık bildirilen sorunlar ve çözüm adımları:

Sorun 1: API bağlantısı “Unauthorized” hatası veriyor
– MNG müşteri temsilcinizle API kullanıcısının aktif olduğunu doğrulayın
– Kullanıcı adı ve şifrede büyük/küçük harf duyarlılığını kontrol edin
– IP kısıtlaması varsa sunucu IP’nizi whitelist’e ekleyin

Sorun 2: Etiket oluşturuluyor ama barkod okunamıyor
– PDF baskı kalitesi minimum 300 DPI olmalı
– Termal yazıcı ayarlarını kontrol edin (koyu yoğunluk, kalibre)
– Etiket boyutunun yazıcı ayarıyla eşleştiğini doğrulayın

Sorun 3: Takip numarası müşteriye gitmiyor
– Shopify Notifications > Shipping confirmation şablonunun aktif olduğunu kontrol edin
– Entegrasyon uygulamasında “otomatik bildirim” ayarının açık olduğunu doğrulayın
– Test siparişiyle bildirimi manuel tetikleyin

Sorun 4: Desi hesabı yanlış, kargo maliyeti beklenenden yüksek
– Shopify’daki ürün ağırlıklarının gram cinsinden doğru girildiğini kontrol edin
– MNG Kargo desi hesabı: En (cm) × Boy (cm) × Yükseklik (cm) / 3000
– Gerçek ağırlık ve desi ağırlığından büyük olan faturalanır

MNG Kargo ile Diğer Shopify Kargo Entegrasyonlarının Karşılaştırması

Hangi kargo firmasının entegrasyonuna öncelik verileceğine karar vermek için şu karşılaştırmayı referans alın:

Kriter	MNG Kargo	Aras Kargo	Yurtiçi Kargo	PTT Kargo
Shopify App Store desteği	Evet (partner uygulamalar)	Evet	Evet	Sınırlı
API olgunluğu	Kurumsal (talep ile)	Kurumsal (talep ile)	Kurumsal (talep ile)	Kısıtlı
Kapıda ödeme	Evet	Evet	Evet	Evet
Şube ağı (2025)	3.600+	1.200+	2.400+	4.200+
İade yönetimi	Kurumsal panelden	Kurumsal panelden	Kurumsal panelden	Şubeden
Aylık hacim indirimi	500+ gönderiden	300+ gönderiden	500+ gönderiden	Değişken

Türkiye’de aylık 200’ün altında sipariş gönderen Shopify mağazaları için tek kargo firması yerine çok-taşıyıcılı bir uygulama kullanmak, müşteri lokasyonuna göre dinamik kargo seçimi yaparak teslimat süresini kısaltır.

Kargo Maliyetini Shopify Checkout’ta Gösterme

MNG Kargo entegrasyonu kuruluyken müşteriye checkout aşamasında dinamik kargo ücreti göstermek için iki yaklaşım kullanılır:

Yaklaşım 1: Sabit ücret (en basit)
Settings > Shipping and delivery > Shipping zones altında sabit kargo ücreti ve ücretsiz kargo eşiği tanımlayın. Gerçek MNG ücreti ile fark varsa marjdan karşılanır.

Yaklaşım 2: Gerçek zamanlı kargo ücreti (Carrier-calculated shipping)
Bu özellik yalnızca Shopify Advanced ve Plus planlarında yerleşik olarak gelir. Diğer planlarda ek uygulama veya API entegrasyonu gerektirir. Gerçek zamanlı hesaplama, müşteri adresini MNG API’sine gönderir ve anlık fiyat döndürür.

SSS

Shopify’da MNG Kargo entegrasyonu ücretsiz mi?
MNG Kargo API erişiminin kendisi ücretsizdir ancak entegrasyon için kullanacağınız Shopify uygulaması aylık 0-500 TL arasında ücret alabilir. Doğrudan API geliştirme yolunu seçerseniz yalnızca geliştirici maliyeti oluşur.

MNG Kargo API bilgilerini nasıl alabilirim?
MNG Kargo kurumsal müşteri hizmetlerini arayarak (444 0 664) veya kurumsal hesabınızın bağlı olduğu şube müdürüyle iletişime geçerek API kullanıcısı açtırabilirsiniz. Bu süreç genellikle 1-3 iş günü alır.

Kapıda ödeme siparişleri otomatik olarak etiket oluşturuyor mu?
Evet, entegrasyon uygulaması kapıda ödeme siparişlerini algılayacak şekilde yapılandırılabilir. MNG Kargo’nun kapıda ödeme servis kodunun uygulamada tanımlı olması gerekir.

Aynı Shopify mağazasında hem MNG hem Aras kullanabilir miyim?
Evet. Çok-taşıyıcılı kargo uygulamaları, sipariş ağırlığı, müşteri bölgesi veya ürün kategorisine göre farklı firmaya otomatik yönlendirme yapabilir. Bu yapı özellikle yüksek hacimli mağazalarda maliyet avantajı sağlar.

MNG Kargo entegrasyonu kurulumunda sorun yaşarsam ne yapmalıyım?
İlk adımda kullandığınız Shopify uygulamasının destek ekibine başvurun. Sorun MNG API tarafındaysa MNG kurumsal destek hattıyla (444 0 664) iletişime geçin. MNG API belgesi için ise kurumsal entegrasyon departmanını isteyin.

Shopify ile MNG kargo entegrasyonu hangi Shopify planında çalışır?
Üçüncü taraf uygulama tabanlı entegrasyon tüm Shopify planlarında (Basic dahil) çalışır. Gerçek zamanlı kargo ücreti hesaplama özelliği ise Advanced ve Plus planlarında yerleşik olarak gelir; diğer planlar ek uygulama gerektirir.

MNG Kargo entegrasyonu kurmadan önce Shopify’da kargo bölgesi tanımlamalı mıyım?
Evet. Settings > Shipping and delivery altında en az bir kargo bölgesi tanımlanmamışsa Shopify checkout’ta kargo seçeneği görünmez. Entegrasyon uygulaması bu bölge ayarlarını okuyarak çalışır.

Sonuç: Bir Sonraki Adım

MNG Kargo entegrasyonu, Shopify mağazanızdaki sipariş yönetimini manuel iş yükünden büyük ölçüde kurtarır. Günlük sipariş hacminiz 10’un altındaysa basit bir Shopify uygulaması yeterli olacaktır; hacminiz büyüdükçe çok-taşıyıcılı bir platform veya doğrudan API entegrasyonu daha ölçeklenebilir bir altyapı sunar.

Kargo altyapısını tamamladıktan sonra Shopify Yurtiçi Kargo Entegrasyonu Rehberi ve Shopify Aras Kargo Entegrasyonu Rehberi içeriklerine göz atarak tüm kargo firmalarını tek bir panel üzerinden yönetme seçeneklerini değerlendirin. Kapıda ödeme oranınızı artırmak istiyorsanız Shopify Taksitli Ödeme Rehberi bir sonraki okuma olabilir.