Shopify DHL Entegrasyonu

Türkiye'de DHL diyen iki farklı şeyden birini kastediyor ve kurulumun ilk kararı bu: yurt içi gönderiyi yapan DHL eCommerce eski MNG Kargo'dur, marka Mayıs 2025'te değişti; yurt dışına çıkan gönderi ise DHL Express'ten gider ve o ayrı bir şirket, ayrı hesap, ayrı panel demektir. Bu ayrımı yapmayan her kurulum yanlış hesapla başlıyor. İki taraf ayrı ayrı kurulur. DHL eCommerce'in Türk kargo firmalarında bulunmayan bir geliştirici portalı var, kurulumu gerçekten tıkayan şart statik çıkış adresinin beyaz listeye alınması ve yurt dışı gönderide gümrük evrakı kendi başına bir iş.

Kurulum için görüşün Entegrasyonu incele

200+ aktif marka
Nodus Works ile Shopify'da büyüyor

Shopify DHL entegrasyonu nedir?

Shopify DHL entegrasyonu, mağazanızdaki siparişleri kargo firmasına gönderi olarak beyan eden, etiketini basan, takip numarasını siparişe yazan ve teslim durumunu geri okuyan bağlantıdır. Yurt içi tarafta bunu eski MNG Kargo olan DHL eCommerce yapar; kendi Shopify uygulamasını yayınlamadığı için köprüyü bir entegrasyon aracı kurar.

Kurulum kod yazmakla değil doğru tarafı seçmekle başlar. Yurt içi gönderi için DHL eCommerce ile kurumsal anlaşma yapıp müşteri numaranızı alırsınız; erişim anahtarını firmanın geliştirici portalından edinirsiniz. Yurt dışına satıyorsanız DHL Express tarafında ayrı bir işletme hesabı açmanız gerekir ve o başvuru tamamen çevrimiçi. Yurt içi ve yurt dışı gönderiyi aynı anda, tek panelden yönetmek gerektiğinde Nodus Works'ün Shopify entegrasyon ve özel uygulama geliştirme hizmeti bu kurulumu birleştirir.

Bağlantı kurulduktan sonra günlük iş tek ekrandan yürür: sipariş beyan edilir, etiket basılır, takip numarası siparişe yazılınca müşteri bildirimi Shopify'ın kendi e-postasından gider ve teslim durumu geri okunduğunda sipariş kendiliğinden kapanır. Yurt dışı gönderide buna gümrük evrakı ve teslim şekli kararı eklenir.

NELER YAPILIR

DHL entegrasyonu tam olarak ne yapar

Bağlantı kurulduğunda gönderi beyanı, etiket, takip, teslim durumu, tahsilat ve iade aynı akışın parçası olur. Yurt dışına satıyorsanız buna gümrük evrakı da eklenir. Aşağıdaki altı başlık en çok sorulan konuları kapsıyor.

Doğru DHL tarafının seçilmesi

Yurt içi gönderi DHL eCommerce'ten, yurt dışı gönderi DHL Express'ten çıkar ve ikisi ayrı hesaptır. Her ikisine de satıyorsanız iki ayrı anlaşma ve iki ayrı bağlantı kurmanız gerekir; tek hesapla iki tarafı yürütmek mümkün değil.

Gönderi oluşturma ve beyan

Sipariş adresi kargo firmasına elle yazılmak yerine siparişteki veriyle beyan edilir. DHL eCommerce tarafında ilçe kodlu bir değer olarak bekleniyor, yani adres verinizin düzgün olması bu adımın ön koşulu.

Etiket ve barkod basımı

Etiket sipariş ekranından basılır, ikinci bir panele geçmeniz gerekmez. Barkod üretimi firmanın kendi servisinden geliyor; entegrasyonun ürettiği bir numarayı barkod olarak kullanmak okunmayan etiket üretir.

Takip numarasının siparişe yazılması

Takip numarası siparişe yazıldığında müşteri bildirimi Shopify'ın kendi e-postasından gider ve teslim durumu geri okunduğunda sipariş kendiliğinden kapanır. Numara yazılmazsa müşteri hiçbir şey görmez.

Tahsilatlı gönderi ve iade

Kapıda ödemeli siparişte tahsil edilecek tutar sipariş toplamından okunup gönderiye yazılır. İade tarafında DHL sabit iade kodu kullanıyor, yani kod her iadede aynıdır ve siparişe özel üretilmez.

Yurt dışı gönderide gümrük evrakı

Yurt dışı paket için beyan alıcı adresi değil, ticari fatura satır verisidir: mal tanımı, tarife kodu, değer ve para birimi. Bu veri ürün kartlarınızda tutulmuyorsa gönderi gümrükte bekler.

İKİ AYRI DHL

MNG Kargo DHL mi oldu, hangi tarafı kullanacaksınız?

Arayan kişinin tam olarak takıldığı yer burası. Türkiye'de iki ayrı DHL var; hangisiyle çalışacağınız gönderinin nereye gittiğine göre belirleniyor.

DHL eCommerce, eski MNG Kargo'dur

DHL Group MNG Kargo'yu satın aldı, devir Ekim 2023'te tamamlandı ve Mayıs 2025'te marka MNG Kargo olmaktan çıkıp DHL eCommerce oldu; şube, araç ve dijital platform kimliği değişti. Yurt içi gönderiyi yapan taraf bu.

DHL Express uluslararası ekspres taraftır

Ayrı şirket, ayrı hesap, ayrı panel ve ayrı servis yapısı. Türkiye'den yurt dışına çıkan gönderi bu taraftan gider; yurt içi paket taşımıyor. İki tarafın hesap bilgileri birbirinin yerine kullanılamaz.

Shopify'ın yardım sayfası Türkiye'yi kapsamıyor

Shopify'ın Türkçe yayınlanmış DHL eCommerce sayfası, Amerika kıtasındaki bir gönderim konumundan uluslararası etiket satın almayı anlatıyor. Aynı ad, tamamen farklı iş; Türkiye'deki mağazada o akış hiç görünmez.

Teknik altyapı adı MNG olarak duruyor

