Search by

intragile / laravel-peppol

intragile

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.

Package info

github.com/intragile/laravel-peppol

Homepage

Type:metapackage

pkg:composer/intragile/laravel-peppol

Statistics

Installs: 7

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

v1.0.0 2026-11-16 19:44 UTC

This package is auto-updated.

Last update: 2026-11-16 20:17:01 UTC


README

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.