La pantalla Clientes — Listado muestra el directorio completo de clientes registrados de tu MYPE. Estos son los compradores que tienes guardados en tu sistema y que aparecen como sugerencias cuando creas una venta o cotización — escribes parte de su nombre o documento en el typeahead y se autocompletan razón social, dirección, email y WhatsApp.

Es la vista detallada de la pestaña Clientes del hub Contactos. Mismos datos, mismo diseño, pero esta pantalla tiene su propia URL y mantiene resaltada la sección Contactos en la navegación superior. La diferencia es que aquí solo ves clientes — sin el selector para cambiar a proveedores.

Arriba tienes 3 pestañas de filtro por estado con contadores: Todos, Activos (los que aparecen en typeaheads) e Inactivos (los que ya no usas). Al lado, una búsqueda en vivo por RUC/DNI, razón social o nombre comercial. La tabla muestra 15 clientes por página ordenados primero por estado (activos arriba) y luego alfabéticamente por razón social.

Las acciones principales son: + Nuevo cliente (te lleva al form de creación) y ← Contactos (regresa al hub unificado). Click en cualquier fila abre el form de edición del cliente — toda la fila es clickable, no solo el icono de editar.

Manual completo

Las 3 pestañas de filtro

Pestaña	Qué muestra	Contador
Todos	Todos los clientes del MYPE, activos e inactivos.	Total de clientes de tu negocio.
Activos	Solo los activos. Estos son los que aparecen como sugerencia en ventas y cotizaciones.	Cantidad de clientes activos.
Inactivos	Solo los inactivos. Quedaron guardados para preservar el histórico de sus ventas, pero no aparecen como sugerencia en nuevos formularios.	Cantidad de clientes inactivos.

💡 Los clientes inactivos no se borran — solo se ocultan. Sus ventas pasadas siguen vinculadas a ellos para que la trazabilidad histórica no se rompa.

La búsqueda

Campo	Cómo busca	Ejemplo
Documento	Por el inicio del número (prefijo)	Buscar 1234 encuentra el DNI 12345678 pero NO 87654321.
Razón social	Por cualquier parte del texto	Buscar pérez encuentra «Juan Pérez», «Pérez Hermanos S.A.», «Distribuidora Pérez».
Nombre comercial	Por cualquier parte del texto	Igual que la razón social — útil cuando el cliente tiene una marca diferente al nombre legal.

El sistema busca en cualquiera de los tres campos a la vez. La tabla se actualiza sola 350 ms después de la última tecla.

Columnas de la tabla

Columna	Qué muestra
Documento	El tipo y número de documento. Si es cliente OTROS sin documento, muestra «Sin documento» en cursiva.
Cliente	Avatar generado del nombre (iniciales con color hash) + razón social + nombre comercial debajo en línea más pequeña.
Contacto	WhatsApp (prefijo WA:), teléfono (prefijo Tel:) y email apilados verticalmente, en texto pequeño muted.
Crédito	Condición default en días o «Contado» si es 0.
Estado	Badge Activo (verde) o Inactivo (gris).
Acción	Icono de editar (lápiz). Toda la fila es clickable.

Acciones de la pantalla

Acción	Dónde	Qué hace
+ Nuevo cliente	Botón primario arriba a la derecha	Te lleva al form de creación.
← Contactos	Botón secundario arriba	Regresa al hub unificado con el segmented activo.
Click en fila	Cualquier registro	Abre el form de edición.
Buscar	Campo arriba	Filtra en vivo, 350 ms después de la última tecla.
Cambiar pestaña	Pestañas Todos/Activos/Inactivos	Filtra por estado (activo/inactivo) y vuelve a la primera página.

Cuándo usar esta pantalla

• Buscar a un cliente específico cuando estás por llamarlo o necesitas su email/teléfono guardado.
• Revisar tu directorio activo antes de hacer una campaña de WhatsApp — filtra por Activos y ve cuántos tienes con WA registrado.
• Limpiar clientes obsoletos — entra a cada cliente que ya no compra y desactívalo desde el form de edición.
• Validar que un cliente nuevo NO existe ya antes de crearlo (evita duplicados por nombre, aunque el sistema ya evita duplicados por número de documento).

Casos comunes

«El typeahead de ventas no me sugiere a un cliente que ya tengo registrado» El buscador de ventas solo muestra clientes activos. Filtra esta pantalla por «Inactivos» y busca al cliente — si está ahí, entra a su edición y haz click en «Reactivar».

«Tengo dos clientes con el mismo nombre pero distinto RUC» Es válido — la identidad del cliente es su tipo y número de documento, no el nombre. Pueden convivir Juan Pérez con DNI 12345678 y Juan Pérez con RUC 10123456789 como registros separados.

«Quiero ver solo clientes con RUC (empresas)» La búsqueda actual no filtra por tipo de documento, pero un workaround: escribe 20 en la búsqueda para ver los RUC de persona jurídica (que empiezan en 20), o 10 para RUC de persona natural. No es una búsqueda exacta pero ayuda.

«Acabo de crear un cliente y no aparece en la lista» Verifica que estés en la pestaña correcta. Si está en Activos y no aparece, intenta limpiar la búsqueda. Si filtraste por algo y el cliente nuevo no cumple, no se muestra.

«Aparece un cliente que nunca registré» El sistema registra clientes solo cuando les emites un comprobante, les aceptas una cotización o les generas una guía con su RUC o DNI real (aunque nunca hayas pasado por «+ Nuevo cliente»). Es normal — puedes completarle el resto de sus datos (email, WhatsApp, crédito) entrando a su edición.

«¿Por qué la condición de crédito de mis clientes dice "Contado"?» Porque tienen 0 días de crédito, que es el valor por defecto. Si quieres que un cliente tenga 30 días de crédito automáticos en cada venta, edita el cliente y pon 30 en ese campo. Es solo el valor sugerido — al crear la venta puedes sobrescribirlo.

Cosas que NO puedes hacer desde el listado

• Crear cliente sin salir del listado: la creación está en página aparte. Sí existe una ventana de creación rápida, pero solo aparece al crear una venta o una cotización, no desde aquí.
• Editar campos directamente en la tabla: la edición exige entrar al form completo.
• Eliminar físicamente un cliente: solo se desactiva. Los registros nunca se borran para no romper el vínculo con las ventas históricas.
• Reasignar las ventas de un cliente a otro: no hay forma de fusionar clientes. Si creaste un duplicado por error, desactiva el incorrecto y nada más — las ventas viejas quedan donde estaban.
• Bulk activar/desactivar: una a una. No hay checkboxes.
• Exportar CSV desde esta pantalla.