> ## 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**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.