Blog'a Dön
ERPNext3 min read20 Ocak 2025

ERPNext Türkiye Lokalizasyonu: E-Fatura, TCMB Kuru ve SGK Entegrasyonu

ERPNext'i Türkiye yasal mevzuatına uyumlu hale getiren lokalizasyon modülleri. E-belge, TCMB döviz kuru, SGK ve muhasebe uyarlamaları.

ERPNextTürkiye lokalizasyone-fatura ERPNextTCMBSGK

ERPNext Türkiye'de Neden Lokalizasyon Gerektirir?

ERPNext küresel bir açık kaynak ERP platformudur. Türkiye'de yasal uyumluluk için ek yapılandırmalar ve modüller gereklidir. Viva Yazılım olarak 2018'den bu yana ERPNext Türkiye lokalizasyonu geliştirip uyguluyoruz.

Bu yazıda hangi modüllerin neden gerektiğini ve nasıl çalıştığını aktarıyoruz.

1. E-Belge Entegrasyonu (GİB)

E-Fatura

ERPNext satış fatura modülüne eklenen GİB e-fatura köprüsü sayesinde:

  • Her satış faturası otomatik UBL (XML) formatına dönüştürülür
  • GİB Özel Entegratör API'sine (Viva Yazılım) gönderilir
  • Onay kodu, UUID ve imza faturaya eklenir
  • Yasal arşive otomatik kaydedilir

E-Arşiv

E-fatura sistemine dahil olmayan alıcılara kesilen faturalar e-arşiv formatında oluşturulur ve GİB'e raporlanır.

E-İrsaliye

Mal sevkiyatlarında e-irsaliye otomasyonu; depo çıkış belgesi oluşturulduğunda tetiklenir.

2. TCMB Döviz Kuru Entegrasyonu

Dövizli işlemlerde güncel kurun kullanılması yasal zorunluluktur. ERPNext Türkiye modülümüz:

  • Her gün 09:00'da TCMB'den USD, EUR, GBP ve diğer kurları çeker
  • Satış/alım faturalarına otomatik uygular
  • Kur farkı muhasebe kayıtlarını oluşturur
# TCMB kur çekme zamanlayıcısı (her sabah çalışır)
@frappe.whitelist()
def fetch_tcmb_rates():
    rates = get_tcmb_rates()
    for currency, rate in rates.items():
        frappe.db.set_value("Currency Exchange", ..., "exchange_rate", rate)

3. Türk Muhasebe Planı (THP)

ERPNext varsayılan hesap planı Türk Muhasebe Planı'na dönüştürülür:

| Hesap Kodu | Açıklama | |---|---| | 100 | Kasa | | 102 | Bankalar | | 120 | Alıcılar | | 320 | Satıcılar | | 391 | Hesaplanan KDV | | 190 | Devreden KDV | | 600 | Yurt İçi Satışlar |

4. KDV Beyannamesi Uyumu

  • %0, %1, %8, %10, %20 KDV oranları tanımlıdır
  • İndirimli oran uygulamaları (gıda, ilaç, eğitim)
  • Tevkifatlı KDV hesaplamaları
  • KDV iade taleplerini destekleyen raporlar

5. SGK & Bordro Entegrasyonu

HRMS modülü üzerinden:

  • SGK bildirgesi (aylık prim hizmet belgesi) formatında çıktı
  • Asgari ücret, asgari geçim indirimi otomatik güncelleme
  • Gelir vergisi dilim hesaplama

6. Muhtasar ve Diğer Beyannameler

  • Aylık/üç aylık muhtasar beyanname için özel raporlar
  • Geçici vergi dönemleri için BS/BA form desteği
  • Damga vergisi takibi

ERPNext Lokalizasyonu ile Rakiplerin Karşılaştırması

| Özellik | ERPNext (Viva) | Logo Tiger | Mikro | |---|---|---|---| | E-Fatura | Evet | Evet | Evet | | Açık kaynak | Evet | Hayır | Hayır | | Özelleştirilebilirlik | Yüksek | Orta | Düşük | | Lisans maliyeti | Yok | Yüksek | Orta | | Bulut seçeneği | Evet | Kısıtlı | Hayır | | API erişimi | Tam | Kısıtlı | Kısıtlı |

Sonuç

ERPNext Türkiye lokalizasyonu doğru yapılandırıldığında yerli ERP yazılımlarıyla tam rekabet edebilir. Viva Yazılım olarak bu lokalizasyonu 2018'den beri geliştirip sürdürüyoruz.

Bu konuda uzman desteği alın

Viva Yazılım ekibi 30 yıllık deneyimiyle yanınızda.

Bizi AraDemo Al