Kısa cevap

STEQAR'da Nilvera ayarları üç gruptur: Test Ortamı işareti, erişim anahtarı ve gönderen firma bilgileri. Gönderen birim etiketi ayarlara yazılmaz, hesaptan okunur; seri ise belge numarasının ilk üç harfidir ve Nilvera hesabında önceden tanımlı olmalıdır. Bağlantı kontrolü hesabı doğrular ve serileri listeler, belge göndermez.

Ayarlarda hangi alanlar var?

Nilvera bağlantısı bilinçli olarak az alanla kurulur. Aşağıdaki tablo her alanın zorunlu olup olmadığını ve işini gösterir:

AlanZorunlu mu?Ne için?
Test Ortamı işaretiHayırHangi Nilvera ortamına bağlanılacağını seçer. Adres elle girilmez.
Erişim anahtarıEvetHer istekte kimlik olarak taşınır. Gizli alandır.
Gönderen VKN ya da TCKNEvetBelgede gönderen taraf olarak yazılır.
Gönderen unvanEvetBelgede gönderen adı olarak yazılır.
Ad ve soyadŞahıs firmasındaGönderen şahıs ise kişi bloğu için girilir.
Vergi dairesi, il, ilçe, adres, posta koduHayırGönderen adres bilgilerini tamamlar.

Dikkat çeken üç eksik vardır. Kullanıcı adı ve parola yoktur, çünkü Nilvera kimliği tek anahtarla alır. Sunucu adresi alanı yoktur, çünkü serbest bir adres yazılabilen bir alan anahtarın yanlış yere gitmesine kapı açardı. Gönderen birim etiketi alanı da yoktur, çünkü etiket hesabınıza bağlıdır ve hesaptan okunur.

Ortam seçimi ve anahtarın korunması

Ortam tek bir işaretle, Test Ortamı ile seçilir; adres yazılacak bir kutu yoktur. Anahtar yalnızca Nilvera'ya giden isteğin kimlik bölümünde taşınır. Günlük satırlarına, gönderim sonucuna ve ham yanıt kaydına yazılmaz.

Zorunlu olan ve olmayan alanlar

Gönderimi başlatmak için üç alan yeter: erişim anahtarı, gönderen VKN ya da TCKN ve unvan. Ad ve soyad yalnızca gönderen şahıs firmasıysa anlam taşır; vergi dairesi, il, ilçe, adres ve posta kodu belgenin gönderen bölümünü tamamlar ama boş bırakılabilir.

Eksik ayarda ne olur?

Erişim anahtarı boşsa ya da gönderen VKN veya unvan eksikse gönderim ağa hiç çıkmaz; ileti eksik alanı söyler. Metin olarak okunamayan bir ayar da eksik sayılır. Ayarlardan biri kayıtlı olduğu hâlde yanlışsa durum farklıdır: anahtar geçersizse ileti yeni anahtar üretip girmenizi ister.

Bağlantı kontrolü neyi sınar?

Bağlantı kontrolü bir belge denemesi değildir. Hesaba salt okuma istek göndererek kimliğin geçerli olduğunu doğrular, gönderen birim etiketini okur ve tanımlı serilerin kısa bir listesini ileti olarak gösterir. Anahtar boşsa ağdan önce durur. Seri listesi okunamazsa ya da eksik kalırsa ileti tam listenin okunamadığını söyler; sürücü hesapta seri olmadığını asla uydurmaz. Kontrol başarısız olursa ileti nedeni söyler: anahtar eksikse ağdan önce durur, kimlik reddedildiyse yeni anahtar ister, Nilvera'ya ulaşılamadıysa bağlantıyı ve ortam seçimini kontrol etmenizi ister. Bu kontrol yeşil olsa bile gönderim başka kapılardan geçer: numara biçimi, alıcı etiketi ve belgenin kendisi gönderimde ayrıca denetlenir.

Gönderen birim etiketi hesaptan okunur

Etiket, hesabınızdaki gönderen birim kaydından çözülür ve süreç boyunca hatırlanır; her gönderimde yeniden sorulmaz. Okunan değer posta kutusu biçiminde değilse belgeye yazılmaz, günlüğe uyarı düşer. Etiket hiç okunamazsa gönderim durdurulmaz; bu durumda sağlayıcı belgeyi gönderen etiketi nedeniyle reddedebilir ve ret iletisi bunu söyler.

Seri: numaranın ilk üç harfi

