Initial commit - Help Service for Coolify

content/sevdesk.md

@@ -0,0 +1,96 @@
+---
+id: sevdesk
+title: sevDesk Integration
+icon: cloud-arrow-up
+description: Buchhaltungs-Anbindung an sevDesk
+section: Integrationen
+tags: [sevDesk, Buchhaltung, Rechnungen, API, E-Rechnung]
+related: [prices, booking, e-rechnung]
+order: 40
+---
+
+# sevDesk Integration
+
+## Verbindung einrichten
+
+1. **API-Token erstellen** in sevDesk unter Einstellungen > API
+2. **Token einfuegen** in den Plugin-Einstellungen
+3. **Verbindung testen** mit dem Test-Button
+
+## Automatische Synchronisation
+
+| Funktion | Beschreibung |
+|----------|--------------|
+| **Kontakte** | Teilnehmer werden als sevDesk-Kontakte angelegt |
+| **Rechnungen** | Buchungen werden als Rechnungen uebertragen |
+| **Positionen** | Kursdetails als Rechnungspositionen |
+
+## Einstellungen
+
+| Option | Beschreibung |
+|--------|--------------|
+| **Auto-Sync** | Automatische Uebertragung bei neuer Buchung |
+| **Rechnungsstatus** | Entwurf oder Finalisiert |
+| **Zahlungsziel** | Tage bis Faelligkeit (Standard: 14) |
+| **Waehrung** | EUR, CHF, GBP oder USD |
+| **Kundenreferenz** | Template mit Platzhaltern (z.B. `{buchungs_nummer}`) |
+
+## Rechnungsnummern konfigurieren
+
+**Wichtig:** Die Rechnungsnummern werden direkt in sevDesk verwaltet - nicht im Plugin!
+
+### Einrichtung in sevDesk
+
+1. Melden Sie sich bei **sevDesk** an
+2. Gehen Sie zu **Einstellungen > Nummernkreise > Rechnungen**
+3. Konfigurieren Sie:
+   - **Praefix:** z.B. `RE-`
+   - **Format:** z.B. `{PRAEFIX}{JAHR}-{NUMMER}`
+   - **Startnummer:** z.B. `1`
+
+### Empfohlenes Format
+
+Fuer automatischen Jahreswechsel ohne manuelles Zuruecksetzen:
+
+```
+RE-2025-0001
+RE-2025-0002
+...
+RE-2026-0001  (automatisch neues Jahr)
+```
+
+### Jahreswechsel
+
+| Option | Beschreibung |
+|--------|--------------|
+| **Mit Jahreszahl im Format** | Kein manuelles Zuruecksetzen noetig (empfohlen) |
+| **Ohne Jahreszahl** | Am 01.01. manuell in sevDesk auf 1 zuruecksetzen |
+
+> **Tipp:** Das Format mit Jahreszahl ist zuverlaessiger und wird von den meisten Steuerberatern empfohlen.
+
+## Teilrechnungen / Anzahlungen
+
+Bei Buchungen mit Anzahlung werden zwei Rechnungen erstellt:
+
+1. **Anzahlungsrechnung** - Sofort bei Buchung
+2. **Restrechnung** - Bei Kursabschluss oder manuell
+
+## E-Rechnung (ZUGFeRD)
+
+Ab 2025 Pflicht fuer B2B in Deutschland. Aktivieren Sie E-Rechnungen im ZUGFeRD-Format:
+
+1. Gehen Sie zu **Kurse > Einstellungen > sevDesk**
+2. Aktivieren Sie **"E-Rechnungen im ZUGFeRD-Format erstellen"**
+
+Die PDF-Rechnung sieht normal aus, enthaelt aber eingebettetes XML fuer automatische Verarbeitung.
+
+**Voraussetzungen in sevDesk:**
+- Vollstaendige Firmenadresse
+- IBAN und Bank hinterlegt
+- Steuernummer oder USt-IdNr.
+
+> Ausfuehrliche Dokumentation: [E-Rechnung (ZUGFeRD/XRechnung)](#/topic/e-rechnung)
+
+---
+
+> **Wichtig:** Die sevDesk-Integration erfordert einen sevDesk-Account mit API-Zugang.