KodDeltaRehberler

Logo Entegrasyonu Nasıl Yapılır?

~10 dk okuma

Logo entegrasyonu üç yoldan kurulur: Logo REST servisi, Logo Objects üzerinden bağlantı ve doğrudan veritabanı okuma. Yeni kayıt yazacaksanız REST servis veya Objects kullanılır; sadece rapor okuyacaksanız veritabanı yeterlidir. Tek yönlü bağlantı 80.000 - 150.000 ₺ bandında 2-4 haftada kurulur.

Logo entegrasyonu üç yoldan kurulur: Logo REST servisi, Logo Objects üzerinden bağlantı ve doğrudan veritabanı okuma. Yeni kayıt yazacaksanız ilk ikisi kullanılır; yalnız rapor okuyacaksanız veritabanı yeterlidir. Mevcut kurulumunuza dokunmayan tek yönlü bağlantı 80.000 - 150.000 ₺ bandında, 2-4 haftada devreye girer.

Logo kullanan şirketlerin çoğu programı değiştirmek istemiyor. İstedikleri şey Logo’nun karşılamadığı bir süreci — atölye takibi, saha servisi, bayi siparişi, teklif hazırlama — ayrı bir yerde çalıştırmak ve iki sistemin aynı veriyi konuşmasını sağlamak. Bu doğru bir yaklaşım: muhasebe tarafı oturmuş bir kurulumu bozmadan, eksik olan yeri tamamlamak hem ucuz hem düşük riskli.

Üç bağlantı yolu ve hangisinin ne zaman doğru olduğu

YöntemNe yapabilirNe zaman doğruRiski
Logo REST servisiKayıt okur ve yazar; token ile kimlik doğrular, JSON konuşurModern bağlantı; sipariş, fatura, cari kaydı yazacaksanızSunucuda servisin kurulu ve lisanslı olması gerekir
Logo Objects (LOBJECTS)Logo'nun kendi iş kurallarını çalıştırarak kayıt oluştururREST servisin kapsamadığı işlemler; Windows tarafında çalışan bileşenlerGeliştirme ortamı ve sürüm bağımlılığı
Doğrudan veritabanı okumaTablolardan veri okurRapor, stok miktarı sorgusu, cari bakiye görüntülemeYazma işlemi için uygun değil; şema değişikliğinden etkilenir

Logo REST servisi, Logo Objects’in yeteneklerini web arayüzü üzerinden sunar; teknik olarak ikisi birbirinden bağımsız değildir. Servisin kurulumu, kullanıcı tanımı ve token alma akışı için Logo’nun kendi dokümantasyonu ve Logo REST servis rehberi gibi kaynaklar başlangıç noktasıdır; kurumsal kurulumda Logo iş ortağınızla birlikte doğrulayın.

Pratikte çoğu projede ikisi birlikte kullanılır: canlı stok ve bakiye sorguları veritabanından okunur (hızlı ve yük bindirmez), kayıt oluşturma REST servis üzerinden yapılır (Logo’nun kendi kuralları çalışır).

Firma ve dönem numarası: en sık yapılan hata

Logo veritabanında tablo adları firma ve dönem numarasını taşır. Aynı stok kartı listesi iki farklı firmada iki farklı tabloda durur; aynı fatura verisi farklı mali dönemlerde ayrı tablolarda birikir.

Entegrasyonu yazarken bu iki numara koda gömülmemeli, ayar ekranından girilmeli. Aksi halde şu iki senaryo sessizce patlar:

  • Şirket ikinci bir firma açar, entegrasyon hâlâ birinci firmayı okur ve kimse fark etmez
  • Yeni mali döneme geçilir, entegrasyon eski dönem tablosunu okumaya devam eder ve rapor boş gelir

İkinci senaryo yıl başında olur ve genelde ocak ayının ikinci haftasında “sistem çalışmıyor” diye bildirilir. Ayar ekranındaki tek bir alan bu sorunu tamamen ortadan kaldırır.

Kart eşleştirme: projenin gerçek zorluğu

Bağlantı kurmak teknik bir iştir ve öngörülebilir sürede biter. Süreyi uzatan şey, iki sistemdeki kartların birbirine eşleşmemesidir.

