PHPackages                             vinelabs-de/xrechnung-kit - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. vinelabs-de/xrechnung-kit

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

vinelabs-de/xrechnung-kit
=========================

EN 16931 / XRechnung 3.0 compliant e-invoice generator and validator. Framework-agnostic core.

v2.1.0(1mo ago)052↓48.4%MITPHPPHP ^8.1

Since May 9Pushed 3w agoCompare

[ Source](https://github.com/vinelabs-de/xrechnung-kit)[ Packagist](https://packagist.org/packages/vinelabs-de/xrechnung-kit)[ Docs](https://github.com/vineethkrishnan/xrechnung-kit)[ RSS](/packages/vinelabs-de-xrechnung-kit/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (1)Versions (4)Used By (0)

xrechnung-kit
=============

[](#xrechnung-kit)

> EN 16931 / XRechnung 3.0 compliant e-invoice generator and validator for PHP. Framework-agnostic core.

[![Packagist](https://camo.githubusercontent.com/9f5d870305f0ebf62fe18354b7f3a8a7f9dab4046707608bf4f2ccccf6739a3f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f76696e656c6162732d64652f78726563686e756e672d6b69742e737667)](https://packagist.org/packages/vinelabs-de/xrechnung-kit)[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://github.com/vinelabs-de/xrechnung-kit/blob/main/LICENSE)[![PHP Version](https://camo.githubusercontent.com/8aa4a5c50118397a75c657a768dfb8e84ec80f03ffee2bc32e8178ae7c440402/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7068702d253345253344382e312d3838393262662e737667)](https://www.php.net/supported-versions)

This is the framework-agnostic core of [xrechnung-kit](https://github.com/vinelabs-de/xrechnung-kit). It turns a typed PHP value object describing an invoice into a KoSIT-strict valid XRechnung 3.0 / EN 16931 XML document, validates the output in memory before writing to disk, and quarantines invalid output.

This package is intentionally minimal. It has no framework dependencies and no runtime network calls. Framework adapters (Laravel, Symfony, CakePHP, Laminas), platform integrations (TYPO3, Shopware 6, WordPress / WooCommerce, Contenido CMS), and the optional KoSIT Schematron bundle are published as separate packages from the same monorepo.

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

[](#installation)

```
composer require vinelabs-de/xrechnung-kit
```

Optional KoSIT Schematron validation:

```
composer require --dev vineethkrishnan/xrechnung-kit-kosit-bundle
```

Framework adapters:

```
composer require vineethkrishnan/xrechnung-kit-laravel
composer require vineethkrishnan/xrechnung-kit-symfony
composer require vineethkrishnan/xrechnung-kit-cakephp
composer require vineethkrishnan/xrechnung-kit-laminas
```

Platform integrations (CMS and e-commerce):

```
composer require vineethkrishnan/xrechnung-kit-typo3
composer require vineethkrishnan/xrechnung-kit-shopware
composer require vineethkrishnan/xrechnung-kit-wordpress
composer require vineethkrishnan/xrechnung-kit-contenido
```

Quick start
-----------

[](#quick-start)

```
use XrechnungKit\Builder\XRechnungBuilder;
use XrechnungKit\XRechnungGenerator;
use XrechnungKit\XRechnungValidator;

$mappingData = (new MyInvoiceMapper($invoice, $customer))->produce();

$entity = XRechnungBuilder::buildEntity($mappingData);
$generator = new XRechnungGenerator($entity);
$path = $generator->generateXRechnung('/path/to/Invoice_RE-1.xml');

$validator = new XRechnungValidator();
$ok = $validator->validate($path);
```

The generator runs UBL XSD validation in memory before writing. Invalid output lands at `*_invalid.xml` and triggers a deduplicated operator alert.

Document classes supported:

- Standard invoice (UNTDID 380)
- Partial invoice / deposit / Anzahlung (UNTDID 326)
- Caution / security deposit
- Credit note / cancellation (UNTDID 381)
- Deposit cancellation

Requirements
------------

[](#requirements)

- PHP 8.1, 8.2, 8.3, or 8.4
- `ext-libxml`, `ext-dom`, `ext-mbstring`
- Optional `psr/log`
- Java 11+ for KoSIT Schematron validation (only when running `validate-kosit`)

Repository
----------

[](#repository)

Source, issues, docs, and PRs live in the monorepo: [vinelabs-de/xrechnung-kit](https://github.com/vinelabs-de/xrechnung-kit).

This repo (`vinelabs-de/xrechnung-kit`) is an auto-generated split of the monorepo's `core/` subtree, published for Packagist. **Do not open PRs here**; open them against the monorepo.

- Documentation: [xrechnung-kit.vineethnk.in](https://xrechnung-kit.vineethnk.in/)
- API reference: [overview](https://xrechnung-kit.vineethnk.in/reference/api) and [generated per-class reference](https://xrechnung-kit.vineethnk.in/api/)
- Issues: [github.com/vinelabs-de/xrechnung-kit/issues](https://github.com/vinelabs-de/xrechnung-kit/issues)
- Contributing: [CONTRIBUTING.md](https://github.com/vinelabs-de/xrechnung-kit/blob/main/CONTRIBUTING.md)
- Security disclosure: [SECURITY.md](https://github.com/vinelabs-de/xrechnung-kit/blob/main/SECURITY.md)

License
-------

[](#license)

[MIT](https://github.com/vinelabs-de/xrechnung-kit/blob/main/LICENSE). Bundled UBL XSDs and KoSIT scenarios retain their original licenses; see [LICENSE-third-party.md](https://github.com/vinelabs-de/xrechnung-kit/blob/main/LICENSE-third-party.md).

Trademark notice
----------------

[](#trademark-notice)

"XRechnung" is a German federal e-invoicing standard maintained by KoSIT (Koordinierungsstelle fuer IT-Standards). xrechnung-kit is an independent open source library and is neither affiliated with nor endorsed by KoSIT or any German government agency.

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance94

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity44

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 ~1 days

Total

3

Last Release

30d ago

Major Versions

v1.0.0 → v2.0.02026-05-09

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2564213?v=4)[Vineeth N K](/maintainers/vineethkrishnan)[@vineethkrishnan](https://github.com/vineethkrishnan)

---

Top Contributors

[![vineethkrishnan](https://avatars.githubusercontent.com/u/2564213?v=4)](https://github.com/vineethkrishnan "vineethkrishnan (31 commits)")

---

Tags

xrechnunginvoicingublpeppole-invoicingEN16931germany

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vinelabs-de-xrechnung-kit/health.svg)

```
[![Health](https://phpackages.com/badges/vinelabs-de-xrechnung-kit/health.svg)](https://phpackages.com/packages/vinelabs-de-xrechnung-kit)
```

###  Alternatives

[easybill/e-invoicing

A package to read and create EN16931 e-invoices or CIUS like: XRechnung, ZUGFeRD etc.

14144.9k](/packages/easybill-e-invoicing)[josemmo/einvoicing

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

176331.0k3](/packages/josemmo-einvoicing)[num-num/ubl-invoice

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

136887.1k](/packages/num-num-ubl-invoice)[prgayman/laravel-zatca

Laravel package a helper to Generate the QR code and signed it for ZATCA E-invoicing

2929.4k1](/packages/prgayman-laravel-zatca)[horstoeko/zugferdublbridge

Convert Factur-X/ZUGFeRD (CII-Syntax) to PEPPOL (UBL-Syntax) and visa versa

17162.6k7](/packages/horstoeko-zugferdublbridge)

PHPackages © 2026

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