Turkey

Splits a Turkish amount into net, VAT and (optionally) withholding: who pays the seller, who remits the withheld VAT.

For invoice lines and checkout totals that have to show KDV dahil / hariç and, when the parties are in a withholding (tevkifat) situation, the split between what the buyer pays the seller and what the buyer remits to the tax office. Rates are 0, 1, 10 and 20 percent. Withholding is a fraction of the VAT (2/10 through 10/10), or a named code from the GİB partial-withholding list. The 2026 threshold (TRY 12,000 gross) is reported and compared with the amount, but applies is always null: whether withholding actually applies depends on the taxpayer status of both parties, which this endpoint does not know. Feeding it a fraction is not a legal opinion.

Credits per call: 1 · Operation id: tr_vat

post/v1/tr/vat

Request

  • Base URL: https://api.temsor.com
  • URL: https://api.temsor.com/v1/tr/vat
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Request body

amountnumber required

The amount to tax. See amountIncludesVat.

amountIncludesVatboolean

If true, amount is the gross (KDV dahil); if false, it is the net/matrah.

withholdingstring

Withholding fraction such as "5/10", or a code from the list (reklam, tasima, hurda, isgucu…).

Response

Success

okunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.