BLOG
SAP E-Beyanname Geçiş Kontrol Listesi
SAP E-Beyanname geçişi, yalnızca bir ABAP geliştirmesini veya REST API bağlantısını canlıya almak değildir. Vergi, SAP, bilgi güvenliği ve operasyon ekiplerinin aynı kapsam kaydında buluşması gerekir. Aşağıdaki kontrol listesi proje kararından ilk canlı dönemin kapanışına kadar izlenebilir bir yol sunar.
1. Kapsam ve sorumluluk
- Her beyanname için GİB adı, vergi kodu ve şirket içi süreç sahibi belirlendi.
- Şirket kodu, vergi dairesi, mükellefiyet ve vergilendirme dönemi kapsamı yazıldı.
- Mükellefin bağlı olduğu il veya vergi dairesi ile hedef dönemin GİB kademeli geçiş kapsamı doğrulandı.
- REST API, BDP veya doğrulanacak kanal beyanname ve dönem bazında kaydedildi.
- Yeni, düzeltme, kanuni süresinden sonra ve özel onay senaryoları ayrıldı.
- GİB duyurularını ve API değişikliklerini izleyecek sorumlu atandı.
Kapsamı tek bir ürün listesiyle değil, beyanname–dönem–il/mükellef–kanal matrisiyle yönetin.
2. GİB başvurusu ve erişim
- Kurumun beyanname gönderme ve entegrasyon başvurusu yapma yetkisi doğrulandı.
- Dijital Vergi Dairesi üzerinden e-Beyan entegrasyon başvurusu tamamlandı.
- Pre-Prod, Pilot ve Prod için gerçek IP adresleri planlandı.
- GİB onay durumu ve onaylanan ortamlar kaydedildi.
- Her ortam için ayrı API anahtarı üretme ve yenileme prosedürü yazıldı.
- API anahtarının kaynak kod, istemci tarafı ve loglardan uzak tutulduğu doğrulandı.
GİB kılavuzuna göre ortama özel token yalnızca oluşturulduğu pencerede görüntülenebilir. Saklama ve yenileme sorumluluğu canlıya geçmeden netleşmelidir.
3. SAP veri ve eşleme hazırlığı
- Kullanılacak SAP FI, ana veri, bordro ve diğer vergi kaynakları belirlendi.
- Belge tarihi, kayıt tarihi ve vergi dönemi kuralları tanımlandı.
- İptal, ters kayıt ve dönem sonu düzeltmeleri için kaynak filtreleri test edildi.
- Her hedef alanın SAP kaynağı, dönüşüm kuralı ve geçerlilik tarihi kaydedildi.
- Yuvarlama, kur dönüşümü ve boş değer kuralları vergi ekibi tarafından onaylandı.
- Kaynak kayıttan beyanname satırına geri izleme sağlandı.
Teknik katmanların ayrıntısı için SAP E-Beyanname entegrasyon mimarisini okuyun.
4. Kontrol ve onay modeli
- Zorunlu alan, tip, uzunluk ve format kontrolleri tanımlandı.
- Matrah–oran, hesap bakiyesi, devreden KDV ve toplam mutabakatları belirlendi.
- Uyarı ile durdurucu hata arasındaki fark yazıldı.
- Hazırlayan, kontrol eden, onaylayan ve gönderen rolleri ayrıldı.
- Yetki çakışmaları ve görevler ayrılığı istisnaları kaydedildi.
- Şirket içi onay tamamlanmadan resmî gönderimin başlatılamadığı test edildi.
5. Test senaryoları
- Normal ve sıfır beyan senaryoları çalıştırıldı.
- Eksik zorunlu alan, hatalı format ve mükerrer kayıt denendi.
- Yetkisiz kullanıcı, yanlış/eksik token ve onaysız IP davranışı test edildi.
- GİB iş kuralı hatasının doğru satır ve sorumluya yönlendirildiği doğrulandı.
- Düzeltme ve kanuni süresinden sonra beyan akışları kapsama göre test edildi.
- Büyük veri setinde parça yükleme, zaman aşımı ve güvenli tekrar senaryoları denendi.
- Onay, tahakkuk, beyanname ve hata belgelerinin arşivi kontrol edildi.
Hata sınıfları için GİB hata yanıtları ve SAP düzeltme akışına bakın.
6. Canlıya geçiş ve işletim
- Üretim ortamı, hedef dönem, il/mükellef kapsamı, IP ve API anahtarı son kez doğrulandı.
- İlk canlı dönem için vergi, SAP ve entegrasyon sorumluları belirlendi.
- Geri dönüş planı ve gerektiğinde kullanılacak alternatif kanal yazıldı.
- İzleme; teknik hata, GİB iş kuralı, bekleyen onay ve belge indirme durumlarını kapsıyor.
- API anahtarı yenileme, IP değişikliği ve yetki kaldırma süreçleri dokümante edildi.
- İlk canlı dönem sonrasında hata, süre ve manuel müdahale kayıtları gözden geçirildi.
Tamamlanma ölçütü
“Bağlantı kuruldu” tek başına tamamlanma ölçütü değildir. Proje, kapsam dahilindeki bir beyanname için kaynak kaydın seçilmesi, şirket içi kontrol ve onay, geçerli GİB kanalı, durum takibi ve belge arşivinin yetkili kullanıcılarla uçtan uca doğrulanmasıyla tamamlanmış sayılmalıdır.
Tarayıcıda örnek akışı görmek ve kapsam koşullarını değerlendirmek için Fenikstech SAP E-Beyanname çözümünün interaktif simülasyonunu inceleyin.
Resmî kaynaklar
- GİB e-Beyan Entegrasyon Kılavuzu
- GİB 20 Temmuz 2026 KDV e-Beyan geçiş duyurusu
- GİB e-Beyan REST API geliştirici dokümanları
- GİB Beyannameler kullanıcı dokümanı
Bu kontrol listesi 23 Temmuz 2026’da resmî kaynaklara göre gözden geçirilmiştir.
