Faktur

Sekilas pandang

NextPDF Enterprise menghasilkan faktur hibrida terstruktur ZUGFeRD / Factur-X / Peppol-UBL dan memvalidasi XML faktur terhadap model data EN 16931 serta kumpulan aturan Schematron. Modul ini menghasilkan faktur terstruktur yang sesuai dengan model data yang didefinisikan dalam EN 16931; ia bukan validator otoritas pajak dan tidak menyertifikasi dokumen apa pun.

Ketersediaan & lisensi

Kapabilitas ini dikirimkan dalam NextPDF Enterprise (nextpdf/enterprise) dan diaktifkan dengan envelope lisensi tingkat-Enterprise. Penerapan tanpa entitlement tersebut tidak memuat class kapabilitas ini. Bandingkan edisi dan dapatkan lisensi.

Pemasangan

composer require nextpdf/enterprise:^3

Mesin Schematron menggunakan ekstensi PHP ext-xsl. Pasang dan aktifkan ekstensi tersebut sebelum menjalankan validasi Schematron.

Tinjauan konseptual

Modul Invoice memiliki tiga permukaan independen: penyematan faktur terstruktur, validasi XML EN 16931, dan eksekusi aturan Schematron.

Penyematan. ZugferdEmbedder melampirkan payload XML UN/CEFACT CII ZUGFeRD 2.4 / Factur-X 1.08 yang disediakan pemanggil ke pembawa PDF/A, menghasilkan faktur hibrida. Dua format pembawa didukung: PDF/A-4f (ISO 19005-4:2020), pembawa modern yang lebih disukai, dan PDF/A-3b (ISO 19005-3:2012) untuk kompatibilitas mundur. ZugferdXmpSchema menyuntikkan deklarasi extension-schema XMP Factur-X yang dibutuhkan pembawa. PeppolEmbedder menjalankan peran yang sama untuk XML faktur atau nota kredit UBL 2.1 Peppol BIS Billing 3.0 yang disediakan pemanggil, melampirkannya dengan relasi associated-file dan tipe MIME yang benar. NextPDF tidak mensintesis XML faktur; pemanggil menyediakan XML yang valid dan tetap menjadi penerbit faktur.

Validasi. InvoiceXmlValidator memeriksa XML faktur terhadap model data semantik EN 16931 dan ekspektasi kontainer ZUGFeRD / Factur-X, termasuk pengidentifikasi spesifikasi BT-24 yang diwajibkan oleh aturan bisnis EN 16931 BR-1. Validator berjalan dalam salah satu dari dua mode: COMPAT (default; temuan kardinalitas EN 16931 yang ambang dilaporkan sebagai peringatan untuk menjaga kompatibilitas mundur bagi fixture yang ada) dan STRICT (kardinalitas BT-24 adalah error keras, mencerminkan semantik validator eksternal). Mode dapat dipilih per panggilan, melalui penggantian environment, atau melalui kebijakan kesesuaian.

Schematron. SchematronValidator menjalankan kumpulan aturan Schematron yang telah dikompilasi sebelumnya (aturan .sch CEN EN 16931 yang dikompilasi ke XSLT saat build) terhadap XML faktur menggunakan prosesor XSLT PHP in-process, dan mengurai laporan SVRL menjadi temuan terstruktur. Enum ZugferdProfile memodelkan profil kesesuaian — MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED, dan CIUS XRechnung B2G Jerman atas EN 16931.

Apa yang diklaim dan tidak diklaim modul ini

Modul ini menghasilkan dan memeriksa data faktur terstruktur. Modul ini tidak menyatakan bahwa dokumen apa pun merupakan faktur yang sah secara hukum, bahwa dokumen tersebut disetujui otoritas pajak, atau bahwa dokumen tersebut dijamin diterima oleh otoritas mana pun.

• Validator memeriksa model semantik EN 16931 dan kontainer ZUGFeRD / Factur-X / UBL saja. Validator ini bukan validator otoritas pajak. Ekstensi nasional dan platform clearance — misalnya SDI Italia, Chorus Pro Prancis, transport XRechnung Jerman — berada di luar cakupan pada tingkat transport.
• Sebagaimana dinyatakan oleh EN 16931-1 itu sendiri, model semantik inti membawa informasi esensial yang dibutuhkan sebuah faktur elektronik untuk mendukung kepatuhan hukum dan fiskal; penerbit faktur bertanggung jawab memenuhi aturan legislasi yang berlaku. Ini bukan validator otoritas pajak.
• Dukungan terhadap suatu standar tidak sama dengan kesesuaian terhadapnya. Konsultasikan dengan penasihat pajak dan kepatuhan Anda untuk menilai kecukupan regulasi di yurisdiksi Anda.

Mengapa cara kerjanya demikian

