DHL Express entegrasyonu:
kendi sözleşmenizle, siparişten etikete.

DHL Express entegrasyonu ne işe yarar, hangi satıcıya gerekir?

DHL Express entegrasyonu, Türkiye'den yurt dışındaki alıcıya ekspres koli gönderen satıcının sipariş ekranı ile kargo sistemi arasındaki elle veri taşımasını ortadan kaldırır. Türkiye'de DHL Express hizmetini DHL Worldwide Express Taşımacılık ve Ticaret A.Ş. verir; gönderi bedeli ve ek hizmetler bu şirketle yaptığınız sözleşmeye göre belirlenir. Yox İş Ortağım bu sözleşmeye taraf değildir: kargo bedeli almaz, tarife vermez, yalnız sizin hesabınızın bilgileriyle gönderi kaydını sipariş akışınıza bağlar.

Bu bağlantının en çok işe yaradığı satış senaryoları

• Etsy mağazanızdan ABD, Avrupa ya da Avustralya'daki alıcılara el yapımı ürün, takı veya tekstil gönderiyorsanız.
• eBay ya da Amazon'un yurt dışı pazaryerlerinde kendi gönderdiğiniz siparişler varsa.
• Kendi web sitenizden yurt dışına sipariş alıyor ve her siparişi DHL'in web ekranına tek tek yazıyorsanız.
• Aynı gün birden çok ülkeye koli çıkarıyor, takip numaralarını her kanala ayrı ayrı girmekte zorlanıyorsanız.

DHL Express hesabı ile DHL eCommerce hesabını ayırt etmek

Türkiye'de “DHL” adı iki ayrı hizmet için kullanılıyor. Eski MNG Kargo bugün DHL eCommerce adıyla yurt içi dağıtım yapar ve kendi müşteri numarası, kendi geliştirici portalı (ApiZone) ile çalışır; o bağlantıyı MNG Kargo ve DHL eCommerce rehberinde ayrıca anlattık. DHL Express ise uluslararası ekspres ağdır ve erişimi DHL'in küresel geliştirici portalındaki MyDHL API üzerinden verilir. Bir hesabın bilgileri diğerinde çalışmaz; ikisini birlikte kullanıyorsanız panelde iki ayrı kargo hesabı olarak bağlanırlar.

MyDHL API nedir, DHL Express hangi servisleri açar?

MyDHL API, DHL Express'in fiyat sorgulama, gönderi oluşturma, kurye talebi ve takip işlemlerini yazılımlara açtığı resmî REST arayüzüdür; DHL Developer Portal'da “DHL Express - MyDHL API” adıyla yayımlanır ve 11 Ekim 2026 tarihli 3.3.4 sürümü günceldir. Kimlik doğrulama Basic Auth standardıyla yapılır, yani her istekte DHL'in size verdiği erişim bilgileri birlikte gönderilir. Portalda aynı servislerin SOAP sürümü de ayrıca listelenir. Başlıca servisler:

Yox İş Ortağım bu servislerden hangilerini kullanır?

Panel, DHL Express'in satıcılarına sunduğu bu entegrasyon servisi üzerinden dört işi yapar: siparişten gönderi kaydı açıp takip numarasını ve etiketi almak, gönderinin durumunu siparişe yansıtmak, takip numarasını siparişin geldiği kanala iletmek ve birden çok kargo hesabınız varsa birincil kargoyu esas almak. Fiyat karşılaştırma, kurye çağırma ve vergi tahmini DHL'in kendi araçlarında ya da müşteri temsilcinizde kalır.

DHL Express entegrasyonu için hesap ve MyDHL API erişimi nasıl alınır?

DHL'in dokümanı bu konuda net: MyDHL API'yi kullanmak için kuruluşunuzun aktif bir DHL Express müşteri hesabı olmalıdır; geliştirici portalına üye olmak tek başına yetmez. Hesabınız varsa doğrudan erişim talebine geçersiniz, yoksa önce hesap açılır. Adımlar şöyle ilerler:

1. Hesabınız yoksa DHL Express'in müşteri hesabı talep formunu doldurun; DHL Express ekibi hesabı kurmak için sizinle iletişime geçer ve size bir hesap numarası tanımlanır.
2. developer.dhl.com adresinde geliştirici hesabı açın ve e-posta adresinizi doğrulayın.
3. Portaldaki “DHL Express - MyDHL API” sayfasında erişim talebi (Get Access) bağlantısıyla API erişimi isteyin.
4. DHL Express danışmanınız erişim bilgilerinizi iletir; teknik sorularda da ilk muhatabınız bu danışmandır.
5. Portalda profilinizin uygulamalar (apps) bölümünde API Key ve API Secret bilgilerinizi ve API'nin durumunu (Enabled, Pending, Disabled) kontrol edin.
6. Bilgileri Yox İş Ortağım'ın Kargo bölümüne girip bağlantıyı test edin; pilot sürecinde bu adımı sizinle birlikte yapıyoruz.

Hesap numarası panelde isteğe bağlı, gönderi için neden hazır olmalı?

