Blog içeriği
February 26, 2026

MNG Kargo Shopify Entegrasyonu: Kurulum ve Yapılandırma Rehberi

MNG Kargo Shopify entegrasyonu nasıl kurulur? API sözleşmesi, doğru uygulama seçimi ve test adımlarıyla eksiksiz kurulum rehberi.

Bu konuda sık karşılaştığımız bir varsayım şu: "Yurtiçi ve Aras'ın resmi uygulaması var, MNG'ninki yok, o yüzden MNG daha zor." Gerçek biraz farklı: Shopify App Store sayfalarını tek tek kontrol ettiğimizde, Türkiye'deki hiçbir kargo firmasının (MNG dahil Yurtiçi ve Aras da) kendi adına yayınlanmış bir uygulaması olmadığını gördük. Fark, MNG'ye özel tek-firma bir üçüncü parti uygulamanın Yurtiçi/Aras'a kıyasla daha sınırlı olmasında. Bu rehberde MNG Kargo'nun Shopify'a gerçekte nasıl bağlandığını, hangi üçüncü parti seçeneklerin gerçekten mevcut olduğunu ve kurulum sonrası doğrulamayı ele alıyoruz.

MNG Kargo Shopify Entegrasyonu Nedir ve Nasıl Çalışır?

MNG Kargo Shopify entegrasyonu, Shopify mağazanızdaki sipariş verisini MNG Kargo'nun API sistemiyle senkronize eden ve kargo etiketi üretimini, takip numarası iletimini ve teslimat bildirimlerini otomatikleştiren bağlantı altyapısıdır. Bu bağlantı MNG Kargo'nun kendisi tarafından değil, MNG'nin kurumsal API'sine bağlanan üçüncü parti bir uygulama (Kargo Entegratör, Pax) veya özel geliştirme üzerinden kurulur.

MNG Kargo, Türkiye'de 600'den fazla şubesiyle özellikle İstanbul, Ankara ve İzmir'de 600'ü aşan şube sayısıyla geniş bir dağıtım ağına sahiptir. Büyük şehirler ve organize sanayi bölgelerine yapılan B2B gönderimlerinde MNG sektörde köklü bir güvenilirliğe sahiptir. Aylık 500'ün üzerinde gönderi yapan e-ticaret mağazaları için anlaşmalı kargo fiyatları rekabetçi düzeye inebilmektedir.

Bu rehber, aktif bir Shopify mağazanız olduğunu varsayıyor. Mağazanız henüz kurulum aşamasındaysa Shopify mağaza kurulum hizmetimiz kargo API bağlantıları dahil teknik altyapıyı baştan doğru sırayla kurar; sonradan kargo entegrasyonu eklemek yerine ilk kurulumda planlamak, ileride API kimlik bilgisi veya webhook uyumsuzluğu yaşama riskini azaltır.

MNG Kargo ile Rakip Firmaların Shopify Uyumluluğu Karşılaştırması

Aşağıdaki tablo beş büyük kargo firmasının gerçek Shopify uyumluluğunu gösteriyor; hiçbirinde kargo firmasının kendi yayınladığı resmi bir uygulama yok, fark yalnızca üçüncü parti kapsamının genişliğinde.

Kargo Firması Kargo Firmasının Kendi Uygulaması Shopify Entegrasyon Yolu
MNG Kargo Hayır Kargo Entegratör (Gurmehub), Pax MNG/DHL veya özel API
Yurtiçi Kargo Hayır Pax: Yurtiçi Kargo (üçüncü parti, dedike) veya Kargo Entegratör
Aras Kargo Hayır Pax: Aras Kargo (üçüncü parti, dedike) veya Kargo Entegratör
Sürat Kargo Hayır Kargo Entegratör (en yaygın seçenek)
PTT Kargo Hayır Kargo Entegratör

