Clientes Salud

Vision general

La pantalla Clientes Salud permite registrar y gestionar clientes especificos del sector salud: pacientes (personas naturales) y empresas de salud. Funciona de manera muy similar al modulo general de Clientes, compartiendo el mismo formulario de creacion/edicion, filtros y estructura de tabla, pero con las siguientes diferencias clave:

Caracteristica	Clientes Salud	Clientes
Columnas de tabla	7 columnas (sin campos comerciales)	14 columnas (incluye Matriz, Actividad, Canal, Sub Canal, Canal Venta)
Detalles comerciales en formulario	No disponible	Disponible (Actividad, Canal, Sub Canal, Canal Venta, Matriz)
Menu contextual	Editar, Eliminar	Editar, Eliminar, Estado de cuenta
Estado de cuenta	No disponible	Disponible desde menu contextual
Exportar Excel	Solo Lista de clientes	Lista de clientes y Detalle de clientes
Barra de herramientas	Botones directos (Exportar, Actualizar, Nuevo cliente)	Menu desplegable (Nuevo > Persona/Empresa)

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

---

Barra de navegacion

Breadcrumb: Comercial / Clientes

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

---

Barra de herramientas

La barra de herramientas se muestra como botones directos (no como menu desplegable):

Boton	Icono	Descripcion
Exportar	Descarga	Abre el dialogo de exportacion a Excel
Actualizar	Recarga	Recarga la lista de clientes desde el servidor
Nuevo cliente	Mas (+)	Abre el formulario para crear un nuevo cliente

---

Busqueda y filtros

Barra de busqueda

En la parte superior de la tabla se muestra una barra de busqueda con:

• Campo de busqueda: campo de texto con placeholder "Buscar..." para buscar registros
• Boton buscar: ejecuta la busqueda con el texto ingresado
• Boton agregar filtro (icono de filtro con +): abre el panel de filtros disponibles

Filtros disponibles

Al seleccionar el boton de agregar filtro, Davix muestra un menu desplegable con 12 opciones de filtro:

#	Filtro	Tipo de control	Descripcion
1	Fecha inicio	Selector de fecha	Filtra clientes registrados desde esta fecha
2	Fecha fin	Selector de fecha	Filtra clientes registrados hasta esta fecha
3	Tipo	Desplegable	Tipo de cliente: Persona o Empresa
4	Tipo de documento	Desplegable	Tipo de documento de identidad
5	Numero de documento	Texto	Numero de documento del cliente
6	Nombres	Texto	Nombres del cliente
7	Direccion	Texto	Direccion del cliente
8	Actividad	Desplegable	Actividad comercial del cliente
9	Canal	Desplegable	Canal comercial del cliente
10	Sub canal	Desplegable	Sub canal comercial del cliente
11	Canal de venta	Desplegable	Canal de venta del cliente
12	Matriz	Desplegable	Matriz comercial del cliente

Chips de filtros activos

Los filtros aplicados se muestran como chips debajo de la barra de busqueda. Cada chip muestra el nombre del filtro y su valor, con un boton X para eliminarlo individualmente.

---

Tabla de clientes

La tabla muestra el listado de clientes salud registrados en el sistema. Soporta carga diferida (lazy loading) con paginacion de 50 registros por pagina. Las columnas son redimensionables y la tabla tiene scroll horizontal y vertical.

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
Fecha	120px	Si	Fecha de registro del cliente en formato fecha
Tipo	100px	Si	Tipo de cliente: Persona o Empresa
T. Documento	120px	Si	Tipo de documento de identidad (DNI, RUC, Pasaporte, etc.)
N. Documento	120px	Si	Numero de documento de identidad
Razon Social	200px	Si	Nombre completo del cliente. La logica de visualizacion es: si el tipo es EMPRESA, muestra la razon social; si es PERSONA con RUC, muestra la razon social; si es PERSONA con otro documento, muestra "{nombres} {apellido paterno} {apellido materno}"
Direccion	150px	Si	Direccion principal del cliente
Contactos	150px	Si	Lista de contactos asociados al cliente
Acciones	60px	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
Editar	Lapiz	Abre el formulario de edicion con los datos del cliente seleccionado precargados
Eliminar	X	Ejecuta la accion de eliminar el cliente seleccionado

