> ## 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 clientes desde Excel

> Crea o actualiza empresas y sucursales en bloque con la plantilla de Excel de Riqra.

La importación de empresas te permite cargar a tus clientes con un solo archivo de Excel: la empresa (razón social, RUC, dirección fiscal) y todas sus sucursales de entrega.

Puedes iniciar una importación desde **[Empresas](https://app.riqra.com/clients/companies)**, con **Importar → Empresas**.

## Antes de empezar

* Usa la plantilla que descargas desde Riqra. 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 `ruc`, `telefono` y `telefono_sucursal` 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, Riqra rechazará el archivo completo.
</Warning>

## Organiza empresas y sucursales

El archivo usa una fila por sucursal. Las filas de una misma empresa se agrupan repitiendo el mismo `ruc`; los datos de la empresa se leen de la primera fila del grupo. Una empresa sin sucursales ocupa una sola fila, con las celdas de sucursal vacías.

| `ruc`         | `razon_social`               | `direccion_fiscal`       | `sucursal`           | `direccion_sucursal`              |
| ------------- | ---------------------------- | ------------------------ | -------------------- | --------------------------------- |
| `20512345671` | Supermercados Andinos S.A.   | Av. Industrial 771, Lima | CD Villa El Salvador | Av. El Sol 120, Villa El Salvador |
| `20512345671` |                              |                          | Tienda Surco         | Av. Caminos del Inca 351, Surco   |
| `20487654320` | Distribuidora Norte E.I.R.L. | Jr. Piura 240, Chiclayo  |                      |                                   |

## Columnas de la empresa

| Columna            | Cómo completarla                                                                                                         |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| `ruc`              | Obligatorio en todas las filas. Número de documento fiscal de la empresa. Agrupa sus sucursales. Máximo 50 caracteres.   |
| `razon_social`     | Obligatorio al crear una empresa. Máximo 255 caracteres.                                                                 |
| `tipo_documento`   | Tipo de documento fiscal, por ejemplo `RUC`. Si lo dejas vacío, Riqra usa el tipo principal del país de tu organización. |
| `direccion_fiscal` | Obligatorio al crear una empresa. Máximo 500 caracteres.                                                                 |
| `email`            | Correo de contacto de la empresa.                                                                                        |
| `telefono`         | Teléfono de contacto. Incluye el código de país si el número no es local.                                                |

## Columnas de cada sucursal

| Columna              | Cómo completarla                                                                                                         |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `sucursal`           | Nombre de la sucursal, único dentro de la empresa. Obligatorio si completas `direccion_sucursal`. Máximo 255 caracteres. |
| `direccion_sucursal` | Obligatorio al crear una sucursal. Máximo 500 caracteres.                                                                |
| `telefono_sucursal`  | Teléfono de la sucursal.                                                                                                 |
| `email_sucursal`     | Correo de la sucursal.                                                                                                   |

<Note>
  El número de documento se valida según el país de tu organización. En Perú, por ejemplo, un RUC debe tener 11 dígitos.
</Note>

## Cómo se actualizan los clientes existentes

Riqra busca la empresa por su `ruc` y la sucursal por su nombre dentro de la empresa (sin distinguir mayúsculas).

* Si encuentra la empresa o la sucursal, actualiza los datos incluidos en el archivo.
* Si no la encuentra, la crea.
* Las celdas vacías no borran datos existentes: puedes reimportar una exportación parcialmente editada sin perder información.

Para editar en bloque, usa **Exportar → Empresas** en la página de empresas: descarga el archivo con el mismo formato, edítalo y vuelve a importarlo.

## Corrige errores de validación

Si una fila tiene errores, Riqra no aplica ninguna fila del archivo. Descarga el reporte —tu mismo archivo con la columna `errores`—, corrige las filas indicadas y vuelve a importarlo. El flujo completo está en [Reporte de errores](/ecommerce/transferencia-de-datos/reporte-de-errores).

Los errores más comunes son una `razon_social` o `direccion_fiscal` vacía en una empresa nueva, una `direccion_sucursal` vacía en una sucursal nueva, un documento inválido para el país y una sucursal repetida dentro del archivo.