Initial commit - Help Service for Coolify

2025-12-17 10:08:16 +01:00
commit a998c47132
57 changed files with 7104 additions and 0 deletions
--- a/content/e-rechnung.md
+++ b/content/e-rechnung.md
@@ -0,0 +1,144 @@
+---
+id: e-rechnung
+title: E-Rechnung (ZUGFeRD/XRechnung)
+icon: file-invoice
+description: Elektronische Rechnungen im ZUGFeRD-Format fuer sevDesk
+section: Integrationen
+tags: [E-Rechnung, ZUGFeRD, XRechnung, sevDesk, B2B, Pflicht 2025]
+related: [sevdesk, prices, booking]
+order: 41
+---
+
+# E-Rechnung (ZUGFeRD/XRechnung)
+
+Ab 2025 sind E-Rechnungen fuer B2B-Geschaefte in Deutschland Pflicht. Das Kurs-Booking Plugin unterstuetzt E-Rechnungen im ZUGFeRD-Format ueber die sevDesk-Integration.
+
+## Was ist eine E-Rechnung?
+
+Eine E-Rechnung ist eine Rechnung in einem strukturierten elektronischen Format. Im Gegensatz zu einer PDF-Rechnung enthaelt sie maschinenlesbare Daten.
+
+| Format | Beschreibung |
+|--------|--------------|
+| **ZUGFeRD 2.1** | PDF mit eingebettetem XML (Hybrid-Format) |
+| **XRechnung** | Reines XML-Format (fuer oeffentliche Auftraggeber) |
+
+> **sevDesk** erstellt Rechnungen im **ZUGFeRD 2.1** Format - das PDF sieht normal aus, enthaelt aber eingebettetes XML fuer automatische Verarbeitung.
+
+## E-Rechnung aktivieren
+
+### Schritt 1: Voraussetzungen in sevDesk pruefen
+
+Bevor Sie E-Rechnungen aktivieren, muessen folgende Daten in sevDesk hinterlegt sein:
+
+| Pflichtfeld | Wo in sevDesk |
+|-------------|---------------|
+| **Firmenadresse** | Einstellungen > Unternehmensdaten > Adresse |
+| **IBAN & Bank** | Einstellungen > Unternehmensdaten > Bankverbindung |
+| **Steuernummer** | Einstellungen > Unternehmensdaten > Steuernummer |
+| **USt-IdNr.** | Einstellungen > Unternehmensdaten > USt-IdNr. (optional, fuer EU) |
+
+### Schritt 2: Im Plugin aktivieren
+
+1. Gehen Sie zu **Kurse > Einstellungen > sevDesk**
+2. Aktivieren Sie **"E-Rechnungen im ZUGFeRD-Format erstellen"**
+3. Speichern Sie die Einstellungen
+
+## So funktioniert es
+
+```
+Buchung bestaetigt
+       |
+       v
+------------------+
+|  sevDesk API     |
+|  mit             |
+|  propertyIs      |
+|  EInvoice: true  |
+------------------+
+       |
+       v
+------------------+
+|  ZUGFeRD PDF     |
+|  (PDF + XML)     |
+------------------+
+       |
+       +-----> PDF fuer Menschen (normale Ansicht)
+       |
+       +-----> XML fuer Maschinen (eingebettet)
+```
+
+### Was der Kunde erhaelt
+
+- **Normale PDF-Rechnung** - Sieht aus wie jede andere Rechnung
+- **Eingebettetes XML** - Unsichtbar, aber maschinenlesbar
+- **Automatische Verarbeitung** - Buchhaltungssoftware kann XML lesen
+
+## Technische Details
+
+### Gespeicherte Meta-Daten
+
+Bei jeder E-Rechnung wird gespeichert:
+
+| Meta-Feld | Beschreibung |
+|-----------|--------------|
+| `_sevdesk_invoice_id` | sevDesk Rechnungs-ID |
+| `_sevdesk_invoice_number` | Rechnungsnummer |
+| `_sevdesk_is_e_invoice` | "1" wenn E-Rechnung |
+
+### XML abrufen (fuer Entwickler)
+
+```php
+// XML einer E-Rechnung abrufen
+$xml = Kurs_Booking_SevDesk::get_invoice_xml( $invoice_id );
+
+if ( is_wp_error( $xml ) ) {
+    echo $xml->get_error_message();
+} else {
+    // XML verarbeiten
+    echo $xml;
+}
+
+// Pruefen ob Rechnung eine E-Rechnung ist
+$is_e_invoice = Kurs_Booking_SevDesk::is_e_invoice( $invoice_id );
+```
+
+## Haeufige Fragen
+
+### Muss ich E-Rechnungen nutzen?
+
+- **B2B (Geschaeftskunden):** Ab 2025 Pflicht in Deutschland
+- **B2C (Privatkunden):** Nicht verpflichtend, aber moeglich
+- **B2G (Oeffentliche Hand):** Bereits jetzt Pflicht (XRechnung)
+
+### Was passiert mit alten Rechnungen?
+
+Bestehende Rechnungen bleiben unveraendert. Die E-Rechnung-Option gilt nur fuer **neue** Rechnungen nach der Aktivierung.
+
+### Kann der Kunde die E-Rechnung lesen?
+
+Ja! Das PDF sieht ganz normal aus. Das XML ist nur fuer die automatische Verarbeitung eingebettet.
+
+### Was wenn sevDesk einen Fehler meldet?
+
+Pruefen Sie:
+1. Sind alle Pflichtfelder in sevDesk ausgefuellt?
+2. Ist die Firmenadresse vollstaendig (Strasse, PLZ, Ort)?
+3. Ist eine gueltige IBAN hinterlegt?
+4. Ist Steuernummer oder USt-IdNr. eingetragen?
+
+## Rechnungsstatus
+
+| Status | Beschreibung |
+|--------|--------------|
+| **Entwurf (100)** | Rechnung zur manuellen Pruefung, noch keine Rechnungsnummer |
+| **Offen (200)** | Sofort finalisiert mit Rechnungsnummer |
+
+> **Tipp:** Bei aktivierter E-Rechnung empfehlen wir Status "Entwurf", um Rechnungen vor dem Versand zu pruefen.
+
+## Rechtliche Hinweise
+
+- E-Rechnungen muessen 10 Jahre aufbewahrt werden
+- Das XML muss unveraendert bleiben
+- sevDesk kuemmert sich um die korrekte Archivierung
+
+> **Hinweis:** Diese Dokumentation ersetzt keine steuerliche Beratung. Bei Fragen wenden Sie sich an Ihren Steuerberater.