---

Nuevo cliente / Editar cliente

Al seleccionar Nuevo cliente en la barra de herramientas, 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: "Nuevo cliente" (o "Editar cliente" al editar)
• 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.

Seccion: Codigo

Campo	Tipo	Obligatorio	Descripcion
Codigo	Texto (solo lectura)	Automatico	Codigo identificador unico del cliente, generado automaticamente por el sistema. Tooltip: "El codigo se genera automaticamente". Se muestra deshabilitado

Seccion: Tipo

Campo	Tipo	Obligatorio	Descripcion
Tipo	Desplegable	Si	Tipo de cliente. Opciones: Persona, Empresa. Al cambiar el tipo, el formulario ajusta dinamicamente los campos visibles y los tipos de documento disponibles. Tooltip: "Seleccione el tipo de cliente"

Seccion: Estado

Campo	Tipo	Obligatorio	Descripcion
Estado	Desplegable	Si	Estado del cliente. Opciones: Activo, Potencial. Tooltip: "Seleccione el estado del cliente"

Seccion: Detalles del cliente

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

Los campos visibles dependen del Tipo seleccionado:

Para tipo Persona

Campo	Tipo	Obligatorio	Descripcion
Tipo Documento	Desplegable	Si	Tipo de documento. Opciones: DNI, Pasaporte, Carnet Extranjeria, RUC, Partida Nacimiento-Identidad. Tooltip: "Seleccione el tipo de documento"
Numero Documento	Texto con boton de busqueda	Si	Numero de documento. Puedes presionar Enter o seleccionar el boton de busqueda (icono lupa) para consultar RENIEC o SUNAT. Tooltip: "Ingrese el numero de documento, y realice una busqueda previa"

Campos adicionales segun tipo de documento:

Si el tipo de documento es RUC:

Campo	Tipo	Obligatorio	Descripcion
Razon Social	Texto	Si	Razon social de la persona. Se autocompleta al buscar un RUC valido. Tooltip: "Ingrese o busque la razon social con el numero de RUC o DNI"
Nombre Comercial	Texto	No	Nombre comercial. Tooltip: "Ingrese el nombre comercial"
Direccion	Texto	No	Direccion fiscal. Se autocompleta con la direccion devuelta por SUNAT. Tooltip: "Ingrese una direccion"

Si el tipo de documento NO es RUC (DNI, Pasaporte, Carnet Extranjeria, Partida Nacimiento-Identidad):

Campo	Tipo	Obligatorio	Descripcion
Apellido Paterno	Texto	Si	Primer apellido. Se autocompleta al buscar un DNI valido. Tooltip: "Ingrese apellido paterno"
Apellido Materno	Texto	Si	Segundo apellido. Se autocompleta al buscar un DNI valido. Tooltip: "Ingrese apellido materno"
Nombres	Texto	Si	Nombres de la persona. Se autocompleta al buscar un DNI valido. Tooltip: "Ingrese sus nombres"
Fecha de nacimiento	Selector de fecha	No	Fecha de nacimiento del cliente. Tooltip: "Seleccione la fecha de nacimiento"
Genero	Desplegable	No	Genero del cliente. Opciones: Masculino, Femenino. Tooltip: "Seleccione el genero"

Para tipo Empresa

