Yurtiçi Kargo Shopify Entegrasyonu Kurulum Rehberi

Yurtiçi Kargo Shopify entegrasyonu, Shopify App Store'daki resmi uygulama aracılığıyla kurulabilen ve sipariş onayından kargo etiketine kadar tüm süreci otomatikleştiren bir altyapı çözümüdür. Bu rehber, Yurtiçi Kargo'yu Shopify mağazanıza entegre etmeniz için gereken her adımı, teknik gereksinimleri ve yaygın sorunların çözümlerini kapsamaktadır.

Yurtiçi Kargo Shopify Entegrasyonu Nedir?

Yurtiçi Kargo Shopify entegrasyonu, mağazanızın sipariş verilerini Yurtiçi Kargo sistemine otomatik ileten ve etiket, takip numarası ile bildirim süreçlerini otomatik yürüten bir API bağlantısıdır. Entegrasyon kurulmadan önce her sipariş için manuel etiket yazdırma, kargo sistemine adres girme ve takip numarasını kopyalama işlemleri gerekir; bu süreç sipariş başına 3–6 dakika alır.

Türkiye'de 780'den fazla şubesiyle Yurtiçi Kargo, özellikle Anadolu'nun ikinci ve üçüncü kademe şehirlerine erişimde güçlü bir seçenektir. Shopify App Store'da Türkiye'nin en çok yorum alan resmi kargo uygulamalarından biri olan Yurtiçi Kargo entegrasyonu, aylık 10 siparişten 10.000 siparişe kadar ölçeklenebilir bir yapıya sahiptir.

Rakip kargo firmalarıyla karşılaştırıldığında Yurtiçi'nin en önemli avantajları şunlardır: geniş şube ağı, API'ye erişim için minimum hacim şartı bulunmaması ve iade yönetimi API desteği.

Yurtiçi ve Diğer Kargo Firmalarının Shopify Uyumluluğu

Türkiye'deki ana kargo firmalarının Shopify entegrasyon özellikleri birbirinden önemli ölçüde farklılaşır. Doğru kargo firmasını seçmek; teslimat bölgelerinize, sipariş hacminize ve fiyat beklentilerinize göre değişir.

Yurtiçi Kargo, API erişimi için minimum hacim şartı koymayan nadir kargo firmalarından biridir; bu özellik yeni açılan Shopify mağazaları için önemli bir avantajdır. Aras Kargo da benzer şekilde hacim şartı koymaz; ancak Yurtiçi'nin resmi Shopify uygulaması kullanıcı arayüzü açısından daha olgun bir yapıya sahiptir.

Kurulum Öncesi Gereksinimler

Yurtiçi Kargo Shopify entegrasyonunu başlatmadan önce tamamlanması gereken dört ön koşul vardır: Yurtiçi kurumsal sözleşmesi, API kimlik bilgileri, Shopify ürün veri doğrulaması ve teslimat bölgesi yapılandırması.

Yurtiçi Kargo Kurumsal Hesap Açılışı

Yurtiçi Kargo'nun kurumsal müşteri bölümüne (yurticikargo.com.tr → Kurumsal Çözümler) başvurarak müşteri temsilcisi talep formu doldurun. Temsilci atanmasının ardından sözleşme süreci başlar ve genellikle 3–5 iş günü içinde tamamlanır. Sözleşme imzalandıktan sonra size özel müşteri numarası ve API erişim şifresi tanımlanır.

Sözleşme görüşmesinde aylık tahmini gönderi hacminizi ve hedef teslimat bölgelerinizi önceden bildirin. Aylık 200'den fazla gönderi taahhüdü verebiliyorsanız birim kargo bedelinde %10–20 indirim kazanabilirsiniz.

💡 İPUCU: Yurtiçi Kargo temsilcinizden API Sandbox (test ortamı) erişimi de isteyin. Sandbox, gerçek kargo üretmeden entegrasyon testleri yapmanıza olanak tanır ve canlıya almadan önce hata ayıklamayı kolaylaştırır.

Shopify Ürün Veri Kontrolü

Entegrasyon öncesinde tüm ürünlerin Shopify admin panelinde ağırlık bilgisinin girilmiş olması zorunludur. Products → Export ile tüm ürünleri CSV olarak dışa aktarın, 'Variant Grams' sütununu kontrol edin ve değeri 0 olan ürünleri güncelleyin. 1000'den fazla ürünü olan mağazalar için bu toplu güncellemeyi CSV import yöntemiyle yapabilirsiniz.

