İçeriğe geç
Ondokuzon

Kargo Entegrasyonu

MNG Kargo Entegrasyonu: Siparişten Gönderi, Etiket ve Takip

MNG Kargo entegrasyonu, siparişi MNG Kargo'nun servislerine gönderi olarak kaydeder, barkod etiketini üretir ve takip numarasıyla teslim durumunu sisteminize yazar. Bağlantıyı Shopify mağazanıza, sitenize ya da ERP'nize göre kurarız.

MNG Kargo entegrasyonu, siparişinizi MNG Kargo'nun sistemine gönderi olarak kaydeden, paket için barkod etiketi üreten ve takip numarasıyla teslim durumunu siparişe geri yazan bağlantıdır. Günde birkaç gönderiden sonra alıcı adını, adresi ve tahsilat tutarını kargo ekranına elle yazmak hem yavaşlatır hem de hata riskini artırır.

MNG Kargo için App Store'da hazır bir uygulamamız yok; MNG Kargo entegrasyonunu sisteminize özel kuruyoruz. Kurguda, Shopify için yayında olan Yurtiçi Kargo uygulamamızdaki mimariyi kullanıyoruz: istekler kuyrukta işlenir, her servis çağrısı kayda geçer, geçici hatalar yeniden denenir. Tüm kargo firmalarını kapsayan yaklaşımımız kargo entegrasyonu, genel mimarimiz e-ticaret ve ERP entegrasyonu sayfasında.

MNG Kargo entegrasyonu neleri otomatikleştirir?

Bir MNG Kargo entegrasyonunun tipik kapsamı

  • Siparişten tek tek ya da toplu gönderi kaydı
  • Barkodlu etiket: termal yazıcı ya da PDF çıktı
  • Takip numarasının siparişe ve müşteri bildirimine yazılması
  • Gönderi durumunun düzenli sorgulanıp siparişe işlenmesi
  • Kapıda ödemede tahsilat tutarı ve tipinin iletilmesi
  • Çok koli gönderilerde parça sayısı ve her koliye etiket
  • İşlem görmemiş gönderinin iptali
  • İade gönderilerinin izlenmesi ve stoka yansıması

MNG Kargo'da marka ve servis değişiklikleri

MNG Kargo 2023'te DHL grubuna katıldı ve Mayıs 2025'ten bu yana Türkiye'de DHL eCommerce adıyla hizmet veriyor; anlaşma belgelerinde ve ekranlarda bu adı görürsünüz. Marka değişikliğiyle birlikte entegrasyon servisleri ve dokümanları da zaman içinde güncelleniyor. Bunun iki pratik sonucu var.

Birincisi, işe doğru servisle başlamak gerekir. Geliştirmeye başlamadan önce müşteri temsilcinizden anlaşmanızın hangi servise tanımlı olduğunu ve güncel dokümanı isteyin. Eski bir dokümanla başlanan entegrasyon, canlıya çıkmadan yeniden yazılmak zorunda kalabilir.

İkincisi, yapının değişime açık olması gerekir. Bu yüzden kargo servisiyle konuşan kodu tek bir katmanda topluyoruz. Servis ya da kimlik doğrulama yöntemi değiştiğinde sipariş, etiket ve takip ekranlarınız aynı kalır, yalnızca bu katman güncellenir.

Bugün eski bir servisle çalışan MNG Kargo entegrasyonunuz varsa geçişi de aynı yöntemle planlarız: yeni servis önce sınırlı gönderiyle denenir, bir süre iki servisin sonuçları karşılaştırılır, ardından eski bağlantı kapatılır.

MNG Kargo'dan istenecek bilgiler

Projenin başında şu bilgileri birlikte toplarız:

  • Kurumsal anlaşmanıza bağlı entegrasyon kullanıcı bilgileri ve müşteri numarası
  • Kullanılacak servisin güncel dokümanı, varsa test ortamı erişimi
  • Sözleşmenizdeki kapıda ödeme seçenekleri (nakit, kredi kartı)
  • Gönderilerin hangi depodan ya da adresten alınacağı
  • Etiketin sizin sisteminizden mi basılacağı, şubede mi düzenleneceği
  • İade gönderileri için anlaşmanızdaki yöntem

Gönderiden önce veri hazırlığı

