Nilvera hesabında kantardan gönderim için üç şey hazır olmalıdır: portaldan üretilmiş bir API anahtarı, hesapta tanımlı gönderen etiketi ve belge numarasının ilk harflerinin ait olduğu, firmaya tanımlı bir seri. Numarayı kantar programı verir; seri tanımlı değilse sağlayıcı belgeyi açık bir hata mesajıyla reddeder.
API anahtarı
Nilvera'da bağlantı, tek bir anahtarla kurulur. Anahtar portalda API tanımları bölümünden üretilir ve her istekte bir başlıkla gönderilir. Ayrı bir oturum açma, anahtar yenileme ya da süre dolması yönetimi gerekmez; bu, bağlantı katmanını sade tutar.
Dikkat edilecek tek nokta anahtarın bir kez gösterilmesidir. Üretildiği anda kopyalanmazsa kaybolur ve yenisi gerekir. Anahtarı bir parola gibi ele alın: yazışmalara, belgelere ve ekran görüntülerine koymayın, yalnızca kantar ayarlarında saklayın. Genel durum için Nilvera rehber yazısına bakabilirsiniz.
Gönderen etiketi
E-irsaliye göndermek için hesapta bir gönderici birim etiketi tanımlı olmalıdır. Nilvera'nın test hesabında bu etiket hazır geldi; bu önemli bir farktır, çünkü başka sağlayıcılarda gönderen etiketinin hesapta olmaması gönderimi baştan engelleyebilir. Hesabın kendi etiketleri, bağlantı kontrolü sırasında hesap bilgisinden okunabilir; ayrıca ayar girmeye gerek kalmaz.
| Etiket | Görevi |
|---|---|
| Gönderici birim | Belgenin hangi birimden çıktığını belirler |
| Posta kutusu | Gelen belgelerin teslim edildiği kutudur |
Etiketler sağlayıcıdan sağlayıcıya aynı değildir; bir sağlayıcıdaki etiketi diğerine kopyalamak çalışmaz.
Belge numarası ve seri
Nilvera'da numarayı sunucu atamaz. Gönderim denemelerinde iki şey öğrendik: boş numara kabul edilmedi, ve numaranın ilk üç harfi firmaya tanımlı bir seri olmadığında belge reddedildi. Seri açıldıktan sonra aynı belge kabul edildi ve numara yanıtta olduğu gibi döndü.
- Seri belirlenir. Kantar ayarlarında kullanılacak seri kodu seçilir.
- Seri doğrulanır. Seri listesinden, kodun hesapta tanımlı ve aktif olduğu görülür.
- Numara üretilir. Kantarın ürettiği numara bu serinin kodu ile başlar ve aynen gönderilir.
Paylaşımlı bir test hesabında çok sayıda seri bulunur; başkalarının numaralarına karışmamak için ayrı bir seri açmak doğru olur. Numaranın tekil olması da şarttır: aynı numarayla ikinci belge reddedilir. Konuyu mükerrer e-irsaliye önleme yazısında genel olarak anlattık.
Test ortamında iki kurum
Nilvera, test için iki ayrı kurum verir. Bu, tek bir hesapta kendi kendine gönderim yapmak yerine, bir kurumdan diğerine gerçek bir gönderim yapıp alıcı tarafında teyit etmeyi mümkün kılar. İki kurumun etiketleri ortaktır; yani test kutuları paylaşımlıdır. Bu nedenle test sonuçlarını canlı hesapla karıştırmamak gerekir: canlı hesabın etiketi, serisi ve anahtarı kendi kaynağından okunur.
Eksik hazırlığın belirtileri
- Seri firmaya tanımlı değil. Numaranın ilk harfleri hesapta yok; seri açılmalı ya da kod düzeltilmeli.
- Numara biçimi geçersiz. Boş ya da beklenen uzunlukta olmayan numara; sağlayıcı beklenen biçimi mesajda gösterir.
- Gönderen etiketi bulunamadı. Hesapta gönderici birim yok; hesabın sağlayıcı tarafından hazırlanması gerekir.
Bu hataların tamamı, belge GİB'e çıkmadan sağlayıcıda yakalanır ve ayrıntısı önizleme, şema ve hata kodları yazısında. Hesabınız hazırsa iletişim sayfasından bize yazın; demo ücretsizdir.
Sık sorulan sorular
Nilvera'da oturum açma ve yenileme gerekiyor mu?
Hayır. Bağlantı tek bir API anahtarıyla yapılır; ayrı bir oturum açma ya da yenileme adımı yoktur. Anahtar her istekte bir başlıkla gönderilir.
API anahtarı kaybolursa ne olur?
Anahtar yalnızca üretildiği anda bir kez gösterilir. Kaybolursa portaldan yenisi üretilir. Bu yüzden anahtar kantar ayarlarında güvenli saklanmalı, yazışmalara konmamalıdır.
Belge numarasını kim veriyor?
Numarayı istemci, yani kantar programı verir; sağlayıcı seriden numara atamaz ve boş numara kabul etmez. Ancak numaranın ilk harfleri firmaya tanımlı bir seriye ait olmalıdır.
Seri tanımlı değilse ne olur?
Sağlayıcı belgeyi reddeder ve serinin firmaya tanımlı olmadığını bildirir. Seri portaldan ya da arayüzden açılır; sonra gönderim yapılır.
Hazırlık tamamsa kantar Nilvera ile çalışır mı?
Henüz değil. Bu yazı sağlayıcı hesabının hazırlığını anlatır; 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.