Fatura

Bir bakışta

NextPDF Enterprise, ZUGFeRD / Factur-X / Peppol-UBL yapılandırılmış karma faturalar üretir ve fatura XML’ini EN 16931 veri modeline ve Schematron kural kümelerine göre doğrular. EN 16931’de tanımlanan veri modeline uygun yapılandırılmış faturalar üretir; bir vergi-otoritesi doğrulayıcısı değildir ve hiçbir belgeyi sertifikalandırmaz.

Kullanılabilirlik ve lisanslama

Bu yetenek NextPDF Enterprise (nextpdf/enterprise) ile birlikte gelir ve Enterprise katmanı bir lisans zarfıyla etkinleşir. Bu yetkiye sahip olmayan bir dağıtım, yeteneğin sınıflarını yüklemez. Sürümleri karşılaştırın ve lisans alın.

Kurulum

composer require nextpdf/enterprise:^3

Schematron motoru PHP ext-xsl uzantısını kullanır. Schematron doğrulamasını çalıştırmadan önce onu kurun ve etkinleştirin.

Kavramsal genel bakış

Invoice modülünün üç bağımsız yüzeyi vardır: yapılandırılmış-fatura gömme, EN 16931 XML doğrulama ve Schematron kural yürütme.

Gömme. ZugferdEmbedder, çağıranın sağladığı bir ZUGFeRD 2.4 / Factur-X 1.08 UN/CEFACT CII XML yükünü bir PDF/A taşıyıcısına iliştirerek karma bir fatura üretir. İki taşıyıcı biçimi desteklenir: tercih edilen modern taşıyıcı olan PDF/A-4f (ISO 19005-4:2020) ve geriye dönük uyumluluk için PDF/A-3b (ISO 19005-3:2012). ZugferdXmpSchema, taşıyıcının ihtiyaç duyduğu Factur-X XMP uzantı-şeması bildirimini enjekte eder. PeppolEmbedder, çağıranın sağladığı Peppol BIS Billing 3.0 UBL 2.1 fatura veya alacak-dekontu XML’i için aynı rolü üstlenir; onu doğru ilişkili-dosya ilişkisi ve MIME türüyle iliştirir. NextPDF fatura XML’i sentezlemez; çağıran geçerli XML sağlar ve fatura düzenleyeni olarak kalır.

Doğrulama. InvoiceXmlValidator, fatura XML’ini EN 16931 anlamsal veri modeline ve ZUGFeRD / Factur-X kapsayıcı beklentilerine göre denetler; buna EN 16931 iş kuralı BR-1’in zorunlu kıldığı BT-24 spesifikasyon tanımlayıcısı da dahildir. İki kipten birinde çalışır: COMPAT (varsayılan; sınırdaki EN 16931 önem-sayısı bulguları, mevcut fikstürler için geriye dönük uyumluluğu korumak amacıyla uyarı olarak raporlanır) ve STRICT (BT-24 önem sayısı, harici-doğrulayıcı anlam bilimini yansıtacak şekilde sert bir hatadır). Kip; çağrı başına, ortam geçersiz kılması ya da uygunluk politikasıyla seçilebilir.

Schematron. SchematronValidator, önceden derlenmiş Schematron kural kümelerini (derleme zamanında XSLT’ye derlenmiş CEN EN 16931 .sch kuralları) süreç içi PHP XSLT işlemcisini kullanarak fatura XML’ine karşı çalıştırır ve SVRL raporunu yapılandırılmış bulgulara ayrıştırır. ZugferdProfile enum’u uygunluk profillerini modeller — MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED ve EN 16931 üzerine kurulu Alman XRechnung B2G CIUS.

Bu modülün ne iddia ettiği ve ne iddia etmediği

Bu modül, yapılandırılmış fatura verisi üretir ve denetler. Herhangi bir belgenin yasal olarak uyumlu bir fatura olduğunu, vergi otoritesince onaylandığını veya herhangi bir otorite tarafından kabul edileceğinin garanti edildiğini iddia etmez.

