Logo ve E-Ticaret Entegrasyonu Nasıl Yapılır? KOBİ'ler İçin Rehber

Muhasebesini ve stoğunu Logo'da tutan, aynı zamanda bir e-ticaret sitesi ya da pazaryeri mağazası işleten pek çok işletmenin günü benzer geçer: sabah gelen siparişler bir ekrandan okunur, Logo'ya elle girilir, irsaliye ve fatura kesilir, akşam da stok sayıları siteye tek tek işlenir. Sipariş sayısı az olduğunda bu düzen idare eder. Sipariş arttıkça yanlış girilen bir ürün kodu, güncellenmemiş bir stok ya da iki kez işlenmiş bir sipariş, ekibin zamanını ve müşterinin güvenini yemeye başlar.

Logo e-ticaret entegrasyonu bu el emeğini ortadan kaldırmayı hedefler. Bu yazıda bir Logo entegrasyonunda hangi verilerin senkronize edildiğini, hangi yöntemlerle yapılabileceğini ve artılarıyla eksilerini, e-Fatura ve e-Arşiv akışıyla ilişkisini, kurulum adımlarını ve en sık yapılan hataları anlatıyoruz. Yazı Logo Tiger, Logo Go veya j-Platform gibi Logo ürünlerinden birini kullanan KOBİ'ler için hazırlandı. Ürünler ve sürümler arasında teknik farklar olduğu için ayrıntıları her zaman kendi sürümünüz ve Logo iş ortağınızla doğrulamanızı öneririz.

Logo e-ticaret entegrasyonunda neler senkronize edilir?#

Entegrasyon tek bir veri akışı değil, yönü ve sıklığı birbirinden farklı birkaç akışın toplamıdır. Başlamadan önce hangi verinin hangi sistemde "asıl" kabul edileceğini netleştirmek gerekir.

Stok#

Genellikle Logo'dan e-ticaret tarafına akar. Depodaki gerçek miktar Logo'da tutulur ve site ya da pazaryeri bu miktarı gösterir. Birden fazla depo varsa hangi depoların satışa açık olduğu, rezerve edilmiş miktarların düşülüp düşülmeyeceği önceden belirlenmelidir.

Fiyat#

Fiyat çoğu işletmede Logo'daki fiyat kartlarından gelir; ancak pazaryerlerinde komisyon farkı nedeniyle farklı fiyat uygulanması yaygındır. Bu durumda Logo'daki liste fiyatına kanal bazında bir kural uygulanır ya da her kanal için ayrı fiyat listesi tutulur.

Sipariş, irsaliye ve fatura#

Ters yönde akan en önemli veri siparişlerdir. Siteden ya da pazaryerinden gelen sipariş Logo'ya sipariş fişi olarak aktarılır; sevkiyatla birlikte irsaliye, ardından fatura oluşturulur. Bazı işletmeler siparişi doğrudan faturaya dönüştürmeyi tercih eder. Hangi adımın otomatik, hangisinin onaylı olacağı iş akışınıza göre belirlenir.

Cari hesap#

Siparişi veren müşterinin Logo'da bir cari hesabı olmalıdır. Bireysel müşteriler için her siparişte yeni cari açmak kısa sürede binlerce kayıt üretir. Bu yüzden bazı işletmeler bireysel satışları kanal bazında ortak bir cariye bağlar, kurumsal müşteriler için ise vergi numarasıyla eşleşen ayrı cari kullanır. Hangisinin uygun olduğu muhasebe ve raporlama ihtiyacınıza bağlıdır; bu kararı mali müşavirinizle birlikte vermek doğru olur.

Tahsilat ve banka hareketleri#

Kredi kartı, havale ve kapıda ödeme gibi tahsilatların Logo'da doğru cariye ve doğru hesaba işlenmesi gerekir. Logo banka entegrasyonu dendiğinde genellikle banka hesap hareketlerinin Logo'ya aktarılması ve gelen ödemelerin ilgili cari ya da siparişle eşleştirilmesi kastedilir. Ödeme kuruluşlarının toplu ve komisyon düşülmüş ödeme yapması, bu eşleştirmenin en çok dikkat isteyen kısmıdır.

Entegrasyon yöntemleri: artıları ve eksileri#

Logo ile e-ticaret arasında veri taşımanın birkaç yolu vardır. Hangisinin uygun olduğu kullandığınız Logo ürününe, sürümüne, lisansınıza ve sipariş hacminize göre değişir.