Modul ini secara sengaja tidak pernah mensintesis XML faktur. Penyematan, validasi EN 16931, dan eksekusi Schematron adalah tiga permukaan independen atas XML yang disediakan dan dimiliki pemanggil. Ini menjaga NextPDF sebagai produser dan pemeriksa, tidak pernah penerbit, karena tanggung jawab hukum tidak dapat didelegasikan ke sebuah library. Validasi default ke COMPAT, sehingga temuan kardinalitas yang ambang adalah peringatan alih-alih regresi. STRICT bersifat opt-in ketika Anda membutuhkan semantik validator eksternal. Hasilnya adalah pemisahan yang bersih: NextPDF melaporkan apa yang diamatinya, dan penerbit memutuskan apakah dokumen memenuhi hukum. Latar belakang desain: Faktur dan e-invoicing.

Permukaan API

Class	Responsibility
ZugferdEmbedder	Melampirkan XML CII ZUGFeRD / Factur-X ke pembawa PDF/A-4f atau PDF/A-3b.
ZugferdXmpSchema	Menyuntikkan deklarasi extension-schema XMP Factur-X.
ZugferdProfile	Enum profil kesesuaian (MINIMUM … EXTENDED, XRECHNUNG).
PeppolEmbedder	Melampirkan XML faktur / nota kredit UBL Peppol BIS 3.0 ke pembawa PDF/A.
InvoiceXmlValidator	Memeriksa XML terhadap model data EN 16931; mode COMPAT atau STRICT.
InvoiceValidatorMode	Enum mode validasi: COMPAT (default) atau STRICT.
SchematronValidator	Menjalankan kumpulan aturan Schematron pra-kompilasi; mengurai temuan SVRL.
InvoiceValidationResult / SchematronResult	Hasil terstruktur: profil, temuan, severity.

Contoh kode — Mulai cepat

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

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

Contoh kode — Produksi

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.

Kasus tepi & jebakan

• PDF yang well-formed namun tidak membawa payload faktur yang dikenali menghasilkan hasil “bukan faktur” alih-alih melempar.
• COMPAT adalah mode validasi default: pengidentifikasi spesifikasi BT-24 yang hilang dilaporkan sebagai peringatan, sehingga lokasi pemanggilan yang menggerbang pada bendera validitas boolean tidak mengalami regresi. Gunakan STRICT untuk menjadikan BT-24 sebagai error keras yang cocok dengan semantik KoSIT / Mustang eksternal.
• Pemanggil menyediakan XML faktur. NextPDF tidak menghasilkan atau memperbaikinya; daftar temuan kosong tidak menjadikan payload yang tidak sesuai menjadi sesuai.
• Mesin Schematron membutuhkan ext-xsl. Kumpulan aturan dikompilasi saat build; runtime hanya mengeksekusi XSLT pra-kompilasi.

Kinerja

Biaya validasi berskala dengan ukuran XML tersemat dan jumlah aturan Schematron. Biaya penyematan berskala dengan ukuran pembawa dan didominasi oleh serialisasi PDF/A. Anggaran kinerja halaman mencerminkan rendering dokumentasi, bukan throughput faktur.

Catatan keamanan

Semua penguraian XML melewati penjaga XML yang diperkuat: resolusi entitas eksternal dinonaktifkan (aman dari XXE), DOCTYPE ditolak, dan dekompresi dibatasi. Prosesor XSLT berjalan dengan pemuatan sumber daya jaringan dan sistem berkas dinonaktifkan dan tidak pernah mendaftarkan fungsi PHP, sehingga document(), xsl:include, xsl:import, dan result-document tidak dapat menjangkau jaringan atau disk. Perlakukan XML faktur dari sumber yang tidak tepercaya sebagai berbahaya.

Residensi data & mitigasi PII

XML faktur dapat memuat data pribadi, komersial, dan finansial. Pemrosesan bersifat in-process dan lokal; modul tidak melakukan panggilan jaringan keluar selama penyematan atau validasi. Terapkan kontrol retensi dan minimisasi Anda sendiri pada XML dan temuan yang diekstraksi.

Telemetri aman & penghapusan data log

Temuan dan log validasi dapat mencakup pengidentifikasi aturan dan nilai tag. Keduanya tidak mencakup payload faktur lengkap. Bersihkan atau lakukan redaksi pada nilai bidang sebelum meneruskan log ke sink bersama jika nilai tersebut sensitif.

Konformitas

Behavior	Reference	Status
Model semantik faktur inti	EN 16931-1:2026 §4	Dibangun terhadapnya; penerbit tetap bertanggung jawab atas legislasi yang berlaku
Pengidentifikasi spesifikasi (BT-24)	EN 16931-1:2026 BR-1	Diperiksa (peringatan di COMPAT, error di STRICT)
Binding sintaks UN/CEFACT CII	CEN/TS 16931-3-3:2020	Penyematan didukung
Binding sintaks UBL 2.1	CEN/TS 16931-3-2:2020	Penyematan didukung
Berkas terasosiasi PDF/A-3	ISO 19005-3:2012 §6.7.8	Pembawa didukung
Berkas tersemat PDF/A-4f	ISO 19005-4:2020 Annex A	Pembawa didukung

