Sistem Entegrasyonu — ERP, E-Fatura, Pazaryeri, Banka ve Saha Cihazı Köprüleri

Aynı bilgiyi kaç kez giriyorsunuz

Bir sipariş geliyor. Satış temsilcisi siparişi kendi listesine yazıyor, muhasebeci aynı satırları programa giriyor, depocu sevkiyat için üçüncü bir tabloya çekiyor, pazaryerinden gelen siparişleri ise biri sabahları panelden indirip elle açıyor. Dört yerde dört kopya var ve hiçbiri diğerinin ne zaman güncellendiğini bilmiyor.

Bunun bedeli genellikle ay sonunda ortaya çıkıyor: stok sayımı programla tutmuyor, cari bakiye müşterinin gönderdiği ekstre ile uyuşmuyor, satış raporundaki adet üretim raporundaki adetten farklı. Tartışma "hangi sayı doğru" diye başlıyor ve kimse cevabı bilmiyor; çünkü sistemlerden hiçbiri o kaydın sahibi olarak tanımlanmamış.

Tek doğruluk kaynağı ne demek

Entegrasyonun teknik değil, kurumsal karar olan kısmı budur. Her kayıt türü için tek bir sahip sistem seçilir: cari kartın sahibi muhasebe programı, stok bakiyesinin sahibi depo sistemi, iş emrinin sahibi üretim sistemi, sipariş durumunun sahibi pazaryeri. Sahip sistem o kaydı üretir ve değiştirir; diğerleri okur ve kendi ekranında gösterir.

Sahiplik yazılı değilse iki sistem birbirini ezer. Müşteri unvanını muhasebeci düzeltir, gece senkronu eski hâlini geri yazar; ertesi gün aynı düzeltme yeniden yapılır. Bu yüzden keşif çalışmasının çıktısında bir sahiplik tablosu bulunur: satırlar kayıt türleri, sütunlar sistemler, hücrede "yazar", "okur" ya da "dokunmaz" yazar. Köprüyü bu tablodan sonra kodluyoruz.

Hangi sistemlerle köprü kuruyoruz

Muhasebe ve ERP

Logo, Mikro, Netsis, SAP ve benzeri programlarda cari kart, stok kartı, stok hareketi, sipariş ve fatura eşitlemesi. Yön ve sahiplik kayıt türüne göre ayrı ayrı tanımlanır.

e-Fatura, e-Arşiv, e-İrsaliye

Entegratör üzerinden giden fatura ve irsaliyenin sistemden üretilmesi, gelen belgenin ayrıştırılıp sipariş ve mal kabul kaydına bağlanması, ret ve iade yanıtlarının işlenmesi.

Pazaryeri ve e-ticaret

Trendyol, Hepsiburada, N11, Amazon, Shopify ve WooCommerce. Sipariş çekme, stok ve fiyat gönderme, kargo bilgisi yazma, iptal ve iade akışı. Ürün eşleşmesi kendi stok kodunuzla pazaryeri kodu arasında kurulan eşleşme tablosuyla yürür; beden-renk gibi iki seviyeli varyantta eşleşme varyant düzeyinde tutulur.

Zor kısım API değil, rezervasyon kuralı: aynı fiziksel stok üç kanalda birden satışa açıldığında miktar ne demektir. Kanal başına ayrılan pay, tahsis sırası ve senkron gecikmesi baştan yazılır; aksi hâlde aşırı satış (oversell) kaçınılmazdır.

Komisyon mutabakatı. Pazaryeri hakediş raporu ile kendi satış kaydınız gece eşleştirilir; komisyon, kargo ve iade kesintileri ayrışır, eşleşmeyen kalem sabah listeye düşer. Ay sonunda elle yapılan mutabakat işi budur.

Banka ve tahsilat

Banka ekstre servisleri ve sanal POS bildirimleri üzerinden gelen hareketlerin cari kayıtla eşleştirilmesi, açıklama alanından fatura numarası okuyup otomatik kapatma, eşleşmeyenin kuyruğa düşmesi.

El terminali, barkod, kantar

Depo el terminalleri ve barkod okuyucularla mal kabul, sayım ve transfer; kantardan okunan brüt ve dara değerinin sevk irsaliyesine doğrudan yazılması. Cihaz çevrimdışıyken kayıt cihazda bekler.

Kargo ve lojistik

Kargo firmalarının servisleriyle gönderi açma, barkod üretme, takip numarasını sipariş kaydına yazma ve teslim bilgisini geri okuma.

Muhasebe ve ERP tarafındaki alan eşleşmelerini ürün bazında ayrı yazılarda ele aldık: Logo entegrasyonu, Mikro entegrasyonu, Netsis REST API, DİA Web Servis API, SAP Business One Service Layer, Nebim V3 Entegratör, Paraşüt API ve e-fatura entegrasyonu.

