Bir entegrasyonun çalıştığını göstermek için ekrandaki bağlantı başarılı mesajı yeterli değildir. Asıl soru, işletmenin beklediği kaydın doğru sistemde, doğru içerikle ve gereken sayıda oluşup oluşmadığıdır. Sipariş karşı tarafa ulaşmış, fakat yanıt yolda kaybolmuş olabilir. Bir stok güncellemesi daha yeni bir değişiklikten sonra gelebilir. Hata görünmese bile iki sistem farklı bir iş durumunu gösteriyor olabilir. Web yazılım kapsamındaki entegrasyon kabulünde aynı kaydın farklı zamanlarda iki kez gelmesini örnek senaryoya dahil edin.
Web yazılım entegrasyonlarında hata yönetimi bu nedenle yalnız hata yakalama kodundan ibaret değildir. İşlem kimliği, durum geçişi, yeniden deneme, karşılaştırma ve destek sorumluluğu birlikte tasarlanmalıdır. CRM ve ERP entegrasyon planlama rehberimizin devamı olan bu yazı, ilk bağlantının kurulmasından sonraki belirsizlikleri ele alır. Amaç evrensel bir kesintisizlik iddiası değil, sorun görüldüğünde hangi kanıtla hangi kararın verileceğini açıklamaktır.
Başarı ölçütünü bağlantıya değil iş sonucuna bağlayın
Her aktarım için beklenen iş sonucunu bir cümleyle yazın. Örneğin onaylı teklifin hedef sistemde bir siparişe dönüşmesi ile yalnız aktarım kuyruğuna alınması farklı sonuçlardır. Yanıt geldi, kayıt kabul edildi ve iş tamamlandı durumları birbirinin yerine kullanılmamalıdır. Alıcı sistemin sözleşmesi, hangi yanıtın hangi aşamayı doğruladığını açıkça belirtmelidir.
Web danışmanlık çalışmasında ilk kontrol, bu sonucun satış, operasyon ve teknik ekip tarafından aynı şekilde anlaşılmasıdır. İki panelin yeşil görünmesi müşteriye verilecek bilginin doğru olduğunu kanıtlamaz. Başarı koşuluna hedef kayıt kimliği, beklenen alanlar ve doğrulama yöntemi ekleyin. Bir ara durum gerçekten ara durumsa kullanıcıya da tamamlandı yerine bekliyor olarak gösterin.
İşlem kimliğini ve veri sahibini birlikte tanımlayın
Aynı işin farklı denemelerini bir arada tanımak için kararlı bir işlem kimliği gerekir. Yerel sipariş numarası, dış sistemdeki kayıt kimliği ve aktarım denemesi kimliği ayrı tutulabilir. Deneme kimliği her çalıştırmada değişebilir; fakat aynı siparişi oluşturma amacının kimliği değişmemelidir. Böylece destek ekibi bir işlemin kaç kez denendiğini, tek bir işin kaç kopyaya dönüştüğünü karıştırmadan görebilir.
İhtiyaç ve kapsam analizi sırasında hangi alanın hangi sistem tarafından yönetileceği de kararlaştırılmalıdır. Ürün açıklamasını web ekibi, kullanılabilir stok bilgisini ERP yönetiyorsa aynı alan için karşılıklı yazma akışı kurulmaz. İş kuralı gerektiren değişiklik, bağlantıyı geliştiren kişinin sessiz varsayımıyla belirlenmemelidir. Kaynağın önceliği ve çatışma çözümü, işletmenin onayladığı bir karar olarak kaydedilir.
Alan eşleştirmesinde biçim kadar anlamı da kontrol edin
Bir alanın sayısal veya metinsel olması tek başına yeterli sözleşme değildir. Tutarın hangi para birimine ait olduğu, verginin dahil olup olmadığı, boş değer ile sıfırın farkı açıklanmalıdır. Ürün kodunda baştaki sıfırların korunması, tarih bilgisinin saat dilimi ve miktarın ölçü birimi örnek veriyle gösterilmelidir. Geçerli görünen bir değer yanlış anlamla aktarıldığında teknik hata oluşmayabilir.
E-ticaret altyapısında ürünün toplam stoğu ile satışa ayrılabilir miktarı aynı kavram olmayabilir. Bu farkı alan adından tahmin etmek yerine veri sözlüğüne yazın. Bilinmeyen kod, beklenmeyen uzunluk veya eksik zorunlu alan için karar belirleyin: kayıt reddedilecek mi, incelemeye mi alınacak? Değeri sessizce kesmek veya rastgele varsayılanla doldurmak sorunu çözmüş sayılmaz.
Hata durumlarını operasyonun anlayacağı biçimde ayırın
Tek bir başarısız etiketi, her sorun için aynı müdahaleyi çağırır. Oysa eksik ürün kodu, yetki reddi ve bağlantı kopması aynı koşullarda çözülmez. İşlem durumunu taşıma katmanının mesajından ayrı saklayın. Aşağıdaki durumlar örnek bir başlangıçtır; kullanılan gerçek sistemin davranışına göre genişletilebilir.
- Alındı: İstek kayda geçti; hedefteki iş sonucu henüz doğrulanmadı.
- Tamamlandı: Tanımlı iş sonucu ve gerekli hedef kimliği doğrulandı.
- Düzeltme bekliyor: Veri veya yetki sorunu var; uygun sorumlu müdahale etmeli.
- Sonuç belirsiz: İstek gitmiş olabilir; yeni denemeden önce hedefteki durum uzlaştırılmalı.
Web sitesi teklif formundan gelen bir talep CRM'ye aktarılırken alan doğrulamasında durduysa, form kaydı kaybolmadan izlenebilmelidir. Kullanıcıya yeniden form doldurtmak yerine yetkili ekip eksik alanı ve aktarım durumunu görebilmelidir. Bu durum kaydının kimin erişimine açık olacağı, hangi değişikliğin denetim izine yazılacağı ve ne zaman kapatılacağı da tasarımın parçasıdır.
Zaman aşımını işlemin yapılmadığına kanıt saymayın
Bir istek yanıtlanmadan bağlantının kapanması, karşı tarafta hiçbir değişiklik yapılmadığını göstermez. İstemci açısından bilinmeyen sonuç vardır. RFC 9110'un yeniden deneme ilkesi, yinelenince aynı amaçlanan etkiyi üretmeyen isteklerin otomatik tekrarını koşula bağlar. İstemci, işlemin güvenle tekrarlanabildiğini veya ilk isteğin uygulanmadığını bilmeden yalnız yanıt yokluğuna dayanarak tekrar yapmamalıdır.
Bu ayrım, uygulama ekranında da korunmalıdır. Destek çalışanı belirsiz işlemi tekrar gönder düğmesiyle yeni siparişe çevirmeden önce mevcut iş kimliğiyle sorgulama yapabilmelidir. Hedef sistem böyle bir sorgu sunmuyorsa belirsizliğin nasıl çözüleceği baştan kararlaştırılır. Bekleme süresinin dolması, kendiliğinden başarısız veya tamamlandı sonucuna dönüştürülmez; eldeki kanıt ve izlenecek yol kaydedilir.
Aynı işi yeniden denemeyi yeni iş oluşturmaktan ayırın
İdempotency, aynı mantıksal isteğin tekrarında istenmeyen ek etkiyi önlemeyi amaçlar. Stripe'ın idempotent istek belgesi bu yaklaşımın sağlayıcıya özgü bir örneğidir: anahtar kullanımı, parametre karşılaştırması ve API sürümüne göre yanıt davranışı belgelenmiştir. Bu örneği bütün servislerin aynı süre ve sonuç davranışıyla çalıştığı şeklinde genellemeyin. Kullandığınız uç noktanın gerçek sözleşmesini kontrol edin.
Uygulamada aynı işin tekrarında aynı anahtar, farklı işte farklı anahtar kullanılmalıdır. Aynı anahtarla değişmiş içeriğin gelmesi de görünür bir uyuşmazlık olmalıdır. Yalnız önce kayıt var mı diye bakıp sonra eklemek, eşzamanlı iki isteği mutlaka engellemez. Geliştirici, kimlik denetimini ve iş etkisini uygun atomik işlem, benzersizlik kuralı ve hata davranışıyla birlikte değerlendirmelidir.
Bu kural yalnız istemci başlığı eklemekle tamamlanmaz. İşlem sürerken gelen ikinci denemeye ne gösterileceği, ilk işlem çökerse durumun nasıl bulunacağı ve saklama süresi dolmuş kimliğin nasıl ele alınacağı tanımlanmalıdır. Günlük çalışan ekip aynı iş için yeni anahtar üreterek korumayı istemeden aşmamalıdır. Yönetim panelindeki günlük işlemler bu ayrımı açık etiketler ve yetkilerle desteklemelidir.
Webhook bildirimlerini geliş sırasına göre kesinleştirmeyin
Bir servis aynı olayı yeniden bildirebilir veya ilişkili olayları beklenen sıranın dışında ulaştırabilir. Stripe webhook belgesi, kendi olaylarında teslim sırasını garanti etmediğini ve yinelenen teslimlerin olay kimliğiyle izlenmesini açıklar. Bu, bütün sağlayıcılar için aynı sözleşme olduğu anlamına gelmez; entegrasyon tasarımında sıralama ve tekrar koşullarını sağlayıcının belgesinden doğrulamak gerektiğini gösterir.
Olay kimliği ile iş nesnesi kimliğini ayırın. Aynı siparişe ilişkin iki farklı olay, tek olayın iki teslimi değildir. Eski bir olay daha yeni durumu geri almamalıdır; sürüm, geçerli durum veya sağlayıcının sunduğu güncel kayıt üzerinden karar verilmelidir. Uygun imza doğrulaması ve işlem sonucu takibi de tasarlanır. Bildirimin alınması ile işlenmesinin tamamlanması ayrı kanıtlar üretir.
Örneğin sipariş iptal edildikten sonra daha eski bir hazırlanıyor bildirimi gelirse, yalnız son gelen mesajı yazmak siparişi yanlış duruma taşıyabilir. Hangi geçişlerin izinli olduğunu bir durum çizelgesiyle belirleyin. Kesin sıra bilgisi yoksa zaman damgalarını gelişigüzel karşılaştırarak kesinlik üretmeyin; gerektiğinde yetkili kaynaktan güncel durumu okuyun. Bildirimin işlendi olarak işaretlenmesi ile iş etkisinin kalıcılaşması arasındaki çökme ihtimali de kabul testinde yer almalıdır. Bu önerilen senaryo sağlayıcıya ait belgelenmiş bir özellik olarak sunulmaz; uygulamanızın sınanacak davranışını tarif eder.
Yerel kayıtla dış bildirimin arasındaki boşluğu kapatın
Yerel veritabanına sipariş yazılıp dış bildirimden önce uygulama durursa aktarım unutulabilir. Ters sırada ise yerel kayıt geri alınmasına rağmen bildirim gitmiş olabilir. AWS'nin transactional outbox açıklaması, iş verisiyle gönderilecek olayın aynı yerel işlem içinde tutulmasını ele alır. Ayrı bir süreç bu bekleyen olayları aktarabilir. Böylece iki bağımsız yazma arasındaki belirli tutarsızlık riski yönetilir.
Bu desen, uzak sistemde her etkinin yalnız bir kez oluşacağını kendiliğinden garanti etmez. AWS ayrıca tüketicinin tekrarlanan mesajları karşılayabilmesini ve işlem geri alındığında olayın gönderilmemesini vurgular. Gönderildi bilgisinin ne zaman yazıldığı, süreç yeniden başladığında ne yapılacağı ve olayların saklama politikası ayrıca tasarlanır. Mimariyi seçerken ihtiyaca uymayan karmaşıklık eklemek yerine gerçek hata penceresini gösterin.
Bir iş hem sipariş açıyor hem bildirim hazırlıyorsa, iki adımın ayrı sonuçları bulunabilir. Sipariş doğru oluştuğu halde bildirim başarısız olduğunda bütün işi baştan çalıştırmak yerine eksik adımı hedefleyen toparlanma gerekir. Tersine, oluşmuş siparişi silerek geri almak her iş modelinde uygun değildir. İptal, düzeltme veya telafi işleminin yetkisini ve etkisini işletme belirlemelidir. Başarılı alt adımı koruyan, kalan işi açık gösteren bir kayıt, tek bir genel hata mesajından daha kullanışlıdır. Dış sistemler arasındaki bütünlüğün yerel işlem sınırını aştığı açıkça belirtilmelidir.
Tekrar denemeyi sınırlı ve izlenebilir bir politika yapın
Her hata yeniden denemeyle iyileşmez. Eksik zorunlu alan düzeltilmeden aynı içerik tekrar gönderilirse sorun sürer. Yetki reddi güvenlik korumasını gevşetme gerekçesi değildir. Geçici hata olabileceği düşünülen durumlarda bile işin tekrar güvenliği, sağlayıcı sınırları ve varsa bekleme yönlendirmesi değerlendirilmelidir. Sabit ve sınırsız hızlı tekrar, kesinti sırasında yeni yük üretebilir.
Politikada deneme sayısı, bekleme aralıkları, toplam süre sınırı ve sonrasında incelemeye geçiş bulunmalıdır. Artan bekleme ve uygun rastgele sapma bir tasarım seçeneğidir; her projeye aynı saniyeleri kopyalamayın. Açık revizyon ve destek yönetimi içinde bu sınırları değiştiren kararların kaydı tutulmalıdır. Son deneme bittiğinde kayıt silinmez; hangi nedenle durduğu ve sıradaki sorumlu görünür kalır.
Mutabakatı toplam sayıdan kayıt düzeyine indirin
Kaynakta ve hedefte aynı sayıda kayıt bulunması, aynı kayıtların bulunduğunu kanıtlamaz. Bir eksik ile bir mükerrer toplamı eşitleyebilir. İş kimliği, dış kimlik, beklenen durum ve gerekli alanlar üzerinden karşılaştırma yapın. Tutar gibi alanlarda hangi yuvarlama ve dönem kuralının kullanılacağı açıklansın. Karşılaştırmanın hangi zaman aralığını ve veri sürümünü kapsadığı belli olsun.
Kurumsal web sitesindeki başvuru akışında mutabakat kişisel veriyi herkese açmadan yürütülebilir. Yetkili ekip yalnız gerekli referansları ve farkın türünü görmelidir. Farklılık bulunduğunda otomatik üzerine yazmak yerine yetkili kaynağı ve son güncellemeyi kontrol edin. Düzeltme veya yeniden işleme, önceki fark kaydıyla ilişkilendirilsin; rapor temiz görünsün diye geçmiş kanıt silinmesin.
Kesinti sonrasında biriken kayıtların yeniden işlenmesi için de kapsam seçimi gerekir. Tüm geçmişi yeniden göndermek yerine tarih aralığı, durum ve işlem kimlikleriyle sınırlandırılmış bir çalışma listesi oluşturun. Deneme öncesinde bu listenin hangi kayıtları içerdiği görülebilsin. Çalışma sırasında yeni veri geliyorsa eski listeyle nasıl ayrılacağı kararlaştırılsın. İşlem bittiğinde yalnız çalıştırıcının hata vermediğini değil, seçilen kayıtların sonuçlarını ve kalan farkları raporlayın. Yeniden işleme aracı kapanmış işleri tekrar açmamalı; düzeltilemeyen kayıtları da sessizce atlayarak toplamı başarılı göstermemelidir.
Panelde güvenli müdahale ve sorumluluk yolu sağlayın
İnceleme ekranı, işlem kimliği, son durum, son deneme, hedef referansı ve sonraki adımı bir arada sunmalıdır. Hata mesajının tüm teknik ayrıntısını işletme kullanıcısına dökmek gerekmez. Düzeltilmesi gereken alan anlaşılabilir biçimde gösterilirken gizli anahtarlar ve gereksiz kişisel bilgiler saklanmalıdır. Tekrar işle düğmesinin gerçek etkisi, yetkisi ve onay gereksinimi belirgin olmalıdır.
Site sahipliği ve destek hakları belirlenirken entegrasyonun hangi bölümüne kimin müdahale edeceği yazılmalıdır. Web ekibi aktarımı, ERP ekibi alan doğrulamasını, işletme temsilcisi iş kararını yönetiyor olabilir. Sağlayıcı desteğine açılan kayıt da aynı olayla ilişkilendirilir. Sorumluluğu belirsiz bir kayıt, teknik olarak görülebilir olsa bile operasyon bakımından yönetilebilir hale gelmiş sayılmaz.
Günlükleri kanıt üretirken veri sızdırmayacak şekilde tutun
İzleme kaydına olayın amacı, işlem ve deneme kimliği, zaman, sonuç sınıfı ve ilgili sürüm eklenebilir. Her isteğin tüm içeriğini sürekli kaydetmek varsayılan çözüm olmamalıdır. Erişim anahtarı, parola veya kişisel başvuru içeriği destek ekranlarına taşınmamalıdır. Hangi kayıtların ne kadar tutulacağı ve kimlerin okuyacağı kurumun veri ve işletim ihtiyaçlarıyla kararlaştırılır.
Proje devralma kontrolünde bu izleme düzeni de teslim edilmelidir. Yeni ekip, bir uyarının yalnız bağlantıyı mı yoksa iş sonucunu mu anlattığını bilmeli; kayıttan hedef sisteme giden ilişkiyi takip edebilmelidir. Başarı oranı gibi bir ölçüm raporlanacaksa payda ve dışarıda bırakılan durumlar belirtilir. Belirsiz işlemleri başarı kabul ederek görünümü iyileştiren raporlar karar vermeyi zorlaştırır.
Kabul testini hata anından toparlanmaya kadar yürütün
Yayına alma kabul listesine yalnız örnek kaydın başarılı aktarımını eklemeyin. Aynı isteğin iki kez gelmesi, hedefin yanıtının kaybolması, eski olayın geç ulaşması, hatalı alan ve sürecin yeniden başlaması gibi senaryoları da tanımlayın. Her testte beklenen kayıt sayısı, iş durumu ve müdahale yolu önceden yazılsın. Kullanılan ortam ve test verisi kapsamı açık olsun. Bir kurumsal web sitesi başvuruları başka bir sisteme aktarıyorsa, aktarım kesintisinde ziyaretçiye verilen mesajı ve kayıt yeniden işlendiğinde oluşan sonucu birlikte doğrulayın.
Gerçek ödeme, müşteri bildirimi veya üretim kaydı değişikliği ayrı yetki gerektirir; sıradan test diye başlatılmaz. Önce uygun test olanakları değerlendirilir. Bir senaryonun denenemediği durumda başarılı işaretlemek yerine sınırı kaydedin. Sonuç, ekranın açılması değil, hatanın gözlenmesi, doğru durumun korunması ve izinli toparlanma adımının beklenen işi üretmesidir.
Örnek akışta kapanış kararını kanıta bağlayın
Temsilî bir işletmede web siparişi ERP'ye gönderiliyor ve yanıt gelmiyor olsun. Yerel kayıt sonuç belirsiz durumuna alınır; operatör yeni sipariş açmak yerine aynı işin hedef referansını araştırır. Hedefte doğru kayıt bulunursa eşleşme doğrulanır. Bulunamadığı kesinleşir ve sözleşme güvenli tekrarı desteklerse aynı mantıksal iş yeniden denenir. Bu örnek gerçek müşteri sonucu veya evrensel çözüm vaadi değildir.
Birinci denemenin kanıtı, hedefte bulunan kayıt ve kapanış gerekçesi birlikte tutulur. Ardından 90 günlük geliştirme planında tekrarlayan hata sınıfları önceliklendirilir. Web Tasarım Sistemleri ile entegrasyon değerlendirmesine başlamak için iletişim sayfamızdan iş akışınızı, kullandığınız sistemleri ve bilinen sorunları paylaşabilirsiniz. Gizli anahtar göndermeniz gerekmez. Sağlam başlangıç, yalnız bağlantıyı değil, belirsizlik halinde verilecek kararı da tasarlamaktır.
Bu makalenin uzunluğu 1907 kelimedir.
Bu makale 2026-10-31 tarihinde yayınlanmıştır.