Kurulum için eKüpSoft hesabınızın kullanıcı adı ve şifresi ile gönderenin VKN ya da TCKN'si ve unvanı gerekir. Test Ortamı işareti hem servis adresini hem kimlik setini seçer; adres elle yazılamaz. Bağlantı testi taze bir oturum açma denemesidir. Başarılı olması gönderimin çalışacağı anlamına gelmez, çünkü numara biçimi ve gönderen bilgisi gönderim sırasında ayrıca kontrol edilir.
Başlamadan önce elinizde olması gerekenler
Kuruluma oturmadan üç şeyi hazırlayın. Birincisi, eKüpSoft hesabınızın kullanıcı adı ve şifresi. İkincisi, belgeyi kesen firmanın VKN ya da TCKN'si ile unvanı. Üçüncüsü, hesabınızın hangi ortama ait olduğu bilgisi. Hesabın açılması ve kullanıcı adıyla şifrenin size verilmesi sizinle eKüpSoft arasındaki iştir; bu rehber yalnızca STEQAR tarafındaki ayarları anlatır. Gönderimin bütününü eKüpSoft ile kantardan e-İrsaliye yazısında topladık.
Ayar ekranı alan alan
Ekrandaki alanlar iki gruba ayrılır: hesabı tanımlayanlar ve gönderen firmayı tanımlayanlar. Zorunlu olanlar boşsa gönderim ağa çıkmadan durur ve eksik ayar operatöre bildirilir.
| Alan | Durum | Notu |
|---|---|---|
| Test Ortamı | İşaret | Hangi ortamın kullanılacağını seçer. |
| Kullanıcı Adı | Zorunlu | Eksikse gönderim başlamaz ve eksik ayar gösterilir. |
| Şifre | Zorunlu | Gizli alandır; şifreli depoda tutulur. |
| Gönderen VKN/TCKN | Zorunlu | Boşsa belge gönderilmez. |
| Gönderen unvan | Zorunlu | Boşsa belge gönderilmez. |
| Gönderen birim etiketi | İsteğe bağlı | Boş bırakılabilir; doluysa geçerli biçimde olmalıdır. |
| Şahıs firması ad ve soyad | İsteğe bağlı | On bir haneli kimlikte kullanılır. |
| Vergi dairesi, il, ilçe, adres, posta kodu | İsteğe bağlı | Gönderen bilgisinin tamamlayıcı parçalarıdır. |
Gönderen bloğunun nasıl çalıştığını, özellikle birim etiketinin boş ve dolu hâlini gönderen bilgileri yazısında ayrıca anlattık.
Şahıs firması için fark
Gönderen on bir haneli bir kimlikle, yani TCKN ile tanımlıysa belge şahıs firması adına düzenlenir ve ayar ekranındaki ad ve soyad alanları kullanılır. Bu iki alan isteğe bağlıdır; unvan ise tüzel kişide de şahıs firmasında da zorunlu kalır. Yani yalnızca kimliği girip unvanı boş bırakmak, kurulumu tamamlamış sayılmanız için yeterli değildir: eksik unvanla belge gönderilmez.
Test Ortamı işareti ne yapar?
Ayar ekranında servis adresi diye bir alan yoktur. Bunun yerine tek bir Test Ortamı işareti bulunur ve bu işaret hem hangi servis adresine gidileceğini hem hangi kimlik setinin kullanılacağını birlikte seçer. Serbest adres girilemez; ortam yalnızca bu işaretle belirlenir. Ekranda karıştırılacak ikinci bir alan olmaması işi basitleştirir, ama kuralı da koyar: hesap bilgileriniz hangi ortama aitse işaret de ona göre durmalıdır. Ortamı değiştirmek istediğinizde yalnızca işareti çevirmek yetmez; seçtiğiniz ortamın kimlik bilgilerinin de ayarlarda doğru olduğundan emin olmanız gerekir.
İşaret hesabınızla uyuşmadığında operatör, servis adresi ya da ortam seçiminin hatalı olduğunu söyleyen sınıflandırılmış bir Türkçe ileti görür. Sağlayıcının ham iletisi ekrana taşınmaz. Hangi iletinin neye işaret ettiği bağlantı hataları yazısında ayrıntılandı.
Bağlantı testi ne gösterir, ne göstermez?
Bağlantı testi, eKüpSoft'a yapılan taze bir oturum açma denemesidir. Daha önce açılmış bir oturumdan başarı döndürmez ve başarısız olursa kendiliğinden ikinci bir deneme yapmaz; gördüğünüz sonuç o anki denemenin sonucudur. Başarılı çıkması yalnız bir şeyi gösterir: bu kullanıcı adı ve şifreyle, seçili ortamda oturum açılabildi.
Göstermediği şey ise gönderimin kendisidir. Bir tartım eKüpSoft'a gitmeden önce şu kontrollerden geçer ve hiçbiri bağlantı testinin konusu değildir:
- numaranın beklenen biçimde olması,
- gönderenin VKN ya da TCKN'sinin ve unvanının dolu olması,
- belgenin eksiksiz oluşturulabilmesi,
- alıcı kutusunun sorulması.
Gönderimdeki sıra ana yazıdaki haritada, numara kuralı ise numara ve seri yazısında yer alıyor.
Kurulum sırası
- Hesabınızın ait olduğu ortama göre Test Ortamı işaretini ayarlayın.
- Kullanıcı adı ve şifreyi girin.
- Gönderenin VKN ya da TCKN'sini ve unvanını girin. Şahıs firmasıysa ad ve soyadı da ekleyin.
- İsterseniz birim etiketi, vergi dairesi, il, ilçe, adres ve posta kodunu doldurun.
- Bağlantıyı test edin.
- Numara biçim kuralı için numara yazısına bakın.
Bu sıra işi kısaltır çünkü hesap hatası ile gönderen hatasını birbirinden ayırır: önce oturum açılır, sonra belge tarafına geçilir. Genel akışı başka bir açıdan görmek için Kantardan otomatik e-İrsaliye nasıl kesilir? yazısına, entegratör seçeneklerini yan yana değerlendirmek için Kantar e-İrsaliye entegratörleri yazısına bakabilirsiniz.
Oturum kurulumdan sonra kendini yönetir
Ayarları bir kez girdikten sonra oturumla uğraşmazsınız. Oturum sınırlı ömürlüdür ve STEQAR onu süresi dolmadan yeniler. Korumalı bir istekte kimlik reddi gelirse en çok bir yeniden giriş yapılır ve istek bir kez tekrarlanır. Yeniden giriş de reddedilirse sorun sert bir kimlik hatası olarak durur; STEQAR aynı isteği döngüye sokmaz. Hız sınırı aşımı ise kimlik hatasından ayrı bir sınıftır ve oturumu düşürmez. Bu ayrımın iletilerdeki karşılığı bağlantı hataları yazısında anlatılıyor.
Kurulum sırasında görebileceğiniz iletiler
Hata olduğunda sağlayıcının ham iletisi değil, STEQAR'ın sınıflandırdığı Türkçe bir ileti gösterilir. Kurulumda en çok şu üçüyle karşılaşırsınız:
- Kimlik bilgisi hatası ya da oturum açılamadı. Kullanıcı Adı ve Şifre alanlarını, ardından Test Ortamı işaretini gözden geçirin.
- Servis adresi ya da ortam seçimi hatalı. Test Ortamı işareti hesabınızın ortamıyla uyuşmuyor demektir; işareti çevirin.
- Kimlik bilgileri eksik ya da okunamadı. Kullanıcı adı ve şifrenin ayarlarda dolu olduğunu doğrulayın.
Güvenlik duvarı, hız sınırı, sağlayıcıya ulaşılamaması ve beklenmeyen yanıt gibi diğer sınıflar kuruluma değil bağlantıya ilişkindir; onlar için bağlantı hataları yazısına bakın.
Hesap alanları oturumu, gönderen alanları belgeyi ilgilendirir; kurulum ikisini de doldurmakla biter.
Sık sorulan sorular
Test Ortamı işareti ne yapar?
Tek işaret hem servis adresini hem kimlik setini seçer. Hesabınız hangi ortama aitse işaret de ona göre durmalıdır. Ortam ya da servis adresi seçimi hatalıysa buna işaret eden sınıflandırılmış bir ileti görürsünüz.
Servis adresini neden elle yazamıyorum?
Adres alanı bilerek yoktur. Ortam yalnız Test Ortamı işaretiyle seçilir ve serbest adres girilemez.
Bağlantı testi başarılı ama gönderim hata veriyorsa ne yapmalıyım?
Gönderimdeki kontroller bağlantı testinden ayrıdır; numara biçimi, gönderen bilgisi, belgenin oluşturulması ve alıcı kutusu sorgusu gönderim sırasında yapılır. Hata iletisi hangisinde takıldığını gösterir; iletinin işaret ettiği ayara bakın.
Şifre ayarlarda nasıl tutulur?
Şifre gizli alandır ve şifreli depoda tutulur.
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.