Carteras de Clientes

Vision general

Las Carteras de Clientes permiten organizar y agrupar clientes bajo la responsabilidad de un colaborador (owner). Cada cartera tiene un tipo (Principal o Secundario), un estado (Vigente o Baja), un periodo de actividad opcional y puede contener multiples clientes asignados.

Este modulo se compone de dos pantallas:

1. Listado de carteras — crea, edita y elimina carteras de clientes
2. Detalles de cartera — visualiza, agrega y quita clientes dentro de una cartera especifica

La pantalla principal muestra el titulo "Carteras clientes" con la descripcion "Muestra el listado y las herramientas para gestionar las carteras".

---

Pantalla 1: Listado de carteras

Barra de navegacion

Breadcrumb: Comercial / Carteras clientes

El enlace Comercial en el breadcrumb es navegable y redirige al modulo principal del Sistema de Gestión Comercial.

Barra de menu

La barra de menu se muestra como un menubar horizontal con las siguientes opciones:

Opcion	Icono	Descripcion
Nuevo	Configuracion	Menu desplegable con opciones para crear
Nuevo > Cartera cliente	Mas (+)	Abre el formulario para crear una nueva cartera de clientes
Actualizar	Recarga	Recarga la lista de carteras desde el servidor
Exportar a	Descarga	Menu desplegable con opciones de exportacion
Exportar a > Exportar a excel	Archivo Excel	Exporta la lista a formato Excel
Exportar a > Exportar a pdf	Archivo PDF	Exporta la lista a formato PDF
Exportar a > Exportar a csv	Archivo CSV	Exporta la lista a formato CSV
Eliminar	Papelera	Elimina los registros seleccionados en la tabla

Tabla de carteras

La tabla muestra el listado de carteras de clientes registradas en el sistema. Soporta carga diferida (lazy loading) con paginacion de 10 registros por pagina. Las columnas son redimensionables y la tabla tiene scroll vertical con altura fija de 350px.

Columnas

Columna	Ancho	Ordenable	Descripcion
Casilla de seleccion	40px	No	Casilla de verificacion para seleccionar registros individualmente. En el encabezado hay una casilla para seleccionar/deseleccionar todos los registros de la pagina actual
Tipo	150px	Si	Clasificacion de la cartera: PRINCIPAL o SECUNDARIO
Nombre	Automatico	Si	Nombre descriptivo de la cartera. Generalmente corresponde al nombre completo del owner
Owner	Automatico	Si	Nombre completo del colaborador responsable de la cartera, mostrado como "{nombres} {apellido_paterno} {apellido_materno}"
Tipo Owner	Automatico	Si	Tipo del colaborador asignado como owner
Acciones	80px	No	Boton con icono de puntos suspensivos (...) que abre el menu contextual del registro

Mensaje sin datos

Cuando no hay registros que mostrar, la tabla muestra el mensaje: "No se encontraron datos" con un icono de advertencia.

Paginacion

La tabla incluye controles de paginacion centrados debajo de la tabla:

• Flechas dobles izquierda: ir a la primera pagina
• Flecha izquierda: ir a la pagina anterior
• Selector de pagina: desplegable con filtro que muestra "{pagina actual} de {total paginas}" para saltar a cualquier pagina
• Flecha derecha: ir a la pagina siguiente
• Flechas dobles derecha: ir a la ultima pagina

Menu contextual

El menu contextual se puede acceder de dos formas:

• Clic derecho sobre un registro en la tabla
• Seleccionando el boton de acciones (icono ...) en la columna Acciones

Opciones del menu contextual

Opcion	Icono	Descripcion
Ver detalles	Carpeta abierta	Navega a la pantalla de detalles de la cartera para ver y gestionar los clientes asignados
Editar	Lapiz	Abre el formulario de edicion con los datos de la cartera seleccionada precargados
Eliminar	X	Ejecuta la accion de eliminar la cartera seleccionada

---

Crear una cartera / Editar una cartera

Al seleccionar Nuevo > Cartera cliente en la barra de menu, o Editar en el menu contextual, Davix abre un dialogo a pantalla completa.

Encabezado del formulario

El dialogo muestra:

