Nilvera tek bir durum sorgusunda üç ayrı bilgi döndürür: belgenin durumu, GİB zarf bilgisi ve alıcı yanıtı. Belge başarılı ve zarf kodu tamamlandı olduğunda belge alıcıya iletilmiştir; alıcının kabul ya da reddi ise ayrı bir bilgidir ve başarıdan çıkarılamaz.
Durumdaki üç bilgi
Nilvera'nın durum yanıtı iç içe bir yapıdır. İlk bilgi belgenin kendi durumudur: bekliyor, başarılı, hatalı ya da bilinmiyor. İkinci bilgi, belgenin içinde bulunduğu GİB zarfıdır: zarfın bir kodu ve açıklaması vardır. Üçüncü bilgi, alıcının belgeye verdiği yanıttır; bu, kabul, ret ya da beklemede olabilir.
| Bölüm | Neyi söyler |
|---|---|
| Belge durumu | Belge sağlayıcıda hangi aşamada |
| GİB zarf bilgisi | GİB tarafında zarfın durumu |
| Alıcı yanıtı | Alıcı belgeyi kabul etti mi, reddetti mi |
Bu üçünü ayırmak, "belgem gitti mi" sorusunun cevabını netleştirir. Genel çerçeve e-irsaliye durumları ve hata çözümleri yazısında; Nilvera'ya özgü okuma burada.
Gerçek geçişler
Sağlayıcıda yaptığımız gönderimde durumu belli aralıklarla sorguladık. Belge önce işlem yapılıyor anlamında bekliyor durumundaydı, zarf kodu da henüz tamamlanmamış aşamayı gösteriyordu. Kısa bir süre sonra belge başarılıya, zarf kodu da tamamlandı değerine geçti; açıklama alıcıya iletildiğini bildirdi.
- Gönderim sonrası. Belge bekliyor, zarf henüz oluşuyor.
- Kısa bir süre sonra. Belge hâlâ bekliyor, zarf işleniyor.
- Tamamlandığında. Belge başarılı, zarf tamamlandı.
Her adımın arası kısadır ama anlık değildir. Bu yüzden sorgu, belirli aralıklarla tekrarlanmalıdır. Ayrıca sağlayıcı, GİB'den bağımsız bir teyit ucu da sunar; bu uç zarfın son durumunu GİB'den ayrıca sorar. Bağımsız teyit, sağlayıcının kendi bilgisine tek başına güvenmek istemeyenler için bir kontrol noktasıdır.
Zarf kodunun boş hâli
Gönderimin ilk saniyelerinde zarf kodu sıfır olarak göründü. Sıfır, hata değil; bilgi henüz oluşmadı demektir. Sıfırı hata sayan bir program, normal akışta yanlış alarm üretir ve operatörü gereksiz yere uğraştırır. Doğru yorum: sıfır, bekle ve yeniden sor demektir.
İkinci bir ayrıntı tiplerdir. Durum ucunda zarf kodu sayı, ayrı zarf bilgisi ucunda ise metin olarak geldi. Bir uçta sayı bekleyen kod, diğerinde gelen metinde hata verebilir; okuma kodu iki tipi de tolere etmelidir.
Alıcı yanıtı ayrıdır
Alıcının belgeye yanıtı, GİB zarfından bağımsız bir eksendir. Denememizde belge başarılı ve zarf tamamlandı olduğu hâlde alıcı yanıtı alanı boş geldi; alan vardı ama değeri yoktu. Bu, yanıtın henüz verilmediğini gösterir. Kodda bu alanı doğrudan okuyup içeri girmeye çalışan bir ifade, boş değer yüzünden hata verebilir; boş değer için güvenli bir okuma gerekir.
Anlam açısından ise şunu unutmamak gerekir: kabul teslim demek değildir, teslim de kabul demek değildir. Başarılı durum belgenin ulaştığını söyler; alıcının onayladığını söylemez.
STEQAR'ın planlanan sınıflaması
- İşlendi. Belge başarılı ve zarf tamamlandı.
- Beklemede. Belge bekliyor, zarf sıfır ya da işleniyor, ya da durum bilinmiyor. Bilinmeyen durum asla başarı sayılmaz.
- Hatalı. Belge hatalı ya da zarf reddedildi. Operatöre bilgi verilir.
Bekleyen kayıtların bağlantı döndüğünde nasıl ele alındığını internet kesilince Nilvera e-irsaliye yazısında anlattık. Hazırlık durumunu Nilvera rehber yazısında topladık; demo için iletişim sayfasına yazın, demo ücretsizdir.
Sık sorulan sorular
Nilvera'da belgenin durumu nasıl okunur?
Tek bir durum sorgusu üç bilgi verir: belgenin kendi durumu, GİB zarf bilgisi ve alıcı yanıtı. Belge durumu bekliyor, başarılı ya da hatalı gibi küçük bir listeden gelir.
Zarf kodu sıfır görünüyorsa belge hatalı mıdır?
Hayır. Gönderimin ilk saniyelerinde zarf kodu henüz oluşmadığı için sıfır görünür; bu hata değil, henüz bilgi yok demektir. Sıfırı hata saymak yanlış alarm üretir.
Belge başarılı görününce alıcı da kabul etti demek mi?
Hayır. Alıcının kabul ya da reddi ayrı bir bilgidir ve çoğu zaman boş gelir. Başarı, belgenin teslim edildiğini gösterir; alıcının onayladığını göstermez.
Aynı zarf kodu iki uçta farklı tipte mi geliyor?
Evet. Durum ucunda zarf kodu sayı olarak, zarf bilgisi ucunda metin olarak döner. Bu yüzden her iki tipi de kabul edecek biçimde okumak gerekir.
STEQAR bu durumları Nilvera'dan şimdi okuyor mu?
Henüz değil. Durum geçişleri sağlayıcı tarafında ölçüldü; STEQAR'ın Nilvera bağlantısı hazırlık aşamasındadır.
STEQAR, SCP Bilişim ve Otomasyon Sistemleri'nin geliştirdiği kantar programıdır; Türkiye genelinde uzaktan kurulum ve destek verir.