ABM de Clientes Prospectos · Manual Plenario v14

Detalle

Campo	Valor
Manual de Usuario	ABM de Clientes Prospectos - Plenario v14
Módulo	Inicio / Clientes
Descripción	Cómo cargar, modificar, administrar y convertir leads en clientes dentro de Sistemas Plenario v14

Introducción

Un cliente prospecto, también conocido como "lead", es una persona o empresa que muestra interés en tus productos o servicios pero aún no es un cliente formal. Representa una oportunidad potencial de negocio que se nutre hasta convertirla en cliente.

Característica	Descripción
Interés manifestado	El prospecto tomó alguna acción que indica interés (consulta, solicitud de demostración, descarga de un recurso, participación en un evento, etc.)
No es un cliente actual	A pesar del interés, todavía no concretó una compra ni firmó un contrato
Etapa del embudo	Se encuentra en las primeras etapas del embudo de ventas, donde se cultiva y educa la relación
Calificación	Se clasifica según su probabilidad de conversión (caliente, tibio, frío) para enfocar el esfuerzo comercial
Importancia	Representan una fuente continua de nuevos clientes y son clave para el crecimiento

Acceso al módulo

Se accede desde la solapa Archivos, opción Clientes Prospectos.

Importante: El acceso requiere la asignación de permisos que deben solicitarse al administrador del sistema. Las acciones de Nuevo, Modificar, Eliminar y Generar Cliente cuentan con permisos independientes.

Pantalla principal

Al ingresar a la pantalla se muestra una grilla con todos los clientes prospectos y una barra de herramientas con las acciones disponibles.

Configuración (tablas auxiliares)

Desde el grupo de Configuración de la pantalla se administran las tablas que alimentan los desplegables del prospecto.

Opción	Descripción
Tipos de Productos	ABM de los tipos de producto disponibles para los prospectos
Estados	ABM de los estados posibles de un prospecto

Filtros de búsqueda

La grilla permite filtrar la información cargada. Además del filtro por columnas de la propia grilla, la búsqueda contempla los siguientes criterios.

Campo	Descripción
N° ID	Filtra por el número de ID del cliente prospecto
Nombre / Razón Social	Filtra por coincidencia en el nombre o la razón social
Documento	Filtra por número de documento
CUIT	Filtra por CUIT (ignora los guiones)
Email	Filtra por coincidencia en el correo electrónico
Teléfono	Filtra por coincidencia en el teléfono
Sexo	Filtra por sexo
Tipo de persona	Filtra por Física o Jurídica
Descripción	Filtra por la descripción del prospecto
Rango de fechas	Permite filtrar por fecha de alta desde y hasta, dentro de un rango específico

Resultados

La grilla muestra todos los clientes prospectos que cumplen con los criterios de búsqueda. Sobre la grilla se pueden realizar las siguientes operaciones.

Edición rápida del Estado desde la grilla

En la grilla se puede cambiar el Estado del prospecto directamente sobre la columna correspondiente. Al modificar el valor, el sistema pide confirmación y guarda el cambio sin necesidad de abrir la ventana de modificación.

Acciones disponibles

La barra de herramientas presenta las siguientes acciones.

Acción	Descripción
Buscar	Refresca la grilla y muestra todos los clientes prospectos
Nuevo	Abre la ventana de alta para cargar un nuevo cliente prospecto (requiere permiso)
Modificar	Abre la ventana de edición del cliente prospecto seleccionado (requiere permiso)
Eliminar	Elimina el cliente prospecto seleccionado, previa confirmación (requiere permiso)
Generar Cliente	Crea un cliente real a partir de los datos del prospecto seleccionado (requiere permiso)
Ver	Abre la ficha del cliente ya vinculado al prospecto

Importante: Para Generar Cliente o Ver primero debe seleccionar un registro válido en la grilla.

Ventana de alta y modificación

Al presionar Nuevo o Modificar se abre una ventana con varias solapas.

Importante: Es obligatorio completar al menos uno de estos campos: Nombre, Apellido o Razón Social. Si los tres quedan vacíos, el sistema no permite guardar.

Solapa Personales

Campo	Descripción
Tipo de persona	Se elige si es persona Física o Jurídica
CUIT	CUIT del cliente prospecto
Razón Social	Razón social (usada principalmente para personas jurídicas)
Nombre	Nombre de la persona
Apellido	Apellido de la persona
DNI	Número de documento
Nro Tramite	Número de trámite del documento
Email	Correo electrónico de contacto
Sexo	Se elige Masculino o Femenino
Telefono	Teléfono de contacto
Cliente	ID de un cliente existente; con los tres puntitos se abre el listado de clientes para elegir con doble clic
Estado	Estado del prospecto. Se puede escribir un estado nuevo (se registra automáticamente) o elegir uno ya existente
Tipo de producto	Tipo de producto de interés. También admite escribir uno nuevo (se registra automáticamente) o elegir uno existente
Monto	Monto estimado de la operación
Cuotas	Cantidad de cuotas estimadas