Campo	Tipo	Obligatorio	Descripcion
Tipo Documento	Desplegable (solo lectura)	Si	Fijado en RUC. No se puede cambiar. Tooltip: "Seleccione el tipo de documento"
Numero Documento	Texto con boton de busqueda	Si	Numero de RUC (11 digitos). Puedes presionar Enter o seleccionar el boton de busqueda (icono lupa) para consultar SUNAT. Tooltip: "Ingrese el numero de documento, y realice una busqueda previa"
Razon Social	Texto	Si	Razon social de la empresa. Se autocompleta al buscar un RUC valido. Tooltip: "Ingrese o busque la razon social con el numero de RUC o DNI"
Nombre Comercial	Texto	No	Nombre comercial de la empresa. Tooltip: "Ingrese el nombre comercial"
Direccion	Texto	No	Direccion fiscal. Se autocompleta con la direccion devuelta por SUNAT. Tooltip: "Ingrese una direccion"

Tipos de documento y validaciones

Tipo de documento	Longitud requerida	Servicio de busqueda	Disponible para
DNI	Exactamente 8 digitos	RENIEC	Persona
RUC	Exactamente 11 digitos	SUNAT	Persona y Empresa
Pasaporte	8 a 12 caracteres	No disponible	Persona
Carnet Extranjeria	8 a 12 caracteres	No disponible	Persona
Partida Nacimiento-Identidad	8 a 15 caracteres	No disponible	Persona

Busqueda RENIEC / SUNAT

Al ingresar el numero de documento y ejecutar la busqueda (boton lupa o Enter):

Para DNI:

1. Davix valida que el numero tenga exactamente 8 digitos
2. Consulta RENIEC con el numero ingresado
3. Si encuentra resultados, autocompleta los campos Apellido Paterno, Apellido Materno y Nombres

Para RUC:

1. Davix valida que el numero tenga exactamente 11 digitos
2. Valida que el RUC comience con 10, 20, 15 o 17 (prefijos validos)
3. Consulta SUNAT con el numero ingresado
4. Si encuentra resultados, autocompleta Razon Social, Nombre Comercial y Direccion

Para Pasaporte, Carnet Extranjeria y Partida Nacimiento-Identidad:

• La busqueda automatica no esta disponible. Los datos deben ingresarse manualmente.

Validaciones de la busqueda

Situacion	Mensaje de validacion
No se selecciono tipo de documento antes de buscar	Toast de alerta: "Seleccione el tipo de documento."
El campo numero de documento esta vacio	Toast de alerta: "Ingrese un numero de valido."
DNI con longitud diferente a 8 digitos	Toast de alerta: "El DNI ingresado es incorrecto, ingrese un numero valido."
RUC con longitud diferente a 11 digitos	Toast de alerta: "Ingrese un numero valido."
RUC no comienza con 10, 20, 15 o 17	Toast de alerta: "Ingrese un numero de RUC valido, el numero ingresado no tiene validez."
Pasaporte con longitud fuera de 8-12 caracteres	Toast de alerta: "Ingrese un numero valido."
Carnet Extranjeria con longitud fuera de 8-12 caracteres	Toast de alerta: "Ingrese un numero valido."
Partida Nacimiento-Identidad con longitud fuera de 8-15 caracteres	Toast de alerta: "Ingrese un numero valido."
No se encontraron datos en RENIEC/SUNAT	Error debajo del campo: "* No se encuentra el numero". Toast de error: "No se encontraron datos para el numero ingresado. ERROR 400"

Mensajes de error de campos obligatorios

Campo	Mensaje cuando esta vacio
Tipo	"* Seleccione tipo valido"
Estado	"* Seleccione estado valido"
Tipo Documento	"* Seleccione tipo documento valido"
Numero Documento	"* Ingrese un numero valido"
Razon Social (cuando aplica)	"* Ingrese una razon social valido"
Apellido Paterno (cuando aplica)	"* Ingrese apellido paterno valido"
Apellido Materno (cuando aplica)	"* Ingrese apellido materno valido"
Nombres (cuando aplica)	"* Ingrese nombres valido"

Seccion: Ubicacion

La seccion de ubicacion permite registrar la ubicacion geografica del cliente con desplegables en cascada:

Campo	Tipo	Obligatorio	Descripcion
Pais	Desplegable con busqueda	No	Selecciona el pais. Tooltip: "Seleccione el pais"
Departamento	Desplegable con busqueda	No	Se habilita al seleccionar un pais. Muestra los departamentos del pais seleccionado. Tooltip: "Seleccione el departamento"
Provincia	Desplegable con busqueda	No	Se habilita al seleccionar un departamento. Muestra las provincias del departamento seleccionado. Tooltip: "Seleccione la provincia"
Distrito	Desplegable con busqueda	No	Se habilita al seleccionar una provincia. Muestra los distritos de la provincia seleccionada. Tooltip: "Seleccione el distrito"

Seccion: Telefonos

La seccion de telefonos muestra el titulo "Telefonos" con la instruccion: "Registre la cantidad de telefonos que tenga el cliente."

Campo	Tipo	Descripcion
Tipo	Desplegable	Tipo de telefono: Celular, Fijo, Otro
Numero	Texto	Numero de telefono
Agregar	Boton (+)	Agrega una nueva fila para ingresar otro telefono
Eliminar	Boton (X)	Elimina la fila de telefono correspondiente

Seccion: Correos

La seccion de correos muestra el titulo "Correos" con la instruccion: "Registre la cantidad de correos que tenga el cliente."

Campo	Tipo	Descripcion
Tipo	Desplegable	Tipo de correo: Personal, Corporativo, Otro
Correo	Texto	Direccion de correo electronico
Agregar	Boton (+)	Agrega una nueva fila para ingresar otro correo
Eliminar	Boton (X)	Elimina la fila de correo correspondiente

Seccion: Contactos

La seccion de contactos muestra el titulo "Contactos" con la instruccion: "Registre la cantidad de contactos que tenga el cliente."

Cada contacto tiene los siguientes campos:

Campo	Tipo	Descripcion
Tipo Documento	Desplegable	Tipo de documento del contacto
Numero Documento	Texto con boton de busqueda	Numero de documento del contacto. El boton de busqueda consulta RENIEC para DNI
Apellido Paterno	Texto	Primer apellido del contacto
Apellido Materno	Texto	Segundo apellido del contacto
Nombres	Texto	Nombres del contacto
Telefono	Texto	Numero de telefono del contacto
Correo	Texto	Correo electronico del contacto
Cargo	Texto	Cargo o posicion del contacto
Agregar	Boton (+)	Agrega una nueva fila para ingresar otro contacto
Eliminar	Boton (X)	Elimina la fila de contacto correspondiente

Seccion: Puntos de venta

La seccion de puntos de venta muestra el titulo "Puntos de venta" con la instruccion: "Registre la cantidad de puntos de venta que tenga el cliente."

Cada punto de venta tiene los siguientes campos:

Campo	Tipo	Descripcion
Codigo	Texto	Codigo identificador del punto de venta
Nombre	Texto	Nombre del punto de venta
Direccion	Texto	Direccion del punto de venta
Pais	Desplegable	Pais del punto de venta
Departamento	Desplegable	Departamento (se habilita al seleccionar pais)
Provincia	Desplegable	Provincia (se habilita al seleccionar departamento)
Distrito	Desplegable	Distrito (se habilita al seleccionar provincia)
Latitud	Texto	Coordenada de latitud para geolocalizacion
Longitud	Texto	Coordenada de longitud para geolocalizacion
Geolocalizacion	Boton	Abre el mapa para seleccionar la ubicacion visualmente
Agregar	Boton (+)	Agrega una nueva fila para ingresar otro punto de venta
Eliminar	Boton (X)	Elimina la fila de punto de venta correspondiente

Guardar el formulario

Una vez completados los campos obligatorios, selecciona el boton Guardar en la parte inferior del dialogo.

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

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 clientes se actualiza con el nuevo registro o los cambios realizados

---

Editar un cliente

1. Haz clic derecho sobre el cliente 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 del cliente precargados:
   • Codigo (no editable), tipo, estado
   • Tipo de documento, numero de documento y datos de identificacion
   • Ubicacion (pais, departamento, provincia, distrito)
   • Telefonos, correos, contactos y puntos de venta registrados
3. Modifica los campos necesarios
4. Selecciona Guardar
5. Davix muestra: "Se ha actualizado con exito"

---

Eliminar un cliente

1. Haz clic derecho sobre el cliente 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 clientes se actualiza automaticamente

---

Exportar a Excel

1. Selecciona el boton Exportar en la barra de herramientas
2. Davix abre un dialogo con el titulo "Exportar Excel"

Formulario de exportacion

Campo	Tipo	Obligatorio	Descripcion
Tipo	Desplegable	Si	Tipo de reporte. Unica opcion disponible: LISTA DE CLIENTES
Fecha de inicio	Selector de fecha	Si	Fecha de inicio del rango de exportacion. Tooltip: "Seleccione una fecha"
Fecha de fin	Selector de fecha	Si	Fecha de fin del rango de exportacion. Tooltip: "Seleccione una fecha"

Validaciones de exportacion

Situacion	Mensaje
Campos de fecha vacios	Toast de alerta: "Ingrese datos obligatorios para exportar"
Rango de fechas mayor a 365 dias	Toast de alerta: "El rango de fechas no puede ser mayor a 3 meses, ingrese un rango menor"

Botones del dialogo

Boton	Descripcion
Cancelar	Cierra el dialogo sin exportar
Descargar	Genera y descarga el archivo Excel con los datos del rango seleccionado

---

Problemas comunes

Problema	Causa	Solucion
La busqueda por DNI no devuelve resultados	El numero de DNI no esta registrado en RENIEC o hay un error de conexion	Verifica que el DNI tenga exactamente 8 digitos. Si el problema persiste, ingresa los datos manualmente
La busqueda por RUC no devuelve resultados	El RUC no esta activo en SUNAT o no es un prefijo valido	Verifica que el RUC tenga 11 digitos y comience con 10, 20, 15 o 17. Si el problema persiste, ingresa los datos manualmente
Aparece "* No se encuentra el numero"	RENIEC o SUNAT no encontro datos para el numero ingresado	Verifica que el numero sea correcto. Si es correcto pero no se encuentra, ingresa los datos manualmente
Aparece "Seleccione el tipo de documento."	Se intento buscar sin seleccionar primero el tipo de documento	Selecciona el tipo de documento en el desplegable antes de realizar la busqueda
Aparece "Ingrese un numero de RUC valido, el numero ingresado no tiene validez."	El RUC ingresado no comienza con un prefijo valido (10, 20, 15 o 17)	Verifica el numero de RUC. Los prefijos validos son: 10 (persona natural), 20 (empresa), 15 y 17 (otros tipos)
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
El boton Guardar no responde	El formulario se esta procesando (el boton se deshabilita durante el guardado)	Espera a que termine el proceso. Si tarda mucho, puede haber un error de conexion; recarga la pagina e intenta nuevamente
No se muestran datos en la tabla	No hay clientes registrados o hay un error de conexion con el servidor	Selecciona Actualizar en la barra de herramientas. Si el problema persiste, verifica la conexion con el servidor
No veo la seccion Detalles comerciales	La seccion no esta disponible en Clientes Salud	Utiliza el modulo Clientes si necesitas asignar campos comerciales
No puedo ver el Estado de cuenta	La opcion no esta disponible en el menu contextual de Clientes Salud	Utiliza el modulo Clientes para acceder al Estado de cuenta
El rango de exportacion indica "3 meses" pero puedo exportar mas	El mensaje de error es incorrecto; el limite real es de 365 dias	Puedes exportar rangos de hasta 1 ano sin problemas

---

Paginas relacionadas

• Clientes — vista completa con todos los campos comerciales, estado de cuenta y exportacion avanzada
• Clientes Personas — formulario simplificado para personas naturales
• Clientes Empresas Salud — empresas del sector salud
• Ventas Salud — registra ventas a estos clientes
• Mis Clientes — clientes asignados al vendedor actual