Adım Adım Yurtiçi Kargo Shopify Kurulumu

Yurtiçi Kargo Shopify entegrasyonu dört ana adımda tamamlanır: uygulama yükleme, API bağlantısı, kargo bölgesi tanımlama ve test doğrulaması. Tüm süreç ortalama 2–4 saat alır.

Adım 1: Uygulamayı Yükleyin

1. Shopify admin panelinde Apps → App Store'a gidin.
2. Arama kutusuna 'Yurtiçi Kargo' yazın.
3. Resmi Yurtiçi Kargo uygulamasını bulun ve 'Add app' butonuna tıklayın.
4. Gerekli izinleri onaylayın (sipariş okuma, gönderim yazma izinleri).

Adım 2: API Bağlantısını Kurun

5. Yurtiçi Kargo uygulaması ayarlar ekranında 'API Ayarları' bölümüne gidin.
6. Müşteri numaranızı (kurumsal portal üzerinden alınan) ilgili alana girin.
7. API şifrenizi girin. Şifreyi kopyala-yapıştır ile değil, manuel olarak yazmanızı öneririz (gizli boşluk karakteri sorununu önler).
8. Şube kodunuzu girin (bazı bölgeler için zorunludur; temsilcinizden alın).
9. 'Bağlantıyı Doğrula' butonuna tıklayın. Başarılı bağlantıda yeşil onay görünür.

⚠️ DİKKAT: API bağlantısı başarısız oluyorsa müşteri numarasının büyük/küçük harf duyarlılığını kontrol edin. Yurtiçi Kargo API'si bazı durumlarda büyük harfli CustomerCode beklerken küçük harfli giriş hata üretir.

Adım 3: Kargo Bölgelerini Yapılandırın

1. Settings → Shipping and delivery → Manage'e gidin.
2. 'Turkey' bölgesi altında 'Add rate' butonuna tıklayın.
3. Yurtiçi Kargo'yu taşıyıcı olarak seçin.
4. Fiyatlandırma modelini belirleyin (bkz. aşağıdaki tablo).
5. Ücretsiz kargo eşiği eklemek istiyorsanız 'Add condition' → 'Order price' → minimum tutar belirleyin.

Adım 4: Test ve Canlıya Alma

1. Shopify admin → Orders → Create order ile test siparişi oluşturun.
2. Gerçek bir Türkiye adresi kullanın (sandbox adresleri etiket üretemeyebilir).
3. Fulfillment ekranında 'Create shipping label' butonunu tıklayın.
4. Etiket PDF olarak açılıyorsa ve Yurtiçi takip sisteminde numara çalışıyorsa entegrasyon başarılıdır.
5. Müşteri bildirim e-postasının takip numarasını içerip içermediğini doğrulayın.

Kargo Fiyatlandırması ve Optimizasyon

Yurtiçi Kargo ile Shopify'da fiyatlandırma yapılandırması doğru kurulduğunda hem kargo maliyetlerinizi kontrol altına alır hem de müşteri sepet tutarını artırırsınız. Türkiye'deki mağazaların yaklaşık %68'i 'belirli tutar üzeri ücretsiz kargo' modelini kullanmaktadır.

Ücretsiz kargo eşiğini belirlerken ortalama sepet tutarınızı baz alın ve eşiği %15–20 üzerine koyun. Örneğin ortalama sepet tutarınız 350 TL ise eşiği 400–420 TL olarak ayarlayın. Bu strateji, müşterilerin sepeti doldurmak için ek ürün eklemesini teşvik eder.

Ağır veya hacimli ürün satan mağazalar için desi (hacimsel ağırlık) hesabını göz önünde bulundurun. Yurtiçi Kargo, 1 desi = 1 kg eşdeğeri hesaplıyor; ancak gerçek ağırlıktan büyük olan hacimsel ağırlık faturalanır. Shopify'da bu durumu karşılamak için ürün ağırlığını gerçek ağırlık yerine hacimsel ağırlıkla güncelleyebilirsiniz.

Yaygın Hatalar ve Çözümleri

Yurtiçi Kargo Shopify entegrasyonunda en sık karşılaşılan sorunlar API bağlantı hataları, etiket üretim başarısızlıkları ve yanlış teslimat süresi gösterimidir. Bu hataların büyük çoğunluğu yapılandırma kaynaklıdır ve teknik bilgi gerektirmeden çözülebilir.