Solapa Domicilio

Campo	Descripción
Calle	Nombre de la vía pública donde se ubica el domicilio
Nro.	Número que identifica la ubicación exacta dentro de la calle
Piso	Nivel del edificio donde se encuentra la dirección
CP	Código postal que identifica la región geográfica
Barrio	Nombre del vecindario o área dentro de la localidad
Entre Calles	Calles cercanas al domicilio, útiles para mayor precisión
Y	Segunda calle del campo "Entre Calles"
Localidad	Ciudad o pueblo donde se encuentra la dirección
País	País del domicilio. Se elige del listado con los tres puntitos
Provincia	Provincia del domicilio. Se elige del listado con los tres puntitos

Solapa Observaciones

Permite cargar observaciones libres sobre el prospecto.

Solapa Descripción

Permite cargar una descripción libre del prospecto.

Solapa Estudios Jurídicos

Campo	Descripción
Linea	ID de una línea de crédito (retail) cargada en el sistema; con los tres puntitos se abre el listado para elegir con doble clic
Prestador	ID de un prestador / entidad cargado en el sistema; con los tres puntitos se abre el listado para elegir con doble clic
Capital Original	Capital original de la deuda
Remanente	Remanente de la deuda original
Deuda Actualizada	Capital original actualizado a la fecha
Bonificación %	Porcentaje de bonificación que se aplica sobre la deuda actualizada
Total Negociado	Total resultante de la negociación
Nro. Crédito	Número de crédito asociado
Tyc Enviado	Fecha en que se enviaron los términos y condiciones
Tyc Aceptado	Fecha en que el prospecto aceptó los términos y condiciones
Metadatos	Datos técnicos adicionales del prospecto; se pueden copiar al portapapeles

Ejemplo práctico

Generar Cliente (conversión de prospecto a cliente). Es la acción que convierte un lead en un cliente formal del sistema.

Seleccionar el prospecto — Posiciónese sobre el registro en la grilla.
Presionar Generar Cliente — El sistema pide confirmación antes de continuar.
Confirmar — Se crea el cliente con los datos del prospecto y se informa el número de cliente generado.

Importante: Una vez generado el cliente, el prospecto queda vinculado a ese cliente. El botón Generar Cliente se deshabilita automáticamente para ese registro para evitar duplicados, y queda disponible el botón Ver para abrir la ficha del cliente.

Consejos útiles

Complete al menos uno de los campos Nombre, Apellido o Razón Social: son obligatorios para poder guardar.
Aproveche la edición rápida del Estado desde la grilla para actualizar prospectos sin abrir la ventana de modificación.
Al escribir un Estado o Tipo de Producto nuevo, el sistema lo registra automáticamente y queda disponible para futuros registros.
Mantenga actualizadas las tablas auxiliares (Estados y Tipos de Productos) desde Configuración para ordenar el embudo de ventas.

Preguntas frecuentes

¿Cómo convierto un prospecto en cliente?

Seleccione el prospecto en la grilla y presione Generar Cliente. El sistema pedirá confirmación y, al aceptar, creará el cliente informando su número. A partir de ese momento el prospecto queda vinculado al cliente y el botón Generar Cliente se deshabilita para ese registro.

¿Por qué no me deja guardar un prospecto nuevo?

Debe completar al menos uno de los campos Nombre, Apellido o Razón Social. Si los tres están vacíos el sistema no permite guardar.

Escribí un Estado o Tipo de Producto que no existía, ¿qué pasa?

El sistema lo registra automáticamente como nuevo valor y lo asocia al prospecto, quedando disponible para futuros registros. También puede administrarlos desde Configuración (Estados / Tipos de Productos).

¿Por qué el botón Generar Cliente aparece deshabilitado?

Porque el prospecto seleccionado ya tiene un cliente generado y vinculado. En ese caso utilice el botón Ver para abrir la ficha del cliente.

Permisos

El acceso al módulo y sus acciones requiere permisos que deben solicitarse al administrador del sistema. Las acciones cuentan con permisos independientes.

Permiso	Descripción
Acceso al módulo	Permite ingresar a la pantalla de Clientes Prospectos
Nuevo	Permite cargar un nuevo cliente prospecto
Modificar	Permite editar un cliente prospecto existente
Eliminar	Permite eliminar un cliente prospecto
Generar Cliente	Permite convertir un prospecto en cliente formal

Información técnica

Basada en el análisis del formulario real de la v14 (FormClientes_Prospectos.cs, proyecto VPNET_WinForms, carpeta Cliente). El módulo está implementado en C# (no en VB).

Formularios y pantallas

