Shopify Parasüt Entegrasyonu Nasıl Yapılır? (E-Fatura Otomasyonu)

Shopify Parasüt Entegrasyonu Nedir? Shopify Parasüt entegrasyonu, Shopify mağazasında oluşan siparişlerin Parasüt’ün açık REST API’si üzerinden otomatik e-fatura veya e-arşiv faturaya dönüştürülmesi, stok ve KDV bilgisinin eş zamanlı senkronize edilmesi sürecidir.

Parasüt, bulut tabanlı bir muhasebe yazılımıdır ve özellikle e-ticaret işletmeleri için tasarlanmış açık bir API sunar. Bu API, Logo veya Netsis gibi kurumsal ERP’lerin aksine ek bir entegratör firma gerektirmeden doğrudan geliştirici erişimine açıktır (Parasüt Geliştirici Dokümantasyonu, 2025). Bu açıklık, Parasüt entegrasyonunu dört ERP seçeneği arasında genelde en hızlı kurulan seçenek yapar.

Parasüt’ün API’si OAuth2 kimlik doğrulama kullanır ve fatura, stok, cari hesap gibi modüllere ayrı ayrı erişim izni (scope) tanımlanmasına izin verir. Bu yapı, Shopify webhook’larının doğrudan Parasüt’e bağlanmasını nispeten basit bir geliştirme projesine indirger.

Parasüt API’si Nasıl Çalışır?

Parasüt API’si, OAuth2 protokolüyle kimlik doğrulaması yapan ve JSON formatında veri alışverişi sağlayan bir REST servisidir. Shopify tarafındaki bir sipariş webhook’u, bu API’ye HTTP isteği göndererek fatura, stok ve müşteri kaydı oluşturabilir.

API erişimi için önce Parasüt hesabında bir “uygulama” (application) tanımlanır ve bu uygulamaya client ID ile client secret atanır. Bu kimlik bilgileri, Shopify ile Parasüt arasındaki her isteğin doğrulanmasında kullanılır ve üçüncü bir tarafla paylaşılmamalıdır.

Parasüt dokümantasyonuna göre API, contacts (cari hesap), sales_invoices (satış faturası), products (ürün/stok) gibi ayrı kaynak uç noktaları (endpoint) sunar ve her biri bağımsız olarak sorgulanıp güncellenebilir (Parasüt Geliştirici Dokümantasyonu, 2025). Bu modülerlik, entegrasyon aracının yalnızca ihtiyaç duyulan modüllere erişim istemesine imkan tanır.

İpucu: API uygulaması tanımlarken yalnızca gerekli scope’lara (örneğin sadece sales_invoices ve products) izin verilmesi, güvenlik açısından erişimi sınırlı tutar. Gereğinden geniş yetki tanımlamak, entegrasyon aracının ihtiyaç duymadığı verilere de erişmesine yol açar.

Shopify Siparişinden Otomatik E-Fatura Nasıl Kesilir?

Otomatik e-fatura kesimi, Shopify’da sipariş ödemesi onaylandığı anda tetiklenen bir webhook’un Parasüt API’sine sipariş verisini (müşteri, ürün, tutar, KDV) göndermesi ve Parasüt’ün bu veriden bir satış faturası oluşturmasıyla işler. Müşteri e-fatura mükellefiyse fatura e-fatura, değilse e-arşiv olarak kesilir.

Bu ayrımın otomatik yapılabilmesi için entegrasyon aracının, fatura kesilecek müşterinin VKN veya TCKN bilgisiyle GİB e-fatura mükellef sorgusu yapması gerekir. Parasüt API’si bu sorguyu dahili olarak destekler; müşteri mükellefse otomatik e-fatura, değilse e-arşiv fatura düzenlenir.

Kritik Not: Müşteri VKN’si eksik veya hatalı girilmişse Parasüt mükellefiyet sorgusunu yapamaz ve varsayılan olarak e-arşiv fatura keser. Bu durum, e-fatura mükellefi bir müşteriye yanlışlıkla e-arşiv fatura kesilmesine ve muhasebe kaydında tutarsızlığa yol açabilir.

