=== E-Rechnung für WooCommerce (XRechnung & ZUGFeRD) ===
Contributors: xrechnungdev
Tags: e-rechnung, xrechnung, zugferd, rechnung, woocommerce
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Gesetzeskonforme E-Rechnungen (ZUGFeRD-PDF oder XRechnung-XML, EN 16931) zu jeder WooCommerce-Bestellung – geprüft mit dem offiziellen KoSIT-Validator.

== Description ==

Seit 2025 muss jedes Unternehmen in Deutschland E-Rechnungen empfangen können; ab 2027/2028 müssen B2B-Rechnungen als E-Rechnung ausgestellt werden. Dieses Plugin erzeugt zu jeder Bestellung automatisch eine E-Rechnung nach EN 16931:

* **ZUGFeRD 2.x** (PDF/A-3 mit eingebettetem XML) für Geschäftskunden – das PDF sieht aus wie eine normale Rechnung, die Software des Empfängers liest das XML.
* **XRechnung 3.0** (reines XML) für öffentliche Auftraggeber, mit Leitweg-ID.
* Jede Rechnung wird vor der Auslieferung mit dem **offiziellen KoSIT-Prüfmodul** validiert – Sie erhalten nie eine ungültige Datei.
* Anhang an die Bestell-E-Mail, Download im Kundenkonto ("Meine Bestellungen") und im Backend, manuelles Neu-Erzeugen.
* Kleinunternehmer-Regelung (§ 19 UStG), Steuersätze 19 %/7 %/0 %, Versandkosten und Gebühren als Positionen, HPOS-kompatibel.

Die Erzeugung läuft über die API von [xrechnung.dev](https://xrechnung.dev). Ohne Anmeldung sind 50 Rechnungen pro Monat kostenlos; für mehr gibt es Tarife ab 19 € im Monat. Rechnungsdaten (Name, Anschrift, Positionen, Beträge) werden zur Erzeugung an xrechnung.dev übertragen, dort im Arbeitsspeicher verarbeitet und nicht gespeichert – siehe [Datenschutzerklärung](https://xrechnung.dev/datenschutz).

== Installation ==

1. Plugin installieren und aktivieren (WooCommerce muss aktiv sein).
2. WooCommerce → Einstellungen → Reiter **E-Rechnung**: Rechnungssteller-Daten eintragen (Name, Anschrift, USt-IdNr. oder Steuernummer, E-Mail, Telefon, IBAN).
3. Format und Auslöse-Status wählen (Standard: ZUGFeRD bei "Abgeschlossen").
4. Optional: API-Schlüssel von xrechnung.dev eintragen, wenn Sie mehr als 50 Rechnungen im Monat brauchen.

== Frequently Asked Questions ==

= Werden meine Daten gespeichert? =
Nein. xrechnung.dev verarbeitet die Rechnungsdaten nur zur Erzeugung und verwirft sie danach. Die fertige Datei liegt ausschließlich in Ihrem WordPress-Upload-Verzeichnis (geschützt gegen direkten Zugriff).

= Wie gebe ich eine Leitweg-ID an? =
Als Bestell-Meta `_xrwc_leitweg_id` (z. B. über ein Checkout-Feld-Plugin oder den Filter `xrwc_invoice_payload`).

= Kann ich die Rechnungsnummer ändern? =
Ja, über den Filter `xrwc_invoice_payload` (z. B. eigene Nummernkreise aus einem Rechnungsnummern-Plugin).

== External services ==

Dieses Plugin nutzt die API von xrechnung.dev (https://xrechnung.dev), um aus den Bestelldaten eine validierte E-Rechnung zu erzeugen. Übertragen werden Rechnungssteller- und Käuferdaten, Positionen und Beträge, wenn eine Rechnung erzeugt wird. Nutzungsbedingungen und Datenschutz: https://xrechnung.dev/datenschutz

== Changelog ==

= 0.1.0 =
* Erste Version: ZUGFeRD/XRechnung-Erzeugung, E-Mail-Anhang, Downloads, Einstellungen, HPOS.
