KDV1 ve KDV2 e-Beyanname Gönderim Süreçleri
- Ağustos 28, 2026
- Yayınlayan: evosas
- Kategoriler: Doküman, Logo ERP
1. Amaç
Bu doküman, KDV1 ve KDV2 beyannamelerinin e-Beyan servisleri üzerinden gönderilmesi, tahakkuk oluşturulması, onaylanması, silinmesi ve PDF çıktılarının alınması süreçlerinde yapılan geliştirmeleri açıklamaktadır.
2. Ön Koşullar
e-Beyan işlemlerinin yapılabilmesi için aşağıdaki tanımların eksiksiz olması gerekmektedir:
• Firma veya işyeri bazında Entegratör Bilgileri tanımlanmış olmalıdır.
• GIBTOKEN bilgisi girilmiş olmalıdır.
• Mükellef Grubu seçilmiş olmalıdır.
• Kullanıcının ilgili ekranlara erişim yetkisi bulunmalıdır.
Not: Entegratör Bilgileri ekranındaki şifre alanında ) } * ? karakterleri kullanılmamalıdır. Aksi halde sistem token alamayabilir ve “Entegratör bilgileri geçersizdir.” uyarısı verebilir. Bu durumda Kullanıcı Kodu ve Şifre bilgileri kontrol edilmelidir.
3. Firma ve İşyeri Tanımlarında Yapılan Değişiklikler
Firma Tanımı ve İşyeri Tanımı ekranlarına e-Beyanname sekmesi eklenmiştir.

Bu sekmede aşağıdaki alanlara veri girişi ve seçimi yapılmalıdır.
e-Beyananame GIB Token : e-Beyan servislerinde kullanılacak GIB Token bilgisi girilmelidir.
e-Beyanname Mükellef Grubu : Liste üzerinden seçim yapılmalıdır.
Beyanname gönderiminde Mükellef Grubu seçimi zorunludur. Seçim yapılmamışsa sistem “Firma/işyeri tanımlı e-Devlet / e-Beyanname sekmesinde Mükellef Grubu seçimi yapılmalıdır. uyarısı verir.
Beyanname içinde özel onay seçenekleri kullanıldığında Tahakkuk Oluştur ve Onayla işlemlerinde Mükellef Grubu değeri zorunludur. İşlemler sırasında hata alınmaması için Gönder işlemi öncesinde seçimi zorunlu tutulmuştur.
4. Beyannamelerin e-Beyan Servisine Gönderilmesi
Beyanname ekranına “e-Beyan Servisine Gönderilecek” seçeneği eklenmiştir.

İşaretli Değilse ; Sistem mevcut BDP süreçleriyle çalışmaya devam eder.
Mevcut:
• XML Oluştur
• Paket Oluştur
• BDP Kontrol
• Gönder
işlemleri kullanılabilir.
İşaretliyse ; BDP süreçleri gizlenir ve e-Beyan süreçleri aktif olur.
Aktif Olan İşlemler:
• Gönder
• Tahakkuk Oluştur
• Onayla
• GİB Sil
• PDF İndir
5. Beyanname Durum Takibi
Beyanname durumları sistem tarafından otomatik takip edilir. Durum bilgileri LGTAXDECLHDR tablosundaki TRANSFERSTATUS alanında tutulur.
Kod Durum
0 Yeni
2 Gönderildi
6 Tahakkuk Oluşturuldu
7 Onaylandı
8 Silindi
Beyanname ilk oluşturulduğunda durumu Yeni olarak görüntülenir. Beyanname browserında ve beyanname Genel Bilgiler sekmesinde Durumu izlenebilir.
6. e-Beyan İşlem Akışı
Beyanname Gönderimi
Önemli: e-Beyan işlemlerinde toplu işlem desteği bulunmamaktadır. Gönder, Tahakkuk Oluştur, Onayla, GİB Sil ve PDF İndir işlemleri yalnızca imlecin (aktif satırın) bulunduğu beyanname için gerçekleştirilir. Birden fazla beyanname seçilerek işlem yapılamaz.
1. Beyanname oluşturulur.
2. e-Beyan Servisine Gönder seçilir.
3. Gönder butonuna basılır.
4. Sistem aşağıdaki onayı ister:
Beyannameniz e-Beyan sistemine gönderilecektir. Devam etmek istiyor musunuz?
5. Gönderim başarılı olursa durum Gönderildi olarak güncellenir.
Tahakkuk Oluşturma Gönderilmiş beyannamelerde kullanılabilir. İşlem başarılı olursa durum:Tahakkuk Oluşturuldu olarak güncellenir.
Onaylama Tahakkuk oluşturulmuş beyannamelerde kullanılabilir. İşlem başarılı olursa durum: Onaylandı olarak güncellenir.
GİB Sil
Gönderilmiş veya tahakkuk oluşturulmuş beyannameler için kullanılabilir. Başarılı işlem sonrasında durum: Silindi olarak güncellenir.
7. Buton Yetkilendirmeleri
Yeni / Silindi
Aktif: Gönder
Pasif:Tahakkuk Oluştur ,Onayla, GİB Sil ,PDF
Gönderildi
Aktif: Tahakkuk Oluştur, GİB Sil, PDF (Beyanname)
Tahakkuk Oluşturuldu
Aktif:Onayla, GİB Sil, PDF
Onaylandı
Aktif: PDF İndir,
8. PDF İndirme
PDF İndir menüsünde aşağıdaki seçenekler bulunmaktadır:
• Beyanname
• Tahakkuk
• İhbarname
Kullanım Kuralları
• Beyanname PDF’i her zaman indirilebilir.
• Tahakkuk ve İhbarname PDF seçenekleri yalnızca onay sonrasında aktif olur.
Tahakkuk PDF indirildiğinde:
1. Önce ana tahakkuk PDF’i indirilir.
2. Sonrasında varsa 344, 352 ve 355 ceza kodlarına ait PDF’ler indirilir.
Örnek dosya adı:
KDV1_123456_Tahakkuk.pdf
Ceza dosyaları:
• KDV1_123456_Tahakkuk_Ceza344.pdf
• KDV1_123456_Tahakkuk_Ceza352.pdf
• KDV1_123456_Tahakkuk_Ceza355.pdf
9. Düzeltme Beyannamesi ve Özel Onay İşlemleri
Beyanname Kayıtları ekranına aşağıdaki alanlar eklenmiştir:

