> ## Documentation Index
> Fetch the complete documentation index at: https://docs.filexpress.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Clientes

> Directorio de clientes con datos fiscales, exenciones e historial de transacciones

El catálogo de clientes es la base para emitir facturas correctamente. Cada cliente almacena sus datos fiscales, tipo de contribuyente y configuración de IVA, que el sistema aplica automáticamente al seleccionar el cliente en una venta.

## Tipos de cliente (`business_type`)

| Valor          | Etiqueta           | Cuándo usar                                                                                            |
| -------------- | ------------------ | ------------------------------------------------------------------------------------------------------ |
| `non-business` | Persona Individual | Consumidor final sin actividad empresarial. Se identifica con DUI, pasaporte u otro documento personal |
| `natural`      | Persona Natural    | Contribuyente individual con número de registro (NRC) y NIT                                            |
| `legal`        | Persona Jurídica   | Empresa o sociedad con razón social, NRC y NIT                                                         |

## Crear un cliente

<Steps>
  <Step title="Ir a Ventas → Clientes → Nuevo Cliente" />

  <Step title="Datos básicos">
    | Campo                       | Descripción                                             |
    | --------------------------- | ------------------------------------------------------- |
    | Nombre comercial            | Nombre que aparece en el sistema y en facturas          |
    | Razón social (`legal_name`) | Nombre legal completo (para `natural` y `legal`)        |
    | Tipo de cliente             | `non-business`, `natural` o `legal`                     |
    | Tamaño de empresa           | Clasificación interna (grande, mediano, pequeño, micro) |
  </Step>

  <Step title="Identificación fiscal">
    | Campo                                  | Descripción                                                          |
    | -------------------------------------- | -------------------------------------------------------------------- |
    | Número de Registro (`register_number`) | NRC del contribuyente                                                |
    | NIT (`tax_number`)                     | Número de Identificación Tributaria                                  |
    | Tipo de documento                      | Para personas individuales: DUI, pasaporte, carné de residente, etc. |
    | Número de documento                    | Número del documento seleccionado                                    |
    | Actividad económica                    | Actividad fiscal del cliente                                         |
  </Step>

  <Step title="Datos de contacto y ubicación">
    Teléfono, correo electrónico, país, departamento, municipio y dirección completa.
  </Step>

  <Step title="Configuración especial">
    | Campo                                             | Descripción                                                                                                                 |
    | ------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
    | **Exento de IVA** (`is_exent`)                    | Si está activo, el sistema elimina el IVA de los precios al facturar a este cliente — incluso si los productos son gravados |
    | **Institución Pública** (`is_public_institution`) | Marca al cliente como entidad gubernamental. Afecta el tipo de documento fiscal emitible según normativa                    |
    | **Cuenta contable**                               | Cuenta de cuentas por cobrar que se usará para los asientos contables de ventas a este cliente                              |
  </Step>

  <Step title="Guardar">
    El cliente queda disponible de inmediato en POS y Nueva Venta.
  </Step>
</Steps>

## Exención de IVA

Cuando un cliente tiene `is_exent = true`, al seleccionarlo en una venta:

* El sistema cambia automáticamente el documento a modo **exento**.
* Los productos gravados se facturan sin IVA — el precio se divide por 1.13 para obtener el valor base.
* El total de la venta refleja el precio sin impuesto, que es el monto que el cliente paga.

```
Producto gravado $11.30 (incluye 13% IVA)
Para cliente exento → $11.30 ÷ 1.13 = $10.00
```

<Note>
  La exención aplica incluyendo descuentos por promociones — los precios combo y override\_price también se dividen por 1.13 para clientes exentos.
</Note>

## Institución pública

Los clientes marcados como institución pública (`is_public_institution = true`) requieren tipos de documento específicos según la normativa fiscal local. El sistema restringe los tipos de DTE disponibles al facturar a estas entidades.

## Perfil del cliente

Desde el detalle de cada cliente se puede ver:

* Historial completo de ventas y cotizaciones.
* Saldo pendiente de cobro.
* Datos fiscales y de contacto.

## Búsqueda

La búsqueda en el listado cubre: nombre comercial, razón social, correo, teléfono, NRC, NIT, número de documento y dirección.