• Breadcrumb: Comercial / Clientes / Nuevo (los dos primeros son enlaces navegables)
• Titulo: "Nueva empresa"
• Descripcion: "Aqui puede editar la lista de clientes"

Mientras se cargan los datos del formulario, Davix muestra el mensaje "Cargando sus datos" con un indicador de carga animado y una barra de progreso.

Seccion: Detalles del Owner

Esta seccion muestra la instruccion: "Seleccione el owner para la cartera."

Campo	Tipo	Obligatorio	Descripcion
Owner	Desplegable con busqueda	Si	Colaborador responsable de la cartera. El desplegable muestra la lista de colaboradores activos del sistema en formato "{numero_documento} - {nombres} {apellido_paterno} {apellido_materno}". Tooltip: "Seleccione el owner"

Seccion: Detalles de cartera

Esta seccion muestra la instruccion: "Se tiene que rellenar los campos que contengan (*) obligatoriamente que se requiere para el registro."

Campo	Tipo	Obligatorio	Descripcion
Nombre	Texto	Si	Nombre descriptivo de la cartera. Se autocompleta al seleccionar un owner pero es editable. Tooltip: "Ingrese el nombre"
Tipo	Desplegable	Si	Clasificacion de la cartera. Tooltip: "Seleccione el tipo"
Detalle	Texto	No	Descripcion adicional o notas sobre la cartera. Tooltip: "Ingrese el detalle"
Estado	Botones de seleccion	No	Estado de la cartera. Por defecto: Vigente. Tooltip: "Seleccione el estado"

Tipos de cartera

Tipo	Descripcion
Principal	Cartera principal del colaborador. Es la que se usa automaticamente al crear clientes desde Mis Clientes
Secundario	Cartera adicional para organizar clientes por criterios especificos (territorio, segmento, etc.)

Estados de cartera

Estado	Icono	Valor	Descripcion
Vigente	Check	1	La cartera esta activa y operativa (valor por defecto)
Baja	Reloj	2	La cartera esta inactiva o fuera de servicio

Seccion: Fecha de actividad

Campo	Tipo	Obligatorio	Descripcion
Fecha de actividad?	Interruptor (toggle)	No	Activa o desactiva los campos de fecha. Cuando esta desactivado, los campos de fecha se muestran en solo lectura y vacios
Fecha inicio	Selector de fecha	Si (si el interruptor esta activo)	Fecha de inicio del periodo de actividad de la cartera. Se inicializa con la fecha actual al activar el interruptor. Tooltip: "Ingrese la fecha de inico"
Fecha fin	Selector de fecha	Si (si el interruptor esta activo)	Fecha de fin del periodo de actividad de la cartera. Tooltip: "Ingrese la fecha final"

Mensajes de error de campos obligatorios

Campo	Mensaje cuando esta vacio
Owner	"* Seleccione tipo documento valido"
Nombre	"* Ingrese un nombre"
Tipo	"* Seleccione tipo documento valido"
Fecha inicio (si activado)	"* Ingrese una fecha inicio"
Fecha fin (si activado)	"* Ingrese una fecha fin"

Guardar el formulario

Boton	Descripcion
Cancelar	Cierra el dialogo sin guardar los cambios
Guardar	Valida el formulario y guarda la cartera. Muestra un indicador de carga mientras se procesa. El boton se deshabilita durante el guardado

Proceso de guardado

1. Davix valida que todos los campos obligatorios esten completos
2. Si hay errores de validacion:
   • Los campos con error se resaltan en rojo
   • Debajo de cada campo con error aparece el mensaje correspondiente
   • Se muestra un toast de error: "Revise bien, hay formularios por validar."
3. Si todo es correcto:
   • Para un nuevo registro: Davix muestra "Registrado con exito"
   • Para una edicion: Davix muestra "Se ha actualizado con exito"
   • El dialogo se cierra automaticamente
   • La lista de carteras se actualiza

---

Editar una cartera

1. Haz clic derecho sobre la cartera en la tabla y selecciona Editar, o selecciona el boton de acciones (...) y luego Editar
2. Davix abre el formulario a pantalla completa con los datos de la cartera precargados:
   • Owner seleccionado en el desplegable
   • Nombre, tipo, detalle y estado
   • Si tiene fechas de actividad, el interruptor esta activo y las fechas estan precargadas
