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.queuekuyruğ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?
- 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.
- Satış faturasını her zamanki gibi onaylayın (
action_post). - Faturada "e-Fatura Gönder" butonuna basın (veya "Onayda Otomatik Gönder" ayarını açın).
- 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.
- UBL-TR XML'i üretilir ve gönderim işlemi
tr.efatura.queuekuyruğuna eklenir; cron birkaç dakika içinde asenkron olarak işler (rate-limit ve tekrar-deneme güvenliği için). - 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 —
accountvemailmodü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).
requestsPython 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
Update date: 2026-07-07
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
•
Discuss (mail)
• Invoicing (account) |
| Lines of code | 977 |
| Technical Name |
tr_efatura_edm |
| License | OPL-1 |
| Website | https://pokutsoft.com |
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module