Magento Kargo Entegrasyonu: Yurt İçi ve Uluslararası Seçenekler

Kargo, e-ticarette müşterinin en çok dikkat ettiği konulardan biridir: ödeme sayfasında gördüğü ücret, teslim süresi ve sipariş sonrası takip bilgisi doğrudan memnuniyeti etkiler. Bu yazıda Magento kargo entegrasyonu konusunu; Magento 2’nin hazır gönderim yöntemleri, yurt içi kargo firmalarıyla bağlantı ve uluslararası taşıyıcılar üzerinden ele alıyoruz.

Türkiye’den yurt dışına satış yapmayı düşünüyorsanız lojistik ve gümrük tarafı için e-ihracat nedir, nasıl yapılır yazımız bu rehberi tamamlar.

Magento 2’de gönderim ayarları nerede yapılır?

Magento 2’de kargo ile ilgili ayarlar iki ana bölümde toplanır. Yönetim panelinde Stores > Settings > Configuration yolunu izledikten sonra sol menüdeki Sales başlığı altında şu iki bölümü görürsünüz:

1. Shipping Settings: Gönderimin çıkış adresi (origin) ve genel gönderim kuralları burada tanımlanır. Taşıyıcıların fiyat hesaplaması bu adrese göre yapılır.
2. Delivery Methods: Sabit ücret, ücretsiz kargo, tablo bazlı ücret ve entegre taşıyıcıların (UPS, USPS, FedEx, DHL) ayarları bu bölümdedir.

Çoklu mağaza veya çoklu web sitesi kullanıyorsanız ayarların kapsamına (scope) dikkat edin. Bir gönderim yöntemi bir web sitesinde açık, diğerinde kapalı olabilir; ücretler de site bazında farklılaşabilir.

Ayarlarda yaptığınız her değişiklikten sonra önbelleği temizlemeyi ve ödeme sayfasını farklı adreslerle test etmeyi alışkanlık haline getirin. Özellikle kampanya dönemlerinden önce yapılan değişiklikler, test edilmeden canlıya alındığında satış kaybına yol açabilir.

Magento 2’nin hazır gönderim yöntemleri

Herhangi bir kargo modülü kurmadan kullanabileceğiniz temel yöntemler şunlardır:

Ücretsiz kargo, sepet fiyat kurallarıyla (Cart Price Rules) birleştirildiğinde kampanya bazlı da kullanılabilir. Örneğin belirli bir kategori için ücretsiz kargo tanımlamak bu kurallarla mümkündür.

Magento DHL, UPS ve FedEx entegrasyonu

Magento 2; UPS, USPS, FedEx ve DHL için çekirdekte gelen taşıyıcı entegrasyonları içerir. Bu entegrasyonlar, taşıyıcıdan aldığınız API bilgileriyle canlı fiyat sorgulama, takip ve bazı durumlarda etiket oluşturma imkanı verir. Ekim 2026 itibarıyla Adobe dokümantasyonunda öne çıkan noktalar şunlardır:

• DHL: Panelde DHL REST veya DHL XML tipi seçilebiliyor; Adobe, DHL ile entegrasyonda REST API’yi tercih edilen yöntem olarak gösteriyor. DHL için etiket oluşturma desteği yalnızca ABD çıkışlı gönderiler için tanımlanmış.
• UPS: Eski UPS entegrasyon tipiyle işlem yapılamadığı, REST tipinin varsayılan ve etiket oluşturma için gerekli olduğu belirtiliyor.
• FedEx: FedEx’ten alınan hesap numarası, API anahtarı ve gizli anahtar ile yapılandırılıyor.
• USPS: Eski Web Tools seçeneği yerine REST API tipi ve tüketici anahtarı kullanılıyor.

Taşıyıcıların API yapıları zaman içinde değiştiği için, kullandığınız Magento sürümünün ilgili taşıyıcının güncel API’sini desteklediğini mutlaka kontrol edin. Eski bir Magento sürümünde taşıyıcı entegrasyonunun çalışmayı bırakması, güncelleme yapmamanın en sık görülen yan etkilerinden biridir.

