ADR-0006 – E-Rechnung: ZUGFeRD (DE) und ebInterface (AT)

Status

Accepted (Migration 031 + packages/domain/src/einvoice/*).

Kontext

Work7 adressiert DE- und AT-Handwerksbetriebe. Beide Märkte verlangen strukturierte E-Rechnungen mit unterschiedlichen Standards: Deutschland ZUGFeRD/XRechnung (CII-XML, in PDF/A-3 eingebettet), Österreich ebInterface. EN 16931 ist die gemeinsame semantische Basis.

Entscheidung

• Eigenständige E-Invoicing-Pipeline in @work7/domain/einvoice, entkoppelt vom normalen PDF-Pfad.
• Kanonisches Zwischenmodell CanonicalInvoice (Seller/Buyer/Lines) + Pflichtfeld-Validierung (EN 16931).
• Formatwahl nach Länderkennzeichen: DE → zugferd (CII-XML + ZUGFeRD-PDF), sonst ebinterface (XML + Human-PDF).
• Feld- und XML-Validierung; Ergebnis (valid/invalid + Fehler) in invoice_exports versioniert.
• Mandant steuert Verhalten über companies.einvoice_enabled/einvoice_format/ reverse_charge_default und AT-UGB-Felder (company_seat, commercial_register_court).

Konsequenzen

• ➕ Gesetzeskonforme Exporte für beide Länder aus einem Modell; nachvollziehbare Validierungshistorie; saubere Trennung „lesbares PDF" vs. „strukturierte Daten".
• ➖ Zwei PDF-Welten (Standard-Templates vs. E-Rechnungs-PDF) zu pflegen; Korrektheit erfordert vollständige Stammdaten (USt-IdNr., Adresse, Bank).

Verwandte Notes

• 10-rechnungen-e-rechnung · 02-mandanten-company-settings · 18-pdf-print-templates
• Compliance-Doku: ../compliance/compliance-e-rechnung-de-at.md