Cari kartlar. Sizin sisteminizde müşteri “Yılmaz Metal”, Logo’da “YILMAZ METAL SAN.TİC.LTD.ŞTİ”. Aynı müşterinin Logo’da iki kartı olabilir. Eşleştirme vergi kimlik numarası üzerinden kurulur; vergi numarası boş olan kartlar elle eşleştirilir. Kurulumdan önce Logo’daki cari kartlarda vergi numarası doluluk oranını ölçün — bu tek sayı, projenin ne kadar süreceğini büyük ölçüde söyler.

Stok kartları. Kod yapısı iki tarafta farklıysa eşleştirme tablosu gerekir. Ölçü birimi de eşleşmelidir: Logo’da “AD” olan birim sizin sisteminizde “adet” ise dönüşüm tablosuna yazılır. Çarpan gerektiren birimler (koli = 12 adet) ayrıca tanımlanır.

Depo ve ambar. Logo’daki ambar numaraları ile sizin depo tanımlarınız eşleşmelidir; aksi halde stok hareketi yanlış ambara yazılır ve fark ancak sayımda görünür.

Muhasebe kodları. Fatura ve hareket yazacaksanız hangi kaydın hangi muhasebe koduna gideceği önceden tanımlanmalıdır. Bu tabloyu mali müşavirinizle birlikte yazın; yazılımcı bu kararı veremez.

Aynı eşleştirme mantığı diğer ticari programlarda da geçerli; Netsis REST API, Mikro entegrasyonu, DİA Web Servis API, SAP Business One Service Layer, Nebim V3 Entegratör ve Paraşüt API yazılarında marka bazlı farkları ayrı ele aldık.

Tipik akışlar: hangi veri hangi yöne gider

Projelerin büyük çoğunluğu şu dört akıştan birini ya da birkaçını kuruyor.

1. Sipariş → Logo. Bayi portalınızdan veya saha satış ekranınızdan gelen sipariş Logo’ya sipariş kaydı olarak yazılır. Muhasebe hiçbir şeyi elle girmez. Bu akışın nasıl kurulduğunu bayi sipariş sistemi kurulumu yazısında anlattık.

2. Üretim → Logo. Atölyede tamamlanan iş emri, sarf edilen hammadde ve üretilen mamul olarak Logo’ya işlenir. Burada dikkat edilecek nokta şu: üretim kaydı gün içinde onlarca kez oluşur; Logo’ya her seferinde yazmak yerine vardiya sonunda toplu yazmak hem hızlı hem daha az hataya açık.

3. Logo → sizin sisteminiz (stok ve bakiye). Saha ekibi teklif hazırlarken güncel stok ve müşterinin bakiyesi görünsün isteniyor. Bu tek yönlü okumadır ve veritabanı sorgusuyla yapılır. Sorgunun canlı sisteme yük bindirmemesi için okunan alanlar sınırlı tutulur ve sonuç kısa süreli önbelleğe alınır.

4. Logo → sizin sisteminiz (kart senkronu). Yeni açılan cari ve stok kartları gece bir kez sizin sisteminize aktarılır. Kartların tek yerden açılması kuralı baştan konmalı; iki yerden de kart açılabilen kurgular altı ay içinde mükerrer kayıt üretir.

Kurulum planı

Hafta 1 — Erişim ve envanter. REST servis kurulumu doğrulanır, kullanıcı ve yetki tanımlanır, test veritabanı hazırlanır. Aynı hafta cari ve stok kartlarındaki eşleşme oranı ölçülür.

Hafta 2 — Eşleştirme tabloları. Cari, stok, birim, depo ve muhasebe kodu eşleştirmeleri yazılır. Bu adım mali müşavir ve muhasebe ekibiyle birlikte yapılır; yazılım tarafı burada sadece tabloyu doldurur.

Hafta 3 — Tek yönlü akış. İlk akış kurulur ve test ortamında 30-50 gerçek kayıtla denenir. Hata durumunda ne olacağı burada tanımlanır: kayıt kuyrukta bekler mi, uyarı mı üretir, kim müdahale eder?

Hafta 4 — Paralel çalışma ve canlı. Bir hafta hem elle hem sistemden giriş yapılır, iki kayıt karşılaştırılır. Fark sıfırlandığında elle giriş kapatılır.

