> For the complete documentation index, see [llms.txt](https://nextcommerce.gitbook.io/nextcommerce-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nextcommerce.gitbook.io/nextcommerce-docs/03-clientes.md).

# Clientes

La sección de **Clientes** te permite gestionar la base de datos de clientes de tu tienda, incluyendo sus datos personales, direcciones de facturación y historial de compras.

***

## Vista General

El listado de clientes se organiza en tres pestañas:

* **Todos**: Muestra todos los clientes registrados
* **Activos**: Clientes con cuenta activa
* **Inactivos**: Clientes con cuenta desactivada

### Columnas del Listado

| Columna            | Descripción                 |
| ------------------ | --------------------------- |
| **Cliente**        | Nombre completo del cliente |
| **Email**          | Correo electrónico          |
| **Teléfono**       | Número de contacto          |
| **Identificación** | DNI o CUIT                  |
| **Estado**         | Activo / Inactivo           |
| **Acciones**       | Botones de acción           |

***

## Funciones Principales

### Barra de Herramientas

* **🔍 Buscar**: Busca por email, nombre, teléfono o identificación
* **📊 Exportar**: Descarga la lista de clientes en Excel
* **➕ Agregar Cliente**: Crea un nuevo cliente

### Búsqueda

El buscador permite encontrar clientes por:

* Correo electrónico
* Nombre o apellido
* Número de teléfono
* DNI o CUIT

Para buscar:

1. Escribe el término de búsqueda
2. Presiona **Enter** para aplicar
3. El filtro activo se muestra como etiqueta
4. Haz clic en la **X** para quitar el filtro

***

## Crear Cliente <a href="#crear-cliente" id="crear-cliente"></a>

Para crear un nuevo cliente:

1. Haz clic en **➕ Agregar Cliente**
2. Completa la información requerida:

### Datos Personales

| Campo                  | Descripción                           | Requerido |
| ---------------------- | ------------------------------------- | --------- |
| **Nombre**             | Nombre del cliente                    | ✅ Sí      |
| **Apellido**           | Apellido del cliente                  | ✅ Sí      |
| **Correo electrónico** | Email (será el usuario de login)      | ✅ Sí      |
| **Contraseña**         | Contraseña inicial (solo en creación) | No        |
| **Teléfono**           | Número de contacto                    | No        |
| **Empresa**            | Nombre de la empresa (si aplica)      | No        |
| **CUIT / DNI**         | Documento de identificación           | No        |

> **💡 Tip**: El email no puede modificarse después de crear el cliente. Asegúrate de ingresarlo correctamente.

### Datos de Facturación

| Campo             | Descripción                      | Requerido |
| ----------------- | -------------------------------- | --------- |
| **Calle**         | Nombre de la calle               | No        |
| **Número**        | Número de puerta                 | No        |
| **Piso**          | Piso (si aplica)                 | No        |
| **Departamento**  | Departamento (si aplica)         | No        |
| **Código postal** | CP de la zona                    | No        |
| **Ciudad**        | Ciudad de residencia             | No        |
| **Provincia**     | Provincia (seleccionar de lista) | No        |

3. Haz clic en **Guardar** para crear el cliente

***

## Editar Cliente

Para editar un cliente existente:

1. En el listado, haz clic en el botón **✏️ Editar** o en el nombre del cliente
2. Modifica los campos necesarios
3. Haz clic en **Guardar**

**Campos que NO pueden modificarse:**

* Correo electrónico (es el identificador único)
* Contraseña (el cliente debe cambiarla desde su cuenta)

***

## Ver Cliente

Para ver el perfil completo de un cliente:

1. Haz clic en el **nombre del cliente** en el listado
2. Accederás a la vista de detalle que incluye:

### Información del Perfil

* Datos personales completos
* Dirección de facturación
* Fecha de registro
* Estado de la cuenta

### Historial de Compras

* Lista de todas las órdenes del cliente
* Total gastado acumulado
* Última compra realizada

***

## Exportar Clientes

Para exportar la base de clientes:

1. Haz clic en **📊 Exportar**
2. Se descargará un archivo Excel con:
   * ID del cliente
   * Nombre y apellido
   * Email
   * Teléfono
   * Identificación
   * Empresa
   * Estado de cuenta
   * Fecha de registro
   * Direcciones

El archivo se nombra automáticamente con la fecha: `clientes_2026-01-16.xlsx`

***

## Estados de Cliente

| Estado       | Descripción                                        |
| ------------ | -------------------------------------------------- |
| **Activo**   | El cliente puede iniciar sesión y realizar compras |
| **Inactivo** | La cuenta está deshabilitada                       |

Para cambiar el estado de un cliente, debes editar su perfil.

***

## Filtrar por Estado

Usa las pestañas para filtrar rápidamente:

1. **Todos**: Muestra clientes activos e inactivos
2. **Activos**: Solo clientes con cuenta habilitada
3. **Inactivos**: Solo clientes con cuenta deshabilitada

> **💡 Tip**: Al cambiar de pestaña, el buscador se limpia automáticamente.

***

## Eliminar Cliente

Para eliminar un cliente:

1. Haz clic en el botón **🗑️ Eliminar**
2. Confirma la acción en el diálogo

> **⚠️ Advertencia**: Eliminar un cliente es una acción permanente. El historial de compras asociado NO se elimina, pero el cliente no podrá acceder a su cuenta.

***

## Paginación

Navega entre los clientes usando los controles:

* Flechas para cambiar de página
* Selector de registros por página (10, 25, 50, 100)
* Contador del total de clientes

***

## Consejos y Mejores Prácticas

### Gestión de Datos

* Mantén los emails actualizados para comunicaciones
* Verifica la identificación para facturación
* Completa las direcciones para agilizar los envíos

### Privacidad

* Los datos de los clientes son confidenciales
* Cumple con las normativas de protección de datos
* No compartas información de clientes con terceros

### Soporte al Cliente

* Usa la vista de detalle para entender el historial
* Verifica el total gastado para atención personalizada
* Revisa las direcciones antes de confirmar envíos

***

## Mensajes de clientes

La sección de **Mensajes** (dentro de Clientes) centraliza los formularios de contacto y consultas que los visitantes envían desde la tienda.

### Acceso

1. En el menú lateral, ve a **Clientes > Mensajes**.
2. Verás una tabla con todos los mensajes recibidos.

### Pestañas

* **Todos**: muestra todos los mensajes.
* **Pendientes**: solo los que todavía no marcaste como respondidos.
* **Respondidos**: historial de consultas ya atendidas.

Los contadores de cada pestaña te ayudan a dimensionar la carga de mensajes pendientes.

### Búsqueda y exportación

* **Buscar mensajes**: buscador por texto para encontrar mensajes específicos (por ejemplo, por nombre, email o asunto).
* **Exportar**: botón para descargar los mensajes listados y analizarlos fuera del sistema (por ejemplo en Excel).

### Gestión de mensajes

Dependiendo de la configuración actual:

* Puedes abrir cada mensaje para ver:
  * Datos del cliente (nombre, email).
  * Mensaje original.
  * Estado (pendiente / respondido).
* Marcar mensajes como respondidos, para mantener organizada la bandeja.

***

## Exclusividades por ciudad

Para tiendas que venden solo en ciertas zonas, existe una pantalla de **Exclusividad por ciudades** donde podés definir en qué ciudades es posible vender.

### Acceso

* Desde el menú lateral (Clientes o Configuración avanzada, según tu versión), buscá **Exclusividades** o **Exclusividad por ciudades**.

### Cómo configurar exclusividades

1. Seleccioná una **Provincia**.
2. Buscá la **Ciudad** escribiendo al menos 3 letras de su nombre.
3. Elegí la ciudad en el buscador y haz clic en **Agregar exclusividad**.
4. La ciudad se suma al listado de ciudades exclusivas para esa provincia.

En la parte inferior verás tarjetas por **Provincia** con sus **ciudades exclusivas**:

* Cada ciudad se muestra como una etiqueta.
* Podés quitar una ciudad de la exclusividad usando el botón de eliminar.

> **Efecto esperado**: solo las ciudades marcadas como exclusivas estarán habilitadas según la lógica de tu tienda (por ejemplo, para métodos de envío o ventas restringidas por región).

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://nextcommerce.gitbook.io/nextcommerce-docs/03-clientes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.