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

# Importa personas desde Excel

> Crea o actualiza personas en bloque, con su segmento, su consentimiento de WhatsApp y sus datos de facturación.

La importación de personas carga o actualiza a tus clientes con un archivo de Excel: contacto, estado, segmento, consentimiento de WhatsApp y datos de facturación.

Inicia la importación desde **[Clientes → Personas](https://app.riqra.com/clients/individuals)** con **Importar**. **Exportar** descarga tus personas actuales en el mismo formato, listo para editar y volver a subir.

## Antes de empezar

* Parte siempre de la plantilla que descargas desde el panel. El archivo debe conservar todos los encabezados, en el mismo orden.
* Guarda el archivo como Excel `.xlsx`, sin contraseña. No se admiten archivos `.xls` ni `.csv`.
* El archivo puede pesar hasta 10 MB y contener hasta 10 000 filas de datos.
* Mantén las columnas `telefono`, `numero_documento` y `numero_documento_fiscal` con formato de texto para que Excel no altere los números.

<Warning>
  No renombres, elimines ni cambies de posición las columnas. Si los encabezados no coinciden exactamente con la plantilla, el archivo completo se rechaza.
</Warning>

## Columnas

| Columna                                             | Cómo completarla                                                                                                                  |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `nombre`                                            | Obligatorio. Máximo 100 caracteres.                                                                                               |
| `apellido`                                          | Obligatorio. Máximo 100 caracteres.                                                                                               |
| `email`                                             | Correo electrónico. Obligatorio si no hay `telefono`.                                                                             |
| `telefono`                                          | Teléfono con código de país, por ejemplo `+51999100001`. Sin el código de país la fila se rechaza. Obligatorio si no hay `email`. |
| `estado`                                            | Obligatorio: `activa` o `pausada`.                                                                                                |
| `segmento`                                          | Nombre del segmento. Si no existe, se crea. Vacío deja a la persona sin segmento.                                                 |
| `acepta_whatsapp`                                   | Obligatorio: `si` o `no`. `no` retira el permiso aunque la persona lo haya dado antes.                                            |
| `tipo_documento` y `numero_documento`               | Documento de identidad de la persona, por ejemplo `DNI`.                                                                          |
| `tipo_documento_fiscal` y `numero_documento_fiscal` | Documento para emitir factura, por ejemplo `RUC`. Si indicas el tipo, el número es obligatorio.                                   |
| `razon_social_fiscal`                               | Razón social para la factura. Máximo 255 caracteres.                                                                              |
| `direccion_fiscal`                                  | Domicilio fiscal para la factura. Máximo 500 caracteres.                                                                          |

La plantilla no incluye contraseñas ni el campo **Código**. Si tu tienda usa acceso por código, asígnalo después en cada ficha. Para dar acceso a las personas importadas, envíales una invitación desde su ficha; lee [Da acceso a la tienda](/plataforma/clientes/acceso-a-la-tienda).

## Cómo se actualizan las personas existentes

Cada fila se busca entre tus personas por `email` y por `telefono`.

* Si encuentra a la persona por cualquiera de los dos, actualiza los datos incluidos en el archivo.
* Si no la encuentra, la crea.
* Las celdas vacías de documento y facturación no borran datos existentes. `estado` y `acepta_whatsapp` no pueden ir vacíos.

Si cambias el correo de una persona **Con acceso**, su correo anterior recibe un aviso y el nuevo queda **Sin verificar** hasta su siguiente inicio de sesión, igual que al editarlo desde su ficha.

## Corrige errores de validación

Si una fila tiene errores, no se aplica ninguna fila del archivo. Descarga el reporte, que es tu propio archivo con una columna `errores`, corrige las filas señaladas y vuelve a subirlo. El flujo completo está en [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores).

Los errores más comunes:

* Una fila sin `email` ni `telefono`.
* Un `email` o `telefono` repetido dentro del archivo, o dos filas que corresponden a la misma persona (una por su correo y otra por su teléfono).
* Un `email` y un `telefono` que pertenecen a dos personas distintas en tu lista. Corrige el dato o unifica las fichas antes de importar.
* Un `telefono` sin código de país o con un formato que no corresponde a ningún país.
* `estado` o `acepta_whatsapp` vacíos o con un valor distinto a los permitidos.