Marka DHL olsa da geliştirici portalı, servis adresleri ve entegrasyon e-postası MNG alan adı üzerinde. Bir üçüncü parti Shopify uygulamasının adresinde de MNG geçmeye devam ediyor; kaynak ararken iki kelimeyi de denemeniz gerekiyor.

Eski MNG anlaşmanız ve müşteri numaranız

Devir kurumsal bir hisse alımı olduğu için sözleşmeler firmanın kendisiyle devam ediyor. Buna karşılık entegrasyon tarafında servis yapısı yenilendiği için eski bir kurulumun çalışmaya devam edeceği varsayılmamalı; kontrol edilmesi gerekiyor.

Yurt içi ölçek yurt dışı ekspresten farklı

DHL eCommerce kendi sitesinde sekiz yüzü aşkın şube, yirmi dokuz aktarma merkezi ve dört binin üzerinde araç bildiriyor; kurumsal referansları arasında büyük pazaryerleri sayılıyor. Yurt içi hacim bu taraftan yürüyor.

Pratik kural şu: yurt içi siparişleriniz için DHL eCommerce ile anlaşıp geliştirici portalından erişim alırsınız, yurt dışı siparişleriniz için DHL Express tarafında ayrı bir işletme hesabı açarsınız. İki tarafa da satıyorsanız iki bağlantı birlikte yürür ve bu normaldir.

KURULUM

Shopify DHL entegrasyonu nasıl yapılır?

Aşağıdaki altı adım, doğru tarafın seçilmesinden ilk etiketin basılmasına kadar kurulumun tamamını kapsıyor. Üçüncü adım DHL'e özgü: erişim anahtarını firmanın kendi geliştirici portalından alıyorsunuz.

Hangi DHL tarafını kullanacağınıza karar verin

Yurt içi gönderi DHL eCommerce'ten, yurt dışı gönderi DHL Express'ten çıkar. İkisine de satıyorsanız iki ayrı anlaşma gerekir. DHL Express tarafında başvuru tamamen çevrimiçi: dhl.com üzerinden işletme hesabı açılabiliyor, şubeye gitme adımı yok.

Yurt içi tarafta kurumsal anlaşmanızı yapın

DHL eCommerce'in e-ticaret müşterisi olma akışı için yayınlanmış bir sayfa bulunmuyor; süreç müşteri temsilcisi ve bölge yapısı üzerinden yürüyor. Anlaşma sonrası müşteri numaranız tanımlanır ve panel şifreniz verilir; bu ikisi entegrasyonun zorunlu alanları.

Geliştirici portalından erişim anahtarınızı alın

DHL eCommerce'in herkese açık bir geliştirici portalı var ve akış üç adım: hesap oluşturulur, onay beklenir, erişim anahtarı alınır. Portalda kargo takip, gönderi hazırlama ve barkod oluşturma servisleri ayrı ayrı listeleniyor; kullanacağınız servislere abone olmanız gerekiyor.

Test ve canlı ortamı ayrı ayrı kurun

Test ortamı ayrı bir portalda ve aboneliği kendiliğinden onaylanıyor; canlı abonelik ise elle onaylanıyor. Canlı ortam için uygulama adınız, müşteri numaranız ve sabit çıkış adresiniz entegrasyon e-postasına bildirilip beyaz listeye alınıyor. Paylaşımlı barındırmada sabit adresiniz yoksa bu adım tıkanır.

Adres, desi ve ödeme kurgusunu tanımlayın

Ödeme sayfasında adres satırı iki alanını zorunlu yapıp adını ilçe olarak değiştirin; DHL eCommerce tarafında ilçe kodlu bir değer olarak beklendiği için bu adım isteğe bağlı değil. Etiket yazıcınızı, beyan düzeninizi ve kapıda ödeme kullanacaksanız Shopify tarafındaki manuel ödeme yöntemini de bu adımda kurun.

Deneme gönderisiyle akışı doğrulayın

Tek siparişle gönderi oluşturup etiketi basın, şubede okutulduğunda takip numarasının siparişe yazıldığını ve müşteri bildiriminin gittiğini görün. Ardından teslim durumunun geri okunduğunu kontrol edin. Yurt dışına satıyorsanız ayrıca bir gümrük evrakı denemesi yapın.

Aşağıdaki tabloda Shopify'daki verilerin kargo tarafında hangi karşılığa gittiğini bulabilirsiniz.

Shopify'da ne var	Kargo tarafında karşılığı
Sipariş	Gönderi beyanı
Kargo adresi	Alıcı adresi
İl	Şehir kodu, servisin listesinden çözülür
Adres satırı 2	İlçe, kodlu bir değer olarak beklenir
Telefon	Bilgilendirme mesajının gittiği numara
Ağırlık	Ücrete esas ağırlığın bir tarafı
Paket tanımı	Desi hesabının kaynağı, tek kalemli siparişte
Takip numarası	Gönderi sisteme girdikten sonra atanır
Ödeme durumu	Tahsilatlı gönderide tahsil edilen tutar
Yurt dışında ek olarak	Mal tanımı, tarife kodu, değer ve para birimi
Karşılığı yok	En, boy, yükseklik; iade kodu; beyan tipi

Tablonun son iki satırı işin en çok sorun çıkaran yeri. En, boy ve yükseklik Shopify'da hiç bulunmaz; yurt dışı gönderide gereken gümrük verisi ise ürün kartlarında ayrıca tutulmadığı sürece hiçbir yerden gelmez.

Kurulumda hangi adımda kaldınız?

Kataloğunuzu ve mevcut kurulumunuzu anlatın, Shopify DHL entegrasyonunun sizin ürün yapınızda nasıl kurulacağını birlikte çıkaralım. Form doldurmanız gerekmiyor, telefon, e-posta veya WhatsApp'tan doğrudan bize ulaşın.

İletişime geçin 0850 888 2815 hub@nodusworks.com WhatsApp

ERİŞİM VE ENGELLER

DHL entegrasyon bilgilerini nereden alırsınız?

Bu soruda DHL eCommerce, Türk kargo firmalarının çoğundan bir adım önde: herkese açık bir geliştirici portalı var. Portal kendini firmanın servis kataloğu olarak tanıtıyor ve üç servisi ayrı ayrı listeliyor: kargo takip, gönderi hazırlama ve barkod oluşturma. Akış da yazılı: hesap oluşturuluyor, onay bekleniyor, erişim anahtarı alınıyor. Yurtiçi ve Aras tarafında bunun karşılığı yok; oralarda bilgi temsilciden e-postayla geliyor.

