Shopify nedir?
Shopify, dünya genelinde yaygın kullanılan bulut tabanlı (SaaS) bir e-ticaret altyapısıdır. Hosting, güvenlik ve checkout’u Shopify yönetir; siz tema ve app ekosistemiyle mağazanızı kurarsınız. Türkiye’de özellikle DTC (direct-to-consumer) markalarda tercih edilir. Ancak global bir SaaS olduğu için Türkiye’ye özel operasyonel ihtiyaçlar — yerli kargo, sanal POS, e-fatura — hazır gelmez, kurulum gerektirir.
Aras Kargo nedir?
Aras Kargo, Türkiye’nin en yaygın kargo ağlarından biridir. Gönderi oluşturma, takip numarası alma, etiket basma ve durum sorgulama işlemleri SOAP web servisi veya REST API üzerinden yapılır. API erişimi anlaşmalı şubeden alınan müşteri kodu, kullanıcı adı, şifre ve entegrasyon koduyla açılır. Bu kimlik bilgileri ve şube koordinasyonu, entegrasyonun en sık takılan kısmıdır.
Neden Shopify ve Aras Kargo entegre edilmeli?
Shopify’ın varsayılan kargo modülü uluslararası taşıyıcılara göre tasarlanmıştır; Aras Kargo gibi yerli bir ağ varsayılan olarak listede yoktur. Manuel akışta her sipariş için Aras paneline tek tek girip gönderi açmak, takip numarasını kopyalayıp Shopify’a yapıştırmak büyük zaman kaybıdır. Doğru kurulmuş bir köprü şunları sağlar:
- Otomatik gönderi kaydı: Sipariş onaylandığında Aras’ta gönderi kaydı kendiliğinden açılır, Aras paneline girmeye gerek kalmaz.
- Takip numarasının geri yazılması: Aras’tan dönen takip numarası Shopify Fulfillment API ile siparişe işlenir, sipariş “fulfilled” olur, müşteriye bildirim gider.
- Doğru şubeye yönlendirme: Shopify adresindeki il-ilçe-mahalle bilgisi Aras formatına eşlenir, gönderi yanlış şubeye düşmez.
- Toplu işlem: Günün bekleyen siparişleri tek seferde gönderiye dönüştürülür, etiketler PDF ya da termal yazıcıya toplu basılır.
- Tek doğruluk kaynağı: Kargo durumu Shopify sipariş ekranından izlenir, “kargom nerede?” sorularıyla uğraşma süresi azalır.
Sipariş hacmi arttıkça manuel kargo girişi tam zamanlı bir iş yüküne dönüşür; köprü kurulduğunda bu yük kendiliğinden yürür.
Shopify Aras Kargo entegrasyonu nasıl yapılır?
Burada dürüst olmak gerekiyor: Aras Kargo’nun kendi yayınladığı resmi bir Shopify App Store uygulaması yok. İki gerçek yol var — Türk geliştiricilerin App Store’da sunduğu üçüncü taraf app’ler veya mağazanıza özel custom middleware (köprü). App yeterliyse onu kurarız; app’in kapsamadığı il-ilçe eşleme, özel iş kuralı veya muhasebe bağlantısı varsa köprü yazarız. Zeisoft olarak süreci şöyle yürütüyoruz:
- Mevcut tema, sipariş hacmi ve checkout yapınızı inceliyor, app mi köprü mü gerektiğine birlikte karar veriyoruz.
- Aras şubenizden API bilgilerinin ve entegrasyon kodunun teminini koordine ediyoruz; entegrasyon kodunun şube sistemine tanımlandığını test aşamasında doğruluyoruz.
- Shopify’ın
orders/createveyaorders/paidwebhook’unu dinleyen tetikleme noktasını kuruyoruz; tetikleme statüsünü siz belirliyorsunuz. - İl-ilçe-mahalle eşleme tablosunu ve desi/ağırlık kuralını tanımlıyor, takip numarasının Fulfillment API ile geri yazılmasını sağlıyoruz.
- Test ortamında 5-10 gerçek sipariş üzerinde gönderi açılışını, etiket çıktısını ve şube doğrulamasını kontrol ediyoruz.
- Canlı geçişten sonra ilk hafta günlük izleme yapıyor, bakım anlaşmasıyla Aras ve Shopify tarafındaki değişiklikleri takip etmeyi üstleniyoruz.
Sıkça karşılaşılan sorunlar
Shopify-Aras kurulumlarında sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Adres yanlış şubeye düşüyor. Shopify adres formu mahalle bilgisini çoğu zaman tek satıra gömüyor, il-ilçe Aras formatıyla birebir eşleşmiyor. Çözüm: köprü tarafında il-ilçe eşleme tablosu ve mahalle ayrıştırma kuralı kurmak.
- Entegrasyon kodu tanımlı değil. Şube barkod/entegrasyon kodunu sisteme girmediğinde “entegrasyon numarası sistemde tanımlı değil” hatası alınır, gönderi hiç açılmaz. Çözüm: test aşamasında şubeyle doğrudan koordinasyon ve kod doğrulaması.
- Takip numarası Shopify’a yazılmıyor. Webhook ile Fulfillment API arasındaki köprü kurulmadığında Aras’ta gönderi açılsa bile Shopify siparişi “unfulfilled” kalır, müşteriye bildirim gitmez. Çözüm: Fulfillment API geri yazımını tetikleme akışına bağlamak.
- Checkout’ta kargo görünmüyor. Shopify checkout özelleştirmesi (özellikle Plus olmadan) sınırlı; carrier-calculated rate kapalıysa Aras seçeneği checkout’ta çıkmaz. Çözüm: kargo seçeneğini tema/ayar seviyesinde değil, sipariş sonrası fulfillment akışında ele almak.
Dördü de kurulumda doğru tasarımla önlenir; canlıdayken düzeltmek kat kat iş yükü yaratır.