• Doğrulayıcı yalnızca EN 16931 anlamsal modelini ve ZUGFeRD / Factur-X / UBL kapsayıcısını denetler. Bir vergi-otoritesi doğrulayıcısı değildir. Ulusal uzantılar ve takas platformları — örneğin İtalyan SDI, Fransız Chorus Pro, Alman XRechnung taşıması — taşıma düzeyinde kapsam dışıdır.
• EN 16931-1’in kendisinin belirttiği gibi, çekirdek anlamsal model bir elektronik faturanın yasal ve mali uyumluluğu desteklemek için ihtiyaç duyduğu temel bilgiyi taşır; fatura düzenleyeni, ilgili mevzuatın kurallarını karşılamaktan sorumludur. Bu, bir vergi-otoritesi doğrulayıcısı değildir.
• Bir standardın desteklenmesi ona uygunlukla aynı şey değildir. Yargı bölgenizdeki düzenleyici yeterliliği değerlendirmek için vergi ve uygunluk danışmanlarınıza başvurun.

Neden bu şekilde çalışır

Modül, fatura XML’ini kasıtlı olarak hiçbir zaman sentezlemez. Gömme, EN 16931 doğrulaması ve Schematron yürütmesi, çağıranın sağladığı ve sahip olduğu XML üzerindeki üç bağımsız yüzeydir. Bu, NextPDF’i bir üretici ve denetleyici olarak tutar, hiçbir zaman düzenleyen olmaz; çünkü yasal sorumluluk bir kütüphaneye devredilemez. Doğrulama, varsayılan olarak COMPAT kullanır; böylece sınırdaki bir önem-sayısı bulgusu, bir gerileme değil bir uyarıdır. Harici-doğrulayıcı anlam bilimine ihtiyaç duyduğunuzda STRICT isteğe bağlıdır. Sonuç temiz bir ayrımdır: NextPDF gözlemlediğini raporlar ve belgenin yasayı karşılayıp karşılamadığına düzenleyen karar verir. Tasarım arka planı: Faturalar ve e-faturalama.

API yüzeyi

Sınıf	Sorumluluk
ZugferdEmbedder	ZUGFeRD / Factur-X CII XML’ini bir PDF/A-4f veya PDF/A-3b taşıyıcısına iliştirir.
ZugferdXmpSchema	Factur-X XMP uzantı-şeması bildirimini enjekte eder.
ZugferdProfile	Uygunluk-profili enum’u (MINIMUM … EXTENDED, XRECHNUNG).
PeppolEmbedder	Peppol BIS 3.0 UBL fatura / alacak-dekontu XML’ini bir PDF/A taşıyıcısına iliştirir.
InvoiceXmlValidator	XML’i EN 16931 veri modeline göre denetler; COMPAT veya STRICT kipi.
InvoiceValidatorMode	Doğrulama-kipi enum’u: COMPAT (varsayılan) veya STRICT.
SchematronValidator	Önceden derlenmiş Schematron kural kümelerini çalıştırır; SVRL bulgularını ayrıştırır.
InvoiceValidationResult / SchematronResult	Yapılandırılmış sonuçlar: profil, bulgular, önem dereceleri.

Kod örneği — hızlı başlangıç

use NextPDF\Enterprise\Invoice\ZugferdEmbedder;
use NextPDF\Enterprise\Invoice\ZugferdProfile;

$pdf = ZugferdEmbedder::basic($pdfAManager, $fileAttachment, $ciiXml)
    ->embed(ZugferdProfile::EN16931);

Kod örneği — üretim

use NextPDF\Enterprise\Invoice\InvoiceXmlValidator;
use NextPDF\Enterprise\Invoice\InvoiceValidatorMode;

$result = $validator->validate($ciiXml, InvoiceValidatorMode::STRICT);

foreach ($result->findings as $finding) {
    $logger->warning('invoice.finding', [
        'rule'     => $finding->ruleId,
        'severity' => $finding->severity->value,
    ]);
}
// A clean result is one input to your decision, not a compliance verdict.
// The invoice issuer remains responsible for relevant legislation.

Uç durumlar ve tuzaklar