Buna karşılık portal her şeyi çözmüyor. Müşteri numaranız ve panel şifreniz kurumsal anlaşmadan geliyor, portalda kendi kendinize üretilmiyor. Yani portalda hesap açmak anlaşma yerine geçmiyor; ikisi birlikte gerekiyor.

Kurulumu gerçekten tıkayan iki engel var ve ikisini de baştan bilmek gerekiyor. Birincisi ortam ayrımı: test ortamı ayrı bir portalda ve aboneliği kendiliğinden onaylanıyor, canlı abonelik ise elle onaylanıyor. Canlı ortam için uygulama adınız, müşteri numaranız ve sabit çıkış adresiniz entegrasyon e-postasına bildirilip beyaz listeye alınıyor. Paylaşımlı bir barındırmada oturuyorsanız sabit çıkış adresiniz olmadığı için bu adımda kalırsınız; çözüm sabit adresli bir ara katman kullanmak. İkincisi servis yapısının yenilenmesi: eski servis uçları kullanımdan kalkıyor ve yeni entegrasyonlar yeni yapıya yazılıyor. Bu iki bilgi üçüncü parti kaynaklardan geliyor, resmi bir takvim yayınlanmış değil; devraldığınız eski bir MNG kurulumu varsa kontrol listenizin başına yazın.

Yurt dışı tarafta panel MyDHL adıyla çalışıyor ve yönetici ayarları resmi olarak belgeli: şirket görünümü, kullanıcı grupları, hesap numaraları, adres defteri, gönderi referansları, kurye kaydı ve dijital gümrük faturası buradan yönetiliyor. Geliştirici tarafı da global bir katalogda toplu duruyor. Anlaşmanın kime ait olduğu konusunda ise DHL eCommerce esnek görünüyor: kendi sözleşmeniz olmadan bir aracın toplu tarifesinden gönderi çıkarmak da mümkün gösteriliyor. İki modeli karıştırmamak gerekir, çünkü faturanın kimden geldiği ve tarifeyi kimin belirlediği değişir.

SHOPIFY SINIRI

Shopify'ın kendi kargo altyapısı Türkiye'de ne kadar işe yarıyor?

Kargo entegrasyonu ihtiyacı buradan doğuyor. Shopify'ın kargo tarafı belirli ülkeler için kurulmuş ve Türkiye o listede değil; DHL'in resmi uygulaması da bu sınırı değiştirmiyor.

Yönetim panelinden etiket satın alınamıyor

Shopify'ın kendi kargo hizmeti sekiz ülkedeki gönderim konumlarına bağlı ve Türkiye bu listede yok. Yardım merkezindeki DHL eCommerce etiket akışı da Amerika kıtasındaki konumlar içindir; Türkiye'deki mağazada görünmez.

Ödeme sayfasında gerçek taşıyıcı ücreti gösterilemiyor

Taşıyıcının kendi hesabından anlık ücret çekmek yalnız üst planlarda mümkün ve desteklenen taşıyıcı listesinde hiç Türk kargo firması yok. DHL Express'in kendi uygulaması ödeme sayfasında canlı ücret sunuyor ama o yurt dışı gönderi içindir ve DHL Express hesabı gerektirir.

İade etiketi Shopify'dan çıkmıyor

Shopify üzerinden iade etiketi üretmek için hem gönderim konumunun hem alıcı adresinin Amerika'da olması gerekiyor. Türkiye'de iade etiketi dışarıda üretilip siparişe yüklenir ya da onay ekranında kargo gerekmiyor seçilir.

Ürün kartında en, boy ve yükseklik alanı yok

Shopify ürün kartında ağırlık var, ölçü yok; ölçü yalnız kargo ayarlarındaki paket tanımında tutulur ve ürüne atanan paket yalnız tek kalemli siparişlerde geçerlidir. Bu yüzden desiyi hesaplayacak veri siparişin içinde bulunmaz.

Ödeme sayfasına ilçe alanı eklenemiyor

Plus dışındaki planlarda ödeme sayfasına il ve ilçe seçimi eklenemiyor. DHL eCommerce tarafı ise şehir ve ilçeyi kendi listesinden çözülen kodlu değerler olarak bekliyor, yani serbest metne gömülü ilçe beyan aşamasında hataya düşer.

Ürün kartında gümrük verisi için hazır alan yok

Yurt dışı gönderide gereken tarife kodu, mal tanımı ve menşe bilgisi Shopify'ın standart ürün alanlarında bulunmaz. Bu veriyi ek alanlarla tutup gönderi evrakına eşlemek kurulumun parçasıdır.

Bu altı maddenin ortak sonucu şu: Türkiye'de kargo entegrasyonu Shopify'ın üzerine bir kolaylık eklemiyor, olmayan bir parçayı yerine koyuyor. Etiket üretimi, takip numarası ve teslim durumu Shopify'a başka bir yolla girmiyor.

TEYİT LİSTESİ

Kurulumdan önce neyi teyit etmeniz gerekiyor

DHL'in dokümantasyonu Türk kargo firmalarına göre iyi ama Türkiye kapsamında yayınlanmamış konular var. Aşağıdaki dokuz başlık kurulumdan önce temsilcinize soracaklarınız.

Yurt içi başvuruda hangi belgeler isteniyor

DHL eCommerce'in e-ticaret müşterisi olma akışı ve belge listesi için yayınlanmış bir sayfa bulunamadı. Süreç müşteri temsilcisi ve bölge yapısı üzerinden yürüyor; takviminizi buna göre kurmanız ve belge listesini görüşmede almanız gerekir.

Sabit çıkış adresi şartı sizin için geçerli mi

Canlı ortam için sabit çıkış adresinin beyaz listeye alındığı iki bağımsız kaynakta yazıyor ama resmi teyidi yok. Paylaşımlı barındırma kullanıyorsanız bu şartı kurulumdan önce sormanız gerekir; sonradan çözmek ara katman kurmak demek.

Eski servis yapısı ne zaman kapanıyor

