Türkiye Lokalizasyonu

Türkiye Lokalizasyonu, SODOO

Genel Bakış

Türkiye Lokalizasyonu, SODOO'yu Türk mevzuatına ve GİB (Gelir İdaresi Başkanlığı) e-belge gereksinimlerine uyumlu hale getiren kapsamlı bir modül paketidir. e-Fatura, e-Arşiv, KDV tevkifatı ve Tek Düzen Hesap Planı desteği sağlar.

10
Modül
UBL-TR
1.2 Standart
81
İl Vergi Dairesi
7.8K+
Satır Kod
2026 Zorunluluğu: 2026 yılından itibaren tüm faturalar elektronik ortamda düzenlenecek, kağıt fatura tamamen kaldırılacaktır. İşletmenizi şimdiden hazırlayın!
e-Fatura
GİB kayıtlı mükelleflere elektronik fatura gönderimi
e-Arşiv
Tüketicilere ve kayıtsız mükelleflere e-Arşiv fatura
KDV Tevkifat
Kısmi ve tam tevkifat hesaplamaları
Vergi Daireleri
Türkiye geneli vergi dairesi veritabanı
Bankalar
Türk bankaları ve IBAN bilgileri
Hesap Planı
Tek Düzen Hesap Planı (TDHP) desteği

Modül Listesi

Türkiye Lokalizasyonu, 10 entegre modülden oluşur. Her modül belirli bir işlevi yerine getirir.

l10n_tr_base
Temel Lokalizasyon

Tüm Türkiye lokalizasyon modüllerini birleştiren meta modül. Diğer modülleri otomatik yükler.

Meta Modül Otomatik Yükleme
gib_invoice_2kb
e-Fatura & e-Arşiv

GİB e-Fatura ve e-Arşiv fatura oluşturma, gönderme ve durum takibi. Ana uygulama modülü.

UBL-TR 1.2 QR Kod PDF
gib_incoming_invoice_2kb
Gelen Faturalar

Tedarikçilerden gelen e-Faturaların alınması, görüntülenmesi ve kabul/red işlemleri.

ETTN Takip Kabul/Red 15 Gün
izibiz_2kb
IZIBIZ Entegratör

IZIBIZ (Foriba) e-belge entegratörü ile GİB bağlantısı. Web servisleri üzerinden iletişim.

API Web Servis SSL
gib_base_2kb
GİB Altyapı

GİB e-belge altyapısı. Entegratör framework, UBL-TR oluşturucu, kod listeleri ve şablonlar.

UBL Builder XSLT Schematron
l10n_tr_witholding
KDV Tevkifat

KDV stopajı ve tevkifat oranları. Kısmi ve tam tevkifat hesaplamaları için mali pozisyonlar.

Kısmi Tevkifat Tam Tevkifat

Diğer Modüller

Modül Versiyon Açıklama
l10n_tr_bank 19.0.1.0.0 Türk bankaları listesi, EFT ve IBAN bilgileri
l10n_tr_tax_office 19.0.1.0.0 Vergi daireleri dizini (81 il, 6 haneli kodlar)
l10n_tr_2kb 19.0.1.0.0 2KB hesap planı varyantı, mali pozisyonlar
kita_api_services 19.0.1.4.0 Kıta API kimlik bilgileri yönetimi

e-Fatura

e-Fatura, GİB'e kayıtlı mükellefler arasında düzenlenen elektronik faturadır. Fatura GİB üzerinden iletilir ve yasal delil niteliği taşır.

Fatura Senaryoları

Temel Fatura
TEMELFATURA
Alıcının GİB kaydı gerekmez. Ticari kabul/red süreci yoktur. Tek seferlik işlemler için uygundur.
Ticari Fatura
TICARIFATURA
Alıcının PK (Posta Kutusu) kaydı gerekir. 15 gün içinde kabul/red beklenir. B2B işlemleri için.
e-Arşiv Fatura
EARSIVFATURA
GİB iletimi olmadan elektronik arşivleme. Düşük maliyetli alternatif. Tüketiciler için.

e-Fatura Gönderim Süreci

Fatura Oluşturma ve Gönderim Akışı
Fatura Oluştur
Onayla
UBL Oluştur
GİB'e Gönder

Fatura Numaralama Formatı

ABC2024000000001 │││ ││││ │││││││ │││ │││└─────────→ 9 haneli sıra numarası │││ └────────────→ Yıl (2024) └────────────────→ 3 harfli önek (şirket kodu)
Format Kuralı: Fatura numarası ^[A-Z0-9]{3}20[0-9]{2}[0-9]{9}$ regex formatına uymalıdır. Önek sadece büyük harf ve rakam içerebilir.

e-Arşiv

e-Arşiv, GİB'e kayıtlı olmayan mükelleflere ve tüketicilere düzenlenen elektronik fatura türüdür. GİB üzerinden iletilmez, ancak dijital imza ile imzalanır ve arşivlenir.

