KDV Tevkifatı — Turkish VAT withholding

Retour index
Documentation développeur

Retour index
Documentation Utilisateur

KDV Tevkifatı — Turkish VAT withholding for Dolibarr

Apply Turkish VAT withholding (KDV tevkifatı) on supplier and customer invoices, with correct totals and accounting entries

   GİB codes 601–627 Supplier & customer invoices Account mapping Validation guard MCP tools Free · GPLv3

Overview

KDV Tevkifatı is a free external module for Dolibarr ERP/CRM that handles Turkish VAT withholding on supplier and customer invoices.

The withholding is represented as one negative invoice line (VAT 0%, amount = −(total VAT × rate)), for example KDV Tevkifatı 3/10 (GİB 625). The invoice total therefore shows the amount actually payable, and payments, reconciliation and journal entries keep working with standard Dolibarr — no hook or patch in the core.

Publisher and support

Item	Information
Publisher	M. Burak Şentürk
Website	https://buraksenturk.net
Support	https://github.com/mbrksntrk/dolibarr-tevkifat/issues
Source code	https://github.com/mbrksntrk/dolibarr-tevkifat

Module information

Information	Detail
Module name	KDV Tevkifatı (trtevkifat)
Module number	194092
Main use	Turkish VAT withholding on invoices
Type	External Dolibarr module
Family	Financial
Documented version	2.1.1
Dolibarr compatibility	Dolibarr 20.0 or higher (developed and tested on 24.0)
PHP compatibility	PHP 8.1 or higher
Required modules	Invoices, Suppliers
Dolibarr core modification	No
License	GNU GPL v3 or later (with an author attribution term)
Price	Free
Available languages	Turkish, English

Official links

• DoliStore: KDV Tevkifatı (Türkiye)
• Source code and releases: GitHub
• Detailed documentation (Turkish): GitHub wiki

Main features

• GİB code list 601–627 with the official rate proposed automatically (rate can be overridden if allowed in setup).
• Supplier and customer invoices, each can be enabled separately.
• Rate → accounting account mapping (default Turkish chart: 360.50.00x for purchases, 391.10.020 for sales); the setup page checks that every account exists in the active chart of accounts.
• Recalculate / remove: the tab warns when invoice lines changed after applying.
• Validation guard: invoice validation can be blocked when the withholding is inconsistent.
• Data kept in invoice extra fields (code, rate, amount, line) — filterable and exportable.
• Each apply/remove is written to the invoice Events tab; setting changes to the security audit log.
• Works with the İşNet e-Fatura module: the withholding is exported in the UBL WithholdingTaxes block.
• MCP tools for the Dolibarr 24 AI module: tevkifat_codes, tevkifat_info, tevkifat_apply, tevkifat_remove.

Typical flow

1. Open a draft invoice → Withholding tab.
2. Choose the GİB code; the rate is filled in.
3. Click Apply withholding: the line is added and the payable amount is shown.
4. Validate the invoice as usual.

Configuration

From Home → Setup → Modules → VAT Withholding (Türkiye): enable per invoice type, allow custom rate, purchase account per rate, fallback purchase account, sales withholding account, line label template (%RATE%, %CODE%), line position, validation guard. Adjust the account codes to your own chart of accounts.

User permissions

• Read withholding information
• Apply / remove withholding (invoice create permission is also required)

Installation

1. Download module_trtevkifat-x.y.z.zip from DoliStore or GitHub Releases.
2. Home → Setup → Modules → Deploy/install external app/module, or unzip into htdocs/custom/.
3. Enable VAT Withholding (Türkiye); extra fields and the trigger are installed automatically.
4. Check the account mapping on the setup page.

Summary

KDV Tevkifatı adds Turkish VAT withholding to Dolibarr invoices as a single, clearly marked line, so totals, payments and accounting stay correct with the standard Dolibarr flow and no core change.