Shopify nedir?
Shopify, kurulum ve 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.
Paraşüt nedir?
Paraşüt, Türkiye’deki KOBİ’lerin tercih ettiği bulut tabanlı ön muhasebe ve e-fatura yazılımıdır. e-fatura ve e-arşiv mükellefiyetiniz için GİB ile bağlantıyı sağlar; cari hesap, gelir-gider takibi, banka entegrasyonları ve raporlama tek panelde toplanır. Paraşüt’ün açık bir API’si vardır ve dış sistemlerden fatura oluşturmaya izin verir — Shopify köprüsünün bağlandığı nokta da budur.
Neden Shopify ve Paraşüt entegre edilmeli?
Shopify’ın kendi fatura modülü Türkiye GİB e-fatura/e-arşiv formatına uymaz; her siparişi elle Paraşüt’e girmek hacim arttıkça sürdürülemez. Doğru kurulmuş bir köprü şunları sağlar:
- Otomatik fatura kesimi: Shopify’da sipariş ilgili statüye geçtiğinde Paraşüt’te e-fatura veya e-arşiv otomatik oluşur.
- Sanal POS akışına uyum: Shopify Payments Türkiye’de aktif olmadığı için ödeme iyzico/PayTR üzerinden alınır; tetikleyici buna göre kurulur, “ödendi” sinyali doğru noktadan okunur.
- Tutarlı cari hesap kayıtları: Aynı müşteri için mükerrer cari açılmaz, TC/VKN birincil eşleşme alanı olur.
- Doğru KDV uygulaması: Ürün koleksiyonlarınız Paraşüt KDV oranlarıyla eşlenir, manuel düzeltme gerekmez.
- GİB uyumu: e-fatura/e-arşiv kesimi Paraşüt üzerinden GİB’e otomatik gönderilir.
Shopify Paraşüt entegrasyonu nasıl yapılır?
Shopify ile Paraşüt arasında resmi bir eklenti olmadığını baştan söyleyelim: bağlantı, Shopify Admin API ve sipariş webhook’ları ile Paraşüt API’sini birbirine bağlayan bir köprü gerektirir. Bunu custom geliştirme veya araya bir orchestration katmanı koyarak çözüyoruz. Zeisoft olarak süreci uçtan uca yürütüyoruz:
- Mevcut mağazanızı, ödeme sağlayıcınızı (iyzico/PayTR) ve sipariş hacminizi inceliyoruz.
- Shopify tarafında Admin API erişimini ve
orders/paidveyaorders/fulfilledgibi uygun webhook’ları yapılandırıyoruz. - Paraşüt API erişimini açıyor, fatura oluşturma ve cari eşleşme kurallarını kuruyoruz.
- Bireysel/kurumsal ayrımını checkout uzantısı, cart attribute veya sipariş sonrası akışla topladığımız TC/VKN bilgisine bağlıyoruz.
- Koleksiyon-KDV eşleme tablosunu ve iade/iptal akışını birlikte tanımlıyoruz.
- Test ortamında 5-10 sipariş üzerinde fatura kesimini doğruluyor, canlı geçişten sonra ilk hafta günlük kontrol yapıyoruz.
- Bakım anlaşması ile Shopify API sürüm geçişlerini ve Paraşüt güncellemelerini sizin yerinize takip ediyoruz.
Sıkça karşılaşılan sorunlar
Shopify-Paraşüt köprüsünde sahada en sık gördüğümüz dört sorun ve nasıl önlediğimiz:
- TC/VKN bilgisinin checkout’ta toplanamaması. Standart Shopify checkout’ta WooCommerce gibi serbest alan eklemek mümkün değil; bilgi toplanmazsa Paraşüt’te cari eksik açılıyor. Çözüm: cart attribute, checkout uzantısı (Plus) veya sipariş sonrası bir adımla TC/VKN’yi yapılandırılmış şekilde toplamak.
- Yanlış tetikleyici yüzünden erken fatura. Tetikleyici sipariş oluşur oluşmaz çalışacak şekilde kurulduğunda, ödemesi tamamlanmamış veya iptal olacak siparişler için fatura kesiliyor. Çözüm: iyzico/PayTR ödeme onayına ya da
fulfilledaşamasına bağlanan güvenilir tetikleyici. - API sürümü emekliye ayrılınca köprünün durması. Shopify Admin API sürümleri dönemsel olarak emekliye ayrılır; takip edilmezse köprü bir gün sessizce çalışmayı bırakır. Çözüm: bakım anlaşması kapsamında sürüm geçişlerini önceden uygulamak.
- Çoklu para birimi ve kur karışıklığı. Shopify Markets ile döviz cinsinden satışta, faturaya yansıyan tutar kur kuralı tanımlanmazsa yanlış oluşuyor. Çözüm: kurulumda TL üzerinden fatura tutarı ve kur dönüşüm kuralını netleştirmek.
Dördü de köprü doğru tasarlandığında önlenebilir; sonradan düzeltmek 3-5 kat iş yükü yaratır.