Shared modules · Definitions

Withholding, VAT exemption and tax offices

Tax authority (GİB) VAT withholding codes and rates, VAT exemption codes for zero-VAT lines, and the tax offices chosen on account cards.

Definitions → Withholding Tax Types, VAT exemption codes, Tax offices Updated: 11/18/2026

This screen changed recently. Screenshots will be retaken after the code change of 2026-11-19; the text is current, some images may look outdated.

These three lists feed the tax details of e-invoice and e-archive documents. The withholding and exemption lists come pre-filled with GİB codes; usually you only need to deactivate the ones you do not use.

Withholding tax types

Part of the screenWithholding types
Withholding types
Figure 1. Withholding types
  1. 1Code Tax authority (GİB) withholding code (e.g. 601).
  2. 2Multiplier Multiplier / divisor: share of VAT withheld (e.g. 9/10).
  3. 3Free rate If ticked, the rate can be changed manually in the document.
  4. 4+ Add row Adds an empty row to the list.
  5. 5Save Saves all changes in the table.
Column Description
Code GİB withholding code (e.g. 601 construction works).
Name Name of the withholding.
Multiplier / Divisor Share of VAT withheld: 9 / 10, 7 / 10, 5 / 10 and so on.
Active Inactive types cannot be chosen on cards and documents.
Free rate If ticked, the rate can be changed manually in the document.

The Withholding Tax Type on item and service cards is chosen from this list and is filled into document lines automatically. + Add row adds an empty row, Save saves all changes in the table together.

VAT exemption codes

Part of the screenVAT exemption codes
VAT exemption codes
Figure 2. VAT exemption codes
  1. 1Code GİB exemption code (e.g. 301).
  2. 2Type Domestic, Export or Special base.
  3. 3Active Inactive codes cannot be chosen in documents.

Document lines with a zero VAT rate choose an exemption code from this list. The Type column states whether the code is Domestic, Export or a special base.

Tax offices

Part of the screenTax offices list
Tax offices list
Figure 3. Tax offices list
  1. 1Search Filters by name or city.
  2. 2New tax office Opens the window to add a tax office that is not listed.
  3. 3Office row Name, city, district and source.
  4. 4Source «Your company»: an office your company added; it can be edited and deleted. «Shared»: the standard list; it cannot be changed.

The standard GİB list is shared by all companies; the search box filters by name or city. You can add a missing office here or from the account card. The Source column shows whether an office is Shared (standard list) or was added by Your company.

New tax office

Part of the screenNew tax office window
New tax office window
Figure 4. New tax office window
  1. 1Save Saves the office to the shared catalogue.
  2. 2Cancel Closes without saving.
New tax office window: fields on screen
FieldSign inDescription
Tax office name requiredTextOffice name (e.g. «Nilüfer»). Required.
Placeholder: «e.g. Güneşli»
CityChoice listProvince of the office.
DistrictChoice listFilled once a city is chosen; optional.

The new office is written to the catalogue shared by all companies.

Editing and deleting a tax office

Part of the screenEdit tax office window
Edit tax office window
Figure 5. Edit tax office window
  1. 1Save Saves the change.
  2. 2Cancel Closes without saving.
Edit tax office window: fields on screen
FieldSign inDescription
Tax office name requiredTextName of the office. Required.
Placeholder: «e.g. Güneşli»
CityChoice listProvince of the office.
DistrictChoice listFilled once a city is chosen; optional.

Only offices showing Your company in the Source column can be edited and deleted; standard (shared) offices have no row menu.

  1. Click the office row, or choose Edit from the menu at the end of the row.
  2. Change the name, city or district and press Save; check that «Tax office updated.» appears.
  3. To delete, choose Delete from the row menu and confirm.

Account cards store the tax office by name. Renaming an office does not change the old name already written on cards. An office used on any account card cannot be deleted.

Step by step: hiding unused withholding codes

  1. Open Withholding Tax Types.
  2. Untick Active on the rows you do not use.
  3. Press Save and check that «Saved.» appears.
  4. Only active codes appear in the withholding list on cards and documents.

Withholding and exemption codes are written into e-documents with their GİB code. Changing a code or rate may get documents rejected; edit them only when the GİB list changes.

Common messages

Message Cause Solution
A VAT exemption code must be selected because there is no VAT. A zero-VAT line has no exemption code. Choose an exemption code on the line or in the document header.
Exemption codes cannot be used on VAT-inclusive lines. An exemption code was chosen on a line with VAT. Remove the code or set VAT to zero.
The exemption code must be selected either in the document header or in the line; they cannot be used together. The code is chosen in both header and line. Choose it in only one place.
Invalid or inactive VAT exemption code: {0} The code is not in the list or inactive. Activate the code or choose another.
Tax office name is required. The name is empty in the new office window. Enter the office name.
This tax office is already registered. The office already exists. Find it with the search box.
Standard (shared) tax offices cannot be changed; only records your company added can be edited. An office in the shared list was edited or deleted. If your company needs its own office, add it with New tax office.
This tax office is used on {0} account card(s) and cannot be deleted. You can edit the record instead. The office is selected on at least one account card. Change the office on those cards, or edit the office instead of deleting it.