Hata: 'Invalid credentials'

Çözüm: Müşteri numaranızı ve API şifrenizi Yurtiçi kurumsal portalından yeniden kopyalayın. Özellikle şifre alanında Türkçe karakter içeriyorsa (ş, ğ, ü, ç, ö, ı) bu karakterlerin doğru kodlandığından emin olun.

Hata: Etiket PDF oluşturmuyor

Çözüm: Sipariş adresindeki il ve ilçe bilgisinin Yurtiçi'nin sistemindeki karşılığıyla eşleşip eşleşmediğini kontrol edin. Özellikle küçük yerleşim yerlerinde Shopify'ın adres formatı ile Yurtiçi'nin bölge kodu sistemi uyuşmayabilir. Bu durumda 'Varsayılan şube kodu' alanını kullanarak manuel eşleme yapabilirsiniz.

Hata: Takip numarası 24 saat geçmesine rağmen çalışmıyor

Çözüm: Yurtiçi kargo etiketi oluşturulduktan sonra fiziksel paket Yurtiçi şubesine teslim edilmeden takip sistemi güncellenmez. Paketi teslim ettikten sonra 2–4 saat içinde takip numarası aktif hale gelir.

Sık Sorulan Sorular

Yurtiçi Kargo Shopify'a nasıl entegre edilir?

Shopify App Store'dan resmi Yurtiçi Kargo uygulamasını yükleyin, ardından Yurtiçi kurumsal müşteri numaranızı ve API şifrenizi uygulama ayarlarına girin. Önce Yurtiçi Kargo ile kurumsal sözleşme imzalanmış ve API erişimi sağlanmış olmalıdır. Süreç 2–4 saat içinde tamamlanabilir.

Yurtiçi Kargo Shopify uygulaması ücretli mi?

Resmi Yurtiçi Kargo Shopify uygulaması ücretsizdir. Gönderim başına ödediğiniz kargo bedeli ise Yurtiçi ile imzaladığınız kurumsal sözleşme tarifesine göre belirlenir. Shopify'ın kendi planı için ise Shopify Basic, Shopify veya Advanced arasından birini seçmeniz gerekir.

Yurtiçi Kargo ile aynı gün teslimat yapabilir miyim?

Yurtiçi Kargo, İstanbul içi bazı bölgelerde 'Hızlı' ve 'Aynı Gün' teslimat seçenekleri sunmaktadır. Bu hizmetler için API'de ServiceType parametresi uygun şekilde ayarlanmalıdır; mevcut sözleşmenizde bu hizmetin tanımlı olması gerekmektedir. Tüm Türkiye için geçerli değildir.

Yurtiçi Kargo'yu başka bir kargo firmasıyla birlikte kullanabilir miyim?

Evet. Shopify, birden fazla kargo firmasını aynı anda aktif tutmanıza izin verir. Farklı teslimat bölgelerine farklı firmalar atayabilirsiniz; örneğin İstanbul ve Ankara için Yurtiçi, diğer iller için Aras Kargo. Bu yapılandırma Shipping zones bölümünden yönetilir.

‍

Yurtiçi Kargo Shopify entegrasyonu, düzgün kurulduğunda mağazanızın kargo operasyonlarını %85 oranında otomatikleştirir. Resmi uygulama küçük ve orta ölçekli mağazalar için güçlü ve ücretsiz bir çözüm sunarken, büyük mağazalar için özel API entegrasyonu daha fazla esneklik sağlar.

Yeni Shopify mağazanızı sıfırdan kurarken Size rehber olacak blog sayfamızı inceleyebilirsiniz.

Nodus Works olarak Yurtiçi Kargo ve diğer kargo firmalarının Shopify entegrasyonlarını teknik ve operasyonel olarak tam kapsamlı kuruyoruz.

İlginizi çekebilecek içerikler;

Shopify Kargo entegrasyonu - https://nodusworks.com/blog/shopify-kargo-entegrasyonu

Shopify Aras kargo entegrasyonu - https://nodusworks.com/blog/aras-kargo-shopify-entegrasyonu-nasil-yapilir

Mng kargo entegrasyonu - https://nodusworks.com/blog/mng-kargo-shopify-entegrasyonu-kurulum-ve-yapilandirma-rehberi

Ücretsiz Danışmanlık Görüşmesi Talep Edin

‍