Odoo ERP for Turkey: E-Fatura, KDV Tax & Turkish Localization

Whether you are a manufacturer in Istanbul's industrial zones, an exporter in Izmir, a tech company in Ankara, or a retailer expanding across Anatolia, this guide covers the complete implementation of Odoo ERP for the Turkish market.

Key Takeaways

• E-Fatura is mandatory for businesses meeting the GIB turnover threshold (currently TRY 3 million gross revenue) — Odoo integrates with GIB-approved intermediary platforms
• E-Arsiv invoicing is required for all sales not covered by E-Fatura (including B2C sales)
• KDV (Katma Deger Vergisi) has three rates: 1%, 10%, and 20% — correct classification is critical
• Turkish payroll involves SGK contributions (employer 20.5-22.5%, employee 15%), income tax (progressive 15-40%), and stamp tax
• TCMB (Central Bank) exchange rates must be used for official foreign currency transactions
• Turkish chart of accounts follows the Uniform Chart of Accounts (Tekduzen Hesap Plani)

---

Turkey's Business Landscape

Market Context

Why Turkey Needs Specialized ERP

Turkey's Revenue Administration (GIB) is one of the most technologically advanced tax authorities globally, mandating electronic invoicing, electronic books (E-Defter), and electronic waybills (E-Irsaliye). This creates a digital compliance ecosystem that generic ERP systems cannot support without deep integration. Combined with the volatile TRY requiring constant exchange rate management and one of the most complex payroll systems in Europe, Turkish businesses need an ERP built for these specific challenges.

---

E-Fatura and E-Arsiv Configuration

E-Fatura (Electronic Invoice)

E-Fatura is Turkey's mandatory B2B electronic invoicing system. All businesses registered in the E-Fatura system must issue and receive invoices electronically in UBL-TR (Universal Business Language — Turkey) format.

Who must register:

• Businesses with gross revenue above TRY 3 million in the previous or current year
• Licensed manufacturers, importers, and exporters of certain goods (tobacco, alcohol, fuels, electronics)
• All registered e-commerce businesses

E-Fatura technical requirements:

E-Arsiv (Electronic Archive Invoice)

E-Arsiv covers all invoices not sent via E-Fatura — primarily B2C invoices and invoices to non-E-Fatura registered businesses:

• Generated in the same UBL-TR format
• Stored electronically for 10 years
• Customer receives a printed/PDF version
• Reported to GIB monthly or real-time (depending on registration type)
• Mandatory for all E-Fatura registered businesses (for their non-E-Fatura invoices)

Odoo E-Fatura/E-Arsiv Integration

Odoo integrates with E-Fatura through GIB-approved intermediary platforms (Ozel Entegratorler):

1. Invoice creation — standard Odoo invoice workflow
2. UBL-TR generation — Odoo generates the invoice in UBL-TR XML format with all GIB-required fields
3. Signing — the XML is signed with the company's NES or Mali Muhur through the intermediary
4. Submission — the signed invoice is transmitted to GIB via the intermediary
5. Response tracking — GIB acceptance, rejection, or commercial response (kabul/red) is tracked in Odoo
6. Inbound invoices — received E-Fatura invoices are imported into Odoo and matched to purchase orders
7. Archival — all invoices stored with their XML and response envelopes

Common GIB-approved intermediaries supported:

• Foriba (FITPAY), Uyumsoft, Logo, Mikro, Turkcell, Vodafone, Sovos, and others

E-Irsaliye (Electronic Waybill)

E-Irsaliye is Turkey's electronic waybill system for goods transportation:

• Mandatory for E-Fatura registered businesses
• Generated before goods leave the warehouse
• Includes sender, receiver, goods description, quantity, transport details
• Transmitted to GIB via the same intermediary infrastructure
• Must be generated within Odoo when delivery orders are validated

E-Defter (Electronic Ledger)

E-Defter is the electronic version of the legally required Turkish commercial books (Yevmiye Defteri — journal, and Buyuk Defter — general ledger):

• Generated in XBRL-GL format
• Signed and timestamped monthly
• Submitted to GIB by the end of the following third month
• Odoo exports the journal entries and general ledger in the E-Defter format