• Tanınabilir bir fatura yükü taşımayan, biçimi düzgün bir PDF, bir istisna fırlatmak yerine “fatura değil” sonucu verir.
• COMPAT, varsayılan doğrulama kipidir: eksik bir BT-24 spesifikasyon tanımlayıcısı bir uyarı olarak raporlanır; böylece bir boole geçerlilik bayrağına göre geçit kuran çağrı noktaları geriye gitmez. BT-24’ü, harici KoSIT / Mustang anlam bilimiyle eşleşen sert bir hata yapmak için STRICT kullanın.
• Fatura XML’ini çağıran sağlar. NextPDF onu üretmez veya düzeltmez; boş bir bulgu listesi, uyumsuz bir yükü uyumlu kılmaz.
• Schematron motoru ext-xsl gerektirir. Kural kümeleri derleme zamanında derlenir; çalışma zamanı yalnızca önceden derlenmiş XSLT’yi yürütür.

Performans

Doğrulama maliyeti, gömülü XML boyutu ve Schematron kurallarının sayısıyla ölçeklenir. Gömme maliyeti taşıyıcı boyutuyla ölçeklenir ve PDF/A serileştirmesi tarafından baskınlanır. Sayfa performans bütçesi, fatura iş hacmini değil, belge oluşturmayı yansıtır.

Güvenlik notları

Tüm XML ayrıştırma, sağlamlaştırılmış XML korumasından geçer: harici varlık çözümleme devre dışıdır (XXE-güvenli), DOCTYPE reddedilir ve açma işlemi sınırlanmıştır. XSLT işlemcisi, ağ ve dosya sistemi kaynak yüklemesi devre dışı çalışır ve hiçbir zaman PHP işlevleri kaydetmez; böylece document(), xsl:include, xsl:import ve result-document ağa veya diske erişemez. Güvenilmeyen kaynaklardan gelen fatura XML’ini düşmanca kabul edin.

Veri yerleşimi ve PII azaltmaları

Fatura XML’i kişisel, ticari ve finansal veri içerebilir. İşleme süreç içi ve yereldir; modül gömme veya doğrulama sırasında hiçbir giden ağ çağrısı yapmaz. Çıkarılan XML’e ve bulgulara kendi saklama ve en aza indirme denetimlerinizi uygulayın.

Güvenli telemetri ve günlük temizleme

Bulgular ve doğrulama günlükleri, kural tanımlayıcılarını ve etiket değerlerini içerebilir. Tam fatura yüklerini içermez. Bu değerler hassassa, günlükleri paylaşılan alıcılara iletmeden önce alan değerlerini temizleyin veya gizleyin.

Uygunluk

Davranış	Referans	Durum
Çekirdek fatura anlamsal modeli	EN 16931-1:2026 §4	Karşı geliştirildi; düzenleyen ilgili mevzuattan sorumlu kalır
Spesifikasyon tanımlayıcısı (BT-24)	EN 16931-1:2026 BR-1	Denetlendi (COMPAT’ta uyarı, STRICT’te hata)
UN/CEFACT CII söz dizimi bağlaması	CEN/TS 16931-3-3:2020	Gömme destekli
UBL 2.1 söz dizimi bağlaması	CEN/TS 16931-3-2:2020	Gömme destekli
PDF/A-3 ilişkili dosyası	ISO 19005-3:2012 §6.7.8	Taşıyıcı destekli
PDF/A-4f gömülü dosyası	ISO 19005-4:2020 Annex A	Taşıyıcı destekli

Bu tablo, NextPDF Enterprise’ın karşı geliştirildiği spesifikasyonları ve neyi denetlediğini kaydeder. Bir sertifikasyon, vergi-otoritesi onayı veya düzenleyici yeterlilik beyanı değildir. Fatura düzenleyeni, ilgili mevzuatın kurallarını karşılamaktan sorumludur; bu, bir vergi-otoritesi doğrulayıcısı değildir.

FIPS modu davranışı

Bu modül hiçbir kriptografik imzalama yapmaz. Bir karma faturayı imzalama ve FIPS modu anahtar muhafazası burada kapsam dışıdır; Signature modülüne bakın.

Tehdit modeli

Güvenilmeyen fatura XML’i birincil girdidir. Azaltmalar: XXE-güvenli ayrıştırma, DOCTYPE reddi, sınırlı açma, ağ ve dosya kaynak yüklemesi devre dışı bir XSLT işlemcisi ve iddia sentezinin olmaması — çağıran, fatura içeriğini sağlar ve ona sahiptir.