Logo'nun resmi arayüzleri (Objects ve REST servisleri)#

Logo, ürününe ve sürümüne göre dış sistemlerin veri yazıp okuyabilmesi için resmi arayüzler sunar. Logo Objects, Tiger ve Go ailesinde uzun süredir kullanılan, kayıtları Logo'nun kendi iş kurallarından geçirerek oluşturan bir nesne kütüphanesidir. Daha yeni sürümlerde web tabanlı REST servisleri de bulunur. Bu yolla yapılan bir API entegrasyonu, fişlerin Logo'nun kendi doğrulamalarından geçmesini sağlar.

• Artıları: Kayıtlar Logo'nun iş kurallarına uygun oluşur, sürüm güncellemelerinde daha öngörülebilir davranır, destek tarafında kabul gören yöntemdir.
• Eksileri: Kullanılabilirlik ürün, sürüm ve lisansa bağlıdır; bazı servisler ek modül veya lisans gerektirebilir. Hangi arayüzün sizin kurulumunuzda açık olduğunu Logo iş ortağınızla teyit etmek gerekir.

Veritabanı katmanı#

Logo ürünleri verilerini bir SQL veritabanında tutar. Okuma amaçlı (örneğin stok ve fiyat çekmek) veritabanına doğrudan bağlanmak teknik olarak mümkündür.

• Artıları: Hızlıdır, raporlama ve okuma için pratiktir.
• Eksileri: Doğrudan veritabanına yazmak, Logo'nun iş kurallarını atlar; bakiye, maliyet ya da bağlantılı tablolarda tutarsızlığa yol açabilir ve sürüm güncellemesinde tablo yapısı değişebilir. Bu yüzden yazma işlemleri için önerilmez; okuma için kullanılacaksa bile yalnızca okuma yetkili bir kullanıcıyla yapılmalıdır.

Hazır entegratörler#

Piyasada Logo ile yaygın e-ticaret altyapıları ve pazaryerleri arasında bağlantı kuran hazır entegrasyon ürünleri bulunur.

• Artıları: Hızlı kurulur, yaygın senaryolar hazırdır, bakımı üreticinin sorumluluğundadır.
• Eksileri: İş akışınız standart dışındaysa (özel fiyat kuralları, karmaşık varyant yapısı, farklı depo mantığı) esneklik sınırlı kalabilir. Abonelik maliyeti ve verinin üçüncü taraf sunucusundan geçmesi de değerlendirilmelidir.

Özel middleware#

Logo ile e-ticaret sistemi arasına, sizin kurallarınıza göre çalışan ayrı bir ara katman yazılımı kurulur. Bu katman siparişleri alır, dönüştürür, Logo'nun resmi arayüzleriyle kaydeder ve her adımı loglar.

• Artıları: İş akışınıza tam uyar, birden fazla kanalı tek noktadan yönetir, hata yönetimi ve raporlama istediğiniz gibi tasarlanır.
• Eksileri: Geliştirme ve bakım sorumluluğu gerektirir. Kanal sayısı az ve süreç standartsa hazır çözüme göre gereğinden ağır kalabilir.

Pratikte bu yöntemler sık sık birlikte kullanılır: okuma için veritabanı görünümleri, yazma için resmi arayüzler, kanal bağlantısı için ise hazır bir entegratör ya da özel bir katman.

e-Fatura ve e-Arşiv akışıyla ilişkisi#

E-ticaret satışlarında fatura, alıcının durumuna göre e-Fatura ya da e-Arşiv fatura olarak düzenlenir. Alıcı e-Fatura mükellefiyse e-Fatura, değilse çoğunlukla e-Arşiv fatura kesilir. Logo tarafında bu belgelerin oluşturulması ve gönderilmesi genellikle Logo'nun kendi e-dönüşüm çözümleri veya bağlı olduğunuz özel entegratör üzerinden yürür.

Entegrasyonun buradaki görevi, faturanın doğru verilerle oluşmasını sağlamaktır: doğru cari, doğru vergi numarası veya T.C. kimlik bilgisi, doğru KDV oranı ve iskonto. Fatura oluştuktan sonra fatura numarası ya da belge bağlantısının e-ticaret tarafına geri yazılması, müşterinin faturasını sipariş ekranından görebilmesini sağlar. Pazaryerlerinin çoğu da faturanın sisteme yüklenmesini bekler. Mevzuat ayrıntıları değişebildiği için e-belge kurallarını mali müşavirinizle birlikte gözden geçirmenizi öneririz.

