Neden Odoo’nun Standart Kurulumu Türkiye için Yeterli Değil?
Türkiye’deki GİB altyapısı — UBL-TR standardı, özel entegratör veya doğrudan portal entegrasyonu gereksinimleri, mali mühür imzalama — standart Odoo kurulumunda bulunmaz. Bu boşluğu kapatmak için AlAfaq Alamiah, Odoo için efatura modülünü geliştirdi.
efatura Modülü Nedir?
efatura, AlAfaq Alamiah tarafından Odoo için sıfırdan geliştirilen bir GİB uyumluluk modülüdür. Odoo’nun Muhasebe modülüyle tam entegre çalışır ve şunları sağlar:
- e-Fatura üretimi ve iletimi — GİB UBL-TR standardına uygun XML
- e-Arşiv Fatura — bireysel alıcılar ve e-Fatura mükellefi olmayan işletmeler için QR kodlu PDF
- Mali mühür imzalama — faturaların otomatik olarak elektronik imzalanması
- Özel entegratör desteği — GİB lisanslı entegratörler üzerinden gönderim
- Yanıt takibi — kabul, ret ve iptal durumlarının Odoo içinde görüntülenmesi
- e-İrsaliye desteği (opsiyonel)
Modül Odoo 16 ve 17 sürümlerini destekler; Community ve Enterprise ile çalışır.
Kurulum Öncesi Gerekenler
efatura modülünü kurmadan önce şunların hazır olması gerekir:
- Odoo 16 veya 17 kurulumu (Community veya Enterprise)
- GİB’e kayıtlı vergi kimlik numarası (VKN)
- Geçerli bir mali mühür sertifikası (
.p12formatında) veya e-imza - Kullanacağınız özel entegratör bilgileri (GİB lisanslı entegratör API bilgileri)
1. Adım: efatura Modülünü Kurun
efatura modülü standart Odoo uygulama mağazasında bulunmaz — doğrudan AlAfaq Alamiah’tan temin edilir. Modülü aldıktan sonra:
- Modül dosyalarını Odoo sunucusunun
addonsdizinine yükleyin - Odoo’yu yeniden başlatın
- Uygulamalar → Güncellemeleri Kontrol Et adımını çalıştırın
- Uygulama listesinde efatura modülünü bulup yükleyin
Kurulum tamamlandığında Muhasebe modülünün ayarlar menüsünde e-Fatura bölümü görünür hale gelir.
2. Adım: Şirket Bilgilerini Doğrulayın
Ayarlar → Şirketler bölümünden şirket bilgilerinizin GİB kaydıyla birebir eşleştiğinden emin olun:
- Ticaret unvanı — GİB sistemindeki tam kayıtlı unvan
- Vergi kimlik numarası (VKN) — 10 haneli
- Adres: İl, ilçe, mahalle, cadde/sokak, posta kodu
- Mersis numarası (varsa)
Herhangi bir tutarsızlık GİB tarafından fatura reddine yol açar.
3. Adım: Entegratör ve Sertifika Ayarlarını Yapın
Muhasebe → Ayarlar → e-Fatura ekranından:
- Entegrasyon yöntemini seçin: özel entegratör veya doğrudan GİB portalı
- Özel entegratör seçildiyse API endpoint ve kimlik bilgilerini girin
- Mali mühür sertifikanızı yükleyin ve şifresini girin
- Bağlantı testini çalıştırarak GİB altyapısına erişimi doğrulayın
4. Adım: Test Ortamında Fatura Gönderin
Canlıya geçmeden önce test senaryolarını tamamlayın:
| Fatura Türü | Test Edilecek Durum |
|---|---|
| e-Fatura (B2B) | Standart satış faturası |
| e-Arşiv (B2C) | Bireysel alıcıya fatura |
| İptal | Kesilen faturanın iptali |
| İade | Müşteriden iade |
Her senaryoda XML formatını, QR kodunu ve GİB’den gelen yanıtı (kabul/ret) doğrulayın.
5. Adım: Canlıya Geçin
Test aşaması tamamlandıktan sonra:
- Ortamı Test’ten Canlı (Production) moduna alın
- İlk gerçek faturayı küçük tutarlı bir işlem için kesin
- GİB yanıtını (kabul onayı) doğrulayın
- Muhasebe ekibinizi yeni iş akışı konusunda eğitin
Sık Karşılaşılan Sorunlar
| Sorun | Muhtemel Neden | Çözüm |
|---|---|---|
| Fatura reddedildi | Şirket bilgisi uyuşmazlığı | GİB mükellef kaydıyla karşılaştırın |
| Bağlantı hatası | Güvenlik duvarı kısıtlaması | Entegratör API adresine çıkan trafiğe izin verin |
| İmzalama hatası | Sertifika süresi dolmuş | Mali mühür sertifikasını yenileyin |
| XML format hatası | Zorunlu alan eksik | Şirket ve müşteri verilerini kontrol edin |
efatura Modülünü Nasıl Edinirsiniz?
efatura modülü AlAfaq Alamiah tarafından sunulmaktadır. Modülü edinmek ve kurulumu profesyonel destek eşliğinde tamamlamak için bizimle iletişime geçin. Tipik kurulum süreci şunları kapsar:
- Modül kurulumu ve yapılandırması
- Sertifika ve entegratör ayarları
- Uçtan uca test (tüm fatura türleri)
- Canlıya geçiş ve muhasebe ekibi eğitimi