TR e-Fatura — EDM Bilişim Bağlayıcısı

UBL-TR 1.2 fatura üretimi + kendi EDM Bilişim hesabınızla (BYOK) e-Fatura / e-Arşiv gönderimi

Bu Modül Ne Yapar?

Odoo faturalarınızdan (account.move) GİB e-Fatura Uygulama Kılavuzu'na uygun UBL-TR 1.2 XML'i üretir ve sizin kendi sözleşmeli olduğunuz EDM Bilişim entegratör hesabınız (Bring-Your-Own-Key / BYOK) üzerinden mükellefiyet kontrolü, gönderim, durum sorgulama, iptal ve PDF alma işlemlerini otomatikleştirir. Standalone çalışır; başka bir Türkiye modülüne bağımlı değildir.

Özellikler

• UBL-TR 1.2 XML üretimi — ETTN/UUID, ProfileID (TEMELFATURA / TICARIFATURA / EARSIVFATURA), InvoiceTypeCode, AccountingSupplierParty/CustomerParty (VKN/TCKN), InvoiceLine, TaxTotal (KDV, opsiyonel tevkifat), LegalMonetaryTotal — doğru cbc/cac ad alanlarıyla.
• Otomatik mükellefiyet sorgusu — alıcının VKN/TCKN'si GİB e-Fatura sisteminde kayıtlı mı EDM Bilişim üzerinden sorgulanır; kayıtlıysa e-Fatura, değilse otomatik olarak e-Arşiv Fatura profiline düşülür.
• EDM Bilişim adaptörü — gerçek HTTP (requests) + XML (xml.etree) istemcisi: authenticate / send / query_status / cancel / get_pdf uçları.
• Kuyruk + Cron mimarisi — gönderim/iptal/durum-sorgu işlemleri tr.efatura.queue kuyruğuna düşer; cron her 5 dakikada bir tekrar-deneme (retry, max_attempts) ile işler — entegratör anlık kesintisinde fatura kaybolmaz.
• account.move entegrasyonu — fatura üzerinde e-Fatura durum çubuğu (taslak / kuyrukta / gönderildi / kabul edildi / reddedildi / iptal edildi), tek tık "e-Fatura Gönder" butonu, ETTN ve GİB/entegratör durumu alanları.
• Onayda otomatik gönderim (opsiyonel) — satış faturası onaylandığında (action_post) otomatik olarak e-Fatura kuyruğuna alınabilir.
• Tek tıkla Bağlantı Testi — Ayarlar ekranında EDM Bilişim kimlik bilgilerinizi anında doğrulayın.

Önemli — Dürüst Sınırlar (Biz Bir GİB Entegratörü DEĞİLİZ)

• Biz entegratör değiliz. Bu modül GİB'e doğrudan bağlanmaz. Faturayı UBL-TR olarak üretir ve sizin kendi sözleşmeli olduğunuz EDM Bilişim hesabınıza (kendi kullanıcı adı/parola/API anahtarınız — BYOK) gönderir. GİB'e fiili iletim, mali mühür/imza ve saklama yükümlülüğü EDM Bilişim'in sorumluluğundadır.
• İmza / Mali Mühür modül içinde YOKTUR; XAdES/mali mühür işlemi EDM Bilişim'in altyapısında gerçekleşir.
• Varsayılan uç nokta URL'leri placeholder'dır ve "canlı sözleşmenizle teyit edin" ibaresiyle işaretlenmiştir; gerçek üretim URL'lerini kendi EDM Bilişim sözleşmenizden alıp Ayarlar'a girmeniz gerekir.
• Resmi UBL-TR XSD şema doğrulaması bu sürümde paketlenmemiştir.
• Kapsam dışı: e-İrsaliye, e-Müstahsil vb. diğer e-belgeler; yalnızca e-Fatura / e-Arşiv Fatura işlenir.

EN (short): We are NOT a GİB integrator. This module generates UBL-TR XML and submits it through YOUR OWN EDM Bilişim integrator contract (BYOK — Bring Your Own Key). Digital signature (XAdES / mali mühür) and actual delivery to GİB remain EDM Bilişim's responsibility.

Nasıl Çalışır?

1. Ayarlar > e-Fatura ekranından kendi EDM Bilişim kullanıcı adı/parola veya API anahtarınızı, VKN ve GB alias bilginizi girin; "Bağlantıyı Test Et" ile doğrulayın.
2. Satış faturasını her zamanki gibi onaylayın (action_post).
3. Faturada "e-Fatura Gönder" butonuna basın (veya "Onayda Otomatik Gönder" ayarını açın).
4. Modül alıcının VKN/TCKN'sini EDM Bilişim üzerinden mükellefiyet sorgusuna tabi tutar ve doğru UBL profilini (TICARIFATURA / EARSIVFATURA) seçer.
5. UBL-TR XML'i üretilir ve gönderim işlemi tr.efatura.queue kuyruğuna eklenir; cron birkaç dakika içinde asenkron olarak işler (rate-limit ve tekrar-deneme güvenliği için).
6. Fatura üzerinde ETTN, GİB/entegratör durumu ve son yanıt anlık olarak görünür; durum sorgulama ve iptal de tek tıkla yapılabilir.

Ekran Görüntüleri

Gereksinimler

• Odoo 17.0 / 18.0 / 19.0 — account ve mail modülleri kurulu (satış modülü şart değildir).
• Kendi sözleşmeli olduğunuz bir EDM Bilişim 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ığı — ekstra kurulum gerekmez).

Destek

Sorularınız, kurulum yardımı veya özel entegrasyon talepleriniz için:
E-posta: support@pokutsoft.com
Web: pokutsoft.com