3. Modifica los campos necesarios
4. Selecciona Guardar
5. Davix muestra: "Se ha actualizado con exito"

---

Eliminar una cartera

1. Haz clic derecho sobre la cartera en la tabla y selecciona Eliminar, o selecciona el boton de acciones (...) y luego Eliminar
2. Davix muestra un dialogo de confirmacion con el mensaje: "Estas seguro de proceder con la eliminacion?"
3. El dialogo presenta dos botones:
   • Si: confirma la eliminacion
   • No: cancela la operacion y cierra el dialogo
4. Si confirmas, Davix elimina el registro y muestra el toast: "Eliminado."
5. La lista de carteras se actualiza automaticamente

---

Pantalla 2: Detalles de cartera (clientes asignados)

Para acceder a los detalles de una cartera:

1. Haz clic derecho sobre la cartera en la tabla y selecciona Ver detalles
2. Davix navega a la pantalla de detalles de la cartera seleccionada

Barra de navegacion

Breadcrumb: Comercial / Carteras clientes / {nombre de la cartera}

Los enlaces Comercial y Carteras clientes son navegables. El nombre de la cartera se muestra dinamicamente segun la cartera seleccionada.

La pantalla muestra el titulo "Carteras clientes detalles" con la descripcion "Muestra el listado y las herramientas para gestionar los detalles de las carteras".

Barra de menu

Opcion	Icono	Descripcion
Nuevo	Configuracion	Menu desplegable con opciones
Nuevo > Agregar cliente	Mas (+)	Abre el formulario para agregar un cliente a la cartera
Actualizar	Recarga	Recarga la lista de clientes de la cartera
Exportar a	Descarga	Menu desplegable (Excel, PDF, CSV) — sin funcionalidad implementada
Eliminar	Papelera	Elimina los registros seleccionados — sin funcionalidad implementada

Tabla de clientes en la cartera

La tabla muestra los clientes asignados a la cartera seleccionada. Soporta carga diferida (lazy loading) con paginacion de 10 registros por pagina. Las columnas son redimensionables y la tabla tiene scroll vertical con altura fija de 350px.

Columnas

Columna	Ancho	Ordenable	Descripcion
Casilla de seleccion	40px	No	Casilla de verificacion para seleccionar registros individualmente
Tipo Documento	150px	Si	Tipo de documento del cliente (DNI, RUC, etc.)
N. Documento	150px	Si	Numero de documento del cliente
Nombres	Automatico	Si	Nombres del cliente
Apellido paterno	Automatico	Si	Primer apellido del cliente
Apellido materno	Automatico	Si	Segundo apellido del cliente
Acciones	80px	No	Boton con icono de puntos suspensivos (...) que abre el menu contextual del registro

Mensaje sin datos

Cuando no hay clientes asignados a la cartera, la tabla muestra el mensaje: "No se encontraron datos" con un icono de advertencia.

Paginacion

Mismos controles de paginacion que la pantalla de listado de carteras (primera, anterior, selector, siguiente, ultima pagina).

Menu contextual de detalles

Opcion	Icono	Descripcion
Quitar	X	Quita al cliente de la cartera (no elimina al cliente del sistema, solo lo desasocia de esta cartera)

---

Agregar un cliente a la cartera

1. Desde la pantalla de detalles de la cartera, selecciona Nuevo > Agregar cliente en la barra de menu
2. Davix abre un dialogo a pantalla completa

Encabezado del formulario

El dialogo muestra:

• Breadcrumb: Comercial / Carteras clientes / {nombre de la cartera} / Agregar de cliente (los tres primeros son enlaces navegables)
• Titulo: "Agregar cliente"
• Descripcion: "Aqui puede editar la lista de detalles de cartera"

Seccion: Detalles de la Cartera

Muestra la informacion de la cartera en modo solo lectura:

Campo	Descripcion
Nombre	Nombre de la cartera (texto en negrita, no editable). Tooltip: "Nombre de cartera de cliente"
Propietario	Nombre completo del owner de la cartera (texto en negrita, no editable). Tooltip: "Datos del propietario"

