Logo ERP Entegrasyonu: E-Ticaret, B2B ve Saha Uygulamalarını Bağlama Rehberi

Logo ERP, şirketin muhasebe, stok, cari, satın alma ve satış süreçlerini yöneten ana sistemdir. Ancak satışın büyük kısmı artık ERP ekranında değil; e-ticaret sitesinde, pazaryerlerinde, bayilerin kullandığı B2B portalda ya da plasiyerin tabletinde gerçekleşir. Entegrasyon, bu sistemlerin Logo ile insan eli değmeden, kurallı ve izlenebilir biçimde veri alışverişi yapmasıdır.

Entegrasyon olmadığında aynı veri birden fazla yere elle girilir. Siparişler Excel'e aktarılıp Logo'ya tek tek işlenir, stok sayıları günde bir kez güncellenir, bayi fiyat listesi e-postayla gönderilir. Sipariş hacmi arttıkça bu yöntem hem personel zamanını tüketir hem de hata üretir: stokta olmayan ürün satılır, yanlış fiyattan fatura kesilir, aynı müşteri üç farklı cari kartla açılır.

İyi bir entegrasyon yalnızca "veri taşımak" değildir. Hangi verinin sahibinin kim olduğunu (master), hangi yönde ve ne sıklıkla aktığını, hata olduğunda ne yapılacağını ve kimin haberdar edileceğini tanımlar. Aşağıdaki araç tam olarak bu tasarımı yapmanıza yardım eder.

Kullandığınız ya da planladığınız sistemleri seçin, her biri için taşınacak veri nesnelerini işaretleyin. Diyagram veri yönünü (ok yönü), senkronizasyon tipini (anlık / zamanlanmış) canlı çizer; altındaki tabloda her akış için önerilen yön ve sıklık, yanında tek doğruluk kaynağı önerisi ve haritanıza özel risk uyarıları çıkar. Sıklıklar başlangıç için örnek değerlerdir; sipariş hacminize ve Logo ürününüze göre ayarlanmalıdır.

Logo ile dış sistemleri konuşturmanın birkaç yolu vardır ve seçim, projenin güvenliğini ve bakım maliyetini yıllarca belirler. Logo ürün ailesinde dış uygulamaların veri yazması için resmî katmanlar bulunur: Tiger ve Go 3 tarafında uzun süredir kullanılan Logo Objects kütüphanesi ve bu yetenekleri HTTP üzerinden sunan REST servisleri; Netsis tarafında ise NetOpenX gibi kendi entegrasyon arayüzleri. Hangisinin hangi özellikleri desteklediği ürüne, sürüme ve lisansa göre değişir.

Bu katmanlar, bir faturayı kaydederken Logo'nun kendi iş kurallarını (belge numaralama, stok hareketi, cari bakiye, KDV hesabı) çalıştırır. Bu yüzden veri yazarken tercih edilmesi gereken yol budur. Daha karmaşık senaryolarda bu katmanların önüne bir ara katman (middleware) konur: kuyruk, log, eşleme tabloları ve tekrar deneme mantığı orada yaşar. Kendi API geliştirme altyapınız varsa ara katman genellikle onun bir parçası olur.

Her veri aynı hızda akmak zorunda değildir. Anlık (olay tabanlı) senkronda bir olay gerçekleştiği anda, çoğu zaman bir webhook ile karşı sisteme haber verilir: müşteri ödemeyi tamamladı, sipariş Logo'ya gitsin. Zamanlanmış (periyodik) senkronda ise bir iş belirli aralıklarla çalışır, son çalışmadan bu yana değişen kayıtları toplar ve toplu gönderir.

Pratik kural şudur: bir kez olan ve kaybolmaması gereken olaylar (sipariş, ödeme, iptal) anlık; sürekli değişen durumlar (stok miktarı, fiyat listesi, bakiye) zamanlanmış akar. Stoğu her satış hareketinde tek tek göndermek hem Logo'yu hem pazaryeri API limitlerini zorlar; 5–15 dakikalık toplu güncelleme ile kritik stok eşiğinde anlık tetik birlikte kullanıldığında çoğu işletme için dengeli bir sonuç verir.

