Odoo e-Fatura Entegrasyonu Nasıl Çalışır? e-Arşiv, e-İrsaliye ve e-Defter Rehberi (2026)

Odoo'nun standart paketinde GİB e-Fatura yoktur; Türkiye'de e-Fatura, e-Arşiv, e-İrsaliye ve e-Defter, iş ortağının geliştirdiği entegrasyon modülü ile bir özel entegratör üzerinden GİB'e bağlanarak Odoo içinden gönderilir ve alınır.

e-Dönüşüm belgeleri kısaca

GİB'in e-dönüşüm sistemi tek bir belge değil, birbirini tamamlayan bir belge ailesidir. Odoo projelerinde en sık karşılaşılanlar şunlardır:

• e-Fatura: Alıcısı da e-Fatura mükellefi olan firmalara, GİB üzerinden elektronik olarak iletilen fatura. Kağıt karşılığı yoktur; alıcı "temel" senaryoda sadece alır, "ticari" senaryoda kabul veya red yanıtı verir.
• e-Arşiv Fatura: e-Fatura mükellefi olmayan firmalara ve nihai tüketicilere kesilen fatura. GİB'e raporlanır, alıcıya e-posta ya da çıktı olarak ulaştırılır.
• e-İrsaliye: Malın sevkiyatını belgeleyen elektronik irsaliye. Fatura ile karıştırılmamalı; stok hareketine bağlıdır.
• e-Defter: Yevmiye ve büyük defter (kebir) kayıtlarının elektronik ortamda tutulup aylık "berat" ile GİB'e bildirilmesi.
• e-Müstahsil Makbuzu: Tarım ürünü alımlarında, vergiden muaf çiftçiden yapılan alışlar için düzenlenen belge. Tarım ve gıda sektöründeki projelerde gündeme gelir.

GİB'e bağlanma yolları: entegratör mü, portal mı?

Bir firmanın e-belgeleri GİB'e ulaştırmasının üç yolu vardır: GİB Portal (belgelerin GİB'in web arayüzünden tek tek girilmesi), doğrudan entegrasyon (firmanın kendi sistemini GİB'e bağlaması; ağır teknik ve altyapı şartları vardır) ve özel entegratör (GİB'den yetki almış bir kuruluşun altyapısını kullanmak).

Odoo projelerinde fiilen kullanılan yol özel entegratördür. Entegrasyon modülü, Odoo'da onaylanan faturayı entegratörün web servisine iletir; entegratör de GİB ile konuşur. Portal yolu bir ERP ile birlikte anlamsızdır: fatura Odoo'da hazırlanıp bir de portale elle girilmesi hem zaman kaybı hem de hata kaynağıdır. Entegratörün kontör veya belge başına ücreti entegratöre göre değişir; sözleşme aşamasında aylık belge hacminize göre karşılaştırma yapmanız yeterlidir.

Odoo'da e-Fatura akışı adım adım

Kullanıcı açısından süreç "faturayı onayla, gönder butonuna bas" kadar kısadır; arka planda ise modül şu adımları yürütür:

1. Fatura onaylanır. Satış siparişinden veya doğrudan muhasebeden oluşturulan fatura Odoo'da onaylandığında fatura numarası ve muhasebe kaydı oluşur. e-belge süreci ancak onaylı fatura üzerinden başlar.
2. Mükellef sorgusu yapılır. Modül, cari kartındaki vergi numarasını entegratör üzerinden GİB'in mükellef listesinde sorgular. Alıcı e-Fatura mükellefiyse belge e-Fatura, değilse e-Arşiv olarak hazırlanır. Bu karar otomatiktir; kullanıcının belge türünü elle seçmesi gerekmez. Cari kartında hangi posta kutusu (GB etiketi) kullanılacağı da bu aşamada belirlenir.
3. UBL-TR belgesi oluşturulur. Faturadaki satırlar, vergi kodları, iskonto, tevkifat ve istisna bilgileri GİB'in UBL-TR XML şemasına dönüştürülür. Şema doğrulaması burada yapılır; eksik vergi numarası veya hatalı KDV kodu gibi sorunlar gönderimden önce kullanıcıya bildirilir.
4. Entegratöre gönderilir. XML, entegratörün web servisine iletilir; entegratör mali mühür ile imzalayıp GİB'e aktarır.
5. GİB yanıtı ve durum takibi. Modül, belgenin durumunu (gönderildi, GİB'e ulaştı, alıcıya iletildi, kabul edildi, reddedildi) periyodik olarak sorgular ve fatura kaydında gösterir. ETTN (evrensel tekil tanımlama numarası) ve GİB fatura numarası Odoo'daki fatura üzerinde saklanır.
6. Gelen faturalar Odoo'ya düşer. Tedarikçilerinizin gönderdiği e-Faturalar, modülün gelen kutusu sorgusuyla taslak tedarikçi faturası olarak Odoo'ya alınır. Cari eşleşmesi vergi numarasından yapılır; ürün ve masraf hesabı eşleşmesi tanımlı kurallara göre veya kullanıcı onayıyla tamamlanır. Böylece tedarikçi faturalarını elle girme işi ortadan kalkar.

İptal, itiraz ve red senaryoları

e-belgelerde "sil ve yeniden kes" mantığı çalışmaz; GİB'e ulaşmış her belge izlenebilir olmak zorundadır. Odoo'daki modül bu senaryoları şöyle karşılar:

• Ticari e-Fatura reddi: Alıcı, süresi içinde (mevzuattaki yanıt süresi dahilinde) faturayı reddedebilir. Red yanıtı Odoo'ya durum olarak düşer; fatura muhasebede iptal edilir veya düzeltilerek yeniden kesilir.
• Temel e-Fatura'da itiraz: Temel senaryoda sistem üzerinden red yoktur; itiraz harici yollarla (noter, KEP, taahhütlü mektup) yapılır ve muhasebede iade faturası ile kapatılır.
• e-Arşiv iptali: e-Arşiv faturalar, GİB'in iptal/itiraz portalı üzerinden veya entegratör aracılığıyla iptal edilebilir; Odoo'da fatura iptal edildiğinde modül iptal bildirimini entegratöre iletir.
• İade faturası: Malın iadesinde alıcı taraf iade e-Faturası keser; Odoo'da bu, orijinal faturaya bağlı bir iade faturası olarak oluşur ve UBL-TR'de "İADE" tipiyle gönderilir.

Önemli ilke şudur: onaylanmış ve gönderilmiş bir faturayı Odoo'da "taslağa çevirip düzeltmek" GİB tarafında karşılıksız kalır. Bu yüzden iyi bir entegrasyon modülü, gönderilmiş faturanın düzenlenmesini kilitler ve kullanıcıyı doğru iptal/iade yoluna yönlendirir.

e-İrsaliye ve stok transferleri

e-İrsaliye'nin faturadan farkı, muhasebeden değil depodan doğmasıdır. Odoo'da sevkiyat bir stok transferi (teslimat) kaydıdır; transfer onaylandığında modül, araç plakası, şoför bilgisi, taşıyıcı ve sevk adresi gibi irsaliyeye özgü alanları da içeren UBL-TR irsaliye belgesini oluşturur ve entegratör üzerinden GİB'e ve alıcıya iletir.

Alıcı, e-İrsaliye'ye kabul, kısmi kabul veya red şeklinde yanıt verebilir; bu yanıt Odoo'daki transfer kaydına işlenir. Fatura daha sonra bu transferden türetildiğinde irsaliye numarası faturaya referans olarak yazılır. Gelen e-İrsaliyeler de mal kabul kaydı olarak Odoo'ya alınabilir; böylece tedarikçinin sevk ettiği miktar ile depoya giren miktar sistem içinde karşılaştırılır.

e-Defter, muhasebe kayıtları ve berat

e-Defter, diğer belgelerden farklı olarak belge bazlı değil dönem bazlı çalışır. Odoo'daki her onaylı fatura, tahsilat, ödeme ve mahsup fişi bir yevmiye kaydıdır; ay kapandığında bu kayıtlar yevmiye ve kebir defterleri olarak GİB'in XBRL-GL formatında dışa aktarılır. Ardından her defter için bir berat dosyası üretilir; berat mali mühür veya e-imza ile imzalanarak GİB'e yüklenir.

Bu noktada dürüst bir ayrım yapmak gerekir: defter dosyalarının Odoo'dan üretilmesi entegrasyon modülünün işidir; imzalama ve yükleme adımı ise çoğu firmada entegratörün e-Defter saklama hizmeti veya mali müşavir aracılığıyla yürütülür. e-Defter'in doğruluğu tamamen muhasebe disiplinine bağlıdır: yevmiye numaralarının kesintisiz olması, kapanmış aya geriye dönük kayıt atılmaması ve her kaydın belge tarihi ile açıklamasının eksiksiz olması şarttır. Odoo'daki dönem kilitleme özelliği bu disiplini zorunlu kılar.

Türkiye'ye özgü alanlar: KDV, tevkifat, hesap planı

UBL-TR, uluslararası UBL standardının GİB tarafından Türkiye'ye uyarlanmış halidir ve Odoo'nun standart vergi yapısında karşılığı olmayan alanlar içerir. Yerelleştirme modülü bu boşluğu vergi ve ürün kartlarına eklenen alanlarla kapatır:

Vergi kartlarının doğru kodlanması, kurulumun en kritik adımıdır; yanlış kodlanmış tek bir vergi, o vergiyi içeren tüm faturaların GİB tarafından reddedilmesine yol açar.

Tek düzen hesap planı ve kur farkı

Odoo, tek düzen hesap planı (100-999) ile kurulabilir; yerelleştirme modülü bu planı ve varsayılan hesap eşleştirmelerini (satış, alış, KDV, kasa, banka, cari) hazır getirir. Dövizli faturalarda Odoo, faturayı belge tarihindeki kurdan TL'ye çevirerek muhasebeleştirir; tahsilat farklı bir kurdan geldiğinde kur farkı otomatik olarak ayrı bir hesaba (646/656) yazılır. Kur farkı faturasının kesilmesi gereken durumlarda modül, bu faturayı ilgili cariye e-Fatura/e-Arşiv olarak düzenlemeyi destekler. Bu konudaki ayrıntılar için Odoo mu Yerel ERP mi? karşılaştırmamıza da bakabilirsiniz.

Mali müşavirle çalışma

Odoo'ya geçen çoğu firmanın mali müşaviri dışarıdadır ve kendi programını kullanır. Bu iş birliği üç yolla kurulur: mali müşavire Odoo'da salt okunur bir kullanıcı açılır; mizan ve muavin raporları Excel veya PDF olarak dönem sonunda dışa aktarılır; ya da yevmiye kayıtları müşavirin programının okuyabileceği formatta aktarılır. Yerelleştirme modülü mizan, muavin, kasa/banka defteri ve KDV listesi gibi Türk muhasebe raporlarını hazır sunar. Beyanname hazırlığı mali müşavirin sorumluluğunda kalır; Odoo'nun görevi, beyannameye giden rakamların kaynağının tek ve tutarlı olmasıdır.

Kurulum sürecinde neler gerekir?

1. Entegratör sözleşmesi: Firma bir özel entegratör ile sözleşme imzalar; entegratör web servis kullanıcı bilgilerini ve test ortamı erişimini sağlar.
2. Mali mühür veya e-imza: Tüzel kişiler için mali mühür, şahıs firmaları için e-imza gerekir. Başvuru ve teslimat süresi kurulum takviminde en sık gecikmeye neden olan kalemdir; erken başvurulmalıdır.
3. GİB kaydı: e-Fatura, e-Arşiv ve e-İrsaliye başvuruları GİB portalı üzerinden yapılır; entegratör yetkilendirmesi bu adımda tanımlanır.
4. Odoo tarafı hazırlık: Şirket kartı (VKN, vergi dairesi, adres, MERSİS), cari kartlarında vergi numarası ve adres bilgileri, vergi kartlarının GİB kodları, fatura seri tanımları.
5. Test ortamı: Entegratörün test ortamında her belge türü ve her vergi senaryosu (normal, tevkifatlı, istisnalı, iade, dövizli) için deneme gönderimi yapılır; GİB yanıtları doğrulanır.
6. Canlı geçiş: Test kullanıcı bilgileri canlı bilgilerle değiştirilir; ilk canlı faturalar kontrollü olarak gönderilir ve gelen kutusu senkronu açılır. Genel kurulum adımları için Odoo kurulum süreci yazımıza bakabilirsiniz.

Vekosis olarak bu süreci, kendi geliştirdiğimiz Türkiye yerelleştirme ve e-dönüşüm modülümüzle yürütüyoruz; modül birden fazla özel entegratörle çalışır ve canlı müşterilerimizde kullanılmaktadır.

Sık yapılan hatalar

• Cari kartlarında eksik vergi numarası: Mükellef sorgusu yapılamaz, belge türü yanlış seçilir. Geçişten önce cari verisi temizlenmelidir.
• Vergi kartlarının GİB kodsuz kalması: Şema doğrulaması geçse bile GİB reddeder. Her vergi kartı tek tek kontrol edilmelidir.
• Gönderilmiş faturayı taslağa çevirmek: Odoo'da düzeltilen fatura GİB'de eski haliyle kalır; doğru yol iptal/iade zinciridir.
• e-İrsaliye'yi faturadan üretmeye çalışmak: İrsaliye sevkiyatla, yani stok transferiyle bağlanmalıdır; aksi halde miktar ve tarih uyuşmazlıkları çıkar.
• Test ortamını atlamak: İlk canlı faturada hata almak hem müşteri hem de GİB tarafında iz bırakır.
• Gelen kutusunu düzenli işlememek: Odoo'ya düşen taslak tedarikçi faturaları onaylanmadıkça muhasebe ve KDV listesi eksik kalır.
• Dönem kilidini kullanmamak: Beratı verilmiş aya sonradan kayıt atmak e-Defter tutarsızlığına yol açar.

Odoo'nun lisans ve proje maliyeti tarafını merak ediyorsanız Odoo fiyatları 2026 yazımız, sistemin genel yapısı için de Odoo Türkiye sayfamız yardımcı olacaktır.

Sık sorulan sorular

Bu rehber Odoo Türkiye resmi iş ortağı Vekosis Kurumsal tarafından hazırlanmıştır. Odoo hizmetlerimiz için odoo.vekosis.com sayfasını inceleyebilirsiniz.