Nilvera entegrasyonu:
siparişin faturası kendiliğinden kesilir.

Nilvera entegrasyonu nedir, Yox İş Ortağım'da hangi işleri üstlenir?

Nilvera, 2008'de Kayseri Erciyes Teknopark'ta kurulan Nilvera Yazılım ve Bilişim Hizmetleri Tic. Ltd. Şti.'nin bulut tabanlı e-dönüşüm platformudur. Gelir İdaresi Başkanlığı'nın ebelge.gib.gov.tr adresinde yayımladığı e-Fatura, e-Arşiv Fatura, e-İrsaliye, e-SMM ve e-Müstahsil Makbuzu özel entegratör listelerinin hepsinde yer alır. Özel entegratör, 509 Sıra No'lu VUK Genel Tebliği'nin saydığı üç yararlanma yönteminden biridir; diğer ikisi GİB Portal ve doğrudan entegrasyondur. Belgeyi düzenleyip GİB'e ve alıcıya ileten Nilvera'dır; siparişi toplayan, stoğu düşen ve kargoyu hazırlayan ise Yox İş Ortağım paneli.

Panelin Nilvera bağlantısıyla yaptığı altı iş

• Siparişten e-Arşiv: Bireysel alıcının siparişi için e-Arşiv Fatura Nilvera üzerinden kesilir; tutarı ve alıcı bilgisini elle girmezsiniz.
• Siparişten e-Fatura: Alıcı e-Fatura mükellefiyse aynı sipariş e-Fatura olarak düzenlenir.
• Fatura PDF'i: Kesilen belgenin PDF'i panele gelir ve kanal destekliyorsa siparişin geldiği pazaryerine yüklenir.
• Fatura iptali: İptal edilen ya da iade gelen siparişte iptal panelden başlatılır; iptalin mümkün olup olmadığına Nilvera ve mevzuat kuralları karar verir.
• Fatura durumu: Belgenin Nilvera'daki durumu (gönderildi, kabul, red) sorgulanır ve siparişin yanında görünür.
• Gelen faturalar: Size kesilen e-Faturalar Nilvera üzerinden panele gelir ve alış faturası olarak işlenebilir.

2026'da e-Fatura ve e-Arşiv zorunluluğu: pazaryeri satıcısı hangi kurala tabi?

Özel entegratör ihtiyacı çoğu zaman bir yasal hadden doğar. 22 Ocak 2022 tarihli Resmî Gazete'de yayımlanan 535 Sıra No'lu VUK Genel Tebliği'ne göre kendi sitesinden ya da aracı hizmet sağlayıcılar (pazaryerleri) üzerinden mal ve hizmet satan mükellefler, 2022 ve sonraki hesap dönemlerinde brüt satış hasılatı 500 Bin TL'ye ulaşırsa e-Fatura ve e-Arşiv Fatura uygulamalarına geçmek zorundadır. Geçiş, haddin aşıldığı hesap dönemini izleyen yedinci ayın başına kadar tamamlanır.

Haddin altında kalan satıcılar için 2026 kuralı

• 573 Sıra No'lu Tebliğ (RG 12.11.2024) ile e-Arşiv'e dahil olmayanların faturalarında sınır 2025 için vergiler dahil 3 Bin TL oldu; 1 Ocak 2026'dan itibaren tutarına bakılmaksızın bu faturalar GİB'in e-Arşiv Portalı'ndan düzenlenir.
• 589 Sıra No'lu Tebliğ (RG 31.12.2025, 5. Mükerrer) bu tarihi basit usuldekiler ile işletme hesabı esasına göre defter tutanlar için 1 Ocak 2027'ye erteledi; bu iki grup 2026'da 3 Bin TL'yi aşan faturaları portaldan e-Arşiv olarak düzenler.
• 509 Sıra No'lu Tebliğ'e göre e-Fatura uygulamasına dahil olanlar e-Arşiv Fatura uygulamasına da geçmek zorundadır; bu yüzden özel entegratör hesabı genellikle iki belgeyi birlikte kapsar.