Form	Rol
`FormClientes_Prospectos`	Pantalla principal: grilla + barra de herramientas (DevExpress). Hereda de `FrmResult`.
`FormClientes_Prospectos_AddMod`	Ficha de alta/modificación (se abre con `ShowDialog`; recibe el `Id`, 0 = alta).
`FormClientes_Prospectos_Estados` / `FormClientes_Prospectos_Estados_AddMod`	ABM del catálogo de Estados (Configuración).
`FormClientes_Prospectos_TipoProductos` / `FormClientes_Prospectos_TipoProductos_AddMod`	ABM del catálogo de Tipos de Producto (Configuración).
Ficha del cliente (`frmClientes`)	Se abre desde el botón Ver vía `VPNetApp.Main.MostrarCliente`.

Managers y clases de negocio

Componente	Detalle
`Clientes_Prospectos_Manager`	Manager EF del prospecto; hereda de `Base_Manager<Clientes_Prospectos>`. Ruta `VPNET_DataModel\Manager\Gestion\ClsClientes`. Valida el alta, auto-registra Estado/Tipo de Producto y arma la búsqueda por LINQ sobre `VisualPlenarioNetContext`.
`Clientes_Prospectos_Estados_Manager`	Catálogo de estados; `RegistrarEstado(texto)` da de alta un estado nuevo y devuelve su Id.
`Clientes_Prospectos_Tipo_Producto_Manager`	Catálogo de tipos de producto; `RegistrarTipoProducto(texto)`.
`Clientes_Manager`	En Generar Cliente, `new Clientes_Manager().Save(prospecto)` crea el cliente real.
`ClassVisualPlenarioNET.Sistema.clsSeguridad`	`IsAllowedObject(...)` valida cada permiso antes de habilitar la acción.

Stored Procedures y funciones

SP	Uso
—	El ABM se resuelve por EF Code First vía `Clientes_Prospectos_Manager` (LINQ sobre `VisualPlenarioNetContext`); no usa Stored Procedures.

Tablas de base de datos

Tabla	Uso
`Clientes_Prospectos`	Entidad principal: datos personales, domicilio, estudio jurídico, montos, `Id_Cliente` del cliente generado y auditoría (`Id_User_Add/Mod`, `Fecha_Add/Mod`).
`Clientes_Prospectos_Estados`	Catálogo de estados del prospecto.
`Clientes_Prospectos_Tipo_Producto`	Catálogo de tipos de producto.
`Clientes`	Cliente real generado a partir del prospecto (vía `Clientes_Manager`).

Permisos reales

Strings exactos validados con clsSeguridad.IsAllowedObject.

Permiso	Acción
`Archivos.Seguridad.ClientesProspectos.Nuevo`	Botón Nuevo (alta)
`Archivos.Seguridad.ClientesProspectos.Modificar`	Botón Modificar
`Archivos.Seguridad.ClientesProspectos..Eliminar`	Botón Eliminar (el string tiene un punto doble, tal como está en el código)
`Archivos.Seguridad.ClientesProspectos.Generar.Cliente`	Botón Generar Cliente
`Archivos.Clientes.Modificar`	Botón Ver (reutiliza el permiso de modificación de Clientes)
`Archivos.Seguridad.ClientesProspectos.TipoProducto.Nuevo` / `.Modificar` / `.Eliminar`	ABM de Tipos de Producto (`FormClientes_Prospectos_TipoProductos`)

Relación con otros módulos / manuales

Se conecta con	Cómo
ABM de Clientes	Generar Cliente crea un registro en `Clientes`; el botón Ver abre la ficha del cliente vinculado.
Módulo Clientes (overview)	El prospecto convertido pasa a formar parte del módulo Clientes.

Notas para soporte

Estado y Tipo de Producto auto-registrados: en Save, si se escribe texto libre en Estado o Tipo de Producto, el manager llama a RegistrarEstado / RegistrarTipoProducto, lo da de alta en su catálogo y vincula el Id.
Validación de alta: Clientes_Prospectos_Manager.Save exige al menos uno de Nombre, Apellido o Razon_Social; si los tres están vacíos devuelve 0 y no guarda.
Generar Cliente: si el prospecto ya tiene Id_Cliente, el botón se deshabilita (FocusedRowChanged y tras generar). El permiso se chequea después de validar que haya registro seleccionado.
Botón Ver — posible bug: barButtonItem1_ItemClick_1 llama MostrarCliente(curr.Id) pasando el Id del prospecto, no curr.Id_Cliente; podría abrir un cliente equivocado. A revisar.
Permiso Eliminar con typo: el string es Archivos.Seguridad.ClientesProspectos..Eliminar (punto doble). Si el permiso se da de alta normalizado, el chequeo puede no coincidir.
Permisos cruzados en FormClientes_Prospectos_Estados: sus botones Nuevo/Modificar usan los strings de TipoProducto (...TipoProducto.Nuevo/.Modificar) y Eliminar usa Prestamos.Creditos.Refinancicion.Eliminar (permiso de otro módulo). A revisar.
Handlers vacíos / controles ocultos: gridView1_RowClick no hace nada; en Load se ocultan TSM_Nuevo, TSM_Modificar, TSM_Eliminar (menú contextual no usado).