Dört paketi barındırma, API yolu, lisans ve kontör şartı açısından yan yana koyan karşılaştırma Logo, Mikro, Netsis ve DİA karşılaştırmasında.

Hangi entegrasyon kolay, hangisi zor

Bir köprünün süresini teknoloji değil, iki soru belirler: karşı tarafın belgelenmiş bir arayüzü var mı, ve iki sistemdeki kayıtlar birbirini tanıyor mu. Aşağıdaki tabloyu teklif öncesi kendi sistemleriniz için dolduruyoruz.

Durum	Zorluk	Neden
Belgelenmiş API, tek yön, kimlik ortak	Kolay	Alanlar eşleşir, test ortamı vardır, hata kodları yazılıdır. İş, eşleme ve doğrulamadan ibarettir.
Belgelenmiş API, iki yön	Orta	Aynı kaydı iki taraf da değiştirebildiği için çakışma kuralı gerekir: hangi tarafın değişikliği üstün, hangi alan hangi taraftan gelir.
API var, kimlikler eşleşmiyor	Zor	Sizde stok kodu, karşıda barkod; sizde vergi numarası, karşıda kendi müşteri numarası. Eşleşme tablosu kurulur ve eşleşmeyen kayıt insan önüne düşer.
API yok, veritabanı erişimi var	Orta	Salt okunur görünüm açılır. Okumak güvenlidir; yazmak programın kendi iş kurallarını atlayacağı için tercih edilmez.
API yok, dosya alışverişi var	Orta	Zamanlanmış dosya aktarımı çalışır ama anlıklık kaybolur; gecikme dakikalarla ölçülür ve dosyanın eksik yazılma ihtimali ele alınır.
Yalnız ekran var	Zor	Ekran otomasyonu, program arayüzü değiştiğinde kırılır. Geçici köprü olarak kurar, kalıcı çözümü ayrıca planlarız.

Dört hata senaryosu ve karşılığında ne tasarlıyoruz

Entegrasyon, mutlu günde herkesin yazabildiği bir iştir. Fark, hatanın çıktığı gün ortaya çıkar. Aşağıdaki dört durum sahada en sık karşılaştıklarımız; her birinin karşısında tasarım kararı duruyor.

Uzak sistem kapalı veya yanıt vermiyor

Köprü kaydı doğrudan göndermez, önce kendi kuyruğuna yazar. Karşı taraf yanıt vermezse kayıt kuyrukta bekler, yeniden deneme aralığı her denemede açılır ve karşı sistemi boğmaz. Hat geldiğinde bekleyenler sırasıyla akar. İzleme ekranında kaç kaydın beklediğini ve en eskisinin ne zamandan kaldığını görürsünüz; belirlediğiniz eşik aşılırsa bildirim gider.
Karşı sistem kaydı reddediyor

Vergi numarası tutmuyor, stok kodu bulunamıyor, zorunlu alan boş. Bu tür hatalarda tekrar denemek işe yaramaz; kayıt insan müdahalesi bekler. Reddedilen kayıtlar ayrı bir kuyrukta, karşı tarafın döndüğü hata metniyle birlikte durur. Her hata türünün isimli bir sahibi vardır — cari hataları muhasebeye, stok hataları depoya düşer — ve düzeltilen kayıt tek düğmeyle yeniden gönderilir.
Çift teslim ve çift kayıt

İstek karşı tarafa ulaşıp yanıt dönerken zaman aşımına uğrarsa köprü isteği tekrar dener; oysa kayıt karşıda çoktan oluşmuştur. Bunu engellemek için her aktarıma kendi ürettiğimiz tekil bir anahtar bağlanır ve bu anahtar karşı sistemdeki kayda yazılır. Aynı anahtar ikinci kez geldiğinde yeni kayıt açılmaz, mevcut kayıt döner.
Karşı taraf şemayı değiştiriyor

Sürüm geçtiğinde alan adı değişebilir, zorunlu bir alan eklenebilir. Köprü yalnız kullandığı alanları okur ve tanımadığı alanı yok sayar; yeni alan eklenmesi bu yüzden çalışmayı durdurmaz. Kaldırılan veya adı değişen alan ise aktarımı durdurur, kayıt kuyrukta kalır ve bildirim gider. Sözleşme testlerini gecelik çalıştırıyoruz, böylece değişikliği kayıp yaşanmadan yakalıyoruz.

Nasıl devreye alıyoruz

Yeni bir köprüyü doğrudan canlıya almıyoruz. Önce sizin gerçek verinizle arka planda çalıştırıp çıktısını mevcut yöntemin çıktısıyla karşılaştırıyoruz. İki sonuç birkaç gün üst üste tuttuğunda köprü devreye alınıyor, elle giriş kapatılıyor. Bu ara dönem genellikle bir hafta sürüyor ve devreye alma gününü sıradan bir güne çeviriyor.

