Veri kaybı ve çift kayıt riskini sıfırlayan kurumsal ERP entegrasyonu yapan firma.

Dağınık Yazılım Adalarından Entegre Kurumsal Veri Omurgasına

Modern işletmelerde finans ve stoklar Logo, Mikro veya SAP üzerinde tutulurken; satışlar Shopify ve Trendyol'da, müşteri ilişkileri Salesforce veya HubSpot'ta, depo operasyonları el terminallerinde, saha servisleri ise mobil uygulamalarda yürütülür.

Bu sistemler birbiriyle konuşmadığında şirket içinde "insan köprüleri" oluşur: çalışanlar siparişleri bir ekrandan okuyup diğer ekrana elle yazar, stok miktarları eşleşmediği için müşteriye olmayan ürün satılır, ay sonlarında ise cari mutabakat ve e-fatura uyumsuzlukları yüzünden yüzlerce saat mesai harcanır.

ERP entegrasyonu yapan firma olarak Appsoni; veritabanı kilitlenmelerini, mükerrer kayıtları ve veri kayıplarını mühendislik yaklaşımıyla çözen kurumsal bir teknoloji ortaklığı sunar.

---

Kurumsal Entegrasyon Mimarisi: Kuyruk Tabanlı ve İşlem Güvenli

ERP sistemleri yüksek yoğunluklu eşzamanlı API çağrıları için tasarlanmamıştır. Doğrudan veritabanına kontrolsüz INSERT sorguları atmak, ERP tablolarının bozulmasına (Database Corruption) ve sistemin kilitlenmesine yol açar.

Appsoni, mikroservis ve kurumsal mesaj kuyruğu (Enterprise Service Bus) mimarisini uygular:

[Harici Sistemler: E-Ticaret / CRM / Pazaryerleri / WMS / Bankalar]
       │ (Webhook / REST JSON API: HTTPS TLS 1.3)
       ▼
[Appsoni API Gateway & Doğrulama Katmanı (Port 443)]
       │ (Redis Idempotency Check: UUID kontrolü ile çift kayıt engelleme)
       ▼
[Mesaj Kuyruğu ve Akış Yöneticisi (RabbitMQ AMQP 0-9-1 / Kafka)]
       │ (Rate Limiting: Saniyede 15 kontrollü işlem paketi)
       ▼
[ERP Konnektör Servisi (Logo Objects LObjects.dll / Mikro COM / SAP BAPI)]
       ├────────────────────────────────────────┐
       ▼                                        ▼
[Kurumsal ERP Veritabanı]             [Hata ve DLQ Kuyruğu (Dead Letter Queue)]
(MS SQL Port 1433 / Oracle / HANA)    (Otomatik Tekrar Deneme + IT Slack Alarmı)

Kritik Entegrasyon Veri Alanları ve Telemetri Şeması

Entegrasyon katmanımızda her veri paketi için tutulan teknik meta veriler:

Veri Alanı	Veri Tipi	Örnek Parametre	Operasyonel Tanım ve Açıklama
entegrasyon_islem_id	UUID	a8b29c41-2026-4401	Her veri paketi için tekil izleme anahtarı
kaynak_sistem_enum	Enum	SHOPIFY_STORE_TR	Verinin doğduğu kaynak platform
hedef_sistem_enum	Enum	LOGO_TIGER_3_ENTERPRISE	Hedef kurumsal ERP sistemi
islem_tipi_kodu	Varchar(32)	SIPARIS_AKTARIMI_FATURA	Sipariş, İrsaliye, Cari Kart veya Stok Güncelleme
erp_firma_kodu	Varchar(8)	001	ERP içerisindeki şirket firma numarası
erp_donem_kodu	Varchar(8)	01	Aktif muhasebe çalışma dönemi
cari_hesap_kodu	Varchar(32)	120.01.PAZARYERI.004	Eşleşen müşteri veya pazaryeri cari hesabı
malzeme_kodu	Varchar(32)	STK-MOTOR-YATAK-08	ERP ana stok malzeme kart kodu
irsaliye_seri_sira_no	Varchar(24)	IRS202600000412	GİB standartlarında e-İrsaliye seri sıra numarası
e_fatura_uuid	UUID	c47b5930-1422-4911	Gelir İdaresi Başkanlığı tekil fatura evrak UUID'si
miktar_ana_birim	Decimal(12,3)	150.000	Birinci ana birim cinsinden net miktar
kdv_orani	Decimal(4,2)	20.00	Satır bazlı yasal KDV vergi oranı
doviz_turu_kodu	Varchar(4)	USD	İşlem döviz cinsi (TL, USD, EUR)
doviz_kuru	Decimal(8,4)	34.2500	ERP'ye işlenen merkez bankası efektif satış kuru
islem_durumu_status	Enum	SUCCESS_COMMITTED	Kuyrukta, İşleniyor, Başarılı veya Hata/DLQ
hata_kodu	Varchar(16)	ERR-STK-YETERSIZ	ERP nesnesinin döndüğü hata sınıfı kodu
hata_aciklamasi	Text	Stok ambarında yeterli bakiye bulunamadı	Hatanın açık Türkçe operasyonel detayı
tekrar_deneme_sayaci	Integer	0	Başarısızlık durumunda otomatik retry sayısı (Max 3)
dead_letter_queue_id	Varchar(32)	DLQ-MSG-2026-9921	Hata kuyruğuna düşen mesajın tekil takip kimliği
islem_zamani_utc	Timestamp	2026-10-18T02:30:00Z	İşlemin kuyruğa girdiği anlık zaman damgası
yanit_suresi_ms	Integer	340	ERP nesnesinin işlemi onaylama süresi (ms)

