Entegrasyon ve API geliştirme

Hangi sorunu çözüyoruz?

Pazaryerinden gelen sipariş elle muhasebe programına giriliyor, faturası ayrıca kesiliyor, kargo kodu kopyalanıp müşteriye iletiliyor. Her elle taşınan kayıt hem zaman kaybı hem hata ihtimalidir.

Sorun büyüdükçe tablo daha da karışır: stok bir yerde düşüyor ama diğer satış kanalında görünmüyor, aynı sipariş iki kez faturalanıyor, iade muhasebeye hiç yansımıyor.

Entegrasyon bu adımları otomatikleştirir. Ama iyi bir entegrasyon yalnızca veriyi taşımaz; taşıyamadığında bunu fark eder, tekrar dener ve kimin müdahale etmesi gerektiğini bildirir.

Ne yapıyoruz?

e-Fatura, e-Arşiv ve e-İrsaliye

Çalıştığınız özel entegratörün servisleriyle otomatik belge kesimi, durum takibi ve iptal/iade akışları. Belgenin GİB'e ulaşıp ulaşmadığı ve alıcının yanıtı panelde izlenir.

Muhasebe ve ERP programları

Logo, Mikro, Netsis ve benzeri programlarla cari kart, stok kartı, sipariş, fatura ve tahsilat aktarımı. Programın sürümüne göre resmi servisler veya kontrollü veritabanı erişimi kullanılır.

Pazaryerleri ve e-ticaret altyapıları

Ürün, stok, fiyat ve sipariş senkronizasyonu; iade ve iptallerin muhasebeye yansıması. Birden fazla satış kanalında stokun tek kaynaktan yönetilmesi.

Ödeme sistemleri

Sanal POS, 3D Secure, taksit, kart saklama (tokenizasyon), abonelik ve iade akışları. Kart verisi sizin sunucunuza hiç uğramayacak şekilde ödeme kuruluşunun altyapısı kullanılır.

Kargo firmaları

Gönderi oluşturma, etiket basma, takip numarasının müşteriye iletilmesi ve teslim durumunun siparişe geri yazılması.

Kendi API'niz

İş ortaklarınızın, bayilerinizin veya mobil uygulamanızın kullanacağı dokümante, sürümlenmiş ve kimlik doğrulamalı API. OpenAPI belgesi ve test ortamı ile teslim edilir.

İyi bir entegrasyonu ne ayırır?

Bu ayrıntılar ilk gün görünmez; sorun ilk yoğun kampanya döneminde veya karşı sistemin bakım saatinde ortaya çıkar. Bu yüzden hata senaryolarını en baştan tasarıma dahil ederiz.

Asıl kaynak ilkesi: her veri tek bir yerde doğar

Entegrasyon projelerindeki karışıklığın çoğu, aynı verinin birden fazla sistemde düzenlenebilmesinden doğar. Bir stok kartı hem ERP'de hem pazaryeri panelinde değiştirilebiliyorsa, hangisinin doğru olduğu bir süre sonra bilinemez.

Bu yüzden her veri türü için tek bir asıl kaynak belirleriz; diğer sistemler bu kaynağı yalnızca okur. Aşağıdaki tablo tipik bir e-ticaret ve muhasebe yapısı için örnektir; sizin yapınıza göre birlikte doldurulur.

Gerçek zamanlı mı, aralıklı mı?

Her verinin anında aktarılması gerekmez ve her anlık aktarım ek maliyet ve karmaşıklık getirir. Aktarım sıklığını verinin iş etkisine göre belirleriz.

• Anlık (webhook / olay tabanlı): Stok düşüşü, ödeme sonucu, sipariş durumu gibi gecikmesi doğrudan satış veya müşteri deneyimi kaybına yol açan veriler.
• Kısa aralıklı: Fiyat güncellemeleri ve kargo takip durumları; birkaç dakikalık gecikme sorun yaratmaz.
• Günlük toplu: Raporlama, mutabakat ve arşivleme; gece çalışan toplu aktarımlar sistemleri gün içinde yormaz.

Başkasının kurduğu entegrasyonu devralmak

Sık karşılaştığımız bir durum: entegrasyonu kuran kişi veya firma artık ulaşılabilir değil, entegrasyon arada bir duruyor ve kimse nedenini bilmiyor. Bu durumda önce mevcut kodu ve logları inceler, hangi senaryolarda kayıt kaybedildiğini raporlarız.