Eski servis uçlarının kullanımdan kalktığı üçüncü parti kaynaklarda yazıyor, resmi bir emeklilik takvimi yayınlanmış değil. Devraldığınız bir MNG kurulumu varsa hangi yapıya yazıldığını ve geçiş planını sormanız gerekir.

Tahsilatlı gönderide para kaç günde geçiyor

Üçüncü parti uygulamalar tahsilatlı gönderiyi destekliyor ancak DHL eCommerce Türkiye'nin bu hizmeti tanımlayan resmi sayfası ve aktarım süresi bulunamadı. Nakit akışınızı buna bağlayacaksanız süreyi sözleşmenizden teyit edin.

Tahsilat hizmet bedeli ne kadar

Kapıda ödeme çoğu firmada gönderi ücretinin üzerine ek bir kalem getiriyor. Bu kalemin varlığı ve tutarı anlaşmaya bağlı olduğu için burada oran vermiyoruz; ödeme sayfasındaki kapıda ödeme ücretinizi buna göre kurmalısınız.

Etiket hangi biçimde ve ölçüde geliyor

Barkod servisinin belirli bir yazıcı diliyle çıktı ürettiği belgeleniyor ama kaynaklar arasında tam bir uyum yok. Termal yazıcı alacaksanız biçim ve ölçü sorusunu kullanacağınız aracın sağlayıcısına sorun.

Anlaşmasız gönderi sizin için uygun mu

DHL eCommerce'te bir aracın toplu tarifesinden gönderi çıkarmak da mümkün gösteriliyor. Bu yolda fatura aracıdan gelir ve tarifeyi siz belirlemezsiniz; hacminiz büyüdükçe kendi anlaşmanız daha avantajlı olabilir.

Yurt dışı gönderide hangi ülkeler kâğıtsız gümrüklemeye açık

Kâğıtsız gümrükleme yurt dışı panelinde bir yönetici ayarı olarak duruyor ve resmi uygulamanın madde listesinde de sayılıyor. Hangi ülkelerin kabul ettiği gönderiye göre değiştiği için ülke listesini temsilcinizden almanız gerekir.

Avrupa vergi kaydı tarafı sizi ilgilendiriyor mu

Avrupa'ya satan mağazaların vergi kaydı ve eşik konuları bu araştırmada DHL kaynağında doğrulanamadı, bu yüzden burada bilgi vermiyoruz. Avrupa'ya düzenli satacaksanız bu konuyu mali danışmanınızla ve DHL temsilcinizle birlikte netleştirin.

YURT DIŞI GÖNDERİ

Yurt dışı gönderide gümrük evrakı nasıl kurulur?

Bu bölüm yurt içi kargodan tamamen ayrı bir iş. Yurt içi paket için beyan alıcı adresi ile desi; yurt dışı paket için beyan ticari fatura satır verisidir ve eksik veri gecikmeyle sonuçlanır.

Beyanın merkezi ticari fatura satır verisi

DHL'in kendi rehberi eksik ya da yanlış mal tanımının gümrükte gecikme ve yaptırım ürettiğini yazıyor. Kritik alanlar dört tane: mal tanımı, tarife kodu, değer ve para birimi. Bu dördü doğru değilse paket bekler.

Tarife kodunu bulmak için ücretsiz araç var

DHL kendi ücretsiz küresel ticaret hizmetleri aracıyla tarife kodu ve ülke gerekliliklerini sorgulamaya izin veriyor. Ürün kartlarınıza kod yazarken tarife kodunu buradan doğrulayabilirsiniz.

Gümrük verisi ürün kartında tutulmalı

Tarife kodu, mal tanımı ve menşe bilgisi Shopify'ın standart alanlarında bulunmuyor. Bu veriyi ek alanlarla tutup gönderi evrakına eşlemek kurulumun parçası; her gönderide elle yazmak sürdürülebilir değil.

Kâğıtsız gümrükleme panelde bir ayar

Yurt dışı panelinde dijital gümrük faturası bir yönetici ayarı olarak duruyor ve resmi Shopify uygulamasının madde listesinde de elektronik veri gönderimi olarak sayılıyor. Evrakın pakete basılı eklenmesini azaltıyor.

Teslim şekli kararı ödeme sayfanızı değiştirir

Gümrük vergisi ve ithalat vergisini satıcı üstlenirse bunu ödeme sayfasında tahsil etmesi gerekiyor; teslimatta müşteriden alınan modelde ise bedel kapıda çıkıyor. İkinci model beklenmeyen maliyet yüzünden iade talebi üretiyor.

İki tarafın hesapları ayrı yürür

Yurt dışı gönderi ayrı bir şirketten, ayrı hesapla ve ayrı panelden çıkıyor. Yurt içi kurulumunuzun çalışıyor olması yurt dışı tarafın hazır olduğu anlamına gelmez; ikisi ayrı ayrı kurulur ve ayrı ayrı denenir.

Yurt dışına düzenli satacaksanız bu bölümü kurulumun ayrı bir başlığı olarak planlamanız gerekir. Ürün kartlarına gümrük verisi eklemek, teslim şekli kararını vermek ve ödeme sayfasını buna göre kurmak; üçü birlikte yapılmadığında yurt dışı satış müşteri şikayetine dönüşüyor.

ADRES, DESİ VE TAHSİLAT

Kargo faturası neden beklediğinizden yüksek geliyor?

Yurt içi tarafta iki sebep var ve ikisi de Shopify'ın veri yapısından geliyor: ilçenin ayrık bir alan olarak tutulamaması ve ürün kartında ölçü bulunmaması. Kapıda ödeme kullanıyorsanız üçüncü bir kalem daha var.

İlçe kodlu bir değer olarak bekleniyor

DHL eCommerce tarafında şehir ve ilçe kendi listesinden çözülen değerler. Serbest metne gömülmüş, yanlış yazılmış ya da boş bırakılmış ilçe gönderi oluşturmayı hataya düşürür; beyan geçse bile paket yanlış aktarma merkezine gidip gecikir.

Çözüm adres satırı iki alanını ilçeye çevirmek

Sahada uygulanan yol tek: ödeme ayarlarında adres satırı iki alanı zorunlu yapılır ve ödeme dili düzenlenerek adı ilçe olarak değiştirilir. İkinci yol, sipariş sonrası adres onayı almaktır.

