MÜH API ve entegrasyon

Sistemleriniz
birbiriyle konuşsun.

Sipariş e-ticaretten gelir, stok ERP’den düşer, fatura kesilir, kargo etiketi basılır — kimse bir ekrandan ötekine kopyala-yapıştır yapmadan. Bağlantı koptuğunda da veri kaybolmaz: kuyruğa alınır, yeniden denenir, size haber verilir.

  • ERP · muhasebe · e-ticaret
  • Kargo · POS · e-fatura
  • Hata kuyruğu ve yeniden deneme
  • İzlenebilir her istek
entegrasyon katmanı — sipariş #S-20871akış sürüyor
kuyrukta · 30 sn sonra tekrar
Temsilî canlandırma
aşağı
HAT Bir entegrasyon nasıl kurulur

Kablo kolay bağlanır. Kopunca ne olacağı zordur.

İki sistemi birbirine bağlamak çoğu zaman bir günlük iştir. Asıl iş; bağlantı koptuğunda, veri hatalı geldiğinde ya da karşı taraf sürüm değiştirdiğinde ne olacağını önceden kurmaktır.

Birbirine dolanmış eski kablolar
01 · Envanter

Önce kimin kime, neyi, ne sıklıkla gönderdiğini çizeriz.

Hangi sistemin hangi verinin sahibi olduğunu, nerede elle aktarım yapıldığını ve hangi alanların birbirine karşılık geldiğini çıkarırız. Çoğu zaman sorunun yarısı bu haritada çözülür.

  • Sistem ve veri sahipliği haritası
  • Alan eşleme tablosu (ürün kodu, cari, vergi no…)
  • Elle yapılan aktarımların listesi
Düzenli patch panel
02 · Sözleşme ve tasarım

Her bağlantının yazılı bir sözleşmesi olur.

API’nin ne alıp ne döndüğü, hata kodları ve sürümleri OpenAPI ile belgelenir. Senkron mu, kuyruklu mu, webhook mu — her akış için doğru yöntemi seçeriz.

  • OpenAPI belgeleri ve örnek istekler
  • Kuyruk, webhook ve zamanlanmış görev tasarımı
  • Kimlik doğrulama ve hız sınırları
Konveyör bantta ilerleyen kargo paketleri
03 · Hata dayanıklılığı

Karşı taraf düştüğünde sipariş düşmez.

Başarısız istekler kuyruğa alınır, artan aralıklarla yeniden denenir; aynı istek iki kez işlenmez. Düzelmeyen hatalar bir panelde birikir ve size bildirilir.

  • Kuyruk ve artan aralıklı yeniden deneme
  • Tekrar işlemeye karşı koruma
  • Hata paneli ve alarm
Işık hatlarıyla bağlı sistemler
04 · İzleme ve bakım

Her isteğin izi sürülebilir.

Hangi siparişin hangi sistemden ne zaman geçtiğini tek bir kayıttan görürsünüz. Karşı taraf API’sini değiştirdiğinde testler bunu sizden önce yakalar.

  • İstek bazlı kayıt ve arama
  • Sözleşme testleri
  • Sürüm değişikliklerine uyum
NE Bağladığımız sistemler

Türkiye’de işin döndüğü her uç.

E-ticaret ve pazar yerleri

Kendi mağazanız ve pazar yerleri arasında ürün, stok, fiyat ve sipariş eşitleme.

ERP ve muhasebe

Cari, stok, sipariş ve faturanın muhasebe yazılımınıza otomatik aktarımı.

e-Fatura ve e-Arşiv

Entegratörünüz üzerinden otomatik fatura kesimi ve durum takibi.

Kargo firmaları

Gönderi oluşturma, etiket, takip numarası ve teslim bilgisi.

Sanal POS ve ödeme

Ödeme, iade, taksit ve 3D Secure akışları.

CRM ve iletişim

Müşteri kaydı, SMS, e-posta ve WhatsApp bildirimleri.

Size özel API

Kendi sisteminizi bayilerinize ve iş ortaklarınıza açan belgeli API.

Eski sistemler

API’si olmayan yazılımlarla veritabanı, dosya ya da köprü servisiyle bağlantı.

İLE Kullandığımız yöntemler

Doğru araç, akışın doğasına göre seçilir.

Protokol

RESTGraphQLSOAP / XMLWebhook

Taşıma

Mesaj kuyruğuZamanlanmış görevSFTP / dosya aktarımı

Güvenlik

OAuth 2.0API anahtarıİmzalı webhookIP kısıtı

Belgeleme ve test

OpenAPISözleşme testleriPostman koleksiyonları

Her yeni bağlantı bir bakım yüküdür; gerçekten gereken entegrasyonu öneririz, mümkün olan her şeyi değil.

Düzenli bağlanmış kablolar
Her bağlantının belgesi, testi ve hata planı yazılıdır.
TESLİM Elinize geçenler

Belgesiz entegrasyon, bomba gibidir.

Teslimde yalnızca çalışan bağlantılar değil, onları anlamak ve sürdürmek için gerekenler de elinizde olur:

API belgeleri

OpenAPI tanımları ve örnek istek/yanıtlar.

Akış şeması

Hangi verinin hangi sistemden nereye aktığı tek çizimde.

Hata paneli

Bekleyen, yeniden denenen ve başarısız istekler.

Test paketi

Sözleşme ve uçtan uca testler, otomatik çalışır.

Erişim listesi

Hangi sistemin hangi anahtarla bağlandığı, sizin kasanızda.

Kaynak kod

Entegrasyon katmanının kodu sizin deponuzda.

SSS Sık sorulanlar

Başlamadan önce sorulanlar.

Muhasebe programımızın API’si yok, yine de bağlanabilir mi?

Çoğu durumda evet. Programın sunduğu veri aktarım yöntemi, veritabanı erişimi ya da dosya tabanlı aktarım üzerinden güvenli bir köprü kurarız. Önce hangi yolun desteklendiğini inceleriz.

Bağlantı koptuğunda veri kaybolur mu?

Hayır. Başarısız istekler kuyruğa alınır ve artan aralıklarla yeniden denenir. Düzelmeyen hatalar bir panelde görünür ve size bildirim gider.

Aynı sipariş iki kez aktarılırsa ne olur?

Her istek benzersiz bir anahtarla işaretlenir; aynı istek ikinci kez geldiğinde yeniden işlenmez. Böylece çift fatura ya da çift stok düşümü yaşanmaz.

Pazar yerleriyle stok eşitlemesi yapabilir misiniz?

Evet. Ürün, stok, fiyat ve sipariş bilgilerini kendi sisteminiz ile pazar yerleri arasında eşitleyen entegrasyonlar kuruyoruz.

Kendi sistemimizi bayilerimize API ile açmak istiyoruz.

Belgeli, yetkilendirmeli ve hız sınırlı bir API tasarlar, bayileriniz için örnek istekler ve test ortamı hazırlarız.

Entegrasyonun bakımını yapıyor musunuz?

İsteğe bağlı olarak evet. Karşı taraf sistem sürüm değiştirdiğinde uyumu sağlar, hata panelini izleriz. Belgeler ve kod sizde olduğu için başka bir ekip de devralabilir.

POST /iletisim · 201

Hangi iki ekran arasında kopyala-yapıştır yapıyorsunuz?

Elle aktarılan veriyi anlatın; hangisinin otomatiğe değer olduğunu ve nasıl bağlanacağını birlikte çıkaralım.

Sistemlerinizi anlatın