Peki bu otomasyon süreci hangi sırayla ilerliyor? Aşağıdaki numaralı liste, sipariş anından fatura oluşumuna kadar olan zinciri gösterir.

1. Shopify’da sipariş ödemesi onaylanır ve orders/paid webhook’u tetiklenir.
2. Entegrasyon aracı sipariş verisini (müşteri bilgisi, ürün kalemleri, KDV oranları) Parasüt API formatına dönüştürür.
3. Parasüt API’sine müşteri VKN/TCKN sorgusu gönderilir, mükellefiyet durumu belirlenir.
4. Mükellefiyet durumuna göre e-fatura veya e-arşiv fatura taslağı oluşturulur.
5. Fatura taslağı otomatik onaylanır (veya manuel onay adımına düşer, kurulum tercihine bağlı).
6. Fatura numarası ve PDF linki Shopify sipariş notuna veya müşteri e-postasına eklenir.

KDV ve Stok Senkronizasyonu Nasıl Yapılandırılır?

KDV senkronizasyonu, Shopify’daki ürün fiyatının KDV dahil mi hariç mi gösterildiğinin Parasüt’teki KDV oranı ayarıyla birebir eşleşmesini gerektirir; stok senkronizasyonu ise sipariş oluştuğunda Parasüt’teki ürün stok miktarının otomatik düşülmesiyle işler.

Shopify’da ürünler genelde KDV dahil fiyatlandırılır, Parasüt’te ise fatura kalemleri KDV hariç birim fiyat üzerinden hesaplanıp KDV ayrıca eklenir. Bu dönüşüm entegrasyon aracı tarafından otomatik yapılmazsa, faturadaki toplam tutar Shopify sipariş tutarından farklı çıkar.

Parasüt’te her ürün kartına bir KDV oranı (%1, %10 veya %20) atanır; Shopify tarafında bu oran ürün meta alanlarında tanımlı değilse entegrasyon aracı varsayılan bir oran kullanır. Farklı KDV oranına tabi ürünler satan mağazalar (örneğin gıda ve elektronik bir arada) için bu varsayılan oran hatalı fatura kesimine yol açabilir.

Uzak Durulması Gereken Risk: Farklı KDV oranına tabi ürünler tek bir varsayılan oranla senkronize edilirse, GİB denetiminde eksik veya fazla KDV beyanı riski doğar. Karma KDV oranlı mağazalarda her ürün kartına doğru oran tanımlanmalı ve entegrasyon bu alanı ürün bazında okumalıdır.

Shopify Parasüt Entegrasyonu Adım Adım Kurulumu

Kurulum, Parasüt tarafında API uygulaması oluşturmakla başlar ve test faturalarıyla doğrulanmadan canlıya alınmamalıdır. Aşağıdaki adımlar sıfırdan kurulum için genel çerçeveyi oluşturur.

1. Parasüt hesabında Ayarlar → Entegrasyonlar → API bölümünden yeni bir uygulama oluşturulur, client ID ve client secret alınır.
2. Shopify Admin → Apps bölümünden entegrasyon uygulaması kurulur, orders/paid, orders/cancelled ve products/update webhook’ları tanımlanır.
3. Parasüt’te ürün kartları oluşturulur veya mevcut kartlar Shopify SKU’larıyla eşleştirilir.
4. KDV oranları ürün bazında Parasüt’e tanımlanır.
5. E-fatura/e-arşiv otomatik seçim kuralı (VKN sorgusu bazlı) aktive edilir.
6. En az 5 farklı senaryo (yurt içi bireysel müşteri, yurt içi e-fatura mükellefi, iade) ile test siparişi verilir.
7. Fatura, stok ve cari hesap kayıtları doğrulandıktan sonra canlıya geçilir.

