ERP-E-Ticaret Entegrasyonu: API, Webhook, Veri Senkronu

"ERP ile siteyi entegre edelim" cümlesi bir toplantıda geçtiğinde, masadakilerin yarısı ne konuşulduğunu tam olarak bilmez. API, webhook, senkron gibi kelimeler teknik ekibin dilidir; oysa kararı veren çoğu zaman işletme sahibidir.
 

Bu yazı tam olarak o boşluğu kapatmak için yazıldı. Kod yok, teknik terim yığını yok. Entegrasyonun nasıl çalıştığını günlük hayattan benzetmelerle anlatıyoruz: hangi veri nereye akar, ne sıklıkla güncellenir, bağlantı koptuğunda ne olur ve bir altyapı seçerken neyi sormanız gerekir.
 

ERP Entegrasyonu Nedir?

ERP entegrasyonu, işletmenizin ERP sistemi ile e-ticaret siteniz ve pazaryerleri arasında otomatik veri alışverişi kurulmasıdır. ERP (Kurumsal Kaynak Planlama), satış, stok, finans ve üretim süreçlerini tek bir veri tabanında toplayan yazılımdır.
 

Entegrasyon olmadığında bu iki dünya birbirinden habersiz çalışır. Mağazada bir ürün satılır, ERP'de stok düşer; ama sitede hiçbir şey değişmez. Siteden bir sipariş gelir, birinin onu elle ERP'ye girmesi gerekir. İki sistemin de kendi gerçeği vardır ve bu iki gerçek zamanla ayrışır.
 

Entegrasyonda önemli bir ilke var: iki sistem doğrudan birbirine bağlanmaz. Arada, birinin diliyle konuşup diğerinin diline çeviren bir katman bulunur. ERP'deki "ürün kartı" ile sitedeki "ürün ve varyant" yapısı aynı şey değildir; bu katman o farkı kapatır, hataları yakalar ve akışı izlenebilir kılar.
 

Entegrasyonun işletmeye katkılarını ayrı bir yazıda ele aldık; bu yazının konusu faydası değil, nasıl çalıştığı. Faydalar için ERP ile e-ticaret entegrasyonunun faydaları yazımıza bakabilirsiniz.
 

Entegrasyonun 3 Temel Kavramı

1. API: Sistemlerin Birbirine Soru Sorması

Bir restorana gittiğinizi düşünün. Mutfağa girip tencerelere bakmazsınız. Garsona sorarsınız, garson mutfağa gider, öğrenir ve size cevabı getirir. Sipariş vermek istediğinizde de aynı yolu izlersiniz: garsona söylersiniz, o mutfağa iletir.
 

API (Application Programming Interface) tam olarak bu garsondur. Bir sistemin, diğer sistemden bilgi istemek ya da ona bilgi göndermek için kullandığı tanımlı bir kapıdır.
 

Pratikte şuna benzer: entegrasyon katmanı ERP'ye "şu ürünün stoğu kaç" diye sorar, ERP cevap verir. Ya da siteye "bu ürünün fiyatını şu yap" der, site uygular. İki sistem birbirinin içine girmez; sadece bu tanımlı kapıdan konuşur.
 

API'nin tek bir sınırı var: birinin soru sorması gerekir. Siz garsonu çağırmazsanız mutfaktan haber gelmez. Bu da bizi ikinci kavrama götürüyor.
 

2. Webhook: Bir Şey Değiştiğinde Haber Verilmesi

Evde kargo bekliyorsunuz. İki seçeneğiniz var: her beş dakikada bir kapıya gidip bakmak ya da kapı zilinin çalmasını beklemek. İlki yorucudur ve çoğu kontrol boşa çıkar; ikincisinde ise kargo geldiği anda haberiniz olur.
 

Webhook, bu kapı zilidir. Bir sistemde önemli bir şey olduğunda — sipariş oluştuğunda, stok değiştiğinde, iade onaylandığında — o sistem diğerine kendiliğinden haber verir. Kimsenin sorması gerekmez.
 

