Türkiye'deki kargo entegrasyon projelerinde Nodus Works'ün en sık düzelttiği yanlış varsayım şu: "Yurtiçi veya Aras'ın resmi Shopify uygulamasını kurarım, iş biter." Gerçek şu ki Türkiye'deki hiçbir kargo firmasının (Yurtiçi, Aras, MNG, Sürat, PTT) Shopify App Store'da kendi geliştirdiği resmi bir uygulaması yok; hepsi bağımsız geliştiricilerin kargo firması API'sine bağlanan üçüncü parti connector'ları üzerinden entegre ediliyor. Bu rehberde beş büyük kargo firmasının gerçek entegrasyon yollarını, toplu barkod ve iade barkodu gibi gözden kaçan özellikleri ve kurulum sonrası doğrulama adımlarını anlatıyoruz.
Shopify Kargo Entegrasyonu Nedir ve Neden Gereklidir?
Shopify kargo entegrasyonu, mağazanızın sipariş yönetim sistemi ile kargo firmasının API altyapısı arasında gerçek zamanlı veri akışı kuran bağlantıdır. Bu bağlantı kurulmadan her sipariş için kargo etiketi elle oluşturulur, adres kargo sistemine elle girilir, takip numarası kopyalanıp müşteriye elle iletilir: sipariş başına 3-6 dakika süren, günde onlarca kez tekrarlanan bir iş yüküdür. Günlük 100 sipariş işleyen bir mağaza için bu, yalnızca kargo işlemlerine harcanan 2-3 saatlik bir mesai anlamına gelir.
Türkiye'deki Kargo Firmaları ve Shopify Uyumluluğu
Beş büyük kargo firmasının da Shopify App Store'da kendi adına yayınlanmış resmi bir uygulaması yoktur; hepsi üçüncü parti geliştiricilerin ürünleri üzerinden bağlanır. Aşağıdaki tablo her firma için doğrulanmış gerçek seçenekleri gösteriyor.
Kritik Not: "Resmi uygulama" ifadesi Shopify App Store'da kargo firmasının adını taşıyan her uygulama için geçerli değildir. Bir uygulamanın adında "Aras Kargo" veya "Yurtiçi Kargo" geçmesi, o kargo firmasının kendisi tarafından geliştirildiği anlamına gelmez; geliştirici bilgisini App Store sayfasında mutlaka kontrol edin.
Yurtiçi Kargo
Yurtiçi Kargo'nun Shopify App Store'da kendi adına yayınlanmış bir uygulaması yoktur. Pax Digital'in "Pax: Yurtiçi Kargo" uygulaması, en yaygın kullanılan üçüncü parti seçenektir; otomatik takip kodu, SMS/e-posta bildirimi ve kapıda ödeme desteği sunar. API erişimi için Yurtiçi Kargo ile kurumsal sözleşme imzalamanız ve müşteri numarası/şifre bilgilerini almanız gerekir; minimum hacim şartı yoktur.
Aras Kargo
Aras Kargo için de durum aynıdır: resmi bir uygulama yoktur, Pax Digital'in "Pax: Aras Kargo" uygulaması üçüncü parti bir connector olarak çalışır. API erişimi için müşteri numarası ve API şifresi gereklidir; bu bilgiler kurumsal sözleşme sonrasında B2B portalı veya temsilci aracılığıyla iletilir. API şifresi güvenlik nedeniyle periyodik olarak yenilenebilir; uygulamadaki eski şifre bağlantı hatasına yol açar.
MNG Kargo
MNG Kargo, beş firma arasında üçüncü parti kapsamı en sınırlı olanıdır. Doğrudan "MNG Kargo" adıyla yayınlanmış bir uygulama bulunmuyor; en yakın seçenek Pax Digital'in DHL Kargo API'sine bağlanan uygulamasıdır. MNG'yi doğrudan destekleyen çok-firmalı bir entegratör bulamazsanız, özel API geliştirmesi veya kargo firmasının kendi entegrasyon danışmanlığı gerekebilir. Aylık gönderi hacmi düşük mağazalar için bu sınırlı kapsam, Yurtiçi veya Aras'ı daha pratik bir başlangıç noktası yapar.
Sürat Kargo
Sürat Kargo'nun Shopify App Store'daki üçüncü parti uygulaması izsoft tarafından geliştirilmiştir; kargo etiketi basma, otomatik takip kodu ekleme, SMS bildirimi ve yapay zeka destekli adres doğrulama sunar. İstanbul ve Ankara'da aynı gün teslimat sunan nadir kargo firmalarından biridir.
PTT Kargo
PTT Kargo'nun tek başına bir Shopify uygulaması bulunmuyor; doğrulanmış tek yaygın seçenek, PTT'yi de kapsayan çok-firmalı GurmeHub Kargo Entegratör uygulamasıdır. Minimum hacim şartı olmadığından küçük mağazalar için erişilebilir görünse de, tek-firma seçeneklere kıyasla kurulum ve destek süreci daha sınırlıdır.
Toplu Barkod Oluşturma: Gözden Kaçan Ama Kritik Bir Özellik
Günde onlarca sipariş işleyen bir mağaza için her kargo etiketini tek tek oluşturmak, entegrasyonun asıl zaman kazandırması gereken noktada darboğaz yaratır. Toplu barkod oluşturma, seçili tüm siparişlerin kargo etiketlerini tek işlemle üretme özelliğidir; Pax'ın uygulamaları, GurmeHub Kargo Entegratör ve Station bu özelliği sunar. Bu özelliği sunmayan bir entegrasyon, sipariş hacminiz büyüdükçe yeniden manuel işe dönüşür.
İpucu: Kargo uygulaması seçerken toplu barkod oluşturmanın yanı sıra iade barkodu entegrasyonuna da bakın. GurmeHub Kargo Entegratör gibi bu özelliği sunan uygulamalarda müşteri iade talebi oluşturduğunda iade barkodu otomatik üretilir; bu özelliği sunmayan uygulamalarda iade süreci elle yönetilmek zorunda kalır.
Shopify Kargo Entegrasyonu Öncesi Hazırlık
Entegrasyona başlamadan önce tamamlanması gereken üç temel hazırlık adımı vardır: kurumsal sözleşme imzalamak, API erişim bilgilerini temin etmek ve Shopify ayarlarını uygun hale getirmek.
1. Kurumsal Sözleşme ve API Erişimi
Kargo firmasının API'sine erişmek için önce kurumsal müşteri sözleşmesi imzalanmalıdır. Süreç firmadan firmaya 3-10 iş günü arasında değişir. Sözleşme tamamlandıktan sonra şu bilgiler temin edilir: müşteri numarası, API anahtarı/şifresi, şube kodu.
Uzak Durulması Gereken Risk: API anahtarlarını asla üçüncü kişilerle paylaşmayın ve Shopify admin panelinde açık metin olarak saklamaktan kaçının. Bu bilgiler seçtiğiniz üçüncü parti uygulamanın kendi güvenli ayar ekranına girilmelidir.
2. Shopify Mağaza Ön Hazırlığı
Entegrasyon öncesinde şu ayarlar doğrulanmalıdır: Settings → Shipping and delivery bölümünde Türkiye için teslimat bölgeleri tanımlanmış olmalı, tüm ürünlerin ağırlık bilgisi eksiksiz girilmiş olmalı, vergi ayarlarında KDV yapılandırması tamamlanmış olmalı. 500'den fazla ürünü olan mağazalar CSV export/import yöntemiyle toplu ağırlık güncellemesi yapabilir.
3. Test Siparişleriyle Doğrulama
Üretim ortamına geçmeden önce en az 10 test siparişi oluşturun; kargo etiketinin doğru üretilip üretilmediğini, takip numarasının Shopify sipariş detayına düşüp düşmediğini ve bildirimlerin tetiklenip tetiklenmediğini doğrulayın. Bazı üçüncü parti uygulamalar bunun için ayrı bir test/sandbox erişimi talep etmenizi isteyebilir.
Shopify Kargo Entegrasyon Yöntemleri
Shopify kargo entegrasyonu üç farklı yöntemle kurulabilir: tek firma üçüncü parti uygulama, çok-firmalı entegratör ve özel API geliştirmesi.
Tek Firma Üçüncü Parti Uygulama ile Kurulum
Seçtiğiniz kargo firmasına özel üçüncü parti uygulamayı (örneğin Pax: Yurtiçi Kargo veya Pax: Aras Kargo) kurmak, çoğu küçük ve orta ölçekli mağaza için en hızlı yoldur.
- Shopify admin → Apps → App Store'a gidin, kargo firmasının adını arayın; sonuçlarda geliştirici bilgisini kontrol ederek üçüncü parti uygulamayı seçin.
- "Add app" butonuyla uygulamayı yükleyin ve gerekli izinleri onaylayın.
- Uygulama ayarlarında kargo firmasından aldığınız API bilgilerini (müşteri no., şifre, şube kodu) girin.
- Uygulamanın bağlantı testi özelliğiyle API bağlantısını doğrulayın.
- Shipping zones bölümünden Türkiye için kargo bölgelerini ve fiyatlandırma kurallarını tanımlayın.
- Test siparişi oluşturun, etiketi üretin ve takip numarasının siparişe düştüğünü doğrulayın.
Çok-Firmalı Entegratör ile Kurulum
Sürat veya PTT gibi tek-firma seçeneği sınırlı kargo firmalarını kullanıyorsanız veya birden fazla firmayı tek panelden yönetmek istiyorsanız GurmeHub Kargo Entegratör veya Nodus Works'ün geliştirdiği Station gibi çok-firmalı platformlar gereklidir; MNG için platformun bu firmayı desteklediğini kurulumdan önce ayrıca doğrulayın. Bu platformlar üzerinden her kargo firması için ayrı ayrı API bilgisi girilir; sipariş geldiğinde platform ilgili kargo firmasını sizin belirlediğiniz kurala göre yönlendirir.
Özel API Geliştirmesi
Aylık 2.000'den fazla sipariş işleyen, ERP veya WMS ile entegre çalışması gereken ya da tamamen özelleştirilmiş depo iş akışlarına ihtiyaç duyan kurumsal mağazalar için en fazla özelleştirme imkânı veren yöntemdir. Kargo firmasının REST API'si doğrudan Shopify webhook'larına bağlanır; üçüncü parti uygulama maliyeti ortadan kalkar ve iş akışı sınırsız özelleştirilebilir.
Shopify'da Kargo Fiyatlandırması ve Otomatik Hesaplama
Shopify kargo fiyatlandırması iki modelle yapılandırılır: sabit fiyat ve ağırlık bazlı hesaplama.
Sabit Fiyat ve Koşullu Ücretsiz Kargo
Settings → Shipping and delivery → Shipping zones bölümünden tüm siparişler için sabit kargo ücreti tanımlanır; belirli bir sipariş tutarı aşıldığında ücretsiz kargo devreye girer. Ücretsiz kargo eşiğini ortalama sepet tutarınızın %15-20 üzerine koymak, müşterileri ek ürün eklemeye teşvik ederken dönüşüm oranını korur.
Ağırlık Bazlı Fiyatlandırma
Ürün ağırlığına göre farklı fiyat dilimleri tanımlanır. Bu modelin çalışması için tüm ürünlerin Shopify'da ağırlık bilgisinin eksiksiz girilmiş olması zorunludur. Türk kargo firmalarının kullandığı desi (hacimsel ağırlık) hesabını göz önünde bulundurun: kargo firması gerçek ağırlık ile hacimsel ağırlık (en × boy × yükseklik / 3000) arasındaki büyük olanı faturalar.
Entegrasyon Sonrası Test ve Doğrulama
Kargo entegrasyonu canlıya alınmadan önce en az beş senaryo üzerinde test yapılmalıdır: standart sipariş, ağır/hacimli sipariş, farklı şehirlere teslimat, iade siparişi ve iptal edilen sipariş. Test siparişlerini gerçek ürünler ve gerçek Türkiye adresleriyle oluşturun.
Shopify Plus dışındaki planlarda checkout'ta il/ilçe seçimi açılır kutu (dropdown) olarak gelmez; müşteri adresi serbest metin olarak girer, bu da yazım hatası riskini artırır. Bu durum, checkout sayfasında yaşanan adres uyumsuzluklarını yapay zeka ile düzelten bir uygulama seçmeyi Plus dışındaki mağazalar için özellikle önemli kılar. GurmeHub Kargo Entegratör gibi AI destekli adres düzeltme sunan uygulamalar, bu riski kargo etiketi oluşturulmadan önce otomatik olarak azaltır.
Test Kontrol Listesi
- Sipariş onaylandığında kargo etiketi otomatik oluşuyor mu?
- Takip numarası sipariş detay sayfasında ve müşteri onay e-postasında görünüyor mu?
- Kargo firmasının web sitesinde takip numarası çalışıyor mu?
- Bildirimler doğru tetikleniyor mu?
- İade talebi oluşturulduğunda sistem doğru yanıt veriyor mu, iade barkodu otomatik üretiliyor mu?
- Farklı ağırlık aralıklarında fiyat hesaplaması doğru ve tutarlı mı?
Yaygın Sorunlar ve Çözümleri
Sorun 1: API Bağlantısı Kurulamıyor
Kargo firmasının portalından API bilgilerinin son sürümünü alın. Aras Kargo başta olmak üzere bazı firmalar güvenlik güncellemelerinde API şifresini otomatik yeniler; uygulamadaki eski şifre bağlantı hatasına yol açar. Kopyala-yapıştır ile girilen bilgilerde gizli boşluk karakteri olup olmadığını kontrol edin.
Sorun 2: Kargo Etiketi Oluşturulmuyor
Siparişin içerdiği ürünlerden en az birinin ağırlık bilgisi eksik olabilir. Products → [ilgili ürün] → Shipping sekmesinden ağırlık bilgisini doldurun. Sözleşmedeki müşteri numarasının API ayarlarında harf büyüklüğüne dikkat edilerek tam olarak girilip girilmediğini doğrulayın.
Sorun 3: Takip Numarası Müşteriye İletilmiyor
Settings → Notifications → Shipping confirmation e-posta şablonunda {{ fulfillment.tracking_number }} değişkeninin mevcut olduğunu kontrol edin. Özelleştirilmiş e-posta şablonlarında bu değişken silinmiş olabilir; orijinal Shopify şablonuyla karşılaştırarak eksikliği giderin.
Sıkça Sorulan Sorular
Shopify'da kargo entegrasyonu nasıl yapılır?
Kargo firmasıyla kurumsal sözleşme imzalayıp API bilgilerini temin etmek, ardından seçtiğiniz üçüncü parti uygulamayı Shopify App Store'dan yükleyip bu bilgileri girmek ve kargo bölgelerini tanımlamak adımlarıyla tamamlanır.
Shopify Türkiye'de hangi kargo firmasıyla entegre çalışır?
Shopify, Türkiye'de Yurtiçi Kargo, Aras Kargo, MNG Kargo, Sürat Kargo ve PTT Kargo ile üçüncü parti uygulamalar üzerinden entegre çalışabilir. Hiçbirinin kendi adına yayınladığı resmi bir Shopify uygulaması yoktur; Yurtiçi ve Aras için Pax Digital'in uygulamaları, PTT ve MNG için ise çok-firmalı entegratörler (GurmeHub gibi) en yaygın seçeneklerdir.
Shopify kargo entegrasyonu için hangi plan gereklidir?
Kargo uygulamaları Shopify'ın Basic, Shopify, Advanced ve Plus dahil her ücretli planında çalışır. Plus planı ayrıca checkout'ta il/ilçe seçimini açılır kutu olarak sunar; diğer planlarda bu alan serbest metin olduğu için adres doğrulama araçları daha kritik hale gelir.
Shopify'da birden fazla kargo firması kullanılabilir mi?
Evet. Shopify'da farklı teslimat bölgelerine farklı kargo firmaları atanabilir; birden fazla firmayı tek panelden yönetmek için GurmeHub veya Station gibi çok-firmalı entegratörler kullanılabilir.
Shopify kargo entegrasyonu için hangi kargo firması önerilir?
Tek bir "en iyi" kargo firması yoktur; doğru seçim şube ağınızın kapsadığı bölgeye ve kargo firmasıyla anlaşabileceğiniz birim fiyata göre değişir. Yurtiçi'nin geniş şube ağı, Aras'ın hızlı teslimat kapasitesi, Sürat'ın büyük şehirlerde aynı gün teslimat seçeneği; hepsi farklı senaryolarda avantajlı olabilir. Karar vermeden önce birden fazla firmadan fiyat teklifi almanızı öneririz.
MNG Kargo Shopify entegrasyonu nasıl yapılır?
MNG Kargo'nun doğrudan kendi adına bir Shopify uygulaması bulunmadığından entegrasyon, MNG'yi destekleyen bir middleware çözümü veya özel API geliştirmesi üzerinden kurulur. Önce MNG ile kurumsal sözleşme imzalanır ve API bilgileri alınır, ardından seçilen platforma bu bilgiler girilerek Shopify bağlantısı kurulur; hangi platformun MNG'yi desteklediğini kurulumdan önce doğrulamanızı öneririz.
Shopify'da kargo firması değiştirmek zor mu?
Teknik olarak mevcut uygulamayı kaldırıp yeni firmanın uygulamasını kurmak yeterlidir. Zorlu olan operasyonel geçiştir: yeni firmayla sözleşme imzalanması, API bilgilerinin temin edilmesi ve depo personelinin yeni etiket sürecine alışması genellikle 1-2 haftalık uyum süreci gerektirir.
Shopify Kargo Entegrasyonunuzu Doğru Kurun
Doğru yapılandırılmış kargo entegrasyonu sipariş başına harcanan manuel süreyi dakikalara indirir, müşteri memnuniyetini artırır ve operasyonel hatalardan kaynaklanan maliyetleri önler. "Resmi uygulama" beklentisiyle başlayan projeler ilk adımda yanlış yöne sapabilir; doğru üçüncü parti seçeneği bulmak, toplu barkod ve iade barkodu gibi sipariş hacmi büyüdükçe fark yaratan özellikleri baştan değerlendirmek daha sağlıklı bir kuruluma götürür.
Belirli kargo firmaları için hazırladığımız ayrıntılı kurulum rehberlerine göz atabilirsiniz: Aras Kargo Shopify entegrasyonu, Yurtiçi Kargo Shopify entegrasyonu ve MNG Kargo Shopify entegrasyonu. Kargo, pazaryeri ve muhasebe entegrasyonlarınızı tek panelden yönetmek isterseniz Shopify entegrasyon çözümleri hizmetimiz hakkında ekibimizle iletişime geçebilirsiniz.