Desi, hacmin ücrete çevrilmiş hali

Fatura, ağırlık ile desiden hangisi büyükse ona göre kesilir. Paketin hacmi desimetreküp olarak bulunur, yurt içi gönderide üçe ve yurt dışı gönderide beşe bölünür; çıkan değer kilogramla karşılaştırılır.

Desiyi hesaplayacak veri siparişte yok

Shopify ürün kartında en, boy ve yükseklik alanı bulunmaz; ölçü yalnız paket tanımında tutulur ve çok kalemli siparişte mağaza varsayılan paketi kullanılır. Bu yüzden entegrasyonların bir kısmı gönderiyi sabit bir desiyle beyan eder.

Gerçek desiyi şube ölçer, fark faturaya gelir

Beyan edilen değer ile şubede ölçülen değer farklıysa fatura ölçülen değerden kesilir. Müşteriden aldığınız kargo bedeli sabitken faturanız değiştiği için aradaki fark doğrudan kârdan düşer.

Kapıda ödeme ayrı bir beyan tipi

Tahsilatlı gönderi gönderici ödemeli gönderiyle aynı beyan değil ve Shopify tarafındaki karşılığı manuel ödeme yöntemidir: ödeme beklemede açılır, tahsilat sonrası ödendi işaretlenir. Mutabakatı entegrasyon kurar; bölge ve tutar sınırı Shopify'da yerleşik değildir.

İade tarafında bilinmesi gereken bir ayrıntı var: DHL sabit iade kodu kullanıyor, yani kod her iadede aynıdır ve siparişe özel üretilmez. Bu, iade akışını kurmayı kolaylaştırır ama hangi iadenin hangi siparişe ait olduğunu eşleştirmeyi size bırakır. Pazaryeri kanallarınız varsa etiket ve iade akışı ayrıca ikiye ayrılır: Trendyol ve Hepsiburada paketleri kendi etiketleriyle çıkarken mağaza siparişleriniz sizin anlaşmanızla gider. İki akışı aynı depoda karıştırmadan yürütmek için Station'ı inceleyin.

SIK YAPILAN HATALAR

Shopify DHL entegrasyonunda en sık yapılan hatalar

Aşağıdaki dokuz başlık kurulumda en çok karşılaşılan hatalar. DHL'de bunların yarısı iki DHL'in karıştırılmasından çıkıyor.

Yurt içi gönderi için Express hesabı açmak

Yurt içi paket DHL eCommerce'ten, yurt dışı paket DHL Express'ten çıkar ve ikisi ayrı hesaptır. Yanlış tarafla başlayan kurulum, hesap açıldıktan sonra baştan yapılır.

Shopify'ın yardım sayfasındaki akışı beklemek

Yardım merkezindeki DHL eCommerce etiket akışı Amerika kıtasındaki gönderim konumları içindir ve Türkiye'deki mağazada görünmez. Aynı ad, farklı iş; o yardım sayfası Türkiye'den okuyanı en çok yanlış yola sokan kaynak.

Portalda hesap açmayı anlaşma yerine saymak

Geliştirici portalı erişim anahtarını veriyor ama müşteri numarası ile panel şifresi kurumsal anlaşmadan geliyor. Portalda hesap açmak tek başına gönderi oluşturmaya yetmiyor.

Canlı ortam için sabit adres beyan etmemek

Canlı abonelik elle onaylanıyor ve sabit çıkış adresinin beyaz listeye alınması gerekiyor. Paylaşımlı barındırmada oturan mağazalar tam bu adımda kalıyor; çözüm sabit adresli bir ara katman.

Test ortamında çalıştı diye canlıya güvenmek

Test aboneliği kendiliğinden onaylanırken canlı abonelik ayrı bir onay ve ayrı bir kayıt istiyor. Test ortamında çalışan bir kurulumun canlıda çalışacağı varsayılmamalı.

Devralınan eski MNG kurulumunu kontrol etmemek

Eski servis uçları kullanımdan kalkıyor. Devraldığınız bir kurulum bir gün sebepsiz durduysa ilk bakılacak yer bu; hangi servis yapısına yazıldığını baştan öğrenmek gerekir.

İlçe alanını çözmeden canlıya geçmek

DHL eCommerce ilçeyi kendi listesinden çözülen kodlu bir değer olarak bekliyor. İlçesi boş ya da serbest metne gömülü siparişler beyan aşamasında hataya düşer; adres satırı iki alanını ilçeye çevirmek kurulumun parçası.

Yurt dışı gönderiyi yurt içi gibi kurmak

Yurt dışı beyanın merkezi ticari fatura satır verisi: mal tanımı, tarife kodu, değer ve para birimi. Bu veri ürün kartlarında tutulmuyorsa her gönderide elle yazılır ve gümrükte bekleme kaçınılmaz olur.

Teslim şekli kararını vermeden yurt dışına satmak

Gümrük vergisini satıcı üstleniyorsa bunu ödeme sayfasında tahsil etmesi gerekiyor. Karar verilmeden açılan yurt dışı satış, müşteriden teslimatta beklenmeyen bir bedel istenmesiyle ve iade talepleriyle sonuçlanıyor.

SENARYO

Üç sık rastlanan sorun ve çözümü

Aşağıdaki üç kurulum senaryosu, bağladığımız mağazalarda çözdüğümüz Shopify DHL entegrasyonu sorunlarını nasıl ele aldığımızı gösterir.

Yanlış DHL tarafıyla başlanan kurulum

SorunMağaza yurt içi siparişlerini DHL ile göndermek istiyordu. İnternette bulduğu adımları izleyerek çevrimiçi bir işletme hesabı açtı, hesap numarasını aldı ve entegrasyonu kurmaya çalıştı; hiçbir yurt içi gönderi oluşturamadı ve iki hafta kaybetti.

SebepAçılan hesap uluslararası ekspres tarafına aitti. Türkiye'de yurt içi gönderiyi yapan taraf eski MNG Kargo olan DHL eCommerce'tir ve o ayrı bir şirket, ayrı hesap, ayrı servis yapısı demek. İki tarafın bilgileri birbirinin yerine kullanılamıyor.

