La pantalla Contactos es el hub donde gestionas todas las personas y empresas con las que tu MYPE hace negocio. Reúne en un solo lugar tu directorio de clientes (a quienes les vendes) y de proveedores (a quienes les compras) — dos listados que antes estaban en pantallas separadas y ahora viven juntos bajo el mismo bucket de navegación.

Arriba ves un segmented control con dos pestañas: Clientes (contador de clientes totales) y Proveedores (contador de proveedores totales). La pestaña activa determina qué tabla se muestra debajo y qué acción primaria aparece en el header (+ Nuevo cliente o + Nuevo proveedor).

Debajo del selector hay filtros compartidos entre ambas pestañas: estado (Todos / Activos / Inactivos), búsqueda libre por RUC/DNI, razón social o nombre comercial. La búsqueda es en vivo — escribes y la tabla se actualiza al instante. La URL recuerda la pestaña y los filtros, así puedes compartir un link específico (por ejemplo, la vista de Proveedores activos).

La tabla muestra: documento (tipo + número), razón social con avatar generado del nombre, contacto (WhatsApp/teléfono/email), condición de crédito por defecto y estado. Click en cualquier fila te lleva al form de edición del cliente o del proveedor. Las acciones de crear y editar viven en páginas aparte — nunca en modales — porque el formulario tiene 10+ campos y conviene tener pantalla completa.

💡 No todos tus clientes tienen que pasar por «+ Nuevo cliente»: si emites una boleta/factura, aceptas una cotización o emites una guía a alguien con RUC o DNI real (no genérico), el sistema lo agrega solo a esta lista. Verás nuevos clientes aparecer aquí aunque nunca hayas abierto el formulario de creación.

Manual completo

Los dos tabs de la pantalla

Tab	Qué muestra	Botón primario
Clientes	Listado de clientes — a quienes les vendes. Pueden tener documento (DNI, RUC, CE, Pasaporte) o ser tipo «OTROS» sin documento (cliente genérico de mostrador).	+ Nuevo cliente
Proveedores	Listado de proveedores — a quienes les compras. Documento siempre obligatorio. Vinculados a tus compras y a cuentas por pagar.	+ Nuevo proveedor

💡 Diferencia clave: el documento en clientes es opcional (puedes tener clientes «Varios» sin DNI/RUC para boletas de mostrador), pero en proveedores es obligatorio porque siempre necesitas el RUC para registrar la compra ante SUNAT.

Los filtros compartidos

Filtro	Default	Cómo se usa
Estado	Todos	Pestañas Todos / Activos / Inactivos. Filtra el listado de la pestaña activa (clientes o proveedores).
Búsqueda	Vacío	Campo arriba a la derecha. Escribe RUC/DNI, razón social o nombre comercial. En el documento busca por el inicio del número; en la razón social y el nombre comercial busca cualquier coincidencia.
Tab activo	Clientes	El selector de arriba. La pestaña elegida se recuerda en la URL.

Columnas de la tabla

Columna	Qué muestra
Documento	El tipo y número de documento (ej. RUC 20123456789). Si el cliente es tipo OTROS sin documento, aparece «Sin doc» en gris.
Razón social	Avatar generado del nombre + razón social + nombre comercial (si existe) en línea inferior pequeña.
Contacto	WhatsApp (solo en clientes), teléfono y email apilados en texto pequeño muted.
Crédito	Condición default en días, o «Contado» si es 0. Es el plazo de pago por defecto que se sugiere al crear venta/compra a crédito.
Estado	Badge verde Activo o gris Inactivo.
Acción	Icono de editar que lleva al form. Toda la fila es clickable.

Acciones de la pantalla

