How do I run the Build KDV Beyannamesi (VAT Return — KDV1) for e-Beyanname skill?

Copy the skill and paste it into your own Claude or ChatGPT, then provide your source data. FinchContext skills run inside your own AI assistant, so your financial data never leaves your control.

Which region does the Build KDV Beyannamesi (VAT Return — KDV1) for e-Beyanname skill cover?

Türkiye. It targets the local tax authority / e-invoicing format described on this page.

Build KDV Beyannamesi (VAT Return — KDV1) for e-Beyanname

Q: What does the Build KDV Beyannamesi (VAT Return — KDV1) for e-Beyanname skill do?

Convert a period's sales and purchase data into the Turkish KDV1 VAT return prepared in the Beyanname Düzenleme Programı (BDP) and filed via e-Beyanname — matrah per rate (20%/10%/1%) with hesaplanan KDV, indirilecek KDV plus önceki dönemden devreden KDV, istisna/ihracat/tevkifat sections, and the ödenecek KDV versus sonraki döneme devreden KDV settlement with a worked example.

Skill: Convert sales/purchase data into the KDV1 beyannamesi prepared in BDP and filed via e-Beyanname

Region: Türkiye (Turkey) Category: Tax — Katma Değer Vergisi (KDV / VAT) Does: Takes a period's sales and purchase figures and maps them onto the KDV beyannamesi (KDV1) — the standard monthly VAT return — prepared in the Beyanname Düzenleme Programı (BDP) and submitted electronically through the e-Beyanname system to the Gelir İdaresi Başkanlığı (GİB). System: BDP → e-Beyanname (KDV1 beyannamesi)

The KDV1 return covers a taxpayer's own taxable transactions (it is distinct from KDV2, the reverse-charge / sorumlu sıfatıyla return). It is filed monthly, generally by the 28th of the following month, with payment by the same date. Figures are entered into the BDP, which produces the official package and the tahakkuk (assessment) is returned after e-Beyanname submission. Field labels and matrah/oran codes change periodically — always use the current BDP version and KDV1 form. Confirm the current rates, deadlines, and form layout against GİB guidance before use.

When this applies

VAT-registered taxpayers reporting their own output and input VAT for the period (KDV1).
Filed monthly (some special regimes differ); deadline generally the 28th of the month following the period.
Reverse-charge VAT the taxpayer owes as sorumlu (e.g. on services from abroad) goes on KDV2, not here; KDV1 may then claim it back as indirme.

Input data required

Group	Fields
Filer	VKN/TCKN, vergi dairesi, dönem (month + year)
Output (hesaplanan)	net sales matrah per rate (20% / 10% / 1%) and computed KDV
Exempt / special	istisna deliveries (tam/kısmi), tevkifatlı satışlar, ihracat
Input (indirilecek)	deductible KDV from purchase invoices, imports, KDV2 paid
Carryforward	previous period devreden KDV (carried-over credit)
Settlement	ödenecek KDV (payable) or sonraki döneme devreden KDV (carryforward)

Matrah (taxable base) is entered per rate; the BDP computes hesaplanan KDV from base × oran.

Key form sections / lines (representative)

Section	Reports
Matrah	taxable base by KDV rate (20% / 10% / 1%); hesaplanan KDV derived
İlave edilecek KDV	VAT to be added (e.g. previously deducted, now corrected)
İstisnalar / İadeler	exempt deliveries and refund-eligible transactions
İndirimler	bu döneme ait indirilecek KDV + önceki dönemden devreden KDV
Tevkifat	KDV withheld by buyers on tevkifatlı satışlar
Sonuç hesapları	Ödenecek KDV or Sonraki Döneme Devreden KDV

Calculation rules

Hesaplanan KDV = sum over rates of (matrah × oran) — e.g. base@20% × 0.20, base@10% × 0.10, base@1% × 0.01.
Toplam indirilecek KDV = bu döneme ait indirilecek KDV + önceki dönemden devreden KDV.
If hesaplanan + ilave KDV > indirilecek KDV → Ödenecek KDV = difference (payable).
If indirilecek KDV > hesaplanan + ilave → the excess becomes Sonraki Döneme Devreden KDV (carried forward; not refunded unless a specific iade ground applies).
Tevkifat withheld by the buyer reduces the amount the seller collects; report it in the tevkifat section.
Amounts in TRY (kuruş); the BDP enforces the form's rounding conventions.

Worked example (monthly KDV1, outline)

Dönem 2026-05, VKN 1234567890, Vergi Dairesi: Mecidiyeköy
  Matrah @20% = 100000.00  → Hesaplanan KDV  20000.00
  Matrah @10% =  20000.00  → Hesaplanan KDV   2000.00
  Toplam Hesaplanan KDV ........................ 22000.00

  Bu döneme ait indirilecek KDV ................ 15000.00
  Önceki dönemden devreden KDV .................  3000.00
  Toplam indirilecek KDV ....................... 18000.00

  Ödenecek KDV = 22000.00 − 18000.00 ........... 4000.00  (ödenecek)

Entered in the BDP, transmitted via e-Beyanname; GİB returns the tahakkuk fişi with the payable amount and due date.

Validation checklist

Current BDP version and KDV1 form layout used
VKN/TCKN, vergi dairesi, and dönem (month/year) correct
Matrah entered per rate (20% / 10% / 1%); hesaplanan KDV reconciles with base × oran
İstisna / ihracat / tevkifatlı satışlar reported in the right sections
İndirilecek KDV supported by invoices; önceki dönemden devreden KDV carried in correctly
Reverse-charge owed as sorumlu reported on KDV2, not KDV1
Ödenecek KDV vs Sonraki Döneme Devreden KDV computed correctly
Filed via e-Beyanname by the deadline (generally 28th); tahakkuk retained, payment made on time

Last updated: 2026-06-04 — confirm the active schema version, field codes, and GİB requirements against the current Gelir İdaresi Başkanlığı (Revenue Administration) specifications before use.