Conversión de Lead a Oportunidad

El flujo de conversión transforma un lead calificado en una oportunidad dentro del pipeline de ventas. Esta página describe el proceso de conversión y el cierre de una oportunidad ganada.

Requisitos y permisos

Permiso	Descripción
crm.ver	Ver leads y oportunidades.
crm.gestionar	Convertir leads y cerrar oportunidades.

Convertir un lead en oportunidad

Cuándo convertir un lead

Convierta un lead cuando:

• El prospecto confirma interés real en comprar.
• Existe un valor económico estimado para la negociación.
• El prospecto pasa de ser un contacto inicial a una oportunidad activa de venta.

Un lead sólo se puede convertir si su estado es NUEVO o EN_GESTION. Los leads en estado CONVERTIDO o DESCARTADO son terminales.

Flujo de conversión

1. Abra el detalle del lead en /crm/leads/[id].
2. En la tarjeta Acciones, pulse Convertir a Oportunidad.
3. Se abre el diálogo LeadConvertDialog.
4. Complete los datos de la oportunidad a crear:

Campo	Descripción
Nombre de la oportunidad	Nombre descriptivo de la negociación.
Etapa inicial	Etapa del pipeline donde inicia la oportunidad.
Monto estimado	Valor económico estimado de la venta (en MXN por defecto).
Asignado a	Usuario responsable de la oportunidad.

5. Pulse Confirmar.

Efecto en el sistema:

• El lead cambia a estado CONVERTIDO y se registra convertidoEn con la fecha actual.
• Se crea la oportunidad con el campo leadOrigenId apuntando al lead de origen, manteniendo la trazabilidad.
• La oportunidad aparece inmediatamente en el tablero kanban (/crm/pipeline) en la etapa seleccionada.
• El evento LeadConvertedEvent queda registrado en el log de auditoría.

Nota

La conversión es atómica: si falla la creación de la oportunidad, el lead no cambia de estado.

Trazabilidad: lead de origen

Una vez creada la oportunidad, el campo Lead de origen en el detalle de la oportunidad muestra el nombre y los datos del lead que le dio origen. Esto permite rastrear la fuente (origen) de cada venta cerrada.

Cierre de oportunidad como ganada

Cuando una negociación concluye con éxito, se cierra la oportunidad como Ganada desde el pipeline.

Flujo de cierre ganado

1. Abra el tablero /crm/pipeline.
2. Haga clic en la tarjeta de la oportunidad para abrir el detalle.
3. Pulse Cerrar como Ganada.
4. En el diálogo CerrarGanadaDialog:

Campo	Descripción
Monto final (MXN)	Monto real de cierre. Pre-llenado con el monto estimado.
Notas (opcional)	Comentarios sobre el cierre, próximos pasos o condiciones acordadas.

5. Pulse Confirmar.

Efecto en el sistema:

• La oportunidad pasa a estado GANADA.
• Se mueve automáticamente a la etapa “Cerrado-Ganado” del pipeline.
• Se registran ganadaEn (fecha del cierre) y cerradaPorUserId (usuario que confirmó).
• Si se modificó el monto, montoEstimado se actualiza al monto final confirmado.
• Se genera el evento OportunidadGanadaEvent.
• La oportunidad deja de aparecer en las columnas activas del tablero.

Precaución

El tenant debe tener configurada una etapa con el nombre exacto “Cerrado-Ganado”. Créela en /crm/configuracion → Etapas del Pipeline antes de intentar cerrar oportunidades.

Cierre de oportunidad como perdida

Si la negociación no prospera:

1. Desde el detalle de la oportunidad, pulse Cerrar como Perdida.
2. Seleccione un Motivo de pérdida de la lista configurada (campo obligatorio).
3. Agregue notas opcionales.
4. Pulse Confirmar.

La oportunidad pasa a estado PERDIDA, registra perdidaEn, motivoPerdidaId y las notas. El evento OportunidadPerdidaEvent queda en el historial.

Los motivos de pérdida se configuran en /crm/configuracion → pestaña Motivos de Pérdida.

Reglas de negocio

Regla	Detalle
Estado terminal de oportunidad	Una oportunidad GANADA o PERDIDA no puede volver a ABIERTA.
Bloqueo optimista	Cada cierre verifica expectedUpdatedAt. Si la oportunidad fue modificada concurrentemente, la operación se rechaza.
Etapa “Cerrado-Ganado”	Debe existir en el tenant. Sin ella, el cierre ganado falla con un error de configuración.
Un lead convertido no se puede convertir dos veces	El sistema lanza un error si se intenta convertir un lead ya en estado CONVERTIDO.

Diferencia entre “Convertir lead” y “Cerrar ganada”

Acción	Sobre	Resultado
Convertir lead	Lead (/crm/leads)	Crea una oportunidad ABIERTA. El lead queda CONVERTIDO.
Cerrar como ganada	Oportunidad (/crm/pipeline)	La oportunidad pasa a GANADA. Se mueve a “Cerrado-Ganado”.

Ambas acciones son independientes: se puede crear una oportunidad sin que exista un lead de origen (desde el tablero directamente), y también se puede descartar un lead sin convertirlo.