horstoeko / zugferd
A library for creating and reading european electronic invoices
Fund package maintenance!
Requires
- php: >=7.3
- ext-dom: *
- ext-fileinfo: *
- ext-json: *
- ext-libxml: *
- ext-simplexml: *
- ext-zip: *
- goetas-webservices/xsd2php-runtime: ^0.2.13
- horstoeko/mimedb: ^1
- horstoeko/stringmanagement: ^1
- jms/serializer: ^3
- setasign/fpdf: ^1
- setasign/fpdi: ^2
- smalot/pdfparser: ^0|^2
- symfony/finder: ^5|^6|^7|^8
- symfony/process: ^5|^6|^7|^8
- symfony/validator: ^5|^6|^7|^8
- symfony/yaml: ^5|^6|^7|^8
Requires (Dev)
Suggests
None
Provides
None
Conflicts
None
Replaces
None
- dev-master
- v1.0.132
- v1.0.131
- v1.0.130
- v1.0.129
- v1.0.128
- v1.0.127
- v1.0.126
- v1.0.125
- v1.0.124
- v1.0.123
- v1.0.122
- v1.0.121
- v1.0.120
- v1.0.119
- v1.0.118
- v1.0.117
- v1.0.116
- v1.0.115
- v1.0.114
- v1.0.113
- v1.0.112
- v1.0.111
- v1.0.110
- v1.0.109
- v1.0.108
- v1.0.107
- v1.0.106
- v1.0.105
- v1.0.104
- v1.0.103
- v1.0.102
- v1.0.101
- v1.0.100
- v1.0.99
- v1.0.98
- v1.0.97
- v1.0.96
- v1.0.95
- v1.0.94
- v1.0.93
- v1.0.92
- v1.0.91
- v1.0.90
- v1.0.89
- v1.0.88
- v1.0.87
- v1.0.86
- v1.0.85
- v1.0.84
- v1.0.83
- v1.0.82
- v1.0.81
- v1.0.80
- v1.0.79
- v1.0.78
- v1.0.77
- v1.0.76
- v1.0.75
- v1.0.74
- v1.0.73
- v1.0.72
- v1.0.71
- v1.0.70
- v1.0.69
- v1.0.68
- v1.0.67
- v1.0.66
- v1.0.65
- v1.0.64
- v1.0.63
- v1.0.62
- v1.0.61
- v1.0.60
- v1.0.59
- v1.0.58
- v1.0.57
- v1.0.56
- v1.0.55
- v1.0.54
- v1.0.53
- v1.0.52
- v1.0.51
- v1.0.50
- v1.0.49
- v1.0.48
- v1.0.47
- v1.0.46
- v1.0.45
- v1.0.44
- v1.0.43
- v1.0.42
- v1.0.41
- v1.0.40
- v1.0.39
- v1.0.38
- v1.0.37
- v1.0.36
- v1.0.35
- v1.0.34
- v1.0.33
- v1.0.32
- v1.0.31
- v1.0.30
- v1.0.29
- v1.0.28
- v1.0.27
- v1.0.26
- v1.0.25
- v1.0.24
- v1.0.23
- v1.0.22
- v1.0.21
- v1.0.20
- v1.0.19
- v1.0.18
- v1.0.17
- v1.0.16
- v1.0.15
- v1.0.14
- v1.0.13
- v1.0.12
- v1.0.11
- v1.0.10
- v1.0.9
- v1.0.8
- v1.0.7
- v1.0.6
- v1.0.5
- v1.0.4
- v1.0.2
- v1.0.1
- v0.1.28
- v0.1.27
- v0.1.26
- v0.1.25
- v0.1.24
- v0.1.23
- v0.1.22
- v0.1.21
- v0.1.20
- v0.1.19
- v0.1.18
- v0.1.17
- v0.1.16
- v0.1.15
- v0.1.14
- v0.1.13
- v0.1.12
- v0.1.11
This package is auto-updated.
Last update: 2026-09-05 06:01:01 UTC
README
ZUGFeRD/XRechnung/Factur-X
Status
Searching for contributors
Projektstatus und offizieller Nachfolger
Important
horstoeko/zugferd wurde technisch umfassend modernisiert. Die Entwicklungsinfrastruktur, CI- und Release-Workflows, Nightly-Builds, Tests sowie die automatisierten Qualitätsprüfungen mit PHPStan, PHP-CS-Fixer und Rector wurden aktualisiert und vereinheitlicht. Die Bibliothek bleibt für bestehende Projekte verfügbar und wird weiterhin gepflegt.
Diese Modernisierung ändert nichts an der strategischen Ausrichtung: Der offizielle Nachfolger und Schwerpunkt der zukünftigen Weiterentwicklung ist horstoeko/invoicesuite. Für neue Projekte wird ausdrücklich InvoiceSuite empfohlen.
InvoiceSuite bietet eine moderne, erweiterbare Architektur für verschiedene Formate und Syntaxen elektronischer Rechnungen – darunter ZUGFeRD, Factur-X und XRechnung in CII und UBL. Die enthaltene Legacy-Kompatibilität erleichtert die Migration bestehender Anwendungen von horstoeko/zugferd.
Bestehende Anwendungen müssen nicht sofort migriert werden. Bei neuen Implementierungen oder größeren Weiterentwicklungen sollte jedoch InvoiceSuite als Grundlage verwendet werden.
Project status and official successor
Important
horstoeko/zugferd has undergone extensive technical modernization. The development infrastructure, CI and release workflows, nightly builds, tests, and automated quality checks using PHPStan, PHP-CS-Fixer, and Rector have been updated and standardized. The library remains available and maintained for existing projects.
This modernization does not change the strategic direction: The official successor and primary focus of future development is horstoeko/invoicesuite. InvoiceSuite is strongly recommended for all new projects.
InvoiceSuite provides a modern, extensible architecture for different electronic invoice formats and syntaxes, including ZUGFeRD, Factur-X, and XRechnung in both CII and UBL. Its legacy compatibility layer facilitates the migration of existing applications from horstoeko/zugferd.
Existing applications do not need to migrate immediately. However, InvoiceSuite should be used as the foundation for new implementations and major future developments.
Table of Contents
- License
- Overview
- Supported profiles
- Further information
- Related projects
- Dependencies
- Resources
- Guide
License
The code in this project is provided under the MIT license.
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
- 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
- ZUGFeRD (German)
- XRechnung (German)
- Factur-X (France)
- Awesome e-Invoicing (EN 16931 / Factur-X / ZUGFeRD)
Related projects
Dependencies
This package makes use of
Resources
Guide
For detailed explanation you may have a look in the examples of this package, the documentation attached to every release or our wiki.
The following parts are documentated in our Wiki: