STEQAR, sağlayıcıdan gelen hatayı ham hâliyle göstermez; kimlik, alanlar, ortam, güvenlik duvarı, hız sınırı, ağ, biçim ve eksik ayar olarak sınıflandırıp kendi Türkçe iletisini verir. Oturum süresi dolmadan yenilenir; korumalı istekte kimlik reddi gelirse en çok bir yeniden giriş ve bir tekrar yapılır, o da reddedilirse hata sert kimlik hatası olarak durur. Hız sınırı kimlik hatasından ayrıdır ve oturumu düşürmez.
Neden ham ileti yerine sınıf gösterilir?
Bağlantı kurulamayınca kantarcının ilk işi iletiyi okumaktır. Sağlayıcının kendi metni burada yanıltabilir: aynı ham ileti hem yanlış şifre hem de süresi dolmuş oturum için dönebilir. Metni olduğu gibi gösterseydik operatör, sorun oturumdayken şifreyi değiştirmeye uğraşabilirdi. Bu yüzden eKüpSoft bağlantısı hatayı önce bir sınıfa oturtur, sonra o sınıfın Türkçe iletisini gösterir. Aşağıdaki tablo, ekranda karşılaşabileceğiniz sekiz sınıfın ne anlama geldiğini ve nereye bakacağınızı özetler.
| İletinin anlamı | Neye işaret eder | Nereye bakılır |
|---|---|---|
| Kimlik bilgisi hatalı ya da oturum açılamadı | Sağlayıcı girişinizi kabul etmedi | Ayarlardaki kullanıcı adı, şifre ve ortam işareti |
| Gönderilen alanlar eksik ya da geçersiz | İstekle giden bilgilerden biri sağlayıcıca uygun görülmedi | Ayar ekranındaki alanların dolu ve doğru olması |
| Servis adresi hatalı | Ortam seçimi uyuşmuyor | Test Ortamı işareti |
| İstek güvenlik duvarında reddedildi | İstek sağlayıcının koruma katmanında takıldı | Ayardan çok sağlayıcı tarafı; iletiyi ve saatini not edin |
| Hız sınırı aşıldı | Kısa sürede çok istek yapıldı | Beklemek; ayar değiştirmeyin |
| Sağlayıcıya ulaşılamadı | Ağ ya da bağlantı sorunu | İnternet erişimi ve sağlayıcının ulaşılabilirliği |
| Yanıt beklenen biçimde değil | Gelen cevap çözülemedi | Bir süre sonra tekrar deneyin; sürerse iletiyi ve saatini not edin |
| Kimlik bilgileri eksik ya da okunamadı | Sorun yerelde; ağa çıkılmadı | Ayar ekranında kimlik alanlarını yeniden kaydedin |
Kimlik hatası ve oturum yenileme
eKüpSoft hesabıyla giriş yapıldığında sınırlı ömürlü bir oturum açılır. STEQAR bu oturumu süresi dolmadan yeniler; operatörün oturumu elle yenilemesi gerekmez. Korumalı bir istekte kimlik reddi gelirse sürücü en çok bir yeniden giriş ve bir tekrar yapar. Yeniden giriş de reddedilirse durum sert kimlik hatası olarak durur, deneme döngüye girmez.
Bu kural size şunu söyler: ekranda kimlik iletisini görüyorsanız kısa süreli bir oturum aksaklığı çoktan elenmiştir; geriye bilgilerin gerçekten reddedilmesi kalır. İlk bakılacak yerler kullanıcı adı, şifre ve Test Ortamı işaretidir.
Gönderim isteği sırasında bir kimlik reddi gelirse durum biraz farklıdır: oturum tazelenir ama o isteğin akıbeti bilinmez. Bu sonuç belirsiz sayılır; yapılacakları gönderim sonucu belirsiz kalırsa yazısı anlatıyor.
Ortam işareti iki şeyi birden seçer
Ayar ekranındaki tek Test Ortamı işareti hem servis adresini hem de kullanılan kimlik setini belirler. Serbest bir adres yazılamaz. Bunun pratik sonucu şudur: işaret yanlışsa bilgileriniz doğru olsa bile o ortam onları tanımayabilir. Kimlik iletisi alıp bilgilerinden emin olan kullanıcı, önce ortam işaretini gözden geçirmelidir. Alan alan ayar ekranı için eKüpSoft kurulum rehberine bakın.
Hız sınırı ayrı bir sınıftır
Hız sınırı, sağlayıcının kısa sürede gelen isteklere koyduğu bir sınırdır. STEQAR bunu kimlik hatasından ayırır, çünkü sebepleri ve çareleri farklıdır. Hız sınırı aşımı oturumu düşürmez; yani şifrenizi ya da kullanıcı adınızı değiştirmenize gerek yoktur. Gönderim sırasında hız sınırı iletisi gelirse belge oluşmamıştır; yani bu bir kesin redtir ve beklemek yeterlidir. İsteklerin sıklığı azalınca gönderim yeniden başlatılabilir.
Hız sınırı iletisini kimlik sorunu sanıp ayarları değiştirmek, çalışan bir kurulumu bozabilir. Önce iletinin hangi sınıfa girdiğine bakın.
Bağlantı testi neyi gösterir?
“Bağlantıyı test et” düğmesi taze bir oturum açma denemesidir. Önbellekten başarı döndürmez ve yeniden deneme yapmaz. Bu yüzden test geçtiyse kimlik bilgileriniz ve ortam seçiminiz o anda sağlayıcıca kabul edilmiştir. Ancak bu, gönderimin de sorunsuz geçeceğini kanıtlamaz: numara biçimi, gönderen bilgisi ve alıcı kutusu gönderimde ayrıca devreye girer. Bu adımları pillar yazıdaki kapı sırasında görebilirsiniz.
Ağ ve biçim hataları: aynı iletinin iki anlamı
“Sağlayıcıya ulaşılamadı” ve “yanıt beklenen biçimde değil” iletileri, nerede çıktıklarına göre farklı sonuç doğurur. Bağlantıyı test ederken ya da oturum açılırken çıkarlarsa ortada bir belge yoktur; sorun yalnızca bağlantıdır ve biraz sonra yeniden denemek yeterlidir. Gönderim isteği sırasında çıkarlarsa durum değişir: istek yola çıkmış, cevap alınamamıştır ve belge sağlayıcıda oluşmuş olabilir. Bu yüzden aynı ileti gönderimde belirsiz sonuç sayılır ve yeniden göndermeden önce portale bakmanız gerekir.
Bu ayrımı akılda tutmak, bağlantı sorununu tartım sırasında yaşayan operatörün ilk refleksini düzeltir: ekrandaki iletiyi okumadan düğmeye tekrar basmak yerine önce iletinin hangi adımda çıktığına bakılır.
Hangi iletide ayara, hangisinde beklemeye bakılır?
- Ayara bakılır: kimlik iletisi, eksik ya da geçersiz alan, servis adresi hatası ve kimlik bilgilerinin eksik ya da okunamadığı durum. Bunlar sizin elinizdeki ayarlarla ilgilidir.
- Beklenir: hız sınırı ve sağlayıcıya ulaşılamaması. İkincisi gönderim sırasında geldiyse belirsiz sayılır, o zaman beklemeden önce portale bakın.
- İleti not edilir: güvenlik duvarı reddi ve biçim hatası. Ayar değiştirmek burada çözüm olmayabilir; iletiyi ve saatini kaydedin.
Birden çok sağlayıcı arasında seçim yapıyorsanız genel karşılaştırma için Kantar e-İrsaliye entegratörleri yazısına bakabilirsiniz.
Sık sorulan sorular
Kullanıcı adım ve şifrem doğru ama kimlik hatası alıyorum, neden?
Aynı kimlik iletisi hem yanlış şifrede hem süresi dolmuş oturumda dönebilir. Oturum süresi dolmuşsa STEQAR bir kez yeniden giriş yapar; bu da reddedilirse hata sert kimlik hatası olarak durur. Bilgiler doğruysa önce Test Ortamı işaretine bakın: işaret hem servis adresini hem kimlik setini seçer.
Hız sınırı iletisi gelince ne yapmalıyım?
Kimlik ayarını değiştirmeyin. Hız sınırı kimlik hatasından ayrı bir sınıftır ve oturumu düşürmez. Gönderimde belge oluşmamıştır. İsteklerin sıklığı azalana kadar bekleyip gönderimi yeniden başlatmak yeterlidir.
Test Ortamı yanlış seçilirse ne görürüm?
Servis adresi hatalı iletisi gelebilir; iletide ortam seçimini kontrol etmeniz söylenir. İşaret kimlik setini de seçtiği için doğru bilgiler yanlış ortamda tutmayabilir, bu da kimlik iletisine benzer bir sonuç verebilir.
Sağlayıcının kendi hata metni neden ekranda görünmüyor?
Aynı ham metin farklı nedenlerle dönebildiği için yanıltıcıdır. STEQAR bunun yerine hatayı bir sınıfa çevirir ve sınıfa uygun Türkçe bir ileti gösterir; böylece nereye bakacağınız daha net olur.
STEQAR, eKüpSoft'un yanı sıra başka e-İrsaliye entegratörleriyle de çalışır; EDM Bilişim, Turkcell e-Şirket, Orkestra e-Faturacım, Veriban, e-Logo, QNB eSolutions, Digital Planet, KolayBi, Nilvera ve VBT bu seçenekler arasındadır. Farkları Kantar e-İrsaliye entegratörleri yazımızda karşılaştırdık.