PHPackages                             darvis/ubl-peppol - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. darvis/ubl-peppol

ActiveLibrary[Payment Processing](/categories/payments)

darvis/ubl-peppol
=================

UBL/PEPPOL service voor het genereren van facturen volgens de UBL/PEPPOL standaard

v1.6.0(2mo ago)8824↓50%4[1 issues](https://github.com/ArvidDeJong/ubl-peppol/issues)MITPHPPHP ^8.2CI passing

Since Sep 2Pushed 2mo agoCompare

[ Source](https://github.com/ArvidDeJong/ubl-peppol)[ Packagist](https://packagist.org/packages/darvis/ubl-peppol)[ Docs](https://github.com/ArvidDeJong/ubl-peppol)[ RSS](/packages/darvis-ubl-peppol/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (6)Dependencies (2)Versions (11)Used By (0)

UBL/PEPPOL Service
==================

[](#ublpeppol-service)

[![Latest Version on Packagist](https://camo.githubusercontent.com/26630a9a580dc84a71c549d519f166ad797e17c7cfff83fb512d21625531af5b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6461727669732f75626c2d706570706f6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/darvis/ubl-peppol)[![Total Downloads](https://camo.githubusercontent.com/759a7402d69a64216a67f1d3525ca720eb87302fae8632b87d6fe1677ba8de92/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6461727669732f75626c2d706570706f6c2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/darvis/ubl-peppol)

PHP library for generating UBL 2.1 invoices compliant with PEPPOL BIS Billing 3.0. Supports Belgian (EN 16931) and Dutch implementations.

Installation
------------

[](#installation)

```
composer require darvis/ubl-peppol
```

**Requirements:** PHP 8.2+, DOM extension

Quick Start (Standalone)
------------------------

[](#quick-start-standalone)

```
use Darvis\UblPeppol\UblBeBis3Service;

$ublService = new UblBeBis3Service();
$xml = $ublService->generateInvoice($invoiceData);
file_put_contents('invoice.xml', $xml);
```

See `examples/` for complete implementations.

Laravel Integration
-------------------

[](#laravel-integration)

Additional features: Peppol network integration, logging, artisan commands.

```
php artisan vendor:publish --tag=ubl-peppol-config
php artisan migrate
```

📖 **[Laravel Documentation](docs/laravel-integration.md)**

Documentation
-------------

[](#documentation)

**Authoritative source for PEPPOL rules**

For PEPPOL BIS Billing 3.0 business rules, this project uses the official BIS documentation as the source of truth:

-

When reviewing, interpreting, or updating rule compliance in this package (BE and NL), always consult that BIS page first.

- [API Reference](docs/api-reference.md)
- [Belgian Implementation](docs/belgium-implementation.md)
- [Dutch Implementation](docs/netherlands-implementation.md)
- [VIES VAT Validation](docs/vies-validation.md)
- [Company Registration Validation](docs/company-registration-validation.md)
- [Laravel Integration](docs/laravel-integration.md)
- [Validation](docs/validation.md)
- [Troubleshooting](docs/troubleshooting.md)

Author
------

[](#author)

**Arvid de Jong**
Email:
Website: [arvid.nl](https://arvid.nl)

Contributing
------------

[](#contributing)

Contributions are welcome! Feel free to create issues or submit pull requests.

License
-------

[](#license)

This package is open-source software licensed under the [MIT License](LICENSE).

Credit Notes Support (v1.6.0)
-----------------------------

[](#credit-notes-support-v160)

Generate PEPPOL-compliant Credit Notes with automatic validation:

```
use Darvis\UblPeppol\UblBeBis3Service;

$service = new UblBeBis3Service();
$service->createCreditNoteDocument();  // Not createDocument()!
$service->addCreditNoteHeader('C2026-001', '2026-01-21');
$service->addBillingReference('F2026-050', '2026-01-15'); // REQUIRED (BR-55)
// ... add parties, lines, totals ...
$xml = $service->generateXml();
```

### Key Points

[](#key-points)

- Use `createCreditNoteDocument()` instead of `createDocument()`
- `addBillingReference()` is **REQUIRED** (PEPPOL BR-55)
- All amounts must be **POSITIVE** (credit nature = document type 381)
- Use `addCreditNoteLine()` instead of `addInvoiceLine()`

See [docs/credit-notes.md](docs/credit-notes.md) for full documentation.

###  Health Score

45

—

FairBetter than 92% of packages

Maintenance81

Actively maintained with recent releases

Popularity26

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~23 days

Recently: every ~14 days

Total

8

Last Release

89d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/24c445b7580e09ff72b8340d1423886148c4c8a249d0a828c98285109e7e5663?d=identicon)[darvis](/maintainers/darvis)

---

Top Contributors

[![ArvidDeJong](https://avatars.githubusercontent.com/u/7394837?v=4)](https://github.com/ArvidDeJong "ArvidDeJong (68 commits)")

---

Tags

laravelpeppolphpubllaravelxmlinvoiceublpeppolfactuure-facturatie

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/darvis-ubl-peppol/health.svg)

```
[![Health](https://phpackages.com/badges/darvis-ubl-peppol/health.svg)](https://phpackages.com/packages/darvis-ubl-peppol)
```

###  Alternatives

[num-num/ubl-invoice

A modern object-oriented PHP library to create and read valid UBL and EN 16931/Peppol BIS 3.0 files

135820.5k](/packages/num-num-ubl-invoice)[josemmo/einvoicing

Library for reading and creating European-compliant electronic invoices (EN 16931)

173279.6k2](/packages/josemmo-einvoicing)[cleverit/ubl_invoice

A PHP wrapper for UBL invoices

36283.4k](/packages/cleverit-ubl-invoice)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)