50 lines
3.3 KiB
Markdown
50 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.
|