SAP E-Beyanname Entegrasyon Mimarisi

Sağlam bir SAP E-Beyanname mimarisi yalnızca bir REST çağrısından oluşmaz. Kaynak finans kaydından GİB’in durum yanıtına ve tahakkuk belgesine kadar her adımın izlenebilmesi gerekir. Mimari; beyanname kapsamı değiştiğinde güncellenebilir, hatayı doğru sorumluya yönlendirebilir ve yeniden işlem sırasında aynı veriyi kontrolsüz biçimde çoğaltmamalıdır.

Önerilen uçtan uca akış

Temel işlem zinciri şu şekilde kurulabilir:

SAP kaynakları → veri seçimi → beyanname eşlemesi → şirket içi kontroller → şirket içi onay → GİB kanalı → durum ve belge arşivi

Her ok üzerinde bir işlem kimliği, zaman damgası ve sorumlu kullanıcı kaydı tutulması; beyanname satırının hangi SAP belgesinden geldiğini açıklamayı kolaylaştırır.

1. SAP kaynak katmanı

Beyannameye göre SAP FI muhasebe belgeleri, ana hesap bakiyeleri, vergi kodları, müşteri/tedarikçi ana verileri ve ilgili bordro veya vergi kaynakları kullanılabilir. Kaynak seçimi şu sorulara yanıt vermelidir:

Hangi şirket kodları ve defterler kapsamdadır?
Belge tarihi, kayıt tarihi ve vergi dönemi nasıl ayrılır?
İptal, ters kayıt ve düzeltme belgeleri nasıl ele alınır?
Kaynak kaydın sonradan değişmesi mevcut beyannameyi nasıl etkiler?

Kaynak sorgusu ile beyanname eşlemesini tek bir geri döndürülemez dönüşümde birleştirmeyin. Kaynak veri anlık görüntüsü, eşleme sonucu ve gönderim paketi ayrı denetim katmanları olmalıdır.

2. Eşleme ve sürüm yönetimi

GİB veri alanları ve doğrulama kuralları beyanname ile döneme göre değişebilir. Bu nedenle eşleme tablosunda yalnızca SAP alanı ve hedef alan değil, aşağıdaki bilgiler de bulunmalıdır:

Beyanname ve vergi kodu
Geçerlilik başlangıç ve bitiş tarihi
GİB beyanname veya şema versiyonu
Dönüşüm ve yuvarlama kuralı
Zorunluluk koşulu
Kural değişikliğini onaylayan kişi

Yeni eşleme sürümü canlıya alınmadan önce geçmiş, sınır ve hata senaryolarıyla test edilmelidir.

3. Kontrol katmanı

Kontrolleri üç gruba ayırmak işletimi kolaylaştırır:

Teknik kontroller: zorunlu alan, veri tipi, uzunluk ve format.
Mutabakat kontrolleri: matrah–vergi oranı, hesap bakiyesi, devreden KDV ve toplamlar.
İş kuralı kontrolleri: dönem, mükellefiyet, sözleşme, tekrar kayıt ve özel onay koşulları.

GİB’in 400 format/doğrulama, 401 kimlik doğrulama, 403 yetkilendirme ve 422 iş kuralı sınıfındaki yanıtları aynı kullanıcı mesajına çevrilmemelidir. Ayrıntılı yönlendirme için GİB hata yanıtları ve SAP düzeltme akışını kullanın.

4. Şirket içi onay

GİB’e gönderim yetkisi ile şirket içi hazırlama ve kontrol yetkisini ayırın. Önerilen en az rol ayrımı:

Hazırlayan: kaynak seçimini ve ilk kontrolleri çalıştırır.
Kontrol eden: mutabakat farklarını ve istisnaları değerlendirir.
Onaylayan: şirket içi onayı tamamlar.
Gönderen: GİB kanalında yetkili işlemi başlatır.

Aynı kişinin bütün rolleri taşıması gerekiyorsa bu istisna kayıt altına alınmalı ve dönemsel olarak gözden geçirilmelidir.

5. GİB entegrasyon geçidi

GİB’in entegrasyon kılavuzu onaylı gerçek IP, ortam bazlı erişim adresleri ve her ortam için ayrı API anahtarı ister. API anahtarı kaynak kodda, tarayıcıda veya loglarda tutulmamalıdır. SAP’den çıkan isteklerde en az şu bilgiler güvenli işletim kaydına bağlanmalıdır:

Ortam ve hedef servis
Beyanname ve dönem
GİB beyanname kimliği
İstek zamanı ve sonuç durumu
GİB mesaj kodu ve iz kimliği varsa bu değer

Loglama yapılırken API anahtarı, kişisel veri ve gereksiz beyanname içeriği maskelenmelidir.

Geçidin hangi kanala bağlanacağı beyanname ve döneme göre değişebilir; iki kanalın rolleri için GİB e-Beyan REST API ile BDP arasındaki farkı inceleyin.

6. Durum ve belge arşivi

Taslak, hatalı, onay bekliyor, onaylandı veya iptal gibi durumlar SAP işlem kaydına tek yönlü metin olarak değil, izin verilen geçişleri olan bir durum modeliyle bağlanmalıdır. GİB kullanıcı dokümanına göre belge indirme ve düzeltme işlemleri beyanname durumuna bağlıdır.

Onaylı beyanname, tahakkuk ve hata belgeleri; beyanname kimliği, dönem, şirket kodu, belge türü ve bütünlük bilgisiyle arşivlenmelidir. Saklama süresi ve erişim yetkisi şirketin vergi, bilgi güvenliği ve kayıt yönetimi politikalarıyla doğrulanmalıdır.

Uygulamaya başlamadan önce SAP E-Beyanname geçiş kontrol listesini tamamlayın. Etkileşimli ürün akışını Fenikstech SAP E-Beyanname çözümünün interaktif simülasyonunda inceleyebilirsiniz.

Resmî kaynaklar

Bu yazı 23 Temmuz 2026’da resmî kaynaklara göre gözden geçirilmiştir.