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

Shopify MNG Kargo Entegrasyonu Nedir? Shopify MNG Kargo entegrasyonu, MNG Kargo’nun kurumsal API’sini bir entegratör firma veya özel yazılım katmanı üzerinden Shopify mağazasına bağlayarak sipariş verisinin otomatik kargo kaydına dönüştürülmesini sağlayan teknik süreçtir.

MNG Kargo, Aras Kargo gibi Shopify App Store’da resmi bir uygulama yayınlamaz; bağlantı kurumsal API entegrasyonu veya çok kargolu entegratör yazılımlar üzerinden kurulur (MNG Kargo Kurumsal, 2025). Bu firma, özellikle e-ticaret odaklı büyük hacimli mağazalar arasında tercih edilir çünkü kurumsal API’si sipariş durumu senkronizasyonunu gerçek zamanlıya yakın çalıştırır. Sipariş-kargo eşleştirmesinin doğru kurulması, MNG Kargo entegrasyonunda en kritik teknik adımdır.

MNG Kargo entegrasyonunu diğer firmalardan ayıran nokta, API’sinin sunduğu durum güncelleme (status webhook) zenginliğidir. Bu rehber API bağlantı sürecini, entegratör seçimini ve sipariş eşleştirme mantığını adım adım açıklar.

Kurumsal e-ticaret mağazalarının MNG Kargo’yu tercih etme nedeni genelde günlük yüksek gönderi hacminde şube ağının genişliği ve API’nin toplu işlem desteğidir. Küçük ölçekli bir mağaza için bu avantajlar öncelikli olmayabilir, ama günlük 100’ün üzerinde sipariş gönderen bir işletme için toplu etiket basımı ve toplu durum sorgusu operasyonel zaman kazandırır.

MNG Kargo Shopify’a Nasıl Entegre Edilir?

MNG Kargo Shopify’a entegre edilirken önce kurumsal anlaşma yapılır, ardından ya doğrudan API bağlantısı geliştirilir ya da bir entegratör firma üzerinden bağlantı kurulur; her iki yöntemde de MNG Kargo’nun API kimlik bilgileri (kullanıcı kodu, şifre, müşteri numarası) gereklidir.

Doğrudan API bağlantısı, Shopify’ın orders/create webhook’unu dinleyip veriyi MNG Kargo’nun REST API’sine ileten özel bir yazılım gerektirir. Bu yöntem sipariş akışını mağazanın özel kurallarına göre şekillendirme imkanı sunar.

1. MNG Kargo Kurumsal Satış ile görüşülüp anlaşma ve müşteri numarası alınır.
2. MNG Kargo API dokümantasyonu üzerinden kullanıcı kodu ve şifre bilgisi temin edilir.
3. Entegratör uygulama kullanılacaksa Shopify App Store’dan ilgili çok kargolu uygulama kurulur; özel API tercih edilirse geliştirici webhook entegrasyonunu kurar.
4. API kimlik bilgileri sisteme tanımlanır ve sandbox ortamında test kargo kaydı oluşturulur.
5. Canlı ortama geçiş öncesi barkod ve etiket çıktısı fiziksel olarak test edilir.

İpucu: MNG Kargo API dokümantasyonu, durum güncellemelerini (kargoya verildi, dağıtıma çıktı, teslim edildi) ayrı webhook uç noktaları olarak sunar. Bu uç noktaların tamamı entegre edilirse müşteri bildirimleri her aşamada otomatik tetiklenebilir, sadece “kargoya verildi” aşamasında kalınmaz.

Entegratör Firma mı, Özel API mi Tercih Edilmeli?

Entegratör firma kullanımı hızlı ve düşük teknik risk taşırken, özel API entegrasyonu daha esnek ama daha uzun geliştirme süreci gerektirir; seçim mağazanın sipariş hacmine ve özel kural ihtiyacına göre yapılmalıdır.

Entegratör firmalar, MNG Kargo dahil birden fazla kargo sağlayıcısını tek panelde birleştirir ve aylık abonelik ücretiyle çalışır. Özel API entegrasyonu ise bir kerelik geliştirme maliyeti taşır ama uzun vadede işlem başına ek ücret ödenmez.

