> ## 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 de empresas

> Asigna en bloque a tus personas a una empresa y a sus sucursales, y exporta quién pertenece a cada una.

Con este archivo asignas muchas [personas](/plataforma/clientes/personas.md) a la vez a una [empresa y sus sucursales](/plataforma/clientes/empresas-y-sucursales.md). La exportación muestra a qué empresa y sucursales pertenece cada persona.

## Dónde importar

Ve a **[Clientes → Empresas](https://app.riqra.com/clients/companies)** y haz clic en **Importar → Personas de empresas**. Descarga la plantilla con **Descargar plantilla** en el diálogo de importación.

## Formato del archivo

Una fila por persona y sucursal. Una persona con tres sucursales ocupa tres filas. Para asignar solo la empresa, deja vacías las columnas de la sucursal.

| Columna | Cómo completarla |
| - | - |
| `numero_documento_fiscal_empresa` | Documento fiscal de la empresa (RUC en Perú). Obligatoria. |
| `sucursal` | Nombre de la sucursal, sin distinguir mayúsculas de minúsculas. |
| `id_externo_sucursal` | Código de la sucursal en tu ERP. Si lo completas, la sucursal se busca por este código y `sucursal` no se usa. |
| `codigo` | Solo con [acceso por código](/plataforma/clientes/acceso-a-la-tienda.md). Identifica a la persona igual que `email` y `telefono`. |
| `email` | Correo de la persona. Cada fila necesita `email`, `telefono` o, con acceso por código, `codigo`. |
| `telefono` | Teléfono con código de país, por ejemplo `+51999100001`. |

| `numero_documento_fiscal_empresa` | `sucursal` | `id_externo_sucursal` | `email` | `telefono` |
| - | - | - | - | - |
| `20512345671` | `Surco` | | `ana@acme.pe` | |
| `20512345671` | | `ERP-SJL` | `ana@acme.pe` | |
| `20512345671` | | | | `+51999100002` |

Conserva `telefono`, `codigo`, `numero_documento_fiscal_empresa` e `id_externo_sucursal` con formato de texto.

La exportación también trae `razon_social_empresa`, `nombre` y `apellido` para que el archivo sea fácil de leer. Al importar, esas columnas se ignoran: puedes volver a subir una exportación sin borrarlas.

## Reglas

* La persona y la empresa ya deben existir. Crea las personas con [Importar personas](/plataforma/transferencia-de-datos/importar-personas.md) y las empresas con [Importar empresas y sucursales](/plataforma/transferencia-de-datos/importar-clientes.md).
* Si la persona no tiene empresa, la fila se la asigna.
* Una persona pertenece a una sola empresa, así que todas sus filas deben tener el mismo `numero_documento_fiscal_empresa`.
* La importación solo agrega asignaciones. Una persona que ya está en la sucursal no cambia, y una sucursal que no aparece en el archivo no se le quita. Para quitar una sucursal o cambiar a la persona de empresa, edítala desde su ficha.
* Si dos sucursales de la empresa tienen el mismo nombre, usa `id_externo_sucursal` para indicar cuál.

Estas filas se rechazan:

* Una fila sin `email` ni `telefono` (ni `codigo`, con acceso por código).
* Una persona o una empresa que no existe.
* Datos de una misma fila (`email`, `telefono` o `codigo`) que pertenecen a personas distintas.
* Una persona que ya pertenece a otra empresa, o que aparece con dos empresas en el archivo.
* Una sucursal que no existe en la empresa, o un nombre que coincide con varias sucursales.
* La misma persona y sucursal repetidas en el archivo.

Si alguna fila tiene errores, no se aplica ninguna. Descarga el **reporte de errores** (tu mismo archivo con la columna `errores`), corrígelo y vuelve a subirlo. Lee [Reporte de errores](/plataforma/transferencia-de-datos/reporte-de-errores.md).

## Exportar

En **Empresas**, haz clic en **Exportar → Personas de empresas**. El archivo viene ordenado por empresa, con una fila por persona y sucursal, y una fila con las columnas de sucursal vacías para cada persona que tiene empresa pero ninguna sucursal. Las personas sin empresa no aparecen.


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