Aktarımların zamanı, süresi ve sonucu kayıt altına alınır. Bir müşteri "faturam gelmedi" dediğinde hangi kaydın ne zaman gönderildiğini, karşı tarafın ne yanıt verdiğini ekrandan görürsünüz. Süre ve bedel için: belgelenmiş API'si olan tek yönlü köprüler günler alır; iki yönlü muhasebe ve pazaryeri köprüleri 2-4 haftada devreye girer ve 80.000 - 150.000 ₺ bandındadır. Sonradan eklenen her köprü 8.000 - 45.000 ₺ bandındadır. Ayrıntı fiyat ve süre sayfasında.

Entegrasyonun çözmediği durum

Köprü kurmak, iki tarafın verisi birbirini tanımıyorsa tek başına yetmez. Stok kodlarınız tutarsızsa, aynı müşteri üç ayrı cari kartta duruyorsa veya ürün adları serbest metinse entegrasyon bu dağınıklığı hızlandırarak kopyalar. Böyle bir durumda önce veri temizliği yapılır: kod yapısı belirlenir, mükerrer kartlar birleştirilir, eşleşme tablosu kurulur. Bu iş sıkıcıdır ve genellikle sizin ekibinizin yapması gerekir; ama atlanırsa köprü her gün insan müdahalesi isteyen bir kuyruk üretir.

İkinci sınır: entegrasyon süreç düzeltmez. Onay zinciri tanımsızsa, iki sistemi bağlamak onayı düzenlemez. O iş iş süreci otomasyonunun konusudur; entegrasyon ise onun altındaki veri katmanıdır. Daha geniş bir yönetim sistemi arıyorsanız kurumsal yazılım sayfasına bakın.

Sıkça sorulan sorular

Mevcut muhasebe programımızı değiştirmeden entegrasyon kurabilir miyiz?

Evet. Muhasebe, bordro ve resmî defter kayıtları Logo, Mikro, Netsis veya SAP tarafında kalır; üretim, saha, teklif ve onay süreçleri özel sistemde yürür. Araya kurulan köprü cari, stok ve fatura kaydını iki yönde taşır. Şart, her kaydın tek bir sahip sisteminin olmasıdır.

Uzak sistem kapalıyken veya hat koptuğunda veri kaybolur mu?

Hayır. Köprü kayıtları doğrudan göndermez, önce kuyruğa yazar. Karşı taraf yanıt vermezse kayıt kuyrukta bekler ve aralık açarak yeniden denenir. Hat geldiğinde sıra bozulmadan aktarılır. Kaç kayıt beklediğini ve en eskisinin ne zamandan kaldığını izleme ekranında görürsünüz.

Aynı fatura veya sipariş iki kez gitmesin diye ne yapıyorsunuz?

Her aktarıma kendi ürettiğimiz tekil bir anahtar bağlanır ve bu anahtar karşı sistemdeki kayda yazılır. Aynı anahtar ikinci kez geldiğinde köprü yeni kayıt açmaz, mevcut kaydı döner. Buna idempotency deniyor; zaman aşımı sonrası tekrar denemelerde çift kayıt oluşmasını bu engeller.

Kullandığımız programın API'si yoksa ne yapıyorsunuz?

Sırasıyla şunlara bakıyoruz: salt okunur veritabanı görünümü, üreticinin sağladığı içe aktarma dosyası biçimi, zamanlanmış dosya alışverişi ve son çare olarak ekran otomasyonu. İlk üçü sağlamdır. Ekran otomasyonu programın arayüzü değiştiğinde kırılır, bu yüzden geçici çözüm olarak öneriyoruz.

Entegrasyon projesi ne kadar sürer ve ne kadara mal olur?

Belgelenmiş API'si olan tek yönlü bir köprü genellikle günler alır. Cari, stok ve fatura eşleşmesi gereken iki yönlü muhasebe köprüsü ile pazaryeri bağlantıları 2-4 haftada devreye girer ve 80.000 - 150.000 ₺ bandındadır. Sonradan eklenen her köprü 8.000 - 45.000 ₺ bandındadır.

Karşı sistem alan ekleyip çıkarırsa entegrasyon kırılır mı?

Köprü yalnız kullandığı alanları okur, tanımadığı alanı yok sayar; bu yüzden alan eklenmesi çalışmayı durdurmaz. Alan adı değişirse veya zorunlu bir alan kaldırılırsa aktarım hata verir, kayıt kuyrukta bekler ve sorumluya bildirim gider. Sözleşme testlerini gecelik çalıştırıp değişikliği kayıp yaşanmadan yakalıyoruz.

Aynı bilgiyi bir kez girin, her sistem aynı sayıyı göstersin