Kritik Not: Entegratör firma seçerken uygulamanın MNG Kargo ile “resmi API ortağı” statüsünde olup olmadığı kontrol edilmelidir. Resmi ortaklığı olmayan bazı üçüncü parti araçlar API değişikliklerinde gecikmeli güncelleme yapar ve kısa süreli kesinti yaşatabilir.

Sipariş-Kargo Eşleştirme Nasıl Çalışır?

Sipariş-kargo eşleştirme, Shopify’daki her siparişin benzersiz sipariş numarasının MNG Kargo tarafındaki gönderi numarasıyla birebir ilişkilendirilmesiyle çalışır; bu eşleştirme olmadan kargo durumu Shopify sipariş paneline geri yansıtılamaz.

Eşleştirme genelde sipariş numarasının kargo firması tarafında “referans numarası” alanına yazılmasıyla kurulur. Bu referans alanı, iki sistem arasındaki tek bağlantı noktasıdır ve hatalı yazıldığında kargo durumu güncellemesi sipariş kaydına ulaşmaz.

Peki bu eşleştirme neden bu kadar kritik? Referans numarası eşleşmezse müşteri “siparişim nerede” sorusunu sorduğunda destek ekibi Shopify panelinde güncel kargo durumunu göremez ve MNG Kargo’nun ayrı takip sayfasına manuel bakmak zorunda kalır.