İpucu: Test aşamasında hem e-fatura mükellefi hem bireysel müşteri senaryosunun ayrı ayrı denenmesi, otomatik mükellefiyet sorgusunun doğru çalıştığını canlıya geçmeden garantiler. Yalnızca tek bir senaryo test edilirse diğer senaryodaki hata canlı ortamda fark edilir.

E-fatura sürecinin GİB tarafındaki teknik altyapısı, dört ERP seçeneğinin karşılaştırması ve hangi işletme büyüklüğüne hangi programın uygun olduğu Shopify ERP ve muhasebe entegrasyonu rehberinde ayrıca ele alınır.

Sipariş ödemesinin doğru tahsil edilmesi, faturalandırma sürecinin sağlıklı işlemesinin ön koşuludur; sanal POS sağlayıcısı seçimi ve komisyon yapısı Shopify ödeme entegrasyonu rehberinde ayrıntılı işlenir.

Parasüt Entegrasyonunda İade ve Kısmi İade Faturası Nasıl Kesilir?

Shopify’da bir sipariş kısmen veya tamamen iade edildiğinde, Parasüt API’si sales_invoices/cancel veya iade faturası (alacak dekontu) oluşturma uç noktası üzerinden orijinal faturayı düzeltir. Kısmi iadede yalnızca iade edilen ürün kalemi kadar tutar geri işlenir, tam iadede faturanın tamamı iptal edilir veya alacak dekontuyla sıfırlanır.

Bu sürecin otomatik çalışması için entegrasyon aracının Shopify’daki refunds/create webhook’unu dinleyip iade tutarını doğru fatura kalemine eşleştirmesi gerekir. Eşleştirme yapılmazsa iade muhasebe kaydına yansımaz ve cari hesap bakiyesi hatalı görünür.

Kritik Not: Kısmi iade senaryosunda hangi ürün kaleminin iade edildiği doğru tespit edilmezse, alacak dekontu yanlış tutarla kesilebilir. Birden fazla ürün içeren siparişlerde kısmi iade testi mutlaka ayrı bir test senaryosu olarak ele alınmalıdır.

Parasüt API Limitleri ve Hız Sınırlaması (Rate Limit)

Parasüt API’si, dakika başına belirli sayıda istek sınırı (rate limit) uygular; yüksek sipariş hacmine sahip mağazalarda kampanya dönemlerinde bu sınıra takılma riski vardır. Sınıra takılan istekler API tarafından reddedilir ve entegrasyon aracının bu isteği kuyruğa alıp yeniden denemesi gerekir.

Rate limit aşımı genelde flaş indirim veya büyük kampanya günlerinde çok sayıda siparişin aynı anda geldiği durumlarda ortaya çıkar. Entegrasyon aracı bu durumu ele almak için bir kuyruk (queue) mekanizmasına sahip değilse, limit aşan istekler kaybolabilir ve o siparişlerin faturası hiç kesilmeyebilir.

İpucu: Yüksek trafik beklenen kampanya günleri öncesinde entegrasyon aracının kuyruk ve yeniden deneme mekanizmasına sahip olup olmadığı entegratör firmadan teyit edilmelidir. Kuyruk mekanizması yoksa, kampanya günü sonrasında fatura kesilmemiş sipariş listesi manuel kontrol edilmelidir.

Parasüt Diğer ERP Seçeneklerine Göre Ne Zaman Daha Uygun?

Parasüt, küçük ve orta ölçekli e-ticaret işletmeleri için genelde en hızlı kurulan seçenektir çünkü API’si açık ve bulut tabanlıdır; Logo, Netsis veya Mikro gibi kurumsal ERP’ler ise çoklu depo, üretim planlama veya karmaşık cari hesap yapısı gereken işletmeler için daha uygundur.

Aylık sipariş hacmi birkaç yüzü aşmayan, tek depodan sevkiyat yapan ve muhasebe süreci dışarıdan bir mali müşavirlik bürosu tarafından yönetilen işletmeler için Parasüt’ün basitliği entegrasyon maliyetini düşürür. Üretim modülü veya çoklu şirket yapısı gereken işletmelerde Parasüt bu ihtiyaçları karşılamaz.