Acción	Dónde	Qué hace
+ Nuevo cliente / proveedor	Botón primario arriba a la derecha	Te lleva al form de creación correspondiente según el tab activo.
Exportar a Excel	Botón junto al primario	Descarga el listado del tab activo (con los filtros aplicados) en un archivo Excel.
Switch tab	Segmented control	Cambia entre clientes y proveedores manteniendo búsqueda y estado. Resetea la paginación.
Click en una fila	Cualquier registro de la tabla	Abre el form de edición (clientes o proveedores).
Filtrar por estado	Pestañas Todos/Activos/Inactivos	Filtra la tabla del tab activo.
Buscar	Campo de búsqueda	Filtra en vivo, 350 ms después de la última tecla.

Cuándo usar esta pantalla

• Ver toda tu red de un vistazo: cuando quieres saber cuántos clientes y proveedores tienes registrados — los contadores del segmented te lo dicen sin entrar a ningún listado.
• Buscar un contacto cuyo tipo no recuerdas: si no sabes si Juan Pérez está como cliente o proveedor, busca por documento o nombre en cada tab — encontrarás dónde está sin ir a cada listado por separado.
• Limpiar tu directorio: filtra por «Inactivos» para revisar contactos que desactivaste y decidir si reactivarlos o dejarlos así.
• Auditoría rápida de RUCs activos: filtra por «Activos» y revisa cuáles tienen RUC válido para emisión de facturas.

Casos comunes

«Quiero registrar a un nuevo cliente que vino al local» Estás en el tab Clientes. Click en + Nuevo cliente → te lleva al form de creación. Si solo te dio el DNI, lo consultas en RENIEC desde el mismo form y autocompleta su nombre.

«Un proveedor cambió de razón social en SUNAT — ¿cómo lo actualizo?» Busca el proveedor por RUC en el tab Proveedores → click en la fila → en el form de edición puedes cambiar razón social, dirección, teléfono. El RUC NO se edita (es la identidad UNIQUE). Si necesitas «cambiar el RUC», la única forma es desactivar el viejo y crear uno nuevo.

«Un cliente dejó de existir — ¿lo borro?» No se borran contactos. Click en su fila → en el form de edición, botón «Desactivar». Queda en estado Inactivo (badge gris) y deja de aparecer en typeaheads de ventas/cotizaciones, pero sus ventas históricas siguen vinculadas a él.

«Veo un cliente en la lista que yo nunca creé» Es normal: se registró automáticamente al emitirle un comprobante, aceptarle una cotización o generarle una guía con su RUC o DNI real. No hace falta pasar por «+ Nuevo cliente» — el sistema lo hace por ti la primera vez que aparece en un documento. Los clientes genéricos (como «Varios») nunca se registran así.

«¿Por qué algunos clientes aparecen sin documento?» Son clientes tipo OTROS — Gestión permite crear un cliente sin número de documento cuando vendes a alguien que solo te dio el nombre. Útil para boletas de mostrador. Estos clientes NO pueden recibir factura electrónica (la factura siempre exige RUC válido).

«Quiero validar un RUC sin guardar al contacto todavía» Esa función ya no es una pantalla aparte — vive dentro del formulario de creación de cliente o proveedor (botón 🔍 SUNAT). Si quieres validar libremente sin crear, también existe la pantalla Consultas SUNAT/RENIEC (por defecto te lleva a Contactos, pero puedes abrirla directamente o usar la versión embebida en el formulario).

Cosas que NO puedes hacer desde el hub

• Editar un contacto inline: la edición vive en página aparte (form de cliente o proveedor).
• Desactivar masivamente: no hay bulk actions. Click uno por uno en cada contacto.
• Exportar más allá de Excel: el botón «Exportar a Excel» descarga el tab activo con los filtros aplicados; no hay otros formatos (CSV, PDF).
• Crear un contacto que sea cliente Y proveedor a la vez: clientes y proveedores son registros separados. Si tu contador te vende y te compra, créalo en ambos por separado (no se duplica nada, son registros distintos en el sistema).
• Buscar entre los dos tabs a la vez: la búsqueda aplica solo al tab activo. Si no encuentras un contacto en Clientes, cambia a Proveedores y busca de nuevo.