Davranış sözleşmesi

• ZugferdEmbedder / PeppolEmbedder, çağıranın sağladığı fatura XML’ini bir PDF/A-4f veya PDF/A-3b taşıyıcısına iliştirir; NextPDF hiçbir zaman fatura XML’i sentezlemez.
• InvoiceXmlValidator, COMPAT (varsayılan; sınırdaki EN 16931 önem sayısı bir uyarıdır) veya STRICT (BT-24 önem sayısı sert bir hatadır) kipinde çalışır.
• SchematronValidator, önceden derlenmiş kural kümelerini süreç içi XSLT işlemcisi üzerinden yürütür ve SVRL bulgularını ayrıştırır; boş bir bulgu listesi, uyumsuz bir yükü uyumlu kılmaz.
• Tüm XML ayrıştırma XXE-güvenlidir: harici varlık çözümleme devre dışı, DOCTYPE reddedilir, açma sınırlanmıştır.

Yayın sınırı

Bu sayfa yalnızca dışarıdan gözlemlenebilir davranışı ve desteklenen herkese açık API yüzeyini belgeler. Dahilî ad alanı yolları, yardımcı sınıflar, mekanizma tabloları, runbook dosya adları ve bilet önekleri kapsam dışıdır.

Core yedeği

NextPDF Core, yapılandırılmış faturalar üretmez veya doğrulamaz. Yalnızca Core’lu bir dağıtım bir PDF üretebilir ancak hiçbir ZUGFeRD / Factur-X / Peppol gömmesine, hiçbir EN 16931 doğrulayıcısına ve hiçbir Schematron motoruna sahip değildir.

Pro yedeği

Yalnızca Pro’lu bir dağıtımda desteklenen yüzey, Factur-X / ZUGFeRD yüklerinin Pro katmanı e-fatura algılama ve doğrulamasıdır. Pro, ZUGFeRD / Factur-X veya Peppol-UBL karma taşıyıcıları üretmez, XRechnung CIUS profilini eklemez ve süreç içi Schematron motorunu çalıştırmaz; yalnızca Pro’lu bir dağıtımda üretim, XRechnung CIUS profili veya Schematron isteyen bir yapılandırmanın bunu karşılayacak hiçbir Enterprise bileşeni yoktur. Pro algılama ve doğrulama yüzeyi için Pro Compliance sayfasına bakın.

Enterprise sınır notu

Dahilî mekanizma ayrıntısı, kaynak deposunun dahilî belgelerinde kalır ve bu kılavuzun kapsamı dışındadır.

Dağıtım sınırı

Schematron motoru ext-xsl PHP uzantısını gerektirir; onu sağlama ve etkinleştirme operatörün sorumluluğundadır. İşleme süreç içi ve yereldir; modül gömme veya doğrulama sırasında hiçbir giden ağ çağrısı yapmaz. Ulusal e-fatura taşıması, takas platformları ve arşivleme sistemleri bu modülün dışındadır ve operatörün sorumluluğundadır.

Hukuki uygunluk sınırı

NextPDF, EN 16931’de tanımlanan veri modeline uygun yapılandırılmış faturalar üretir ve kural bulgularını raporlar. “Yasal olarak uyumlu faturalar” üretmez, “vergi-otoritesince onaylanmış” çıktı sağlamaz ve herhangi bir faturanın bir vergi otoritesi, mahkeme veya sicil tarafından kabul edileceğini garanti etmez. Fatura düzenleyeni, ilgili mevzuatın kurallarını karşılamaktan sorumludur; bu, bir vergi-otoritesi doğrulayıcısı değildir. Ulusal e-fatura platformları, takas modelleri, arşivleme zorunlulukları ve dijital-imza gereksinimleri yargı bölgesine göre değişir ve düzenleyenin sorumluluğundadır. Vergi ve hukuk danışmanlarınıza başvurun.

Ayrıca bakınız

• Invoice reference — gömücüler, doğrulayıcılar ve Schematron motoru için API düzeyinde referans.
• Pro Compliance — Pro katmanı e-fatura algılama ve doğrulama.
• Document E-Filing — mahkeme/sicil teslim optimizasyonu.
• Enterprise overview
• Core, Pro ve Enterprise özellik matrisi