Satınalma otomasyonunda en pahalı hatalardan biri, doğru verinin yanlış anda taşınmasıdır. Henüz onaylanmamış talep kalemleri ihaleye giderse veya aynı sonuç iki kez alınırsa, bağlantının teknik olarak çalışması yeterli olmaz. API entegrasyonunu bir veri taşıma işi kadar bir durum yönetimi işi olarak düşünmek gerekir.
Hangi olay aktarımı başlatacak?
Talebin kaydedilmesi ile onaylanması aynı olay değildir. Sipariş taslağı ile tedarikçiye iletilmiş sipariş de aynı aşamada bulunmaz. Her aktarım için hangi statünün gerekli olduğunu, sonradan değişiklik olursa ne yapılacağını ve kaydın hangi sistemde düzeltileceğini belirleyin.
OCDS, farklı süreç aşamalarını birbirine bağlayan kayıt yapısı sunar. Özel sektör entegrasyonunda da benzer bir düşünce yararlıdır: talep, ihale sonucu ve sipariş aynı işin farklı kayıtlarıdır. Bu yaklaşım, Tenflex’te belirli bir kamu veri standardı kullanıldığı anlamına gelmez.
Benzersiz referansı koruyun
Her kaynak kaydın hedefte hangi kayıtla eşleştiği bulunabilsin. Firma adı veya açıklama üzerinden arama yapmak, günlük kullanımda yardımcı olsa da entegrasyon kimliği yerine geçmemelidir. Kaynak talep numarası ve hedef kayıt kimliği gibi referanslar teknik ekiple kararlaştırılmalıdır.
Bağlantı kesildiğinde tekrar denemenin ne yapacağı da belli olsun. Aynı isteği ikinci kez göndermek ikinci bir sipariş üretmemelidir. Bu davranışın hangi tarafta ve hangi API imkanıyla sağlanacağı geliştirme sırasında doğrulanmalıdır; yalnızca “otomatik aktarım” ifadesi yeterli değildir.
Örnek kabul senaryoları
- Onaylı talebin bütün kalemleri doğru miktar ve birimle ulaşır.
- Eksik zorunlu alan, ilgili kayıtla birlikte anlaşılır bir hata üretir.
- Tekrar gönderim yeni bir mükerrer kayıt oluşturmaz.
- İhale sonucu ile siparişe seçilen kalemler doğru referanslarla ilişkilendirilir.
- Başarısız işlem düzeltildikten sonra diğer kayıtlar bozulmadan devam eder.
Bu liste genel bir entegrasyon test önerisidir. Gerçek senaryolar, kurumunuzun kullandığı API ve iş kurallarıyla netleştirilmelidir. Testi yalnızca geliştirici değil, sonucu kullanacak satınalma ekibi de incelemelidir.
Tenflex ve IFS örneği
Tenflex API dokümanını paylaşır; IFS veya başka bir sistem tarafındaki ekip talepleri gönderir ve sonuçları alır. Başlangıçta az sayıda kayıtla iki yönü de doğrulamak, büyük hacimli aktarım öncesinde hataları görünür kılar.
Canlı kullanım planında teknik hata kaydı kadar operasyonel sorumlu da bulunsun. “Aktarım başarısız” mesajını kimin takip edeceği belli değilse bağlantı çalışmadığında süreç yine e-postaya döner. İyi entegrasyon, verinin ulaştığı kadar anlaşılır biçimde yönetilebildiği entegrasyondur.
