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

# Clientes

La importación por lote permite cargar múltiples clientes en Piriod desde un archivo, sin necesidad de crearlos manualmente.

Ve a **Configuración de la organización → Importar → Clientes**.

***

### Requisitos del archivo

* Formato: `CSV`, `XLSX` o `JSON`
* Los nombres de las columnas deben coincidir exactamente con los definidos
* Evita símbolos especiales (`# $ % & - /`), tildes y ñ
* El orden de las columnas no afecta la importación

Puedes descargar un archivo de ejemplo directamente desde la pantalla de importación o desde [aquí](https://docs.google.com/spreadsheets/d/1Vc0owZwukZOdYWwwE3gvBZzFpRmKyo9Y/edit?usp=sharing\&ouid=109386486582398522693\&rtpof=true\&sd=true).

***

### Estructura del archivo

Una fila por cliente. Las columnas disponibles son:

#### Campos obligatorios

| Campo      | Descripción                                    |
| :--------- | :--------------------------------------------- |
| `name`     | Nombre del cliente                             |
| `address`  | Dirección del cliente                          |
| `email`    | Email de facturación                           |
| `state`    | ID del estado, región o provincia              |
| `country`  | ID del país                                    |
| `currency` | Moneda del cliente: `CLP`, `USD`, `MXN`, `EUR` |

#### Campos condicionales

| Campo                                   | Descripción                                                |
| :-------------------------------------- | :--------------------------------------------------------- |
| `tax_id`                                | RUT, DNI, NIF o VAT del cliente. Obligatorio según el país |
| `tax_settings__cl_activity_description` | Actividad económica o giro del cliente                     |

#### Campos opcionales

| Campo      | Descripción                                                                    |
| :--------- | :----------------------------------------------------------------------------- |
| `phone`    | Teléfono del cliente                                                           |
| `website`  | Sitio web del cliente                                                          |
| `metadata` | Información adicional en formato clave/valor. Ej: `{"my_custom_data":"valor"}` |

***

### Importar el archivo

1. Haz clic en **Seleccionar un archivo**
2. Busca el archivo en tu equipo
3. Haz clic en **Importar**

Si el archivo es válido, Piriod mostrará un mensaje de éxito indicando cuántos registros fueron importados. Si hay errores de formato o faltan columnas obligatorias, la importación no se realizará.

***

### Errores comunes

* Faltan columnas obligatorias
* Los nombres de las columnas no coinciden exactamente
* RUTs inválidos para clientes de Chile — el sistema los valida automáticamente
* El campo `metadata` no está en formato clave/valor correcto
* IDs de país o estado inválidos

***

Una vez completada la importación, los clientes estarán disponibles en **Contactos → Clientes**.