Shopify nedir?
Shopify, kurulum ve sunucu bakımı derdi olmadan mağaza açmak isteyen markaların tercih ettiği bulut tabanlı (SaaS) bir e-ticaret altyapısıdır. Türkiye’de özellikle DTC (direct-to-consumer) markalarda yaygın; hızlı başlangıç, modern checkout ve geniş uygulama ekosistemi öne çıkan avantajları. Global bir platform olduğu için Türkiye’ye özel mevzuat ihtiyaçları (e-fatura, sanal POS, TC/VKN) hazır gelmez, kurulum gerektirir. En önemlisi: Shopify bulutta çalışır, yani dış sistemlere internet üzerinden Admin API ile bağlanır.
Logo nedir?
Logo, Türkiye’nin en köklü ve yaygın kullanılan iş yazılımlarından biridir. Logo Tiger ve Logo Go; muhasebe, stok yönetimi, cari hesap takibi, e-fatura ve e-arşiv fatura işlemlerini tek çatı altında toplar. Logo’nun en belirleyici özelliği on-premise (yerinde kurulum) mimarisidir: yazılım bulutta değil, sizin sunucunuzda veya yerel ağınızdaki bir bilgisayarda çalışır. Bu yapı veri sahipliği ve kontrol açısından avantaj sağlar; ancak bulutta çalışan Shopify ile doğrudan konuşamaz, aralarına bir köprü gerekir.
Neden Shopify ve Logo entegre edilmeli?
Shopify’ın kendi fatura modülü Türkiye GİB e-fatura/e-arşiv formatına uymaz. Halihazırda Logo kullanan bir işletme için her Shopify siparişini elle Logo’ya girip fatura kesmek, sipariş hacmi arttıkça muhasebe ekibinin tam zamanlı işine dönüşür. Doğru kurulmuş bir köprü şunları sağlar:
- Otomatik fatura kesimi: Shopify’da sipariş ilgili statüye geçtiğinde Logo’da doğru fatura türünde otomatik fatura kesilir.
- Tek muhasebe merkezi: Logo’yu zaten muhasebenizin merkezi olarak kullanıyorsanız, Shopify satışları da aynı deftere akar; ayrı bir bulut yazılıma dağılmaz.
- Tutarlı cari hesap kayıtları: Aynı müşteri için Logo’da mükerrer cari açılmaz, TC/VKN birincil eşleşme alanı olur.
- Stok senkronizasyonu (opsiyonel): Logo Tiger kullanıyorsanız satış sonrası stok kartlarınız otomatik düşebilir, çoklu depo yapısı köprüye dahil edilebilir.
- GİB uyumu: Fatura kesimi Logo’nun e-fatura modülü üzerinden GİB’e iletilir, manuel beyan derdi azalır.
Manuel akışta saatler süren Shopify fatura girişi, doğru kurulmuş köprüyle kendiliğinden yürür.
Shopify Logo entegrasyonu nasıl yapılır?
Önce dürüst olalım: Shopify ile Logo arasında tek tıkla kurulan resmi bir entegrasyon yok. İki temel zorluk var. Birincisi, Shopify App Store’da Logo’nun yayınladığı resmi bir uygulama bulunmuyor. İkincisi ve daha önemlisi, Logo bulutta değil sizin sunucunuzda çalışıyor — Shopify’ın internet üzerinden ulaşabileceği bir adresi yok. Bu yüzden bağlantı, bulut araçlarına göre farklı bir kurulum gerektirir. Zeisoft olarak süreci uçtan uca yürütüyoruz:
- Logo kurulumunuzu inceliyoruz: Tiger mı Go mu, hangi sürüm, hangi modüller aktif, sunucu nerede duruyor — bunları belirliyoruz.
- Erişim yolunu kuruyoruz: Bulut Shopify ile sunucudaki Logo’yu bağlamak için güvenli bir erişim yolu (VPN, sabit IP veya güvenli tünel) ve Logo Connect ya da custom köprü katmanını birlikte planlıyoruz.
- Shopify tarafını yapılandırıyoruz: Admin API erişimini ve
orders/paidveyaorders/fulfilledgibi güvenilir bir webhook’u kuruyoruz — ödeme iyzico/PayTR üzerinden alındığı için tetikleyiciyi buna göre seçiyoruz. - Logo tarafını kurguluyoruz: Köprünün siparişi Logo’nun beklediği formata dönüştürüp veritabanına yazmasını, cari eşleşme ve KDV kurallarını tanımlıyoruz.
- Bireysel/kurumsal ayrımını çözüyoruz: Checkout uzantısı, cart attribute veya sipariş sonrası akışla TC/VKN topluyor, Logo’da doğru cari tipine bağlıyoruz.
- Test edip canlıya alıyoruz: Gerçek 5-10 sipariş üzerinde — bireysel, kurumsal, iade — fatura kesimini doğruluyor, ilk hafta günlük kontrol yapıyoruz.
- Bakım veriyoruz: Logo sürüm güncellemelerini ve Shopify Admin API sürüm geçişlerini bakım anlaşmasıyla takip etmek bizde kalır.
Lisanslar (Shopify, Logo, varsa Logo Connect) sizin tarafınızda; biz köprü kurulumu, bakım ve desteği üstleniyoruz.
Sıkça karşılaşılan sorunlar
Shopify-Logo köprüsünde sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- Sunucuya erişim yolunun planlanmaması. Logo on-premise olduğu için bulut köprünün sunucunuza ulaşabilmesi gerekir; bu yol (VPN, sabit IP, tünel) baştan kurulmazsa entegrasyon yarıda kalır. Çözüm: erişim ve güvenlik gereksinimlerini keşif aşamasında netleştirip kurmak.
- Logo sürüm güncellemesinin köprüyü sessizce durdurması. Logo’nun büyük güncellemeleri veritabanı yapısını değiştirip köprüyü bir gün çalışmaz hale getirebilir. Çözüm: bakım anlaşması kapsamında her güncelleme sonrası köprüyü test edip uyarlamak.
- TC/VKN bilgisinin checkout’ta toplanamaması. Standart Shopify checkout’ta serbest alan eklemek sınırlıdır; bilgi toplanmazsa Logo’da cari eksik açılıyor. Çözüm: cart attribute, checkout uzantısı (Plus) veya sipariş sonrası adımla TC/VKN’yi yapılandırılmış şekilde toplamak, bilgi yoksa varsayılanı e-arşiv kurmak.
- Yanlış tetikleyici yüzünden erken fatura. Tetikleyici sipariş oluşur oluşmaz çalışınca, ödemesi tamamlanmamış veya iptal olacak siparişe fatura kesiliyor. Çözüm: iyzico/PayTR ödeme onayına ya da
fulfilledaşamasına bağlı güvenilir tetikleyici.
Dördü de köprü doğru tasarlandığında önlenebilir; sonradan düzeltmek katbekat iş yükü yaratır.