Fark önemlidir. API ile çalışan bir yapıda entegrasyon katmanı düzenli aralıklarla "yeni sipariş var mı" diye sorar; iki sorgu arasında geçen süre kadar gecikme olur. Webhook'la çalışan yapıda sipariş oluştuğu anda bildirim gelir ve işlem saniyeler içinde başlar.
 

Gerçek kurgularda ikisi birlikte kullanılır: webhook anlık olayları taşır, API ise toplu ve planlı aktarımları yürütür.
 

3. Veri Senkronu: İki Sistemin Aynı Bilgiyi Göstermesi

Telefonunuzdaki takvim ile bilgisayarınızdaki takvimi düşünün. Birine eklediğiniz randevu diğerinde de görünür. İkisi ayrı cihazdır ama aynı bilgiyi gösterirler.
 

Veri senkronu budur: iki sistemdeki bilginin birbiriyle uyumlu tutulması. API ve webhook bu işin aracıdır; senkron ise sonucudur.
 

Senkronun sağlıklı çalışması için bir kuralın baştan belirlenmesi gerekir: hangi sistem doğruyu söylüyor? Buna "doğruluk merkezi" denir. Ürün, stok ve fiyat için doğruluk merkezi genellikle ERP'dir. Bir çelişki çıktığında — sitede 5 adet, ERP'de 3 adet görünüyorsa — ERP'deki değer esas alınır.
 

Bu kural tanımlı değilse iki sistem birbirinin üzerine yazar ve hangisinin doğru olduğu kimse bilemez. Entegrasyon projelerinde en sık yaşanan karmaşa buradan doğar.
 

Anlık Senkron mu, Periyodik Senkron mu?

Her verinin aynı hızda akması gerekmez. İki yöntem vardır ve doğru kurguda ikisi birlikte kullanılır.
 

Anlık senkron, değişiklik olduğu anda karşı tarafa yansır. Genellikle webhook ile çalışır. Avantajı hızdır; bedeli ise sistem üzerindeki yüktür. Her küçük değişiklik ayrı bir iletişim doğurur.
 

Periyodik senkron, belirli aralıklarla — örneğin gecede bir ya da saatte bir — toplu aktarım yapar. Avantajı verimliliktir; yüzünde biriken değişiklik tek seferde taşınır. Bedeli ise iki aktarım arasındaki gecikmedir.
 

Hangi verinin hangi yöntemle çalışacağı, gecikmenin maliyetine göre belirlenir:
 

• Stok anlık olmalıdır. Gecikmenin bedeli doğrudandır: olmayan ürün satılır, sipariş iptal edilir, pazaryerinde ceza doğar.
• Sipariş anlık olmalıdır. Depo ekibinin toplamaya hemen başlayabilmesi ve termin süresinin kaçırılmaması için.
• Fiyat değişiklik anında aktarılmalıdır. Özellikle kampanya başlangıç ve bitiş saatlerinde; yanlış fiyatla satış hem marj hem itibar kaybıdır.
• Ürün kartı periyodik olabilir. Açıklama, görsel ve özellik bilgisi stok kadar sık değişmez; günde birkaç kez aktarım yeterlidir.
   

Pratik kural şudur: bir verinin geç aktarılması müşteriye yanlış bilgi gösterecekse o veri anlık, göstermeyecekse periyodik olmalıdır.
 

Hangi Veri Hangi Yöne Akar?

Entegrasyon tek yönlü değildir. Bazı veriler ERP'den satış kanallarına, bazıları ise kanallardan ERP'ye gider.
 

Tabloda görülen simetri önemlidir: ürün, fiyat ve stok ERP'den dışarı akar; sipariş, müşteri ve iade dışarıdan ERP'ye gelir. Bu ayrım, hangi sistemin neyin doğruluk merkezi olduğunu da gösterir.
 

Birden fazla satış kanalı varsa kritik bir kural daha devreye girer: her kanalı ERP'ye ayrı ayrı bağlamayın. Site bir entegrasyonla, Trendyol başka bir entegrasyonla, Hepsiburada üçüncü bir entegrasyonla bağlandığında aynı stoğu birbirinden habersiz üç sistem okur ve yazar. Doğru kurgu, tüm kanalların tek bir merkezden beslenmesidir.
 

Entegrasyon Koptuğunda İşletme Ne Kaybeder?