Haddin altındaysanız ve az sipariş kesiyorsanız GİB e-Arşiv Portal entegrasyonu ayrı bir seçenektir; e-Fatura alıcılarınız da varsa özel entegratör daha uygun düşer.

İnternet satışı faturasında bulunması gereken bilgiler

509 Sıra No'lu Tebliğ'in güncel metnine göre internet üzerinden yapılan satışlarda e-Arşiv Faturanın elektronik ortamda iletilmesi zorunludur ve faturada “Bu satış internet üzerinden yapılmıştır.” ifadesi ile şu bilgiler yer alır:

• Satışın yapıldığı web adresi.
• Ödeme şekli ve ödeme tarihi.
• Mal satışında gönderiyi taşıyanın adı soyadı ya da unvanı ile VKN/TCKN'si.
• Malın gönderildiği ya da hizmetin ifa edildiği tarih.
• İade bölümü: iade edenin adı soyadı, adresi, imzası ile iade edilen malın cinsi, miktarı, birim fiyatı ve tutarı.

e-Fatura kullanıcısı bir firmaya internetten satışta düzenlenen e-Faturada iade bölümü dışındaki bilgiler aynen bulunur. Bu alanlar her siparişte aynı kuralla dolacağı için ödeme şekli ve kargo firması bilgisini mali müşavirinizle netleştirin.

Nilvera API anahtarı nasıl üretilir, hangi ayarlara dikkat edilir?

Nilvera'nın bütün API'leri OAuth 2.0 altyapısında çalışır ve erişim, Portal'da üretilen kalıcı bir anahtarla sağlanır; anahtar her istekte Bearer yöntemiyle gönderilir. Yox İş Ortağım'ın istediği zorunlu bilgi yalnız bu anahtardır, Nilvera Portal kullanıcı adınız ve şifreniz panelde sorulmaz. Kurulum/API adresi alanı isteğe bağlıdır; boş kalırsa varsayılan adres kullanılır.

1. Nilvera Portal'a (portal.nilvera.com) kendi kullanıcı adınız ve şifrenizle giriş yapın.
2. Sol menüde API Tanımları bölümüne girip Yeni Anahtar'ı seçin.
3. Açıklama alanına anahtarın nerede kullanıldığını hatırlatacak bir ad verin, örneğin Yox İş Ortağım sipariş faturaları.
4. Son geçerlilik tarihini belirleyin ya da alanı boş bırakıp süresiz anahtar üretin.
5. Ekranda bir kez gösterilen anahtarı kopyalayın, panelin Muhasebe bölümüne yapıştırın ve bağlantı testini çalıştırın.

Test ortamında neyi denemek gerekir?

Test ortamında kesilen belge gerçek fatura değildir; senaryo seçimini, seri ve şablon görünümünü, PDF'in siparişe dönüşünü görmek için kullanılır. İlk canlı faturayı düşük tutarlı bir siparişte birlikte kontrol etmek, seri ve şablon hatalarını alıcıya ulaşmadan yakalamanın en kısa yoludur.

Nilvera entegrasyonunda e-Fatura mı e-Arşiv mi kesilir?

Belge türünü pazaryeri değil, alıcının e-Fatura kaydı belirler. GİB'in tanımına göre e-Fatura, satıcı ile alıcı arasında merkezi platform üzerinden iletilen ve uygulamaya kayıtlı kullanıcılar arasında düzenlenen elektronik faturadır; kayıtlı olmayan kişi ve kurumlara e-Arşiv Fatura düzenlenir. Nilvera'nın Genel API'si vergi numarası ya da TC kimlik numarasıyla e-Fatura mükellefi sorgusu sunar ve kurala aykırı gönderimi kendisi durdurur: kayıtlı bir alıcıya e-Arşiv göndermeye çalışırsanız 2025 koduyla “Alıcı E-Fatura Mükellefidir” yanıtı döner.

Temel ve ticari senaryo arasındaki fark

