E-Rechnung aus der eigenen Laravel-Anwendung: XRechnung und ZUGFeRD umsetzen
Ab 1. Januar 2027 müssen Unternehmen mit mehr als 800.000 € Umsatz B2B-Rechnungen als E-Rechnung versenden. Was das für selbst entwickelte PHP- und Laravel-Anwendungen bedeutet und wie die Umsetzung aussieht.
Viele Unternehmen schreiben ihre Rechnungen nicht in DATEV oder lexoffice, sondern in einer eigenen Anwendung: einem Shop, einem Kundenportal, einer Plattform mit Abrechnung. Genau diese Systeme müssen bald strukturierte E-Rechnungen erzeugen. Eine PDF-Datei reicht im deutschen B2B-Geschäft dann nicht mehr.
Dieser Artikel zeigt, welche Fristen gelten, was technisch zu tun ist und wie Sie das in einer bestehenden PHP- oder Laravel-Anwendung umsetzen.
Hinweis: Dieser Artikel ist eine technische Einordnung, keine Steuerberatung. Klären Sie Ihre konkrete Pflicht mit Ihrer Steuerberatung.
Die Fristen
| Ab | Was gilt |
|---|---|
| 1. Januar 2025 | Alle Unternehmen müssen E-Rechnungen empfangen können |
| 1. Januar 2027 | Versandpflicht für Unternehmen mit mehr als 800.000 € Vorjahresumsatz (2026) |
| 1. Januar 2028 | Versandpflicht für alle übrigen Unternehmen im inländischen B2B-Geschäft |
Maßgeblich ist der Gesamtumsatz des Vorjahres, nicht nur der B2B-Anteil. Rechnungen an Privatkunden (B2C) sind nicht betroffen.
Was eine E-Rechnung ist und was nicht
Eine E-Rechnung ist ein strukturierter Datensatz nach der europäischen Norm EN 16931, den ein System automatisch lesen kann. Eine per E-Mail verschickte PDF-Datei ist keine E-Rechnung, auch wenn sie elektronisch ankommt.
In Deutschland sind zwei Formate üblich:
- XRechnung: reines XML (UBL oder CII). Für Menschen nicht lesbar, ohne Viewer. Pflicht bei Rechnungen an öffentliche Auftraggeber.
- ZUGFeRD / Factur-X: eine PDF/A-3-Datei mit eingebettetem XML. Menschen sehen die gewohnte PDF-Rechnung, Systeme lesen das XML. Für B2B oft die angenehmere Wahl, weil Empfänger ohne E-Rechnungs-Software trotzdem etwas sehen. Achten Sie auf ein Profil, das die EN 16931 vollständig abdeckt; die Minimalprofile genügen nicht.
Was das für Ihre Anwendung bedeutet
Wenn Ihre Laravel- oder PHP-Anwendung heute ein PDF erzeugt, sind meist vier Bereiche betroffen:
1. Datenmodell
Eine E-Rechnung verlangt Daten, die in vielen gewachsenen Anwendungen fehlen oder nur als Freitext vorliegen:
- Strukturierte Adressen von Verkäufer und Käufer (Straße, PLZ, Ort, Ländercode getrennt)
- Umsatzsteuer-ID, Steuerkategorien und Steuersätze je Position
- Einheiten nach einem festgelegten Code-Verzeichnis (z. B. Stück, Stunde)
- Zahlungsbedingungen und Bankverbindung als eigene Felder
- Bei Behördenkunden: die Leitweg-ID
Wer bisher eine fertig formatierte Adresse als Textblock speichert, muss hier nacharbeiten. Das ist oft der größte Teil des Aufwands, nicht das XML.
2. Erzeugung des XML
Für PHP gibt es ausgereifte Open-Source-Bibliotheken, zum Beispiel:
- horstoeko/zugferd für ZUGFeRD/Factur-X und XRechnung im CII-Format
- josemmo/einvoicing für UBL- und CII-basierte Formate
In Laravel kapsle ich die Erzeugung in einer eigenen Service-Klasse, die aus dem bestehenden Invoice-Model einen E-Rechnungs-Datensatz baut. So bleibt der Rest der Anwendung unberührt.
final class EInvoiceBuilder
{
public function forInvoice(Invoice $invoice): string
{
// 1. Daten aus dem Model in ein neutrales DTO überführen
// 2. Pflichtfelder prüfen, fehlende Daten früh melden
// 3. Mit der Bibliothek XML bzw. ZUGFeRD-PDF erzeugen
// 4. Ergebnis validieren, dann speichern und versenden
}
}
3. Validierung
Eine E-Rechnung, die formal fehlerhaft ist, kann der Empfänger zurückweisen, und im schlimmsten Fall gefährdet sie seinen Vorsteuerabzug. Deshalb gehört eine Validierung vor dem Versand dazu. Der Standard dafür ist der Validator der KoSIT, der sich in eine Queue-Job-Pipeline einbinden lässt. Ergänzend schreibe ich Tests, die für typische Rechnungsarten (Standard, Gutschrift, Rechnung mit Rabatt, Reverse Charge) jeweils eine gültige Datei erzeugen.
4. Versand und Archivierung
- Versand als E-Mail-Anhang reicht im B2B-Bereich. Ein Portal ist nicht vorgeschrieben.
- Archiviert werden muss die E-Rechnung selbst (das XML bzw. die ZUGFeRD-Datei), revisionssicher und über die gesetzliche Aufbewahrungsfrist.
- Ein zusätzliches Sicht-PDF schadet nicht, ersetzt aber das XML nicht.
Typischer Ablauf in einem Projekt
- Bestandsaufnahme: Welche Rechnungsarten gibt es, welche Daten fehlen, wo entstehen Rechnungen überall? (Oft gibt es mehr als eine Stelle.)
- Datenmodell erweitern: Migrationen für strukturierte Adressen, Steuerdaten, Einheiten. Bestehende Daten bereinigen.
- Builder und Validierung: Service-Klasse, Bibliothek, Validator im Queue-Job.
- Tests: Je Rechnungsart eine Referenzdatei, die bei jeder Änderung neu validiert wird.
- Pilot: Erst an wenige Kunden, dann an alle.
Für eine gepflegte Laravel-Anwendung ist das ein überschaubares Projekt. Liegt die Anwendung noch auf einer alten PHP- oder Laravel-Version, sollten Sie beides zusammen planen: Aktuelle E-Rechnungs-Bibliotheken setzen moderne PHP-Versionen voraus.
Checkliste
- Vorjahresumsatz 2026 geklärt: Pflicht ab 2027 oder ab 2028?
- Alle Stellen identifiziert, an denen die Anwendung Rechnungen erzeugt
- Format gewählt (XRechnung oder ZUGFeRD mit EN-16931-Profil)
- Datenmodell auf Pflichtfelder geprüft
- Validierung vor dem Versand eingeplant
- Archivierung des XML geklärt
- PHP- und Framework-Version kompatibel mit den Bibliotheken
Unklar, wie fit Ihre Anwendung dafür ist?
Im Legacy Audit prüfe ich auch, was Ihrer Anwendung für die E-Rechnung fehlt: Datenmodell, Abhängigkeiten, PHP-Version. Sie erhalten eine priorisierte Roadmap mit Aufwand in Wochen. Festpreis €7.500 netto, Quickcheck für kleinere Codebasen €2.500.