README

ZUGFeRD/XRechnung/Factur-X

Status

Searching for contributors

Important

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): horstoeko-invoicesuite@erling.com.de Schreib kurz, wobei du unterstützen möchtest und wie viel Zeit du grob hast.

Important

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): horstoeko-invoicesuite@erling.com.de Please share what you’d like to help with and roughly how much time you have.

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)

Related projects

• ZUGFeRD Visualizer
• ZUGFeRD Laravel
• ZUGFeRD UBL Bridge
• ZUGFeRD Mail
• Order-X

Dependencies

This package makes use of

• JMS Serializer
• Xsd2Php
• FPDF
• FPDI.

Resources

• Official documentaries (Version Archive)

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:

• Installation
• Configuration
• Read a xml file
• Read a pdf file with attached xml file
• Write a xml file
• Write a pdf file with attached xml file file
• Merge existing PDF and XML
• Validation