Rechnungen & Angebote
PDF-Generierung und Belegverwaltung
Rechnungen & Angebote (Belegwesen)
Modulübersicht
Das Fakturierungs-Modul orchestriert den gesamten Finanzzyklus von S4Cash. Es nutzt eine Headless-PDF-Engine zur server-seitigen Generierung rechtssicherer Belege.
Validierung & Strukturierung
Jedes generierte Dokument (Rechnungen, Gutschriften, Angebote) durchläuft einen strikten Workflow-Prozess:
| Lebenszyklus | Beschreibung der Aktion |
|---|---|
| DRAFT | Entwurfsstatus, Bearbeitung der Rechnungspositionen (InvoiceLineItems) möglich. |
| ISSUED | Finalisierung. Die PDF wird im Cloudflare R2 Bucket freigeschaltet. Keine Modifikationen mehr zulässig. |
| PARTIAL | Erste Teilzahlung wurde verbucht (z.B. Stripe Webhook empfangen). |
| PAID | Forderung ist beglichen (Referenz auf PaymentRecord). |
| OVERDUE | Fälligkeitsdatum (dueDate) überschritten, Mahnprozess wird angetriggert. |
Konversionen & Workflows
Das System erlaubt fließende Übergänge (Konversionen) zwischen Dokumenttypen, um redundante Dateneingaben zu vermeiden:
- Angebot -> Rechnung: Ein akzeptiertes Angebot generiert direkt eine Rechnungskopie.
- Angebot -> Lieferschein: Übernahme der Artikel (ohne Preis-Referenzen) auf das Transport-Dokument.
- Sammelabrechnung: Lieferscheine (
DeliveryNotes) können auf Monatsbasis konsolidiert zu einer Sammelrechnung abgerechnet werden.
Dunning System (Mahnwesen)
Zahlungsverzüge eskalieren durch ein mehrstufiges Mahnwesen:
| Mahnstufe | Trigger | Aktion Backend |
|---|---|---|
Stage 1 | 7 Tage überfällig | Freundliche Zahlungserinnerung (E-Mail Generierung via Resend). |
Stage 2 | 14 Tage überfällig | Formelle Mahnung + Mahngebühr Zuschlag auf den OP-Betrag. |
Stage 3 | 30 Tage überfällig | Letzte Mahnung; Deaktivierung von S4Hub-Krediten für den Mandanten. |
Tax-Engine (Steuerberechnungen)
S4Cash integriert ein komplexes Steuer-Kalkulationsmodell:
| Steuer-Szenario | Berechnungsgrundlage |
|---|---|
| Inland B2C | Voller MwSt.-Satz auf Basis der Filial-Konfiguration. |
| Inland S4Hub | Voller MwSt.-Satz auf Basis der Filial-Konfiguration. |
| Reverse Charge | Innerhalb der EU, S4Hub-Verifikation (VIES API) erfolgreich -> 0% Steuer. |
| Drittland | Steuerfreie Exportlieferung -> 0% Steuer. |
Das System validiert bei der Belegfinalisierung die Reverse-Charge Kriterien (Gültige Umsatzsteuer-ID zwingend vorausgesetzt).