Nilvera bağlantısı kullanıcı şifresiyle değil, portalda ürettiğiniz API anahtarıyla kurulur. Rahat Aktarım'da Kullanıcı Adı alanına firmanın Nilvera'daki tam resmi unvanı, Şifre alanına bu anahtar yazılır. Anahtar süresiz ve tam yetkili üretilirse e-Fatura ve e-Arşiv belgeleri eksiksiz gelir. Anahtar portalda yalnızca bir kez görüntülendiği için üretir üretmez kaydedin.
API anahtarı nasıl üretilir?
- Nilvera Portal'a (portal.nilvera.com) giriş yapın ve sol menüde YÖNETİM PANELİ altındaki API Tanımları'nı açın.
- Listenin sağ üst köşesindeki yeşil + YENİ ANAHTAR düğmesine basın.
- Açıklama alanına bir tanım yazın (ör. fatura aktarım).
- Son Geçerlilik Tarihi alanını boş bırakın; boş bırakıldığında süresiz yetki tanımlanır.
- Sol alttaki TÜMÜNÜ SEÇ düğmesine basın; konnektör, fatura işlemleri, e-Fatura ve e-Arşiv sekmelerindeki yetkiler tek seferde seçilir. Ardından KAYDET'e basın.
- Çıkan API Erişim Anahtarı penceresinde KOPYALA VE KAPAT'a basın. Anahtar yalnızca bir kez gösterilir.
Rahat Aktarım'da Nilvera'yı seçtiğinizde bu adımlar ekran görüntüleriyle bir rehber penceresinde de açılır. Firma kodu alanı gerekmez; bağlantıyı Fatura Ayarları > Entegratörler ekranında tanımlarsınız.
En sık yapılan hata nedir?
En sık hata, Şifre alanına hesap şifresini yazmaktır. Tablodaki Şifre sütununun başlığı satırlara göre değişir: tüm satırlar API anahtarı kullanıyorsa "API Anahtarı", karışık kullanımda "Şifre / API Anahtarı" görünür. Nilvera satırında buraya hesap şifresi değil, portalda ürettiğiniz anahtar yazılır. Yetkileri tek tek seçip bir sekmeyi atlamak ilgili belge türünün eksik gelmesine yol açabilir; bu yüzden Tümünü Seç önerilir.
Hangi belgeler alınır?
| Belge | Yön | Alınma koşulu |
|---|---|---|
| e-Fatura (ticari olmayan) | Giden / Gelen | Başarıyla iletilmiş faturalar |
| e-Fatura (ticari) | Giden / Gelen | Başarıyla iletilmiş ve alıcı tarafından kabul edilmiş ya da otomatik yanıtlanmış faturalar |
| e-Arşiv | Giden | Başarıyla iletilmiş ve iptal edilmemiş faturalar |
Ticari faturalarda yalnızca kabul edilmiş veya otomatik yanıtlanmış faturalar alınır; reddedilen ya da hâlâ yanıt bekleyenler listeye girmez. Böylece muhasebe kaydına konu olmayan bir ticari fatura fişe karışmaz.
Tarih aralığı ve gelen e-Arşiv
Başlangıç tarihi bitiş tarihinden sonra olamaz; geçersiz bir tarih seçerseniz çekim başlamadan uyarı alırsınız. Gelen yönde yalnızca e-Fatura alınır, çünkü gelen e-Arşiv diye bir belge türü yoktur. Geniş tarih aralıklarında çekim daha uzun sürebilir; dönemi aylara bölmek işi hızlandırır.
Sonra ne olur?
Faturalar sayfasında cari ve hesap eşleşmelerini kontrol eder, faturaları seçip Fiş Oluştur dersiniz; fişleri Fişler sayfasında gözden geçirip programınıza gönderirsiniz. Hiçbir fiş sizin onayınız olmadan gönderilmez. Aşağıdaki tutarlar örnektir; hesap kodları hesap planınıza göre değişir.
| Fatura | Borç | Alacak |
|---|---|---|
| Gelen e-Fatura: 8.000 TL mal alışı + 1.600 TL KDV (%20) | 153 Ticari Mallar 8.000 TL 191 İndirilecek KDV 1.600 TL | 320 Satıcılar 9.600 TL |
| Giden e-Arşiv: 8.000 TL satış + 1.600 TL KDV (%20) | 120 Alıcılar 9.600 TL | 600 Yurt İçi Satışlar 8.000 TL 391 Hesaplanan KDV 1.600 TL |
Sorun giderme
- Giriş reddedildi: Kullanıcı Adı alanında e-posta yerine Nilvera'daki tam firma unvanını yazdığınızdan emin olun.
- Anahtarı kaybettim: Anahtar tekrar görüntülenemez; portalda yeni bir anahtar üretip tabloyu güncelleyin.
- Bazı belgeler eksik: Anahtar oluşturulurken bir yetki sekmesi atlanmış olabilir; Tümünü Seç ile yeni bir anahtar üretin.
- Anahtarın süresi doldu: Son Geçerlilik Tarihi dolu bırakılmışsa o tarihte bağlantı kesilir; süresiz anahtar bu yüzden önerilir.
Aktarım sonrası kontrol listesi
- Faturalar sayfasındaki belge sayısını Nilvera portalındaki sayıyla karşılaştırın; ekrandaki uyarı da iptal ve red durumlarının portalda bir kez doğrulanmasını ister.
- Ticari faturalardan kabul edilmeyenlerin listede olmaması normaldir.
- Fişlerdeki KDV tutarlarını portaldaki fatura toplamlarıyla birkaç örnekte karşılaştırın.
Hesap eşleşmeleri için otomatik cari eşleştirme, diğer entegratörler için özel entegratör nedir ve desteklenen entegratörler yazıları yardımcı olur. API anahtarıyla çalışan bir diğer bağlantı için NES Portal rehberine bakabilirsiniz.