CRM - Gestión de prospectos y oportunidades

El módulo CRM centraliza el seguimiento comercial previo al alta o vinculación de un cliente. Cada oportunidad se registra como un prospecto y puede avanzar por las etapas del pipeline, recibir tareas y recordatorios, conservar notas y archivos, y mostrar su historial de actividad.

El inicio resume la situación comercial mediante indicadores. Desde allí se puede trabajar en formato de pipeline o tabla, abrir el detalle de un prospecto, convertirlo en cliente y enviarlo a un tablero Pipeline-Kanban.

Importante: convertir un prospecto crea un cliente nuevo; vincularlo relaciona el prospecto con un cliente que ya existe. Son operaciones diferentes.

1. Iniciá sesión en Plenario.
2. Abrí la opción CRM del menú principal.
3. El sistema valida el permiso CRM.Ver.
4. Al ingresar se muestra el inicio del CRM con los indicadores generales.

Si la opción no aparece o se informa que el usuario no tiene autorización, solicitá al administrador que revise el permiso exacto CRM.Ver.

La barra superior permite alternar entre el inicio, la tabla de prospectos y el pipeline.

Inicio e indicadores

El inicio presenta tres grupos:

Al seleccionar el indicador de prospectos se abre el pipeline. Al seleccionar el de tareas se abre el panel de pendientes.

Vista pipeline

El pipeline presenta una columna por cada estado configurado. Cada tarjeta representa un prospecto y muestra su información comercial principal.

• Arrastrá una tarjeta a otra columna para cambiar su estado.
• Seleccioná una tarjeta para abrir el detalle.
• La cantidad del encabezado indica cuántos prospectos hay en esa etapa.
• El cambio de estado queda registrado automáticamente en la actividad.

Vista tabla

La tabla reúne los prospectos en un listado y permite abrir cualquiera de ellos. Los filtros disponibles permiten acotar por estado, tipo de producto y texto. La búsqueda contempla nombre, apellido, razón social, CUIT, documento y correo electrónico.

Pendientes

La barra superior reúne las tareas y los recordatorios pendientes asignados al usuario para los próximos siete días, incluyendo los vencidos. Desde el panel se puede ir directamente al prospecto y a la solapa correspondiente.

La vista tabla permite combinar los siguientes criterios:

Para volver al listado general, limpiá los filtros aplicados. La búsqueda de clientes usada al vincular consulta solamente clientes no eliminados, busca por nombre o CUIT y devuelve hasta 30 coincidencias.

Los resultados se presentan de acuerdo con la vista elegida:

• En pipeline, cada resultado es una tarjeta dentro de la columna de su estado.
• En tabla, cada prospecto ocupa una fila que permite abrir su detalle.
• En el inicio, los datos se agregan como indicadores y distribución por estado.
• En pendientes, las tareas y los recordatorios se unifican y ordenan para facilitar el seguimiento.

Si una búsqueda no devuelve registros, revisá los filtros, probá con una parte del nombre o CUIT y verificá que el prospecto haya sido cargado.

Crear o editar un prospecto

1. Seleccioná + Nuevo prospecto.
2. Indicá si corresponde a una persona física o jurídica.
3. Completá nombre y apellido o razón social.
4. Cargá CUIT, correo electrónico y teléfono cuando estén disponibles.
5. Elegí el estado del pipeline y el tipo de producto.
6. Informá monto, cuotas y descripción de la oportunidad.
7. Presioná Guardar.

Para modificarlo, abrí el prospecto y elegí Editar.

Control de duplicados: al crear un prospecto con CUIT, el sistema impide el alta si ya existe otro prospecto con el mismo CUIT. En ese caso, editá el registro existente o vinculalo con el cliente correspondiente.

Cambiar la etapa comercial

En la vista pipeline, arrastrá el prospecto hasta el estado de destino. El sistema actualiza la etapa y agrega el movimiento al historial. También se puede editar el prospecto y seleccionar otro estado.

Administrar estados y tipos de producto

La configuración del CRM permite:

• agregar, editar y eliminar estados del pipeline;
• definir la descripción y sigla de cada estado;
• agregar, editar y eliminar tipos de producto;
• indicar nombre, descripción y condición activa del tipo de producto.

Antes de eliminar un elemento, verificá que no esté siendo utilizado por prospectos existentes.

Trabajar con el detalle

El detalle del prospecto organiza la información en las siguientes solapas:

Tareas

1. Abrí el prospecto y seleccioná Tareas.
2. Elegí + Nueva tarea.
3. Completá título, detalle, vencimiento, usuario asignado y prioridad.
4. Guardá la tarea.

Las tareas se pueden editar, marcar como hechas o pendientes y eliminar. La eliminación es lógica: el registro deja de mostrarse, pero conserva su marca de auditoría.

Recordatorios

1. Abrí la solapa Recordatorios.
2. Seleccioná + Nuevo recordatorio.
3. Indicá fecha y hora, texto y usuario asignado.
4. Guardá el aviso.

Los recordatorios pueden marcarse como completados, volver a pendientes o eliminarse. También aparecen en el panel unificado de pendientes del usuario.

Notas

En la solapa Notas, escribí el comentario y seleccioná Agregar. Las notas admiten edición y eliminación. El sistema conserva el autor y las fechas para facilitar el seguimiento.

Adjuntos

