Shopify Yurtiçi Kargo Entegrasyonu Nedir?
Shopify Yurtiçi Kargo entegrasyonu, Yurtiçi Kargo’nun API altyapısını Shopify mağazanıza bağlayarak sipariş oluşturma anında kargo etiketi üretmeyi, takip numarasını müşteriye otomatik iletmeyi ve teslimat durumunu Shopify Admin’de anlık izlemeyi mümkün kılan teknik yapılandırmadır.
Yurtiçi Kargo, Türkiye’de 1.200’ü aşkın şubesi ve günlük 1 milyonun üzerinde gönderi kapasitesiyle e-ticaret segmentinin en yaygın lojistik altyapılarından birini oluşturur. Shopify mağazalarının yaklaşık %40’ı birincil kargo firması olarak Yurtiçi Kargo’yu kullanmaktadır; bu oran özellikle büyük şehir dışına yoğun gönderim yapan tekstil ve elektronik kategorilerinde daha yüksektir.
Shopify ile Yurtiçi Kargo Entegrasyonunun İki Yolu
Shopify ve Yurtiçi Kargo arasında entegrasyon kurmanın iki temel yöntemi vardır: Yurtiçi Kargo’nun resmi API’si üzerinden doğrudan bağlantı veya üçüncü taraf Shopify uygulamaları. Yöntem seçimi günlük sipariş hacminize ve teknik altyapı tercihinize göre belirlenir.
| Özellik | Doğrudan API Entegrasyonu | Shopify Uygulaması ile Entegrasyon |
|---|---|---|
| Kurulum karmaşıklığı | Yüksek (geliştirici gerektirir) | Düşük (5-15 dakika) |
| Aylık maliyet | Geliştirici ücreti (tek seferlik) | $15-40/ay (uygulama aboneliği) |
| Otomatik etiket basımı | Tam otomatik | Yarı veya tam otomatik |
| Kargo takibi | Gerçek zamanlı webhook | Periyodik sorgulama (10-30 dk gecikme) |
| Çoklu kargo firması desteği | Hayır (tek firma) | Evet (Aras, MNG, PTT vb.) |
| Günlük sipariş eşiği | 50+ sipariş için avantajlı | 1-50 sipariş için uygun |
Günde 20’den az sipariş gönderen mağazalar için uygulama tabanlı entegrasyon yeterlidir ve kurulum süresini günlerden saatlere indirir. Günde 50 ve üzeri siparişte doğrudan API entegrasyonu operasyonel verimliliği artırır.
Yurtiçi Kargo API Hesabı Açma
Entegrasyonu kurabilmek için önce Yurtiçi Kargo’nun kurumsal müşteri portalına kayıt yaptırmanız ve API erişim bilgilerini almanız gerekir.
Yurtiçi Kargo API başvurusu için:
- Yurtiçi Kargo kurumsal web sitesinden “E-Ticaret Çözümleri” bölümüne girin.
- Müşteri numaranızı ve sözleşmeli fiyatlamanızı belirleyebilmek için bir satış temsilcisiyle iletişime geçin.
- Sözleşme imzalandıktan sonra Yurtiçi Kargo size bir müşteri numarası (customer number), kullanıcı adı ve şifre içeren API erişim bilgileri iletir.
- Yurtiçi Kargo’nun geliştirici portalında test ortamını aktifleştirin.
Kritik Not: Yurtiçi Kargo API erişimi, bireysel müşteri değil kurumsal müşteri sözleşmesi gerektirir. Henüz sözleşmeniz yoksa, günlük 10-15 gönderimde bile anlaşmalı fiyat, kapıdan teslim standart tarifesinin %15-25 altında kalır. Başvuruyu geciktirmenin pratik bir maliyeti vardır.
Shopify Uygulamasıyla Yurtiçi Kargo Kurulumu
Yurtiçi Kargo entegrasyonunu destekleyen Shopify uygulamalarının en yaygın kullanılanları:
- Kargoist — Yurtiçi, Aras, MNG ve PTT desteği. Otomatik etiket basımı, toplu kargo oluşturma. Aylık $19.
- Shipmoose — Yurtiçi Kargo dahil 5 kargo firması. Kural tabanlı kargo seçimi (en ucuz/en hızlı). Aylık $25.
- ShipEntegra — Türkiye odaklı kargo entegrasyon platformu. Yurtiçi dahil 8 kargo firması. Aylık $15.
Kurulum adımları (Kargoist örneği üzerinden):
Adım 1: Uygulamayı Yükleyin
Shopify App Store’dan uygulamayı kurun. Yükleme sonrasında uygulama, Shopify Admin’de “Apps” menüsünde görünür.
Adım 2: Yurtiçi Kargo Hesabınızı Bağlayın
Uygulama ayarlarında “Yurtiçi Kargo” seçeneğine tıklayın. Müşteri numaranızı, kullanıcı adınızı ve şifrenizi girin. Bağlantı testi yapın.
Adım 3: Varsayılan Kargo Kurallarını Belirleyin
Hangi siparişlerin otomatik olarak Yurtiçi’ye yönlendirileceğini tanımlayın:
– Belirli bir tutarın üzerindeki siparişler
– Belirli iller veya bölgeler
– Belirli ürün ağırlık aralıkları
Adım 4: Etiket Formatını Ayarlayın
Yurtiçi Kargo, barkodlu etiket için A6 (10×15 cm) format kullanır. Yazıcınızın bu formata uyumlu olduğunu doğrulayın. Termal etiket yazıcı (Zebra, Honeywell) kullanıyorsanız ZPL format seçeneğini aktifleştirin.
Adım 5: Test Gönderimi Yapın
Gerçek bir test siparişi oluşturun, kargo etiketi üretin ve barkodu Yurtiçi Kargo şubesinde okuttuktan sonra takip numarasının doğru kaydedildiğini doğrulayın.
Yurtiçi Kargo API ile Doğrudan Entegrasyon
API entegrasyonunda üç temel işlem akışı vardır: gönderi oluşturma, barkod sorgusu ve kargo durum takibi.
Gönderi Oluşturma (CreateShipment)
Yurtiçi Kargo SOAP tabanlı bir web servis mimarisi kullanır. Temel istek yapısı:
<CreateShipmentRequest>
<UserName>API_KULLANICI_ADI</UserName>
<Password>API_SIFRE</Password>
<CustomerNumber>MUSTERI_NO</CustomerNumber>
<ShipmentInfo>
<ReceiverName>Müşteri Adı Soyadı</ReceiverName>
<ReceiverAddress>Teslimat Adresi</ReceiverAddress>
<ReceiverCityCode>34</ReceiverCityCode>
<ReceiverPhone>05XX XXX XXXX</ReceiverPhone>
<Desi>1</Desi>
<PayerTypeCode>1</PayerTypeCode>
</ShipmentInfo>
</CreateShipmentRequest>
PayerTypeCode: 1 = Gönderici öder, 2 = Alıcı öder (kapıda ödeme için).
Barkod ve Takip Numarası
Başarılı CreateShipment yanıtı size bir CargoKey (takip numarası) döner. Bu numarayı Shopify siparişinin tracking_number alanına yazın; Shopify otomatik olarak müşteriye takip linki içeren e-posta gönderir.
Kargo Durum Sorgulama
QueryShipment endpoint’i takip numarasına göre anlık kargo durumu döner. Shopify’da sipariş durumunu güncel tutmak için bu sorguyu sipariş teslim edilene kadar her 2 saatte bir çalıştıran bir cron job kurabilirsiniz.
Yurtiçi Kargo ile Türkiye’ye Özel Yapılandırmalar
Kapıda Ödeme (COD) Entegrasyonu
Yurtiçi Kargo, kapıda nakit tahsilat hizmeti sunar. Shopify’da kapıda ödeme seçeneği açıkken Yurtiçi entegrasyonunuzu şu şekilde yapılandırın:
PayerTypeCode = 2ile gönderim oluşturun.CodAmountalanına tahsil edilecek tutarı yazın.- Tahsilat sonrası para yatırma süresini (genellikle T+2) nakit akışı planlamanıza dahil edin.
Desi Hesaplama ve Fiyatlama
Yurtiçi Kargo fiyatlandırması, fiziksel ağırlık veya hacimsel ağırlık (desi) arasında büyük olanı baz alır. Hacimsel ağırlık hesabı: En (cm) x Boy (cm) x Yükseklik (cm) / 3.000. Shopify’da her ürüne doğru ağırlık ve boyut bilgisi girmeniz, kargo maliyetlerinin otomatik hesaplanması için şarttır.
| Desi Aralığı | Açıklama | Tipik Ürün Kategorisi | Tahmini Maliyet Etkisi |
|---|---|---|---|
| 1 desi | 0-1 kg / 0-3.000 cm³ | Takı, aksesuar, kozmetik | En düşük tarife |
| 2-5 desi | 1-5 kg / 3.000-15.000 cm³ | Giyim, kitap, küçük elektronik | Standart tarife |
| 6-10 desi | 5-10 kg / 15.000-30.000 cm³ | Ayakkabı, ev tekstili | +%30-50 standart üzeri |
| 10+ desi | 10 kg üzeri veya büyük hacim | Mobilya, beyaz eşya parçaları | Özel tarife gerektirir |
İl Bazlı Kargo Süresi
Yurtiçi Kargo, büyükşehirler arası gönderimde genellikle 1 iş günü, ilçe bazında 2-3 iş günü teslim süresi sunar. Shopify’da teslimat süresi göstermek için “Estimated Delivery Date” veya “Order Delivery Date” uygulamalarını kullanabilirsiniz. Müşteriye doğru beklenti vermek, ilk teslimat denemesinde teslim oranını artırır ve iade maliyetini azaltır.
Sahadan 3 Kritik Gözlem
Gözlem 1: Yurtiçi Kargo API entegrasyonunda adres formatı, etiket hatasının yüzde altmışından sorumlu
Yurtiçi Kargo’nun adres alanı maksimum 80 karakter kabul eder. Shopify adres formlarından gelen uzun adresler (özellikle mahalle + cadde + sokak + numara birleşimi) bu limiti aşınca kargo etiketi hata verir veya adresin bir kısmı kesilir. Çözüm: adres alanına girilecek maksimum karakter sayısını Shopify tema düzenlemesiyle 75 karaktere kısıtlamak ve müşterileri “apartman no’yu ayrı alana yazın” şeklinde yönlendirmek.
Gözlem 2: Anlaşmalı fiyat almak için Yurtiçi Kargo’nun aylık minimum gönderim şartını karşılamak zorunlu değil; başvuru yapmak yeterli
Yaygın kanının aksine, Yurtiçi Kargo kurumsal sözleşme için belirlenmiş bir minimum aylık gönderim hacmi şartı uygulamaz. Vergi numarası olan her işletme başvurabilir. Başvuru yapmadan standart tarife üzerinden gönderim yapan mağazalar gereksiz maliyet taşır. Günde 5 gönderi bile olsa kurumsal sözleşme açın; ilk aydan itibaren gönderim başı maliyet düşer.
Gözlem 3: Yurtiçi Kargo takip webhook’ları test ortamında çalışır; production’da sessizce başarısız olur
Yurtiçi Kargo’nun API test ortamı, webhook bildirimlerini simüle eder. Production’a geçildiğinde bazı webhook endpoint’lerinin çalışmadığı ve Shopify’daki sipariş durumunun güncellenmeyi bıraktığı görülmüştür. Production ortamına geçiş sonrasında canlı bir gönderi oluşturun, gönderimi şubeye teslim edin ve 2 saat bekleyerek Shopify’da takip durumunun güncellenip güncellenmediğini manuel kontrol edin.
SSS
Yurtiçi Kargo Shopify ile doğrudan entegre mi?
Yurtiçi Kargo’nun Shopify App Store’da resmi bir uygulaması yoktur. Entegrasyon Kargoist, Shipmoose veya ShipEntegra gibi üçüncü taraf uygulamalar ya da doğrudan Yurtiçi API bağlantısıyla kurulur.
Shopify’da birden fazla kargo firması kullanılabilir mi?
Evet. Kargoist veya Shipmoose gibi çoklu kargo uygulamaları, sipariş ağırlığı veya teslimat iline göre otomatik kargo firması seçimi yapar. Yurtiçi ve Aras’ı aynı anda aktif tutabilirsiniz.
Yurtiçi Kargo API anahtarı nasıl alınır?
API erişimi için Yurtiçi Kargo kurumsal satış departmanıyla iletişime geçin. Sözleşme imzalandıktan sonra müşteri numarası ve API kimlik bilgileri e-posta ile iletilir.
Shopify’da kargo ücreti otomatik hesaplanabilir mi?
Evet. Yurtiçi Kargo entegrasyonu aktifken ürün ağırlıkları doğru girilmişse checkout’ta müşterinin iline ve sipariş ağırlığına göre otomatik kargo ücreti hesaplanabilir. Bu özellik Shopify’ın “Carrier Calculated Shipping” fonksiyonu üzerinden çalışır ve Shopify Basic plan dahil tüm planlarda mevcuttur.
Kargo etiketi otomatik basılabilir mi?
Entegrasyon uygulamasına bağlı olarak sipariş onaylandığında etiket otomatik oluşturulabilir. Günde 30 ve üzeri gönderi yapan mağazalarda termal etiket yazıcı ile toplu etiket basımı operasyonel süreyi sipariş başına 2-3 dakikadan 20 saniyeye indirir.
Sonuç
Shopify mağazanıza Yurtiçi Kargo entegrasyonu kurmak için en hızlı yol Kargoist veya ShipEntegra gibi üçüncü taraf uygulamalardır; kurulum 15 dakika içinde tamamlanır ve günde 50 gönderiye kadar sorunsuz çalışır.
Hacminiz günde 50 gönderimi geçiyorsa veya kapıda ödeme otomasyonuna ihtiyaç duyuyorsanız doğrudan API entegrasyonu uzun vadede hem maliyet hem hız avantajı getirir.
İlk adım olarak Yurtiçi Kargo kurumsal başvuruyu tamamlayın; henüz anlaşmanız yoksa bu aydan itibaren her gönderi için standart tarife yerine indirimli kurumsal tarife ödemeye başlarsınız.