Projenizi anlatın

API ve sistem entegrasyonu

API entegrasyonuyla kullandığınız yazılımları birbirine bağlıyoruz: siparişler pazaryerinden ERP’ye, faturalar e-Fatura entegratörüne, kargo bilgisi müşteriye kendiliğinden gider. Gerekirse sisteminizin dışarıya açılan API’sini de biz yazarız.

Sunucu odasında, bir kabindeki ağ anahtarına mavi ağ kablosu takan el
Tipik süre
2–8 hafta
Platform
REST, SOAP, webhook
Teslimde
Servisler, izleme, dokümantasyon
İzleme
Aktarım kaydı ve uyarılar

API & entegrasyon nedir, neden gerekir

API (uygulama programlama arayüzü), iki yazılımın birbiriyle konuşmak için kullandığı kapıdır. Bir pazaryerindeki sipariş bu kapı sayesinde muhasebe programınıza kendiliğinden düşer; bir ödeme onaylandığında stok otomatik olarak azalır. Entegrasyon ise bu konuşmanın kurallarını yazmaktır: hangi veri, ne zaman, hangi biçimde gidecek ve hata olursa ne yapılacak.

Entegrasyonu olmayan işletmelerde aynı bilgi birkaç kez elle girilir: sipariş pazaryeri panelinden kopyalanır, ERP’ye yazılır, kargo firmasının sitesine yeniden girilir. Her elle giriş hem zaman kaybı hem hata riskidir; yanlış adrese giden bir kargo ya da iki kez kesilen bir fatura bunun tipik sonuçlarıdır.

Olimpos Yazılım entegrasyonları “çalışıyor” düzeyinde bırakmaz, izlenebilir kurar. Her veri aktarımı kayda geçer; karşı sistem yanıt vermezse aktarım kuyruğa alınıp yeniden denenir, aynı sipariş iki kez işlenmez, kalıcı bir hata olduğunda ilgili kişiye bildirim gider. REST ve GraphQL gibi güncel API türlerinin yanında, kurumsal ve kamu sistemlerinde hâlâ yaygın olan SOAP servisleri, FTP üzerinden dosya alışverişi ve doğrudan veritabanı bağlantısıyla da çalışırız.

Hizmete dahil olanlar

7 kalem; kapsam görüşmesinde ihtiyacınıza göre daraltılır ya da genişletilir.

  • Entegrasyon haritası

    Hangi sistemin hangi veriyi, hangi sıklıkla ve hangi yönde gönderdiğini gösteren şema; veri alanlarının sistemler arası eşleştirme tablosu.

  • Bağlantı servisleri

    Sistemler arasında veriyi taşıyan, dönüştüren ve doğrulayan ara katman servisleri.

  • Kuyruk ve yeniden deneme

    Karşı sistem geçici olarak yanıt vermediğinde verinin kaybolmaması için kuyruk yapısı; aynı kaydın iki kez işlenmesini önleyen kontroller.

  • İzleme paneli

    Her aktarımın durumunu, hatalarını ve yeniden gönderim seçeneğini gösteren ekran; kritik hatalarda e-posta ya da SMS uyarısı.

  • Dışa açık API

    Bayilerinizin, iş ortaklarınızın ya da mobil uygulamanızın kullanacağı, kimlik doğrulamalı ve istek sınırlı REST API.

  • API dokümantasyonu

    OpenAPI (Swagger) standardında, örnek isteklerle belgelenmiş uç noktalar ve iş ortaklarınız için ayrı bir test ortamı.

  • Güvenlik

    Anahtar ve token yönetimi, şifreli bağlantı, IP kısıtlama ve erişim kayıtları.

Nasıl ilerliyoruz

API & entegrasyon projelerinde izlediğimiz 5 adım.

  1. Sistem envanteri

    Kullandığınız yazılımları ve her birinin entegrasyon imkânlarını (API, dosya, veritabanı) çıkarırız. Bazı sağlayıcılar API erişimini ayrı bir paket olarak sunar; bunu baştan tespit ederiz.

  2. Veri eşleştirme

    Ürün kodu, cari kodu, KDV oranı ve birim gibi alanların sistemler arasında nasıl karşılık bulacağını ekibinizle birlikte netleştiririz.

  3. Geliştirme ve test

    Entegrasyonu sağlayıcıların test ortamlarında kurar, gerçek senaryolara benzeyen verilerle baştan sona deneriz.

  4. Kontrollü yayın

    Önce sınırlı sayıda kayıtla canlıya alır, sonuçları elle kontrol eder, ardından bütün akışı açarız.

  5. İzleme ve bakım

    Karşı sistemler API’lerini zaman zaman değiştirir. İzleme ve bakım anlaşmasıyla bu değişiklikleri takip eder, entegrasyonu güncel tutarız.

Kimler için

API & Entegrasyon çoğunlukla şu durumlarda işe yarar.

E-ticaret ve pazaryeri satıcıları

Trendyol, Hepsiburada ve Amazon gibi pazaryerlerinde ve kendi sitesinde satış yapıp stoku, siparişi ve faturayı tek yerden yönetmek isteyen firmalar.

