İmzalı Belgeyi ERP'ye Geri Yazmak: Entegrasyonda Sık Atlanan Hata Senaryoları
İmza tamamlandığında ERP kaydının da doğru güncellendiğinden nasıl emin olunur? Geciken bildirim, yinelenen olay, yanlış belge sürümü ve yarım kalan işlemler için entegrasyon kontrol noktalarını inceliyoruz.
Bir tedarikçi sözleşmeyi imzaladı. İmza platformunda dosya tamamlanmış görünüyor, fakat ERP ekranında hâlâ “imza bekleniyor” yazıyor. Satın alma ekibi yeniden davet gönderiyor; birkaç saat sonra aynı sözleşmenin iki kopyası ortaya çıkıyor. Sorun imza ekranında değil, iki sistem arasındaki sonuç aktarımında.
Entegrasyon projesi yalnızca “imzala” düğmesini ERP'ye eklemekle bitmez. Asıl sınav, tamamlanan dosyanın doğru kayda dönmesi ve hata olduğunda operatörün ne yapacağını bilmesidir.
Her imza isteğine değişmeyen bir kimlik verin
ERP sözleşmeyi göndermeden önce işlem kimliği üretir. Bu kimlik, belge sürümü ve karşı taraf bilgisiyle birlikte imza platformuna iletilir. Sonuç geldiğinde sistem yalnızca aynı işlem kimliğine ait dosyayı ilgili ERP kaydına bağlar. Dosya adı veya kişinin e-posta adresi tek başına güvenilir eşleştirme anahtarı değildir; ikisi de değişebilir veya birden çok işlemde tekrar edebilir.
Belge imza davetinden sonra güncellenirse yeni sürüm için ayrı bir işlem açılır. Eski davetten gelen sonuç yeni sözleşmeye otomatik iliştirilmez. Bu kural, bedel değişikliği gibi kritik düzeltmelerde yanlış metnin “tamamlandı” görünmesini önler.
Bildirim kaybolduğunda işlem kaybolmasın
İmza platformundan ERP'ye gönderilen tamamlanma bildirimi ağ kesintisi nedeniyle ulaşmayabilir. Bu nedenle ERP'nin olayları tekrar alabilmesi ve işlem durumunu gerekirse sorgulayabilmesi gerekir. Tekrar gelen aynı olay ikinci belge oluşturmamalı; sistem aynı işlem kimliği ve sonuç için daha önce kayıt yapılıp yapılmadığını kontrol eder.
Teknik ekipler bu davranışı “idempotent işlem” diye adlandırır. Operasyon açısından anlamı basittir: Bildirim iki kez gelse de sözleşme ERP'de bir kez tamamlanır. Kaybolan bildirimin yeniden denenmesi ise dosyayı kaybetmez.
Yarım kalan durumu açıkça gösterin
“Gönderildi”, “imzacı açtı”, “reddedildi”, “süresi doldu” ve “tamamlandı” ayrı durumlardır. ERP'de hepsini yalnızca “bekliyor” altında toplamak, ekibin hangi müdahaleyi yapacağını gizler. Özellikle birden fazla imzacı varsa ilk kişinin imzası tamamlanmış belge anlamına gelmez.
Görülen sorun | ERP'de yapılacak kontrol | Operasyonun sonraki adımı |
Bildirim gelmedi | İşlem kimliğiyle gerçek durumu sorgula | Doğrulanmış sonucu kaydet veya yeniden dene |
Aynı bildirim tekrar geldi | Sonucun daha önce işlendiğini kontrol et | İkinci kopya üretme |
İmzacı reddetti | Ret durumunu tamamlanmış imzadan ayır | Belgeyi iş birimine revizyona gönder |
Belge sürümü değişti | İmza sonucundaki sürümü ERP sürümüyle karşılaştır | Gerekirse eski daveti kapat ve yeni akış başlat |
Bu tablo ürünün otomatik davranışına ilişkin bir vaat değil, entegrasyon tasarımında test edilmesi gereken senaryoların özetidir. Teknik kabul testinde her satırın beklenen sonucu gösterilmelidir.
Operasyon ekibine ayrıca günlük bir istisna görünümü gerekir. “Platformda tamamlandı, ERP'de bekliyor” durumunda kalan işlemler, son deneme zamanı ve hata nedeniyle listelenir. Önce gerçek durum sorgulanır; yalnızca görselde bekliyor yazdığı için imzacıya ikinci davet gönderilmez. Gün sonu mutabakatı, otomatik tekrar denemelerin sessizce bıraktığı dosyaları yakalar.
Arşive doğru dosyayı koyun
ERP'ye dönen şey yalnızca “başarılı” bilgisi olmamalıdır. İmzalanmış dosyanın kendisi veya güvenli erişim bağlantısı, işlem kimliği, imzacı ve zaman kayıtları birlikte bulunmalıdır. Bağlantı kullanılıyorsa erişim süresi, yetki ve sağlayıcı değişiminde dışa aktarım yöntemi belirlenir. Aksi halde ERP kaydı yıllar sonra var olsa bile belge açılamayabilir.
Arşiv kaydının doğrulanması için bir sorumlu da belirleyin. Satın alma ekibi sözleşmenin ticari içeriğini kontrol ederken BT ekibi teknik aktarımın tamamlandığını izler; iki kontrol birbirinin yerine geçmez. İşlem sonuçlandıktan sonra dosya açılamıyorsa “imzalandı” etiketi tek başına yeterli değildir. Bu istisna, belgeye yeniden erişilene kadar açık bir iş listesinde kalmalıdır.
Canlıya geçiş öncesi üç test özellikle yararlıdır: tamamlanan imza, yinelenen bildirim ve imza sırasında değiştirilen belge. ArgeLabs Dijital İmza ile entegrasyonu planlarken bu testlerin sonuçlarını birlikte değerlendirmek, gerçek iş akışının nerede manuel müdahale gerektirdiğini görünür kılar.
İlgili içerik