Devreye alma kontrol listesi

  • Logo sürümü ve modül lisansları yazılı olarak doğrulandı
  • REST servis kurulu mu, lisansı var mı — Logo iş ortağından teyit alındı
  • Firma ve dönem numarası ayar ekranından girilebilir hale getirildi
  • Cari kartlarda vergi kimlik numarası doluluk oranı ölçüldü
  • Stok kodu ve birim eşleştirme tablosu hazırlandı, çarpanlı birimler tanımlandı
  • Ambar/depo eşleşmesi doğrulandı
  • Muhasebe kod eşleştirmesi mali müşavirle birlikte yazıldı
  • Hata durumunda kaydın nereye düşeceği ve kimin bakacağı belirlendi
  • Mükerrer yazma koruması test edildi (bağlantıyı bilerek koparıp deneyin)
  • Test veritabanı canlıdan ayrı, gerçek veri kopyasıyla hazırlandı
  • Logo sürüm geçişi öncesi entegrasyon testinin kimin görevi olduğu yazıldı

Logo’yu değiştirmek mi, yanına yazmak mı

Dürüst karşılaştırma:

KriterLogo’yu değiştirmekLogo’yu bırakıp yanına yazmak
Muhasebe ekibinin öğrenme yüküYüksek; ekran ve alışkanlık değişirYok; aynı ekranı kullanır
Mali müşavir uyumuYeni programa uyum gerekirDeğişmez
Geçmiş veriTaşınmalı, denetim riski taşırYerinde kalır
SüreAylarHaftalar
Eksik sürecin çözülmesiYeni programın kapsamına bağlıDoğrudan sizin sürecinize göre yazılır
RiskMuhasebe kesintisiYalnız yeni modül etkilenir

Bu tablo, Logo’nun kötü olduğunu söylemiyor. Logo cari, stok ve muhasebe tarafında oturmuş bir kurulum sunuyor; sorun, her şirketin kendine özgü sürecinin paket programın alanlarına sığmamasından çıkıyor. Paketin yetmediği yeri paketi değiştirerek çözmek çoğu şirkette gereksiz maliyet üretiyor.

Paket ve özel yazılım kararını daha geniş çerçevede özel yazılım ve hazır paket karşılaştırması yazısında ele aldık. Genel entegrasyon yaklaşımımız entegrasyon sayfasında, çalıştığımız iş tipleri vakalar sayfasında.

Performans: canlı Logo veritabanını yormamak

Entegrasyonların canlıda çıkardığı en yaygın sorun hata değil, yavaşlıktır. Muhasebe ekibi “Logo ağırlaştı” der ve şüphe entegrasyona düşer. Çoğu zaman haklıdırlar.

Sebep üç şeyden biri oluyor.

Gereğinden geniş sorgu. Stok miktarını görmek için tüm hareket tablosunu tarayan sorgular, tablo büyüdükçe yavaşlar. Yalnız ihtiyaç duyulan alanları ve tarih aralığını okuyun.

Çok sık sorgu. Saha ekranı her açıldığında canlı bakiye sorgulayan kurgular, 20 temsilcide dakikada onlarca sorgu üretir. Çözüm kısa ömürlü önbellek: bakiye 60-120 saniye saklanır, o sürede tekrar sorulmaz. Bakiyenin iki dakikalık gecikmesi hiçbir kararı bozmaz.

Yanlış zamanda toplu iş. Gece çalışması gereken kart senkronu mesai saatinde çalışırsa muhasebenin en yoğun anına denk gelir. Toplu işler için saat penceresi tanımlayın.

Pratik önlem listesi:

  • Okuma işlemleri mümkünse canlı veritabanı yerine raporlama kopyası üzerinden yapılır
  • Sık sorulan alanlar için kısa ömürlü önbellek kullanılır
  • Toplu aktarımlar mesai dışına alınır
  • Sorgu süreleri kaydedilir; belirli eşiği aşan sorgu uyarı üretir
  • Entegrasyonun kendi kullanıcı hesabı olur, böylece yükün kaynağı Logo tarafında görünür

