Kısa cevap: üç yol var, kural tek
Bayi portalını ERP'ye bağlamanın üç yolu vardır: üreticinin resmî API ya da servis katmanı, dosya ya da ara tablo aktarımı, doğrudan veritabanı erişimi. Kural şudur: ERP'ye veri yazarken üreticinin iş kurallarından geçen katmanı kullanın, veritabanına doğrudan yazmayın. Okuma için hızlı yöntemler (görünüm, ara tablo) kabul edilebilir; yazma için değil.
Dört ERP'nin kamuya açık belgelerinde görünen resmî katmanlar şöyle:
| ERP | Resmî entegrasyon katmanı | Protokol | Önce netleştirin |
|---|---|---|---|
| Logo Tiger | Logo Objects, Logo REST servisi | COM, REST (JSON) | Sürüm (REST yalnızca Tiger 3 ve Wings serisinde), Objects lisansı |
| Logo Netsis | NetOpenX, Netsis REST API | COM, WCF, REST | NetOpenX lisansı ve ürün sürümü |
| Mikro | Mikro Desktop API | REST (JSON) | API Key lisansı, V16/V17 uyumu, sunucu ve port kurulumu |
| Canias | TROIA Web Services 2.0 | SOAP (WSDL) | Web servis modülünün lisansı, REST'in olmaması |
Bu yazıdaki bilgiler üreticilerin ve entegrasyon firmalarının kamuya açık belgelerinden derlenmiştir; ürün sürümünüz için uygulamaya başlamadan önce üreticiye ya da yetkili iş ortağına teyit ettirin. Hangi ERP ile hangi projeyi yaptığımızı anlatmıyoruz; bu bir seçim ve soru rehberidir.
Bayi portalı ERP'den ne ister?
Hangi veri hangi yöne akar?
Bayi portalı bir ERP'nin yerine geçmez; ERP'deki fiyatı, stoku ve cariyi gösterir, siparişi ERP'ye geri yazar. B2B bayi portalının normal e-ticaretten farklarını B2B bayi portalı nedir yazımızda anlattık; ERP bağlantısı o yazıdaki yedinci farktı. Tipik akış:
| Veri | Yön | Sıklık (bizim önerimiz) |
|---|---|---|
| Stok kartı, fiyat listesi, iskonto | ERP → portal | Zamanlanmış, fiyat değişince |
| Stok miktarı | ERP → portal | Sık (dakikalar), sipariş anında yeniden doğrulama |
| Cari bakiye ve limit | ERP → portal | Sipariş anında okuma |
| Sipariş | Portal → ERP | Anında |
| Sipariş durumu, irsaliye, fatura | ERP → portal | Durum değişince |
Hangi sistem "tek doğru kaynak" olmalı?
Fiyat, stok ve cari ERP'de tutuluyorsa tek doğru kaynak ERP'dir; portal bunları kendi veritabanına kopyalıyorsa kopyanın ne kadar eski olabileceğini baştan belirleyin. Aynı bilgiyi iki yerde elle güncellemek, bayinin güvenini ilk bozan şeydir. Bu bir yorumdur, kaynaklı bir olgu değil.
Yöntem 1: resmî API ya da servis katmanı
Logo Tiger: Objects ve REST
Logo Objects, Logo'nun fiyat listesindeki tanımıyla Tiger için veri aktarım ve entegrasyon aracı, yani sistemlerin Logo ERP'ye bağlanmasında kullanılan standart arayüzdür. Logo REST servisi ise bu Objects'in REST arayüzüdür: Datasource'un anlatımına göre ayrı bir lisansı yoktur, geçerli bir Objects kullanım lisansı gerekir ve yalnızca Tiger 3 ve Wings serisi ürünlerde (Tiger 3, Tiger Wings, Tiger 3 Enterprise, Tiger Wings Enterprise) desteklenir; Logo Start, Go Plus, Go 3, Tiger Plus ve Tiger Enterprise listede desteklenmeyenler arasındadır. Yani önce hangi Logo ürününü ve sürümünü kullandığınızı netleştirin: REST'in olmadığı bir sürümde yol COM tabanlı Objects'tir.
Logo Netsis: NetOpenX ve REST API
Logo'nun Netsis 3 Enterprise ürün sayfası, üçüncü taraf uygulamaların entegrasyonu için NetOpenX ve Netsis REST API'yi sayar. Logo'nun uyarlama araçları fiyat listesine göre NetOpenX lisansı Netsis Wings Enterprise, Netsis Wings, Netsis 3 Enterprise ve Netsis 3 Standard ile kullanılabilir. Logo'nun Netsis uyarlama araçları yardım sayfası da entegrasyon araçlarının WCF, REST ve COM tabanlı olduğunu yazar. Fiyat listesinde Objects ve NetOpenX lisanslarının 1 kullanıcılı olduğu ve uyarlama araçlarının yalnızca ekosistem çözüm geliştirme iş ortaklarınca sipariş edilebildiği yazıyor. Pratik sonuç: entegrasyonu yazacak firmanın bu lisansı alabilen bir iş ortağı olup olmadığını sorun.
Mikro: Mikro Desktop API
Mikro'nun API portalı, Mikro Desktop API'yi REST ve JSON temelli olarak anlatır; hedef kitle olarak Mikro müşterilerini, iş ortaklarını ve üçüncü taraf geliştiricileri sayar, başvuru bir form üzerinden yapılır. Sık sorulan sorular sayfasındaki bilgiler bir bayi portalı projesinde doğrudan işe yarar:
- API yerel sunucuda çalışır ve Active-Active kullanımı desteklemez.
- API bir Windows servisidir; SSL ve port yönlendirmelerini sistem yöneticileri yapar.
- API Key lisansı dikey çözüm kullananlara otomatik atanır, şirket içi yazılımlar için manuel lisans verilir.
- Demo kurulumla 100 kayda kadar test yapılabilir; lisanslı kullanıcılar için test veritabanı açılabilir.
Bunlardan ilki mimariyi etkiler: API sizin şirket içi sunucunuzda çalışıyorsa portalın ona internetten nasıl, hangi güvenlik katmanıyla ulaşacağı ayrı bir tasarım kararıdır.
Canias: TROIA Web Services 2.0
Canias'ı geliştiren IAS'ın kendi GitHub deposundaki troia-webservice-connector örneği, TROIA platformuna web servis 2.0 ile bağlanmayı gösterir: bir WSDL adresine bağlanılır, oturum açılır (login), servis çağrılır (callService) ve oturum kapatılır. Yani arayüz oturum tabanlı bir SOAP servisidir. Pexon'un incelemesine göre belgelenmiş bir REST API yoktur ve web servis modülünün (WSR) lisans koşulları herkese açık değildir; lisans için IAS'a ya da Canias iş ortağınıza sormak gerekir. Bir bayi portalı bu SOAP servisleriyle konuşabilir, ama o servisleri (fiyat, stok, sipariş) TROIA tarafında kimin yazacağını teklif aşamasında netleştirin.
Yöntem 2: dosya ya da ara tablo aktarımı
Resmî API'nin lisansı ya da sürümü uygun değilse, ERP'nin dışa aktardığı dosya (CSV, XML) ya da ERP'ye bağlı bir ara tablo kullanılabilir. Bu yöntemin gerçek maliyeti gecikmedir: fiyat ve stok dosya çalıştığı anda güncellenir, arada eski kalır. Sipariş yönünde dosyayı ERP'nin kendi içe aktarma aracı okuyorsa kayıtların ERP'nin kontrollerinden geçmesi beklenir; bunu üreticiye sorun. Bu yöntemi bir ara çözüm olarak düşünün ve stok doğrulamasını sipariş anında API ya da sorguyla yapmanın mümkün olup olmadığına bakın (bizim önerimiz).
Yöntem 3: doğrudan veritabanı
Veritabanına doğrudan yazmak neden riskli?
Entegrasyon firmalarının kendi rehberlerinde bu uyarı sık geçer: i-Pazaryeri'nin rehberi, Logo'da doğrudan SQL erişiminin performans avantajı sağladığını ama Logo'nun iş kurallarını (KDV hesabı, stok hareketi tetikleme) atlama riski taşıdığını, üretimde resmî API'nin tercih edilmesi gerektiğini yazar. Aynı yönde, Netsis için hazırlanmış bir entegrasyon sayfasında YK Yazılım yalnızca okuma gereken raporlarda doğrudan SQL görünümleri kullandığını, yazmayı her zaman NetOpenX üzerinden yaptığını söyler. İkisi de satıcı sayfasıdır; üreticinin kendi belgesi değildir, ama yöntem uyumludur. Okuma için görünüm, yazma için resmî katman: bizim de önerdiğimiz denge budur.
Hata, tekrar ve eşzamanlılık
Bir bayi sipariş verir ve ERP o anda erişilemiyorsa sipariş kaybolmamalı, kuyrukta bekleyip sonra aktarılmalıdır. Aynı sipariş iki kez gönderilirse ERP'de çift kayıt oluşmamalıdır (aynı sipariş numarası ikinci kez işlenmez). Bunlar kaynaklı olgular değil, entegrasyon tasarımında genel iyi uygulamadır ve teklifte sorulacak sorulardır: ERP kapalıyken ne olur, tekrar gönderim nasıl çalışır, hata kimin ekranına düşer?
Lisans ve maliyet kalemleri
Entegrasyonun maliyeti yalnızca yazılım ücreti değildir: ERP tarafındaki entegrasyon lisansı (Logo için Objects ya da NetOpenX, Mikro için API Key), geliştirici eğitimi, test ortamı, sunucu ve güvenlik kurulumu ve sonraki bakım ayrı kalemlerdir. Bunların toplamını 5 yıllık düşünmek için ERP fiyatları: 5 yıllık toplam maliyet yazımızdaki boş tabloya bir "entegrasyonlar" satırı olarak yazabilirsiniz. Ürün seçimi aşamasındaysanız İzmir'de ERP firması seçerken 12 soru yazımız entegrasyon sorularını da kapsar.
Teklif istemeden önce 10 soru
| # | Soru |
|---|---|
| 1 | ERP ürününüz ve sürümünüz nedir? Resmî API o sürümde destekleniyor mu? |
| 2 | Entegrasyon için hangi ek lisans gerekiyor, kimden alınıyor? |
| 3 | Fiyat, stok ve cari hangi yönde, ne sıklıkla aktarılacak? |
| 4 | Sipariş ERP'de hangi belge olarak açılacak (sipariş, irsaliye, fatura)? |
| 5 | ERP erişilemezken sipariş kuyruğu nasıl çalışacak? |
| 6 | Aynı sipariş iki kez gönderilirse ne olacak? |
| 7 | ERP sunucusu şirket içindeyse portal ona nasıl güvenli ulaşacak? |
| 8 | Test ortamı ve test verisi kim tarafından, ne zaman hazırlanacak? |
| 9 | ERP sürüm yükseltmesinde entegrasyon kimin sorumluluğunda? |
| 10 | Hata günlüğü ve izleme kimin ekranına düşecek? |
Entegrasyonu özel bir yazılım projesi olarak yaptırmayı düşünüyorsanız özel yazılım geliştirme sayfamıza ve e-ticaret tarafı için e-ticaret hizmet sayfamıza bakabilirsiniz.
Sıkça Sorulan Sorular
Bayi portalı hangi ERP ile çalışır?
ERP'nin dışarıya açtığı bir arayüzü (API, web servis, içe aktarma aracı) varsa bayi portalı ona bağlanabilir. Bu yazıda Logo Tiger, Logo Netsis, Mikro ve Canias için kamuya açık belgelerde görünen katmanları sıraladık; hangisinin sizin sürümünüzde desteklendiğini üreticiye teyit ettirin.
ERP'ye doğrudan veritabanından yazmak güvenli mi?
Entegrasyon firmalarının rehberleri bunu önermiyor: doğrudan yazma ERP'nin iş kurallarını (vergi hesabı, stok hareketi) atlayabilir. Okuma için veritabanı görünümleri kullanılabilir, yazma için üreticinin resmî katmanı tercih edilir.
Entegrasyon için ayrı lisans gerekir mi?
Çoğu durumda evet, ürüne göre değişir. Logo'nun uyarlama araçları listesinde Objects ve NetOpenX ayrı lisanslardır, Logo REST servisi için geçerli bir Objects lisansı gerekir; Mikro API için API Key lisansı gerekir; Canias'ta web servis modülünün lisans koşulları kamuya açık değildir. Teklifte bu satırı ayrı isteyin.
Entegrasyon kaç haftada tamamlanır?
Türkiye için yayımlanmış güvenilir bir süre verisi bulamadık. Süre ERP sürümüne, veri akışı sayısına, test ortamının hazır olmasına ve onay hızınıza bağlıdır; teklifte aşamalı bir plan ve pilot tarihi yazılı isteyin.
Kendi ERP'nize bağlanacak bir bayi portalını birlikte konuşmak isterseniz bizimle iletişime geçin.
Kaynaklar: Mikro Desktop API (Mikro Yazılımevi), Mikro API Süreci, Sık Sorulan Sorular (Mikro Yazılımevi), Logo Netsis 3 Enterprise (Logo Yazılım), Logo uyarlama araçları tavsiye edilen fiyat listesi (Logo Yazılım; Destek Yazılım sitesinde barındırılan kopya, erişim 12 Kasım 2026), Logo REST Servis Kurulumu ve Yapılandırması (Datasource), troia-webservice-connector (IAS, GitHub), Canias ERP connector incelemesi (Pexon, 21 Eylül 2026'ya göre), ERP Muhasebe Entegrasyonu Rehberi (i-Pazaryeri), Logo Netsis Uyarlama Araçları yardım ve destek (Logo Yazılım, Dijital Danışman), Netsis Entegrasyonu (YK Yazılım)
Kapak fotoğrafı: Rifki Kurniawan / Unsplash