Looking to hire Laravel developers? Try LaraJobs

laravel-peppol maintained by intragile

Description
Laravel Peppol: send and receive Peppol BIS Billing 3.0 e-invoices through an access point (Recommand, B2Brouter, e-invoice.be) with queued sending, webhooks and validation, on top of intragile/laravel-einvoicing.
Last update
2026/11/16 20:44 (dev-main)
License
Downloads
0

Comments
comments powered by Disqus

Laravel Peppol

Developed and maintained by IntrAgile Kft.

Install Latest Version PHP License

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.