Kısa cevap: Genelge 30 hatası, e-Faturanın UBL format kurallarına uymadığını gösterir. En sık nedeni Netsis sürümünün güncel UBL şemasını desteklememesidir. Çözüm: Netsis’i son sürüme güncelleyin, GİB ret yanıtındaki XML’de eksik/yanlış alanı (ProfileID, CurrencyCode, tarih formatı) düzeltin ve önce test ortamında gönderim yapın.
e-Fatura sisteminde Genelge 30 hatası alıyorsanız genellikle UBL formatında bir sorun var. Bu rehberde Genelge 30’un ne anlam ifade ettiğini ve adım adım çözüm yolunu paylaşıyoruz.
Genelge 30 Nedir?
Genelge 30, e-Fatura standardının UBL (Universal Business Language) format kurallarını ve Türkiye’ye özel uyarlamaları içerir. Versiyon güncellemeleri olur ve Netsis sürümünüzün uyumlu olması gerekir.
Hata Sebepleri
- Eski Netsis sürümü → güncel UBL desteklemiyor
- XML namespace yanlış
- Zorunlu alan eksik (CurrencyCode, ProfileID)
- Tarih formatı yanlış (YYYY-MM-DD olmalı)
- Para birimi kodu yanlış (TRY, USD, EUR ISO 4217)
- Vergi oranı format yanlış
Çözüm
1. Netsis sürüm kontrolü
Yardım → Hakkında → Sürüm numarası → Logo Yazılım sayfasından son sürümle karşılaştırın
2. Sürüm güncelleme
Eski sürüm ise update gerekli (1-2 saat)
3. Hata XML’i incele
GİB’den gelen ret yanıtında detay XML var, eksik alanı görün
4. Düzeltme uygulayın
Cari kart, stok kart veya parametre düzeltme
5. Test gönderim
Test ortamında deneyin, onay alırsanız üretime geçin
Genelge 30 Bilgi Kartı
| Alan | Değer |
|---|---|
| Genelge No | 30 |
| Konu | UBL format ve Türkiye uyarlaması |
| Versiyon | Düzenli güncellenir |
| İlgili | e-Fatura, e-Arşiv, e-İrsaliye |
💡 Bakım anlaşmamızda: Yeni genelgeler çıktığında 24-48 saat içinde Netsis sisteminize uygulanır. Standart müşteriler için saatlik destek olarak çözülür.
Sıkça Sorulan Sorular
Genelge 30 hatası tam olarak ne anlama geliyor?
Genelge 30, e-Fatura UBL (Universal Business Language) formatının Türkiye’ye özel kurallarını tanımlar. Bu hatayı aldığınızda gönderdiğiniz faturanın XML yapısı GİB’in beklediği UBL şemasıyla uyumlu değildir; genellikle zorunlu bir alan eksik, namespace yanlış ya da Netsis sürümünüz güncel şemayı desteklemiyordur.
Genelge 30 hatasını çözmek ne kadar sürer?
Sorun yalnızca sürüm güncellemesinden kaynaklanıyorsa update işlemi tipik olarak 1-2 saat sürer. Cari/stok kartı veya parametre kaynaklı eksik alan düzeltmeleri çok daha hızlıdır. Bakım anlaşması olan müşterilerde yeni genelgeler 24-48 saat içinde uygulanır.
Hangi alanlar Genelge 30 hatasına en sık yol açar?
En sık karşılaşılanlar ProfileID ve CurrencyCode gibi zorunlu alanların eksik olması, tarih formatının YYYY-MM-DD dışında girilmesi, para birimi kodunun ISO 4217’ye (TRY, USD, EUR) uymaması ve XML namespace’inin yanlış tanımlanmasıdır.
Düzeltme sonrası faturayı doğrudan göndermeli miyim?
Hayır. Düzeltmeyi yaptıktan sonra önce GİB test ortamında gönderim yapın. Test ortamından onay aldıktan sonra aynı faturayı üretim ortamında gönderin; böylece tekrar ret riskini ortadan kaldırırsınız.