Shopify Logo GO Entegrasyonu Nedir?
Shopify Logo GO entegrasyonu, Shopify mağazasındaki sipariş, stok ve fatura verilerini Logo GO muhasebe yazılımıyla otomatik olarak senkronize eden bir bağlantı altyapısıdır.
Türkiye’deki e-ticaret mağazaları için muhasebe uyumluluğu, sadece iyi pratik değil; yasal zorunluluktur. Vergi Usul Kanunu kapsamında her satış işlemi için e-fatura veya e-arşiv fatura düzenlenmesi gerekir. Shopify, yerli bir muhasebe yazılımıyla entegre edilmediğinde fatura süreçleri manuel yürütülmek zorunda kalır – bu hem zaman kaybı hem de hata riski demektir. Logo GO, Türkiye’nin en yaygın kullanılan kurumsal muhasebe yazılımlarından biridir ve Shopify ile entegrasyonu doğrudan API veya üçüncü taraf köprü araçlarıyla sağlanabilir.
Bu rehberde Shopify ile Logo GO arasındaki entegrasyonu nasıl kuracağınızı, hangi verilerin senkronize edildiğini ve dikkat etmeniz gereken teknik kısıtlamaları adım adım ele alıyoruz.
Logo GO Neden Shopify ile Entegre Edilmeli?
Logo GO’yu Shopify’a bağlamanın temel sebebi, muhasebe süreçlerini otomatikleştirerek insan hatalarını ve manuel veri girişi yükünü ortadan kaldırmaktır. Entegrasyon olmadan sipariş başına ortalama 5-10 dakika manuel muhasebe işi yapılır; 100 siparişlik bir günde bu 8-16 saat anlamına gelir.
Entegrasyonun sağladığı temel faydalar:
- Her Shopify siparişi için Logo GO’da otomatik satış faturası oluşturulur.
- Stok hareketleri muhasebe tarafına otomatik yansır, sayım hataları azalır.
- KDV hesaplamaları iki sistem arasında tutarlı yürür.
- Ay sonu kapanış ve BA/BS formu hazırlığı kolaylaşır.
- E-fatura ve e-arşiv fatura düzenleme süreci hızlanır.
Shopify-Logo GO entegrasyonu kurulu mağazalarda manuel fatura hatası oranı ortalama yüzde 90 düşer ve muhasebe işlem süresi sipariş başına 2 dakikanın altına iner.
Türkiye’de e-ticaret yapan ve aylık 200’den fazla sipariş alan her mağaza için bu entegrasyon artık bir lüks değil, operasyonel zorunluluktur.
Shopify-Logo GO Entegrasyon Yöntemleri
Shopify ile Logo GO’yu bağlamanın birden fazla yolu vardır. Doğrudan API entegrasyonu en güçlü yöntemdir; ancak teknik bilgi gerektirir. Hazır köprü araçları ise kurulum kolaylığı sunar fakat özelleştirme kapasitesi sınırlıdır.
Yöntem karşılaştırması:
| Yöntem | Kurulum Süresi | Teknik Gereksinim | Maliyet | Esneklik |
|---|---|---|---|---|
| Direkt API entegrasyonu | 2-5 gün | Yüksek (geliştirici) | Yüksek (proje bedeli) | Tam özelleştirme |
| Entegrasyon platformu (n8n, Make) | 1-2 gün | Orta | Düşük-Orta (SaaS aylık) | Orta |
| Hazır Logo iş ortağı çözümü | Birkaç saat | Düşük | Orta (lisans) | Sınırlı |
| Manuel CSV aktarımı | Sürekli | Düşük | Ücretsiz | Yok |
Hangi yöntemi seçmelisiniz?
Günde 50 siparişin altındaki mağazalar için n8n veya Make tabanlı otomasyon yeterlidir. 50-500 sipariş aralığında Logo iş ortağı çözümleri tercih edilir. 500+ sipariş için direkt API entegrasyonu zorunludur; verinin güvenilirliği ve işlem hızı kritik önem taşır.
Logo iş ortağı çözümlerini kullanmadan önce Logo’nun resmi iş ortağı listesinden onaylı yazılımı seçin. Onaysız araçlar Logo GO güncellemelerinde bozulabilir.
n8n ile Shopify-Logo GO Entegrasyonu Nasıl Kurulur
n8n, açık kaynaklı bir otomasyon platformudur (no-code iş akışı aracı). Self-hosted veya cloud olarak kullanılabilir. Shopify ve Logo GO REST API’lerini köprüleyen iş akışları oluşturabilirsiniz.
Adım adım kurulum:
- n8n’i kurun: n8n.io’dan cloud hesabı açın veya kendi sunucunuza Docker ile deploy edin.
- Shopify node’unu ekleyin: n8n’de “Shopify” node’unu seçin, mağaza URL’nizi ve API token’ınızı girin. Shopify Admin > Uygulamalar > Özel uygulamalar’dan token alınır.
- Tetikleyiciyi tanımlayın: “Order Created” event’ini tetikleyici olarak seçin. Her yeni sipariş n8n iş akışını otomatik başlatır.
- Veri dönüşümünü yapılandırın: Shopify’dan gelen sipariş JSON’ını Logo GO’nun beklediği formata map edin. Müşteri adı, fatura adresi, ürün kodu, KDV oranı ve tutar alanları zorunludur.
- Logo GO API bağlantısını kurun: Logo GO REST API endpoint’ini HTTP Request node’una ekleyin. Logo GO API anahtarınızı yetkilendirme başlığına girin.
- Test edin: n8n’de “Execute Workflow” ile test siparişi gönderin ve Logo GO’da faturanın oluşup oluşmadığını doğrulayın.
- Aktif edin: Test başarılıysa iş akışını “Active” konumuna getirin. Artık her Shopify siparişi otomatik Logo GO’ya aktarılır.
n8n ile Shopify-Logo GO entegrasyonu ortalama 1 iş günü içinde kurulabilir ve aylık 20-50 dolar arasında SaaS maliyetiyle sürdürülebilir.
Shopify Admin API Token Nasıl Alınır
Logo GO entegrasyonu kurmadan önce Shopify tarafında API erişimi açmak gerekir. Bu işlem Custom App (özel uygulama) oluşturarak yapılır.
Shopify Admin API token alma adımları:
- Shopify Admin’e giriş yapın, sol menüden Ayarlar > Uygulamalar ve satış kanalları‘na gidin.
- Sayfanın altında Uygulamaları geliştirin seçeneğini tıklayın.
- Özel uygulama oluşturun butonuna basın ve uygulamaya açıklayıcı bir isim verin (örneğin: “Logo GO Entegrasyonu”).
- Admin API erişimini yapılandırın bölümünde şu izinleri verin:
- Siparişler: Okuma ve yazma
- Müşteriler: Okuma ve yazma
- Ürünler: Okuma ve yazma
- Envanter: Okuma ve yazma
- Uygulamayı kaydedin ve üretilen Admin API erişim token’ını kopyalayın. Bu token yalnızca bir kez görüntülenir; güvenli bir yere kaydedin.
Token sızdırılırsa hemen Shopify Admin’den ilgili uygulamayı silin ve yeni token oluşturun. Token’ı kaynak koduna yazmak yerine sunucu ortam değişkenine (environment variable) ekleyin.
Logo GO REST API ile Doğrudan Entegrasyon
Doğrudan API entegrasyonu, en güvenilir ve özelleştirilebilir yöntemdir. Logo GO, REST tabanlı bir API sağlar; ancak bu API kurumsal lisans kapsamındadır ve teknik dokümantasyona erişim için Logo ile resmi iletişim gerekir.
Teknik gereksinimler:
- Logo GO kurumsal veya Logo GO Plus lisansı (API erişimi için).
- Logo GO REST API token ve endpoint bilgisi.
- Shopify Custom App API token (Admin API).
- Backend geliştirici (Node.js, Python veya PHP).
API entegrasyonunun temel bileşenleri:
| Bileşen | Shopify Tarafı | Logo GO Tarafı |
|---|---|---|
| Sipariş verisi | GET /admin/api/orders.json | POST /api/SalesInvoice |
| Müşteri verisi | GET /admin/api/customers.json | POST /api/CurrentAccount |
| Stok güncelleme | Webhook: inventory_levels/update | PUT /api/InventoryItem |
| İade işlemi | Webhook: refunds/create | POST /api/ReturnInvoice |
Webhook tabanlı gerçek zamanlı senkronizasyon:
Shopify Webhooks, sipariş oluşturulduğunda, güncellendiğinde veya iptal edildiğinde otomatik bildirim gönderir. Bu bildirimleri dinleyen bir backend servisi, Logo GO API’sine ilgili fatura veya kayıt işlemini anında iletir. Webhook tabanlı yaklaşım, polling (sorgulama) yöntemine göre çok daha güvenilirdir ve gerçek zamanlı senkronizasyon sağlar.
Logo GO API, her Shopify siparişi için ayrı fatura oluşturur. Toplu sipariş indirimi veya kargo faturalaması gibi özel durumlar için ek iş akışı mantığı yazılması gerekir; standart entegrasyon bu senaryoları otomatik işlemez.
Hazır Entegrasyon Çözümleri: Logo İş Ortağı Uygulamaları
Logo’nun resmi iş ortakları, Shopify bağlantısı dahil çeşitli e-ticaret entegrasyon çözümleri sunar. Bu çözümler teknik bilgi gerektirmeden kurulabilir.
Türkiye’de kullanılan başlıca Shopify-Logo GO entegrasyon araçları:
- Entegra.io: Shopify, Trendyol, Hepsiburada gibi kanallarla Logo GO entegrasyonu sunar. Sipariş, fatura ve stok senkronizasyonu tek panel üzerinden yönetilir.
- Simpra Connect: Perakende odaklı; Logo GO ile POS ve e-ticaret senkronizasyonu sağlar.
- Uyumsoft E-Ticaret Köprüsü: Logo uyumlu muhasebe entegrasyonuyla birlikte e-fatura ve e-arşiv yönetimi sunar.
Bu araçlar genellikle aylık SaaS abonelik modeliyle fiyatlandırılır. Sipariş hacminize göre 200-2.000 TL/ay aralığında değişen fiyatlandırma planları mevcuttur.
Logo iş ortağı çözümleri ile doğrudan API entegrasyonu karşılaştırması:
| Kriter | Hazır Çözüm | Doğrudan API |
|---|---|---|
| Kurulum süresi | 1-4 saat | 2-7 gün |
| Teknik gereksinim | Minimal | Yüksek |
| Özelleştirme | Sınırlı | Tam |
| Aylık maliyet | 200-2.000 TL | Sunucu + geliştirici saati |
| Güncelleme yönetimi | Sağlayıcı yönetir | Kendiniz |
| Destek | Sağlayıcı | Kendiniz / geliştirici |
Shopify Ödeme Mutabakatı ve Logo GO
Shopify’da farklı ödeme yöntemleri (kredi kartı, havale, kapıda ödeme) kullanıldığında her birinin Logo GO’da doğru hesap koduna eşleştirilmesi gerekir. Hatalı eşleştirme, banka mutabakatında ve ay sonu kapanışında ciddi sorunlar doğurur.
Ödeme yöntemi – Logo GO hesap kodu eşleştirme tablosu:
| Shopify Ödeme Yöntemi | Logo GO Hesap Kodu | Açıklama |
|---|---|---|
| Kredi kartı (iyzico, PayTR) | 102 | Bankalar hesabı |
| Banka havalesi / EFT | 102 | Bankalar hesabı |
| Kapıda ödeme (nakit) | 100 | Kasa hesabı |
| Kapıda ödeme (kredi kartı) | 102 | Bankalar hesabı |
| PayPal | 102 | Bankalar hesabı (dövizli alt hesap) |
Bu eşleştirme tablosu entegrasyon yapılandırmasında tanımlanır. Shopify Payments Türkiye’de kullanılamadığından, Türk mağazalar için iyzico ve PayTR en yaygın ödeme sağlayıcılarıdır. Shopify Stripe Kurulum Rehberi uluslararası ödeme seçeneklerini karşılaştırır.
Ödeme mutabakatı için entegrasyonun, Shopify’dan gelen payout (ödeme transferi) verilerini de Logo GO’ya aktarması önerilir. Böylece banka hesabına giren tutarla Logo GO’daki alacak kaydı otomatik eşleştirilir.
Entegrasyonda Sık Karşılaşılan Sorunlar ve Çözümleri
Shopify-Logo GO entegrasyonunda teknik sorunlar, çoğunlukla veri formatı uyumsuzlukları ve KDV eşleştirme hatalarından kaynaklanır. Her sorunun bilinen bir çözümü vardır.
En sık karşılaşılan sorunlar:
- KDV kodu uyumsuzluğu: Shopify’da %20 KDV kodu Logo GO’daki KDV gruplarıyla eşleşmeyebilir. Çözüm: Her KDV oranı için manuel eşleştirme tablosu oluşturun.
- Ürün kodu (SKU) çakışması: Logo GO’daki stok kartı kodu ile Shopify SKU’su eşleşmezse stok senkronizasyonu bozulur. Çözüm: Shopify SKU’larını Logo GO stok kodlarıyla birebir eşleştirin.
- Kur farkı faturalama: Dövizli siparişlerde Logo GO’da kur farkı muhasebesi için ek yapılandırma gerekebilir. Çözüm: Muhasebeciniziyle birlikte döviz hesabı parametrelerini ayarlayın.
- Çift fatura oluşumu: Webhook tetikleyicisi birden fazla kez çalışırsa aynı sipariş için iki fatura oluşabilir. Çözüm: İş akışına idempotency (tekrarlama önleme) kontrolü ekleyin.
- Logo GO API timeout hatası: Yüksek sipariş hacminde Logo GO API yanıt vermeyebilir. Çözüm: Exponential backoff ile otomatik yeniden deneme mekanizması kurun.
Entegrasyon canlıya geçmeden önce mutlaka test ortamında en az 20 farklı sipariş senaryosunu doğrulayın: normal sipariş, kısmi iade, tam iade, dövizli ödeme, çoklu ürün. Test edilmemiş entegrasyon muhasebe kayıtlarında telafi edilmesi güç hatalar oluşturabilir.
E-Fatura ve E-Arşiv Fatura Entegrasyonu
Türkiye’de yıllık 500.000 TL ve üzeri ciro eşiğini geçen mükelleflerin e-fatura sistemine geçmesi zorunludur. Shopify üzerinden satış yapan mağazalar bu eşiği aşarsa e-fatura düzenleme yükümlülüğü doğar. (Gelir İdaresi Başkanlığı, 2024)
Logo GO, e-Devlet entegrasyonu kapsamında e-fatura ve e-arşiv fatura düzenleyebilir. Shopify siparişleri Logo GO’ya aktarıldığında, muhasebe tarafında e-fatura oluşturma ve GİB’e iletme süreci Logo GO üzerinden yürütülür.
E-fatura akışı (entegrasyon kurulu mağaza için):
- Müşteri Shopify’da sipariş verir.
- Sipariş verisi entegrasyon aracılığıyla Logo GO’ya iletilir.
- Logo GO satış faturası oluşturur.
- Logo GO e-fatura modülü, faturayı elektronik imzayla imzalar ve GİB’e iletir.
- Fatura PDF’i müşteriye e-posta ile gönderilir.
Tüm bu süreç, entegrasyon doğru kurulduğunda tamamen otomatik işler. Shopify KDV Ayarları makalesi Shopify tarafındaki vergi yapılandırmasını açıklar.
E-fatura zorunluluğuna uyumsuz her fatura için Gelir İdaresi Başkanlığı tarafından özel usulsüzlük cezası uygulanır; 2024 itibarıyla bu ceza belge başına minimum 670 TL’dir.
Logo GO Entegrasyonunda Güvenlik ve Yedekleme
Muhasebe verileri yasal kayıt niteliği taşır. Entegrasyon altyapısında güvenlik ve yedekleme ihmali, hem operasyonel hem de hukuki risk oluşturur.
Güvenlik için zorunlu önlemler:
- Logo GO API token’ını ve Shopify API token’ını şifreli bir vault’ta saklayın (HashiCorp Vault, AWS Secrets Manager veya Bitwarden Business).
- Entegrasyon sunucusundan yalnızca Logo GO ve Shopify API endpoint’lerine çıkış izni verin; gereksiz port ve bağlantıları kapatın.
- Entegrasyon loglarını en az 6 ay boyunca saklayın. Vergi incelemesinde fatura ile sipariş verisi karşılaştırması istenebilir; loglar bu kanıtı sağlar.
- Her hafta Logo GO’dan verilen faturalar ile Shopify’daki sipariş sayısını karşılaştırın. Fark varsa hemen araştırın.
Yedekleme stratejisi:
Logo GO veritabanını günlük yedekleyin. Shopify sipariş verisi Shopify’da saklanır ancak Logo GO’daki muhasebe kayıtları kendi yedekleme sorumluluğunuzdadır. Vergi Usul Kanunu uyarınca elektronik kayıtların 5 yıl boyunca saklanması zorunludur.
Stok Senkronizasyonu: Shopify ile Logo GO Arasında Envanter Yönetimi
Stok senkronizasyonu, muhasebe entegrasyonunun en kritik bileşenidir. Shopify ve Logo GO’da stok miktarlarının tutarsız olması hem yanlış satış hem de muhasebe hatası anlamına gelir.
Stok senkronizasyonu için iki yönlü bağlantı:
| Yön | Ne Tetikler | Sonuç |
|---|---|---|
| Shopify → Logo GO | Sipariş oluşturuldu | Logo GO’da stok düşümü |
| Logo GO → Shopify | Tedarikçi malı teslim aldı | Shopify’da stok artışı |
| İki yönlü | İade işlendi | Her iki sistemde stok iade güncelleme |
Tek yönlü entegrasyon yeterli değildir. Tedarikçiden mal girişi yapıldığında bu bilginin Shopify’a da yansıması gerekir; aksi hâlde ürün Shopify’da tükendi görünmeye devam eder ve satış kaybı yaşanır.
Negatif stok koruması: Entegrasyonda negatif stok önleme kuralı aktif edilmelidir. Shopify’da stok tükenmişken sipariş alınırsa ve bu bilgi Logo GO’ya aktarılırsa, Logo GO muhasebe kaydı oluşturur fakat gerçekte teslim edilecek ürün yoktur. Bu durum hem müşteri mağduriyeti hem de muhasebe tutarsızlığı yaratır. Shopify ürün sayfasında “Stokta yokken satışa devam et” seçeneğini kapalı tutun.
İki yönlü stok senkronizasyonu kurmayan Shopify mağazalarında tedarikçi mal girişlerinin Shopify’a yansımaması nedeniyle ortalama yüzde 12 stok tükendi uyarısı hatalı görünür ve bu da kaçırılan satışa dönüşür.
SSS
Shopify Logo GO entegrasyonu için Logo GO lisansı şart mı?
Evet. Logo GO REST API’sine erişmek için Logo GO kurumsal lisansı gereklidir. API erişimi standart lisanslarda kısıtlıdır; Logo GO temsilcinizle API modülü aktivasyonunu görüşün.
Entegrasyon olmadan Shopify siparişlerini Logo GO’ya aktarmanın yolu var mı?
Manuel CSV aktarımı mümkündür. Shopify’dan sipariş listesini CSV olarak dışa aktarın, Logo GO’nun kabul ettiği formata dönüştürün ve içe aktarın. Ancak bu süreç yoğun sipariş hacminde pratik değildir ve hata riskini artırır.
Entegrasyon kurulumu ne kadar sürer?
Hazır çözümler için 2-8 saat; n8n/Make tabanlı otomasyon için 1-2 iş günü; özel API entegrasyonu için 3-10 iş günü gerekir. Süre, sipariş yapısının karmaşıklığına ve KDV senaryolarının sayısına göre değişir.
Logo GO ile Shopify arasında hangi veriler senkronize edilir?
Tipik entegrasyon şu verileri kapsar: siparişler, faturalar, müşteri kayıtları, ürün/stok bilgisi ve iade işlemleri. Ödeme mutabakatı bazı çözümlerde ek yapılandırma gerektirir.
Entegrasyon koptuğunda ne olur?
Entegrasyon kesintisinde Shopify siparişleri alınmaya devam eder ancak Logo GO’ya otomatik aktarılmaz. Bu süredeki siparişler için manuel giriş veya toplu aktarım gerekir. Bu nedenle entegrasyonda hata bildirim mekanizması (e-posta alert) kurulması zorunludur.
Shopify ile muhasebe entegrasyonu için alternatif yazılımlar var mı?
Türkiye’de Logo GO’nun yanı sıra Mikro, Netsis ve Luca muhasebe yazılımları da kullanılmaktadır. Uluslararası alternatiflerse QuickBooks ve Xero’dur; ancak bunlar Türk e-fatura sistemine doğrudan entegre değildir.
Entegrasyon Shopify mağazasının performansını etkiler mi?
Doğru yapılandırılmış bir entegrasyon mağaza performansını etkilemez. Webhook tabanlı entegrasyon asenkron çalışır; yani müşteri ödeme yaptıktan sonra fatura işlemi arka planda yürür, ödeme akışı yavaşlamaz.
Logo GO yerine bulut tabanlı muhasebe sistemi kullanmak daha mı avantajlı?
Logo GO’nun bulut sürümü (Logo GO | Bulut) hem yerel mevzuata uyumlu hem de API entegrasyonuna açıktır. Kurum içi sunucu yönetimi istemiyorsanız bulut versiyonu tercih edilebilir; teknik altyapı gereksinimi düşer.
Sonuç: Hangi Entegrasyon Yolunu Seçmeli?
Shopify-Logo GO entegrasyonunda doğru yöntemi seçmek, sipariş hacminize ve teknik kapasitenize bağlıdır.
- Günlük 50 siparişin altı: n8n veya Make ile otomasyonu kendiniz kurabilirsiniz; maliyet düşük, kurulum hızlıdır.
- 50-500 sipariş: Logo iş ortağı çözümlerinden birini seçin; destek ve güncel uyumluluk garantisi sağlar.
- 500+ sipariş: Özel API entegrasyonu kaçınılmazdır; geliştirici maliyeti karşılanabilir, çünkü insan hatası ve muhasebe düzeltme maliyeti çok daha yüksektir.
Bir sonraki adım olarak Shopify mağazanızdaki KDV yapılandırmanızı doğrulayın – entegrasyon kurulmadan önce Shopify tarafında doğru KDV oranları tanımlı olmak zorundadır. Shopify KDV Ayarları ve Shopify Türkçe Dil Paketi rehberleri bu konuyu detaylı ele alır.
Entegrasyon kurulumunda muhasebecinizsizle birlikte çalışmanız şiddetle önerilir. Shopify tarafındaki vergi kodları, Logo GO’daki KDV gruplarıyla muhasebeci onayı alınarak eşleştirilmelidir. Teknik kurulum ne kadar doğru yapılmış olursa olsun, yanlış KDV eşleştirmesi tüm fatura kayıtlarını hatalı hale getirir. Muhasebeci uyumu olmadan canlıya geçmeyin.