Senkronizasyon sıklığı ve çakışma yönetimi#

Her veri aynı sıklıkta senkronize edilmek zorunda değildir.

• Stok: Satış hızınıza göre birkaç dakikada bir ya da değişiklik olduğunda tetiklenerek güncellenir. Hızlı satan ürünlerde gecikme, olmayan ürünün satılmasına yol açar.
• Fiyat: Genellikle değişiklik olduğunda ya da günde birkaç kez yeterlidir.
• Sipariş: Mümkün olduğunca kısa aralıklarla ya da e-ticaret tarafının bildirimiyle (webhook) anlık olarak alınır.
• Tahsilat: Banka ve ödeme kuruluşunun sunduğu yönteme göre günlük ya da daha sık.

Çakışma, aynı verinin iki tarafta farklı değiştiği durumdur. En sağlam kural, her veri için tek bir asıl kaynak belirlemektir: stok ve fiyatın asıl kaynağı Logo, siparişin asıl kaynağı e-ticaret tarafıdır. Böylece "hangisi doğru?" sorusu her seferinde yeniden tartışılmaz. Stokta güvenlik payı bırakmak, yani kritik ürünlerde son birkaç adedi satışa kapatmak da senkronizasyon gecikmesinden kaynaklanan aşırı satışı azaltır.

Hata loglama ve izleme#

Entegrasyon çalıştığında görünmez; sorun çıktığında ise çoğu zaman günler sonra fark edilir. Bunun önüne geçmek için:

• Her aktarılan kaydın kaynak numarası, Logo'daki fiş numarası, zamanı ve sonucu kaydedilmelidir.
• Başarısız kayıtlar sessizce atlanmamalı, nedeniyle birlikte bir hata listesine düşmeli ve yeniden denenebilmelidir.
• Belirli bir süre sipariş gelmemesi ya da hata sayısının artması gibi durumlarda ilgili kişiye bildirim gitmelidir.
• Aynı siparişin ikinci kez işlenmesini engellemek için her siparişin dış kaynak numarası Logo'da saklanmalı ve aktarımdan önce kontrol edilmelidir.

Kurulum adımları#

Bir Logo entegrasyonu projesinde izlenmesi gereken adımlar genel olarak şunlardır:

1. Analiz: Hangi kanallar var, günde kaç sipariş geliyor, hangi Logo ürünü ve sürümü kullanılıyor, hangi arayüzler açık, fatura süreci nasıl işliyor? Bu aşamada elle yapılan işler adım adım yazılır.
2. Eşleştirme tablosu: E-ticaret tarafındaki ürün kodları, varyantlar, kargo ve ödeme yöntemleri, KDV oranları ve depo kodları Logo'daki karşılıklarıyla tek tek eşleştirilir. Projenin en az görünen ama en belirleyici adımıdır.
3. Test ortamı: Entegrasyon, canlı şirketin bir kopyası ya da test şirketi üzerinde denenir. Normal sipariş, iptal, iade, kısmi sevkiyat, kampanyalı ürün ve farklı KDV oranlı sepet gibi senaryolar ayrı ayrı çalıştırılır.
4. Canlıya geçiş: Geçiş, sipariş yoğunluğunun düşük olduğu bir döneme planlanır. İlk günlerde otomatik oluşan kayıtlar elle kontrol edilir; gerekirse bir süre yalnızca tek kanal açılır.
5. İzleme: Hata listesi, aktarım süreleri ve stok farkları düzenli olarak gözden geçirilir. Logo ya da e-ticaret tarafında yapılan sürüm güncellemelerinden sonra temel senaryolar yeniden test edilir.

Sık yapılan hatalar#