Türkiye’den yapılan uluslararası gönderilerde taşıyıcıların yerel hesap ve anlaşma koşulları farklı olabilir. Canlı fiyat sorgulaması yerine anlaşmalı fiyatlarınızı tablo bazlı ücret olarak girmek bazen daha öngörülebilir sonuç verir.

Magento Yurtiçi Kargo ve diğer yerli firmalarla entegrasyon

Yurtiçi Kargo, Aras Kargo, PTT Kargo gibi yerli firmalar için Magento çekirdeğinde hazır bir entegrasyon yoktur. Bu bağlantı genellikle üç yoldan kurulur:

1. Kargo firmasının veya iş ortağının hazır Magento modülü: Varsa en hızlı yoldur. Modülün Magento 2 sürümünüzle uyumunu ve son güncelleme tarihini kontrol edin.
2. Kargo entegratörü (çoklu firma platformu): Birden fazla kargo firmasını tek panelden yöneten servisler, Magento ile API veya modül üzerinden bağlanır. Firma değiştirmek veya bölgeye göre firma seçmek kolaylaşır.
3. Özel modül: Kargo firmasının web servislerine doğrudan bağlanan bir modül geliştirilir. Özel iş akışlarınız varsa (ör. depo bazlı firma seçimi) en esnek çözümdür.

Hangi yolu seçerseniz seçin, kargo firmasıyla yaptığınız anlaşmada API erişimini, test hesabını ve barkod formatını yazılı olarak isteyin. Ayrıca API’nin günlük istek sınırını ve bakım saatlerini öğrenin; yoğun günlerde servise erişilememesi, depoda etiket basılamaması anlamına gelir.

Siparişten takip numarasına: Akış nasıl olmalı?

İyi kurgulanmış bir Magento kargo modülü, depodaki ekibin işini kolaylaştırır ve müşteriyi bilgilendirir. Tipik akış şöyledir:

1. Müşteri ödeme sayfasında gönderim yöntemini seçer, ücret anında hesaplanır.
2. Sipariş onaylandıktan sonra depo ekibi siparişi hazırlar.
3. Panelden veya entegrasyon üzerinden kargo firmasına gönderi kaydı oluşturulur, barkod veya etiket basılır.
4. Kargo firmasından dönen takip numarası Magento’da sevkiyat (shipment) kaydına işlenir.
5. Müşteriye takip numarasını içeren sevkiyat e-postası gönderilir.
6. Teslim bilgisi döndüğünde sipariş durumu güncellenir.

ERP veya depo yönetim sistemi kullanıyorsanız 3. ve 4. adımlar bu sistemler üzerinden de yapılabilir. Bu durumda takip numarasının Magento’ya geri yazılması entegrasyonun bir parçası olmalıdır.

Magento gönderim ayarlarında dikkat edilmesi gerekenler

• Ürün ağırlığı ve desi: Ürünlerde ağırlık alanı boşsa tablo bazlı ve canlı fiyat hesaplamaları yanlış çıkar. Desi hesabı gerekiyorsa ürün ölçüleri için ek özellikler tanımlayın.
• Bölge tanımları: Tablo bazlı ücretlerde ülke, il ve posta kodu bilgisinin tutarlı olması gerekir. Türkiye için il listesinin doğru tanımlandığından emin olun.
• Kapıda ödeme: Kapıda ödeme sunacaksanız (Cash On Delivery yöntemi), bunun kargo firmanızla yaptığınız anlaşmada ve kargo modülünde desteklendiğini kontrol edin.
• Ücretsiz kargo eşiği: Eşiği belirlerken kargo maliyetinizi ve sepet ortalamanızı birlikte değerlendirin.
• Ödeme sayfasında açıklık: Teslim süresini ve ücreti ödeme adımından önce, ürün sayfasında da gösterin. Beklenmedik kargo ücreti, sepet terkinin sık nedenlerinden biridir. Bu konuyu dönüşüm oranı optimizasyonu yazımızda ayrıca ele aldık.

