Davix ERPXClientes Personas
Registro y gestion de clientes de tipo persona natural con busqueda RENIEC/SUNAT, telefonos y correos
Para acceder al modulo de Clientes Personas, navega a Sistema de Gestión Comercial > Clientes Personas en el menu principal de Davix.
Vision general
La pantalla Clientes Personas permite registrar y gestionar clientes de tipo persona natural. A diferencia del modulo general de Clientes, esta vista ofrece un formulario simplificado enfocado en los datos esenciales de identificacion: codigo, tipo de documento, numero de documento y razon social, junto con secciones para telefonos y correos.
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 menu superior
La barra de menu se muestra como un menubar horizontal con las siguientes opciones:
| Opcion | Icono | Descripcion |
|---|---|---|
| Nuevo | Configuracion | Menu desplegable con las opciones para crear un nuevo cliente |
| Nuevo > Persona | Mas (+) | Abre el formulario para crear un nuevo cliente persona |
| Nuevo > Empresa | Mas (+) | Abre el formulario para crear un nuevo cliente empresa |
| Actualizar | Recarga | Recarga la lista de clientes 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 clientes
La tabla muestra el listado de clientes personas registrados 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.
Columnas
| Columna | Ordenable | Descripcion |
|---|---|---|
| Casilla de seleccion | No | Casilla de verificacion para seleccionar registros individualmente. En el encabezado hay una casilla para seleccionar/deseleccionar todos los registros de la pagina actual |
| Codigo | Si | Codigo identificador unico del cliente, ingresado manualmente al crear el registro |
| Nombre | Si | Nombre completo del cliente (razon social o nombre compuesto obtenido de RENIEC/SUNAT) |
| Almacenes | Si | Almacenes asociados al cliente |
| Acciones | 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 |
|---|---|---|
| Persona | Mas (+) | Abre el formulario para crear un nuevo cliente persona (sin datos precargados) |
| Empresa | Mas (+) | Abre el formulario para crear un nuevo cliente empresa (sin datos precargados) |
| Editar | Lapiz | Abre el formulario de edicion con los datos del cliente seleccionado precargados |
| Eliminar | X | Ejecuta la accion de eliminar el cliente seleccionado |
Las opciones Persona y Empresa del menu contextual crean un nuevo registro en blanco, igual que las opciones del menu Nuevo en la barra superior. No dependen del registro seleccionado.
Nuevo cliente / Editar cliente
Al seleccionar Nuevo > Persona, Nuevo > Empresa, Persona o Empresa del menu contextual, o Editar, 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 persona"
- 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: Detalles de persona
Esta seccion muestra la instruccion: "Se tiene que rellenar los campos que contengan (*) obligatoriamente que se requiere para el registro."
| Campo | Tipo | Obligatorio | Descripcion |
|---|---|---|---|
| Codigo | Texto | Si | Codigo identificador del cliente. A diferencia del modulo Clientes donde el codigo es automatico, aqui se ingresa manualmente. Tooltip: "Ingrese el codigo de registro" |
| Tipo Documento | Desplegable | Si | Tipo de documento de identidad. Tooltip: "Seleccione el tipo de documento" |
| Numero Documento | Texto con boton de busqueda | Si | Numero de documento del cliente. 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" |
| Razon Social | Texto | Si | Nombre completo o razon social del cliente. Se autocompleta al buscar un documento valido. Tooltip: "Ingrese o busque la razon social con el numero de RUC o DNI" |
Tipos de documento disponibles
| Tipo | Descripcion |
|---|---|
| DNI | Documento Nacional de Identidad (8 digitos). Busqueda en RENIEC |
| RUC | Registro Unico de Contribuyentes (11 digitos). Busqueda en SUNAT |
Busqueda RENIEC / SUNAT
Al ingresar el numero de documento y ejecutar la busqueda (boton lupa o Enter):
Para DNI:
- Davix valida que el numero tenga exactamente 8 digitos
- Consulta RENIEC con el numero ingresado
- Si encuentra resultados, autocompleta el campo Razon Social con el formato: "{nombres} {apellido_paterno} {apellido_materno}"
Para RUC:
- Davix valida que el numero tenga exactamente 11 digitos
- Valida que el RUC comience con 10, 20, 15 o 17 (prefijos validos)
- Consulta SUNAT con el numero ingresado
- Si encuentra resultados, autocompleta el campo Razon Social con la razon social de la empresa
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." |
| 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 |
|---|---|
| Codigo | "* Ingrese codigo valido" |
| Tipo Documento | "* Seleccione tipo documento valido" |
| Numero Documento | "* Ingrese un numero valido" |
| Razon Social | "* Ingrese una razon social valido" |
Al ingresar el numero de documento y seleccionar el boton de busqueda (o presionar Enter), Davix consulta automaticamente RENIEC (para DNI) o SUNAT (para RUC) y autocompleta la razon social. Esto ahorra tiempo y reduce errores de escritura.
Seccion: Telefonos
La seccion de telefonos muestra el titulo "Telefonos" con la instruccion: "Registre la cantidad de correos que tenga el proveedor."
Esta seccion permite registrar numeros de telefono del cliente. Los telefonos ingresados se guardan junto con el registro del cliente.
La funcionalidad visual de telefonos se muestra como un componente integrado en el formulario. Los datos de telefonos se envian al servidor al guardar el formulario.
Seccion: Correos
La seccion de correos muestra el titulo "Correos" con la instruccion: "Registre la cantidad de telefonos que tenga el proveedor."
Esta seccion permite registrar direcciones de correo electronico del cliente. Los correos ingresados se guardan junto con el registro del cliente.
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
- Davix valida que todos los campos obligatorios esten completos
- 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."
- 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
- Haz clic derecho sobre el cliente en la tabla y selecciona Editar
- Davix abre el formulario a pantalla completa con los datos del cliente precargados:
- Codigo, tipo de documento, numero de documento y razon social
- Telefonos y correos registrados
- Si el cliente tiene ubicacion (pais, ubigeo), se precargan los desplegables correspondientes
- Modifica los campos necesarios
- Selecciona Guardar
- Davix muestra: "Se ha actualizado con exito"
Eliminar un cliente
Al seleccionar Eliminar en el menu contextual, Davix ejecuta la accion de eliminacion del cliente seleccionado.
La funcionalidad de eliminacion esta disponible en el menu contextual y en la barra de menu superior (boton Eliminar para registros seleccionados con las casillas de verificacion).
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 en el campo Razon Social |
| 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 la razon social manualmente |
| Aparece "Seleccione el tipo de documento." | Se intento buscar sin seleccionar primero el tipo de documento | Selecciona DNI o RUC en el desplegable Tipo Documento 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 menu. Si el problema persiste, verifica la conexion con el servidor |
| Los campos de telefonos/correos no aparecen completos | Los componentes de telefonos y correos estan en version basica | Ingresa los datos disponibles. Para una gestion mas completa de telefonos y correos, utiliza el modulo Clientes |
Diferencias con el modulo Clientes
| Caracteristica | Clientes Personas | Clientes |
|---|---|---|
| Codigo | Ingresado manualmente | Generado automaticamente |
| Tipos de documento | DNI y RUC | DNI, RUC, Pasaporte, Carnet Extranjeria, Partida Nacimiento-Identidad |
| Campos de persona | Solo Razon Social | Nombres, Apellido Paterno, Apellido Materno, Fecha Nacimiento, Genero |
| Ubicacion | No disponible en formulario | Direccion, Pais, Departamento, Provincia, Distrito |
| Contactos | No disponible | Lista dinamica de contactos con busqueda RENIEC |
| Puntos de venta | No disponible | Lista dinamica con ubicacion y geolocalizacion |
| Detalles comerciales | No disponible | Actividad, Canal, Sub-Canal, Canal Venta, Matriz |
| Estado de cuenta | No disponible | Disponible desde menu contextual |
| Filtros | No disponible | 12 campos de filtro avanzados |
| Exportacion | Excel, PDF, CSV (desde menu) | Excel con configuracion avanzada |
| Registros por pagina | 10 | 50 |
Paginas relacionadas
- Clientes — vista completa con todos los campos, filtros y funcionalidades avanzadas
- Clientes Salud — clientes del sector salud
- Clientes Empresas Salud — empresas del sector salud
- Ventas Salud — registra ventas a estos clientes