Skip to Content

TR e-Fatura Nesbilgi

208.95 208.95

Instant digital delivery after payment confirmation.
License: OPL-1, every download is watermarked.
Terms and Conditions

TR e-Fatura — Nesbilgi Bağlayıcısı (BYOK)

Odoo faturalarınızdan GİB uyumlu UBL-TR 1.2 üretin, kendi Nesbilgi hesabınızla
e-Fatura / e-Arşiv Fatura gönderin — kurulumdan dakikalar sonra.

Bu modül ne yapar?

TR e-Fatura Nesbilgi, herhangi bir Odoo satış faturasından (account.move) GİB e-Fatura Uygulama Kılavuzu'na uygun UBL-TR 1.2 XML'i üretir ve bu belgeyi, şirketinizin kendi sözleşmeli olduğu Nesbilgi entegratör hesabı üzerinden GİB'e iletilmek üzere gönderir. Alıcının e-Fatura mükellefi olup olmadığı otomatik sorgulanır; sonuca göre e-Fatura (TICARIFATURA) veya e-Arşiv Fatura (EARSIVFATURA) profili otomatik seçilir.

Özellikler

  • UBL-TR 1.2 XML üretimi: ETTN/UUID, ProfileID, InvoiceTypeCode, Satıcı/Alıcı (VKN/TCKN), fatura satırları, KDV toplamları (opsiyonel tevkifat dahil), genel toplamlar.
  • Otomatik mükellefiyet sorgusu: Alıcının VKN/TCKN'si GİB e-Fatura sisteminde kayıtlı mı diye Nesbilgi üzerinden sorgulanır; kayıtlı değilse otomatik e-Arşiv'e düşer.
  • Nesbilgi SOAP istemcisi: kimlik doğrulama, gönderim, durum sorgulama, iptal ve PDF alma uçları; 429/503 durumunda sınırlı ve akıllı tekrar deneme (throttling).
  • Güvenilir kuyruk + cron: gönderim/iptal/durum işlemleri arka planda, yeniden deneme (retry) mantığıyla, kullanıcıyı bekletmeden işlenir.
  • Fatura üzerinde durum takibi: "e-Fatura Gönder" butonu, durum çubuğu (taslak/kuyrukta/gönderildi/kabul edildi/reddedildi/iptal), ETTN ve entegratör yanıtı alanları.
  • Onayda otomatik gönderim (opsiyonel): fatura onaylandığında (post) otomatik olarak kuyruğa alınabilir.
  • Tek tıkla bağlantı testi: Ayarlar ekranından Nesbilgi kimlik bilgilerinizi anında doğrulayın.

Önemli — Dürüst Sınırlar / Important — Honest Limits

Biz bir GİB entegratörü DEĞİLİZ. Bu modül GİB'e doğrudan bağlanmaz; faturayı UBL-TR olarak üretir ve sizin kendi kullanıcı adı / parola / API anahtarınızla (BYOK) sözleşmeli olduğunuz Nesbilgi hesabınıza gönderir. GİB'e fiili iletim, mali mühür/imza (XAdES) ve yasal saklama yükümlülüğü Nesbilgi'nin sorumluluğundadır. Varsayılan uç nokta (endpoint) adresleri placeholder'dır; canlı kullanım için kendi Nesbilgi sözleşmenizden alacağınız gerçek uç noktayı Ayarlar'a girmeniz gerekir. Resmi UBL-TR XSD şema doğrulaması bu sürümde paketlenmemiştir; e-İrsaliye/e-Müstahsil gibi diğer e-belgeler ve pazaryeri/satış siparişi entegrasyonu kapsam dışıdır.

English: We are NOT a GİB (Turkish Revenue Administration) integrator. This module builds UBL-TR XML and forwards it to your own Nesbilgi integrator account (Bring-Your-Own-Key). Actual transmission to GİB, digital signing (mali mühür/XAdES) and legal retention are Nesbilgi's responsibility. Default endpoints are placeholders — confirm the real production endpoint with your Nesbilgi contract before going live. No XSD schema validation is bundled in this version; e-Waybill, marketplace/sale-order bridging and other e-document types are out of scope.

Nasıl çalışır?

  1. Ayarlar > e-Fatura ekranından Nesbilgi kullanıcı adı/parola (veya API anahtarı), VKN, ünvan ve GB alias bilgilerinizi girin; "Bağlantıyı Test Et" ile doğrulayın.
  2. Satış faturasını onaylayın (post) ve "e-Fatura Gönder" butonuna basın (veya otomatik gönderimi açın).
  3. Modül alıcının mükellefiyet durumunu sorgular, doğru UBL profilini seçer ve XML'i üretir.
  4. Gönderim arka plan kuyruğuna (cron) düşer; Nesbilgi'ye iletilir, ETTN ve durum faturaya yazılır.
  5. Fatura üzerinden istediğiniz zaman durum sorgulayabilir veya iptal talebi gönderebilirsiniz.

Ekran Görüntüleri

e-Fatura ayarları
Nesbilgi BYOK ayarları
Fatura üzerinde e-Fatura durumu
Fatura üzerinde durum ve gönder butonu
Gönderim kuyruğu
Gönderim kuyruğu ve tekrar deneme
Bağlantı testi bildirimi
Tek tıkla bağlantı testi

Gereksinimler

  • Odoo 17.0 / 18.0 / 19.0 — account ve mail modülleri (standart kurulum).
  • Kendi adınıza aktif bir Nesbilgi e-Fatura/e-Arşiv entegratör hesabı (kullanıcı adı/parola veya API anahtarı, VKN, GB alias).
  • requests Python kütüphanesi (Odoo'nun standart bağımlılığı).

Destek

Sorularınız, kurulum yardımı veya özel istekleriniz için: support@pokutsoft.comhttps://pokutsoft.com

Update date: 2026-07-07