Table Rates ile bölge bazlı ücret nasıl kurulur?

Yerli kargo firmanızla anlaşmalı bir fiyat listeniz varsa, canlı fiyat sorgulaması yapan bir modül olmadan da tablo bazlı ücretlerle doğru ücreti gösterebilirsiniz. Adımlar şöyledir:

1. Kapsamı web sitesi düzeyine getirin; tablo bazlı ücretler web sitesi kapsamında yüklenir.
2. Delivery Methods > Table Rates bölümünde yöntemi etkinleştirin ve koşulu seçin: ağırlık ve hedef, sepet tutarı ve hedef ya da ürün adedi ve hedef.
3. Mevcut şablonu dışa aktarın (Export), CSV dosyasında ülke, il, posta kodu ve koşul değerlerine göre ücretleri doldurun.
4. Dosyayı içe aktarın (Import) ve kaydedin.
5. Ön yüzde farklı adres ve sepet kombinasyonlarıyla test edin.

Ağırlığa dayalı tabloda ürünlerin ağırlık alanı mutlaka dolu olmalıdır. Desi ile çalışan bir anlaşmanız varsa ağırlık alanına ürünün desi karşılığını yazmak pratik bir çözüm olabilir; ancak bu tercihin raporlama ve diğer entegrasyonları nasıl etkileyeceğini önceden değerlendirin.

Kargo maliyetini kontrol altında tutmak

Kargo ücretinin bir kısmını veya tamamını siz üstleniyorsanız, kargo maliyeti kar marjınızı doğrudan etkiler. Şu ölçümleri düzenli takip edin:

• Sipariş başına ortalama kargo maliyeti: Müşteriden aldığınız ücretle karşılaştırın.
• Ücretsiz kargo eşiğinin etkisi: Eşiğe yakın sepetlerin oranı arttı mı, ortalama sepet tutarı değişti mi?
• İade kargo maliyeti: İade oranı yüksek kategorilerde kargo maliyeti ikiye katlanır.
• Hasar ve kayıp oranı: Firma değiştirme kararında fiyat kadar önemlidir.

Bu verileri Magento raporları, ERP ve kargo firmasının faturalarıyla birlikte değerlendirmek, hangi firmayla hangi bölgede çalışmanız gerektiğini gösterir.

Uluslararası gönderimde ek konular

Yurt dışına satışta kargo ücreti yalnızca taşıma bedelinden oluşmaz. Gümrük vergileri, alıcı ülkedeki vergiler ve iade lojistiği de hesaba katılmalıdır. Magento tarafında şunları planlayın:

• Ülke bazlı gönderim yöntemleri: Her ülkeye her yöntemi açmak yerine, gönderim yapabildiğiniz ülkeleri sınırlayın.
• Para birimi: Kargo ücretinin hangi para biriminde gösterileceği, çoklu para birimi ayarlarıyla uyumlu olmalı.
• Gümrük bilgileri: Ürünlerde GTİP (tarife) kodu ve menşe ülke gibi bilgiler için ayrı özellikler tanımlamak, uluslararası etiket ve beyanname süreçlerini kolaylaştırır.
• İade süreci: Yurt dışından iade nasıl alınacak, iade kargo ücretini kim ödeyecek? Bu kuralları satış koşullarınızda açıkça yazın.

Gümrük ve vergi uygulamaları ülkeye ve döneme göre değiştiği için ayrıntılar konusunda mali müşavirinize ve gümrük müşavirinize danışın.

Hazır kargo modülü mü, özel geliştirme mi?

Karar verirken şu soruları kendinize sorun:

Hazır modül seçerken son güncelleme tarihine, Magento sürüm uyumuna, destek kanalına ve kaynak koduna erişim olup olmadığına bakın. Uzun süredir güncellenmeyen bir modül, Magento güncellemesinden sonra ödeme sayfasını bozabilir.

İade gönderimleri ve yasal metinler

