İçeriğe geç
Önem Bilişim

Web Sitesi ile ERP Arasında Veri Aktarımı: REST, Webhook ve Zamanlanmış Senkronizasyon

Web siteniz siparişleri alıyor, ERP ya da muhasebe programınız stok ve faturaları yönetiyor; ikisi birbiriyle konuşmuyorsa aradaki işi insanlar yapıyor. REST API, webhook ve zamanlanmış senkronizasyon yöntemlerini karşılaştırıyor, sağlam bir ERP entegrasyonunun tasarım ilkelerini anlatıyoruz.

Yazılım ve Entegrasyon8 dk okuma
Web Sitesi ile ERP Arasında Veri Aktarımı: REST, Webhook ve Zamanlanmış Senkronizasyon
İçindekiler
  1. Önce sahiplik: hangi veri hangi sistemde doğar?
  2. Dört aktarım yöntemi
  3. REST API: istek ve yanıt
  4. Webhook: olay olduğunda haber ver
  5. Zamanlanmış senkronizasyon
  6. Dosya aktarımı
  7. Sağlam bir entegrasyonun tasarım ilkeleri
  8. Kuyruk ve tekrar deneme
  9. Aynı kaydı iki kez işlememek
  10. Hata bildirimi ve kayıt
  11. Güvenlik
  12. Ayrıntılar: vergi, yuvarlama ve saat
  13. Örnek akış: bir siparişin ERP’ye yolculuğu
  14. Entegrasyonu izlemek
  15. Entegrasyon belgesinde neler yazılı olmalı?
  16. Test ortamında başlayın
  17. Sıkça sorulan sorular
  18. ERP entegrasyonu nedir?
  19. Webhook ile REST API arasındaki fark nedir?
  20. ERP’m API sunmuyorsa entegrasyon yapılabilir mi?
  21. Stok ne sıklıkla senkronize edilmeli?
  22. Sonuç

Web sitenizden bir sipariş geliyor. Bir çalışan siparişi açıyor, müşteri ve ürün bilgilerini ERP’ye ya da muhasebe programına tek tek giriyor. Akşam olunca ERP’deki güncel stok sayıları bir Excel dosyasına aktarılıyor ve bu dosya siteye yükleniyor. Arada geçen saatlerde sitede stokta görünen ama depoda olmayan ürünler satılıyor.

Bu tablonun çözümü, iki sistemin doğrudan konuşmasını sağlayan bir entegrasyondur. Ancak “entegrasyon yapalım” kararı, nasıl yapılacağı sorusunu da beraberinde getirir. Veri anlık mı aktarılmalı, belirli aralıklarla mı? Kim kimi çağırmalı? Bir sistem kapalıyken ne olacak? Bu yazıda web sitesi ile ERP arasında veri aktarımının yöntemlerini karşılaştırıyor ve sağlam bir entegrasyonun tasarım ilkelerini anlatıyoruz.

Kısaca
  • Önce sahiplik: Her verinin tek bir ana kaynağı olmalı; stok ERP’de, sipariş sitede doğar
  • Yöntem: Anlık olaylar için webhook, sorgu ve kayıt için REST, toplu işler için zamanlanmış görev
  • Sağlamlık: Kuyruk, tekrar deneme, aynı kaydın iki kez işlenmesini önleyen benzersiz referans ve hata bildirimi
  • Güvenlik: Anahtarlar kodda değil yapılandırmada, en az yetki, imzalı webhook ve ayrıntılı kayıt

Önce sahiplik: hangi veri hangi sistemde doğar?

Teknik yöntemden önce yanıtlanması gereken soru şudur: Her veri türünün ana kaynağı hangi sistem? Bu karar verilmezse iki sistem aynı veriyi birbirinin üzerine yazar ve hangisinin doğru olduğu bilinmez.

VeriTipik ana kaynakAktarım yönü
Ürün kartı, fiyat, stokERPERP’den siteye
SiparişWeb sitesiSiteden ERP’ye
Müşteri (bireysel)Web sitesiSiteden ERP’ye
Cari hesap (kurumsal müşteri)ERPERP’den siteye
FaturaERP ya da e-fatura sağlayıcısıERP’den siteye (müşteri görüntüler)
Kargo takip numarasıKargo entegrasyonuHem siteye hem ERP’ye

Tablo işletmeye göre değişebilir. Önemli olan her satır için tek bir ana kaynağın yazılı olarak belirlenmesidir.

Dört aktarım yöntemi

