MNG Kargo (DHL eCommerce) Entegrasyonu
MNG Kargo, DHL Group bünyesine katıldı ve “DHL eCommerce” adıyla hizmet veriyor. Sözleşmeniz ve müşteri numaranız aynı kalır; değişen şey markanın adı ve API altyapısıdır. Fenikya panelinde taşıyıcı “DHL eCommerce” olarak listelenir — “MNG Kargo” yazan bir satır aramayın.
MNG Kargo (DHL eCommerce) entegrasyonu ne yapar?
Gönderi oluşturma
Sipariş ve barkod aşamaları arka planda zincirlenir; siz tek tuşa basarsınız.
Takip numarası
Barkod adımından dönen takip numarası siparişe otomatik işlenir.
İl/ilçe kodu çözümleme
API şehir adı değil kod ister; Fenikya bunu adresten otomatik çözer.
Kapıda Ödeme
Tahsilatlı gönderi tipi destekleniyor.
Başlamadan önce neye ihtiyacınız var?
Kuruluma geçmeden şunları hazır etmeniz süreci kısaltır:
- MNG Kargo (DHL eCommerce) sözleşmesi: müşteri numaranız ve şifreniz
- MNG geliştirici portalında oluşturulmuş bir uygulama: Client Id ve Client Secret
- Gönderici adres tanımı
Nasıl kurulur?
- apizone.mngkargo.com.tr adresinden geliştirici hesabı açın. Kayıt ücretsizdir ve firma/vergi bilgisi istemez.
- Portalda bir uygulama oluşturun; Client Id ve Client Secret otomatik üretilir.
- Uygulamanızı kullanacağınız ürünlere abone edin (bazı planlar ücretsizdir ve onay beklemez).
- Fenikya panelinde Ayarlar → Kargo'ya girin ve listeden DHL eCommerce'i seçin.
- Dört alanı doldurun: Client Id, Client Secret, müşteri numarası, müşteri şifresi.
- Bağlantıyı test edin. Fenikya portal anahtarı ile müşteri bilgilerini ayrı ayrı doğrular; hangisinin hatalı olduğunu size söyler.
Kurulum sırasında takılırsanız destek ekibimize yazabilirsiniz.
Bu entegrasyon kimin işine yarar?
MNG Kargo / DHL eCommerce sözleşmesi olan yurt içi satıcılar için. Yurt dışı gönderi yapıyorsanız bu sayfa değil, DHL Express entegrasyonu size uygundur — ikisi ayrı hizmet ve ayrı API'dir.
Sık karşılaşılan sorunlar
Panelde “MNG Kargo” satırını bulamıyorum
Marka değiştiği için taşıyıcı listede “DHL eCommerce” adıyla görünür. Aynı firmadır, sözleşmeniz geçerlidir.
“Invalid client id or secret” hatası
Bu hata müşteri numaranızla ilgili değildir; portal uygulamanızın Client Id/Secret değerlerini işaret eder. İki değerin yerini ters yazmadığınızdan emin olun.
“Not registered to plan” hatası
Bu aslında iyi haber: anahtarlarınız doğru. Portalda uygulamanızı ilgili ürüne abone etmemişsiniz demektir.
Anahtarlar doğru ama gönderi açılmıyor
Müşteri numarası veya şifresi kabul edilmemiştir. Bunlar portal anahtarlarından farklıdır ve MNG sözleşmenizden gelir; online şube şifreniz API şifresi yerine geçmeyebilir.
Etiket (barkod PDF) indiremiyorum
API'de ayrı bir etiket indirme ucu bulunmuyor; barkod değerleri gönderi oluşturma yanıtında döner. Etiket çıktısını MNG şube panelinden alabilirsiniz.
Test bilgileriyle canlı gönderi açılmıyor
Test ve canlı ortamlar ayrı adreslerdedir ve anahtarları birbirinin yerine geçmez.
Sık Sorulan Sorular
MNG Kargo DHL mi oldu?
MNG Kargo, DHL Group bünyesine katıldı ve DHL eCommerce adıyla hizmet veriyor. mngkargo.com.tr da bu marka altında yayında. Mevcut sözleşmeniz ve müşteri numaranız geçerliliğini korur.
DHL eCommerce ile DHL Express aynı şey mi?
Hayır. DHL eCommerce yurt içi gönderilerinizi taşır ve MNG altyapısını kullanır; DHL Express uluslararası hizmettir ve tamamen farklı bir API'ye sahiptir. Yurt dışına gönderi yapacaksanız DHL Express entegrasyonuna bakın.
API bilgilerimi müşteri temsilcimden mi alacağım?
Yalnızca bir kısmını. Client Id ve Client Secret'ı MNG geliştirici portalından kendiniz üretirsiniz; müşteri numarası ve şifresi ise sözleşmenizden gelir. Entegrasyon için dördü birden gerekir.
Geliştirici portalına kaydolmak için MNG müşterisi olmam gerekir mi?
Hayır. Portal kaydı ücretsizdir ve firma bilgisi istemez. Ancak gönderi oluşturabilmek için MNG sözleşmenizden gelen müşteri numarası ve şifresi gerekir.
Kargo kategorisindeki diğer entegrasyonlar
MNG Kargo (DHL eCommerce) entegrasyonunu Fenikya'da deneyin
Mağazanızı açın, entegrasyonu bağlayın, satışa başlayın.
Ücretsiz Başlayın