Troubleshooting & Reference · Article 7.10
"De status zegt Eindfactuur uitgesteld maar de factuur heeft geen regelitems"
Een race-conditie tussen `Markeren als voltooid` en de vooraf gegenereerde eindfactuur. Als de vooraf-generatie stil is mislukt voordat u op voltooid klikte, is het factuurrecord aangemaakt maar de PDF is leeg of onjuist. Herstel: de eindfactuur opnieuw genereren.
De eindfactuurstroom heeft twee fasen: vooraf genereren (achtergrond, op het moment dat het voorschot binnenkomt) en versturen (voorgrond, wanneer u op Markeren als voltooid klikt). De vooraf-generatie is waar de meeste mislukkingen verborgen zitten — als Gotenberg stoort tijdens de vooraf-generatie, bestaat het tijdelijke INV-record maar is de PDF defect.
Step by step
Controleer de Documenten-dropdown.
Kijk naar INV-XXXX — als het ontbreekt of als mislukt is gemarkeerd, is dat het kernprobleem.
Klik op
Eindfactuur opnieuw genererenvanuit Acties. De renderer wordt opnieuw uitgevoerd met de huidige staat van de offerte (na addendum indien van toepassing).
Bevestig de PDF.
Open INV-XXXX vanuit Documenten; regelitems moeten zijn ingevuld.
Stuur opnieuw indien nodig.
Als u al de e-mail had geactiveerd met de defecte PDF, klik dan op
Eindfactuur-e-mail opnieuw verzendenom de gecorrigeerde versie te sturen.
Why this works this way
Vooraf-generatiestroom (prepare_final_invoice Celery-taak):
1. Genereer de eindfactuur-HTML (Jinja).
2. Stuur naar Gotenberg → PDF-bytes.
3. Upload naar R2.
4. Sla URL op in FinalInvoice.pdf_url.
Als stap 2 of 3 mislukt na herhaalde pogingen, bestaat het FinalInvoice-record met pdf_url = null. De offertestatus blijft op Voorschot betaald en een Eindfactuur opnieuw proberen-knop verschijnt. Vóór de fix (begin 2026) verscheen de knop niet altijd — de status ging vooruit naar In uitvoering en u kon niet zien dat de PDF ontbrak totdat u op Markeren als voltooid klikte. Het huidige gedrag (mei 2026-fix) blokkeert statusvoortgang wanneer de vooraf-generatie mislukt, zodat het probleem eerder zichtbaar wordt.
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.