Panelin kurulum adımında DHL Express hesap numarası isteğe bağlı görünür. Buna karşın MyDHL API şemasında gönderi oluşturma isteğinin “accounts” alanı zorunludur ve gönderici, ödeyen ya da vergi-harç hesabı türünde en az bir hesap numarası içerir; referansla takip sorgusu da bu numarayı ister. Bu yüzden kurulum görüşmesine hesap numaranızla gelin; bilmiyorsanız DHL Express satış temsilcinizden öğrenebilirsiniz.

Erişim bilgilerini güvenle paylaşmak

API Key ve API Secret, DHL hesabınız adına gönderi oluşturma yetkisi taşır; bu bilgilerle açılan gönderiler sizin hesabınız üzerinden oluşturulur. Bilgileri e-posta ya da mesajla göndermeyin; panele kendiniz girin ya da kurulum görüşmesinde ekranda birlikte girelim. Pazaryeri mağaza şifrenizi hiçbir aşamada istemiyoruz, satış kanalları da kendi resmî API anahtarlarıyla bağlanır.

MyDHL API test ortamı ile canlı ortam arasındaki fark

MyDHL API'de üç ayrı adres vardır ve her biri farklı bir amaca hizmet eder; gerçek gönderi yalnız canlı (production) ortamda oluşur. DHL'in resmî şemasında listelenen ortamlar:

Test ortamının bir inceliği satıcıları sık şaşırtır: takip servisi testte yalnız DHL'in dokümanında listelediği sabit örnek gönderi numaralarını tanır, test ortamında oluşturduğunuz gönderi takip edilemez. Testte durumun güncellenmemesi bu yüzden hata sayılmaz. Hangi erişim bilgilerinin canlı ortama ait olduğunu DHL Express danışmanınızdan teyit edin.

Pilot kurulumda ilk canlı gönderide neyi birlikte kontrol ediyoruz?

• Gönderi kaydı DHL Express'te açıldı mı, takip numarası siparişe yazıldı mı?
• Etiket doğru boyutta basılıyor, barkod okunuyor mu?
• Takip numarası ve kargo firması siparişin geldiği kanalda görünüyor mu?
• Kurye koliyi teslim aldıktan sonra durum bilgisi siparişe yansıyor mu?

Pazaryeri siparişi DHL Express gönderisine dönüşürken hangi bilgiler zorunlu?

Yurt içi kargoda ad, adres ve telefon çoğu zaman yeterlidir; DHL Express ise koliyi gümrükten geçirmek zorunda olduğu için daha fazla alanı zorunlu ve uzunluk sınırlı tutar. MyDHL API 3.3.4 şemasında bir satıcının en sık takıldığı kurallar şunlar:

Gümrük vergisini kim öder: teslim şekli seçimi

Şemadaki zorunlu “incoterm” alanı, varış ülkesindeki vergi ve harçların kimde kalacağını belirler. DHL'in listesinde yer alan DAP koşulunda vergiler kural olarak alıcıya, DDP koşulunda göndericiye aittir; DDP'de DHL ayrıca vergi-harç hesabı numarası isteyebilir. Pazaryerinde alıcıya “vergiler dahil” fiyat gösteriyorsanız bu tercihi DHL Express sözleşmenizde netleştirin; pilot kurulumda hangi koşulla göndereceğinizi birlikte konuşuyoruz.

Etsy ve eBay siparişlerinde en sık eksik kalan bilgiler

• Adres tek satırda 45 karakteri aşıyorsa ikinci ve üçüncü satıra bölün; aksi hâlde DHL gönderi kaydını reddeder.
• Ürün başlığını içerik açıklaması olarak kullanacaksanız 70 karakter sınırına dikkat edin; pazaryeri başlıkları çoğu zaman bu sınırı aşar.
• Aynı siparişte birden çok ürün varsa her biri gümrük beyanında ayrı kalem olarak yer almalı.
• Sipariş numaranızı gönderiye müşteri referansı olarak eklemek, DHL'in referansla takip sorgusunda işinizi kolaylaştırır.

Mikro ihracatta gümrük beyanı: BGB ve 2026'da değişen 600 kg / 30.000 Avro sınırı

Küçük paketle yapılan ihracatta gümrük beyanı, Ticaret Bakanlığından dolaylı temsil yetkisi almış posta ve hızlı kargo operatörlerinin verdiği Basitleştirilmiş Gümrük Beyannamesi (BGB) ile yapılır; sistemde beyan tipi hâlâ “ETGB” olarak seçildiği için iki ad birlikte geçer. Gönderinizin bu yolla mı, gümrük müşaviri aracılığıyla detaylı beyanla mı çıkacağını DHL Express temsilcinize sorun.

Pazaryeri satışında beyana yazılan unvan ve vergi numarası

Kılavuza göre operatör, ihracatçının sunduğu belgelerden pazaryerini biliyorsa EX kodlu BGB'nin “Pazaryeri” bölümüne pazaryerinin unvanını ve vergi kimlik numarasını yazar; sistem bu numarayı kontrol eder. Pratikte bu, siparişin hangi pazaryerinden geldiğini DHL'e verdiğiniz belgelerde açıkça belirtmeniz demektir; Amazon'un yurt dışı mağazalarından ya da Etsy'den gelen satışlarda bilgi ihracat istatistiğine doğru yansır.

