Zurück zum Changelog

ZUGFeRD 2.4 + Factur-X 1.08

13. April 2026

Neue Output-Format-Versionen wählbar im Finalisierungs-Dialog, plus eine UI für Sub-Line-Items mit Typ-Auswahl (DETAIL/INFORMATION/GROUP). Bestehende Versionen 2.3 / 1.07 bleiben verfügbar.

ZUGFeRD 2.4

Aktuelle deutsche Hybrid-Format-Version (PDF + XML), wählbar via formatOptions.version.

Factur-X 1.08

Aktuelle französische Hybrid-Format-Version, wählbar via formatOptions.facturxVersion.

Sub-Line-Items

Pro Rechnungsposition: Sub-Items mit Typ DETAIL/INFORMATION/GROUP und Expand/Collapse.

12 Sprachen aktualisiert

bg, cs, de, en, es, fr, hu, it, nl, pl, pt, ro

Neue Output-Formate

ZUGFeRD 2.4 (DE) und Factur-X 1.08 (FR) erweitern das Format-Dropdown im Finalisierungs-Dialog. Bestehende Versionen 2.3 / 1.07 bleiben der Default und voll unterstützt.

ZUGFeRD

Auswahl zwischen 2.3 (Standard) und 2.4 via formatOptions.version.

Factur-X

Auswahl zwischen 1.07 (Standard) und 1.08 via formatOptions.facturxVersion.

Versions-Auswahl im Dialog

Bei Auswahl von ZUGFeRD oder Factur-X erscheint im Finalisierungs-Dialog jetzt ein neues „Version“-Dropdown direkt neben dem Format. Default-Werte sind 2.3 / 1.07, damit bestehende Workflows byte-stabil bleiben; wähle 2.4 / 1.08, wenn du die neuere Revision brauchst.

Die Auswahl wird als formatOptions an die API weitergereicht — siehe REST-API-Mapping unten.

Sub-Line-Items (Unterpositionen)

Jede Rechnungsposition hat jetzt einen „+“-Button zum Hinzufügen von Sub-Items. Sub-Items werden eingerückt unter der Hauptposition angezeigt, mit Expand/Collapse-Chevron. Sie unterstützen alle Standardfelder (Beschreibung, Menge, Einheit, Preis, MwSt., Rabatt).

Sub-Item-Typen

DETAIL

Echte Detailposition mit Mengen, Preis und Steuersatz — fließt in die Summen ein.

INFORMATION

Reiner Info-Eintrag (Hinweise, Anmerkungen) — kein Einfluss auf Summen.

GROUP

Gruppen-/Zwischensummen-Marker für strukturelle Lesbarkeit.

REST API Mapping

Frontend-Formate werden auf Backend-Format + Version-Flag gemappt:

Frontend-FormatBackend-FormatformatOptions
zugferd-2.4zugferd{ version: '2.4' }
factur-x-1.08facturx{ facturxVersion: '1.08' }

PDF-Embedding (ZUGFeRD/Factur-X-Hybrid) funktioniert für beide Versionen.

Beispiel: ZUGFeRD 2.4 Request mit Sub-Items

json
1POST /api/v1/invoice/de/zugferd/generate
2 
3{
4  "invoice": {
5    "invoiceNumber": "RE-2026-100",
6    "type": "invoice",
7    "issueDate": "2026-04-13",
8    "currency": "EUR",
9    "seller": { "name": "Acme GmbH", "countryCode": "DE", "vatId": "DE123456789" },
10    "buyer":  { "name": "Kunde AG", "countryCode": "DE" },
11    "items": [
12      {
13        "position": 1,
14        "description": "Projekt Q2 — Phase 1",
15        "quantity": 1,
16        "unitPrice": 10000.00,
17        "taxRate": 19,
18        "subItems": [
19          { "type": "DETAIL", "description": "Konzept",        "netAmount": 3000.00 },
20          { "type": "DETAIL", "description": "Implementation", "netAmount": 6000.00 },
21          { "type": "INFORMATION", "description": "QA-Hinweis: extern abgenommen" },
22          { "type": "GROUP", "description": "Schulung",        "netAmount": 1000.00 }
23        ]
24      }
25    ],
26    "subtotal": 10000.00,
27    "total": 11900.00
28  },
29  "formatOptions": {
30    "version": "2.4"
31  }
32}

Beispiel: Factur-X 1.08 Request

json
1POST /api/v1/invoice/fr/facturx/generate
2 
3{
4  "invoice": { /* ... */ },
5  "formatOptions": {
6    "facturxVersion": "1.08"
7  }
8}
Alle Changelog-EinträgeAPI-Dokumentation