Entegrasyon projelerinin en çok zaman alan kısmı kod değil, veri eşleştirmedir. E-ticaret sitesinde "TSH-001-M-SYH" olarak duran varyantın Logo'daki malzeme kodu farklıdır; site fiyatı KDV dahil tutarken Logo satırı KDV hariç hesaplar; pazaryeri "adet" satar ama depo "koli" sayar. Bu farklar bir eşleme tablosunda tek tek karara bağlanmazsa her fatura bir sürpriz olur.

Aşağıdaki sekmelerde en sık karşılaşılan eşleme başlıklarını örnek değerlerle görebilirsiniz. Değerler temsilidir; sizin kod yapınız ve Logo parametreleriniz farklı olacaktır. Tablonun altındaki şablonu kopyalayıp kendi projenizde başlangıç noktası olarak kullanabilirsiniz.

{
  "channel": "eticaret",
  "external": { "sku": "TSH-001-M-SYH", "barcode": "8690000000017" },
  "logo": {
    "itemCode": "TS.001.M.S",
    "unit": "AD",
    "unitFactor": 1,
    "warehouse": 1,
    "vatRate": 20,
    "priceIncludesVat": false
  },
  "stock": { "safetyStock": 2, "reserveOpenOrders": true },
  "owner": { "price": "logo", "stock": "logo", "content": "channel" },
  "updatedBy": "veri-sorumlusu",
  "updatedAt": "2026-09-17T10:00:00+03:00"
}

Logo stok senkronizasyonunda en pahalı hata, aynı son ürünün iki kanalda birden satılmasıdır. Örneğin Logo'da 3 adet kalan bir ürün, 10 dakikalık güncelleme aralığında hem sitede hem pazaryerinde satılabilir. Sipariş Logo'ya düştüğünde stok eksiye iner, iptal ve müşteri memnuniyetsizliği kaçınılmaz olur.

Çözüm üç katmanlıdır. Birincisi, stoğun tek sahibi Logo'dur; hiçbir kanal kendi stok sayısını tutmaz, yalnız Logo'dan gelen "satılabilir stok" değerini gösterir. İkincisi, satılabilir stok hesabında Logo'ya işlenmiş ama sevk edilmemiş açık siparişler düşülür. Üçüncüsü, kanal başına küçük bir emniyet stoğu bırakılır; güncelleme aralığındaki gecikme bu tampondan karşılanır.

Sipariş hacmi yüksek, stok derinliği az olan işletmelerde bu yeterli olmayabilir. O durumda sipariş kanalda oluştuğu anda ara katmanda bir rezervasyon yapılır ve diğer kanalların satılabilir stoğu bir sonraki senkronu beklemeden düşürülür. Bu yaklaşım, ara katmanın neden bir lüks değil ihtiyaç olduğunu da gösterir.

Entegrasyon ilk gün çalışır; asıl soru üçüncü ayda, Logo sunucusu güncelleme için kapatıldığında ne olacağıdır. Sağlıklı bir yapıda her aktarım önce bir kuyruğa yazılır. Kuyruktaki iş Logo'ya gönderilir; başarısız olursa hata türüne bakılır. Bağlantı kopması, zaman aşımı veya kayıt kilidi gibi geçici hatalarda iş artan aralıklarla (ör. 1 dk, 5 dk, 30 dk) yeniden denenir.

Tanımsız stok kodu, eksik vergi numarası veya kapalı cari gibi veri hatalarında tekrar denemek işe yaramaz. Bu işler "bekleyenler" kuyruğuna alınır ve sorumlu kişiye bildirim gider; veri düzeltildiğinde iş tek tıkla yeniden oynatılır. Böylece hiçbir sipariş sessizce kaybolmaz.

Tekrar denemenin güvenli olması için entegrasyonun idempotent olması gerekir: aynı mesaj iki kez işlense bile sonuç tek kayıttır. Bunun en basit yolu, kanal sipariş numarasını Logo belgesinde saklamak ve yazmadan önce bu numarayla kayıt olup olmadığını kontrol etmektir.

Türkiye'de fatura ve irsaliye büyük ölçüde elektronik düzende düzenlenir. Alıcı e-Fatura sistemine kayıtlıysa belge e-Fatura olarak, kayıtlı değilse (ör. bireysel müşteri) e-Arşiv fatura olarak düzenlenir. Belgeler Gelir İdaresi Başkanlığı (GİB) altyapısına ya GİB'in kendi portalı üzerinden ya da GİB tarafından yetkilendirilmiş özel entegratörler aracılığıyla iletilir; şirketlerin çoğu ERP ile otomatik çalışabilmek için özel entegratör yolunu kullanır. Hangi belgeleri hangi tarihten itibaren elektronik düzenlemeniz gerektiği mükellefiyet durumunuza bağlıdır; güncel yükümlülüğü mali müşavirinizle teyit edin.