Entegrasyonun büyük kısmı servisi çağırmak değil, gönderilen verinin doğru olmasıdır. Kargo servislerinden dönen hataların çoğu şu alanlardan çıkar:

  • Her gönderi sizin ürettiğiniz benzersiz bir gönderi referansıyla gider. Biz sipariş numarasına deneme sırasını ekleriz, böylece iptal edilip yeniden açılan gönderi yeni bir referans alır.
  • Adresteki il ve ilçe adı kargo firmasının listesindeki kayıtla eşleşmelidir. Yurtiçi Kargo uygulamamızda il ve ilçe adlarını 81 il ve 973 ilçelik bir referans listeyle eşleştiriyoruz. Aynı yaklaşım MNG Kargo'da da yazım farklarını gönderimden önce düzeltir.
  • Telefon numarasında ülke kodu, boşluklar ve baştaki sıfır temizlenir.
  • Ürün kartlarında ölçü ve ağırlık varsa desi otomatik hesaplanır, yoksa paketleme sırasında girilir. Çok kolili siparişlerde parça sayısı gönderiyle bildirilir.
  • Gönderi isteği yanıt vermeden zaman aşımına uğrarsa kayıt açılmış olabilir. İsteği körlemesine tekrarlamak yerine önce referansla sorgularız, böylece aynı paket için iki gönderi oluşmaz.

Kapıda ödeme ve iade gönderileri

Kapıda ödemeli siparişlerde tahsil edilecek tutar, kargo ve kapıda ödeme bedeli dahil sipariş toplamıyla birebir aynı gitmelidir. Tahsilat tipi (nakit ya da kart) siparişteki ödeme yönteminden belirlenir. Kargo firmasından gelen tahsilat bilgisi siparişlerle karşılaştırıldığında hesabınıza geçmeyen tutarlar ayrı bir listede görünür.

İade, anlaşmanızdaki yönteme göre bir iade kodu ya da sipariş numarasıyla eşleşen bir iade gönderisiyle yürür. Entegrasyon iade gönderisini izler; ürün depoya ulaşıp kontrol edildiğinde stok geri alınır ve iade belgesi ERP'de ya da e-fatura sisteminde açılır.

Shopify, özel site, ERP ve pazaryerleri

Shopify'da bağlantıyı mağazanıza özel bir uygulama olarak kurarız. Takip numarası Shopify'daki gönderi (fulfillment) kaydına yazılır ve bildirim ayarınız açıksa müşteriye kargo e-postası gider. Diğer seçenekler Shopify kargo entegrasyonu sayfasında.

Özel sitelerde sipariş ekranına toplu gönderi açma ve toplu etiket basma eklenir. ERP ya da depo yazılımı kullanıyorsanız gönderi irsaliye kesildiğinde açılır, takip numarası irsaliyeye ve satış kanalına geri yazılır.

Pazaryeri siparişlerinde etiket çoğunlukla pazaryerinin anlaşmalı kargosundan gelir. Kendi MNG Kargo anlaşmanızla göndereceğiniz siparişler kuralla ayrılır. Ayrıntılar pazaryeri entegrasyonu sayfasında.

Birden fazla kargo firmasıyla çalışmak

MNG Kargo'yu çoğu zaman başka bir firmayla birlikte kullanırsınız: belirli bölgeler, ağır paketler ya da kapıda ödemeli siparişler için. Firma seçimi bölgeye, desiye, ödeme tipine ya da çıkış deposuna göre kurala bağlanır ve bütün gönderiler aynı ekrandan, aynı hata ekranıyla yönetilir. Diğer firmalar için Yurtiçi Kargo API entegrasyonu, Aras Kargo entegrasyonu ve Hepsijet entegrasyonu sayfalarına bakabilirsiniz.

MNG Kargo gönderilerinizi siparişe bağlayalım

Siparişlerinizi hangi sistemden yönettiğinizi, günlük gönderi sayınızı ve kapıda ödeme kullanıp kullanmadığınızı yazın; akışı birlikte çıkaralım.

Teklif alın

MNG Kargo entegrasyonu süreci

  1. Bilgi toplama. MNG Kargo'dan entegrasyon bilgileri ve güncel doküman alınır, test imkânı netleşir.
  2. Eşleme. Kargo yöntemleri, ödeme tipleri, depo ve gönderici bilgileri eşlenir.
  3. Geliştirme. Gönderi kaydı, etiket, sorgu ve iptal akışları kuyruk, tekrar deneme ve hata ekranıyla yazılır.
  4. Test gönderileri. Kapıda ödemeli, çok kolili ve iptal edilen gönderiler dahil örnek senaryolar denenir.
  5. Canlı ve izleme. Tüm gönderiler entegrasyona alınır; takılan gönderiler ve hatalı adresler listeden izlenir.