Seccion: Detalles del Cliente

Esta seccion muestra la instruccion: "Seleccione el owner para la cartera."

Campo	Tipo	Obligatorio	Descripcion
Cliente	Desplegable con busqueda asincrona	Si	Busca y selecciona el cliente a agregar. Tooltip: "Seleccione el cliente"

Busqueda asincrona de clientes

El campo Cliente tiene busqueda asincrona: al escribir en el campo de filtro, Davix consulta el servidor en tiempo real y muestra los resultados que coinciden. Los resultados se muestran con el siguiente formato:

• Para personas: "{numero_documento} - {nombres} {apellido_paterno} {apellido_materno}"
• Para empresas: "{numero_documento} - {razon_social}"

Mensajes de error

Campo	Mensaje cuando esta vacio
Cliente	"* Seleccione el cliente"

Guardar

Boton	Descripcion
Cancelar	Cierra el dialogo sin agregar el cliente
Guardar	Valida el formulario y agrega el cliente a la cartera

Proceso de guardado

1. Davix valida que se haya seleccionado un cliente
2. Si no se selecciono cliente:
   • Se muestra un toast de error: "Revise bien, hay formularios por validar."
   • El campo Cliente se resalta en rojo con el mensaje de error
3. Si todo es correcto:
   • Davix crea la asociacion entre el cliente y la cartera
   • Muestra el toast: "Registrado con exito"
   • El dialogo se cierra automaticamente
   • La lista de clientes de la cartera se actualiza con el nuevo registro

---

Quitar un cliente de la cartera

1. Desde la pantalla de detalles de la cartera, haz clic derecho sobre el cliente y selecciona Quitar, o selecciona el boton de acciones (...) y luego Quitar
2. Davix muestra un dialogo de confirmacion con el mensaje: "Estas seguro de proceder con la eliminacion?"
3. El dialogo presenta dos botones:
   • Si: confirma la eliminacion
   • No: cancela la operacion y cierra el dialogo
4. Si confirmas, Davix quita al cliente de la cartera y muestra el toast: "Eliminado."
5. La lista de clientes de la cartera se actualiza automaticamente

---

Problemas comunes

Problema	Causa	Solucion
No aparecen owners en el desplegable	No hay colaboradores registrados en el sistema o hay un error de conexion	Solicita al administrador que registre colaboradores en el sistema
El nombre no se autocompleta al seleccionar un owner	Puede haber un error temporal	Ingresa el nombre manualmente en el campo Nombre
No puedo agregar un cliente a la cartera	El cliente no esta registrado en el sistema	Primero registra al cliente en Clientes o Mis Clientes
La busqueda de clientes no muestra resultados	El texto ingresado no coincide con ningun registro o el servidor no responde	Verifica el nombre o documento del cliente. Intenta con menos caracteres
Aparece "Revise bien, hay formularios por validar."	Hay campos obligatorios vacios al intentar guardar	Revisa los campos marcados en rojo y completa la informacion faltante
Las fechas de actividad no se muestran	El interruptor de fecha de actividad esta desactivado	Activa el interruptor "Fecha de actividad?" para habilitar los campos de fecha
Los botones Exportar a no funcionan	La funcionalidad de exportacion no esta implementada en esta version	Funcionalidad pendiente de implementacion en futuras versiones
El boton Eliminar de la barra de menu no funciona	La eliminacion masiva no esta implementada	Usa el menu contextual (clic derecho > Eliminar) para eliminar carteras individualmente
Al quitar un cliente de la cartera, desaparece del sistema	El cliente no se elimina del sistema, solo se desasocia de la cartera	El cliente sigue disponible en los modulos de Clientes. Verifica en Clientes
No se muestran datos en la tabla de detalles	La cartera no tiene clientes asignados	Agrega clientes usando Nuevo > Agregar cliente

---

Paginas relacionadas

• Clientes — administra los clientes que se asignan a carteras
• Mis Clientes — tus clientes asignados (crea cartera PRINCIPAL automaticamente)
• Clientes Salud — clientes del sector salud
• Ventas Salud — registra ventas a los clientes de tus carteras