Entegrasyonun en sinsi tarafı şudur: koptuğunda genellikle ekranda kırmızı bir uyarı çıkmaz. Sistem çalışıyor görünür, sadece veri akmaz. Sorun fark edildiğinde genellikle müşteriden duyulmuştur.
 

Stokta olmayan ürün satılır. Mağazada son adet satılmış, ERP'de stok sıfıra düşmüş ama siteye yansımamıştır. Müşteri sipariş verir, ertesi gün "ürün tükendi" mesajı alır. Kaybedilen yalnızca o satış değildir; reklam bütçesi harcanarak kazanılmış bir müşteridir.
 

Yanlış fiyattan satış yapılır. Kampanya ERP'de bitmiş ama sitede ya da pazaryerinde eski indirimli fiyat durmaktadır. Her satış marjın altında gerçekleşir ve bu fark genellikle ay sonunda, mutabakat sırasında fark edilir.
 

Pazaryerinde ceza doğar. Stok yansımadığı için gelen sipariş karşılanamaz ve iptal edilir. Pazaryeri bunu "tedarik edememe" sayar, cezai şart uygular ve iptal oranı mağaza performans skoruna işler. Skor düştüğünde ürünler aramada geriler — yani görünmeyen bir ciro kaybı da eklenir. Ayrıntılar için pazaryeri cezalarını önlemek rehberimize bakabilirsiniz.
 

Sipariş elle girilmeye başlar. Akış durduğunda ekip siparişleri panelden indirip ERP'ye elle girer. Bu, hem termin kaybı hem yazım hatası riski demektir ve geçici çözüm genellikle kalıcı hale gelir.
 

Bu nedenle entegrasyonun kendisi kadar izlenebilirliği de önemlidir: aktarılamayan kayıtları gösteren bir ekran ve bağlantı koptuğunda uyarı üreten bir yapı olmalıdır. Senkronizasyonda sık yapılan hataları ERP ve e-ticaret senkronizasyonunda yapılan hatalar yazımızda ayrıntılı ele aldık.
 

Entegrasyon Altyapısı Seçerken Sorulması Gereken 5 Soru

1. Hangi veri hangi sıklıkla akacak ve bunu kim belirliyor? Stok anlık mı, beş dakikada bir mi? Bu ayarı siz yapabiliyor musunuz, yoksa sabit mi? Kampanya dönemlerinde sıklığı artırabiliyor musunuz?
 

2. Bir hata olduğunda nasıl görüyorum? Aktarılamayan sipariş ve ürünleri gösteren bir ekran var mı? Bağlantı koptuğunda uyarı geliyor mu, yoksa fark etmek için birinin bakması mı gerekiyor?
 

3. Aktarılamayan kayıt ne oluyor? Hata veren bir sipariş kayboluyor mu, bekleme kuyruğunda duruyor mu, yoksa sistem kendiliğinden yeniden deniyor mu? İyi kurulmuş bir yapıda hiçbir kayıt sessizce düşmez.
 

4. Yeni bir kanal eklediğimde ne oluyor? Yeni bir pazaryeri ya da ikinci bir site eklemek sıfırdan proje mi gerektiriyor, yoksa mevcut yapıya bağlanıyor mu? Bu soru, bugünkü maliyetten çok iki yıl sonraki esnekliği belirler.
 

5. ERP sürümü güncellendiğinde kim sorumlu? ERP sağlayıcısı yeni bir versiyon yayınladığında entegrasyonun uyumlu kalması kimin işi? Bu sorunun cevabı sözleşmede net yazılı olmalıdır; aksi halde güncelleme sonrası kimsenin sahiplenmediği bir kesinti yaşanır.
 

LivaSoft ile Nebim V3 ve E-Ticaret Arasında Kesintisiz Veri Akışı

Bu yazıdaki kavramların tamamı tek bir amaçta birleşir: verinin doğru yönde, doğru sıklıkta ve kesintisiz akması. LivaSoft bu katmanda çalışır.
 

Nebim V3 ERP entegrasyonu ile ürün, stok, fiyat, sipariş ve müşteri verisi çift yönlü senkronize çalışır. Stok hareketleri anlık yansır, siparişler oluştuğu anda ERP'ye yazılır, faturalama ve kargo süreçleri aynı akışta tetiklenir. Aktarım logları tek panelden izlenir; aktarılamayan kayıt sessizce düşmez, kuyrukta görünür.
 

