Nilvera belge numarası üç harfli seri, dört haneli yıl ve dokuz haneli sıradan oluşur; biçim dışı numarayla gönderim başlamaz. Belge kimliği (ETTN) gönderimden önce bir kez belirlenir ve akış boyunca sabit kalır. Belirsiz sonuçta sürücü aynı kimlik, numara ve içerikle yalnızca bir kez daha dener.
Numara: üç parça, tek biçim
Belge numarası üç parçadan oluşur ve üçü de denetlenir. Tablo her parçanın kuralını gösterir:
| Parça | Kural | Ne olur? |
|---|---|---|
| Seri | İlk üç karakter harf | Seri Nilvera hesabında tanımlı olmalıdır. |
| Yıl | Sonraki dört hane | Rakam olmayan yıl parçası numarayı geçersiz kılar. |
| Sıra | Son dokuz hane | Tamamı sıfır olamaz. |
Numara denetlenmeden önce büyük harfe çevrilir ve baştaki sondaki boşluklar atılır; küçük harfle yazılmış geçerli bir numara bu yüzden reddedilmez. Yalnızca üç harfli bir seri, boş değer ya da otomatik ailesinden bir değer numara sayılmaz. Bunların hepsinde gönderim ağ çağrısı yapılmadan durur ve ileti numaranın beklenen biçimde olmadığını söyler. Sürücü numara üretmez; yalnızca gelen numarayı doğrular. Bu yüzden numara sayacı ve seri yönetimi sürücünün konusu değildir.
Biçim denetimi neden kantarda yapılır?
Numara kuralı bilerek katıdır. Hata, gönderimden sonra uzaktan gelen bir retle değil, gönderim başlamadan ve anlaşılır bir iletiyle kantarda yakalanır. Denetim ağ çağrısından önce biter; yanlış numaralı bir belge Nilvera'ya hiç ulaşmaz ve orada bir kayıt oluşturmaz.
Seri bu kuralın neresinde?
Seri numaranın ilk üç harfidir ve ayarlarda ayrı bir alan yoktur. Sürücü gönderimden önce serinin hesapta tanımlı olup olmadığını sormaz; bunu Nilvera denetler. Seri tanımlı değilse belge reddedilir, oluşmaz ve ileti seriyi Nilvera portalinden açmanızı söyler. Seri hazırlığının adımları hesap ve seri yazısında.
Belge kimliği: gönderimden önce bir kez belirlenir
Numaranın yanında her belgenin bir de kimliği (ETTN) vardır. Ana uygulama bir kimlik verdiyse sürücü onu kullanır; vermediyse gönderimden önce bir kez üretilir. Kimlik hem belgenin içine yazılır hem de sürücü tarafından akış boyunca saklanır. Kimliğin üretildiği an gönderim çağrısından öncedir ve üretim bir kez yapılır; gönderim sırasında yeni bir kimlik yaratılmaz. Böylece iki deneme aynı kimliği taşır.
Neden ikisi de değişmez?
Belirsiz bir gönderimden sonra belgenin sağlayıcıda oluşmuş olabileceği düşünülür. Bu nedenle sürücü yeniden denemede kimliği ve numarayı değiştirmez: ilk deneme ve tek yeniden deneme aynı kimlik, aynı numara ve aynı içerikle gider. Kapıların tamamı Nilvera ile Kantardan e-İrsaliye rehberinde, kesinti anındaki davranış internet kesilince yazısında anlatılıyor.
İki tekillik, iki farklı sonuç
Belge kimliği ve belge numarası birbirinden bağımsız olarak çakışabilir. Sürücü bu iki çakışmayı iki farklı sınıfa koyar ve karıştırmaz:
| Çakışan şey | Sürücünün sonucu | İleti ne söyler? |
|---|---|---|
| Belge kimliği | Başarı sayılır; GİB tarafı doğrulanmadığı için kayda uyarı eklenir. | Belge sağlayıcıda zaten kayıtlı; durumu sorgulayarak doğrulayın. |
| Belge numarası | Ret sayılır; zaten gönderildi sayılmaz. | Numara kullanılmış; sayacı kontrol edin, aynı numarayla yeniden göndermeyin. |
Ayrımın nedeni basittir. Kimlik çakışması, sizin gönderdiğiniz aynı belgenin sistemde olduğunu gösterir. Numara çakışması ise başka bir belgenin o numarayı almış olduğunu gösterir ve sizin belgeniz sistemde olmayabilir. İkisini aynı sonuca indirgemek ya yanlışlıkla başarı ya da gereksiz ret üretirdi. Retlerin tam sınıflandırması önizleme ve hata sınıfları yazısında.
Yanıttaki numara farklı çıkarsa
Başarılı gönderimde Nilvera belge kimliğinin yanında numarayı da bildirir. Bildirilen numara gönderdiğinizle aynıysa fark yoktur. Farklıysa kayıtta Nilvera'nın numarası kullanılır ve aradaki fark günlüğe ile ham yanıt kaydına yazılır. Numara hiç bildirilmemişse gönderdiğiniz numara geçerli kalır. Bir yanıtın başarı sayılması için belge kimliğinin dolu olması gerekir; kimliksiz bir başarı yanıtı belirsiz sonuçtur ve numaraya bakılarak başarıya çevrilmez.
Kayıtta hangi tanımlayıcılar durur?
Bir gönderimin kaydında üç tanımlayıcı yan yana bulunur: belge numarası, belge kimliği (ETTN) ve gönderim sonrası Nilvera'nın bildirdiği kendi belge kimliği. Numara, gönderdiğiniz değerdir; Nilvera farklı bir numara bildirdiyse onunki yazılır. Nilvera'nın kendi kimliği durum sorgusunda tercih edilir, ama yalnızca uygulama çalıştığı sürece hatırlanır; yeniden başlatmadan sonra sorgu ETTN ile yapılır.
Hangi iletiyi görürsünüz?
| İleti | Neden? | Yapılacak iş |
|---|---|---|
| Numara biçimi geçersiz | Numara üç harf, dört hane ve dokuz hane kuralına uymuyor; gönderim başlamadı. | Numarayı biçime uydurun. |
| Seri tanımlı ya da aktif değil | Nilvera seriyi hesapta bulamadı; belge oluşmadı. | Seriyi portalden açın. |
| Numara sağlayıcıda kullanılmış | Başka bir belge o numarayı almış. | Sayacı denetleyin, aynı numarayı denemeyin. |
| Belge sağlayıcıda zaten kayıtlı | Belge kimliği sistemde var. | Durumu sorgulayın. |
Kısa kontrol listesi
- Numaranın üç harf, dört hane ve dokuz haneden oluştuğunu doğrulayın.
- Serinin Nilvera hesabında tanımlı olduğunu portalden kontrol edin.
- Numara çakışması iletisi gelirse sayacı denetleyin; aynı numarayı yeniden denemeyin.
- Zaten kayıtlı iletisi gelirse durumu sorgulayın; belge sistemdedir.
Kantarda e-İrsaliyenin tartımdan nasıl çıktığı için Kantardan otomatik e-İrsaliye nasıl kesilir? yazısına bakın.
Numara biçimle, kimlik sabitlikle korunur: biçim dışı numara gönderilmez, belirsiz sonuçta kimlik ve numara yenilenmez.
Sık sorulan sorular
Nilvera için belge numarası hangi biçimde olmalı?
Üç harfli seri, dört haneli yıl ve dokuz haneli sıra, toplam on altı karakter. Sıranın tamamı sıfır olamaz. Büyük küçük harf ve baştaki sondaki boşluk düzeltilir. Boş, kısa, yalnızca seriden oluşan, otomatik yazan ya da biçim dışı bir değerle gönderim ağa çıkmadan durur.
STEQAR belge numarasını kendisi üretir mi?
Bu bağlantı numara üretmez, yalnızca doğrular. Numaranın biçimi kurala uymuyorsa belge gönderilmez ve ileti biçimi anlatır. Sayaç ve seri yönetimi bu rehberin konusu değildir.
Tekrar gönderimde belge kimliği değişir mi?
Sürücünün kendi yeniden denemesinde değişmez. Belirsiz kalan bir gönderim aynı belge kimliği, aynı numara ve aynı içerikle bir kez daha denenir. Kimlik ve numara akış içinde yenilenmez.
Nilvera farklı bir numara döndürürse ne olur?
Kayıtta Nilvera'nın bildirdiği numara kullanılır ve aradaki fark günlüğe ile ham yanıt kaydına yazılır. Fark sessizce kabul edilmez; kayıttan hangi numaranın gönderildiği ve hangisinin döndüğü okunabilir.
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.