Web sitesi ile ERP arasında dört veri aktarım yöntemi: REST API ile istek ve yanıt, webhook ile olay bildirimi, zamanlanmış toplu senkronizasyon ve dosya aktarımı; her birinin hız ve kullanım alanı
Çoğu entegrasyon bu yöntemleri birlikte kullanır: siparişler anlık, stok ve fiyatlar düzenli aralıklarla aktarılır.

REST API: istek ve yanıt

Bir sistem diğerine “şu siparişi kaydet” ya da “şu ürünün stoğunu ver” diye HTTP üzerinden istek gönderir ve yanıt alır. Bugün çoğu modern ERP, e-ticaret altyapısı ve hizmet sağlayıcı REST API sunar. Kayıt oluşturmak, güncellemek ve tek tek sorgulamak için idealdir. Bazı eski ya da kurumsal sistemler ise aynı işi SOAP servisleriyle yapar. Mantık benzerdir, yalnızca mesaj biçimi farklıdır.

Webhook: olay olduğunda haber ver

Webhook’ta yön tersine döner. Bir olay gerçekleştiğinde (yeni sipariş, ödeme onayı, stok değişikliği) kaynak sistem, önceden tanımlanan bir adrese kendiliğinden bildirim gönderir. Karşı tarafın sürekli “yeni bir şey var mı?” diye sorması gerekmez. Anlık tepki gereken olaylar için en verimli yöntemdir. Ödeme kuruluşları ödeme sonucunu, birçok e-ticaret altyapısı da yeni siparişleri bu şekilde bildirir.

Zamanlanmış senkronizasyon

Belirli aralıklarla çalışan bir görev, değişen kayıtları toplu olarak aktarır. Örneğin her on beş dakikada bir son değişen ürünlerin stok ve fiyatları siteye gönderilir. Sunucuda genellikle cron ile tetiklenir. Nasıl çalıştığını Cronjob nedir yazımızda anlattık. Anlık olması gerekmeyen ve çok sayıda kayıt içeren işler için uygundur.

Dosya aktarımı

XML, CSV ya da Excel dosyalarının bir klasöre bırakılması ve diğer sistemin bunları okumasıdır. API sunmayan eski sistemlerde hâlâ yaygındır. Basittir ama hata yönetimi zayıftır ve gecikmelidir. Mümkünse API tabanlı bir yönteme geçmek gerekir.

YöntemHızUygun olduğu işDikkat
REST / SOAPAnlık, istek anındaSipariş kaydı, tekil sorguKarşı sistem kapalıysa tekrar deneme gerekir
WebhookAnlık, olay anındaYeni sipariş, ödeme sonucuBildirim kaybolabilir; doğrulama ve yedek kontrol gerekir
Zamanlanmış görevDakikalarStok, fiyat, toplu güncellemeYalnızca değişen kayıtları göndermek gerekir
Dosya aktarımıSaatlerAPI’siz eski sistemlerHata takibi zor, biçim hatalarına açık

Pratikte en sağlam yapı yöntemleri birleştirir. Siparişler webhook ya da REST ile anlık aktarılır. Stok ve fiyatlar zamanlanmış görevle düzenli olarak güncellenir. Gece çalışan bir kontrol görevi de gün içinde kaçan bir kayıt olup olmadığını denetler.

Sağlam bir entegrasyonun tasarım ilkeleri

Kuyruk ve tekrar deneme

ERP bakımdayken gelen bir sipariş kaybolmamalıdır. Siparişler önce bir kuyruğa yazılır, sonra sırayla aktarılır. Aktarım başarısız olursa sistem artan aralıklarla yeniden dener. Belirli sayıda denemeden sonra hâlâ başarısızsa ilgili kişiye bildirim gönderir.

Aynı kaydı iki kez işlememek

Ağ kesintisinde bir istek ulaşmış ama yanıtı gelmemiş olabilir. Sistem tekrar denediğinde aynı sipariş ERP’de iki kez oluşmamalıdır. Bunun için her kayıt benzersiz bir dış referansla (örneğin sitedeki sipariş numarası) gönderilir. ERP bu referansı daha önce gördüyse yeni kayıt açmaz. Bu ilkeye teknik dilde “idempotency” denir.

Hata bildirimi ve kayıt

Her aktarımın ne zaman, hangi veriyle yapıldığı ve sonucun ne olduğu kayıt altına alınmalıdır. Sessizce başarısız olan bir entegrasyon, hiç olmayan bir entegrasyondan daha tehlikelidir, çünkü herkes verinin aktarıldığını sanır.