Dört programın karşılaştırmalı analizi ve işletme büyüklüğüne göre öneri Shopify ERP ve muhasebe entegrasyonu rehberinde ayrıntılı işlenir.

Parasüt Entegrasyonunda Çoklu Para Birimi ve Yurt Dışı Satış

Shopify üzerinden yurt dışına satış yapan işletmeler için Parasüt entegrasyonu, faturanın hangi para biriminde kesileceği ve KDV muafiyetinin nasıl uygulanacağı konusunda ek bir yapılandırma gerektirir. Yurt dışı satışlarda genelde ihracat istisnası uygulanır ve fatura KDV’siz kesilir.

Parasüt API’si çoklu para birimini destekler, ancak Shopify’daki sipariş tutarının hangi kurla Parasüt’e aktarılacağı (sipariş anındaki kur mu, fatura kesim anındaki kur mu) entegrasyon kurulumunda netleştirilmelidir. Bu iki kur farklı olduğunda, faturadaki TL karşılığı Shopify’da görünen tutardan az miktarda sapabilir.

Kritik Not: Yurt dışı satış yapan işletmelerde ihracat istisnası uygulanmadan yurt içi KDV oranıyla fatura kesilmesi, hem gereksiz vergi yüküne hem GİB nezdinde hatalı beyana yol açar. Yurt dışı sipariş senaryosu entegrasyon testinde ayrı bir senaryo olarak mutlaka denenmelidir.

Parasüt Entegrasyonunda Abonelik ve Tekrarlayan Sipariş Yönetimi

Shopify üzerinde abonelik modeliyle satış yapan mağazalar (örneğin aylık tekrarlayan ürün gönderimi) için Parasüt entegrasyonu, her tekrarlayan ödeme döngüsünde otomatik yeni bir fatura oluşturacak şekilde yapılandırılmalıdır. Bu, tek seferlik sipariş akışından farklı bir webhook mantığı gerektirir.

Abonelik uygulamaları (Shopify App Store’daki abonelik eklentileri) genelde kendi ödeme tahsilat webhook’unu tetikler; bu webhook’un Parasüt’e doğru sipariş kalemiyle eşleştirilmesi, abonelik ürününün her döngüde aynı fiyat ve KDV oranıyla faturalandırılmasını sağlar. Abonelik iptal edildiğinde ise gelecek dönem faturalarının otomatik durdurulması gerekir.

İpucu: Abonelik modeliyle çalışan mağazalarda entegrasyon aracının iptal edilen abonelikler için otomatik fatura kesmeyi durdurma yeteneği mutlaka test edilmelidir. Aksi halde iptal edilmiş bir abonelik için haksız fatura kesimi devam edebilir.

Parasüt Entegrasyonunda Muhasebeci Erişimi Nasıl Düzenlenir?

Parasüt hesabı genelde işletme sahibi ve mali müşavir tarafından ortak kullanılır; entegrasyon kurulduktan sonra API üzerinden otomatik oluşan faturaların mali müşavir tarafından görülüp onaylanması gerekebilir. Bu onay adımının otomasyona nasıl dahil edileceği kurulum öncesi netleştirilmelidir.

Bazı işletmeler faturaların API üzerinden doğrudan onaylı (kesinleşmiş) olarak oluşturulmasını tercih ederken, bazıları mali müşavirin günlük kontrolünden geçmeden faturanın taslak durumunda kalmasını ister. İkinci yaklaşım daha güvenli ama fatura kesim hızını yavaşlatır; müşteriye anlık fatura gönderimi gereken mağazalarda bu gecikme sorun yaratabilir.

İpucu: Anlık fatura gönderimi kritik olmayan düşük hacimli mağazalarda faturaların taslak oluşup mali müşavir onayından geçmesi hatalı KDV oranı gibi sorunları erken yakalar. Yüksek hacimli ve anlık fatura gönderimi gereken mağazalarda ise otomatik onaylı fatura akışı tercih edilip örnekleme yöntemiyle sonradan kontrol yapılabilir.

Parasüt’ten Diğer Bir Muhasebe Programına Geçiş Gerekirse Ne Olur?

İşletme büyüdükçe Parasüt’ün basit yapısı yetersiz kalabilir ve Logo veya Netsis gibi daha kapsamlı bir ERP’ye geçiş gündeme gelebilir; bu geçişte Parasüt’teki geçmiş fatura ve stok verisinin yeni sisteme aktarılması ayrı bir veri göçü (migration) projesi gerektirir. Bu geçiş, Shopify entegrasyonunun da yeniden kurulmasını zorunlu kılar.

Veri göçü sürecinde en kritik nokta, geçmiş faturaların GİB nezdindeki hukuki geçerliliğinin korunmasıdır; kesilmiş e-fatura ve e-arşiv faturalar yeni sisteme taşınmaz, yalnızca referans amaçlı arşivlenir ve yeni sistemde yeni bir fatura numarası serisiyle devam edilir. Bu ayrım, geçiş sürecinde mali müşavirle birlikte planlanmalıdır.

Kritik Not: ERP değişikliği kararı verilmeden önce mevcut Parasüt entegrasyonunun ne kadar özelleştirilmiş olduğu değerlendirilmelidir. Yoğun özel geliştirme içeren bir entegrasyon, yeni ERP’de sıfırdan kurulmak zorunda kalabilir ve bu maliyet geçiş kararına dahil edilmelidir.

Parasüt Webhook Güvenliği Nasıl Sağlanır?

Parasüt webhook güvenliği, Shopify’dan gelen isteklerin gerçekten mağazanın kendi sunucusundan geldiğini doğrulayan bir imza kontrolü (HMAC doğrulaması) kurulmasıyla sağlanır; bu kontrol olmadan entegrasyon uç noktası, sahte bir istekle tetiklenip yetkisiz fatura oluşturma riskine açık kalır.

Shopify, her webhook isteğine X-Shopify-Hmac-SHA256 başlığında bir imza ekler; entegrasyon aracı bu imzayı kendi gizli anahtarıyla yeniden hesaplayıp gelen değerle karşılaştırmalıdır. İmza eşleşmiyorsa istek reddedilmeli ve loglanmalıdır bu adım atlanırsa, uç noktanın adresini bilen herhangi biri sahte sipariş verisiyle Parasüt’te gerçek olmayan fatura oluşturabilir.

Kritik Not: Webhook imza doğrulaması, entegrasyon geliştirme sürecinde sıkça atlanan bir güvenlik adımıdır çünkü test ortamında doğrulama olmadan da sistem çalışır gibi görünür. Canlıya geçmeden önce imza doğrulamasının aktif olduğu, kasıtlı olarak bozuk bir imzayla test isteği gönderilerek doğrulanmalıdır.

Peki bu doğrulama adımı neden bu kadar kritik? Parasüt API’sine erişim bilgisi (client ID, client secret) mağaza sunucusunda tutulur; webhook uç noktasının adresi ise dışarıdan tahmin edilebilir bir URL yapısına sahipse, imza kontrolü olmadan bu uç nokta doğrudan hedef alınabilir ve gerçek olmayan sipariş verisiyle sahte fatura oluşturulabilir.

İkinci güvenlik katmanı, Parasüt API’sine erişen entegrasyon sunucusunun IP adresinin sabit tutulup gerektiğinde Parasüt tarafında IP kısıtlaması talep edilmesidir. Bu, client ID ve client secret bilgisi bir şekilde sızsa bile yetkisiz bir sunucudan API’ye erişimi engelleyen ek bir bariyer oluşturur.

Üçüncü katman, client secret bilgisinin kod deposunda düz metin olarak tutulmaması, bunun yerine bir ortam değişkeni (environment variable) veya sır yönetim servisi (secrets manager) üzerinden okunmasıdır. Bir geliştirici hesabı ele geçirildiğinde bile secret bilgisi kod deposunda görünür değilse saldırganın Parasüt API’sine erişimi engellenir.