Belge numarası üç harfli seri, dört haneli yıl ve dokuz haneli sıradan oluşur. Seri, numaranın ilk üç harfidir ve ayarlarda ayrı bir kutu olarak yer almaz; çünkü aynı bilgiyi iki yerde tutmak çelişki üretirdi. Sürücü gönderimde seriyi önceden Nilvera'ya sormaz. Seri hesapta tanımlı ve aktif değilse Nilvera belgeyi reddeder; bu durumda belge oluşmaz, ileti serinin Nilvera portalinden açılmasını söyler. Numaranın biçim kuralı için belge kimliği ve numara yazısına bakın. Önizleme seriyi denetlemediği için serinin doğruluğunu önizleme göstermez; ayrıntı önizleme yazısında.

Sık görülen ayar sorunları

BelirtiAnlamıÇözüm
Anahtar girilmemiş iletisiErişim anahtarı alanı boş; ağ çağrısı yapılmadı.Portalden anahtar üretip ayarlara girin.
Anahtar geçersiz ya da yetkisiz iletisiNilvera kimliği kabul etmedi.Yeni anahtar üretip girin.
Gönderen firma eksik iletisiVKN ya da unvan boş; belge gönderilmedi.İki alanı da doldurun.
Tam liste okunamadı iletisiSeri listesi eksik ya da okunamadı.Portalden seri tanımlarına bakın.
Gönderen etiketi reddiGönderen birim etiketi hesapta bulunamadı.İletideki yönlendirmeyi izleyin.

İlk belgeden önce kontrol listesi

  1. Erişim anahtarını Nilvera portalinde üretin ve ayarlara yazın; anahtarı ayarların dışında paylaşmayın.
  2. Gönderen VKN ya da TCKN ile unvanı girin; şahıs firmasıysa ad ve soyadı da ekleyin.
  3. Kullanacağınız seriyi portalde açın.
  4. Bağlantı kontrolünü çalıştırın; iletide serinizi görmeniz gerekir. Tam liste okunamadı iletisi çıkarsa portaldan seri tanımlarına bakın.
  5. Önce bir önizleme alın, sonra gerçek gönderime geçin.

Genel akışı görmek için Nilvera ile Kantardan e-İrsaliye rehberini, e-İrsaliyenin kantarda nasıl kesildiğini anlamak için Kantardan otomatik e-İrsaliye nasıl kesilir? yazısını okuyabilirsiniz.

Ayarlar az: anahtar ve gönderen bilgileri ayarlarda, gönderen birim etiketi hesaptan okunur, seri ise Nilvera hesabında tanımlı olmalıdır.

Sık sorulan sorular

Nilvera ayarlarında kullanıcı adı ve parola girilir mi?

Hayır. Bağlantı tek bir erişim anahtarıyla kurulur; kullanıcı adı, parola ya da sunucu adresi alanı yoktur. Anahtarı Nilvera portalinde üretip ayarlara yazarsınız, alan gizli olarak saklanır. Anahtar geçersiz ya da yetkisizse ileti yeni bir anahtar üretip ayarlara girmenizi ister.

Gönderen birim etiketini ayarlara yazmam gerekir mi?

Hayır. Etiket ayarlarda alan olarak bulunmaz; hesabınızdan okunur ve çalışma süresince hatırlanır. Okunan değer posta kutusu biçiminde değilse kullanılmaz ve günlüğe yazılır.

Belge serisini nereden seçerim?

Seri için ayarlarda ayrı bir alan yoktur. Seri, belge numarasının ilk üç harfidir. Seri Nilvera hesabında tanımlı ve aktif olmalıdır; değilse Nilvera belgeyi reddeder, belge oluşmaz ve ileti seriyi portalden açmanızı söyler.

Bağlantı kontrolü belge gönderir mi?

Hayır. Bağlantı kontrolü hesabı okuyarak kimliği doğrular, tanımlı serileri listeler ve gönderen birim etiketini okur. Hiçbir belge göndermez. Başarılı bir kontrol, belgenin kabul edileceği anlamına gelmez; numara, alıcı ve belge kuralları gönderimde ayrıca işler.

Şeffaflık notu

STEQAR, Nilvera'nın 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, eKüpSoft, Digital Planet, KolayBi ve VBT bu seçenekler arasındadır. Farkları Kantar e-İrsaliye entegratörleri yazımızda karşılaştırdık.

Kendi tartımınızda görün

Tartımdan e-İrsaliyeye otomatik akışı gösterelim.

Kantarınızda bir tartım yapalım, belgenin entegratöre gidişini birlikte izleyelim. İnterneti kapatıp kuyruğu da deneriz.