Kendi e-ticaret altyapınız ve pazaryerleriniz aynı merkezden beslendiği için her kanal için ayrı entegrasyon kurmanıza gerek kalmaz. Yeni bir kanal eklendiğinde sıfırdan proje yerine mevcut yapıya bağlanır.
 

Mevcut ERP ve kanal yapınızda verinin nasıl akacağını birlikte çıkarmak için demo talep edin.
 

Sıkça Sorulan Sorular

ERP entegrasyonu nedir?

ERP entegrasyonu, işletmenin ERP sistemi ile e-ticaret sitesi ve pazaryerleri arasında otomatik veri alışverişi kurulmasıdır. İki sistem doğrudan birbirine bağlanmaz; arada, birinin veri yapısını diğerine çeviren, hataları yakalayan ve akışı izlenebilir kılan bir entegrasyon katmanı bulunur. Bu katman sayesinde ERP'deki ürün, fiyat ve stok bilgisi satış kanallarına aktarılır; kanallardan gelen sipariş, müşteri ve iade bilgisi ise ERP'ye geri yazılır.
 

API ile webhook arasındaki fark nedir?

API, bir sistemin diğerine soru sorması ya da bilgi göndermesi için kullandığı tanımlı kapıdır; restorandaki garsona benzer, siz sormazsanız mutfaktan haber gelmez. Webhook ise tersidir: bir sistemde önemli bir şey olduğunda — sipariş oluştuğunda, stok değiştiğinde — o sistem diğerine kendiliğinden haber verir; kapı ziline benzer. API ile çalışan yapıda iki sorgu arasında gecikme olurken webhook'ta işlem olay anında başlar. Gerçek kurgularda ikisi birlikte kullanılır: webhook anlık olayları, API toplu ve planlı aktarımları taşır.
 

Stok bilgisi ne sıklıkla senkronize edilmelidir?

Stok, entegrasyondaki en kritik veridir ve anlık senkronize edilmelidir. Gecikmenin bedeli doğrudandır: mağazada ya da başka bir kanalda satılan ürün sitede satılabilir görünmeye devam eder, gelen sipariş karşılanamaz ve iptal edilir. Pazaryerlerinde bu durum ayrıca cezai şart ve performans skoru düşüşü doğurur. Genel kural şudur: bir verinin geç aktarılması müşteriye yanlış bilgi gösterecekse o veri anlık olmalıdır. Ürün açıklaması ve görsel gibi veriler ise periyodik aktarılabilir.
 

ERP entegrasyonu koparsa ne olur?

En sinsi tarafı, koptuğunda genellikle açık bir uyarı üretmemesidir; sistem çalışıyor görünür, yalnızca veri akmaz. Sonuçlar somuttur: stokta olmayan ürün satılır ve sipariş iptal edilir, kampanya bittiği halde eski fiyattan satış yapılır, pazaryerinde tedarik edememe cezası doğar ve iptal oranı mağaza skoruna işler. Ekip geçici çözüm olarak siparişleri elle girmeye başlar; bu da termin kaybı ve yazım hatası riski getirir. Bu nedenle entegrasyonun kendisi kadar izlenebilirliği de önemlidir.
 

ERP entegrasyonu için yazılım ekibi gerekir mi?

Hazır bir entegrasyon çözümü kullanıyorsanız kendi yazılım ekibinize gerek yoktur; kurulum ve bakım çözüm sağlayıcısı tarafından yürütülür. Sizin tarafınızda gereken, teknik bilgi değil karar vermektir: hangi verinin hangi sıklıkla akacağı, çelişki durumunda hangi sistemin doğru kabul edileceği ve hangi mağaza stoklarının online satışa açılacağı gibi kurallar işletme tarafından belirlenir. Sıfırdan özel entegrasyon geliştirilecekse sürekli bir yazılım kapasitesi gerekir; bu durumda ERP sürüm güncellemelerinde uyumun kimin sorumluluğunda olduğu da baştan netleştirilmelidir.