KDV Tevkifatı — Turkish VAT withholding for Dolibarr invoices

Community module · Free · GPL-3.0-or-later · No core modification

 Key Functions

•   
• "Withholding" tab on supplier and customer invoices
• Pick the GİB code (601–627); the published rate is filled automatically and can be overridden when allowed by setup
• Calculation table: taxable base, VAT by rate, VAT withheld, payable amount
• Apply / recalculate / remove with one click on draft invoices
• Withholding booked as a single marked negative line (VAT 0%) mapped by rate to the configured accounting account (e.g. 360.50.xxx on purchases, 391.10.xxx on sales)
• Invoice totals, payments, purchase/sales journals and PDFs are right out of the box

• ---

    

• Alış ve satış faturalarında "Tevkifat" sekmesi
• GİB kodunu seçin (601–627); tebliğ oranı otomatik gelir, ayar izin veriyorsa değiştirilebilir
• Hesaplama tablosu: matrah, KDV kırılımı, tevkif edilen KDV, ödenecek tutar
• Taslak faturada tek tıkla uygula / yeniden hesapla / kaldır
• Tevkifat, orana göre eşlenen muhasebe hesabına giden tek bir işaretli negatif satır (KDV %0) olarak işlenir (ör. alışta 360.50.xxx, satışta 391.10.xxx)
• Fatura toplamı, ödeme, alış/satış yevmiyeleri ve PDF kendiliğinden doğru

 Main Features

•   
• Validation guard: an invoice cannot be validated when a code is set without a withholding line or when the lines changed after the calculation
• Rate → account mapping, default account, line label template, line position and override permission — all in setup; the setup page checks that every account exists in the active chart
• Credit notes supported (negative VAT)
• Audit: every apply/remove on the invoice's Events tab, setup changes in the security audit log
• Works with the İşNet e-Fatura module: withholding goes into the UBL as WitholdingTaxes, TotalPayableAmount is correct
• 4 MCP tools for the Dolibarr 24 AI module: codes, info, apply, remove

• ---

    

• Onay koruması: kod seçili ama tevkifat satırı yoksa ya da hesaplamadan sonra satırlar değiştiyse fatura onaylanamaz
• Oran → hesap eşlemesi, varsayılan hesap, satır açıklaması şablonu, satır yeri ve oran ezme izni ayarlarda; ayar sayfası her hesabın aktif hesap planında olduğunu denetler
• Alacak dekontu desteği (negatif KDV)
• Denetim: her uygulama/kaldırma faturanın Olaylar sekmesinde, ayar değişiklikleri güvenlik denetim günlüğünde
• İşNet e-Fatura modülü ile birlikte: tevkifat UBL'ye WitholdingTaxes olarak gider, TotalPayableAmount doğru
• Dolibarr 24 AI modülü için 4 MCP aracı: kodlar, bilgi, uygula, kaldır

How it works

1. Install and enable the module (extra fields and the validation trigger are created automatically)
2. Check the rate → account mapping in the setup page against your chart of accounts
3. Open a draft invoice → Withholding tab → choose the code → Apply withholding → validate

1. Modülü kurun ve aktif edin (ek alanlar ve onay tetikleyicisi otomatik oluşur)
2. Ayar sayfasında oran → hesap eşlemesini hesap planınıza göre kontrol edin
3. Taslak fatura → Tevkifat sekmesi → kodu seçin → Tevkifat uygula → onaylayın

Documentation / Dokümantasyon

• Wiki (Turkish): installation, how it works, settings, accounting examples, code list, MCP tools
• Source code, releases and issues on GitHub

License / Lisans

GPL-3.0-or-later with an attribution-preservation term under GPLv3 §7(b): the author attribution must be kept in derived works. Free for personal and commercial use.
GPL-3.0-or-later; GPLv3 7(b) kapsamında yazar atfının korunması şartıyla. Kişisel ve ticari kullanım ücretsizdir.

Author / Yazar: M. Burak Şentürk — buraksenturk.net — github.com/mbrksntrk