Uzak Durulması Gereken Risk: Sipariş numarası formatı Shopify’da özel karakterler (# işareti gibi) içerdiğinde bazı entegratör uygulamalar bu karakteri referans alanına aktarırken hata verir. Referans alanı test sırasında sadece sayısal veya alfanümerik format kullanılarak doğrulanmalıdır.

MNG Kargo Aras Kargo’dan Hangi Noktalarda Ayrışır?

MNG Kargo ile Aras Kargo arasındaki temel teknik fark API’nin sunduğu durum webhook zenginliğidir; MNG Kargo daha fazla ara durum bildirimi sağlarken, iki firma da Shopify App Store’da resmi uygulama bulundurmaz.

Bu fark, sık müşteri bildirimi göndermek isteyen mağazalar için MNG Kargo’yu öne çıkarabilir. Genel kargo firması karşılaştırması ve seçim kriterleri Shopify kargo entegrasyonu rehberinde işlenir; Aras Kargo’nun kurumsal anlaşma ve barkod entegrasyon süreci ise Shopify Aras Kargo entegrasyonu rehberinde detaylandırılır.

Sipariş-kargo eşleştirmesi tamamlandıktan sonra kargo takip numarasının müşteriye otomatik ulaştırılması ayrı bir kurulum gerektirir; bu süreç kargo takip numarası otomatik oluşturma rehberinde anlatılır.

MNG Kargo API Dokümantasyonu Hangi Teknik Detayları İçerir?

MNG Kargo API dokümantasyonu, kimlik doğrulama (kullanıcı kodu, şifre, müşteri numarası), gönderi oluşturma, barkod/etiket üretme ve durum sorgulama olmak üzere dört ana uç nokta grubunu tanımlar; bu dokümantasyon yalnızca kurumsal anlaşma sonrası erişime açılır.

Kimlik doğrulama katmanı, her API isteğinde kullanıcı kodu ve şifrenin istek gövdesine (body) eklenmesini gerektirir; bazı entegrasyon senaryolarında ek olarak bir oturum anahtarı (session token) alınıp belirli bir süre geçerli kalacak şekilde kullanılır. Gönderi oluşturma uç noktası, alıcı adresi, ağırlık, desi ve ödeme tipi (gönderici öder / alıcı öder) bilgilerini işleyerek bir gönderi numarası döndürür.

Durum sorgulama uç noktası, tek bir gönderi numarasıyla ya da toplu sorgu ile birden fazla gönderinin güncel durumunu döndürebilir. Toplu sorgu seçeneği, yüksek hacimli mağazalarda her siparişi tek tek sorgulamak yerine belirli aralıklarla toplu durum çekmeyi mümkün kılar ve API çağrısı sayısını azaltır.

İpucu: Toplu durum sorgusu desteği olan bir entegrasyon aracı seçmek, yüksek sipariş hacminde API rate limit sınırına takılma riskini önemli ölçüde azaltır. Her siparişi ayrı ayrı sorgulayan bir kurulum, sipariş sayısı arttıkça orantısız şekilde daha fazla API isteği üretir.

MNG Kargo Barkod ve Etiket Formatı Nasıl Yapılandırılır?

MNG Kargo barkod ve etiket formatı, gönderi oluşturma isteğine yanıt olarak dönen PDF veya ZPL (Zebra Programming Language) formatındaki etiket verisinin depo tarafındaki yazıcıya uygun biçimde işlenmesiyle yapılandırılır; yanlış format seçimi etiketin termal yazıcıda okunmaz çıkmasına neden olur.

PDF formatı, standart lazer yazıcılarla uyumludur ve düşük hacimli mağazalar için yeterlidir. ZPL formatı ise termal etiket yazıcılarına doğrudan gönderilecek şekilde tasarlanmıştır ve yüksek hacimli depo operasyonlarında etiket basım hızını artırır çünkü PDF’e kıyasla işlenmesi daha az işlemci kaynağı gerektirir.

Kritik Not: Termal yazıcı kullanan bir depo, entegrasyon aracından yanlışlıkla PDF formatı talep ederse etiketler ya hiç basılmaz ya da bozuk çıktı verir. Format seçimi, entegrasyon kurulumunun ilk aşamasında depodaki fiziksel yazıcı donanımına göre netleştirilmelidir.

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

MNG Kargo entegrasyonunda en sık karşılaşılan hata, adres alanlarının (il, ilçe, mahalle) MNG Kargo’nun kendi coğrafi kod tablosuyla eşleşmemesidir; bu uyumsuzluk gönderi oluşturma isteğinin “geçersiz adres” hatasıyla reddedilmesine yol açar.

MNG Kargo, adres bilgisini serbest metin yerine kendi il/ilçe kod tablosuna göre işler. Shopify’daki adres alanı serbest metin girişine izin verdiği için müşterinin yazdığı ilçe adı MNG Kargo’nun kod tablosundaki resmi adla birebir örtüşmeyebilir özellikle kısaltma veya yazım farkı olan ilçelerde bu sorun sık görülür.

İkinci yaygın hata, desi/ağırlık bilgisinin Shopify ürün kartında tanımlı olmaması veya varsayılan bir değerle gönderilmesidir. MNG Kargo, ücretlendirmeyi gerçek desi üzerinden yaptığı için eksik desi bilgisi hem hatalı faturalandırmaya hem bazı durumlarda gönderi reddine neden olabilir.

1. Adres alanları, entegrasyon kurulumunda MNG Kargo’nun il/ilçe kod tablosuna karşı bir eşleştirme katmanından geçirilmelidir.
2. Her ürün kartına gerçek ağırlık ve desi bilgisi girilmeli, varsayılan değerle gönderim yapılmamalıdır.
3. Test aşamasında az bilinen veya kısaltmalı ilçe adlarıyla en az 3 örnek sipariş denenmelidir.

Uzak Durulması Gereken Risk: Adres eşleştirme katmanı kurulmadan canlıya geçen mağazalarda, özellikle küçük ilçelerden gelen siparişlerin bir kısmı gönderi oluşturma aşamasında sessizce hata verip manuel müdahale kuyruğuna düşer. Bu, fark edilmediği sürece teslimat gecikmesi olarak müşteriye yansır.

MNG Kargo İade Süreci Shopify’a Nasıl Yansır?

MNG Kargo iade süreci, müşterinin ürünü MNG Kargo şubesine teslim etmesi ve bu iade gönderisinin ayrı bir gönderi numarasıyla takip edilmesiyle işler; bu iade gönderi numarası orijinal sipariş takip numarasından farklıdır ve Shopify’ın standart Fulfillment akışına otomatik yazılmaz.

İade sürecinin Shopify tarafına yansıması için entegrasyon aracının MNG Kargo’nun iade/ters lojistik API’sini ayrıca dinlemesi gerekir. Bu ek entegrasyon kurulmadığında iade durumu yalnızca MNG Kargo’nun kendi kurumsal panelinden takip edilebilir, Shopify sipariş sayfasında görünmez.

İpucu: İade hacmi düzenli olan mağazalar, MNG Kargo’nun iade API’sini sipariş notuna otomatik yazacak bir kural talep etmelidir. Bu kural olmadan müşteri hizmetleri, her iade sorgusunda MNG Kargo’nun ayrı panelini kontrol etmek zorunda kalır.

MNG Kargo Entegrasyonunda Bölgesel Teslimat Süresi Nasıl Yönetilir?

Bölgesel teslimat süresi yönetimi, MNG Kargo’nun şube ağı yoğunluğuna göre farklı illerde farklı ortalama teslimat süresi sunmasından kaynaklanır; büyükşehirlerde 1 iş günü, uzak bölgelerde 2-3 iş güne kadar çıkan bu fark checkout sayfasında doğru gösterilmezse müşteri beklentisiyle gerçek teslimat arasında uyumsuzluk oluşur.

MNG Kargo’nun API’si, gönderi oluşturma isteğine yanıt olarak tahmini teslimat süresini de döndürebilir; bu bilgi entegrasyon aracı tarafından çekilip sipariş onay sayfasında veya bildirim e-postasında gösterilirse müşteri “siparişim ne zaman gelir” sorusunu kendi başına yanıtlayabilir.

Peki bu bilgi gösterilmezse ne olur? Müşteri, checkout sırasında gördüğü genel “2-4 iş günü” gibi belirsiz bir ifadeye güvenip kendi bölgesindeki gerçek süreyi bilmeden sipariş verir; teslimat üçüncü günü aştığında destek talebi açma olasılığı artar.

İpucu: MNG Kargo API’sinden dönen tahmini teslimat süresi bilgisinin, ürün sayfasında değilse bile en azından sipariş onay e-postasında gösterilmesi, “siparişim nerede” tipi destek taleplerini azaltan düşük maliyetli bir iyileştirmedir.

MNG Kargo Kapıda Ödeme Seçeneğiyle Nasıl Çalışır?

MNG Kargo kapıda ödeme seçeneği, Shopify’da ödeme yöntemi olarak “kapıda ödeme” tanımlandığında gönderi oluşturma isteğine ek bir tahsilat tutarı parametresinin eklenmesiyle çalışır; bu parametre, kargo görevlisinin teslimat sırasında tahsil edeceği tutarı MNG Kargo sistemine bildirir.

Kapıda ödeme kullanan mağazalarda, entegrasyon aracının sipariş tutarını doğru para birimi ve KDV dahil formatta MNG Kargo’nun tahsilat alanına yazması kritik bir adımdır. Tutar hatalı aktarılırsa kargo görevlisi ya eksik ya fazla tahsilat yapar, bu da hem müşteri hem mağaza için muhasebe uyuşmazlığı doğurur.

Kritik Not: Kapıda ödeme kullanan mağazalar, kampanya döneminde uygulanan indirimlerin sipariş tutarına doğru yansıdığından emin olmalıdır. Entegrasyon aracı indirim öncesi tutarı MNG Kargo’ya gönderirse, kargo görevlisi müşteriden fazla tahsilat talep eder ve bu durum teslimat noktasında anlaşmazlığa yol açar.

Kapıda ödeme seçeneğinin sanal POS sağlayıcılarına kıyasla nakit akışı ve iade süreci farklı işler; bu farkın işletme muhasebesine etkisi ve alternatif ödeme yöntemlerinin karşılaştırması Shopify ödeme entegrasyonu rehberinde ayrıntılı ele alınır.

MNG Kargo Desi Hesaplaması Kargo Maliyetini Nasıl Etkiler?

MNG Kargo desi hesaplaması, gönderinin en/boy/yükseklik ölçülerinin belirli bir sabit değere bölünmesiyle bulunan hacimsel ağırlığın gerçek ağırlıkla karşılaştırılıp yüksek olanın faturalandırmaya esas alınmasıyla çalışır; bu yöntem, hafif ama hacimli ürünlerde kargo maliyetini gerçek ağırlığa göre önemli ölçüde yükseltebilir.

Bir mağaza ürün kartlarına yalnızca gerçek ağırlığı girip kutu ölçülerini boş bırakırsa, entegrasyon aracı desi hesaplamasını yapamaz ve MNG Kargo kendi standart varsayılan desi değerini uygular. Bu varsayılan değer, gerçek kutu boyutundan büyük çıkarsa mağaza gereğinden fazla kargo ücreti öder; küçük çıkarsa MNG Kargo teslimat noktasında ek ücret talep edebilir.

Peki bu fark hangi ürün kategorisinde daha çok görülür? Hafif ama kutulu ürünler (örneğin dekorasyon eşyası, oyuncak, bazı elektronik aksesuar) gerçek ağırlığı düşük olsa da kutu hacmi büyük olduğu için desi bazlı ücretlendirmede gerçek ağırlığın kat kat üzerinde bir tutara tabi olabilir.

İpucu: Her ürün kartına gerçek kutu ölçülerinin (en, boy, yükseklik) girilmesi ve entegrasyon aracının bu veriyi MNG Kargo’nun desi formülüne göre hesaplayıp gönderi isteğine eklemesi, hem doğru faturalandırma hem de kargo maliyetinin ürün fiyatlandırmasına doğru yansıtılması için gereklidir.

Sık Sorulan Sorular

MNG Kargo’nun resmi Shopify uygulaması var mı? Hayır, MNG Kargo Shopify App Store’da resmi bir uygulama yayınlamaz. Bağlantı entegratör firma veya özel API geliştirmesi üzerinden kurulur.

MNG Kargo entegrasyonu için kurumsal anlaşma şart mı? Evet, API erişimi yalnızca kurumsal müşteri numarası olan hesaplara açılır. Bireysel gönderi hesabıyla API bağlantısı kurulamaz.

Sipariş-kargo eşleştirmesi bozulursa ne olur? Kargo durumu Shopify sipariş paneline yansımaz ve müşteri bildirimleri tetiklenmez. Referans numarası formatının doğru aktarıldığı ilk kurulumda mutlaka test edilmelidir.

MNG Kargo entegrasyonu kaç günde tamamlanır? Kurumsal anlaşma 3-7 iş günü, entegratör kurulumu 1-3 gün sürer. Özel API geliştirmesi tercih edilirse toplam süreç 3-4 haftaya çıkabilir.

Entegratör uygulama aylık ne kadara mal olur? Ücret işlem hacmine ve seçilen uygulamaya göre değişir, sabit bir rakam yoktur. Karar öncesi en az iki entegratör firmadan teklif almak fiili maliyeti netleştirir.

MNG Kargo ile PTT Kargo aynı mağazada birlikte kullanılabilir mi? Evet, çoğu entegratör uygulama birden fazla kargo firmasını aynı panelde tanımlamaya izin verir. Bölgeye göre otomatik kargo firması seçimi de kurulabilir.

MNG Kargo kapıda ödeme tutarını otomatik hesaplar mı? Hayır, tutar entegrasyon aracı tarafından Shopify sipariş tutarından hesaplanıp gönderi isteğine ayrıca eklenmelidir. Bu hesaplama indirim ve kampanya tutarlarını da doğru yansıtacak şekilde yapılandırılmalıdır.

MNG Kargo desi hesaplaması hangi formülü kullanır? En, boy ve yükseklik ölçülerinin çarpımı belirli bir sabit değere bölünerek hacimsel ağırlık bulunur ve gerçek ağırlıkla karşılaştırılıp yüksek olan esas alınır. Kesin sabit değer ve güncel tarife için MNG Kargo’nun kurumsal anlaşma dokümantasyonuna bakılmalıdır.

Sonraki Adım

MNG Kargo entegrasyonu ve sipariş-kargo eşleştirmesi tamamlandıktan sonra takip numarasının müşteriye otomatik SMS veya e-posta ile ulaştırılması gerekir. Bu bildirim akışının Fulfillment API ve Shopify Flow ile nasıl kurulacağı kargo takip numarası otomatik oluşturma rehberinde adım adım anlatılır.