# ZUGFeRD doğrulayıcıları: hibrit faturayı göndermeden önce neyi test etmelisiniz

- Date: 2026-04-20
- Modified: 2026-08-29
- Denetlendi: 15 Ağustos 2026
- Reading time: 2 dk okuma

ZUGFeRD ve Factur-X doğrulaması için pratik 2026 rehberi: XML kuralları, PDF/A-3 kontrolleri, profil uyumu, yaygın hatalar ve hangi doğrulayıcı türlerinin

> Şu resmî kaynaklara göre denetlendi: FNFE-MPE Factur-X kaynakları, UN/CEFACT XML şemaları.

Bu rehber, ZUGFeRD veya Factur-X üreten ve “PDF açılıyor” ifadesinin gönderime hazır anlamına gelip gelmediğini merak eden ekipler içindir.

Gelmez. Kullanılabilir hibrit fatura için okunabilir PDF'den fazlası gerekir: gömülü XML amaçlanan profile uymalı, zorunlu veriler mevcut olmalı, toplamlar tutarlı olmalı ve PDF kapsayıcısı da formatın arşiv beklentilerini karşılamalıdır.

## Bir doğrulayıcının gerçekten kontrol etmesi gerekenler

- Gömülü XML mevcut olmalı ve PDF kapsayıcısından doğru şekilde okunabilmelidir.
- Fatura verisi EN 16931'a ve seçilen ZUGFeRD veya Factur-X profiline uymalıdır.
- Parasal toplamlar, KDV kırılımları, birimler ve tarihler kendi içinde tutarlı olmalıdır.
- PDF dosyası hibrit fatura akışı için beklenen PDF/A-3 gerekliliklerini karşılamalıdır.
## Birden fazla türde doğrulama kullanın

Sağlam bir akış genellikle en az iki katman içerir. Önce iş kurallarını ve XML yapısını doğrulayın. Sonra PDF/A-3 kapsayıcısını ve gömülü dosya paketlemesini kontrol edin. Alıcı kanalının kendi kontrolleri varsa bunu tek testiniz değil, üçüncü kapı olarak görün.

Bu yüzden ekipler çoğu zaman ZUGFeRD farkında bir fatura doğrulayıcısını, belge kapsayıcısı için [veraPDF](https://verapdf.org/) gibi bir PDF/A doğrulayıcısıyla birleştirir.

## Önerilen doğrulama akışı

- ZUGFeRD veya Factur-X faturasını zaten gözden geçirilmiş kaynak veriden üretin.
- Hedef profil ve EN 16931 beklentilerine karşı kural tabanlı fatura doğrulaması çalıştırın.
- PDF/A-3 kontrolünü gömülü XML içermeyen taslak PDF üzerinde değil, nihai belgede yapın.
- Yapılandırılmış veriyi gösterebilen bir görüntüleyicide belgeyi açın ve kilit alanları kaynak faturayla karşılaştırın.
- Ancak bundan sonra belgeyi e-posta, portal veya PEPPOL üzerinden gönderin.
## Yaygın hatalar ve genelde ne anlama geldikleri

- PDF normal açılır ama XML eksiktir, bozuktur veya beklenen şekilde eklenmemiştir.
- XML teknik olarak okunur ama zorunlu alanlar veya profil tanımlayıcıları yanlıştır.
- Satır toplamları, vergilendirilebilir tutarlar ve KDV değerleri çıkarım veya eşleme sonrası uzlaşmaz.
- Belge insana doğru görünür ama hibrit kapsayıcı eksik veya uyumsuz olduğu için PDF/A-3 testinden kalır.
## Resmî ve birincil kaynaklar

- [FeRD ZUGFeRD 2.5.2 / Factur-X 1.09.2 paket sayfası](https://www.ferd-net.de/publikationen-produkte/publikationen/detailseite/zugferd-252-english).
- [EN 16931 ve XRechnung kuralları için KoSIT doğrulayıcı yapılandırması](https://github.com/itplr-kosit/validator-configuration-xrechnung).
- [XRechnung doğrulama bağlamı için KoSIT destek notları](https://xeinkauf.de/xrechnung/supporthinweise/).
- [veraPDF PDF/A doğrulama projesi](https://verapdf.org/).

## FAQ

### PDF'nin açılması ZUGFeRD uyumunu kanıtlar mı?

Hayır. Okunabilir PDF yalnızca görsel katmanın var olduğunu gösterir. Gömülü XML’in mevcut, geçerli veya profile uygun olduğunu göstermez.

### Neden hem fatura doğrulayıcısı hem PDF/A doğrulayıcısı kullanmalıyım?

Çünkü farklı şeyleri kontrol ederler. Biri fatura semantiği ve kurallara odaklanır, diğeri PDF kapsayıcısının arşiv ve paketleme beklentilerini test eder.

### Doğrulama insan incelemesini ortadan kaldırır mı?

Hayır. Doğrulama zorunludur, ancak kaynak kalite sorunları, yanlış profil seçimi ve iş bağlamı hataları için insan incelemesi yine gerekir.

## Resmî kaynaklar

- [FNFE-MPE Factur-X kaynakları](https://fnfe-mpe.org/factur-x/)
- [UN/CEFACT XML şemaları](https://unece.org/trade/uncefact/xml-schemas)