Son madde çoğu projede atlanıyor. Entegrasyon muhasebe kullanıcısının hesabıyla bağlandığında yükün kaynağını ayırt etmek imkânsız hale gelir ve sorun yaşandığında suçlu aranır.

Kapsam ve bant

KapsamNe içerirBantSüre
Tek yönlü bağlantıTek akış (örneğin sipariş veya üretim kaydı yazma), eşleştirme tabloları, hata kuyruğu80.000 - 150.000 ₺2-4 hafta
İki yönlü kurguCanlı stok/bakiye okuma, kart senkronu, çoklu akış, kuyruk ve yeniden deneme mantığı200.000 - 400.000 ₺4-8 hafta
Çok firmalı kurguBirden çok Logo firması, dönem yönetimi, konsolide rapor, yetki ayrımı500.000 ₺+3-6 ay
Ek modülYeni akış, yeni belge tipi, ek rapor8.000 - 45.000 ₺—

Barındırma ilk yıl dahildir, sonrasında 4.800 veya 9.600 ₺/yıl. Yıllık bakım isteğe bağlıdır (%12, %18, %25). Lisans ömür boyudur ve kaynak kod size teslim edilir; entegrasyon kodunu başka bir ekibe devretmek isterseniz devredebilirsiniz. Bantların tamamı fiyat sayfasında.



İlgili Üretim Rehberleri ve Hesaplayıcılar

Logo'da hangi süreç eksik kalıyor?

Hangi verinin hangi yöne akması gerektiğini birlikte çıkaralım; bağlantı yöntemini o akış belirlesin.

Logo Entegrasyonu İçin Teklif Alın →

Sıkça sorulan sorular

Logo'yu değiştirmeden yanına program yazdırabilir miyim?

Evet, en yaygın kurgu bu. Logo muhasebe, cari ve stok tarafında kalır; üretim takibi, saha servisi, teklif motoru veya bayi portalı gibi Logo'nun karşılamadığı süreç ayrı yazılır ve iki sistem birbirine bağlanır. Muhasebe ekibinizin ekranı değişmez, Logo lisansınız yerinde kalır.

Doğrudan veritabanına yazmak doğru mu?

Okumak için sorun yok, yazmak için değil. Logo'nun kayıt oluştururken yaptığı iş tek tabloya satır eklemekten ibaret değildir: bağlı hareket kayıtları, bakiye güncellemeleri ve numaralama zinciri birlikte işler. Bunları elle taklit eden entegrasyonlar ilk aylarda çalışır, sonra bakiye tutmaz. Yazma işini REST servis veya Objects üzerinden yapın.

Firma ve dönem numarası neden önemli?

Logo veritabanında tablolar firma ve dönem numarasıyla adlandırılır; aynı verinin farklı firmalarda ve farklı mali dönemlerde ayrı tabloları vardır. Entegrasyonu tek firma ve tek dönem varsayarak yazan sistemler yıl dönümünde sessizce boş veri döndürmeye başlar. Firma ve dönem numarası ayarlanabilir bir alan olmalı, koda gömülmemeli.

Logo sürümü güncellendiğinde entegrasyon bozulur mu?

REST servis veya Objects üzerinden kurulan bağlantılar sürüm geçişlerinde genelde ayakta kalır; doğrudan tablo okuyan entegrasyonlar ise şema değişikliğinden etkilenebilir. Pratik önlem şu: her sürüm geçişinden önce test ortamında entegrasyonu bir kez çalıştırın ve kritik alanları karşılaştırın. Bu, yarım günlük iştir ve canlıda bir haftalık sorunu önler.

Kaç günde bağlanır?

Tek yönlü aktarım — örneğin sizin sisteminizde oluşan sipariş veya üretim kaydının Logo'ya yazılması — 2-4 hafta sürer. İki yönlü çalışan, cari bakiyesi ve stok miktarını canlı okuyan kurgular 4-8 hafta. Süreyi belirleyen şey bağlantı değil, iki taraftaki kart eşleştirmesinin ne kadar dağınık olduğudur.

İlgili rehberler

Hizmet sayfası: Entegrasyon hizmeti

Mevcut muhasebe ve ERP entegrasyonunu netleştirelim.

Logo, Netsis, Mikro, Vega: hangi veri, hangi yön, ne kadar sürede? 30 dakikada yol haritası.