• Ürün kodu eşleşmesini sona bırakmak: Sitedeki stok kodu ile Logo'daki malzeme kodu farklıysa ya da varyantlar Logo'da ayrı kart olarak tanımlı değilse, entegrasyon yanlış ürünü düşer. Eşleştirme işi teknik geliştirmeden önce bitirilmelidir.
• KDV ve iskonto farklarını gözden kaçırmak: E-ticaret tarafında fiyatlar genellikle KDV dahil, Logo'da ise KDV hariç tutulabilir. Sepet indirimi, kupon ve kargo bedelinin satırlara nasıl dağıtılacağı netleşmezse fatura toplamı ile tahsil edilen tutar arasında kuruş farkları çıkar.
• Çift kayıt: Ağ kesintisi ya da zaman aşımı sonrası yeniden deneme, aynı siparişin iki kez oluşmasına yol açabilir. Dış sipariş numarasıyla mükerrer kontrolü bu yüzden şarttır.
• Her siparişte yeni cari açmak: Kısa sürede yönetilemez bir cari listesi oluşur. Cari politikası en başta belirlenmelidir.
• İade ve iptalleri düşünmemek: Yalnızca başarılı siparişleri kapsayan bir entegrasyon, iade geldiğinde elle düzeltme gerektirir ve stokları bozar.
• Veritabanına doğrudan yazmak: Kısa yoldan sonuç verir gibi görünür ama Logo'nun iş kurallarını atladığı için ileride düzeltilmesi zor tutarsızlıklar bırakır.

Nereden başlamalı?#

En iyi başlangıç, bugün elle yapılan işlerin listesini çıkarmak ve her birine harcanan zamanı yazmaktır. Çoğu işletmede sipariş aktarımı ve stok güncellemesi bu listenin başında yer alır. Önce bu iki akışı sağlam kurmak, ardından tahsilat ve banka eşleştirmesine geçmek riski azaltır. Süreçlerinizi otomasyon açısından nasıl değerlendirebileceğinize dair genel yaklaşımımızı Bursa'da yapay zeka ve otomasyon rehberimizde anlattık.

Logo ile e-ticaret siteniz ya da pazaryeri mağazalarınız arasında bir entegrasyon ihtiyacınız varsa, mevcut sürecinizi birlikte değerlendirmek için iletişim sayfamızdan bize ulaşabilirsiniz. Diğer çözümlerimizi hizmetler sayfamızda inceleyebilirsiniz.

Sık Sorulan Sorular#

Logo entegrasyonu için hangi Logo ürününü kullanmam gerekir?#

Entegrasyon Logo Tiger, Logo Go ve j-Platform gibi farklı ürünlerle yapılabilir; ancak hangi arayüzlerin kullanılabildiği ürüne, sürüme ve lisansa göre değişir. Başlamadan önce kurulumunuzda hangi servislerin açık olduğunu Logo iş ortağınızla teyit etmeniz gerekir.

Hazır entegratör mü, özel geliştirme mi daha uygun?#

Kanal sayınız az, ürün yapınız ve iş akışınız standartsa hazır entegratör genellikle daha hızlı ve ekonomiktir. Özel fiyat kuralları, karmaşık varyant ya da depo yapısı ve birden fazla kanalın tek noktadan yönetilmesi gerekiyorsa özel bir ara katman daha esnek olur.

Stok ne sıklıkla güncellenmeli?#

Satış hızınıza bağlıdır. Hızlı satan ürünlerde birkaç dakikalık aralıklar ya da değişiklik anında tetiklenen güncelleme tercih edilir. Yavaş dönen ürünlerde daha seyrek güncelleme yeterli olabilir. Kritik ürünlerde güvenlik stoku bırakmak aşırı satış riskini azaltır.

Entegrasyon e-Fatura ve e-Arşiv faturayı da keser mi?#

Entegrasyon faturanın Logo'da doğru verilerle oluşmasını sağlar; belgenin e-Fatura ya da e-Arşiv olarak gönderilmesi ise genellikle Logo'nun e-dönüşüm çözümü veya kullandığınız özel entegratör üzerinden yürür. Akışın tamamı birbirine bağlanabilir, ancak e-belge kurallarını mali müşavirinizle birlikte gözden geçirmeniz önerilir.

Logo banka entegrasyonu e-ticaret entegrasyonundan farklı mı?#

Amaçları farklıdır. E-ticaret entegrasyonu stok, fiyat ve sipariş akışını yönetir; banka entegrasyonu ise banka hareketlerini Logo'ya aktarıp tahsilatları ilgili cari ve siparişlerle eşleştirir. İkisi birlikte kurulduğunda siparişten tahsilata kadar olan süreç uçtan uca izlenebilir hale gelir.

Aynı siparişin iki kez aktarılmasını nasıl önleriz?#

Her siparişin e-ticaret tarafındaki numarası Logo'daki kayıtla birlikte saklanır ve her aktarımdan önce bu numaranın daha önce işlenip işlenmediği kontrol edilir. Hata sonrası yeniden denemeler de aynı kontrolden geçtiğinde çift kayıt oluşmaz.