Düzeltme Beyannamesi Checkbox alanıdır. İşaretlendiğinde: Açıklama alanı aktif olur.
Düzeltme Beyanname Açıklaması
• Düzeltme Beyannamesi seçili ise aktif olur.
• Gönderim ve onay işlemlerinde servise gönderilir.
Özel Onay İşlemleri
Özel Onay alanı altında aşağıdaki seçenekler bulunmaktadır:
• Kanuni Süresinden Sonra
• Pişmanlık Talebi
• İzah
• İhtirazi Kayıt
Seçilen özel onay türüne göre ilgili ceza işlem türleri kullanılabilir.
Bazı ceza türleri yalnızca:
• Düzeltme beyannamesinde,
• Kanuni süresinden sonra,
• Pişmanlık,
• İzah
seçenekleri seçildiğinde kullanılabilir.
İzah seçildiğinde:
• Referans Numarası
• Tebliğ Tarihi
alanları aktif olur.
İzah veya İhtirazi seçildiğinde:
• Gerekçe alanı aktif olur.
• Minimum 50, maksimum 500 karakter girilebilir.
10. Beyanname ID Bilgisi
e-Beyan servislerine başarılı gönderim sonrasında dönen Beyanname ID değeri LGTAXDECLHDR.DECLID alanında saklanmaktadır.
Bu bilgi aşağıdaki işlemlerde kullanılır:
• Tahakkuk Oluşturma
• Onaylama
• GİB Silme
• PDF İndirme
11. Hata ve Uyarılar
Gönderim sırasında servisten birden fazla hata veya uyarı mesajı dönebilir. Bu durumda mesajlar Beyanname Gönderim Hataları ekranında liste halinde görüntülenir. Kullanıcı tüm hata ve uyarıları inceleyerek gerekli düzeltmeleri yaptıktan sonra beyannamenin yeniden gönderimini gerçekleştirmelidir.
Örnek hata:
Token uygun değil / bulunamadı
Bu durumda GIBTOKEN bilgileri kontrol edilmelidir.

13. İşyeri ve Firma Bazlı Çalışma
Beyanname ekranında: İşyeri Seçiliyse
İşyeri tanımındaki:
• Entegratör bilgileri
• GIBTOKEN
• Mükellef Grubu
kullanılır.
İşyeri = Hepsi Seçiliyse Firma tanımındaki bilgiler kullanılır.
14. Uzun Süren İşlemler
Gönderim, tahakkuk ve onay işlemleri servis yoğunluğuna bağlı olarak uzun sürebilir. İşlem sırasında kullanıcıya aşağıdaki bilgilendirmeler gösterilir:
• Gönderim Yapılıyor…
• Tahakkuklar Oluşturuluyor…
• Onay İşlemi Yapılıyor…
Bu süreçte uygulama kullanılmaya devam edilebilir.
15.Beyanname Json formunun düzenlenebilmesi
KDV 1 ve KDV 2 beyannamelerine ait json formları gönderilmeden önce edit edilebilecek ve son hali gönderilebilecektir.

16.Önemli Notlar
• Gönderilmiş beyannamelerde değişiklik yapılamaz.
• Değişiklik yapılabilmesi için önce GİB Sil işlemi yapılmalıdır.
• Durum güncellemeleri sistem tarafından otomatik yapılır.
• Kullanıcının ayrıca durum sorgulaması yapmasına gerek yoktur.
• Servisten dönen tüm yanıtlar kullanıcıya gösterilir.
