https://github.com/horstoeko/zugferd
ZUGFeRD/XRechnung/Factur-X Library
https://github.com/horstoeko/zugferd
cross-industry-invoice electronic-invoices electronic-invoicing en16931 factur-x php php7 php8 xrechnung zugferd
Last synced: 5 days ago
JSON representation
ZUGFeRD/XRechnung/Factur-X Library
- Host: GitHub
- URL: https://github.com/horstoeko/zugferd
- Owner: horstoeko
- License: mit
- Created: 2020-08-16T15:17:38.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2025-05-08T03:38:42.000Z (12 days ago)
- Last Synced: 2025-05-08T04:26:18.858Z (12 days ago)
- Topics: cross-industry-invoice, electronic-invoices, electronic-invoicing, en16931, factur-x, php, php7, php8, xrechnung, zugferd
- Language: PHP
- Homepage:
- Size: 9.67 MB
- Stars: 331
- Watchers: 18
- Forks: 54
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# ZUGFeRD/XRechnung/Factur-X
## Status
[](https://packagist.org/packages/horstoeko/zugferd)
[](https://packagist.org/packages/horstoeko/zugferd)
[](https://packagist.org/packages/horstoeko/zugferd)
[](https://github.com/horstoeko/zugferd/actions/workflows/build.ci.yml)
[](https://github.com/horstoeko/zugferd/actions/workflows/build.release.yml)
## 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
The code in this project is provided under the [MIT](https://opensource.org/licenses/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](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
* [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
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
- [Official documentaries (Version Archive)](https://www.ferd-net.de/ueber-uns/ressourcen-1/veroeffentlichungen)
## 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)