MNG Kargo entegrasyonu:
kendi sözleşmenizle, siparişten etikete.

MNG Kargo entegrasyonu nedir, DHL eCommerce adına geçiş neyi değiştirdi?

MNG Kargo entegrasyonu, kargo işini sipariş ekranından çıkmadan yürütmenizi sağlayan bir veri bağlantısıdır: alıcı adı, adres, telefon ve koli bilgisi MNG Kargo'ya otomatik gider, karşılığında gönderi numarası, barkod ve durum bilgisi geri gelir. Firmanın kendi tanımında bu bağlantı kargo sipariş web servisleri üzerinden kurulur; gönderim talebi size hizmet veren şubeye yönlendirilir, kargo faturalandırılarak yola çıkar ve raporlama servisleri gönderi durumunu hem sitenizde hem iç sistemlerinizde göstermenize imkân verir.

Şirket tarafında iki tarih önemlidir: MNG Kargo Ekim 2023'te DHL Group'a katıldı ve 22 Mayıs 2025'ten itibaren DHL eCommerce adıyla çalışıyor. Firmanın Hakkımızda sayfasına göre ağ 850'den fazla şube, 7'si teknolojik olmak üzere 29 aktarma merkezi ve 14 bölge müdürlüğünden oluşuyor. Eski mngkargo.com.tr adresi bugün kalıcı yönlendirmeyle dhlecommerce.com.tr sitesine açılıyor.

Panelde iki ad, arka planda tek hesap

Entegrasyon katmanında MNG adı yerinde duruyor. Geliştirici portalı apizone.mngkargo.com.tr, servislerin adresi api.mngkargo.com.tr; kimlik servisindeki alanlar da MNG Müşteri Numarası ve MNG Müşteri Şifresi diye tanımlı. Bu nedenle bir yazılımda MNG Kargo, ötekinde DHL eCommerce yazması ayrı bir entegrasyon anlamına gelmez. Karışıklığı önlemek için üç noktayı bilin:

• Marka DHL eCommerce Türkiye, API ve portal alan adları MNG Kargo; ikisi aynı şirketin aynı hesabını ifade eder.
• Elinizdeki MNG Kargo müşteri numarasının entegrasyonda kullanılıp kullanılmayacağını satış temsilcinize ya da şube yetkilinize teyit ettirin.
• DHL Group'un uluslararası ekspres birimi DHL Express ayrı bir hizmettir ve ayrı hesapla çalışır; yurt içi DHL eCommerce bilgileriyle bağlanmaz.

Sözleşmeli müşteri olmadan MNG Kargo bağlantısı kurulur mu?

Kurulmaz; entegrasyonun ilk şartı DHL eCommerce'te sözleşmeli (kurumsal) müşteri hesabı açtırmaktır, çünkü API'deki oturum anahtarı müşteri numarası ve müşteri şifresiyle üretilir. Firmanın KOBİ sayfasına göre işletmeler ticaret sicil gazetesi, vergi levhası ve şirket ortaklarının kimlik bilgilerini Online Şube'ye yükleyerek müşteri olabiliyor; şube ziyareti ve satış sorumlusu da diğer yoldur. Kapıda ödemeli satış yapıyorsanız bilmeniz gereken ek kural: firmanın tahsilatlı gönderi hizmeti de yalnız sözleşmeli müşterilere açıktır.

Sözleşme görüşmesinde yazılı olarak netleştirmeniz gerekenler

MNG Kargo'nun sipariş servisi, gönderinin nasıl taşınacağını sayısal kodlarla ister ve bu kodların karşılığı sözleşmenizde tanımlı olmalıdır. Görüşmeye şu listeyle girin:

• Ödeme şekli: ücreti gönderici mi öder, alıcı mı? API'de iki ayrı kod vardır; platformun ödediği üçüncü seçenek normal sipariş servisinde geçerli değildir.
• Teslim şekli: adrese teslim mi, yoksa alıcısı haberli (alıcının şubeden aldığı) gönderi mi?
• Gönderi tipi: standart teslimatın yanında gün içi ya da akşam teslimat sözleşmenize tanımlı mı?
• SMS bilgilendirme: alıcıya ve göndericiye giden mesajların ücreti faturanıza eklenir; hangi mesajları isteyeceğinize baştan karar verin.
• Müşteri numarasının hangi gönderici adresine ve hangi şubeye bağlı olduğu; birden fazla depodan çıkış yapacaksanız bu ayrımı ayrıca sorun.

ApiZone'da MNG Kargo API anahtarı nasıl alınır?

ApiZone, MNG Kargo'nun geliştiricilere açtığı portaldır ve resmî akış dört aşamadır: API'lere göz atmak, hesap açmak, uygulama kaydetmek ve plan seçmek. Portal katılımın ücretsiz olduğunu belirtir; planlar için ise üç durum tanımlar: bazıları ücretsiz ve onaysız, bazıları onaya tabi, bazıları da onayla birlikte aylık abonelik gerektirir. Hangi planın sizin için geçerli olduğunu portalda ve temsilcinizle kontrol edin.

1. apizone.mngkargo.com.tr adresinde Create account bağlantısıyla geliştirici hesabı açın.
2. Uygulamalar menüsünden yeni uygulama oluşturun; ad ve açıklama girdiğinizde portal API anahtarını (Client Id) ve güvenlik dizgisini (Client Secret) gösterir.
3. Güvenlik dizgisini aynı ekranda güvenli bir yere kaydedin, portal bu değeri yalnız bir kez gösterir.
4. Kullanacağınız API ürünlerinin planlarına uygulamanızı abone edin; sınırlı erişimli planlarda talebiniz API yöneticisine gider ve gerekirse sizinle iletişime geçilir.
5. Client Id, Client Secret, müşteri numarası ve şifreyi Yox İş Ortağım'ın Kargo bölümüne girip Bağlantıyı test et ile doğrulayın.

MNG Kargo API ürünleri: hangi servis sipariş akışının hangi adımında çalışır?

ApiZone'da Ekim 2026 itibarıyla on API ürünü listeleniyor. Hepsi aynı kimlik doğrulamasını kullanır ama her biri ayrı plan aboneliği ister; bu yüzden anahtarlar doğru olduğu hâlde bağlantı testi başarısızsa ilk bakılacak yer eksik plan aboneliğidir. Aşağıdaki tablo firmanın servis yapısını gösterir; Yox İş Ortağım'ın bu firmada yaptığı işler gönderi kaydı ve etiket, kargo durumu takibi ve takip numarasının kanala iletilmesidir.

Sipariş kaydı açılması gönderinin çıktığı anlamına gelmez

MNG Kargo'da sipariş ve gönderi iki ayrı aşamadır. Önce sipariş kaydı açılır; barkod servisi bu kaydı faturalaştırdığında gönderi numarası oluşur ve etiket üretilir. Sorgu servislerinin açıklamalarında da gönderi bilgisinin ancak sipariş faturalaştıktan sonra alınabildiği yazar. Servis her sipariş için benzersiz ve büyük harfli bir referans numarası ister, kargo cinsini de dosya, Mİ, paket ya da koli olarak bekler. Pratik sonucu şudur: etiketi basılmamış bir siparişin kanala iletilecek takip numarası da yoktur.

Pazaryeri siparişinde MNG Kargo entegrasyonu: DHLECOMMP kodu mu, kendi sözleşmeniz mi?

Satıcıların büyük kısmı MNG Kargo'yu kendi sözleşmesiyle değil, pazaryerinin anlaşmasıyla kullanır ve iki model farklı etiket, farklı takip numarası, farklı fatura demektir. Trendyol'un geliştirici dokümanındaki kargo firmaları listesinde firma, ID 10 ve DHLECOMMP koduyla DHL eCommerce Marketplace adıyla yer alır. Aynı doküman, ürün gönderirken bildirdiğiniz kargo firmasının Trendyol sözleşmenizde onaylanan firmayla aynı olmasını ister; aksi hâlde ürünler yayına çıkmaz. Trendyol'un sipariş servisleri rehberi iki ödeme modelini şöyle ayırır:

n11 ve diğer kanallarda pazaryeri kodlu sipariş