e-Fatura iki ana senaryoyla gönderilir. Ticari senaryoda alıcı faturayı sistem üzerinden kabul ya da reddedebilir; temel senaryoda böyle bir yanıt yoktur, Nilvera'nın hata listesinde bu kural “Temel Faturalara Cevap Verilmemektedir” (1006) olarak geçer. Hangi senaryoyu kullanacağınızı mali müşavirinizle önceden belirleyin; kural bir kez kurulduğunda bütün kurumsal siparişler aynı senaryoyla gider.

Kurumsal alıcının vergi numarası eksik gelirse

Pazaryerinde kurumsal fatura isteyen alıcı vergi numarasını ve vergi dairesini siparişe girer. Bu alanlar boş gelirse belge bireysel e-Arşiv olarak kesilir ve e-Fatura mükellefi alıcı belgeyi geri ister. Vergi bilgisi eksik kurumsal siparişleri faturalamadan önce ayıklamak, sonradan iptal ve yeniden düzenleme işini azaltır.

Siparişten Nilvera faturasına: fatura kuralı ve akış adım adım

Panelde bütün kanalların siparişleri tek listede toplanır ve Yeni, Hazırlanıyor, Faturalandı, Kargolandı, Teslim durumlarından geçer. Nilvera bu zincirin fatura adımına bağlanır; hangi anda devreye gireceğini sizin belirlediğiniz fatura kuralı belirler.

1. Sipariş, kanalın resmî API'siyle panele düşer; alıcı adı, adresi ve varsa vergi numarası siparişle gelir.
2. Sipariş, kurulumda seçtiğiniz fatura aşamasına geldiğinde fatura işi başlar.
3. e-Fatura ya da e-Arşiv seçimi, alıcının durumuna göre kurduğunuz kurala bağlı olarak yapılır.
4. Belge, seçtiğiniz seri ve şablonla Nilvera üzerinden düzenlenir; sipariş Faturalandı durumuna geçer.
5. PDF panele gelir ve kanal destekliyorsa siparişin geldiği pazaryerine yüklenir.
6. Belgenin Nilvera'daki durumu sorgulanır ve siparişin yanında gösterilir.

PDF yükleme her kanalda aynı işlemez. Trendyol entegrasyonu ve Hepsiburada entegrasyonu sayfalarında kanalların fatura beklentisini anlattık; yüklemeyi desteklemeyen kanalda faturayı alıcıya kanalın kendi yöntemiyle iletirsiniz.

Seri ve şablon: kurulumda en çok atlanan adım

Nilvera'da e-Fatura ve e-Arşiv serileri ayrı ayrı tanımlanır. Nilvera'nın hata listesine göre aktif olmayan seriyle gönderim 2032 (e-Arşiv) ya da 2064 (e-Fatura) koduyla, seri yılı ile belge yılının tutmaması ise 2100 koduyla reddedilir. Panelden kesilecek faturalar için ayrı bir seri açmak, Nilvera Portal'da elle kestiğiniz belgelerle numara karışıklığını önler. Yıl başında serinin yeni yıla geçtiğini de kontrol edin.

Fatura durumu, iptal ve iade: Nilvera'daki kodlar ne anlatır?

Bir faturanın kesilmiş görünmesi, alıcıya ve GİB'e ulaştığı anlamına gelmez. Nilvera'nın geliştirici dokümanında e-Arşiv ve e-Fatura için ayrı durum alanları tanımlıdır; siparişin yanında gördüğünüz durum bu sorguya dayanır.

e-Arşiv iptalinde 8 günlük süre

GİB'in e-Arşiv Uygulamaları İptal, İhtar/İtiraz Bildirim Kılavuzu'na (Ocak 2025, sürüm 1.1) göre e-Arşiv Fatura iptalinde 8 günlük süre belgenin alıcıya iletildiği tarihten başlar ve iptal her durumda bu süre içinde yapılır. Kılavuz bu süreyi Türk Ticaret Kanunu'nun 21. maddesindeki sekiz günlük itiraz süresine dayandırır. Nilvera tarafında da sınırlar bellidir: daha önce iptal edilmiş belge (2026), raporu hatalı belge (2027) ya da kuyrukta bekleyen veya durumu bilinmeyen belge (2028) iptal edilemez.