La solapa Adjuntos permite cargar, descargar y eliminar archivos asociados al prospecto. Los archivos se almacenan fuera de la base de datos; la tabla del CRM conserva su identificación, ubicación, tipo MIME, tamaño, usuario y fecha.

Convertir o vincular con un cliente

• Convertir a cliente crea un registro nuevo en Clientes con la información disponible y vincula el prospecto con ese alta.
• Vincular cliente busca por nombre o CUIT entre clientes activos y relaciona el prospecto con uno existente.

Antes de convertir, controlá especialmente nombre o razón social, CUIT, domicilio y datos de contacto. Una vez relacionado, el prospecto conserva el identificador del cliente.

Enviar a Pipeline-Kanban

Desde el detalle, seleccioná Enviar a Kanban. Se abre el selector de Pipeline-Kanban para elegir el tablero y crear una tarjeta vinculada con el prospecto.

Caso: registrar y dar seguimiento a una oportunidad hasta convertirla en cliente.

1. Abrí CRM y seleccioná + Nuevo prospecto.
2. Cargá la persona o empresa, CUIT, contacto, producto, monto y estado inicial.
3. Abrí el pipeline y mové la tarjeta a medida que avanza la gestión.
4. Ingresá al detalle, agregá una nota con el resultado del contacto y adjuntá la documentación recibida.
5. Creá una tarea para la próxima gestión y un recordatorio para el responsable.
6. Si el seguimiento necesita un flujo adicional, utilizá Enviar a Kanban.
7. Cuando la operación esté confirmada, buscá primero si el cliente ya existe.
8. Si existe, vinculalo; si no existe, revisá los datos y elegí Convertir a cliente.
9. Consultá la solapa Actividad para comprobar la secuencia completa.

• Definí estados breves y ordenados según el circuito comercial real.
• Usá el CUIT siempre que sea posible: ayuda a evitar prospectos duplicados y a encontrar clientes existentes.
• Asigná vencimiento y responsable a las tareas para que aparezcan correctamente en pendientes.
• Usá notas para decisiones o conversaciones y tareas para acciones que deban completarse.
• Antes de borrar un estado o tipo de producto, revisá que no tenga prospectos asociados.
• Convertí solo después de validar los datos fiscales y de contacto.
• Consultá la actividad cuando necesites reconstruir quién realizó cada movimiento.

En el código analizado no se encontraron permisos separados para crear, editar, convertir, configurar catálogos, administrar tareas o adjuntos. Por lo tanto, el acceso actual al formulario habilita las operaciones expuestas por su interfaz.

Nota para administración: si se requiere separar consulta, edición, conversión o configuración, deben incorporarse objetos de seguridad específicos en el sistema; no alcanza con configurarlos solamente en el perfil.

El CRM es un formulario WinForms que aloja una interfaz HTML/CSS/JavaScript embebida mediante WebView2. No utiliza un sitio PHP ni IIS: CrmBridge intercepta las solicitudes a https://crm.local/ y las resuelve dentro del proceso mediante Entity Framework y los managers del DataModel.

Formularios y pantallas

Managers y clases

Procedimientos almacenados y funciones

El flujo analizado no invoca procedimientos almacenados ni funciones SQL específicos. Opera con Entity Framework sobre VisualPlenarioNetContext. Los KPIs también se calculan con consultas LINQ.

Tablas de base de datos

Las relaciones con prospectos se resuelven principalmente mediante el par polimórfico Entidad = "Prospecto" e Id_Entidad = Clientes_Prospectos.Id. El vínculo comercial final usa Clientes_Prospectos.Id_Cliente = Clientes.id.

Relación con otros módulos y manuales

• Clientes: búsqueda, vinculación y creación del cliente final.
• Pipeline-Kanban: creación de una tarjeta vinculada mediante FormEnviarKanban.
• Seguridad: acceso por CRM.Ver y resolución de usuarios asignados.
• Recordatorios: CRM_Recordatorios es la fuente polimórfica compartida con otras entidades del ERP.
• Manuales relacionados: ABM de Clientes y Pipeline-Kanban.

Notas para soporte

• Si WebView2 no inicializa, el formulario muestra un error y el CRM no carga. Verificar el runtime de Microsoft Edge WebView2.
• crm.html debe estar incluido como recurso embebido del ensamblado; si falta, el bridge devuelve “Recurso crm.html no encontrado”.
• Las respuestas de la API virtual siempre se entregan como JSON. Un error de manager se devuelve a la interfaz con ok = false.
• El constructor utilizado desde VB.NET recibe solamente Id y Nombre del usuario activo.
• Los adjuntos se almacenan en disco. Ante errores de carga o descarga, revisar la ruta base, permisos del directorio y correspondencia con CRM_Adjuntos.Ruta.
• La conversión asigna Clientes.id mediante máximo existente más uno. Si hubiera conversiones concurrentes, revisar posibles colisiones y considerar una estrategia transaccional o de secuencia.
• La conversión completa campos obligatorios de texto con cadenas vacías y usa valores mínimos seguros; los datos administrativos restantes deben revisarse luego en Clientes.
• La eliminación de tareas, notas, recordatorios, adjuntos y vistas es lógica; los listados filtran registros eliminados.
• El único control de autorización localizado está antes de abrir el formulario. Las operaciones internas del bridge no vuelven a validar permisos por acción.
• Los cambios de estado, altas y conversiones relevantes se registran en CRM_Timeline.