Propuestas al Cliente

Una Propuesta al Cliente es una capa de presentación construida sobre una estimación — distinta de la estimación misma. Selecciona qué información de costos es visible para el cliente, controla el modo de visualización de precios, gestiona cómo se redistribuyen los márgenes antes de su emisión, genera secciones narrativas y produce un documento PDF formateado para entrega.

Crea una Propuesta Desde una Estimación

Las propuestas al cliente pertenecen a una revisión de estimación específica. Para crear o gestionar una:

Abre el proyecto y selecciona la revisión de estimación desde Estimaciones.
Abre su Espacio de Estimación.
Selecciona la pestaña Propuesta.
Crea una propuesta en borrador o abre una propuesta existente para esa revisión.
Configura el contenido visible para la audiencia y luego finaliza y registra la entrega cuando esté lista.

La pestaña Propuesta es un centro de control: muestra el estado del borrador, los totales y la hora de la última modificación, y abre el editor de propuestas a página completa para trabajo detallado. El registro del Cliente contiene la relación, contactos, proyectos, solicitudes y archivos. No es donde se construyen ni se entregan las propuestas.

Modos de Visualización de Precios

Las Propuestas al Cliente soportan cuatro modos de visualización de precios, dando control total sobre cuánto detalle de costo ve el cliente:

Modo	Significado
Solo Total	Solo el total final — la vista predeterminada, más conservadora
Resumen de Valor por Alcance	Agrupaciones a nivel de alcance con su valor, sin desglose de costos
Resumen Comercial	Vista comercial agregada, adecuada para revisión ejecutiva o del cliente
Respaldo Detallado de Estimación	Precios desglosados completos — precios a nivel de sección y partida, cantidades, tarifas unitarias

Interruptores de visibilidad adicionales controlan el desglose de costos, las cantidades, los precios unitarios, la separación de materiales-mano de obra-gastos, y la inclusión de anexos. Estos controles permiten que la misma estimación sirva tanto para revisión interna como para presentación externa sin duplicar datos.

Distribución de Margen

La Distribución de Margen es una forma controlada de mover el margen entre las filas reveladas de una propuesta antes de que salga, sin cambiar el total. Es el registro que une lo que Darwin mantuvo internamente con lo que salió — y demuestra que el total no cambió.

Cuándo Está Disponible

La función está deliberadamente no disponible en la mayoría de las propuestas. Donde no se revelan precios unitarios, la agregación ya oculta la base de costos, por lo que no hay nada que proteger. Darwin muestra una lista de verificación de requisitos — nunca solo el primer fallo — y todas estas condiciones deben cumplirse:

la propuesta está en Borrador
revela precios unitarios
no muestra la separación de materiales/mano de obra/gastos
la agrupación produce tarifas unitarias (al menos una fila con tarifa)
existen al menos dos filas elegibles con tarifas

Las filas no elegibles permanecen visibles y de solo lectura, con su motivo, y contribuyen su monto balanceado sin cambios a ambos lados del total.

Ciclo de Vida y Autoridad

Borrador → Enviada → Aprobada | Rechazada → Reemplazada

El estimador mueve montos entre las filas reveladas; el documento debe cuadrar hasta el último centavo para guardarse. Al enviar, una tarea de acción requerida se enruta al aprobador del proyecto. Solo el aprobador del proyecto puede aprobar o rechazar, y al aprobar la versión se vuelve inmutable — se registra un hash de contenido y se estampa la firma. Las tareas de aprobación se enrutan como tareas de enlace profundo para que una solicitud de aprobación nunca se pierda silenciosamente.

El día de la licitación, un rechazo no es un callejón sin salida: devuelve la distribución a un Borrador editable mientras preserva el contenido exacto enviado como un evento de revisión inmutable, para que el estimador pueda actuar sobre el comentario sin perder su trabajo.

Política de Desviación

Dos umbrales configurables por tenant capturan la intención sin negar nunca el trabajo:

Umbral	Predeterminado	Efecto
Racionalización	±15%	Una razón declarada se vuelve obligatoria
Advertencia	±30%	El espacio de trabajo advierte de manera prominente; la razón sigue siendo obligatoria

Una detención dura solo empujaría el trabajo a una hoja de cálculo — perdiendo exactamente el registro que la función existe para conservar.

Límites