ÇözümYurt içi taraf için ayrı bir kurumsal anlaşma yapıldı, müşteri numarası alındı ve erişim anahtarı firmanın geliştirici portalından edinildi. Uluslararası hesap kapatılmadı; mağaza yurt dışına da satmaya başladığında iki bağlantı yan yana yürüdü.

Test ortamında çalışan kurulum canlıda durdu

SorunGeliştirme sırasında her şey sorunsuzdu: gönderiler oluşuyor, barkodlar üretiliyor, takip verisi geliyordu. Canlıya alındığı gün hiçbir istek yanıtlanmadı ve mağaza o gün siparişlerini elle panelden göndermek zorunda kaldı.

Sebepİki ayrı ortam var ve ikisi ayrı kayıt istiyor: test aboneliği kendiliğinden onaylanırken canlı abonelik elle onaylanıyor. Canlı ortam için ayrıca uygulama adı, müşteri numarası ve sabit çıkış adresinin bildirilip beyaz listeye alınması gerekiyordu. Mağaza paylaşımlı bir barındırmada oturduğu için sabit çıkış adresi de yoktu.

ÇözümSabit adresli bir ara katman devreye alındı ve o adres beyaz listeye aldırıldı; canlı abonelik onayı da bu bilgilerle tamamlandı. Kurulum sonraki gün canlıda çalıştı. Aynı çalışmada eski servis yapısı yerine yeni yapının kullanıldığı da doğrulandı.

Yurt dışı gönderiler gümrükte bekliyor

SorunYurt dışına satmaya başlayan mağazanın gönderilerinin bir bölümü gümrükte günlerce bekliyordu. Bazı müşterilerden teslimatta beklenmeyen bir vergi isteniyor, bu da paketin teslim alınmamasına ve iade talebine dönüşüyordu.

Sebepİki ayrı eksik vardı. Ürün kartlarında tarife kodu, mal tanımı ve menşe bilgisi tutulmadığı için gönderi evrakı eksik hazırlanıyordu. İkincisi teslim şekli kararı verilmemişti: gümrük vergisi satıcı tarafından üstlenilmediği için bedel kapıda müşteriden isteniyordu.

ÇözümGümrük verisi ürün kartlarına eklendi ve evraka bu alanlardan yazılacak şekilde eşlendi; tarife kodları firmanın ücretsiz sorgulama aracıyla doğrulandı. Teslim şekli kararı verildi ve ödeme sayfası buna göre kuruldu, böylece müşteri maliyeti alışveriş anında gördü. Bekleme süreleri kısaldı, teslim alınmayan paket sayısı düştü.

STATION

Shopify DHL entegrasyonu

Sipariş, etiket, takip ve tahsilat akışını tek panelden yürütmek için geliştirdiğimiz araç Station. Pazaryeri kanallarınız varsa onların kargo akışı ayrı kaldığı için ikisini yan yana görmek işi kolaylaştırır.

Entegrasyonu incele Kurulum için görüşün

SSS

Sıkça Sorulan Sorular

Shopify DHL entegrasyonu nasıl yapılır?

İlk karar hangi DHL tarafını kullanacağınız: yurt içi gönderi eski MNG Kargo olan DHL eCommerce'ten, yurt dışı gönderi DHL Express'ten çıkar. Yurt içi tarafta kurumsal anlaşma yapılıp müşteri numaranız alınır, erişim anahtarı firmanın geliştirici portalından edinilir ve canlı ortam için sabit çıkış adresiniz beyaz listeye aldırılır. Son adımlar adres alanlarının düzeltilmesi, etiket ile desi kurgusunun tanımlanması ve deneme gönderisidir.

MNG Kargo DHL mi oldu?

Oldu. DHL Group MNG Kargo'yu satın aldı, devir Ekim 2023'te tamamlandı ve Mayıs 2025'te marka MNG Kargo olmaktan çıkıp DHL eCommerce oldu; şube, araç ve dijital platform kimliği değişti. Teknik altyapı adı ise MNG olarak duruyor: geliştirici portalı, servis adresleri ve entegrasyon e-postası o alan adı üzerinde duruyor.

Yurt içine gönderirken DHL Express mi DHL eCommerce mi kullanıyorum?

Yurt içi gönderi DHL eCommerce'ten çıkar; DHL Express uluslararası ekspres taraftır ve yurt içi paket taşımıyor. İkisi ayrı şirket, ayrı hesap, ayrı panel ve ayrı servis yapısı. Her ikisine de satıyorsanız iki ayrı anlaşma ve iki ayrı bağlantı kurmanız gerekir; tek hesapla iki tarafı yürütmek mümkün değil.

Eski MNG anlaşmam ve müşteri numaram geçerli mi?

Devir kurumsal bir hisse alımı olduğu için sözleşmeler firmanın kendisiyle devam ediyor. Buna karşılık entegrasyon tarafında servis yapısı yenilendi: eski servis uçlarının kullanımdan kalktığı biliniyor. Yani anlaşmanız duruyor olsa bile eski bir kurulumun çalışmaya devam edeceği varsayılmamalı; hangi yapıya yazıldığını kontrol etmeniz gerekir.

Shopify'ın yardım sayfasındaki DHL eCommerce etiket akışı bende neden çıkmıyor?

Çünkü o sayfa Türkiye'deki DHL eCommerce'i anlatmıyor. Türkçe yayınlanmış olsa da içerik Amerika kıtasındaki bir gönderim konumundan uluslararası etiket satın almayı kapsıyor. Aynı ad, tamamen farklı iş. Türkiye'deki mağazada o akış görünmez; etiket kargo firmasının panelinden ya da bir entegrasyon aracından basılır.

DHL entegrasyon bilgilerimi nereden alıyorum?

İki parçadan geliyor. Müşteri numaranız ve panel şifreniz kurumsal anlaşmayla veriliyor. Erişim anahtarını ise firmanın herkese açık geliştirici portalından kendiniz alıyorsunuz: hesap oluşturulur, onay beklenir, anahtar alınır. Portalda kargo takip, gönderi hazırlama ve barkod oluşturma servisleri ayrı ayrı listeleniyor ve kullanacağınız servislere abone olmanız gerekiyor.

DHL'in herkese açık geliştirici portalı var mı?