Yurt dışından iade gelen gönderide KDV etkisi

Mikro ihracatla çıkan bir ürün iade olarak döndüğünde işlem “geri gelen eşya” rejimiyle yürür. Kılavuza göre ihracat nedeniyle KDV ya da ÖTV iadesinden veya istisnasından yararlanılmışsa bu vergiler geri gelişte tahsil edilir; durum Tek Pencere Sistemi'ndeki 0996 kodlu belgeyle Hazine ve Maliye Bakanlığına sorulur. İade politikanızı yazarken bu maliyeti hesaba katın ve ayrıntıyı mali müşavirinizle netleştirin.

DHL Express'te hacimsel ağırlık hesabı ve koli hazırlığı

DHL Express uluslararası gönderide ücreti, gerçek ağırlık ile hacimsel ağırlıktan hangisi yüksekse ona göre hesaplar. DHL Express'in yardım sayfasındaki formül uzunluk × genişlik × yükseklik (cm) / 5000 şeklindedir ve 1 m³ = 200 kg hacim anahtarına karşılık gelir. Bölen, yuvarlama kuralı ve tarife sözleşmeye göre değişebileceği için rakamları kendi DHL Express teklifinizden teyit edin. Aşağıdaki hesaplar yalnız formülün nasıl işlediğini gösteren örneklerdir:

İkinci satırdaki 3 kilogramlık koli, kutu boyutu yüzünden iki katından fazla ağırlık üzerinden ücretlendirilir; hafif ama hacimli ürünlerde kutu seçimi doğrudan kâra dokunur.

Hacimsel ağırlığı düşürmenin pratik yolları

• Kutu boyutunu ürüne göre seçin; kutudaki boş hacim doğrudan ücrete yansır.
• Birden çok koliye bölünen siparişte her koli için ayrı ölçü ve ağırlık girin; DHL şeması koli başına ayrı tanım ister.
• Ölçüleri göndermeden önce desi hesaplama aracımızla karşılaştırın; yurt içi desi hesabındaki bölen ile DHL Express'in 5000 böleni farklı olabilir.

DHL Express entegrasyonu hangi Yox İş Ortağım paketinde, elle gönderimden farkı ne?

Kargo bağlantısı Büyüme paketinden itibaren açılır; Başlangıç paketinde takip numarası siparişe elle girilir. Yox İş Ortağım'da 57 kargo ve lojistik firması tanımlıdır ve DHL Express, paketinizdeki kargo firması hakkından birini kullanır. Bütün paketlerde 3 günlük ücretsiz deneme vardır ve yıllık ödemede %20 indirim uygulanır.

Elle yönetim ile panel üzerinden gönderim karşılaştırması

Yurt içi siparişler için bir firma, yurt dışı için DHL Express kullanacaksanız en az iki kargo firması bağlayabildiğiniz Profesyonel paket uygun olur; bütün limitleri paket karşılaştırmasında görebilirsiniz. Uluslararası seçenekleri yan yana değerlendirmek isterseniz FedEx bağlantısını da inceleyin; bağlanabilen bütün kanal ve firmalar entegrasyon listesinde yer alıyor.

DHL Express entegrasyonunu canlıya almadan önce kontrol listesi ve sık hatalar

DHL Express gönderisinde hata çoğu zaman entegrasyondan değil, eksik ya da tutarsız veriden çıkar; gümrükte bekleyen bir koli, yurt içinde geciken bir koliden daha pahalıya mal olur. Canlıya geçmeden önce aşağıdaki listeyi birlikte gözden geçiriyoruz.

Canlıya geçiş kontrol listesi

1. DHL Express müşteri hesabınız aktif ve hesap numaranız elinizde.
2. Portalda MyDHL API durumu “Enabled”; test değil canlı ortam bilgileriyle çalışıyorsunuz.
3. Sık gönderdiğiniz ürünlerin gümrük açıklaması, GTİP kodu ve menşe ülkesi hazır.
4. Ürün grubunuzun varış ülkelerinde yasak ya da izne tabi olup olmadığını DHL Express'e sordunuz.
5. Hangi teslim şekliyle (DAP ya da DDP) göndereceğinize karar verdiniz.
6. İlk canlı gönderiyi pilot kurulumda bizimle birlikte oluşturup takip numarasının kanala gidişini doğruladınız.

En sık görülen hatalar

• Test bilgileriyle canlı gönderi beklemek: test ortamındaki kayıt kuryeye verilmez ve takip edilmez.
• DHL eCommerce (eski MNG) müşteri numarasını DHL Express alanına girmek.
• Gönderi tarihini geçmişe ya da 10 günden ileriye ayarlamak; DHL bu isteği kabul etmez.
• Gümrük beyanındaki kalem tutarlarıyla satış faturasındaki tutarların farklı olması.
• Takip numarasını, pazaryerinin kendi kargo anlaşmasını zorunlu tuttuğu bir siparişe yazmaya çalışmak; bu kural kanala göre değişir.