Skip to main content
Commencer gratuitement

Troubleshooting & Reference · Article 7.10

« Le statut indique Facture finale émise mais la facture n'a pas de postes »

Une condition de concurrence entre `Mark as completed` et la facture finale pré-générée. Si le pré-rendu a échoué silencieusement avant que vous cliquiez sur Terminer, l'enregistrement de la facture est créé mais le PDF est vide ou incorrect. Récupération : régénérez la facture finale.

Le flux de la facture finale comporte deux étapes : le pré-rendu (en arrière-plan, dès que l'acompte est reçu) et l'envoi (au premier plan, lorsque vous cliquez sur Mark as completed). Le pré-rendu est là où se cachent la plupart des échecs — si Gotenberg défaille pendant le pré-rendu, l'enregistrement INV de remplacement existe mais son PDF est défectueux.

Step by step

  1. Vérifiez la liste déroulante des Documents.

    Regardez INV-XXXX — s'il est absent ou marqué comme échoué, c'est le problème principal.

  2. Cliquez sur Regenerate final invoice

    depuis Actions. Le moteur de rendu se réexécute avec l'état actuel du devis (post-avenant si applicable).

  3. Confirmez le PDF.

    Ouvrez INV-XXXX depuis Documents ; les postes doivent être renseignés.

  4. Réémettre si nécessaire.

    Si vous aviez déjà déclenché l'e-mail avec le PDF défectueux, cliquez sur Resend final invoice email pour envoyer la version corrigée.

Why this works this way

Flux de pré-rendu (tâche Celery prepare_final_invoice) : 1. Générer le HTML de la facture finale (Jinja). 2. Envoyer à Gotenberg → octets PDF. 3. Téléverser dans R2. 4. Enregistrer l'URL dans FinalInvoice.pdf_url.

Si l'étape 2 ou 3 échoue après les tentatives, l'enregistrement FinalInvoice existe avec pdf_url = null. Le statut du devis reste à Deposit paid et un bouton Retry final invoice apparaît. Avant le correctif (début 2026), le bouton n'apparaissait pas toujours — le statut avançait à In work et vous ne pouviez pas savoir que le PDF était manquant jusqu'à ce que vous cliquiez sur Mark as completed. Le comportement actuel (correctif de mai 2026) bloque l'avancement du statut lorsque le pré-rendu échoue, de sorte que le problème remonte plus tôt.

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.

« Le statut indique Facture finale émise mais la facture n'a pas de postes » · Help · Clozo