A
Ali Güngör
Misafir
Misafir
SAP e-fatura GİB entegrasyonu, Türkiye’deki kurumsal SAP kullanıcılarının en sık hata yaptığı ve en pahalıya ödediği alan olma özelliğini korumaktadır. GİB, e-fatura, e-arşiv, e-irsaliye ve e-defter düzenlemelerini sürekli güncellerken bu değişikliklere SAP sistemi tarafında zamanında ve doğru uyum sağlamak kritik bir operasyonel yetkinliğe dönüşmüştür. En küçük yapılandırma hatası bile toplu fatura reddine, mali idari cezaya ve şirket itibar kaybına yol açabilir.
MDP Group olarak, onlarca SAP müşterimizin GİB entegrasyon sürecinde yaşadığı sorunları doğrudan deneyimledik. Bu yazıda en sık karşılaşılan hataları ve bunların önlenme yollarını ele alıyoruz.
GİB, UBL-TR (Universal Business Language – Türkiye) şemasını düzenli aralıklarla günceller. Bu güncellemeler; yeni zorunlu alanlar, değişen vergi kodları ya da format değişikliklerini kapsayabilir. SAP sistemi GİB’in yeni şemasına uyarlanmadan işlem yapmaya devam ederse faturalar reddedilir. Ancak çok daha tehlikelisi, reddedilen faturaların fark edilmemesi ve alacak takibinin bozulmasıdır. GİB duyurularını takip eden ve SAP’yi zamanında güncelleten bir süreç şart olarak kurulmalıdır.
GİB, canlı entegrasyon öncesinde test edilebilecek bir API ortamı sunar. Ancak bazı firmalar maliyet veya zaman baskısıyla bu aşamayı atlar ve doğrudan canlı sisteme geçer. Bu hata, canlı ortamda toplu fatura hatasına veya sistem çökmesine yol açabilir. MDP Group olarak tüm GİB entegrasyon projelerinde mutlaka GİB test API üzerinden tam senaryo testi yapılmasını öneriyoruz; bu adımı atlamak uzun vadede çok daha büyük maliyet doğurur.
SAP’daki fatura verileri GİB’in beklediği UBL-TR XML formatına dönüştürülrken mapping (eşleme) hataları sıkça gerçekleşir. Özellikle vergi üst tipi ayrımı (KDV, ÖTV, damga vergisi), işem kodu etiketleri veya para birimi tanımları yanlış yapılandırılabilir. Bu tür hataların büyük bölümü çälışma ortamında değil test sırasında ortaya çıkar ve erken düzeltilebilir.
e-Fatura, GİB’e kayıtlı mükellefler arasında düzenlenirken; e-arşiv, kayıtlı olmayan mükellef ya da bireysel alıcı için kullanılır. SAP’ta bu ayrımın iyi yapılandırılmaması durumunda yanlış belge tipiyle kesilen fatura hem GİB’de hem muhasebede uyumsuzluğa yol açar. Özellikle hem B2B hem B2C satış yapan firmalar bu ayrımı SAP müşteri master verisine ve output type yapılandırmasına doğru biçimde yansıtmalıdır.
GİB, gönderilen fatura için bir yanıt kodu döndürür. “1300 – Kabul Edildi” yeterince takip edilirken, “220 – Teknik Hata” veya “500 – Sistem Hatası” gibi kodlar SAP tarafında uyarı tetiklemez ve fatura yanlış bir durumda askıda kalırsa fark edilmez. Otomatik durum kodu izleme ve alarm mekanizması kurulmadan GİB entegrasyonu tamamlanmış sayılmamalıdır.
bu izleme mekanizmasını merkezi bir panelden yönetmeyi mümkün kılar.
GİB, fatura tarih ve saatinin UTC+3 (Türkiye saati) ile uyumlu olmasını bekler. SAP sistemi farklı timezone ile yapılandırıldığında, özellikle gece yarısı yakın saatlerde kesilen faturalarda tarih kayması yaşanır ve GİB bu faturayı geçersiz sayılır. Görünmez ama ağır sonuçları olan bu hata özellikle gece vardiyalarında veya toplu fatura oluşturma sırasında kendini gösterir.
Bu yazıdaki bilgiler; 2025-2026 yıllarında geçerli GİB düzenlemelerine dayanmaktadır. GİB sürekli güncelleme yaptığından, herhangi bir entegrasyon kararı öncesinde resmi GİB dokümantasyonunu ve SAP notlarını kontrol etmenizi öneririz. Bu yazı hukuki tavsiye niteliği taşımaz; yasal uyum konularında uzman danışmanlık alın.
SAP üzerinden GİB entegrasyonu; özel entegrasyon araçları (MDP IMS gibi), SAP ERP e-fatura add-on’ları veya üretici entegratör hizmetleri üzerinden sağlanabilir. Her yöntemin fiyat, esneklik ve sürdürülebilirlik açısından farklı avantajları vardır. Özellikle çok fazla fatura hacmine sahip firmalar için SAP native entegrasyonu uzun vadede en sürdürülebilir seçenektir.
GİB resmi duyurusunu takip edin, SAP Note’larını inceleyin ve mevcut entegrasyon yapılandırmanızı yeni şemaya göre güncelleyin. Güncelleme sonrasında mutlaka GİB test API üzerinde testi tekralyın ve canlı geçiş öncesi onay alın. Kritik güncellemelerde aynı gün değişikliğe gitmeyin; test süresini en az 2-3 iş günü olarak planlayın.
Hayır. SAP standard güncellemesi yasal uyumu tam olarak garantilemez; özellikle Türkiye’ye özel düzenlemeler için ek SAP Note’ların uygulanması ve özeleştirme kontrolleri gerekebilir.
SAP e-fatura GİB entegrasyonu, teknik kurulum bittiğinde tamamlanmış değil; sürekli izleme, düzenli güncelleme ve test gerektiren canlı bir süreçtir. Yukarıdaki hataların önlenebilmesi için doğru bir yapılandırma ve süreç disiplini şarttır. MDP Group GİB entegrasyon uzmanlarıyla görüşmek için bizimle iletişime geçin.
MDP Group olarak, onlarca SAP müşterimizin GİB entegrasyon sürecinde yaşadığı sorunları doğrudan deneyimledik. Bu yazıda en sık karşılaşılan hataları ve bunların önlenme yollarını ele alıyoruz.
Bu bağlantıyı görüntüleyebilmek için kayıt olmalı zaten üyeyseniz üye girişi yapmalısınız.
konusunu henüz incelemedinizse, bu makaleyi okumadan önce o yazımızı incelemenizi öneririz.SAP e-Fatura GİB Entegrasyonunda Yapılan En Yaygın Hatalar
| Hata | Etkilenen Süreç | Olası Sonuç |
| GİB şema güncellemelerinin takip edilmemesi | e-Fatura gönderimi | Reddedilen fatura, gecikme cezası |
| Test ortamı (GİB test API) atlanması | Canlı geçiş | Toplu fatura hatası, sistem çöküntesı |
| UBL-TR format uyumsuzluğu | e-Fatura, e-İrsaliye | GİB reddi, mali idari yaptırım |
| e-Arşiv ve e-Fatura karıştırılması | Fatura sınıflandırma | Yanlış belge tipi, uyumsuzluk |
| GİB durum kodu 220/500 hatası göz ardı | Fatura yanlış yanıtı | Kabul edilmemiş fatura takipsiz kalır |
| SAP zaman dilimi (timezone) yapılandırma hatası | Fatura tarihi/saati | Geçersiz fatura, GİB reddi |
1. GİB şema Güncellemelerinin Takip Edilmemesi
GİB, UBL-TR (Universal Business Language – Türkiye) şemasını düzenli aralıklarla günceller. Bu güncellemeler; yeni zorunlu alanlar, değişen vergi kodları ya da format değişikliklerini kapsayabilir. SAP sistemi GİB’in yeni şemasına uyarlanmadan işlem yapmaya devam ederse faturalar reddedilir. Ancak çok daha tehlikelisi, reddedilen faturaların fark edilmemesi ve alacak takibinin bozulmasıdır. GİB duyurularını takip eden ve SAP’yi zamanında güncelleten bir süreç şart olarak kurulmalıdır.
2. Test Ortamı (GİB Test API) Atlanması
GİB, canlı entegrasyon öncesinde test edilebilecek bir API ortamı sunar. Ancak bazı firmalar maliyet veya zaman baskısıyla bu aşamayı atlar ve doğrudan canlı sisteme geçer. Bu hata, canlı ortamda toplu fatura hatasına veya sistem çökmesine yol açabilir. MDP Group olarak tüm GİB entegrasyon projelerinde mutlaka GİB test API üzerinden tam senaryo testi yapılmasını öneriyoruz; bu adımı atlamak uzun vadede çok daha büyük maliyet doğurur.
3. UBL-TR Format Uyumsuzluğu
SAP’daki fatura verileri GİB’in beklediği UBL-TR XML formatına dönüştürülrken mapping (eşleme) hataları sıkça gerçekleşir. Özellikle vergi üst tipi ayrımı (KDV, ÖTV, damga vergisi), işem kodu etiketleri veya para birimi tanımları yanlış yapılandırılabilir. Bu tür hataların büyük bölümü çälışma ortamında değil test sırasında ortaya çıkar ve erken düzeltilebilir.
Bu bağlantıyı görüntüleyebilmek için kayıt olmalı zaten üyeyseniz üye girişi yapmalısınız.
nasıl yönetildiğini anlatan yazımızda vergi entegrasyonunun teknik boyutunu detaylandırdık.4. e-Arşiv ve e-Fatura Karıştırılması
e-Fatura, GİB’e kayıtlı mükellefler arasında düzenlenirken; e-arşiv, kayıtlı olmayan mükellef ya da bireysel alıcı için kullanılır. SAP’ta bu ayrımın iyi yapılandırılmaması durumunda yanlış belge tipiyle kesilen fatura hem GİB’de hem muhasebede uyumsuzluğa yol açar. Özellikle hem B2B hem B2C satış yapan firmalar bu ayrımı SAP müşteri master verisine ve output type yapılandırmasına doğru biçimde yansıtmalıdır.
5. GİB Durum Kodu Hatalarının Göz Ardı Edilmesi
GİB, gönderilen fatura için bir yanıt kodu döndürür. “1300 – Kabul Edildi” yeterince takip edilirken, “220 – Teknik Hata” veya “500 – Sistem Hatası” gibi kodlar SAP tarafında uyarı tetiklemez ve fatura yanlış bir durumda askıda kalırsa fark edilmez. Otomatik durum kodu izleme ve alarm mekanizması kurulmadan GİB entegrasyonu tamamlanmış sayılmamalıdır.
Bu bağlantıyı görüntüleyebilmek için kayıt olmalı zaten üyeyseniz üye girişi yapmalısınız.
bu izleme mekanizmasını merkezi bir panelden yönetmeyi mümkün kılar.
6. SAP Zaman Dilimi (Timezone) Yapılandırma Hatası
GİB, fatura tarih ve saatinin UTC+3 (Türkiye saati) ile uyumlu olmasını bekler. SAP sistemi farklı timezone ile yapılandırıldığında, özellikle gece yarısı yakın saatlerde kesilen faturalarda tarih kayması yaşanır ve GİB bu faturayı geçersiz sayılır. Görünmez ama ağır sonuçları olan bu hata özellikle gece vardiyalarında veya toplu fatura oluşturma sırasında kendini gösterir.
GİB Entegrasyonunu Sağlam Kurmak İçin Kontrol Listesi
- GİB şema ve UBL-TR güncellemelerini takip eden bir süreç kurun. GİB duyurularını periyodik kontrol eden sorumlu atanın.
- Her yapılandırma değişikliğinde GİB test API üzerinde senaryo testi yapın. Canlıya geçiş öncesi en az 50 farklı senaryo test edilmelidir.
- SAP output type yapılandırmasında e-fatura / e-arşiv ayrımını müşteri master verisine bağlayın.
- GİB durum kodu izleme mekanizması kurun. Hata kodları için SAP tarafında otomatik bildirim tanımlayın.
- SAP sistem timezone’unu doğrulayan periyodik kontrol yapın.
- GİB entegrasyon dokümantasyonunu güncel tutun. Her güncelleme sonrası yapılandırma kaydını yenileyin.
Uyarılar ve Sınırlamalar
Bu yazıdaki bilgiler; 2025-2026 yıllarında geçerli GİB düzenlemelerine dayanmaktadır. GİB sürekli güncelleme yaptığından, herhangi bir entegrasyon kararı öncesinde resmi GİB dokümantasyonunu ve SAP notlarını kontrol etmenizi öneririz. Bu yazı hukuki tavsiye niteliği taşımaz; yasal uyum konularında uzman danışmanlık alın.
Sık Sorulan Sorular
SAP’ta GİB e-fatura entegrasyonu için hangi çözüm yöntemleri mevcut?
SAP üzerinden GİB entegrasyonu; özel entegrasyon araçları (MDP IMS gibi), SAP ERP e-fatura add-on’ları veya üretici entegratör hizmetleri üzerinden sağlanabilir. Her yöntemin fiyat, esneklik ve sürdürülebilirlik açısından farklı avantajları vardır. Özellikle çok fazla fatura hacmine sahip firmalar için SAP native entegrasyonu uzun vadede en sürdürülebilir seçenektir.
GİB güncellemesi geldiğinde SAP tarafında ne yapmalıyız?
GİB resmi duyurusunu takip edin, SAP Note’larını inceleyin ve mevcut entegrasyon yapılandırmanızı yeni şemaya göre güncelleyin. Güncelleme sonrasında mutlaka GİB test API üzerinde testi tekralyın ve canlı geçiş öncesi onay alın. Kritik güncellemelerde aynı gün değişikliğe gitmeyin; test süresini en az 2-3 iş günü olarak planlayın.
e-Dönüşüm kapsamı genişlediğinde SAP sistemi otomatik uyum sağlar mı?
Hayır. SAP standard güncellemesi yasal uyumu tam olarak garantilemez; özellikle Türkiye’ye özel düzenlemeler için ek SAP Note’ların uygulanması ve özeleştirme kontrolleri gerekebilir.
Bu bağlantıyı görüntüleyebilmek için kayıt olmalı zaten üyeyseniz üye girişi yapmalısınız.
yapılmadan geçiş yapılması pek çok firmanın yaşadığı hatalı bir yaklaşımdır.Sonuç
SAP e-fatura GİB entegrasyonu, teknik kurulum bittiğinde tamamlanmış değil; sürekli izleme, düzenli güncelleme ve test gerektiren canlı bir süreçtir. Yukarıdaki hataların önlenebilmesi için doğru bir yapılandırma ve süreç disiplini şarttır. MDP Group GİB entegrasyon uzmanlarıyla görüşmek için bizimle iletişime geçin.
Referanslar
Bu bağlantıyı görüntüleyebilmek için kayıt olmalı zaten üyeyseniz üye girişi yapmalısınız.
Bu bağlantıyı görüntüleyebilmek için kayıt olmalı zaten üyeyseniz üye girişi yapmalısınız.
Bu bağlantıyı görüntüleyebilmek için kayıt olmalı zaten üyeyseniz üye girişi yapmalısınız.
Bu bağlantıyı görüntüleyebilmek için kayıt olmalı zaten üyeyseniz üye girişi yapmalısınız.