La separación M/MO/G está prohibida en un artefacto distribuido — imprimir la composición de costos junto al margen redistribuido es contraproducente
Ningún valor distribuido se filtra a los datos internos de costos — el control de costos, la varianza y la atribución de módulos son idénticos byte a byte antes y después de una distribución
La vista previa de un artefacto distribuido está marcada con marca de agua para que no pueda confundirse con un documento emitible

El Editor de Propuesta a Página Completa

Más allá de la tarjeta del panel derecho de la pestaña Propuesta, un editor dedicado a página completa (/projects/:projectId/estimations/:estimationId/proposals/:proposalId) aloja el flujo de trabajo completo de la propuesta:

Encabezado y narrativa de la propuesta — el título, las secciones narrativas y los paneles de precios/visibilidad
Resumen de instantánea — los totales finalizados con su linaje de aprobación
Tarjeta de Distribución de Margen — abre el espacio de trabajo de distribución cuando está disponible
Registrar Decisión — la respuesta del cliente, registrada contra la propuesta

El editor protege el trabajo sin guardar contra la navegación de propuestas, los cambios de pestaña, el cierre del navegador, Vista Previa, Enviar y Finalizar. La Vista Previa requiere un borrador vinculado y guardado, para que una asignación más antigua nunca se renderice mientras valores más nuevos están en pantalla.

Ciclo de Vida del Estado

Borrador → Finalizada → Enviada → Aceptada / Rechazada / Reemplazada

Borrador — la propuesta es editable; se configuran los ajustes de visibilidad y la narrativa
Finalizar — el costo queda fijado por el aprobador del proyecto. Finalizar requiere al aprobador del proyecto y una aprobación formal exacta, no preliminar, y es donde el monto de venta aprobado, el cronograma congelado, cualquier total de distribución y el total de la propuesta se concilian atómicamente. Registra qué aprobación produjo la cifra y cómo se obtuvo esa cifra, localiza el cronograma y calcula un hash de contenido para verificación posterior. A partir de este punto, la propuesta es inmune a cambios posteriores en la estimación fuente. Regenerar requiere crear una nueva propuesta
Enviada — marca la entrega al cliente. Darwin renderiza y retiene los bytes exactos del PDF que salieron, con metadatos inmutables. Enviar registra la emisión en Darwin; no demuestra que el correo se entregó ni que el destinatario recibió el PDF
Aceptada / Rechazada / Reemplazada — estados terminales que reflejan la respuesta del cliente

Decisiones y Razones de Pérdida

La respuesta del cliente a una propuesta finalizada se registra como un registro de decisión separado, no como un campo en la propuesta. Los resultados de decisión incluyen:

Aceptada — la propuesta fue aceptada
Rechazada — la propuesta fue rechazada, opcionalmente con una razón de pérdida estructurada
Negociación Solicitada — el cliente solicita cambios; se puede crear una nueva propuesta

Cada decisión registra el número de propuesta, el monto, la moneda y el código de estimación tal como estaban al momento de la decisión. Las decisiones se numeran por proyecto mediante DecisionCycleNumber, permitiendo a Darwin rastrear una negociación a través de múltiples rondas de propuesta.

Narrativa de la Propuesta

Las propuestas al cliente pueden incluir secciones narrativas generadas por IA o redactadas manualmente que explican:

Alcance del trabajo cubierto por la estimación
Supuestos clave y exclusiones
Base de precios y contexto de mercado
Ajustes comerciales o alternativas

La capa narrativa es independiente de los datos de costo, permitiendo edición independiente.

Límite de Audiencia

Una propuesta recién creada usa por defecto los ajustes de visibilidad más conservadores — precios Solo Total, sin desglose de costos, sin anexo detallado. El respaldo de costo detallado solo se genera cuando se habilita explícitamente, y el respaldo detallado de estimación nunca expone las filas internas de costo base de Darwin.

Rol en el Flujo de Trabajo

Una estimación se construye y se revisa internamente
Se crea una Propuesta al Cliente a partir de la estimación (o se clona de una propuesta anterior) como Borrador
Se configuran los ajustes de visibilidad y la narrativa
Cuando es elegible, el estimador distribuye el margen y el aprobador del proyecto lo aprueba (Distribución de Margen)
El aprobador finaliza — fijando el total conciliado — y Enviar marca la entrega
La respuesta del cliente se registra como una decisión
Un resultado de rechazo o solicitud de negociación puede llevar a una estimación revisada y una nueva propuesta

Próximos Pasos

➡️ Espacio de Estimación
➡️ Revisiones