e-Fatura'da iptal yerine yanıt ve yeni belge

Nilvera'nın e-Fatura API'sinde e-Arşiv'deki gibi bir iptal işlemi tanımlı değildir; e-Fatura tarafında alıcının yanıtı ve red cevabı sorgulanır. Teslim edilmiş bir siparişin iadesinde hangi belgenin düzenleneceği, alıcının e-Fatura mükellefi olup olmamasına göre değişir. İade akışını ilk iade gelmeden önce mali müşavirinizle yazılı hâle getirin.

Nilvera entegrasyonu hangi pakette, toplam maliyet nelerden oluşur?

Muhasebe ve e-Fatura bağlantıları Yox İş Ortağım'da Profesyonel paketle açılır ve Nilvera bir program hakkı sayılır. Panelde 80 satış kanalı (48'i hazır), 57 kargo ve lojistik firması ve 51 muhasebe, e-Fatura ve ERP programı tanımlıdır; tam liste entegrasyon ana sayfasında.

Yıllık ödemede %20 indirim uygulanır; bütün limitler paket karşılaştırmasında yer alır. Panel ücretinin yanında Nilvera tarafındaki kalemleri de hesaba katın:

• Kontör: Nilvera'da belge gönderimi kontörle yürür; Genel API toplam, kullanılan ve kalan kontörü ile paketin bitiş tarihini gösterir. Kontör yetmezse gönderim 2000, paket süresi dolduysa 2075 koduyla reddedilir.
• Mali mühür ya da e-imza: e-Fatura başvurusunda tüzel kişiler mali mühür, gerçek kişiler e-imza ya da mali mühür kullanır.
• Nilvera hizmet bedeli: Güncel fiyatı ve kontör paketlerini Nilvera'dan öğrenin; bu sayfada program fiyatı vermiyoruz.

Siparişleri bir ön muhasebe programına da aktarmak istiyorsanız Kurumsal paketteki üç program hakkıyla Nilvera'nın yanına örneğin Paraşüt entegrasyonu eklenebilir. Bu durumda bir siparişin faturası yalnız tek yerden kesilir kuralını baştan koyun; aksi halde aynı satışa iki belge düşebilir.

Kurulum kontrol listesi ve Nilvera hata kodlarıyla sık yapılan hatalar

Nilvera kurulumunu geciktiren şey nadiren bağlantının kendisidir; çoğu zaman Nilvera hesabındaki bir eksik, ilk test faturasında hata kodu olarak döner. Aşağıdaki liste ve tablo, kuruluma başlamadan önce bakılacakları toplar.

Kuruluma başlamadan önce kontrol edin

• Nilvera'da e-Fatura ve e-Arşiv kullanıcılığınız aktif mi, mali mühür ya da e-imzanız tanımlı mı?
• Kontör bakiyeniz ve paketinizin bitiş tarihi kampanya dönemine yetiyor mu?
• Panelde kullanılacak e-Fatura ve e-Arşiv serileri açık ve aktif mi, şablonunuz (logo, banka, iletişim) hazır mı?
• API anahtarı canlı ortamda, gereken yetkilerle üretildi mi; süreliyse bitiş tarihi not edildi mi?
• Ürünlerin KDV oranları doğru mu? Dahil ve hariç tutarı KDV hesaplama aracıyla karşılaştırabilirsiniz.
• Kurumsal alıcıların vergi numarası siparişte eksiksiz geliyor mu?

Sık görülen Nilvera hata kodları ve çözümleri

Kurulumu birlikte yapmak isterseniz ön görüşmede Nilvera hesabınızı ve fatura kuralınızı beraber gözden geçiririz. Paneli 3 gün ücretsiz denemek için Yox İş Ortağım'a başvurun; sorularınız için iletişim sayfasından yazın.