Sık Sorulan Sorular

Parasüt entegrasyonu için geliştirici gerekir mi? Basit senkronizasyon için hazır Shopify App’ler kullanılabilir, ancak otomatik e-fatura mükellefiyet sorgusu gibi özel akışlar için API tabanlı geliştirme genelde gerekir. Parasüt’ün açık API’si bu geliştirmeyi Logo veya Netsis’e göre daha hızlı tamamlar.

Shopify siparişinden otomatik e-fatura kesilebilir mi? Evet, Parasüt API’si sipariş verisinden otomatik e-fatura veya e-arşiv fatura oluşturabilir. Müşterinin VKN/TCKN bilgisine göre mükellefiyet sorgusu yapılarak doğru fatura türü seçilir.

Parasüt entegrasyonu ne kadar sürede kurulur? Açık API sayesinde Parasüt entegrasyonu genelde 2-5 iş günü içinde tamamlanır. Karma KDV oranlı veya çoklu ürün kategorili mağazalarda test süreci bu süreyi uzatabilir.

Parasüt karma KDV oranlarını destekler mi? Evet, her ürün kartına ayrı KDV oranı tanımlanabilir. Entegrasyon aracının bu oranı ürün bazında okuyacak şekilde yapılandırılması gerekir, aksi halde varsayılan bir oran tüm ürünlere uygulanabilir.

Parasüt mü Logo mu Shopify için daha uygun? Küçük ve orta ölçekli, tek depolu işletmeler için Parasüt’ün açık API’si daha hızlı kurulum sağlar. Çoklu depo veya üretim modülü gereken kurumsal işletmeler için Logo daha kapsamlı bir yapı sunar.

Parasüt entegrasyonu iade işlemlerini destekler mi? Evet, Shopify’da işlenen bir iade Parasüt’e iade faturası ve stok giriş hareketi olarak yansıtılabilir. Bu akışın doğru çalışması için iade webhook’unun entegrasyon kapsamına dahil edilmesi gerekir.

Parasüt API’sinde istek sınırı (rate limit) var mı? Evet, Parasüt API’si dakika başına belirli sayıda isteğe izin verir ve bu sınır aşıldığında istekler reddedilir. Yüksek trafikli kampanya günlerinde entegrasyon aracının kuyruk mekanizmasına sahip olması gerekir.

Kısmi iade Parasüt’te nasıl işlenir? Kısmi iade, orijinal faturanın ilgili kalemine karşılık gelen tutar kadar alacak dekontu kesilerek işlenir. Bu senaryonun doğru çalışması için entegrasyon aracının iade edilen ürün kalemini doğru tespit etmesi gerekir.

Parasüt webhook güvenliği için ne yapılmalı? Shopify’dan gelen her isteğin HMAC imzası doğrulanmalı, eşleşmeyen istekler reddedilip loglanmalıdır. Ek olarak entegrasyon sunucusunun IP adresi sabitlenip Parasüt tarafında kısıtlama talep edilebilir.

Parasüt entegrasyonunda mali müşavir onayı zorunlu mu? Zorunlu değildir, ama bazı işletmeler faturaların API üzerinden doğrudan kesinleşmeden önce mali müşavir kontrolünden geçmesini tercih eder. Bu tercih kurulum aşamasında entegrasyon akışına dahil edilmelidir.

Sonraki Adım

Parasüt entegrasyonu canlıya alındıktan sonra ilk ay boyunca fatura ve stok kayıtlarının günlük kontrol edilmesi, KDV oranı veya mükellefiyet sorgusu kaynaklı hataların erken fark edilmesini sağlar. Diğer ERP seçeneklerini karşılaştırmak veya e-fatura sürecinin teknik detaylarını incelemek isteyenler ilgili rehberlere geçerek karar sürecini derinleştirebilir.