---

KDV (Value Added Tax) Configuration

KDV Rate Structure

Note: Turkey's KDV rates have been subject to frequent changes. The rates were last restructured in July 2023 when the standard rate moved from 18% to 20% and the reduced rate from 8% to 10%.

KDV Withholding (Tevkifat)

Turkey applies KDV withholding on specific transactions where the buyer deducts a portion of KDV and pays it directly to the tax office:

Odoo's Turkish localization includes KDV withholding (tevkifat) codes that automatically calculate the split between the amount paid to the vendor and the amount withheld for direct payment to the tax office.

Odoo KDV Setup

Tax codes:

• KDV 20% — Standard rate output and input
• KDV 10% — Reduced rate
• KDV 1% — Super-reduced rate
• KDV Exempt (Istisna) — Export exemption, investment incentive exemption, and other qualifying exemptions
• KDV Tevkifat — Withholding rates by service category
• KDV Reverse Charge — For imports of services

KDV Return (KDV Beyannamesi)

Turkish businesses file monthly KDV returns. Odoo generates the data for:

• Total sales by KDV rate (20%, 10%, 1%, exempt)
• Total purchases by KDV rate
• KDV withholding applied (tevkifat)
• KDV withholding suffered
• Deductible KDV from previous periods
• Net KDV payable or refundable

---

Turkish Payroll (SGK and Income Tax)

SGK (Social Security Institution) Contributions

SGK ceiling: Contributions are calculated on gross salary up to the SGK monthly ceiling (approximately TRY 150,000/month in 2025, updated annually).

SGK floor: Minimum wage is the floor for SGK calculations (TRY 20,002.50 gross/month for 2025).

Income Tax (Gelir Vergisi)

Turkey applies progressive income tax on employment income:

Odoo calculates monthly income tax based on cumulative year-to-date earnings, applying the correct bracket as the employee's cumulative income crosses thresholds during the year.

Stamp Tax (Damga Vergisi)

Stamp tax of 0.759% applies to employment contracts and monthly salary amounts. Odoo deducts stamp tax from gross salary as part of the payroll calculation.

Minimum Wage Exemption

Turkey provides an income tax exemption on the minimum wage portion of all salaries. Employees earning above minimum wage only pay income tax on the amount exceeding the minimum wage. Odoo applies this exemption automatically in the payroll calculation.

Payroll Components

Severance Pay (Kidem Tazminati)

Turkey's severance pay system is among the most generous globally:

• Calculation: 30 days' gross salary per year of service
• Ceiling: Updated biannually (approximately TRY 35,000 per year of service in 2025)
• Eligibility: Minimum 1 year of service, dismissal without cause, resignation for valid reason, military service, retirement, marriage (for women within 1 year), or death
• Accrual: Odoo accrues the liability monthly on the balance sheet

---

Turkish Chart of Accounts (Tekduzen Hesap Plani)

Turkey mandates a Uniform Chart of Accounts that all businesses must follow. Odoo's Turkish localization includes this chart:

Key tax-related accounts:

• 191 — Deductible KDV (input tax)
• 391 — KDV payable (output tax)
• 360 — Tax and duties payable
• 361 — Social security payable
• 370 — Advance income tax

---

TCMB Exchange Rate Integration

Mandatory Exchange Rates

Turkish tax regulations require the use of TCMB (Central Bank of the Republic of Turkey) exchange rates for:

• Foreign currency invoice conversion
• Month-end balance revaluation
• Customs valuation (for import duties)
• Tax return foreign currency disclosures

Odoo can be configured to automatically fetch daily TCMB exchange rates for all currency pairs published by the Central Bank.

Multi-Currency Management

Given the TRY's significant volatility, multi-currency management is critical:

• Daily TCMB rate updates — automatic import of buying, selling, and effective rates
• Invoice date conversion — foreign currency invoices converted at the TCMB rate on the invoice date
• Month-end revaluation — unrealized FX gains/losses posted using month-end TCMB rates
• Realized FX gains/losses — calculated at payment date and posted to 646/656 accounts
• FX exposure reporting — summary of foreign currency positions by currency

