> ## 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 una plantilla de Excel.

La importación de empresas te permite cargar a tus clientes con un solo archivo de Excel. Cada empresa lleva su razón social, su documento fiscal, su dirección fiscal y sus sucursales de entrega.

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

## Antes de empezar

* Descarga la plantilla o exporta tus empresas. Las columnas se reconocen por su nombre. Puedes borrar las que no vas a cambiar, pero conserva siempre `numero_documento_fiscal` y `sucursal`.
* 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 `numero_documento_fiscal`, `telefono`, `telefono_sucursal` e `id_externo_sucursal` con formato de texto para que Excel no altere los números.

<Warning>
  Un encabezado que no pertenece a la plantilla, o repetido, rechaza el archivo completo.
</Warning>

## Organiza empresas y sucursales

El archivo usa una fila por sucursal. `numero_documento_fiscal` identifica a la empresa y `sucursal` identifica a una sucursal dentro de ella. Las filas de una misma empresa repiten su `numero_documento_fiscal`, y de cada columna de la empresa se usa el primer valor no vacío del grupo. Una empresa sin sucursales ocupa una sola fila, con las celdas de sucursal vacías.

| `numero_documento_fiscal` | `sucursal` | `razon_social` | `direccion_fiscal` | `direccion_sucursal` |
| - | - | - | - | - |
| `20512345671` | CD Villa El Salvador | Supermercados Andinos S.A. | Av. Industrial 771, Lima | 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 | |

`numero_documento_fiscal` es el documento fiscal de empresa del país de tu tienda: RUC en Perú y Ecuador, RUT en Chile, NIT en Colombia, RFC en México. Cada país tiene un solo tipo, así que el archivo lleva solo el número. Al crear una empresa, el número se valida según ese país. En Perú, por ejemplo, un RUC debe tener 11 dígitos y un dígito verificador correcto.

## Cómo se resuelve cada fila

| Fila | Resultado |
| - | - |
| Documento nuevo | Crea la empresa, y la sucursal si `sucursal` está lleno. |
| Documento existente, `sucursal` vacía | Actualiza solo la empresa. |
| Documento existente, `sucursal` existente | Actualiza la empresa y esa sucursal. |
| Documento existente, `sucursal` nueva | Agrega una sucursal. |

La sucursal se busca por su nombre dentro de la empresa, sin distinguir mayúsculas.

* **Para crear una empresa** necesitas `razon_social` y `direccion_fiscal`. **Para crear una sucursal**, `direccion_sucursal`.
* **Para actualizar** solo necesitas las columnas clave. Las celdas vacías, y las columnas que no están en el archivo, no cambian el valor guardado.

## Columnas de la empresa

| Columna | Cómo completarla |
| - | - |
| `numero_documento_fiscal` | Obligatorio en todas las filas. Documento fiscal de la empresa. Máximo 50 caracteres. |
| `razon_social` | Obligatorio al crear una empresa. Máximo 255 caracteres. |
| `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. |
| `id_externo_sucursal` | Código de la sucursal en tu sistema. Máximo 50 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. |

Para editar en bloque, usa **Exportar → Empresas y sucursales** en la página de empresas. Descarga el archivo, edítalo y vuelve a importarlo.

## Corrige errores de validación

Si una fila tiene errores, no se aplica ninguna fila del archivo. Descarga el reporte, que es tu mismo archivo con la columna `errores`. Corrige las filas indicadas y vuelve a importarlo. El flujo completo está en [Reporte de errores](/plataforma/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 fiscal inválido para el país y una sucursal repetida dentro del archivo.


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