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?
- 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.
- Satış faturasını onaylayın (post) ve "e-Fatura Gönder" butonuna basın (veya otomatik gönderimi açın).
- Modül alıcının mükellefiyet durumunu sorgular, doğru UBL profilini seçer ve XML'i üretir.
- Gönderim arka plan kuyruğuna (cron) düşer; Nesbilgi'ye iletilir, ETTN ve durum faturaya yazılır.
- Fatura üzerinden istediğiniz zaman durum sorgulayabilir veya iptal talebi gönderebilirsiniz.
Ekran Görüntüleri
Gereksinimler
- Odoo 17.0 / 18.0 / 19.0 —
accountvemailmodü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).
requestsPython kütüphanesi (Odoo'nun standart bağımlılığı).
Destek
Sorularınız, kurulum yardımı veya özel istekleriniz için: support@pokutsoft.com — https://pokutsoft.com
Update date: 2026-07-07