Özellik e-Fatura e-Arşiv
GİB İletimi Evet Hayır
PK Gereksinimi Sadece TICARI Gerekmez
Ticari İş Akışı Kabul/Red Yok
Dijital İmza Zorunlu Zorunlu
Maliyet Yüksek Düşük
Kullanım Alanı B2B (kayıtlı) B2C + B2B (kayıtsız)
2025 Eşik Değeri: e-Arşiv fatura tutarı 3.000 TL (KDV dahil) ve üzeri olan satışlarda e-Arşiv fatura düzenleme zorunluluğu bulunmaktadır.

KDV Tevkifat

KDV tevkifatı, belirli mal ve hizmet alımlarında alıcının satıcıya ödemesi gereken KDV'nin bir kısmını kesip doğrudan vergi dairesine ödemesidir.

Kısmi Tevkifat Oranları (2025-2026)

Hizmet/Mal Türü Tevkifat Oranı Satıcıya Ödenen
Temizlik, güvenlik ve benzeri hizmetler 9/10 1/10
Bakır, çinko, alüminyum, kurşun teslimleri 7/10 3/10
Demir-çelik ve alaşımlı ürünler 5/10 5/10
Yemek ve servis hizmetleri 5/10 5/10
Yapım işleri (inşaat) 4/10 6/10
Ticari reklam hizmetleri 3/10 7/10
Nakliye (yük taşıma) 2/10 8/10

Tevkifat Eşik Değerleri

2025 Yılı
9.900 TL (KDV dahil) ve üzeri işlemler
2026 Yılı
12.000 TL (KDV dahil) ve üzeri işlemler
Mali Pozisyon: Tevkifat oranları Odoo'da "Mali Pozisyon" (Fiscal Position) kullanılarak yapılandırılır. Her tevkifat türü için ayrı mali pozisyon tanımlanmalıdır.

GİB Entegrasyonu

Gelir İdaresi Başkanlığı (GİB) ile entegrasyon, özel entegratörler aracılığıyla gerçekleştirilir. SODOO, IZIBIZ entegratörünü kullanır.

Entegrasyon Seçenekleri

Yöntem Açıklama Uygunluk
GİB Portalı Ücretsiz, manuel yükleme/indirme Düşük fatura hacmi
Özel Entegratör API ile otomatik işlem, 10 yıl arşivleme Orta-yüksek hacim
Doğrudan Entegrasyon GİB onaylı altyapı gerektirir Büyük kurumsal

IZIBIZ Entegratörü

IZIBIZ (Foriba), Türkiye'nin önde gelen e-belge entegratörlerinden biridir. SODOO, IZIBIZ web servisleri üzerinden GİB ile iletişim kurar.

Fatura Gönderimi
SendInvoice API ile GİB'e iletim
Durum Sorgulama
GetInvoiceStatus ile anlık takip
Gelen Faturalar
GetInvoice ile tedarikçi faturaları

PK (Posta Kutusu) ve GB Alias

PK (Posta Kutusu)
Fatura alıcısı rolü. TICARIFATURA için alıcının PK kaydı gerekir.
GB (Gönderici Birim)
Fatura göndericisi rolü. Şirketinizin fatura gönderme adresi.

Yapılandırma

Şirket GİB Ayarları

1
Entegratör Seç
IZIBIZ
2
API Bilgileri
Kıta API Key
3
Logo Yükle
Fatura logosu
4
Ortam Seç
Test/Üretim
5
Test Et
Bağlantı kontrolü

Gerekli Ayarlar

Ayar Konum Açıklama
Entegratör Ayarlar → Şirket → GİB IZIBIZ seçilmeli
API Anahtarı Ayarlar → Şirket → Kıta API Kıta'dan alınan API key ve secret
Üretim Ortamı GİB Entegratör ayarları Test veya üretim ortamı seçimi
Fatura Logosu GİB Entegratör ayarları Faturada görünecek şirket logosu
Vergi Dairesi Ayarlar → Şirket Şirketin bağlı olduğu vergi dairesi
VKN/TCKN Karşı taraf kartı Müşteri/tedarikçi vergi numarası

Fatura Sırası Yapılandırması

Her fatura senaryosu için ayrı numara serisi oluşturulur:

TEMELFATURA Serisi
TEM2024000000001, TEM2024000000002, ...
TICARIFATURA Serisi
TIC2024000000001, TIC2024000000002, ...
EARSIVFATURA Serisi
EAR2024000000001, EAR2024000000002, ...
İade Fatura Serisi
IAD2024000000001, IAD2024000000002, ...
Otomatik Seçim: Sistem, müşterinin GİB kayıt durumuna göre otomatik olarak uygun fatura senaryosunu (TEMEL, TICARI veya EARSIV) seçer.

Destek ve Kaynaklar

GİB Portal
ebelge.gib.gov.tr
IZIBIZ Geliştirici
dev.izibiz.com.tr
GitHub
github.com/Odoo-Turkey-Community
2KB
2kb.com.tr