Hazır Yazılım Entegrasyonu: API, Veri ve Test Kontrol Listesi

Hazır yazılım kullanmak, bütün işlerin tek bir sistemde yürütüleceği anlamına gelmez. Satışlar e-ticaret sitesinde, müşteri görüşmeleri CRM'de ve stok hareketleri ERP'de tutulabilir. Entegrasyonun amacı, bu sistemler arasında hangi bilginin ne zaman aktarılacağını açık bir kurala bağlamaktır.

Örneğin e-ticaret siparişi ERP'ye aktarılırken müşteri, ürün kodu ve miktar bilgisi gerekir. ERP'deki stok bilgisinin siteye dönmesi ise ayrı bir akıştır. Bu yazı, hazır yazılımınız için bağlantı çalışması istemeden önce hazırlayabileceğiniz kapsamı anlatır.

İlk soru: sistem hangi bağlantı yöntemini destekliyor?

Sağlayıcıya API, olay bildirimi (webhook) veya dosya aktarımı desteğini sorun. API, bir sistemin belirli kayıtları diğer sistemden istemesine veya göndermesine olanak verir. Webhook, belirli bir olay oluştuğunda bildirim gönderilmesidir. CSV gibi dosya aktarımı ise daha seyrek güncellenen süreçlerde değerlendirilebilir. Desteklenen yöntem, kullandığınız ürün ve abonelik kapsamıyla birlikte doğrulanmalıdır.

Bağlantı dokümanına erişim, test ortamı, kullanım sınırları ve desteklenen alanlar netleşmeden “bütün sistemler bağlanır” varsayımıyla teklif hazırlamayın. Mevcut hazır bağlantı varsa hangi işlemleri desteklediğini örnek üzerinde görün.

Hangi sistem esas kayıt kaynağı olacak?

Aynı bilgi iki tarafta da değiştirilebiliyorsa hangisinin geçerli olduğunu belirlemek gerekir. Örneğin ürün adı ERP'de, web açıklaması e-ticaret panelinde yönetilebilir. Bu durumda her alanın kaynağı ayrı tanımlanır. Tek bir “iki yönlü entegrasyon” ifadesi bu kararların tamamını açıklamaz.

Basit bir kapsam örneği:

• Ürün kodu ve stok miktarı: ERP'den siteye
• Yeni sipariş: siteden ERP'ye
• Kargo takip numarası: teslimat sisteminden siteye
• Müşteri notu: belirlenen sorumlu sistemde tutulur; aktarılıp aktarılmayacağı ayrıca kararlaştırılır

Bu örnek genel bir taslaktır; kullandığınız ürünlerin gerçekten hangi alanları sunduğu kontrol edilmelidir.

Kayıtlar nasıl eşleştirilecek?

Ürün adı gibi değişebilir bir metin yerine, iki sistemde de takip edilebilecek ürün veya kayıt kimliği belirleyin. Birim, tarih ve sayı biçimleri için örnekler hazırlayın. “Adet” ve “koli” bilgisinin aynı miktar gibi yorumlanması, başarılı görünen bir aktarımda bile yanlış sonuç üretebilir.

Önceki veriler hazırlanacaksa veri temizliği ve eşleştirme rehberimiz başlangıç kontrolü olarak kullanılabilir.

Bağlantı kesilirse ve aynı kayıt tekrar gelirse ne olur?

İstek zaman aşımına uğradığında işlem karşı tarafta tamamlanmış olabilir. Yeniden deneme aynı siparişi ikinci kez oluşturmamalıdır. Aynı kayıt kimliğiyle gelen tekrarın nasıl ele alınacağı, hata kayıtlarının nerede görüleceği ve yeniden denemelerin nasıl sınırlandırılacağı tasarlanmalıdır. Microsoft'un API uygulama rehberi, bağlantı davranışları için teknik bir başvuru kaynağıdır.

İşletme tarafında şu senaryoyu sağlayıcıya sorun: “Bir sipariş aktarılamadığında bunu kim görecek, nasıl düzeltecek ve kaydın son durumunu nereden kontrol edecek?” Operasyon sorumlusu için kullanılabilir bir cevap, yalnızca teknik hata kodundan daha değerlidir.

Bağlantıya hangi erişimler verilecek?

Entegrasyon için gereken okuma ve yazma işlemlerini belirleyin. Bağlantı hesabına yalnızca ihtiyaç duyduğu erişimlerin verilmesi, gereksiz yetkileri azaltır. API anahtarlarının kullanıcı arayüzlerinde veya paylaşılan belgelerde açık tutulmaması gerekir. Bu yaklaşım için OWASP yetkilendirme rehberi incelenebilir.

Testte yalnızca başarılı örneğe bakmayın

• Yeni siparişin doğru ürün ve miktarla aktarılması
• Aynı kaydın tekrar gönderilmesi
• Eksik ürün kodu ve tanınmayan kayıt
• İptal veya düzeltme işlemi
• Bağlantı kesintisi sonrası bekleyen kayıtlar
• İki sistemdeki örnek kayıtların karşılaştırılması

Her kontrol için beklenen sonucu ve kabul edecek kişiyi belirleyin. Canlı geçişten sonra bağlantının bakımını kimin yapacağı, ürün sürümü değiştiğinde kimin kontrol edeceği ve destek kanalının ne olduğu da kapsamda yer alsın.

Hazır ürünün uygunluğunu değerlendiriyorsanız özel yazılım ve hazır yazılım karşılaştırmamızı okuyabilirsiniz. İhtiyacınız bir yönetim paneli veya sistemler arası bağlantıysa web yazılım geliştirme hizmetimizi inceleyin. Kullandığınız sistemleri ve aktarılacak kayıtları teklif formunda paylaşarak kapsam değerlendirmesine başlayabilirsiniz.