MNG Kargo entegrasyonu maliyetini belirleyen kalemler

  • Gönderinin açılacağı sistem: Shopify, özel site, ERP ya da depo yazılımı
  • Kullanılacak MNG Kargo servisi ve test imkânı
  • Günlük gönderi sayısı ve toplu işlem ihtiyacı
  • Kapıda ödeme ve iade akışları
  • Depo ve gönderici adresi sayısı
  • Diğer kargo firmalarıyla kurala bağlı firma seçimi

Kargo tarafında canlıda olan işlerimiz

  • Shopify siparişlerini tek tıkla Yurtiçi Kargo'ya gönderen uygulamamız Yurtiçi Kargo Entegrasyonu
  • Shopify mağazalarında canlıda çalışan Yurtiçi Kargo gönderimleri
  • Laravel kuyruklarıyla çalışan, hata olunca yeniden deneyen entegrasyonlar

Yayından sonra MNG Kargo'nun servis değişikliklerini ve hata kayıtlarını bakım ve destek kapsamında izleyebiliriz.

SSS

Sık sorulan sorular

MNG Kargo entegrasyonu nasıl yapılır?
MNG Kargo ile kurumsal anlaşmanız üzerinden entegrasyon erişim bilgileri ve güncel teknik doküman alınır. Kargo yöntemleri, ödeme tipleri ve gönderici bilgileri eşlenir; gönderi kaydı, etiket, sorgu ve iptal akışları geliştirilip sınırlı sayıda gönderiyle canlıya alınır.
MNG Kargo API bilgileri nereden alınır?
Entegrasyon bilgileri, MNG Kargo ile yaptığınız kurumsal anlaşma üzerinden müşteri temsilciniz ya da anlaşmanızı yürüten şube aracılığıyla verilir. Hangi servisi kullanacağınızı ve güncel dokümanı da aynı kanaldan istemeniz gerekir. Bu bilgiler olmadan test gönderisi açılamaz.
Shopify'da MNG Kargo entegrasyonu var mı?
MNG Kargo için App Store'da yayında bir uygulamamız yok. Bağlantıyı mağazanıza özel bir uygulama olarak kurarız; gönderi siparişten açılır, takip numarası Shopify'daki gönderi kaydına yazılır. Yurtiçi Kargo kullanıyorsanız App Store'daki uygulamamızı doğrudan kurabilirsiniz.
MNG Kargo'da kapıda ödeme entegrasyonla yapılabilir mi?
Sözleşmenizde tahsilatlı teslimat tanımlıysa tahsil edilecek tutar ve tahsilat tipi gönderiyle birlikte iletilir. Tutarın kargo ve kapıda ödeme bedeli dahil sipariş toplamıyla aynı olduğu canlıya geçmeden test edilir.
MNG Kargo gönderisi entegrasyondan iptal edilebilir mi?
Henüz şubede ya da kuryede işlem görmemiş gönderiler entegrasyon üzerinden iptal edilebilir. İşlem görmüş gönderilerde iptal ve adres değişikliği MNG Kargo üzerinden yürütülür. Sitenizde iptal edilen siparişin gönderi kaydının da iptal edilmesi akışa eklenir.
MNG Kargo servislerini değiştirirse entegrasyon ne olur?
Kargo firmaları servislerini zaman zaman yeniler ve eski servisleri belirli bir tarihten sonra kapatabilir. Entegrasyonu servis çağrılarını tek bir katmanda toplayacak şekilde kurduğumuz için servis değiştiğinde yalnızca bu katman güncellenir. Bakım kapsamında firmanın duyurularını takip ederiz.
MNG Kargo'yu başka bir kargo firmasıyla birlikte kullanabilir miyim?
Evet. Firma seçimi bölgeye, desiye, ödeme tipine ya da müşterinin seçtiği kargo yöntemine göre kurala bağlanır. Bütün firmaların gönderileri aynı ekrandan, aynı kuyruk ve hata ekranıyla yönetilir.

Hadi birlikte bir şeyler yapalım!

Projenizi anlatın, ihtiyacınızı netleştirelim ve size uygun yol haritasını birlikte çıkaralım.

Projeni anlat