Magento 2 ERP ve Muhasebe Entegrasyon Rehberi: Logo, Mikro, Netsis ve SAP Mimarisi

1. Problem: Manuel Excel Aktarımları, Stok Çakışmaları ve Ödeme Anında Çöken Sipariş Akışı

Ölçekli bir e-ticaret veya B2B operasyonu kuran işletmelerde Magento 2 ile şirket içi ERP/muhasebe yazılımları (Logo Tiger/J-Platform, Mikro, Netsis, SAP, Nebim) birbirine doğru mimariyle bağlanmadığında üç kritik operasyon sorunu ortaya çıkar:

1. Stok Uyuşmazlığı ve İptaller: Fiziki depoda tükenen ürün sitede hâlâ satışta kalır; müşteri sipariş verdikten sonra iptal ve iade süreci yaşanır.
2. Senkron Blokaj Riski: Sipariş oluştuğu anda (checkout sırasında) ERP API'sine doğrudan senkron istek atılırsa, ERP sunucusundaki 10 saniyelik bir yavaşlama müşterinin ödeme ekranının zaman aşımına düşmesine ve çift tahsilat riskine yol açar.
3. Çift Kayıt ve İndeks Kilitlenmesi: Binlerce ürünün stok ve fiyat bilgisini her 5 dakikada bir tekil ürün kaydı üzerinden (ProductRepository::save()) güncellemek MySQL satır kilitlemelerine (deadlock) ve reindex darboğazına neden olur.

2. Mimari Yaklaşım: Dayanıklı Middleware, RabbitMQ ve Delta Senkronizasyonu

Sağlıklı bir Magento 2 – ERP entegrasyonu; Magento çekirdeğini kilitlemeden çalışan, hata toleranslı ve izlenebilir bir ara katman (middleware) ve özel modül (YilmazSoft_ErpConnector) üzerine kurulmalıdır.

A. Çift Yönlü Veri Akış Haritası

[ERP (Logo/Mikro/Netsis/SAP)]
   |-- (Delta Stok & Fiyat & Cari Bakiye) --> [Middleware / Bulk Queue] --> [Magento 2 MSI & Catalog]
   
[Magento 2 Checkout (Order Placed)]
   |-- (Domain Event) --> [RabbitMQ Queue] --> [ErpOrderConsumer] --> [ERP Sipariş & İrsaliye API]
                                                  |
                                         (Hata -> Retry / DLQ)

B. Kritik Entegrasyon Kuralları

1. Tekil Kimlik (SKU & Cari Kod Eşlemesi)

Magento entity_id değerleri ortamlar arasında değişebilir; bu nedenle entegrasyonun değişmez anahtarı ürünlerde SKU (veya barkod), B2B müşterilerde ise ERP Cari Hesap Kodu (customer_erp_code) olmalıdır.

2. Sipariş Aktarımında Asenkron Kuyruk (RabbitMQ) ve Idempotency

Sipariş ödeme onayı aldığında müşteri arayüzünü bekletmek yerine kuyruğa hafif bir order_id mesajı bırakılır:

• Idempotency Anahtarı: ERP'ye gönderilen her sipariş paketi Magento'nun benzersiz increment_id değerini taşır. Ağ kopması nedeniyle mesaj tekrar işlense bile ERP tarafında aynı increment_id için ikinci sipariş/fatura oluşturulmaz.
• Dead Letter Queue (DLQ): Geçici ağ kesintilerinde mesaj üstel gecikmeyle (exponential backoff) yeniden denenir; şema veya cari kod eksikliği gibi kalıcı hatalarda ise DLQ'ya alınıp admin panelinde operasyon ekibine alert üretilir.

3. Stok Güncellemesinde ProductRepository::save() Yerine MSI Toplu Yazım

Klasik ürün kaydetme metodu yerine Magento Multi-Source Inventory (SourceItemsSaveInterface) kullanıldığında tüm ürün EAV tabloları değil, yalnızca depo kaynak miktarı güncellenir:

<?php
declare(strict_types=1);

namespace YilmazSoft\ErpConnector\Service;

use Magento\InventoryApi\Api\Data\SourceItemInterfaceFactory;
use Magento\InventoryApi\Api\SourceItemsSaveInterface;

class DeltaStockUpdater
{
    public function __construct(
        private readonly SourceItemInterfaceFactory $sourceItemFactory,
        private readonly SourceItemsSaveInterface $sourceItemsSave
    ) {}