---

Idempotency ve ACID Güvencesi: Mükerrer Kayıtları Önleme

Entegrasyon projelerinde yaşanan en büyük kriz, bir e-ticaret siparişinin ERP'ye iki kez fatura edilmesi veya stok miktarının mükerrer düşülmesidir. Bu durum genellikle ağ zaman aşımında (Network Timeout) kaynağın işlemi yeniden tetiklemesiyle yaşanır.

Appsoni olarak Redis Idempotency Key katmanını zorunlu kılarız:

1. Gelen her siparişin tekil kimliği (Order_ID + Channel_ID) SHA-256 ile özetlenerek Redis üzerinde TTL (Time To Live: 48 saat) ile kilitlenir.
2. Aynı istek ağ kesintisi nedeniyle ikinci kez gelse dahi, sistem daha önce kaydedildiğini anlar ve ERP'ye mükerrer kayıt açmak yerine önceki başarılı işlem yanıtını döner.
3. İki Fazlı Taahhüt (Two-Phase Commit): Veri ERP'ye yazılırken stok hareketi ve cari hesap fişi tek bir veritabanı transaction bloğunda yürütülür. Biri başarısız olursa tüm işlem geri alınır (Rollback).

Entegrasyon katmanının kuyruğa aldığı örnek JSON sipariş yükü:

{
  "idempotency_key": "IDEMP-SHP-TR-2026-89104",
  "source": "SHOPIFY_STORE_TR",
  "target": "LOGO_TIGER_3",
  "timestamp": "2026-10-18T02:30:15.140Z",
  "payload": {
    "firma_no": 1,
    "donem_no": 1,
    "siparis_no": "ORD-2026-9912",
    "cari_kodu": "120.01.00492",
    "para_birimi": "TRY",
    "kalemler": [
      {
        "stok_kodu": "STK-MOTOR-YATAK-08",
        "miktar": 2,
        "birim_fiyat": 1450.00,
        "kdv_orani": 20.0
      }
    ]
  }
}

---

ERP Özel Nesne Modelleri ve Protokol Desteği

Firma olarak veri tabanına körü körüne SQL INSERT sorgusu yazmak yerine, ERP üreticilerinin onayladığı resmi arayüz kütüphanelerini kullanırız:

• Logo Yazılım (Tiger / GO / Netsis): Logo Objects (LObjects.dll), LBS REST Service ve Netsis NetOpenX kütüphaneleriyle çalışarak tüm ticari kuralların (iskonto hesaplama, cari limit kontrolü, muhasebe kod üretimi) Logo motoru tarafından doğrulanmasını sağlarız.
• Mikro Yazılım (Fly / Jump / V16): Mikro COM API ve doğrudan yetkili SQL görünüm (View) protokolleri üzerinden çalışarak STOK_HAREKETLERI ve CARI_HESAP_HAREKETLERI tablolarında veri tutarlılığı kurarız.
• SAP ERP (ECC / S4HANA): RFC, BAPI (BAPI_SALESORDER_CREATEFROMDAT2) ve OData v4 servisleri üzerinden kurumsal SAP standartlarına tam uyumlu entegrasyon geliştiririz.

---

Proje Metodolojisi ve SLA Garantisi

Proje Aşaması	Yapılan Çalışmalar	Süre	Çıktı ve Garanti
1. Veri ve Akış Analizi	Mevcut ERP tabloları, özel alanlar (UDF) ve API dokümanlarının incelenmesi	4 Gün	Teknik Mimari Dokümanı (TDD)
2. Kuyruk ve Gateway Kurulumu	RabbitMQ, Redis ve Docker konteyner altyapısının devreye alınması	5 Gün	Güvenli Mesajlaşma Omurgası
3. Çift Yönlü Konnektör Geliştirme	Logo Objects / Mikro / SAP API köprülerinin kodlanması	10 Gün	Çalışır Durumda Entegrasyon Servisi
4. Yük Testi ve İstisna Yönetimi	Black Friday simülasyonu, ağ kesintisi ve DLQ hata kurtarma testleri	4 Gün	%99.99 Veri Tutarlılığı Test Raporu
5. Canlıya Geçiş & 7/24 İzleme	Canlı sistem senkronizasyonu, log paneli ve SLA destek başlangıcı	4 Gün	Anahtar Teslim Kurumsal Çözüm

---

ERP Entegrasyonunuzu Güvenilir Mühendislikle Kurun

Sipariş aktarımlarında hata yaşamamak, stoklarınızı tüm kanallarda gerçek zamanlı tutmak ve kurumsal sistemlerinizi geleceğe taşımak için Appsoni entegrasyon ekibiyle görüşün. Sistemlerinizi inceleyelim ve firmanıza özel mimari yol haritasını oluşturalım.