Ardından ya mevcut entegrasyonu izleme ve yeniden deneme mekanizmasıyla güçlendiririz ya da daha düşük maliyetliyse yeniden yazarız. Karar, raporla birlikte gerekçeli olarak size sunulur.

Entegrasyon izleme paneli

Kurduğumuz her entegrasyon, aktarımların durumunu gösteren bir panelle teslim edilir. Ekibiniz teknik bilgiye ihtiyaç duymadan neyin aktarıldığını, neyin beklediğini ve neyin hata verdiğini görür.

• Hatalı kayıtlar nedeniyle birlikte listelenir; düzeltildikten sonra tek tuşla yeniden gönderilir.
• Günlük özet raporu, aktarılan ve hata veren kayıt sayılarını içerir.
• Karşı sistemin yanıt süresi ve erişilebilirliği izlenir; uzun süreli kesintide uyarı üretilir.

Nasıl çalışıyoruz?

1. Veri akışı haritası: Hangi verinin hangi sistemden hangisine, hangi olayla ve hangi sıklıkta gideceğini tek bir şemada çıkarırız. Hangi sistemin hangi verinin "asıl kaynağı" olduğu burada netleşir.
2. Eşleştirme kuralları: Cari kodları, stok kodları, KDV oranları, birimler ve depo karşılıkları tablolaştırılır. Entegrasyon hatalarının çoğu bu tablonun eksik olmasından kaynaklanır.
3. Test ortamında geliştirme: Karşı sistemlerin test ortamları kullanılır; test ortamı yoksa canlı veriye dokunmayan bir doğrulama yöntemi kurulur.
4. Paralel çalıştırma: Entegrasyon bir süre elle yapılan işle yan yana çalışır, sonuçlar karşılaştırılır.
5. Yayın ve izleme: Canlıya geçişten sonra ilk günler yakından izlenir, eşleştirme tablosundaki eksikler tamamlanır.

Örnek kullanım senaryoları

• Pazaryeri → muhasebe: Pazaryerinden gelen sipariş otomatik olarak cari ve faturaya dönüşür, e-arşiv fatura kesilir, kargo etiketi basılır, takip numarası pazaryerine geri yazılır.
• B2B portal → ERP: Bayi portalında verilen sipariş, onaydan sonra ERP'ye düşer; bayi cari bakiyesini portalda anlık görür.
• Abonelik tahsilatı: Her ay kart üzerinden tahsilat yapılır, başarısız ödemeler belirli aralıklarla yeniden denenir, faturası otomatik kesilir.
• Tedarikçi fiyat listesi: Tedarikçinin gönderdiği fiyat ve stok dosyası düzenli olarak okunur, kâr marjı kuralına göre satış fiyatları güncellenir.
• Banka hareketleri: Banka hesap hareketleri düzenli olarak alınır, açıklamadaki referansa göre ilgili cari ile eşleştirilir; eşleşmeyen tahsilatlar muhasebe ekibinin onayına düşer.

İlgili çalışmalarımız

Şarjlı Enerji projesinde şarj oturumu, istasyon verisi ve mobil ödemeyi tek akışta birleştiren entegrasyonları kurduk. Üreticy ise cihazlardan gelen verinin API üzerinden diğer sistemlere açıldığı bir örnektir.

Güvenlik

• API anahtarları ve parolalar kod içinde değil, şifreli yapılandırmada tutulur ve düzenli yenilenebilir.
• Webhook istekleri imza ile doğrulanır; doğrulanamayan istek işlenmez ve güvenlik kaydına yazılır.
• Kişisel veri içeren aktarımlarda yalnızca gerekli alanlar taşınır (veri minimizasyonu).
• Kendi API'niz yayına alınmadan önce API güvenlik testinden geçirilir.

Fiyatı etkileyen faktörler

• Bağlanacak sistem sayısı ve bu sistemlerin API'lerinin olgunluğu.
• Aktarılan veri türleri ve eşleştirme kurallarının karmaşıklığı.
• Gerçek zamanlı mı, belirli aralıklarla mı çalışacağı.
• Karşı sistemin test ortamı sunup sunmadığı.
• İzleme paneli ve raporlama gereksinimleri.

Karşı tarafın API'si değiştiğinde entegrasyonun da güncellenmesi gerekir. Bu güncellemeleri bakım paketi kapsamında takip ederiz.

Sık sorulan sorular