    /**
     * @param array<int, array{sku: string, source_code: string, qty: float}> $changes
     */
    public function applyBatch(array $changes): void
    {
        $sourceItems = [];
        foreach ($changes as $row) {
            $item = $this->sourceItemFactory->create();
            $item->setSku($row['sku']);
            $item->setSourceCode($row['source_code']);
            $item->setQuantity($row['qty']);
            $item->setStatus($row['qty'] > 0 ? 1 : 0);
            $sourceItems[] = $item;
        }

        if ($sourceItems !== []) {
            $this->sourceItemsSave->execute($sourceItems);
        }
    }
}

4. Fiyat ve KDV Tutarsızlığını Önleme

Logo, Mikro ve SAP gibi sistemler genellikle KDV hariç birim fiyat ve kademeli iskonto tutarken son kullanıcı (B2C) vitrini KDV dahil fiyat bekler; B2B bayiler ise KDV hariç + özel cari iskonto görmek isteyebilir. Catalog/Tax kurallarının ve yuvarlama hassasiyetinin (2 ondalık kuruş yuvarlaması) her iki tarafta birebir test edilmesi gerekir.

5. Güvenlik ve Şifreleme

ERP sistemleri çoğu işletmede şirket içi sunucularda (on-premise) barındırılır. Dış dünyaya güvensiz veritabanı portu açmak yerine:

• ERP tarafında IP kısıtlı, TLS/HTTPS üzerinden konuşan hafif bir REST köprüsü (bridge agent) veya Site-to-Site VPN tüneli kurulur.
• Tüm API anahtarları versiyon kontrolü dışında şifreli gizli alanlarda (env.php / secret vault) saklanır.

Magento özel modül geliştirme yaklaşımımızın tamamını Magento 2 Özel Mimari ve Modül Geliştirme Rehberi yazımızda inceleyebilirsiniz.

3. Süre ve Bütçe Aralığı (2026)

4. Sık Sorulan Sorular

Magento 2 ile Logo, Mikro, Netsis veya SAP arasındaki senkronizasyon neden doğrudan HTTP çağrısı yerine kuyruk (RabbitMQ) ile yapılmalıdır?

Sipariş onaylandığı anda ERP servisinin yavaş yanıt vermesi veya geçici bakım penceresinde olması müşterinin ödeme sonrası hata ekranı görmesine neden olur. RabbitMQ tabanlı asenkron kuyruk mimarisi siparişi güvenle kaydeder, arka planda ERP'ye iletir ve geçici hatalarda kontrollü yeniden deneme (retry + DLQ) uygular.

Büyük ürün kataloglarında (10.000+ SKU) fiyat ve stok güncellemesi site hızını bozmadan nasıl yapılır?

Tekil REST istekleri yerine Magento 2'nin async/bulk endpointleri veya MSI SourceItemsSaveInterface toplu yazım katmanı kullanılmalı, sadece değişen kayıtların (delta sync) işlenmesi sağlanmalıdır.

Aynı anda hem mağazadan hem B2B/e-ticaret sitesinden satış yapılırken eksi stok (overselling) nasıl engellenir?

Magento Multi-Source Inventory (MSI) rezervasyon mekanizmasıyla eşzamanlı koruma sağlanır; ERP tarafında da depo bazlı satılabilir stok kuralı uygulanır ve sipariş statüsü geçişlerinde idempotency anahtarı ile çift stok düşümü engellenir.

Magento 2 ERP entegrasyon modülü geliştirme süresi ve bütçesi nedir?

Tek yönlü temel stok/sipariş konnektörleri kapsamına göre özel modül/API bütçesiyle planlanır; kapsamlı e-ticaret ve ERP entegrasyon projeleri Basic ₺49.900 / Pro ₺82.900 (E-Ticaret çekirdek: ₺49.900 – ₺139.900), çift yönlü B2B Bayi Portalı + ERP mimarisi ise ₺74.900 – ₺164.000 (özel ERP yazılımı Enterprise ₺199.000+) aralığındadır.

5. Sonraki Adım: ERP ve E-Ticaret Sistemlerinizi Kusursuz Bağlayın

İlgili hizmetlerimiz ve rehberlerimiz:

• E-Ticaret Sitesi Yaptırma
• Özel Yazılım ve API Entegrasyonu
• B2B Bayi Portalı Yazılımı
• Magento 2 Özel Mimari ve Modül Geliştirme
• API Entegrasyonu Rehberi
• Proje Fiyat Hesaplama

Logo, Mikro, Netsis veya SAP entegrasyon projeniz için teknik keşif randevusu alın:

• Telefon & WhatsApp: 0543 256 97 07
• E-posta: [email protected]
• İletişim: Entegrasyon Teklifi Talep Et