Kritik Not: Bu tabloyu daha önce "Yurtiçi ve Aras'ın resmi uygulaması var, MNG'ninki yok" şeklinde okuyorduysanız düzeltelim: hiçbiri kargo firmasının kendisi tarafından yayınlanmış değil. Aradaki gerçek fark, MNG için doğrudan tek-firma dedike bir uygulamanın (Pax'ın Yurtiçi/Aras için sunduğu gibi) henüz bulunmaması; MNG'ye özel entegrasyon ihtiyacı çok-firmalı bir entegratör, MNG'yi DHL ile birlikte kapsayan bir uygulama veya özel geliştirmeyle karşılanıyor.

MNG Kargo Kurumsal Sözleşmesi ve API Erişimi

Sözleşme Süreci

MNG Kargo'nun API'sine erişmek için önce kurumsal müşteri sözleşmesi imzalanmalıdır; bu süreç genellikle 5-10 iş günü sürer. mngkargo.com.tr üzerinden Kurumsal Çözümler bölümünden müşteri temsilcisi talep formu doldurun. Temsilci size ulaşacak ve aylık gönderi hacminizi, ürün tiplerinizi ve teslimat bölgelerinizi soracaktır. Aylık 500 gönderi taahhüdü verebiliyorsanız bu bilgiyi görüşme sırasında belirtin; anlaşmalı fiyat müzakeresi daha hızlı başlar.

API Kimlik Bilgileri

MNG Kargo API entegrasyonu için gereken bilgiler: müşteri kodu (CustomerCode), API kullanıcı adı ve şifresi (Username/Password), şube kodu (BranchCode, bazı bölgeler için zorunlu), production ve sandbox endpoint URL'leri. Bu bilgiler Shopify'a değil, seçtiğiniz üçüncü parti uygulamaya veya özel geliştirdiğiniz entegrasyona tanımlanır; MNG kurumsal portalı veya bayi temsilciniz size iletir.

Uzak Durulması Gereken Risk: MNG Kargo API kimlik bilgileri periyodik güvenlik güncellemeleriyle yenilenir. Entegrasyon sonrasında kargo etiketleri ani olarak oluşturulamamaya başlarsa ilk kontrol adımınız API şifresinin güncel olup olmadığını doğrulamak olmalıdır.

MNG Kargo'yu Shopify'a Bağlamanın Gerçek Yolları

MNG Kargo'yu Shopify'a bağlamak için üç gerçek yol var: çok-firmalı bir entegratör, MNG'yi DHL ile birlikte kapsayan Pax uygulaması veya özel API geliştirmesi. Aşağıdaki tabloda, Shopify App Store'daki uygulama sayfalarını tek tek kontrol ederek doğruladığımız seçenekleri özetliyoruz; Türkçe kaynaklarda geçen bazı "middleware" isimleri bu kontrolden geçemedi ve makaleye alınmadı.

Seçenek Kapsam Aylık / Yıllık Maliyet
Kargo Entegratör (Gurmehub) MNG dahil Yurtiçi, Aras, PTT, Sürat gibi çoklu firma; toplu barkod, AI adres düzeltme, iade barkodu $12.99 - $63 / ay
(İlk 25 gönderi ücretsiz)
Pax MNG / DHL Kargo MNG'yi DHL ile birlikte kapsayan uygulama; kapıda ödeme tutarını sipariş toplamından otomatik alma $9.99 / ay'dan başlıyor
Station (Nodus Works) Kargo + pazaryeri + ön muhasebe tek panelde; MNG dahil kargo firmalarıyla entegrasyon 999 USD + KDV / yıl
(Peşin ödeme)
Özel API Geliştirmesi MNG REST API'sinin doğrudan Shopify webhook'larına bağlanması Proje bazlı
(Tek seferlik geliştirme maliyeti)

Yöntem A: Kargo Entegratör (Gurmehub) ile Entegrasyon

Kargo Entegratör, MNG dahil 10'dan fazla kargo firmasını tek panelde birleştiren bir Shopify uygulaması; App Store'da 17 değerlendirmeye sahip ve MNG Kargo'ya özel ayrı bir kurulum rehberi de kendi sitesinde bulunuyor. Kurulum adımları:

  • apps.shopify.com üzerinden Kargo Entegratör uygulamasını yükleyin.
  • Uygulama panelinde MNG Kargo'yu kargo firması olarak ekleyin.
  • MNG API bilgilerinizi (CustomerCode, Username, Password) uygulamaya girin.
  • Kargo kurallarını tanımlayın: hangi sipariş tipinde MNG'nin kullanılacağını belirleyin.
  • Test siparişi oluşturun ve etiketi doğrulayın.

Birden fazla kargo firmasıyla (örneğin MNG ve Yurtiçi'yi aynı anda) çalışıyorsanız, bu çok-firmalı yapı ayrı ayrı tek-firma uygulaması kurmaktan daha az yönetim yükü getirir.

Yöntem B: Pax'ın MNG/DHL Kargo Uygulaması

Pax'ın geliştirdiği uygulama, Shopify App Store'da "DHL Kargo Entegrasyonu" adıyla listelense de MNG kategorisi altında da yer alıyor; MNG'nin Türkiye'de DHL eCommerce ile olan ortaklığı nedeniyle iki markayı aynı uygulama üzerinden kapsıyor. Kargo takip kodunu sipariş içine otomatik ekler, müşteriyi e-posta ve SMS ile bilgilendirir, teslim edilen siparişleri otomatik arşivler; gönderici ödemeli ve kapıda ödemeli kargo türlerinde tahsilat tutarını sipariş toplamından otomatik hesaplar.

Yöntem C: Station ile Çok Kanallı Operasyon Yönetimi

Yalnızca MNG değil, birden fazla kargo firmasını, pazaryeri siparişlerini ve ön muhasebe süreçlerini tek panelden yönetmek isteyen mağazalar için Station, kargo entegrasyonunu daha geniş bir operasyon yönetimi katmanının parçası olarak sunuyor. Tek amaçlı bir kargo uygulaması yerine kargo sürecini stok ve muhasebe akışıyla birlikte yönetmek isteyen mağazalar için bu tercih, daha az araç ve tek panel anlamına geliyor.

Yöntem D: Özel API Geliştirmesi

Aylık 2000'den fazla sipariş işleyen, ERP veya WMS sistemiyle çalışan ya da özelleştirilmiş depo iş akışlarına ihtiyaç duyan mağazalar için özel API geliştirmesi iş akışını sınırlamadan tam özelleştirme imkânı verir. Bu yöntemde MNG Kargo'nun REST API'si doğrudan Shopify webhook'larına bağlanır; üçüncü parti uygulama abonelik maliyeti ortadan kalkar ve iş akışı tam olarak özelleştirilebilir. Shopify entegrasyon çözümleri ve özel uygulama geliştirme hizmetimiz, bu tür kurumsal MNG Kargo entegrasyon projelerini sıfırdan kurar.

İpucu: MNG için hangi uygulamayı seçerseniz seçin, kurulum öncesi o uygulamanın MNG desteğini güncel olarak sunduğunu App Store sayfasından veya destek ekibinden teyit edin. Üçüncü parti uygulamaların desteklediği kargo firması listesi zaman içinde değişebilir; bu makaledeki bulgularımız bile bazı yaygın "middleware" iddialarının artık geçerli olmadığını gösterdi.

Kurulum Sonrası Test ve Doğrulama

MNG Kargo entegrasyonu canlıya alınmadan önce en az beş farklı senaryo üzerinde test yapılmalıdır. Bir özelliğin test edilmeden atlanması, canlı ortamda müşterileri etkileyen hataya dönüşür.

Test Senaryoları

  • Standart sipariş: Etiketi oluşturuluyor mu? Takip numarası Shopify siparişine düşüyor mu?
  • Ağır sipariş (5 kg+): Desi hesabı doğru çalışıyor mu? Fiyat hesaplaması tutarlı mı?
  • Farklı şehirler: İstanbul dışı teslimat adreslerinde etiket üretimi sorunsuz mu?
  • İptal edilen sipariş: İptal durumunda kargo sistemi nasıl tepki veriyor?
  • İade siparişi: Müşteriden gelen iade kargosu sisteme doğru kaydediliyor mu?

MNG Kargo Entegrasyonunda Yaygın Sorunlar

MNG Kargo Shopify entegrasyonunda karşılaşılan sorunların büyük çoğunluğu uygulama bağlantı yapılandırmasından, API kimlik bilgilerinden ve Shopify ürün veri eksikliklerinden kaynaklanır.

Sorun: Uygulama Bağlantısı Kesildi

Çözüm: Kullandığınız uygulamanın (Kargo Entegratör, Pax) gösterge panelini kontrol edin. Bağlantı durumu kırmızıya dönmüşse genellikle MNG API şifresi yenilenmiştir. MNG kurumsal portalından güncel şifreyi alın ve uygulamanın bağlantı ayarlarına girin.

Sorun: Kargo Etiketi Oluşturulmuyor

Çözüm: Teslimat adresinde il/ilçe bilgisinin MNG sistemindeki bölge kodu formatıyla uyuşup uyuşmadığını kontrol edin; ayrıca siparişteki ürünün ağırlık bilgisinin eksik olmadığından emin olun. MNG, bazı küçük yerleşim yerlerinin adres formatını kabul etmeyebilir; bu durumda yakın büyük ilçeye yönlendirme yapmanız gerekebilir.

Sorun: Takip Numarası Siparişe veya Müşteriye Düşmüyor

Çözüm: Uygulamanın webhook ayarlarını kontrol edin. Shopify ve uygulama arasındaki webhook URL'nin aktif olduğunu doğrulayın; bazı platform güncellemelerinden sonra webhook URL'leri sıfırlanabilir. Shopify'ın e-posta bildirim şablonunda takip numarası değişkeninin mevcut olduğunu da doğrulayın, özelleştirilmiş şablonlarda bu alan silinmiş olabilir.

Sıkça Sorulan Sorular

MNG Kargo'nun Shopify uygulaması var mı?

MNG Kargo'nun kendi markasıyla yayınladığı bir uygulama yok; bu durum yalnızca MNG'ye özel de değil, Yurtiçi ve Aras'ın da resmi uygulaması yok. Kargo Entegratör (Gurmehub) ve Pax'ın MNG/DHL uygulaması gibi üçüncü parti uygulamalar MNG'yi doğrudan Shopify içinden destekliyor ve özel API geliştirmesi maliyetini ortadan kaldırıyor.

MNG Kargo kurumsal sözleşmesi için minimum hacim şartı nedir?

MNG Kargo, kurumsal API erişimi için genellikle aylık 500 gönderi taahhüdü talep etmektedir. Bu eşiğin altında kalan mağazalar için MNG tercih edilirse, aylık uygulama abonelik ücreti düşük gönderi hacmine bölündüğünde gönderi başına maliyet Yurtiçi veya Aras'a göre daha yüksek çıkabilir.

MNG Kargo ile Shopify'da aynı anda Aras veya Yurtiçi kullanabilir miyim?

Evet. Kargo Entegratör veya Station gibi çok-firmalı bir entegratör kullanarak birden fazla kargo firmasını tek panelden, farklı teslimat bölgelerine atayarak yönetebilirsiniz; örneğin İstanbul içi siparişler MNG, diğer şehirler Yurtiçi.

MNG Kargo API entegrasyonu ne kadar sürer?

MNG Kargo API bilgileri temin edildikten sonra Kargo Entegratör gibi hazır bir uygulama kullanılıyorsa teknik kurulum birkaç saat içinde tamamlanabilir. Özel API geliştirmesi ise iş gereksinimlerinize bağlı olarak 2-5 iş günü alır. Buna sözleşme sürecini (5-10 iş günü) de eklemek gerekir.

MNG Kargo Shopify için uygun mu?

MNG Kargo, aylık 500'ün üzerinde sipariş işleyen ve İstanbul ile Ankara gibi büyük şehirlere yoğun gönderim yapan mağazalar için uygun bir seçenektir. Daha düşük hacimli mağazalar için minimum gönderi şartı olmayan Yurtiçi veya Aras, hacim taahhüdü gerektirmediği için daha uygun bir başlangıç noktasıdır.

Shopify'da birden fazla kargo firması nasıl kullanılır?

Shopify'da birden fazla kargo firması Settings → Shipping and delivery → Manage bölümünden farklı teslimat bölgelerine farklı firmalar atanarak kullanılır. Kargo Entegratör veya Station gibi uygulamalar ise tüm firmaları tek panel üzerinden yöneterek sipariş özelliklerine göre (ağırlık, bölge, hız) otomatik kurye seçimi yapabilir.

Sonuç: Doğru MNG Entegrasyonu, Hacminize Göre Değişir

MNG Kargo Shopify entegrasyonu, resmi bir uygulama beklentisiyle değil, çok-firmalı bir entegratör, Pax'ın MNG/DHL uygulaması veya özel API geliştirmesiyle doğru kurulur. Bu, MNG'yi Yurtiçi veya Aras'tan "daha zor" yapmaz; yalnızca kurulumda hangi seçeneğin gerçekten mevcut olduğunu baştan netleştirmeyi gerektirir. Aylık 500'den az sipariş işliyorsanız önce Yurtiçi veya Aras Kargo'nun dedike Shopify uygulamalarıyla başlamanızı, hacminiz büyüdükçe MNG'yi Kargo Entegratör veya Pax üzerinden portföyünüze eklemenizi öneririz.

Kargo dışında pazaryeri ve muhasebe süreçlerinizi de tek panelde toplamak isterseniz Station çözümümüzü inceleyebilir, kurulum sürecini uçtan uca planlamak için Shopify entegrasyon çözümleri hizmetimiz hakkında ekibimizle iletişime geçebilirsiniz. Türkiye'deki tüm kargo firmalarını karşılaştırmalı değerlendirmek için Shopify Kargo Entegrasyonu: Eksiksiz Rehber yazımıza, Shopify'a geçiş yapıyorsanız Shopify'a Geçiş Teknik Rehberi yazımıza göz atın.

MNG Kargo entegrasyonunuzu Nodus Works ile kurmak ister misiniz? İlk görüşme ücretsizdir, ücretsiz danışmanlık görüşmesi talep edin.