Var ve bu, Türk kargo firmalarının çoğunda bulunmayan bir avantaj. Portal firmanın servis kataloğunu, hesap oluşturma akışını ve erişim anahtarı alma adımlarını yayınlıyor. Buna karşılık portal anlaşma yerine geçmiyor: müşteri numaranız kurumsal sözleşmeden geliyor.

Statik IP'm yok, DHL entegrasyonunu yine de kurabilir miyim?

Canlı ortam için sabit çıkış adresinin beyaz listeye alınması gerektiği iki bağımsız kaynakta yazıyor; resmi teyidi yok ama sahada karşılaşılan bir şart. Paylaşımlı bir barındırmada oturuyorsanız sabit adresiniz olmadığı için bu adımda kalırsınız. Pratik çözüm sabit adresli bir ara katman kullanmak; kurulumdan önce bu şartı sormanız gerekir.

Test ortamı ile canlı ortam arasındaki fark ne?

İkisi ayrı portalda ve ayrı kayıt istiyor. Test aboneliği kendiliğinden onaylanırken canlı abonelik elle onaylanıyor; canlı ortam için uygulama adınız, müşteri numaranız ve sabit çıkış adresiniz entegrasyon e-postasına bildiriliyor. Bu yüzden test ortamında çalışan bir kurulumun canlıda çalışacağı varsayılmamalı.

Eski MNG entegrasyonum var, yenilemem gerekiyor mu?

Eski servis uçlarının kullanımdan kalktığı ve yeni entegrasyonların yeni yapıya yazıldığı üçüncü parti kaynaklarda yazıyor; resmi bir emeklilik takvimi yayınlanmış değil. Devraldığınız bir kurulum bir gün sebepsiz durduysa ilk bakılacak yer bu. Kontrol listenize hangi servis yapısının kullanıldığını ve geçiş planını yazın.

DHL'in Shopify'da resmi uygulaması var mı?

Uluslararası ekspres tarafın kendi resmi uygulaması var: uluslararası gönderi, ödeme sayfasında canlı ücret, toplu etiket, kâğıtsız gümrükleme, sipariş eşitleme ve takip sayılıyor. Kullanmak için o taraftan bir hesabınızın olması gerekiyor. Türkiye'deki yurt içi tarafın kendi Shopify uygulaması ise yok; uygulama mağazasındaki Türkiye listelemeleri üçüncü parti geliştiricilere ait.

Türkiye'de hangi uygulamayı kullanmalıyım?

Yurt içi gönderi için uygulama mağazasındaki üçüncü parti listelemeler kullanılıyor; kapsamları tekli ve toplu kargolama, kargo iptali, doküman görüntüleme, kısa mesaj bildirimi, kapıda ödeme, toplu etiket ile sevk irsaliyesi ve iade barkodu şeklinde sıralanıyor. Hepsi kullanmak için DHL hesap bilgilerinizin gerektiğini yazıyor, yani uygulama kargo anlaşmasını sağlamıyor.

Anlaşma yapmadan entegrasyon kurabilir miyim?

Kendi anlaşmanızla çalışmak için sözleşme ve müşteri numarası gerekiyor. Buna karşılık DHL eCommerce'te bir aracın toplu tarifesinden gönderi çıkarmak da mümkün gösteriliyor; o yolda ücret aracıya ödenir, fatura ondan gelir ve tarifeyi siz belirlemezsiniz. İki model karıştırılmamalı; hacminiz büyüdükçe kendi anlaşmanız daha avantajlı olabilir.

Shopify'ın kendi kargo etiketi Türkiye'de çalışıyor mu?

Çalışmıyor. Shopify'ın kendi kargo hizmeti sekiz ülkedeki gönderim konumlarına bağlı ve Türkiye bu listede yok; bu yüzden sipariş ekranında etiket satın alma akışı hiç görünmez. Etiket ya kargo firmasının kendi panelinden ya bir entegrasyondan basılır. İade etiketi de yalnız Amerika içinde üretilebiliyor.

Kargo takip numarası siparişe ne zaman eklenir?

Paket sisteme girip beyanı tamamlandıktan sonra. Barkod, kargo firmasının paketi tanıması için üretilen ara numaradır; takip numarası ise pakete sonradan atanır. Bu yüzden takip numarası siparişe anında değil, paket akışa girdikten sonra yazılır. Numara yazılmadığında Shopify'ın bildirim zinciri hiç başlamaz.

Sipariş beyan edilmemiştir uyarısı ne demek?

Etiketin basıldığı ama gönderinin kargo firmasına beyan edilmediği anlamına geliyor. Böyle bir etiket şubede okutulamaz ve paket sisteme girmez. Barkodu önce basıp beyanı sonra yapmak sorun değil, tersi sorundur; akışın her zaman beyanla kapanması gerekir.

İlçe yanlış girilirse ne oluyor?

DHL eCommerce tarafı şehir ve ilçeyi kendi listesinden çözülen kodlu değerler olarak bekliyor. Serbest metne gömülmüş, yanlış yazılmış ya da boş bırakılmış ilçe gönderi oluşturmayı hataya düşürür; beyan geçse bile paket yanlış aktarma merkezine gidip gecikir. Bu yüzden adres alanlarının düzeltilmesi kurulumun bir parçası olmalıdır.

Ödeme sayfasına ilçe alanı nasıl eklenir?

Plus dışındaki planlarda ödeme sayfasına il ve ilçe seçimi eklenemiyor; bunu bir Shopify çalışanı Türkiye'den gelen talebe verdiği cevapta doğruluyor. Sahada uygulanan çözüm tek: ödeme ayarlarında adres satırı iki alanı zorunlu yapılır ve ödeme dili düzenlenerek adı ilçe olarak değiştirilir. İkinci yol sipariş sonrası adres onayı almaktır.

Desi nasıl hesaplanıyor, ben mi giriyorum?

Fatura, ağırlık ile desiden hangisi büyükse ona göre kesilir. Paketin hacmi desimetreküp olarak bulunur, yurt içi gönderide üçe bölünür ve çıkan değer kilogramla karşılaştırılır; yurt dışı gönderide bölen beş olur. Yuvarlama yarımdan itibaren yukarı, altında aşağı yapılıyor; her zaman bir üst tam sayıya yuvarlandığını söyleyen kaynaklar resmi metinlerle çelişiyor.