Entegrasyon açısından önemli olan zincirin kopmamasıdır: sipariş Logo'da faturaya dönüşür, fatura entegratöre gider, entegratörden gelen durum ve belge kimliği (ETTN) Logo'ya geri yazılır, fatura bağlantısı da e-ticaret sitesine veya pazaryerine iletilir. Aynı zincir sevkiyatta e-İrsaliye ve kargo takip numarası için de geçerlidir. Logo'nun kendi e-dönüşüm çözümleri ile üçüncü taraf entegratörler arasında seçim yaparken bu geri bildirim adımının nasıl çalıştığını mutlaka sorun.

Tedarikçi faturalarında ise yön terstir: gelen e-faturalar entegratörden Logo'ya alım faturası olarak aktarılır. PDF veya taranmış belgelerden veri çıkarma ihtiyacınız varsa şirketlerde yapay zeka kullanımı rehberimizde belge ve fatura veri çıkarımını ilk proje adayı olarak ele aldık.

İyi tasarlanmış bir entegrasyon Logo'yu hissedilir biçimde yavaşlatmaz; kötü tasarlanmış olanı ise muhasebe ekibinin öğleden sonrasını kilitleyebilir. Aşağıdaki başlıklar, canlıya geçmeden önce konuşulması gereken performans ve lisans etkileridir.

ERP entegrasyonu nasıl yapılır sorusunun cevabı kod yazmakla başlamaz. Aşağıdaki akış, orta ölçekli bir e-ticaret veya B2B entegrasyonu için tipik aşamaları gösterir; süreler yalnızca örnektir ve kapsamla birlikte değişir. Projeyi kimin yöneteceğine karar veriyorsanız yazılım firması seçerken dikkat edilmesi gerekenler rehberindeki soruları entegrasyon bağlamında da kullanabilirsiniz.

1. 1
   Keşif ve akış haritasıörn. 1 hfSistem listesi, veri nesneleri, yön ve sıklık kararları, master tablosu.
2. 2
   Veri temizliğiörn. 1–2 hfMükerrer cariler birleştirilir, ürün kodu ve barkod standardı oturur.
3. 3
   Eşleme ve kurallarörn. 1 hfÜrün, KDV, birim, depo ve cari eşleme tablosu imzalanır.
4. 4
   Geliştirme ve testörn. 3–6 hfTest şirketinde (Logo test firması) uçtan uca senaryolar çalışır.
5. 5
   Paralel çalıştırmaörn. 1 hfEski yöntem sürerken entegrasyon sonuçları karşılaştırılır.
6. 6
   Canlıya geçişörn. 1–2 günAçılış stokları ve bakiyeler doğrulanır, eski aktarım kapatılır.
7. 7
   İzleme ve iyileştirmesürekliHata panosu, haftalık mutabakat, yeni kanal ekleme.

Canlıya geçiş öncesi bu listeyi ekibinizle birlikte işaretleyin. İlerlemeniz yan panelde görünür. Liste, kendi projeniz için kopyalanıp kullanılabilecek genel bir şablondur.

Entegrasyonun iki ucu da önemlidir: Logo tarafında doğru parametre ve lisans kurgusu için Logo ERP çözüm ortaklığı, kanal tarafında ise sipariş ve bayi deneyimi için web yazılım geliştirme ve plasiyer uygulamaları için mobil yazılım geliştirme hizmetlerimize göz atabilirsiniz. Saha uygulamasını hangi teknolojiyle yapacağınıza henüz karar vermediyseniz native ve cross-platform mobil uygulama rehberimiz iyi bir başlangıçtır.

Mevcut bir entegrasyonunuz sık hata veriyor ve nereden başlayacağınızı bilmiyorsanız, önce bağımsız bir teknik danışmanlık değerlendirmesiyle akışları, logları ve veri kalitesini inceletin. Benzer entegrasyon çalışmalarımızın genel çerçevesini projeler sayfamızda bulabilir, doğrudan sorularınız için iletişim sayfasından bize ulaşabilir ya da yukarıda çıkardığınız haritayla birlikte Logo entegrasyonu teklifi isteyebilirsiniz.