Güvenlik

  • Anahtarlar kodda değil yapılandırmada: API anahtarları ve şifreler sunucuda güvenli bir yapılandırma dosyasında tutulur, kaynak koda yazılmaz.
  • En az yetki: Entegrasyon kullanıcısı yalnızca ihtiyaç duyduğu işlemleri yapabilmelidir. Stok okuyan bir entegrasyonun fatura silme yetkisi olmamalıdır.
  • İmzalı webhook: Gelen bildirimin gerçekten beklenen kaynaktan geldiği, sağlayıcının sunduğu imza ya da gizli anahtarla doğrulanmalıdır.
  • Güvenli bağlantı: Tüm aktarımlar HTTPS üzerinden yapılmalı. OAuth 2.0 destekleyen sistemlerde kalıcı şifre yerine süreli erişim anahtarları tercih edilmelidir.

Ayrıntılar: vergi, yuvarlama ve saat

Entegrasyon hatalarının önemli bir kısmı küçük ayrıntılardan doğar. KDV dahil ve hariç tutarların karıştırılması, kuruş yuvarlama farkları, indirim ve kargo ücretinin satırlara dağıtılması ve iki sistemin farklı saat dilimleri kullanması bunların başındadır. Bu kurallar analiz aşamasında örnek siparişlerle tek tek doğrulanmalıdır.

Örnek akış: bir siparişin ERP’ye yolculuğu

İlkelerin birlikte nasıl çalıştığını bir sipariş üzerinden izleyelim:

  1. Müşteri web sitesinde ödemeyi tamamlar. Ödeme kuruluşu ödeme sonucunu sitenize webhook ile bildirir. Site, imzayı doğruladıktan sonra siparişi “ödendi” durumuna alır.
  2. Sipariş, aktarılmak üzere kuyruğa eklenir. Müşteri bu sırada beklemez, onay sayfasını hemen görür.
  3. Arka planda çalışan bir işçi kuyruktaki siparişi alır ve ERP’nin REST API’sine gönderir. Gönderide sitenin sipariş numarası dış referans olarak yer alır.
  4. ERP o an bakımdadır ve yanıt vermez. İşçi birkaç dakika sonra, sonra daha uzun bir aralıkla yeniden dener.
  5. ERP yeniden açıldığında sipariş kaydedilir. ERP’nin verdiği belge numarası sitedeki siparişe yazılır ve stok ERP’de düşer.
  6. On beş dakikada bir çalışan zamanlanmış görev, ERP’de değişen stokları siteye ve pazaryerlerine gönderir.
  7. Gece çalışan kontrol görevi, sitedeki ödenmiş siparişler ile ERP’deki kayıtları karşılaştırır. Eşleşmeyen bir kayıt varsa sorumluya bildirim gönderir.

Bu akışta hiçbir sipariş kaybolmaz, hiçbiri iki kez kaydedilmez ve bir sorun çıktığında hangi adımda takıldığı kayıtlardan görülebilir.

Entegrasyonu izlemek

Entegrasyon kurulduktan sonra da gözetim gerektirir. Basit bir izleme ekranında şu bilgiler bulunmalıdır: son başarılı aktarımın zamanı, kuyrukta bekleyen kayıt sayısı, son yirmi dört saatteki hatalar ve elle yeniden denenmesi gereken kayıtlar. Kuyruk birden büyümeye başladığında ya da uzun süre hiç aktarım olmadığında otomatik uyarı gelmesi, sorunun müşteriden önce fark edilmesini sağlar. Karşı sistemlerin API’leri de zamanla değişir. Sağlayıcıların sürüm ve kullanımdan kaldırma duyurularını takip etmek, entegrasyon bakımının bir parçasıdır.

Entegrasyon belgesinde neler yazılı olmalı?

Entegrasyonu yazan kişi değiştiğinde ya da bir yıl sonra bir sorun çıktığında, sistemin nasıl çalıştığını anlatan bir belge büyük zaman kazandırır. Kısa da olsa şu başlıklar yazılı olmalıdır:

  • Veri sahipliği tablosu: Hangi verinin hangi sistemde doğduğu ve aktarım yönü.
  • Alan eşleştirmesi: Sitedeki her alanın ERP’de hangi alana karşılık geldiği; birim, para birimi ve vergi kuralları.
  • Zamanlama: Hangi işin anlık, hangisinin hangi aralıkla çalıştığı.
  • Hata senaryoları: Karşı sistem yanıt vermediğinde, veri eksik geldiğinde ya da kayıt zaten varsa ne olduğu.
  • Erişim bilgilerinin yeri: Anahtarların nerede saklandığı ve kimin değiştirebildiği. Anahtarın kendisi belgeye yazılmaz.
  • İletişim: Bir sorun çıktığında entegrasyon tarafında ve karşı sistem tarafında kime ulaşılacağı.

