ERP sistemleri isletmelerin omurgasini olusturur; ancak tek basina her seyi yapamaz. Farkli departmanlar, e-ticaret platformlari, depo yonetim sistemleri ve is zekasi araclari gibi dis sistemlerle veri alisverisi yapabilmek icin API (Application Programming Interface) entegrasyonu sart hale gelmistir. API, iki yazilim sisteminin birbirleriyle standart bir protokol uzerinden iletisim kurmasini saglayan arayuzdur. Gunumuzde ERP entegrasyonlarinin buyuk cogunlugu ya REST ya da SOAP tabanli web servisleri uzerinden gerceklestirilmektedir.
Turkiye'deki KOBI'lerin buyuk cogunlugu Logo (Tiger, Go 3, Go Plus), Mikro, Netsis veya SAP gibi ERP sistemlerini kullanmaktadir. Bu ERP'lerin her biri farkli API mimarileri ve entegrasyon yontemleri sunmaktadir. Dogru API yaklasimini secmek, entegrasyon projesinin basarisi, performansi ve uzun vadeli surdurulebilirligi acisindan kritik oneme sahiptir. Bu rehberde REST ve SOAP protokollerini teknik derinlikte karsilastirarak, her birinin ERP entegrasyonundaki avantaj ve dezavantajlarini ele alacagiz.
API Nedir ve Neden ERP Entegrasyonunda Kritik Oneme Sahiptir?
API, bir yazilim uygulamasinin baska bir yazilim uygulamasiyla veri paylasmasini ve islem yapmasini saglayan tanimli arayuzler butunudur. ERP baglaminda API, dis sistemlerin ERP veritabanindaki verilere (stok, siparis, fatura, cari hesap vb.) guvenli ve kontrolllu bir sekilde erismesini mumkun kilar. API olmadan ERP entegrasyonu genellikle dogrudan veritabani erisimi veya dosya tabanli veri transferi ile yapilmak zorunda kalir ki her ikisi de ciddi riskler tasir.
API tabanli entegrasyonun temel avantajlari sunlardir:
- Guvenlir veri erisimi: API, yetkilendirme mekanizmalari (OAuth, API Key, token) ile korunur. Hangi veriye kimin erisebilecegi detayli sekilde kontrol edilir.
- Standart protokoller: REST ve SOAP gibi endustri standartlari kullanilir. Farkli programlama dilleri ve platformlar arasinda uyumluluk saglanir.
- Surum yonetimi: API surumlemesi sayesinde ERP guncellendignde mevcut entegrasyonlar bozulmaz.
- Hata yonetimi: Standart HTTP durum kodlari ve hata mesajlari ile sorunlar hizla tespit edilir ve cozulur.
- Olceklenebilirlik: API tabanli mimariler, artan islem hacimlerine uyum saglayabilir. Yuk dengeleme ve onbellekleme mekanizmalari uygulanabilir.
UBS Bilisim olarak 18 yili askin deneyimimizle, Logo Tiger, Logo Go 3, Logo Go Plus, Mikro, Netsis, Odoo ve SAP ERP sistemleriyle 200'den fazla basarili API entegrasyon projesi gerceklestirdik. Her ERP'nin API yapisina hakim teknik ekibimizle, isletmenize en uygun entegrasyon stratejisini belirliyoruz.
REST API Nedir? Temel Kavramlar ve Mimarisi
REST (Representational State Transfer), 2000 yilinda Roy Fielding tarafindan doktora tezinde ortaya konan bir yazilim mimari stilidir. REST, HTTP protokolu uzerine insa edilmis, kaynak odakli (resource-oriented) bir yaklasimdir. Gunumuzde web servislerinin %80'inden fazlasi REST mimarisini kullanmaktadir.
REST'in Temel Prensipleri
- Kaynak tabanli (Resource-based): Her veri nesnesi (urun, siparis, musteri) benzersiz bir URL ile temsil edilir. Ornegin:
/api/v1/products/12345 - HTTP metotlari: CRUD islemleri standart HTTP metotlari ile gerceklestirilir: GET (okuma), POST (olusturma), PUT (guncelleme), DELETE (silme).
- Durumsuz (Stateless): Her istek, islemin tamamlanmasi icin gereken tum bilgiyi icerir. Sunucu, istekler arasinda istemci durumunu tutmaz.
- JSON veri formati: REST API'lerde genellikle JSON (JavaScript Object Notation) formati kullanilir. XML'e gore cok daha hafif ve okunabilirdir.
- Onbellekleme (Caching): HTTP'nin yerlesik onbellekleme mekanizmalari kullanilarak performans arttirilir.
REST API ERP Entegrasyon Ornegi
Bir e-ticaret platformunun Logo ERP'deki stok bilgisini sorgulamasi su sekilde gerceklesir: Platform, GET /api/v1/inventory?productCode=URN001 seklinde bir HTTP istegi gonderir. Logo REST API, JSON formatinda stok miktari, depo lokasyonu ve son guncelleme zamanini dondurur. Bu islem milisaniyeler icerisinde tamamlanir ve gercek zamanli stok goruntulemeyi mumkun kilar.
Bir siparis olusturma islemi icin ise POST /api/v1/orders endpoint'ine siparis detaylarini iceren bir JSON gonderilir. API, siparisi ERP'de olusturur ve siparis numarasi ile onay bilgisini yanit olarak dondurur.
SOAP Nedir? Protokol Yapisi ve Calismasi
SOAP (Simple Object Access Protocol), 1998 yilinda Microsoft tarafindan gelistirilen ve W3C tarafindan standartlastirilan bir mesajlasma protokoludur. SOAP, XML tabanli mesajlar kullanarak sistemler arasinda yapilandirilmis veri alisverisi saglar. Kurumsal yazilim dunyasinda, ozellikle bankacilik, sigorta ve buyuk olcekli ERP sistemlerinde yaygin olarak kullanilmaktadir.
SOAP'in Temel Ozellikleri
- XML tabanli mesajlasma: Tum istekler ve yanitlar XML formatinda SOAP zarflari (envelope) icinde iletilir. Bu yapi, mesajin basligini (header) ve govdesini (body) net bir sekilde ayirir.
- WSDL (Web Services Description Language): SOAP servisleri, WSDL dosyasi ile tanimlanir. Bu dosya, mevcut islemleri, parametre tiplerini ve yanit yapilarini detayli sekilde dokumante eder.
- WS-Security: Kurumsal duzeyde guvenlik standartlari (dijital imza, sifreleme, token tabanli kimlik dogrulama) yerlesik olarak desteklenir.
- Protokol bagimsizligi: SOAP, HTTP disinda SMTP, TCP ve JMS gibi farkli tasima protokolleri uzerinde de calisabilir.
- ACID islem destegi: WS-AtomicTransaction gibi standartlarla dagitik islemlerde veri tutarliligi saglanir.
SOAP ERP Entegrasyon Ornegi
Netsis ERP'nin SOAP web servisleri uzerinden bir fatura olusturma islemi su adimlari icerir: Istemci, WSDL dosyasini okuyarak mevcut islemleri ve parametre yapilarini ogenir. Ardindan XML formatinda bir SOAP zarfi olusturur; bu zarf, fatura baslik bilgileri (tarih, cari kodu, vade) ve kalem detaylarini (urun kodu, miktar, birim fiyat) icerir. SOAP servisi, istegi isler, ERP'de faturayi olusturur ve fatura numarasini XML yanit olarak dondurur.
REST vs SOAP: Detayli Teknik Karsilastirma
Veri Formati ve Boyutu
REST API'ler genellikle JSON formati kullanir. JSON, XML'e kiyasla %30-50 daha az veri boyutuna sahiptir. Bu fark, ozellikle yuksek hacimli islemlerde bant genisligi ve islem suresi acisindan onemli avantaj saglar. Ornegin, 1000 urun bilgisi JSON'da yaklasik 250 KB yer kaplarken, ayni veri XML/SOAP formatinda 400-500 KB'a ulasabilir.
SOAP ise zorunlu olarak XML kullanir. XML, insan tarafindan daha okunabilir olmakla birlikte, acilis/kapanis etiketleri nedeniyle daha fazla yer kaplar. Ayrica SOAP zarfi (envelope, header, body) ek yuk (overhead) getirir.
Performans ve Hiz
REST, daha hafif veri formati ve HTTP onbellekleme destegi sayesinde genellikle SOAP'a gore daha hizli calismaktadir. Benchmark testlerinde REST API'lerin SOAP servislerine kiyasla %20-40 daha dusuk gecikme suresi (latency) sundugu gorulmektedir. Ozellikle mobil uygulamalar ve gercek zamanli entegrasyonlarda bu fark belirginlesir.
Ancak SOAP, WS-ReliableMessaging sayesinde mesaj iletim garantisi sunar. Kritik finansal islemlerde (fatura olusturma, odeme islemi) bu ozellik onemli bir avantajdir.
Guvenlik
SOAP, WS-Security standardiyla kurumsal duzeyde guvenlik sunar: mesaj duzeyinde sifreleme, dijital imza, SAML token destegi ve WS-Trust ile federatif kimlik yonetimi. Bu ozellikler, bankacilik ve saglik sektoru gibi yuksek guvenlik gereksinimi olan alanlarda SOAP'i tercih edilen protokol yapar.
REST API'ler ise guvenlik icin HTTP/TLS (HTTPS) uzerinden tasima katmani guvenligini, OAuth 2.0 yetkilendirmesini ve JWT (JSON Web Token) tabanli kimlik dogrulamayi kullanir. Modern uygulamalarin buyuk cogunlugu icin bu guvenlik duzeyi yeterlidir. Ancak REST'te mesaj duzeyinde sifreleme icin ek implementasyon gerekir.
Hata Yonetimi
REST, standart HTTP durum kodlarini kullanir: 200 (basarili), 201 (olusturuldu), 400 (hatali istek), 401 (yetkisiz), 404 (bulunamadi), 500 (sunucu hatasi). Bu kodlar evrensel olarak anlasilir ve hizli sorun tespiti saglar.
SOAP, SOAP Fault mekanizmasi ile detayli hata bilgisi sunar. Fault code, fault string ve detail alanlari, hatanin tam olarak nerede ve neden olustugunu bildirir. Karmasik is surecleri icin bu detay duzeyi faydalidir.
Turkiye'deki ERP Sistemlerinin API Yaklasimlari
Logo (Tiger, Go 3, Go Plus)
Logo ERP, REST API yaklasimini benimsemistir. Logo REST API, JSON formatinda veri alisverisi saglar ve modern entegrasyon standartlarini destekler. Stok sorgulama, siparis olusturma, fatura isleme ve cari hesap yonetimi gibi temel islemler REST endpoint'leri uzerinden gerceklestirilebilir. Logo ayrica SDK (Software Development Kit) sunarak gelistiricilere daha derin entegrasyon imkanlari tanir.
Logo REST API'nin avantajlari arasinda kapsamli dokumantasyon, aktif gelistirici toplulugu ve duzenlı guncellenen API surumleri yer almaktadir. UBS Bilisim olarak Logo REST API uzerinde en fazla deneyime sahip entegrasyon partnerlerinden biriyiz.
Netsis
Netsis ERP, SOAP tabanli web servisleri kullanmaktadir. Netsis Web Servis yapisi, WSDL tanimi ile tum mevcut islemleri detayli olarak dokumante eder. Fatura, irsaliye, siparis, stok hareketi ve cari hesap islemleri SOAP servisleri uzerinden gerceklestirilebilir.
Netsis'in SOAP yaklasimi, ozellikle kurumsal musteri segmentinde yaygin olan guvenlik ve islem butunlugu gereksinimlerini karsilamaktadir. Ancak SOAP'in XML tabanli yapisi, entegrasyon gelistirme surecini REST'e kiyasla daha karmasik hale getirebilir.
SAP
SAP, hem SOAP (RFC/BAPI) hem de REST (OData) protokollerini destekleyen kapsamli bir API ekosistemine sahiptir. SAP RFC (Remote Function Call), ABAP fonksiyonlarini uzaktan cagirmak icin kullanilir. SAP OData servisleri ise REST tabanli modern entegrasyon imkani sunar. SAP S/4HANA ile birlikte OData ve REST API'lere agirlik verilmektedir.
Mikro
Mikro ERP, veritabani duzeyi entegrasyon ve web servis destegi sunmaktadir. Mikro'nun entegrasyon arayuzleri, ozellikle KOBI segmentinde yaygin kullanim alanina sahiptir. UBS Bilisim olarak Mikro ile hem veritabani hem de servis tabanli entegrasyonlar gerceklestirmekteyiz.
Odoo
Odoo, acik kaynakli yapisi ile REST API ve XML-RPC protokollerini destekler. Odoo'nun REST API'si, modern JSON tabanli veri alisverisi sunar ve Python ekosistemi ile uyumlu calisir. Odoo'nun modüler yapisi, API uzerinden hemen hemen tum modullere erisim imkani tanir.
Hangi Protokolu Secmelisiniz? Karar Kriterleri
REST Tercih Edilmesi Gereken Senaryolar
- E-ticaret entegrasyonlari: Web sitesi, mobil uygulama ve pazar yeri entegrasyonlarinda REST'in hafif yapisi ve JSON formati idealdir.
- Gercek zamanli stok ve siparis senkronizasyonu: Dusuk gecikme suresi gerektiren islemlerde REST ustundur.
- Mobil uygulama entegrasyonlari: Mobil cihazlarin sinirli bant genisligi ve islem gucu icin REST'in hafif yapisi uygundur.
- Mikroservis mimarisi: Modern bulut tabanli uygulamalarda REST, mikroservisler arasi iletisim icin standart haline gelmistir.
- Hizli prototipleme: REST API'lerin gelistirilmesi ve test edilmesi SOAP'a gore daha kolay ve hizlidir.
SOAP Tercih Edilmesi Gereken Senaryolar
- Finansal islemler: Fatura, odeme ve muhasebe islemleri gibi veri butunlugu kritik olan senaryolarda SOAP'in WS-AtomicTransaction destegi onemlidir.
- Kurumsal guvenlik gereksinimleri: Mesaj duzeyinde sifreleme ve dijital imza gerektiren uygulamalarda WS-Security avantaj saglar.
- Karmasik is surecleri: Cok adimli, dagitik islemler ve orkestrasyon gerektiren senaryolarda SOAP'in WS-BPEL destegi faydalidir.
- Legacy sistem entegrasyonu: Eski kurumsal yazilimlarla entegrasyonda SOAP, daha yaygin olarak desteklenmektedir.
- Sozlesme oncelikli gelistirme: WSDL ile tanimli, kesin tipli (strongly-typed) entegrasyonlarda SOAP net bir sozlesme saglar.
Hibrit Yaklasim: REST ve SOAP Birlikte Kullanimi
Pratikte pek cok isletme, tek bir protokole baglanmak yerine hibrit bir yaklasim benimsemektedir. Ornegin, e-ticaret ve mobil kanal entegrasyonlari icin REST API kullanilirken, muhasebe ve finansal islemler icin SOAP web servisleri tercih edilebilir. Bu yaklasim, her protokolun guclu yanlarindan yararlanarak en optimal cozumu sunar.
UBS Bilisim olarak gelistirdigimiz ExtraDepo depo yonetim sistemi, bu hibrit yaklasimi basariyla uygulamaktadir. ExtraDepo, Logo REST API uzerinden stok ve siparis verilerini gercek zamanli senkronize ederken, Netsis SOAP servisleri uzerinden fatura ve irsaliye islemlerini gerceklestirir. Bu sayede her ERP'nin sundugu en iyi entegrasyon kanalini kullanarak yuksek performans ve guvenilirlik saglar.
API Entegrasyonunda En Iyi Uygulamalar
1. API Guvenlik Standartlari
API entegrasyonlarinda guvenlik, tasarim asamasindan itibaren once dusunulmesi gereken bir konudur. HTTPS kullanimi zorunlu olmalidir. OAuth 2.0 veya API Key tabanli kimlik dogrulama uygulanmalidir. API erisim loglari tutulmali ve duzenli olarak denetlenmelidir. Rate limiting (istek sinirlandirma) uygulanarak kotu niyetli veya hatali istemcilerin sistemi etkisiz hale getirmesi onlenmelidir.
2. Hata Yonetimi ve Yeniden Deneme Mekanizmasi
API entegrasyonlarinda hata yonetimi kritiktir. Gecici hatalar (ag kesintisi, sunucu yuklenmesi) icin otomatik yeniden deneme (retry) mekanizmasi uygulanmalidir. Usterel geri cekilme (exponential backoff) stratejisi ile yeniden deneme araliklari kademeli olarak arttirilmalidir. Kalici hatalarda ise uyari mekanizmalari devreye girmeli ve ilgili ekipler bilgilendirilmelidir.
3. Veri Donusumu ve Eslestirme
Farkli sistemler, ayni kavrami farkli veri yapilari ile temsil edebilir. Ornegin, ERP'deki "musteri kodu" ile e-ticaret platformundaki "customer_id" arasinda eslestirme (mapping) yapilmalidir. Bu eslestirme katmani, entegrasyonun esnekligini ve bakim kolayligini dogrudan etkiler.
4. API Versiyonlama
API'ler zamanla degisir ve gelisir. Versiyonlama stratejisi (/api/v1/, /api/v2/) uygulanarak mevcut entegrasyonlarin bozulmasmasi garanti altina alinmalidir. Eski versiyonlar icin kullanim sonu (deprecation) surecleri acik ve net tanimlanmalidir.
5. Dokumantasyon ve Test
Kapsamli API dokumantasyonu, entegrasyon gelistirme suresini onemli olcude kisaltir. Swagger/OpenAPI (REST) veya WSDL (SOAP) ile otomatik dokumantasyon olusturulmalidir. Postman veya SoapUI gibi araclarla API testleri duzenlı olarak yapilmalidir.
API Entegrasyon Performans Optimizasyonu
Yuksek hacimli ERP entegrasyonlarinda performans kritik bir konudur. Asagidaki stratejiler, API entegrasyon performansini onemli olcude artirabilir:
- Sayfalama (Pagination): Buyuk veri setleri, sayfalama ile parcalanarak iletilmelidir. Her istekte binlerce kayit cekmek yerine 50-100 kayitlik sayfalar kullanilmalidir.
- Secici alan sorgulama (Field Selection): Sadece ihtiyac duyulan alanlar sorgulanmalidir. Tum alanlari cekmek gereksiz veri transferine neden olur.
- Toplu islem (Batch Processing): Birden fazla islem, tek bir API cagrisi ile toplu olarak gerceklestirilmelidir. Ornegin, 100 stok guncellemesi icin 100 ayri istek yerine tek bir toplu guncelleme istegi gonderilmelidir.
- Onbellekleme (Caching): Sik degismeyen veriler (urun katalogu, fiyat listesi) onbellekte tutularak gereksiz API cagrilari azaltilmalidir.
- Asenkron islem: Uzun suren islemler (buyuk rapor uretimi, toplu veri aktarimi) asenkron olarak calistirilmali ve sonuc hazir oldugunda bildirim gonderilmelidir.
Gercek Dunya Senaryosu: E-Ticaret - ERP API Entegrasyonu
Bir KOBI'nin e-ticaret sitesini Logo ERP ile entegre ettigini dusunelim. Bu senaryoda su API entegrasyonlari gereklidir:
- Urun senkronizasyonu: ERP'deki urun bilgileri (ad, aciklama, fiyat, stok) REST API ile e-ticaret platformuna aktarilir. Urun guncellendignde webhook ile platform bilgilendirilir.
- Stok guncelleme: Depoda mal kabul veya sevkiyat yapildiginda, stok miktari REST API uzerinden gercek zamanli olarak e-ticaret platformuna yansitilir.
- Siparis aktarimi: E-ticaret platformundan gelen siparisler, REST API ile ERP'ye otomatik olarak aktarilir. Siparis durumu degisiklikleri iki yonlu olarak senkronize edilir.
- Fatura olusturma: Siparis onaylandi ve sevk edildignde, ERP'de otomatik olarak e-fatura olusturulur. Bu islem, veri butunlugu gerektirdiginden SOAP servisi tercih edilebilir.
- Kargo entegrasyonu: Kargo firmalarinin API'leri ile entegrasyon saglarnarak takip numarasi otomatik olarak ERP ve e-ticaret platformuna yazilir.
Bu senaryoda REST API, stok ve siparis gibi yuksek frekanli islemler icin kullanilirken, fatura gibi kritik finansal islemler icin SOAP veya REST'in guvenlik katmanlari ile guclendirmis versiyonu tercih edilir.
API Entegrasyonunda Yaygin Hatalar ve Cozumleri
- Yetersiz hata yonetimi: API hatalarini yakalamamak veya loglamak, sorunlarin gec fark edilmesine neden olur. Her API cagrisi icin try-catch mekanizmasi ve detayli loglama uygulanmalidir.
- Guvenlik ihmalları: API anahtarlarini kod icinde sabit olarak tutmak, HTTPS kullanmamak veya yetkilendirme kontrolu yapmamak ciddi guvenlik aciklarina yol acar.
- Rate limit gozardi etme: ERP API'lerinin istek limitlerini asarak sunucuyu yuklemek, hem performans sorunlarina hem de erisim engeline neden olabilir.
- Veri tutarliligini ihmal etme: Farkli sistemler arasinda veri eslestirme hatalar, stok tutarsizligi ve fatura hatalarina yol acar.
- Test eksikligi: Entegrasyonu yeterince test etmeden canlia almak, uretim ortaminda beklenmeyen hatalara neden olur.
Gelecek Trendler: GraphQL ve gRPC
REST ve SOAP disinda, yeni nesil API protokolleri de ERP entegrasyonunda dikkat cekmektedir. GraphQL, istemcinin tam olarak ihtiyac duydugu verileri sorgulamasina olanak tanir ve over-fetching/under-fetching sorunlarini ortadan kaldirir. gRPC ise Google tarafindan gelistirilen yuksek performansli bir RPC framework'udur; Protocol Buffers ile binary veri serializasyonu saglayarak REST'e kiyasla 5-10 kat daha hizli calisabilir.
Ancak su an icin Turkiye'deki ERP ekosistemerinde REST ve SOAP baskin protokoller olmaya devam etmektedir. GraphQL ve gRPC, ozellikle mikro servis tabanli yeni nesil ERP cozumlerinde onumuzdeki yillarda daha yaygin kullanim alani bulacaktir.
Sonuc
ERP API entegrasyonu, isletmelerin dijital donusum yolculugundaki en kritik adimlardan biridir. REST ve SOAP, farkli guclu yanlara sahip iki olgun protokoldur. REST, hafif yapisi, JSON destegi ve yuksek performansiyla modern entegrasyon senaryolari icin idealdir. SOAP ise kurumsal guvenlik, islem butunlugu ve karmasik is surecleri icin guclu bir secenek sunmaktadir.
Dogru protokol secimi, isletmenizin ihtiyaclarina, kullandiginiz ERP sistemine ve entegrasyon senaryolariniza baglidir. Cogu durumda hibrit bir yaklasim, her iki protokolun avantajlarindan yararlanarak en optimal sonucu verir.
ERP API entegrasyonu teknik uzmanlk gerektiren bir sureçtir. Deneyimli bir is ortaklari ile calisarak, entegrasyon projenizin basarili bir sekilde tamamlanmasini saglayabilirsiniz. UBS Bilisim olarak Logo, Mikro, Netsis, Odoo ve SAP ERP sistemleriyle API entegrasyon konusunda kapsamli deneyimimizle yaninizdayiz.