Kargo kurgusu yalnızca giden paketlerle sınırlı değildir. Cayma hakkı kapsamında dönen ürünlerin hangi kargo firmasıyla, hangi kodla ve kimin ödemesiyle gönderileceği müşteriye açıkça anlatılmalıdır. Pek çok kargo firması anlaşmalı iade kodu sunar; bu kodun sipariş e-postasında veya müşteri hesabında görünmesi, müşteri hizmetlerine gelen soruları azaltır.

Teslim süresi, kargo ücreti ve iade koşulları mesafeli satış sözleşmesi ve ön bilgilendirme formunda yer almalıdır. Sitedeki metinlerle Magento’daki gönderim ayarlarının birbiriyle çelişmemesine dikkat edin. Bu metinlerin kapsamı için mesafeli satış sözleşmesi ve yasal metinler yazımıza bakabilirsiniz; hukuki ayrıntılar için bir avukata veya mali müşavirinize danışın.

Kargo entegrasyonunu test ederken

Canlıya almadan önce şu senaryoları test ortamında deneyin:

• Farklı ağırlık ve bölgelerde fiyat hesaplaması doğru mu?
• Ücretsiz kargo eşiği ve kampanya kuralları beklendiği gibi çalışıyor mu?
• Kısmi sevkiyatta (siparişin bir kısmı gönderildiğinde) takip numarası doğru kayda işleniyor mu?
• İptal edilen gönderi kargo firması tarafında da iptal ediliyor mu?
• Kargo firmasının servisine ulaşılamadığında ödeme sayfası hata vermeden alternatif bir ücret gösteriyor mu?

Sonuç: Kargo deneyimi, satış deneyiminin parçasıdır

Magento 2, temel gönderim yöntemleri ve uluslararası taşıyıcılar için güçlü bir altyapı sunar; yerli kargo firmalarıyla bağlantı ise doğru modül veya entegratör seçimiyle tamamlanır. Ücret hesabının doğru, takip bilgisinin otomatik ve sürecin ölçülebilir olması müşteri memnuniyetini doğrudan etkiler. Mağazanız için Magento kargo entegrasyonu kurgusunu birlikte planlamak isterseniz hizmet sayfamızdan bize ulaşabilirsiniz. Ekibinizin gönderim ayarlarını kendisinin yönetmesini istiyorsanız Magento 2 eğitimi seçeneğine göz atın.

Sık Sorulan Sorular

Magento 2'de Yurtiçi Kargo modülü hazır geliyor mu?

Hayır. Magento çekirdeğinde UPS, USPS, FedEx ve DHL entegrasyonları bulunur; yerli kargo firmaları için firmanın veya iş ortaklarının modülü, bir kargo entegratörü ya da özel geliştirme gerekir.

Magento'da desiye göre kargo ücreti hesaplanabilir mi?

Tablo bazlı ücretler (Table Rates) ağırlık, sepet tutarı veya ürün adedine göre çalışır. Desi hesabı için ürün ölçülerini tutan ek özellikler ve bu hesabı yapan bir modül gerekir.

Magento DHL entegrasyonu Türkiye'den çalışır mı?

Magento'nun DHL entegrasyonu DHL'den alınan API bilgileriyle fiyat sorgulama ve takip için kullanılabilir. Adobe dokümantasyonuna göre etiket oluşturma desteği yalnızca ABD çıkışlı gönderiler için tanımlıdır. Türkiye'den gönderimde hesap koşullarınızı DHL ile netleştirin.

Ücretsiz kargo kampanyası nasıl tanımlanır?

Delivery Methods altındaki Free Shipping yöntemiyle sepet tutarı eşiği belirleyebilir ya da Cart Price Rules ile belirli ürün, kategori veya kupon koşuluna bağlı ücretsiz kargo tanımlayabilirsiniz.

Takip numarası müşteriye otomatik gider mi?

Takip numarası sevkiyat kaydına işlendiğinde Magento sevkiyat e-postasını gönderebilir. Numaranın kargo firmasından otomatik alınması için entegrasyon veya modül gerekir; aksi halde elle girilir.