MNG Kargo'nun API'sinde normal siparişten ayrı bir pazaryeri siparişi türü vardır; bu türde pazaryeri kısa kodu (dokümandaki örneklerde TRND ve N11) ve pazaryeri satış kodu zorunludur, gönderi sorgusunda da ücretin platform tarafından ödenip ödenmediğini gösteren bir alan bulunur. Bu, kanalla kargo firması arasındaki anlaşmanın teknik izidir; kendi sözleşmenizle gönderime izin verilip verilmediğine ise kanal karar verir. n11 mağazanızda ya da başka bir kanalda kuralı satıcı panelinin kargo ayarlarından kontrol edin; izin varsa Yox İş Ortağım takip numarasını ve kargo firmasını siparişin geldiği kanala iletir.

Siparişten teslimata MNG Kargo gönderisi panelde nasıl ilerler?

Yox İş Ortağım'da MNG Kargo bağlıyken bir siparişin yolu beş adımdan oluşur ve bilgiyi hiçbir aşamada elle kopyalamazsınız:

1. Sipariş pazaryerinden ya da sitenizden panelin sipariş listesine düşer.
2. Birincil kargo MNG Kargo ise siparişten MNG tarafında gönderi kaydı açılır.
3. MNG takip numarasını ve barkodlu etiketi döndürür; etiketi panelden basıp koliye yapıştırırsınız.
4. Takip numarası ve kargo firması, kanal kendi kargonuzla gönderime izin veriyorsa siparişin geldiği kanala iletilir.
5. Gönderinin durumu MNG Kargo üzerinden sorgulanır ve siparişe yansır.

Durum bilgisinin kaynağı MNG Kargo'nun gönderi durum kodlarıdır. Resmî API tanımında sekiz kod var; panelde kargoya verildi, yolda, teslim edildi gibi durumlar olarak izlenir. Kodların ne anlattığını bilmek, müşteri sorduğunda doğru cevabı vermenizi sağlar:

MNG Kargo desi hesabı, ağırlık sınırları ve teslim süreleri

DHL eCommerce'in taşıma kurallarına göre yurt içi desi en × boy × yükseklik (cm) / 3000 formülüyle bulunur. Tek parçada 100 kg ya da 300 desiyi aşan, en uzun kenarı 3 metreden büyük gönderiler kabul edilmez. Barkod servisi her koli parçası için desi ve kilogramı ayrı ister; firma da şubede yapılan ölçüm ve tartıma göre nihai ücretin farklılaşabileceğini belirtir. Teslimat şekli de ölçüye bağlıdır: tek parçada 30 kg/desiye kadar, parçalı gönderide toplam 50 kg/desiye kadar olanlar kata, üzerindekiler bina kapısına teslim edilir.

Örnek hesap: iki koli, iki farklı teslimat

40 × 30 × 20 cm bir koli 24.000 / 3000 = 8 desi eder ve 4 kg ağırlıkla kata teslim edilir. 60 × 50 × 40 cm bir koli ise 120.000 / 3000 = 40 desiye çıkar; tek parçada 30 desiyi geçtiği için bina kapısında teslim edilir. Ücrete hangi değerin esas alınacağı ve yuvarlama sözleşmenize bağlıdır. Koli ölçülerini desi hesaplama aracıyla önceden kontrol edin, kargo bedelini de kâr hesaplama aracında ürün maliyetine ekleyin.

Süreler firmanın hedeflediği değerlerdir, iş günüyle hesaplanır ve kabul günü sayılmaz. Mesafe iller arası yol değil, gönderinin çıkış birimi, aktarma merkezleri ve varış birimi arasında katettiği operasyonel mesafedir; mobil alanlarda bu tablo uygulanmaz.

Taşınmayan ve taahhütnameyle taşınan ürünler

E-ticarette en çok sürpriz yaratan konu yasak listesidir. DHL eCommerce'in operasyonel taşıma standartlarında parfüm, alev alabilir sıvılar sınıfında taşınması yasak ürünler arasında sayılır. Kategorinizi bu listeyle karşılaştırmadan MNG Kargo'yu birincil kargo yapmayın:

• Taşınması yasak: parfüm, aerosol, pil ve batarya, lityum pil, akülü cihazlar (scooter, akülü oyuncak), tütün ürünleri, çakmak.
• Taahhütnameyle taşınan: cam, porselen, seramik, ayna; bozulabilir gıdalar; kurumsal müşterilerin tablet, telefon ve bilgisayar gönderileri; televizyon ve müzik aletleri.
• Sıvılar: sızdırmaz, çift katlı özel ambalaj şarttır; platform üzerinden sipariş verilen sıvı gönderiler taahhütname alınamadığı için tazmin kapsamı dışında kalır.

MNG Kargo entegrasyonu hangi Yox İş Ortağım paketinde var?

Kargo bağlantısı Büyüme paketinden itibaren açılır; Başlangıç paketinde takip numarasını siparişe elle girersiniz. Yox İş Ortağım'da 57 kargo ve lojistik firması tanımlıdır ve MNG Kargo, paketinizdeki kargo firması hakkından birini kullanır. Yox İş Ortağım kargo firması değildir; kargo bedeli almaz, anlaşmalı tarife vermez, gönderiler kendi sözleşmeniz üzerinden faturalanır.

Yıllık ödemede %20 indirim uygulanır; bütün özellikleri paket karşılaştırmasında görebilirsiniz. 3 günlük ücretsiz denemede MNG bağlantısını kendi hesabınızla test edebilir, isterseniz kurulumu bizimle birlikte yapabilirsiniz.

MNG Kargo'yu ikinci bir kargo hesabıyla birlikte kullanmak

Profesyonel ve üstü paketlerde birden fazla kargo hesabı bağlayıp birincil kargo seçersiniz; siparişin hangi firmayla gideceğine siz karar verirsiniz. Örneğin büyük kolileri MNG Kargo ile, diğer siparişleri Aras Kargo hesabınızla göndermeyi tercih edebilirsiniz. Uluslararası ekspres gönderiler ise DHL Group'un ayrı birimi olan DHL Express üzerinden ayrı hesapla yürür. Bağlanabilen bütün kanal ve firmalar entegrasyon listesinde.

MNG Kargo bağlantısını canlıya almadan önce kontrol listesi ve sık hatalar

Canlıya geçiş kontrol listesi

• ApiZone uygulamanız Identity, sipariş, barkod ve sorgu ürünlerinin planlarına abone mi; onay bekleyen plan kaldı mı?
• Client Secret güvenli bir yerde kayıtlı mı, panele girilen değer son sıfırlamadan sonraki değer mi?
• Müşteri numarası, gönderilerin çıkacağı depo adresine bağlı hesabın numarası mı?
• Ürünleriniz yasak listede ya da taahhütname isteyen gruplarda mı?
• Standart koli ölçüleri belli mi; 30 desiyi aşan koliler için bina kapısı teslimatını müşteriye anlattınız mı?
• Kanal kendi kargonuzla gönderime izin veriyor mu, Trendyol'daki kargo modeliniz ne?

En sık görülen hatalar

Birinci hata, anahtarlar doğru olduğu hâlde plan aboneliğinin eksik kalmasıdır; servis yetki hatası döner ve sorun şifrede aranır. İkincisi, Online Şube giriş bilgisinin müşteri numarası yerine yazılmasıdır. Üçüncüsü, pazaryerinin DHLECOMMP anlaşmasıyla gidecek bir siparişe kendi hesabından ikinci gönderi açmaktır. Dördüncüsü, koli ölçüsünü tahminle girmektir; şube ölçümüyle fark çıkar. Test başarısızsa hata mesajında hangi alanın reddedildiğine bakın.

Hasar ve kayıpta tazmin: satıcı olarak sizin rolünüz

DHL eCommerce'in tazmin prosedürüne göre e-ticaret platformlarından yapılan gönderilerde alıcı tazmin için göndericiye, yani size başvurur; kargo şirketi bu gönderilerde alıcıya ödeme yapmaz. Başvuru şubeden dilekçeyle ya da sitedeki hasar tazmin formuyla yapılır, taşıma faturası tarihinden itibaren on gün geçtikten sonra açılabilir ve istenen eksik belgeler 10 gün içinde tamamlanmazsa talep reddedilir. Ürün faturasını, sevk irsaliyesini ve hasar fotoğraflarını sipariş bazında saklayın.