Tabel ini mencatat spesifikasi yang menjadi dasar pembangunan NextPDF Enterprise dan apa yang diperiksanya. Tabel ini bukan pernyataan sertifikasi, persetujuan otoritas pajak, atau kecukupan regulasi. Penerbit faktur bertanggung jawab memenuhi aturan legislasi yang berlaku; ini bukan validator otoritas pajak.

Perilaku mode FIPS

Modul ini tidak melakukan penandatanganan kriptografis. Penandatanganan faktur hibrida dan penyimpanan kunci mode FIPS berada di luar cakupan di sini; lihat modul Signature.

Model ancaman

XML faktur yang tidak tepercaya adalah masukan utamanya. Mitigasi: penguraian aman dari XXE, penolakan DOCTYPE, dekompresi terbatas, prosesor XSLT dengan pemuatan sumber daya jaringan dan berkas dinonaktifkan, serta tanpa sintesis klaim — pemanggil menyediakan dan memiliki konten faktur.

Kontrak perilaku

• ZugferdEmbedder / PeppolEmbedder melampirkan XML faktur yang disediakan pemanggil ke pembawa PDF/A-4f atau PDF/A-3b; NextPDF tidak pernah mensintesis XML faktur.
• InvoiceXmlValidator berjalan dalam COMPAT (default; kardinalitas EN 16931 yang ambang adalah peringatan) atau STRICT (kardinalitas BT-24 adalah error keras).
• SchematronValidator mengeksekusi kumpulan aturan pra-kompilasi melalui prosesor XSLT in-process dan mengurai temuan SVRL; daftar temuan kosong tidak menjadikan payload yang tidak sesuai menjadi sesuai.
• Semua penguraian XML aman dari XXE: resolusi entitas eksternal dinonaktifkan, DOCTYPE ditolak, dekompresi dibatasi.

Batas publikasi

Halaman ini hanya mendokumentasikan perilaku yang dapat diamati dari luar dan permukaan API publik yang didukung. Jalur namespace internal, class helper, tabel mekanisme, nama berkas runbook, dan prefiks tiket berada di luar cakupan.

Fallback Core

NextPDF Core tidak menghasilkan atau memvalidasi faktur terstruktur. Penerapan Core-saja dapat menghasilkan PDF tetapi tidak memiliki penyematan ZUGFeRD / Factur-X / Peppol, tidak ada validator EN 16931, dan tidak ada mesin Schematron.

Fallback Pro

Pada penerapan Pro-saja, permukaan yang didukung adalah deteksi dan validasi e-invoice tingkat-Pro atas payload Factur-X / ZUGFeRD. Pro tidak menghasilkan pembawa hibrida ZUGFeRD / Factur-X atau Peppol-UBL, tidak menambahkan profil CIUS XRechnung, dan tidak menjalankan mesin Schematron in-process; konfigurasi yang meminta pembuatan, profil CIUS XRechnung, atau Schematron pada penerapan Pro-saja tidak memiliki komponen Enterprise untuk memenuhinya. Lihat Pro Compliance untuk permukaan deteksi dan validasi Pro.

Catatan batas Enterprise

Detail mekanisme internal tetap berada dalam dokumentasi internal repositori sumber dan berada di luar cakupan manual ini.

Batas penyebaran

Mesin Schematron membutuhkan ekstensi PHP ext-xsl; penyediaan dan pengaktifannya adalah tanggung jawab operator. Pemrosesan bersifat in-process dan lokal; modul tidak melakukan panggilan jaringan keluar selama penyematan atau validasi. Transport e-invoicing nasional, platform clearance, dan sistem pengarsipan berada di luar modul ini dan menjadi tanggung jawab operator.

Batas kepatuhan hukum

NextPDF menghasilkan faktur terstruktur yang sesuai dengan model data yang didefinisikan dalam EN 16931 dan melaporkan temuan aturan. NextPDF tidak menghasilkan “faktur yang sah secara hukum”, tidak menyediakan keluaran “yang disetujui otoritas pajak”, dan tidak menjamin bahwa faktur apa pun akan diterima oleh otoritas pajak, pengadilan, atau registri. Penerbit faktur bertanggung jawab memenuhi aturan legislasi yang berlaku; ini bukan validator otoritas pajak. Platform e-invoicing nasional, model clearance, mandat pengarsipan, dan persyaratan tanda tangan digital bervariasi menurut yurisdiksi dan menjadi tanggung jawab penerbit. Konsultasikan dengan penasihat pajak dan hukum Anda.

Lihat juga

• Rujukan Invoice — rujukan tingkat-API untuk embedder, validator, dan mesin Schematron.
• Pro Compliance — deteksi dan validasi e-invoice tingkat-Pro.
• Document E-Filing — optimasi pengiriman ke pengadilan/registri.
• Ringkasan Enterprise
• Matriks fitur Core vs Pro vs Enterprise