Muhasebe ve ERP bağlantısı

Satış, CRM ya da üretim sistemindeki hareketlerin Logo, Mikro ve Netsis gibi programlara kendiliğinden aktarılmasını isteyen işletmeler.

Bayi ve iş ortağı entegrasyonu

İş ortaklarının stok, fiyat ve sipariş bilgisine API üzerinden erişmesini isteyen üretici ve distribütörler.

Otel ve acente sistemleri

Otel yönetim sistemi (PMS), kanal yöneticisi, rezervasyon motoru ve acente sistemleri arasında oda, fiyat ve rezervasyon bilgisinin elle girilmeden aktarılması.

Teknolojiler

  • REST
  • GraphQL
  • SOAP
  • Webhook
  • OpenAPI
  • Node.js
  • NestJS
  • Python
  • FastAPI
  • Redis
  • PostgreSQL
  • Docker

API & entegrasyon hakkında sorular

Kullandığım programın API’si yoksa entegrasyon yapılabilir mi?
Çoğu durumda evet. API yoksa programın veritabanına kontrollü erişim, dışa ve içe aktarım dosyalarının (Excel, CSV, XML) otomatik işlenmesi ya da programın sunduğu başka bir bağlantı yöntemi kullanılabilir. Bu yöntemlerin riskleri farklıdır; örneğin veritabanına doğrudan yazmak, program güncellendiğinde bozulabilir. Sistem envanterini çıkardıktan sonra en sağlam yolu ve sınırlarını yazılı olarak söyleriz.
Zapier ya da Make gibi hazır araçlar yerine neden özel entegrasyon?
Basit ve düşük hacimli akışlar için bu araçlar gerçekten iyidir; ihtiyacınız buysa bunu önerir, kurulumuna yardım ederiz. Özel entegrasyon şu durumlarda öne çıkar: günde binlerce kayıt aktarılıyorsa ve işlem başı ücretler büyüyorsa, aktarımda karmaşık iş kuralları varsa (fiyat hesaplama, stok rezervasyonu), Türkiye’ye özgü ve hazır araçta bulunmayan sistemlere bağlanılacaksa ya da verinin üçüncü bir platformdan geçmesi KVKK açısından istenmiyorsa.
Entegrasyon bozulursa nasıl haberimiz olur?
Her aktarım kayda geçer ve izleme panelinde görünür. Karşı sistem geçici olarak yanıt vermezse aktarım kuyruğa alınır ve belirli aralıklarla yeniden denenir; bu sırada veri kaybolmaz. Denemeler sonuçsuz kalırsa ya da veri hatalıysa (örneğin eşleşmeyen bir ürün kodu) belirlediğiniz kişilere e-posta veya SMS uyarısı gider; kayıt panelden düzeltilip yeniden gönderilebilir.
e-Fatura ve e-Arşiv entegrasyonu nasıl çalışıyor?
e-Fatura ve e-Arşiv faturaları Gelir İdaresi Başkanlığı’na (GİB) çoğunlukla bir özel entegratör aracılığıyla iletilir. Sisteminiz faturayı oluşturup entegratörün API’sine gönderir; entegratör faturayı GİB’e iletir ve sonucu geri bildirir. Biz bu bağlantıyı, fatura durumlarının (gönderildi, kabul edildi, reddedildi) sisteminize geri yazılmasını ve hatalı faturaların raporlanmasını kurarız. Hangi entegratörle çalıştığınızı ilk görüşmede sorarız; çoğunun belgeli bir API’si vardır.
Pazaryeri entegrasyonunda hangi işlemler otomatikleşir?
En yaygın olanlar ürün ve fiyat gönderimi, stok eşitleme, siparişlerin çekilmesi, kargo firması ve takip numarasının iletilmesi, iade ve iptal durumlarının alınmasıdır. Birden fazla pazaryerinde satış yapıyorsanız stok tek merkezden yönetilir; bir kanalda satılan ürün diğerlerinde de düşer. Pazaryerlerinin API kuralları ve istek sınırları birbirinden farklıdır; entegrasyonu bu sınırlara göre zamanlarız.
Kendi sistemimiz için dışa açık bir API yazdırmak istiyoruz. Neler dahil?
Kimlik doğrulama (API anahtarı ya da OAuth), yetkilendirme, istek sınırlama, sürümleme ve dokümantasyon. Dokümantasyonu OpenAPI standardında hazırlar, iş ortaklarınızın deneyebileceği bir test ortamı açarız. API’yi sonradan değiştirmek onu kullanan herkesi etkilediği için uç noktaları ve veri yapısını baştan dikkatle tasarlar, kırıcı değişiklikleri yeni sürüm olarak yayımlarız.
Mavi saatte falezlerin üstünde uzanan bir kıyı kenti, arkasında dağlar

API & entegrasyon projenizi anlatın

Ne yapmak istediğinizi birkaç cümleyle yazın; Muratpaşa ofisimizde ya da görüntülü görüşmede kapsamı ve süreyi netleştirelim.

Projenizi anlatın