Skip to main content
Kostenlos starten

Troubleshooting & Reference · Article 7.10

„Der Status zeigt Schlussrechnung ausgestellt, aber die Rechnung hat keine Positionen"

Eine Wettlaufbedingung zwischen `Als abgeschlossen markieren` und der vorgerenderten Schlussrechnung. Wenn das Vorrendering vor Ihrem Klick auf Abgeschlossen stillschweigend fehlgeschlagen ist, wird der Rechnungsdatensatz erstellt, aber das PDF ist leer oder falsch. Wiederherstellung: Schlussrechnung neu generieren.

Der Schlussrechnungsablauf hat zwei Phasen: Vorrendering (Hintergrund, in dem Moment, in dem die Anzahlung eingeht) und Versand (Vordergrund, wenn Sie auf Als abgeschlossen markieren klicken). Das Vorrendering ist, wo sich die meisten Fehler verstecken — wenn Gotenberg während des Vorrenderings fehlschlägt, existiert der Platzhalter-INV-Datensatz, aber sein PDF ist defekt.

Step by step

  1. Dokumenten-Dropdown prüfen.

    INV-XXXX anschauen — wenn fehlend oder als fehlgeschlagen markiert, ist das das Grundproblem.

  2. Auf Schlussrechnung neu generieren klicken

    unter Aktionen. Der Renderer läuft erneut mit dem aktuellen Stand des Angebots (nach der Änderung, falls zutreffend).

  3. Das PDF bestätigen.

    INV-XXXX aus Dokumenten öffnen; Positionen sollten ausgefüllt sein.

  4. Bei Bedarf neu ausstellen.

    Wenn Sie bereits die E-Mail mit dem defekten PDF ausgelöst hatten, klicken Sie auf Schlussrechnungs-E-Mail erneut senden, um die korrigierte Version zu senden.

Why this works this way

Vorrendering-Ablauf (prepare_final_invoice Celery-Task): 1. Schlussrechnungs-HTML rendern (Jinja). 2. An Gotenberg senden → PDF-Bytes. 3. In R2 hochladen. 4. URL in FinalInvoice.pdf_url speichern.

Wenn Schritt 2 oder 3 nach Wiederholungsversuchen fehlschlägt, existiert der FinalInvoice-Datensatz mit pdf_url = null. Der Angebotsstatus bleibt bei Anzahlung bezahlt und eine Schaltfläche Schlussrechnung erneut versuchen erscheint. Vor der Korrektur (Anfang 2026) erschien die Schaltfläche nicht immer — der Status wechselte zu In Arbeit und Sie konnten nicht erkennen, dass das PDF fehlte, bis Sie auf Als abgeschlossen markieren klickten. Das aktuelle Verhalten (Korrektur Mai 2026) blockiert die Statusweiterentwicklung, wenn das Vorrendering fehlschlägt, sodass das Problem früher sichtbar wird.

Troubleshooting

Keep reading

Lifecycle

Status: In work — deposit settled, project running, final invoice ready

You're between the deposit and the final payment. The final invoice is pre-rendered and ready to issue when you finish. Clozo doesn't track project progress here — you do — but it's listening for you to say `done`.

Proposals & Invoices

The 4 delta branches: Δ+, Δ−, Δ=0, Δ_REFUND

Every signed amendment falls into one of four branches based on (a) the sign of the cost change and (b) whether the proposal was already paid. Each branch fires a different document chain. This is the central conceptual map for the entire amendment system.

Troubleshooting & Reference

"The invoice link is broken or the PDF is missing"

PDFs occasionally fail to render (Gotenberg flake) or fail to upload to R2. Symptom: the document shows as "issued" but clicking the link returns 404 or the PDF is blank. Recovery: regenerate from the Documents dropdown.

„Der Status zeigt Schlussrechnung ausgestellt, aber die Rechnung hat keine Positionen" · Help · Clozo