Bu belge, entegrasyonun yalnızca onu yazan kişinin kafasında yaşamasını önler ve bakımı kolaylaştırır.

Test ortamında başlayın

Entegrasyonu canlı sistemler üzerinde geliştirmek, test siparişlerinin muhasebeye karışmasına yol açar. ERP’nin ve hizmet sağlayıcıların test ortamlarını (sandbox) kullanın, sitenin de bir kopyasında deneyin. Ayrı geliştirme ve test ortamlarının neden önemli olduğunu geliştirme ve test ortamları yazımızda anlattık. Yoğun dönemlerde entegrasyon isteklerinin sunucuya getirdiği yükü de Ryzen VDS ve e-ticaret performansı yazımızda ele aldık.

E-ticarete özel pazaryeri, kargo ve e-fatura bağlantılarını pazaryeri, kargo ve e-fatura entegrasyonu rehberimizde ayrıca inceledik.

Önem Bilişim’in yazılım ekibi REST, SOAP ve webhook entegrasyonları, zamanlanmış veri aktarımları ve e-fatura, ödeme, kargo ve pazaryeri bağlantıları geliştirir. PHP ve Laravel, Node.js, MySQL ve Redis gibi teknolojilerle çalışır. Kapsamı ve çalışma sürecini API entegrasyonu ve yazılım hizmetlerimiz sayfasında bulabilirsiniz.

Sıkça sorulan sorular

ERP entegrasyonu nedir?

ERP entegrasyonu, web sitesi, e-ticaret altyapısı ya da diğer iş uygulamalarının ERP sistemiyle otomatik veri alışverişi yapmasını sağlayan yazılım bağlantısıdır. Siparişler, stok, fiyat, müşteri ve fatura bilgileri iki sistem arasında elle giriş yapılmadan aktarılır.

Webhook ile REST API arasındaki fark nedir?

REST API’de veriye ihtiyaç duyan sistem karşı tarafa istek gönderir ve yanıt alır. Webhook’ta ise bir olay gerçekleştiğinde kaynak sistem karşı tarafa kendiliğinden bildirim gönderir. REST “sor ve al”, webhook “olunca haber ver” mantığıyla çalışır. Çoğu entegrasyon ikisini birlikte kullanır.

ERP’m API sunmuyorsa entegrasyon yapılabilir mi?

Çoğu zaman evet. Bazı sistemler SOAP servisleri, veritabanı görünümleri ya da XML veya CSV dosya aktarımı sunar. Bu yöntemler daha sınırlıdır ama doğru hata kontrolüyle güvenilir şekilde çalışabilir. Önce ERP sağlayıcınızdan hangi entegrasyon seçeneklerinin bulunduğunu öğrenin.

Stok ne sıklıkla senkronize edilmeli?

Satış hızınıza bağlıdır. Çoğu işletme için değişen ürünlerin birkaç dakikada bir aktarılması yeterlidir. Siparişler ise anlık aktarılmalı ve stok sipariş anında düşmelidir. Az kalan ürünlerde güvenlik payı bırakmak, aradaki gecikmeden doğan fazla satışı önler.

Sonuç

İyi bir ERP entegrasyonu, hangi verinin hangi sistemde doğduğunu netleştirmekle başlar. Anlık olaylar için webhook ve REST, toplu güncellemeler için zamanlanmış görevler kullanın. Kuyruk, tekrar deneme, benzersiz referans, ayrıntılı kayıt ve güvenli anahtar yönetimiyle entegrasyonu sağlam kurun ve her şeyi önce test ortamında deneyin. Böylece siparişler bir kez girilir, stok her kanalda doğru görünür ve ekibiniz veri taşımak yerine işine odaklanır.

API entegrasyonu

Sistemleriniz birbiriyle konuşsun

Web siteniz, ERP ya da muhasebe programınız, e-fatura, ödeme, kargo ve pazaryeri servisleri arasında REST, SOAP ve webhook entegrasyonları kuruyoruz. Bandırma merkezli, Türkiye ve yurt dışına hizmet veren ekibimizle analizden bakıma tek muhatap.

Paylaş:WhatsAppXFacebookLinkedInTelegram

Bunlar da ilginizi çekebilir