PHPackages                             horstoeko/zugferd - 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. horstoeko/zugferd

ActivePackage[Payment Processing](/categories/payments)

horstoeko/zugferd
=================

A library for creating and reading european electronic invoices

v1.0.122(1mo ago)4174.3M—9.2%6713MITPHPPHP &gt;=7.3CI passing

Since Oct 24Pushed 2w ago22 watchersCompare

[ Source](https://github.com/horstoeko/zugferd)[ Packagist](https://packagist.org/packages/horstoeko/zugferd)[ Docs](https://github.com/horstoeko/zugferd)[ RSS](/packages/horstoeko-zugferd/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (44)Versions (144)Used By (13)

ZUGFeRD/XRechnung/Factur-X
==========================

[](#zugferdxrechnungfactur-x)

Status
------

[](#status)

[![Latest Stable Version](https://camo.githubusercontent.com/7d1e30a42ea3a0bbde856ba02da83f740d0253654bfb3c76f6ed276216e88275/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f686f7273746f656b6f2f7a7567666572642e7376673f7374796c653d706c6173746963)](https://packagist.org/packages/horstoeko/zugferd)[![PHP version](https://camo.githubusercontent.com/693343507cb7dae83b6ba339b7558ca1733bb0bee6e601e4c61bbd2566551011/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f686f7273746f656b6f2f7a7567666572642e7376673f7374796c653d706c6173746963)](https://packagist.org/packages/horstoeko/zugferd)[![License](https://camo.githubusercontent.com/a3ae192c92b1f10395ab706e44505a2c8394809674b44e13f88cea5cd177453e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f686f7273746f656b6f2f7a7567666572642e7376673f7374796c653d706c6173746963)](https://packagist.org/packages/horstoeko/zugferd)

[![Continuous Integration](https://github.com/horstoeko/zugferd/actions/workflows/build.ci.yml/badge.svg?branch=master)](https://github.com/horstoeko/zugferd/actions/workflows/build.ci.yml)[![Release Status](https://github.com/horstoeko/zugferd/actions/workflows/build.release.yml/badge.svg)](https://github.com/horstoeko/zugferd/actions/workflows/build.release.yml)

Searching for contributors
--------------------------

[](#searching-for-contributors)

Important

Zukunft / Nachfolger-Projekt
----------------------------

[](#zukunft--nachfolger-projekt)

Dieses Projekt hat lange gute Dienste geleistet, aber die Codebasis ist inzwischen in die Jahre gekommen – es ist Zeit für eine grundlegende Modernisierung.

**Keine Sorge:** `horstoeko/zugferd` wird weiterhin betreut. Ich werde bestmöglich Bugfixes liefern und Pull Requests prüfen, sodass bestehende Anwender sich weiterhin darauf verlassen können.

Parallel entsteht eine neue, modernere Codebasis. Sie wird einen **Legacy-Support** erhalten, damit die Migration für bestehende Nutzer so reibungslos wie möglich abläuft.

Ich suche einfach **helfende Hände**, die mich wegen **Zeitmangels** bei der Weiterentwicklung und Pflege unterstützen können – ganz egal ob Code, Tests, Doku, Reviews, Beispiele, Issue-Triage oder einfach Feedback.

**Kontakt (gern auch unverbindlich):** Schreib kurz, wobei du unterstützen möchtest und wie viel Zeit du grob hast.

Important

Future / Successor project
--------------------------

[](#future--successor-project)

This project has served well for a long time, but the codebase is getting old and it’s time for a major modernization.

**No worries:** `horstoeko/zugferd` will continue to be maintained. I will keep providing best-effort bugfixes and reviewing PRs so existing users can continue to rely on it.

In parallel, a new, modern codebase is being built. It will include **legacy support** to make migration as smooth as possible for current users.

I’m simply looking for **helping hands** because my time is limited — whether it’s code, tests, docs, reviews, examples, issue triage, or just feedback.

**Contact (also just for an informal chat):** Please share what you’d like to help with and roughly how much time you have.

Table of Contents
-----------------

[](#table-of-contents)

- [License](#license)
- [Overview](#overview)
- [Supported profiles](#supported-profiles)
- [Further information](#further-information)
- [Related projects](#related-projects)
- [Dependencies](#dependencies)
- [Resources](#resources)
- [Guide](#guide)

License
-------

[](#license)

The code in this project is provided under the [MIT](https://opensource.org/licenses/MIT) license.

Overview
--------

[](#overview)

With `horstoeko/zugferd` you can read and write xml files containing electronic invoice data in the Minimum-, Basic-, EN16931-, Extended- and XRechnung Profile. In addition, it is possible to attach the XML data to an existing PDF file, which was created from an ERP system, for example. If both an XML file (or XML string) and a PDF file (or a PDF in the form of a string) exist, then a compliant PDF file with attachment can be created using the `ZugferdDocumentPdfMerger` class.

**The advantage of this library is that you don't have to worry about whether a particular XML element exists in a desired profile - you can use the same program code for all supported profiles.**

Supported profiles
------------------

[](#supported-profiles)

- EN16931 Minimum
- EN16931 Basic
- EN16931 Basic WL
- EN16931 Comfort
- EN16931 Extended
- EN16931 XRechnung 1.x
- EN16931 XRechnung 2.x
- EN16931 XRechnung 3.x

Important

This package provides only support for CII-Syntax - not UBL-Syntax

Further information
-------------------

[](#further-information)

- [ZUGFeRD](https://de.wikipedia.org/wiki/ZUGFeRD) (German)
- [XRechnung](https://de.wikipedia.org/wiki/XRechnung) (German)
- [Factur-X](http://fnfe-mpe.org/factur-x/factur-x_en) (France)

Related projects
----------------

[](#related-projects)

- [ZUGFeRD Visualizer](https://github.com/horstoeko/zugferdvisualizer)
- [ZUGFeRD Laravel](https://github.com/horstoeko/zugferd-laravel)
- [ZUGFeRD UBL Bridge](https://github.com/horstoeko/zugferdublbridge)
- [ZUGFeRD Mail](https://github.com/horstoeko/zugferdmail)
- [Order-X](https://github.com/horstoeko/orderx)

Dependencies
------------

[](#dependencies)

This package makes use of

- [JMS Serializer](http://jmsyst.com/libs/serializer)
- [Xsd2Php](https://github.com/goetas-webservices/xsd2php)
- [FPDF](https://github.com/Setasign/FPDF)
- [FPDI](https://github.com/Setasign/FPDI).

Resources
---------

[](#resources)

- [Official documentaries (Version Archive)](https://www.ferd-net.de/ueber-uns/ressourcen-1/veroeffentlichungen)

Guide
-----

[](#guide)

For detailed explanation you may have a look in the [examples](https://github.com/horstoeko/zugferd/tree/master/examples)of this package, the documentation attached to every release or our [wiki](https://github.com/horstoeko/zugferd/wiki).

The following parts are documentated in our [Wiki](https://github.com/horstoeko/zugferd/wiki/Configuration):

- [Installation](https://github.com/horstoeko/zugferd/wiki/Installation)
- [Configuration](https://github.com/horstoeko/zugferd/wiki/Configuration)
- [Read a xml file](https://github.com/horstoeko/zugferd/wiki/Reading-XML-Documents)
- [Read a pdf file with attached xml file](https://github.com/horstoeko/zugferd/wiki/Reading-PDF-Documents)
- [Write a xml file](https://github.com/horstoeko/zugferd/wiki/Creating-XML-Documents)
- [Write a pdf file with attached xml file file](https://github.com/horstoeko/zugferd/wiki/Creating-PDF-Documents)
- [Merge existing PDF and XML](https://github.com/horstoeko/zugferd/wiki/Merging-XML-and-PDF-Documents)
- [Validation](https://github.com/horstoeko/zugferd/wiki/Validation)

###  Health Score

69

—

FairBetter than 100% of packages

Maintenance93

Actively maintained with recent releases

Popularity65

Solid adoption and visibility

Community40

Growing community involvement

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 66.7% 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 ~14 days

Recently: every ~26 days

Total

139

Last Release

55d ago

Major Versions

v0.1.28 → v1.0.12020-11-26

PHP version history (6 changes)v0.1.22PHP ^7

v1.0.9PHP ^7.3|^8.0|^8.1

v1.0.17PHP ^7.3|^7.4|^8.0|^8.1

v1.0.33PHP ^7.3|^7.4|^8

v1.0.74PHP &gt;=7.3

v1.0.121PHP &gt;=7.3 &lt;9.0

### Community

Maintainers

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

---

Top Contributors

[![horstoeko](https://avatars.githubusercontent.com/u/2326713?v=4)](https://github.com/horstoeko "horstoeko (160 commits)")[![danielmarschall](https://avatars.githubusercontent.com/u/28412477?v=4)](https://github.com/danielmarschall "danielmarschall (16 commits)")[![alpham8](https://avatars.githubusercontent.com/u/11745001?v=4)](https://github.com/alpham8 "alpham8 (12 commits)")[![OLLIVAULT](https://avatars.githubusercontent.com/u/169679285?v=4)](https://github.com/OLLIVAULT "OLLIVAULT (12 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (8 commits)")[![wundii](https://avatars.githubusercontent.com/u/58734845?v=4)](https://github.com/wundii "wundii (8 commits)")[![Schrank](https://avatars.githubusercontent.com/u/379680?v=4)](https://github.com/Schrank "Schrank (3 commits)")[![kohlerdominik](https://avatars.githubusercontent.com/u/18621527?v=4)](https://github.com/kohlerdominik "kohlerdominik (3 commits)")[![c-schmitz](https://avatars.githubusercontent.com/u/1364282?v=4)](https://github.com/c-schmitz "c-schmitz (2 commits)")[![DKhalil](https://avatars.githubusercontent.com/u/497250?v=4)](https://github.com/DKhalil "DKhalil (2 commits)")[![kevinpapst](https://avatars.githubusercontent.com/u/533162?v=4)](https://github.com/kevinpapst "kevinpapst (2 commits)")[![wurst-hans](https://avatars.githubusercontent.com/u/56444979?v=4)](https://github.com/wurst-hans "wurst-hans (2 commits)")[![briceflaceliere](https://avatars.githubusercontent.com/u/5811531?v=4)](https://github.com/briceflaceliere "briceflaceliere (2 commits)")[![mmethner](https://avatars.githubusercontent.com/u/958868?v=4)](https://github.com/mmethner "mmethner (1 commits)")[![nikbobbie](https://avatars.githubusercontent.com/u/137070037?v=4)](https://github.com/nikbobbie "nikbobbie (1 commits)")[![En0Ma1259](https://avatars.githubusercontent.com/u/30216825?v=4)](https://github.com/En0Ma1259 "En0Ma1259 (1 commits)")[![gaertnermarkus](https://avatars.githubusercontent.com/u/3882322?v=4)](https://github.com/gaertnermarkus "gaertnermarkus (1 commits)")[![simonsolutions](https://avatars.githubusercontent.com/u/20499623?v=4)](https://github.com/simonsolutions "simonsolutions (1 commits)")[![BernhardK91](https://avatars.githubusercontent.com/u/5526334?v=4)](https://github.com/BernhardK91 "BernhardK91 (1 commits)")[![turbo124](https://avatars.githubusercontent.com/u/5827962?v=4)](https://github.com/turbo124 "turbo124 (1 commits)")

---

Tags

cross-industry-invoiceelectronic-invoiceselectronic-invoicingen16931factur-xphpphp7php8xrechnungzugferdinvoiceelectronicZUGFeRDfactur-xxrechnung

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan, Rector

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/horstoeko-zugferd/health.svg)

```
[![Health](https://phpackages.com/badges/horstoeko-zugferd/health.svg)](https://phpackages.com/packages/horstoeko-zugferd)
```

###  Alternatives

[atgp/factur-x

PHP library to manage your Factur-X / ZUGFeRD 2.0 PDF invoices files

138825.5k3](/packages/atgp-factur-x)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[horstoeko/zugferd-laravel

A library for Laravel-Framework for creating and reading european electronic invoices

3693.6k2](/packages/horstoeko-zugferd-laravel)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

19562.3M1.3k](/packages/drupal-core)

PHPackages © 2026

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