intragile / laravel-xrechnung
Laravel XRechnung: create, validate and send German XRechnung 3.0 e-invoices (UBL and CII) with the KoSIT rules, over Peppol, on top of intragile/laravel-einvoicing.
Package info
github.com/intragile/laravel-xrechnung
Type:metapackage
pkg:composer/intragile/laravel-xrechnung
Requires
- php: ^8.3
- intragile/einvoicing-rules-xrechnung: ^1.0
- intragile/laravel-einvoicing: ^1.0
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Developed and maintained by IntrAgile Kft.
XRechnung 3.0 for Laravel: validate German e-invoices (UBL and CII) with the official KoSIT rules and send them over Peppol.
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,zlib - Laravel 12 or 13
Quick start
composer require intragile/laravel-xrechnung
Install the Peppol validation rules (the default validator loads them even when you send only XRechnung documents) and set the transport you send through:
php artisan einvoicing:install-rules
php artisan migrate # create the two tables
EINVOICING_TRANSPORT=recommand RECOMMAND_API_KEY_ID=key_... RECOMMAND_API_SECRET=secret_... RECOMMAND_COMPANY_ID=c_...
Check the installation:
php artisan einvoicing:doctor
Usage:
use IntrAgile\EInvoicing\Laravel\Facades\EInvoicing; $xml = file_get_contents('xrechnung.xml'); // XRechnung 3.0 as UBL or CII $report = EInvoicing::xrechnung()->validate($xml); // KoSIT rules if (! $report->isValid()) { throw new RuntimeException('The XRechnung is invalid.'); } // Queued, validated again before sending, then delivered over Peppol. $message = EInvoicing::send($xml, reference: 'RE-2026-0815');
The invoice carries its own routing (sender, receiver and process) and XRechnung process control; send() refuses anything else. Sending is over Peppol; this package does not submit to a Leitweg-ID portal.
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-xrechnung 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.