Lifecycle · Article 2.1
El ciclo de vida de la propuesta, de principio a fin
Cada propuesta atraviesa hasta nueve transiciones de estado, con dos actores (usted y su cliente) que se van pasando el control por el camino. Este es el mapa canónico.
Esta es la página más marcada como favorita en la documentación de Clozo. Cuando no esté seguro de dónde está una propuesta, por qué una acción no está disponible o qué correo acaba de salir, localice el estado actual en el diagrama de abajo y haga clic en su artículo detallado. Cada píldora de estado es un enlace directo.
Una insignia de estado en cada propuesta del panel, la línea de tiempo en la página de detalle de la propuesta y un banner en la parte superior ("A la espera de la firma del cliente", "Pago recibido", etc.) que ofrece un resumen del estado en una frase y en lenguaje claro.
Why this works this way
El ciclo de vida está implementado como una máquina de estados finita en el backend (backend/apps/proposals/models.py:Proposal.STATUS_*). El campo de estado es la fuente de verdad — cada elemento de la interfaz, cada disparador de correo, la visibilidad de los botones y los manejadores de webhook leen de él. Exponemos las transiciones en el diagrama para que pueda anticipar lo que viene sin tener que conocer la implementación.
El formato de carriles con dos actores hace explícito qué transiciones puede disparar usted y cuáles dispara el cliente. La mayoría de manuales de herramientas para autónomos colapsan esto en un único flujo lineal, lo que oculta un hecho clave: desde Enviada hasta Firmada está esperando al cliente; no tiene un botón para hacer avanzar el estado. Algunos estados (como Vista) solo los puede disparar el cliente.
Troubleshooting
Keep reading
Lifecycle
Status: Draft — the only status where you can edit everything
A draft is a proposal you've started but not yet sent. It's editable in every field; nothing has been emailed, no invoice exists, no audit trail beyond your edits.
Lifecycle
Status: Sent — the proposal is in your client's inbox
You've clicked `Send`. The PDF is rendered, the email is on its way, the proposal number is assigned, and the audit trail starts here. Now you wait — until the client opens it (`Viewed`) or signs (`Signed`).
Lifecycle
Status: Signed — legally binding, audit trail captured
The client clicked Sign. Clozo collects an eIDAS-compliant evidence stack, generates the signed Service Agreement PDF, fires confirmation emails to both parties, and queues the deposit invoice. The proposal is now a contract.
Lifecycle
Status: Awaiting final payment, then Paid
You've issued the final invoice. The client now owes the remaining balance (full amount minus the deposit they already paid). When the money lands, status flips to `Paid` and the final receipt is generated.
Lifecycle
Timeline events: every event type explained
The Timeline component on every proposal detail page records 21+ event types. This is the canonical list with descriptions and triggers, useful when auditing what happened on a proposal.