---

Implementation Considerations

Typical Timeline

Key Success Factors

1. Choose the intermediary early — E-Fatura intermediary (Ozel Entegrator) selection affects the integration approach; confirm compatibility with Odoo before starting
2. Classify KDV rates carefully — incorrect KDV classification leads to assessment risk; validate all product/service categories against GIB schedules
3. Test E-Fatura thoroughly — GIB's test environment should be used extensively; production invoices cannot be corrected once accepted
4. Configure KDV tevkifat matrix — withholding rate determination depends on both the service type and the buyer's status; map this matrix completely
5. Plan for SGK reporting — monthly SGK declarations (APHB — Aylik Prim ve Hizmet Belgesi) must reconcile exactly with payroll; errors incur penalties

---

Frequently Asked Questions

Is E-Fatura mandatory for all businesses in Turkey?

E-Fatura is mandatory for businesses meeting the GIB-specified criteria: gross revenue above TRY 3 million, manufacturers/importers/exporters of certain regulated products, and registered e-commerce businesses. Even businesses below the threshold can voluntarily register. E-Arsiv is mandatory for all E-Fatura registered businesses for their non-E-Fatura transactions (B2C and sales to non-registered businesses).

How does Odoo handle the E-Fatura integration with GIB?

Odoo integrates with GIB through approved intermediary platforms (Ozel Entegratorler). When you create and validate an invoice in Odoo, the system generates the UBL-TR XML, sends it to the intermediary for digital signing and GIB submission, and tracks the response (acceptance or rejection). Inbound E-Fatura invoices are pulled from the intermediary and imported into Odoo for matching with purchase orders.

Can Odoo calculate KDV withholding (tevkifat) automatically?

Yes, Odoo's Turkish localization includes tevkifat codes for all GIB-specified withholding categories. When creating a sales invoice with a tevkifat-applicable service, Odoo splits the KDV between the amount collected from the buyer and the amount the buyer withholds and pays directly to the tax office. The corresponding E-Fatura is generated with the TEVKIFAT invoice type.

How does Odoo handle severance pay (kidem tazminati) accrual and calculation?

Odoo accrues severance pay liability monthly based on each employee's current gross salary (capped at the biannual ceiling) and tenure. When an employee's contract terminates, Odoo calculates the final severance payment: 30 days' gross salary for each completed year of service, prorated for partial years, capped at the applicable ceiling. The accrual is booked as a long-term liability and released upon payment.

Does Odoo support E-Defter (electronic ledger) generation?

Yes, Odoo can export journal entries and the general ledger in the XBRL-GL format required for E-Defter. The data includes the Yevmiye Defteri (journal) and Buyuk Defter (general ledger) in the GIB-specified schema. The files are then signed, timestamped, and submitted through the GIB or intermediary platform by the filing deadline.

How does Odoo manage the Turkish minimum wage income tax exemption?

Odoo's Turkish payroll module applies the minimum wage income tax exemption automatically. For all employees, the income tax is calculated only on the amount of gross salary (after SGK deductions) that exceeds the net minimum wage equivalent. This exemption reduces the effective income tax for employees earning close to or slightly above the minimum wage.

---

Getting Started with Odoo in Turkey

Turkey's advanced digital compliance ecosystem — E-Fatura, E-Arsiv, E-Irsaliye, E-Defter — combined with complex payroll legislation and the mandatory Tekduzen chart of accounts, creates one of the most demanding ERP environments globally. Odoo, properly configured with Turkish localization and integrated with a reliable intermediary, delivers comprehensive compliance while maintaining the flexibility and affordability that Turkish businesses value.

ECOSIRE has experience implementing Odoo for Turkish businesses across manufacturing, trading, retail, and services sectors. We understand the GIB compliance requirements, SGK payroll complexities, and the operational needs of companies operating in and from Turkey.

Explore our Odoo implementation services to learn how we deliver compliant, efficient Odoo deployments for Turkish businesses. Contact our team to discuss your implementation requirements.