laravel-peppol maintained by intragile
Laravel Peppol
Developed and maintained by IntrAgile Kft.
Peppol for Laravel: send and receive Peppol BIS Billing 3.0 invoices through an access point, with queued sending, signed webhooks and validation before every send.
This is a thin metapackage: it has no code of its own and pulls in intragile/laravel-einvoicing so that you can find it; the bridge brings the rule packages. 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-peppol
Install the Peppol BIS validation rules and give the default transport its credentials (Recommand shown; B2Brouter and e-invoice.be are configured the same way, see the full documentation):
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('invoice.xml'); // Peppol BIS Billing 3.0 UBL
// Queued; validated before the send claims the row; one send, never two.
$message = EInvoicing::send($xml, reference: 'INV-2026-0001');
// Use a connection other than the default one:
EInvoicing::send($xml, reference: 'INV-2026-0002', transport: 'b2brouter');
$message->state; // OutboundState: queued, sending, sent, delivered, ...
The invoice carries its own routing (sender, receiver, process) and must be Peppol BIS Billing 3.0 (or an XRechnung sent over Peppol); send() refuses anything else. A send whose outcome is unknown is never resent automatically. Receiving invoices (signed webhooks, or polling with php artisan einvoicing:poll-inbound) is covered in the laravel-einvoicing documentation.
Drivers
| Driver | Status |
|---|---|
Recommand (recommand) |
live-tested on the Peppol test network |
B2Brouter (b2brouter) |
live-tested against the provider sandbox (simulated network) |
e-invoice.be (einvoicebe) |
live-tested against the provider sandbox (simulated network) |
More providers are planned. A test against a provider sandbox that simulates the network proves the provider's API contract, not delivery over Peppol; only Recommand can reach the Peppol test network. Provider details are in the full documentation.
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).
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.