Turkey Localization
Turkey Localization for SODOO
- A compliant startThe uniform chart of accounts, tax offices and Turkish banks, ready.
- e-Invoicing inside the systeme-Invoices and e-Archive documents go out through the integrator; incoming invoices come in.
- Withholding done rightVAT withholding is applied on the invoice by itself.
Overview
Turkey Localization is a comprehensive module package that makes SODOO compliant with Turkish legislation and the e-document requirements of the GİB (Revenue Administration). It provides e-Invoice, e-Archive, VAT withholding and Uniform Chart of Accounts support.
Module List
Turkey Localization consists of 10 integrated modules. Each module performs a specific function.
The meta module that brings all Turkey localization modules together. Installs the other modules automatically.
Creating, sending and tracking GİB e-Invoices and e-Archive invoices. The main application module.
Receiving, viewing and accepting or rejecting e-Invoices from suppliers.
GİB connection through the IZIBIZ (Foriba) e-document integrator. Communication via web services.
The GİB e-document infrastructure. Integrator framework, UBL-TR builder, code lists and templates.
VAT withholding and withholding rates. Fiscal positions for partial and full withholding calculations.
Other Modules
| Module | Version | Description |
|---|---|---|
| l10n_tr_bank | 19.0.1.0.0 | List of Turkish banks, EFT and IBAN details |
| l10n_tr_tax_office | 19.0.1.0.0 | Tax office directory (81 provinces, 6-digit codes) |
| l10n_tr_2kb | 19.0.1.0.0 | 2KB chart of accounts variant, fiscal positions |
| kita_api_services | 19.0.1.4.0 | Kıta API credentials management |
e-Invoice
An e-Invoice is an electronic invoice issued between taxpayers registered with the GİB. It is transmitted through the GİB and has the status of legal evidence.
Invoice Scenarios
e-Invoice Sending Process
Invoice Numbering Format
ABC2024000000001
│││ ││││ │││││││
│││ │││└─────────→ 9-digit sequence number
│││ └────────────→ Year (2024)
└────────────────→ 3-letter prefix (company code)
^[A-Z0-9]{3}20[0-9]{2}[0-9]{9}$ regex format. The prefix may contain only upper-case letters and digits.
e-Archive
e-Archive is the electronic invoice type issued to consumers and to taxpayers not registered with the GİB. It is not transmitted through the GİB, but it is signed with a digital signature and archived.
| Feature | e-Invoice | e-Archive |
|---|---|---|
| GİB transmission | Yes | No |
| PK requirement | TICARI (commercial) only | Not required |
| Commercial workflow | Accept/Reject | None |
| Digital signature | Mandatory | Mandatory |
| Cost | High | Low |
| Use case | B2B (registered) | B2C + B2B (unregistered) |
VAT Withholding
VAT withholding means that, for certain purchases of goods and services, the buyer withholds part of the VAT due to the seller and pays it directly to the tax office.
Partial Withholding Rates (2025-2026)
| Service/Goods Type | Withholding Rate | Paid to the Seller |
|---|---|---|
| Cleaning, security and similar services | 9/10 | 1/10 |
| Supplies of copper, zinc, aluminium and lead | 7/10 | 3/10 |
| Iron-steel and alloy products | 5/10 | 5/10 |
| Catering and meal services | 5/10 | 5/10 |
| Construction works | 4/10 | 6/10 |
| Commercial advertising services | 3/10 | 7/10 |
| Freight transport | 2/10 | 8/10 |
Withholding Thresholds
GİB Integration
Integration with the Revenue Administration (GİB) is done through private integrators. SODOO uses the IZIBIZ integrator.
Integration Options
| Method | Description | Suitable for |
|---|---|---|
| GİB Portal | Free, manual upload/download | Low invoice volume |
| Private integrator | Automatic processing via API, 10-year archiving | Medium to high volume |
| Direct integration | Requires GİB-approved infrastructure | Large enterprises |
IZIBIZ Integrator
IZIBIZ (Foriba) is one of Türkiye's leading e-document integrators. SODOO communicates with the GİB through IZIBIZ web services.
PK (Mailbox) and GB Alias
Configuration
Company GİB Settings
Required Settings
| Setting | Location | Description |
|---|---|---|
| Integrator | Settings → Company → GİB | IZIBIZ must be selected |
| API key | Settings → Company → Kıta API | API key and secret obtained from Kıta |
| Production environment | GİB integrator settings | Choice of test or production environment |
| Invoice logo | GİB integrator settings | Company logo shown on the invoice |
| Tax office | Settings → Company | The tax office the company is registered with |
| VKN/TCKN | Partner record | Customer/supplier tax number |
Invoice Sequence Configuration
A separate number series is created for each invoice scenario: