Saltar al contenido principal

Listado de Clientes

¿Qué es el Listado de Clientes?​

Es la pantalla principal donde ves todos tus clientes registrados con su información básica y puedes buscar, filtrar y acceder a sus detalles.

¿Cómo acceder?​

  1. Ve al menú principal
  2. Haz clic en "Clientes"
  3. Se abre el listado completo

Información que Muestra​

Tarjetas de Estadísticas​

En la parte superior verás 3 tarjetas con información general:

📊 Total Clientes: Cantidad total de clientes registrados

✅ Clientes Activos: Clientes que están activos en el sistema

❌ Clientes Inactivos: Clientes desactivados pero que mantienen su historial

Tabla de Clientes​

Para cada cliente verás:

Columna 1: Información Básica

  • Avatar: Iniciales del cliente en círculo de color
  • Nombre completo: Nombre y apellido
  • Código: Identificador único (ej: CLI-0001)

Columna 2: Contacto

  • Email: Correo electrónico
  • Teléfono: Número de contacto

Columna 3: Datos Fiscales

  • RNC/Cédula: Identificación fiscal
  • Régimen: Tipo de contribuyente

Columna 4: Estadísticas

  • Facturas: Cantidad de compras realizadas
  • Total gastado: Dinero total que ha pagado

Columna 5: Estado

  • 🟢 Activo: Cliente habilitado para ventas
  • 🔴 Inactivo: Cliente deshabilitado

Columna 6: Acciones

  • 👁️ Ver: Detalles completos y historial
  • ✏️ Editar: Modificar información
  • 🗑️ Eliminar: Borrar cliente (solo si no tiene facturas)
  • 🔄 Activar/Desactivar: Cambiar estado

Buscar Clientes​

Barra de Búsqueda​

La búsqueda es inteligente y encuentra coincidencias en múltiples campos:

Puedes buscar por:

  • Código (CLI-0001)
  • Nombre (Juan)
  • Apellido (Pérez)
  • Email ([email protected])
  • Teléfono (809-555-0100)
  • RNC/Cédula (001-0000000-0)

Características de la búsqueda:

  • ✅ No distingue mayúsculas/minúsculas
  • ✅ Encuentra coincidencias parciales
  • ✅ Busca en tiempo real (mientras escribes)

Ejemplos de Búsqueda​

Buscar por teléfono parcial:

  • Escribes: 809
  • Encuentra: Todos los clientes con "809" en su teléfono

Buscar por nombre:

  • Escribes: mar
  • Encuentra: María, Marta, Mariano, etc.

Buscar por email:

  • Escribes: @gmail
  • Encuentra: Todos los clientes con Gmail

Filtros y Opciones​

Elementos por Página​

Controla cuántos clientes ves en cada página:

  • 5 por página: Para listas cortas
  • 10 por página: Predeterminado
  • 25 por página: Para revisar más datos
  • 50 por página: Para búsquedas amplias

Dónde está: Selector en la parte superior derecha, al lado de la búsqueda.

Paginación​

Si tienes muchos clientes, aparecen en múltiples páginas:

Controles:

  • ← (Anterior): Ir a página anterior
  • Número de página: Página actual y total
  • → (Siguiente): Ir a página siguiente

Ejemplo:

Mostrando 11-20 de 156 clientes    ← Página 2 de 16 →

Acciones Disponibles​

👁️ Ver Detalles​

Qué hace: Abre pantalla con información completa del cliente.

Pasos:

  1. Busca al cliente en la lista
  2. Haz clic en el ícono del ojo 👁️
  3. Se abre página de detalles

Qué verás:

  • Toda la información del cliente
  • Total de facturas realizadas
  • Monto total gastado
  • Últimas 10 facturas con fecha y monto
  • Estado actual (activo/inactivo)

Para qué sirve:

  • Consultar historial de compras
  • Verificar datos completos
  • Analizar comportamiento del cliente

✏️ Editar Cliente​

Qué hace: Permite modificar la información del cliente.

Pasos:

  1. Busca al cliente
  2. Haz clic en el ícono del lápiz ✏️
  3. Se abre formulario de edición
  4. Modifica los datos necesarios
  5. Haz clic en "Guardar"

Qué puedes editar:

  • Nombre y apellido
  • Email y teléfono
  • Dirección
  • RNC/Cédula
  • Régimen fiscal
  • Estado (activo/inactivo)

Qué NO puedes cambiar fácilmente:

  • Código (no recomendado cambiarlo)
  • Historial de facturas (se mantiene automáticamente)

Ver guía completa de edición →

🗑️ Eliminar Cliente​

Qué hace: Borra permanentemente el cliente del sistema.

⚠️ Importante:

  • Solo puedes eliminar clientes sin facturas
  • Si tiene facturas, el sistema lo impide
  • La eliminación es permanente (no se puede deshacer)

Pasos:

  1. Busca al cliente
  2. Haz clic en el ícono de basura 🗑️
  3. Aparece mensaje de confirmación:
    • "¿Estás seguro de eliminar a [Nombre del Cliente]?"
  4. Haz clic en "Eliminar" para confirmar
  5. Cliente eliminado

Si tiene facturas: El sistema muestra error:

"No se puede eliminar el cliente porque tiene 5 factura(s) 
asociada(s). Considere desactivarlo en su lugar."

Solución: En lugar de eliminar, desactívalo.

🔄 Activar/Desactivar​

Qué hace: Cambia el estado del cliente sin eliminarlo.

Cliente Activo:

  • ✅ Aparece en búsquedas del POS
  • ✅ Puede usarse en nuevas facturas
  • ✅ Visible en dropdowns de selección

Cliente Inactivo:

  • ❌ No aparece en búsquedas del POS
  • ❌ No se puede usar en nuevas facturas
  • ✅ Mantiene su historial de facturas antiguas
  • ✅ Visible en el listado general de clientes

Pasos para Desactivar:

  1. Busca al cliente activo (🟢)
  2. Haz clic en el ícono de estado 🔄
  3. Cliente cambia a inactivo (🔴)
  4. Mensaje: "Cliente desactivado exitosamente"

Pasos para Activar:

  1. Busca al cliente inactivo (🔴)
  2. Haz clic en el ícono de estado 🔄
  3. Cliente cambia a activo (🟢)
  4. Mensaje: "Cliente activado exitosamente"

¿Cuándo desactivar?

  • Cliente ya no compra hace mucho
  • Cliente se mudó o cerró negocio
  • Quieres limpiar búsquedas sin perder historial
  • Cliente específicamente lo solicita

Botones de la Cabecera​

➕ Nuevo Cliente​

Qué hace: Abre formulario para crear un nuevo cliente.

Ubicación: Esquina superior derecha, botón amarillo.

Pasos:

  1. Haz clic en "Nuevo Cliente"
  2. Se abre formulario de creación
  3. Completa la información
  4. Haz clic en "Guardar"

Ver guía de creación →

📤 Exportar​

Qué hace: Descarga la base de datos de clientes.

Formatos disponibles:

  • Excel (XLSX): Para análisis, modificaciones, respaldo
  • PDF: Para imprimir o presentar

Pasos:

  1. Haz clic en "Exportar"
  2. Selecciona formato (Excel o PDF)
  3. El archivo se descarga automáticamente

El archivo incluye:

  • Código
  • Nombre completo
  • Email
  • Teléfono
  • Dirección
  • RNC/Cédula
  • Régimen fiscal
  • Estado (Activo/Inactivo)
  • Total de facturas
  • Total gastado

Nombre del archivo:

clientes-2024-03-15.xlsx
clientes-2024-03-15.pdf

Ver más sobre exportar/importar →

Interpretación de Datos​

Iniciales de Avatar​

Cada cliente tiene un círculo con sus iniciales de colores:

Ejemplo:

  • Juan Pérez → JP (en círculo azul)
  • María González → MG (en círculo rosa)
  • Pedro → P (en círculo verde)

Para qué sirve:

  • Identificar visualmente clientes rápido
  • Hace el listado más amigable
  • Fácil de escanear visualmente

Íconos de Contacto​

📧 Email:

  • Con email: Se muestra la dirección
  • Sin email: Aparece "-"

📱 Teléfono:

  • Con teléfono: Se muestra el número
  • Sin teléfono: Aparece "-"

Estadísticas de Compras​

Facturas:

  • 0 facturas: Cliente nuevo sin compras
  • 1-5 facturas: Cliente ocasional
  • 5+ facturas: Cliente frecuente
  • 20+ facturas: Cliente muy importante

Total Gastado:

  • Suma de todas las facturas completadas
  • No incluye facturas canceladas
  • Formato: RD$ 12,345.67

Casos de Uso​

Caso 1: Encontrar Cliente para Facturar​

Situación: Estás en caja y llega un cliente conocido.

Pasos:

  1. Abre "Clientes" (o usa búsqueda rápida en POS)
  2. Escribe parte de su nombre en búsqueda: "Juan"
  3. Aparecen todos los "Juan" registrados
  4. Identifícalo por apellido o teléfono
  5. Anota su código (CLI-0025)
  6. Úsalo en la factura

Caso 2: Verificar Historial de Cliente​

Situación: Un cliente dice que ya compró hace meses y quieres verificar.

Pasos:

  1. Busca al cliente en la lista
  2. Haz clic en 👁️ (Ver detalles)
  3. Revisa la sección "Últimas Facturas"
  4. Ves fecha, número de factura y monto
  5. Confirmas su historial

Caso 3: Limpiar Base de Datos​

Situación: Tienes muchos clientes viejos que ya no compran.

Pasos:

  1. Revisa lista de clientes
  2. Identifica clientes con:
    • 0 facturas en último año
    • Última compra hace 2+ años
  3. Para cada uno:
    • Si tiene facturas: Desactívalo (no eliminarlo)
    • Si no tiene facturas: Elimínalo (opcional)
  4. Base de datos más limpia y organizada

Caso 4: Exportar para Contador​

Situación: Tu contador necesita lista de clientes para declaraciones.

Pasos:

  1. Ve a "Clientes"
  2. Haz clic en "Exportar"
  3. Selecciona formato: Excel
  4. Se descarga: clientes-2024-03-15.xlsx
  5. Envía archivo por email a tu contador

Caso 5: Actualizar Teléfonos Masivamente​

Situación: Varios clientes han cambiado de teléfono.

Opción 1 (Individual):

  1. Busca cada cliente
  2. Haz clic en ✏️ (Editar)
  3. Actualiza teléfono
  4. Guarda

Opción 2 (Masivo - si tienes muchos):

  1. Exporta base de datos a Excel
  2. Actualiza teléfonos en Excel
  3. Importa archivo actualizado

Ver importación masiva →

Mejores Prácticas​

✅ Usa la Búsqueda Inteligente​

No necesitas escribir el nombre completo. Con 2-3 letras encuentras lo que buscas.

✅ Revisa Periódicamente​

Una vez al mes, revisa tu lista:

  • ¿Hay duplicados?
  • ¿Datos desactualizados?
  • ¿Clientes para desactivar?

✅ Desactiva en Lugar de Eliminar​

Preserva historial. Nunca sabes si el cliente volverá.

✅ Actualiza Estado en Tiempo Real​

Si un cliente te dice que cambió email o teléfono, actualízalo inmediatamente.

✅ Usa Filtros de Paginación​

Si tienes cientos de clientes, usa 25 o 50 por página para búsquedas rápidas.

Permisos Necesarios​

Para ver el listado de clientes necesitas:

  • VIEW (Ver): Consultar lista y detalles

Para acciones adicionales:

  • UPDATE (Actualizar): Editar y activar/desactivar
  • DELETE (Eliminar): Borrar clientes
  • EXPORT (Exportar): Descargar base de datos

Preguntas Frecuentes​

¿Los clientes se ordenan por algún criterio?​

Sí, por defecto se muestran los más recientes primero (último creado aparece arriba).

¿Puedo buscar varios campos a la vez?​

No directamente, pero la búsqueda es amplia. Si buscas "809 Juan", encuentra clientes llamados Juan con teléfono que contenga 809.

¿Qué significa el guion "-" en email o teléfono?​

Significa que ese cliente no tiene ese dato registrado. Es opcional.

¿Puedo ver solo clientes activos?​

No hay filtro específico en la interfaz, pero los clientes inactivos están marcados con 🔴 y es fácil identificarlos.

¿La búsqueda busca en clientes inactivos también?​

Sí, la búsqueda del listado busca en todos (activos e inactivos). Pero en el POS solo aparecen activos.

¿Cuántos clientes puedo ver a la vez?​

Depende de tu selección de "Elementos por página":

  • Mínimo: 5
  • Máximo: 50

¿Puedo ordenar la tabla por columna?​

No en la versión actual. El orden es por fecha de creación (más reciente primero).

¿Se actualiza automáticamente el total gastado?​

Sí. Cada vez que completas una factura, el total se actualiza automáticamente para ese cliente.

Próximos Pasos​