Faturam neden beklediğimden yüksek geldi?

En sık sebep desi beyanı. Shopify ürün kartında en, boy ve yükseklik alanı bulunmadığı için entegrasyonların bir kısmı gönderiyi sabit bir desiyle beyan ediyor; gerçek desiyi şube ölçüyor ve fatura ölçülen değerden kesiliyor. Müşteriden aldığınız kargo bedeli sabit kaldığı için aradaki fark doğrudan kârdan düşer. Çözüm paket standartlarını tanımlayıp beyanı gerçek ölçülerden üretmek.

DHL kapıda ödemeli gönderi yapıyor mu?

Üçüncü parti Shopify uygulamaları tahsilatlı gönderiyi destekliyor, yani akış sahada çalışıyor. Buna karşılık DHL eCommerce Türkiye'nin bu hizmeti tanımlayan resmi sayfası bulunamadı, bu yüzden burada hizmetin koşulları hakkında bilgi vermiyoruz. Kapıda ödeme iş modelinizin parçasıysa koşulları ve varsa hizmet bedelini sözleşmenizde teyit etmeniz gerekir.

Tahsilatlı gönderide para hesabıma ne zaman geçiyor?

Aktarım süresi resmi bir kaynakta yayınlanmadığı için burada gün vermiyoruz. Bazı kargo firmaları bu süreyi kendi sayfasında yazıyor, DHL eCommerce Türkiye tarafında böyle bir sayfa bulunamadı. Nakit akışınızı bu hizmete bağlayacaksanız süreyi sözleşmenizden ya da temsilcinizden teyit etmeniz gerekir.

Kapıda ödeme Shopify tarafında nasıl kurulur?

Ayarlar içindeki ödemeler bölümünde kapıda ödeme hazır bir manuel ödeme yöntemi olarak durur. Böyle bir siparişte ödeme beklemede açılır ve tahsilat gerçekleştikten sonra ödendi olarak işaretlenir. Entegrasyonun işi bu eşleşmeyi kurmak. Bölgeye göre kısıtlamak, tutar sınırı koymak ya da kapıda ödeme ücreti eklemek Shopify'da yerleşik değildir.

DHL'de iade kodu tek kullanımlık mı?

DHL tarafında sabit iade kodu kullanılıyor, yani kod her iadede aynıdır ve siparişe özel üretilmez. Bu, iade akışını kurmayı kolaylaştırıyor: müşteriye tek bir kod iletmek yeterli. Buna karşılık hangi iadenin hangi siparişe ait olduğunu eşleştirmek size kalıyor, çünkü kod bu bilgiyi taşımıyor.

Shopify'da iade etiketi oluşturabilir miyim?

Mağazada self servis iade akışını açabilirsiniz, ancak Türkiye'de onay ekranında iade etiketi oluşturma seçeneği görünmez; bu özellik yalnız Amerika içi gönderilerde var. Pratik yol, iade kodunu müşteriye iletip Shopify tarafında kargo gerekmiyor seçeneğini kullanmak ya da dışarıda üretilmiş etiketi siparişe yüklemektir.

Yurt dışına satarken proforma faturayı kim hazırlıyor?

Beyanı siz veriyorsunuz, evrak sizin verinizden üretiliyor. DHL'in kendi rehberi eksik ya da yanlış mal tanımının gümrükte gecikme ve yaptırım ürettiğini yazıyor; kritik alanlar mal tanımı, tarife kodu, değer ve para birimi. Bu veriyi ürün kartlarınızda tutup gönderi evrakına eşlemek kurulumun parçasıdır, her gönderide elle yazmak sürdürülebilir değil.

Gümrük tarife kodunu nereden buluyorum?

DHL'in bu iş için ücretsiz bir küresel ticaret hizmetleri aracı var: tarife kodu ve ülke gerekliliklerini buradan sorgulayabiliyorsunuz. Ürün kartlarınıza yazdığınız kodları buradan doğrulamak, gümrükte bekleyen paket sayısını doğrudan azaltıyor.

Kâğıtsız gümrükleme nedir, nasıl açılıyor?

Uluslararası gönderide gümrük evrakının basılı olarak pakete eklenmesini azaltan bir hizmet. Yurt dışı panelinde dijital gümrük faturası adıyla bir yönetici ayarı olarak duruyor ve resmi Shopify uygulamasının madde listesinde elektronik veri gönderimi olarak sayılıyor. Hangi ülkelerin kabul ettiği gönderiye göre değiştiği için ülke listesini temsilcinizden almanız gerekir.

Gümrük vergisini ödeme sayfasında mı almalıyım, teslimatta mı?

İki model var ve karar ödeme sayfası kurgunuzu değiştiriyor. Gümrük vergisi ile ithalat vergisini satıcı üstlenirse bunu ödeme sayfasında tahsil etmesi gerekiyor; diğer modelde bedel teslimatta müşteriden alınıyor. İkinci model beklenmeyen maliyet yüzünden teslim alınmayan paket ve iade talebi üretiyor, bu yüzden düzenli yurt dışı satışta ilk model tercih ediliyor.

Pazaryeri kargosu ile kendi anlaşmam nasıl ayrışıyor?

Pazaryeri siparişi çoğu zaman platformun seçtiği firmayla ve onun ürettiği etiketle çıkar, bedeli hakedişinizden kesilir; kendi anlaşmanızla gönderdiğinizde etiketi siz üretirsiniz ve fatura size gelir. Aynı depoda iki ayrı etiket akışı yürür ve kargo maliyeti tek bir ekranda görünmez: pazaryeri kargosu hakediş raporunda, kendi anlaşmanız aylık faturada, kapıda ödeme ise tahsilat akışında durur.

Kargo fiyatını uygulama mı belirliyor?

Belirlemiyor. Kendi anlaşmanızla çalışıyorsanız tarife kargo firmasıyla yaptığınız pazarlıktan çıkar ve fatura size kargo firmasından gelir; entegrasyon yalnız veriyi taşır. Bir aracın toplu anlaşmasından gönderiyorsanız tarife o aracın tarifesidir ve ücreti ona ödersiniz. İki model karıştırılmamalı, çünkü faturanın kimden geldiği değişir.