# Clientes

### Importación de clientes por lote

La importación de clientes te permite **cargar múltiples clientes en Piriod mediante un archivo**, evitando tener que crearlos manualmente uno por uno.

Esta opción es útil cuando necesitas **migrar clientes desde otro sistema o cargar una base de datos completa**.

### Pasos de la importación

#### 1. Acceder al módulo de importación

Dirígete al menú:

**Configuración de la organización → Importar → Clientes**

Aquí encontrarás la opción para importar clientes mediante archivo.

<figure><img src="https://2036178115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4WAkXxe1kDllkOjS2L%2Fuploads%2FOKG1IBH2NE757uGQzfLk%2F1.png?alt=media&#x26;token=24f9490d-36cb-4a00-b00b-f9f5453f8828" alt=""><figcaption></figcaption></figure>

### 2. Revisar los requisitos del archivo

Antes de subir tu archivo, asegúrate de cumplir con los siguientes requisitos:

* El archivo debe estar en formato **CSV, XLSX o JSON**
* Debe contener al menos las columnas obligatorias
* Los nombres de las columnas deben coincidir exactamente con los definidos por el sistema
* **Evita usar** símbolos especiales (# $ % & - /, etc.) así como también tildes y ñ
* **El orden de las columnas no afecta la importación**

También puedes **descargar un archivo de ejemplo** desde esta misma pantalla para usarlo como referencia, o descárgalo desde acá:

{% file src="<https://2036178115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4WAkXxe1kDllkOjS2L%2Fuploads%2FB5XxG6Nfi1RSiVkScjzQ%2Fcustomers.import.sample.xlsx?alt=media&token=31c408a7-a32d-4215-933b-44fc71424aa8>" %}
Descargar un archivo de ejemplo
{% endfile %}

### 3. Preparar el archivo de clientes

El archivo debe contener una fila por cada cliente y las columnas correspondientes.

#### Campos obligatorios

<table><thead><tr><th width="100">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>name</strong></td><td>Nombre del cliente</td></tr><tr><td><strong>address</strong></td><td>Dirección del cliente</td></tr><tr><td><strong>email</strong></td><td>Email de facturación</td></tr><tr><td><strong>state</strong></td><td>ID del estado, región o provincia</td></tr><tr><td><strong>country</strong></td><td>ID del país</td></tr><tr><td><strong>currency</strong></td><td>Moneda del cliente. CLP, USD, MXN, EUR</td></tr></tbody></table>

#### Campos condicionales

<table><thead><tr><th width="100">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>tax_id</strong></td><td>DNI, NIF, VAN o RUT del cliente. Puede ser obligatorio dependiendo del país</td></tr><tr><td><strong>tax_settings__cl_activity_description</strong></td><td>Actividad económica del cliente o giro</td></tr></tbody></table>

#### Campos opcionales

<table><thead><tr><th width="100">Campo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>phone</strong></td><td>Teléfono del cliente</td></tr><tr><td><strong>website</strong></td><td>Sitio web del cliente</td></tr><tr><td><strong>metadata</strong></td><td>Información adicional del cliente en formato clave/valor <br><code>Ejemplo: {"my_custom_data":"valor"}</code></td></tr></tbody></table>

### 4. Subir el archivo

Una vez que tu archivo esté listo:

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

<figure><img src="https://2036178115-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M4WAkXxe1kDllkOjS2L%2Fuploads%2FUjHmprE5cKWGW8omccMC%2F5.png?alt=media&#x26;token=0642a3a2-a7ea-4227-abb0-d4d8c076edeb" alt=""><figcaption></figcaption></figure>

### 5. Confirmar la importación

Si el archivo cumple con los requisitos, Piriod mostrará un **mensaje de éxito (Succeeded)** indicando cuántos registros fueron importados.

Si el archivo tiene problemas de formato o faltan columnas obligatorias, la importación no se realizará.

### Errores comunes al importar clientes

Para evitar problemas durante la importación, revisa lo siguiente:

* Las **columnas obligatorias están presentes**
* Los **nombres de las columnas coinciden exactamente**
* Para clientes de Chile, **asegúrate que los IDs fiscales (RUT) sean correctos, el software los valida**
* El campo **metadata** están en formato **clave/valor**
* Los **IDs de país y estado son válidos**

### **Visualización de clientes**

Una vez creados los registros los puedes ver en el menú **Contactos → Clientes**