laravel-zugferd maintained by intragile
Laravel ZUGFeRD / Factur-X
Developed and maintained by IntrAgile Kft.
ZUGFeRD 2.x and Factur-X 1.0 for Laravel: embed the invoice XML into your PDF/A-3 and validate every profile, in pure PHP.
This is a thin metapackage: it has no code of its own and pulls in intragile/laravel-einvoicing together with the rule package this use case needs, so that you can find it. The full functionality is documented there.
Magyar nyelvű leírás → README.hu.md
Requirements
- PHP 8.3+ with
dom,libxml,mbstring(andzlibfor PDF) - Laravel 12 or 13
Quick start
composer require intragile/laravel-zugferd
Nothing needs configuring to write, read and validate: the Factur-X rules ship in the installed rule package. You supply the PDF/A-3 (rendering the PDF is not part of the library). The doctor also checks the default validator, which loads the Peppol rules, so install them once. Set a transport only if you also send over Peppol (see the full documentation).
php artisan einvoicing:install-rules
php artisan migrate # create the two tables
Check the installation:
php artisan einvoicing:doctor
Usage:
use IntrAgile\EInvoicing\Laravel\Facades\EInvoicing;
use IntrAgile\EInvoicing\Syntax\FacturX\{FacturXPdfWriter, FacturXProfile, FacturXXmlWriter};
use IntrAgile\EInvoicing\Syntax\Ubl\UblReader;
$invoice = (new UblReader)->read(file_get_contents('invoice.xml'))->invoice; // or one you built
$xml = (new FacturXXmlWriter)->write($invoice, FacturXProfile::En16931)->xml;
$report = EInvoicing::facturx()->validate($xml);
if (! $report->isValid()) {
throw new RuntimeException('The Factur-X XML is invalid.');
}
$pdf = (new FacturXPdfWriter)->embed($pdfA3Bytes, $xml)->pdf; // $pdfA3Bytes: the PDF/A-3 you rendered
file_put_contents('invoice.pdf', $pdf);
The library does not convert to PDF/A: give it a PDF/A-3 input. The profiles are MINIMUM, BASIC WL, BASIC, EN 16931, EXTENDED and XRECHNUNG; the format is verified offline against the official files and tools, not in live exchanges.
What it pulls in
intragile/laravel-einvoicing (the Laravel bridge, MIT), which brings the engine intragile/php-einvoicing (MIT) and the rule packages intragile/einvoicing-rules-en16931 (EUPL-1.2), intragile/einvoicing-rules-xrechnung (Apache-2.0) and intragile/einvoicing-rules-facturx (Apache-2.0). intragile/einvoicing-rules-facturx is required directly as well.
The metapackage itself is MIT-licensed and ships no code; each pulled package keeps its own licence.
Full documentation
Full documentation: laravel-einvoicing
License
MIT. See LICENSE.
Developed and maintained by IntrAgile Kft.