49 lines
3.3 KiB
Markdown
49 lines
3.3 KiB
Markdown
# Rechnungen
|
||
|
||
Eigenes Rechnungsmodul (`apps/api/src/modules/invoices`, Migration 016). Kein Invoice Ninja, keine
|
||
externe Buchhaltungssoftware – bewusst so gewählt.
|
||
|
||
## Lebenszyklus
|
||
`draft` → `open` (ausgestellt) → `paid` **oder** `cancelled` (per Storno).
|
||
|
||
- **Entwurf (`draft`):** frei bearbeitbar (Positionen ersetzen, löschen). Kunden sehen Entwürfe nie.
|
||
- **Ausstellen (`POST /invoices/:id/issue`):** vergibt die Rechnungsnummer (fortlaufend, `<Präfix>-<Zähler>`,
|
||
Standard `RE-1000, RE-1001, …`, **ohne Lücken und ohne Rücksetzung pro Jahr** – das ist bewusst so,
|
||
weil eine lückenlose Nummerierung einfacher rechtssicher zu halten ist als eine jährliche mit
|
||
Neustart). Ab hier ist die Rechnung **unveränderlich**: Positionen, Beträge und Nummer werden nie
|
||
wieder geändert. Setzt Ausstellungs- und Fälligkeitsdatum (Zahlungsziel aus den Firmeneinstellungen
|
||
oder explizit übergeben).
|
||
- **Bezahlt (`POST /invoices/:id/mark-paid`):** rein manuell gepflegt. Es gibt keine Anbindung an ein
|
||
Zahlungssystem – niemand hat bisher festgelegt, welcher Zahlungsanbieter (falls überhaupt einer)
|
||
genutzt werden soll.
|
||
- **Storno (`POST /invoices/:id/cancel`):** Eine ausgestellte Rechnung wird **nie** gelöscht oder
|
||
nachträglich verändert (§ 14 UStG, GoBD). Stattdessen entsteht eine neue, ausgestellte
|
||
Stornorechnung mit umgekehrten Vorzeichen (eigene Nummer aus derselben Zählerreihe), die auf die
|
||
Originalrechnung verweist (`cancelsInvoiceId`); die Originalrechnung bekommt den Status `cancelled`
|
||
und einen Rückverweis (`cancelledByInvoiceId`). Beide bleiben für immer einsehbar.
|
||
|
||
## Firmenstammdaten (`company_settings`, `/einstellungen/firma`)
|
||
Name, Anschrift, Steuernummer/USt-IdNr., Bankverbindung, Rechnungspräfix, Zahlungsziel, Zahlungsarten
|
||
(Freitextliste), Fußzeile. **Beim ersten Einrichten absichtlich leer** – nichts davon wurde geraten.
|
||
Ohne vollständige Angaben (Name, Anschrift, Steuernummer oder USt-IdNr.) lässt sich keine Rechnung
|
||
ausstellen (`COMPANY_SETTINGS_INCOMPLETE`), Entwürfe lassen sich aber schon vorbereiten. Ändern kann
|
||
das nur ein Superadministrator (`settings.write`).
|
||
|
||
## Rechte
|
||
`invoices.read`: Personal (alle Rollen) sowie Kunden für die eigene Organisation (nie Entwürfe).
|
||
`invoices.write`: Buchhaltung, Administratoren, Superadministratoren – nicht Support (nur lesend).
|
||
|
||
## PDF
|
||
Wird bei jedem Aufruf aus den gespeicherten Daten neu gerendert (`pdfkit`, kein Zwischenspeichern),
|
||
`GET /invoices/:id/pdf`, nur für ausgestellte Rechnungen. Enthält die Pflichtangaben, soweit aus den
|
||
vorhandenen Daten ableitbar (Rechnungsnummer, Datum, Leistungsbeschreibung, Entgelt/Steuersatz je
|
||
Position, Steuernummer/USt-IdNr., Empfängeranschrift). **Keine rechtliche Prüfung durch einen
|
||
Steuerberater/Anwalt hat stattgefunden** – vor dem ersten Versand an echte Kunden empfohlen.
|
||
|
||
## Offen / bewusst nicht gebaut
|
||
- Kein Zahlungsanbieter (SEPA-Lastschrift, Kartenzahlung, …) – Entscheidung steht aus.
|
||
- Keine automatische Rechnungsstellung aus Verträgen (wiederkehrend); es gibt nur
|
||
`GET /invoices/suggest-from-contract/:id` als Vorschlag für eine einzelne Position, die man von
|
||
Hand übernimmt.
|
||
- Kein E-Mail-Versand der Rechnung (liegt nur zum Abruf bereit, wie beim Lizenzschlüssel-Muster).
|
||
- Keine E-Rechnung (XRechnung/ZUGFeRD) – falls das für B2B mit Behörden nötig wird, gesondert klären.
|