upstream-twenty/packages/twenty-docs/l/es/user-guide/data-migration/overview.mdx

---
title: Migración de datos
description: Importe y exporte sus datos de CRM mediante archivos CSV o la API.
---

import { VimeoEmbed } from '/snippets/vimeo-embed.mdx';

## Métodos de importación

Twenty admite dos métodos principales para importar datos:

| Método                       | Ideal para                                       | Límite de volumen            |
| ---------------------------- | ------------------------------------------------ | ---------------------------- |
| **Importación CSV**          | Migraciones estándar, actualizaciones periódicas | 10.000 registros por archivo |
| **Importación mediante API** | Migraciones a gran escala, automatización        | Ilimitado                    |

<Note>Para conjuntos de datos muy grandes (cientos de miles de registros), use la API. Nuestros [socios de implementación](/l/es/user-guide/getting-started/capabilities/implementation-services) pueden ayudar a ejecutar estos scripts si es necesario.</Note>

## Conceptos básicos de la importación CSV

Puede importar datos de cualquier objeto mediante archivos CSV, XLSX o XLS. Cada archivo debe contener **solo un tipo de objeto** (por ejemplo, solo registros de Personas).

<Note>**Los campos deben existir antes de la importación.** Cargar un CSV crea registros, pero no crea campos. Si necesita campos personalizados, créelos primero en **Configuración → Modelo de datos**.</Note>

### Pasos

1. Vaya al objeto en el que desea importar datos
2. Haga clic en el icono **⋮** en la esquina superior derecha (este es el Menú de comandos) y haga clic en **Importar registros**
3. Descargue el archivo de plantilla para asegurarse de que sus datos estén en el formato esperado
4. Cargue su archivo CSV con el formato correcto
5. Asigne sus columnas a los campos de Twenty
6. Revise los errores (resaltados en amarillo) y corríjalos, editando directamente en la interfaz de usuario
7. Confirme la importación

### Importar relaciones entre objetos

Puedes importar relaciones entre objetos usando la función de importación CSV. Debe hacer referencia al objeto relacionado utilizando un campo único de ese objeto: el `id`, el `email` para Personas y Miembros del espacio de trabajo, el `domain` para empresas, cualquier otro campo establecido como único en el modelo de datos para cualquier otro objeto.

<Note>**Los registros eliminados cuentan para la unicidad.** Los registros eliminados lógicamente (visibles en Menú de comandos → Ver registros eliminados) se incluyen en las comprobaciones de unicidad. Si importa un registro con el mismo valor único que un registro eliminado, el registro eliminado se restaurará.</Note>

<Warning>
**¡Importa el orden de importación!**

Al importar objetos relacionados, cargue los archivos en este orden:
1. **Empresas** primero (el lado "uno" de las relaciones)
2. **Personas** en segundo lugar (vinculadas a Empresas mediante companyId)
3. **Oportunidades** en tercer lugar (vinculadas a Empresas/Personas)
4. **Objetos personalizados** con relaciones al final

¿Por qué? El lado "uno" de una relación de uno a muchos debe existir antes de que pueda hacer referencia a él. Por ejemplo, el registro de Empresa debe existir antes de importar una Persona con el ID de esa empresa.
</Warning>

Consulte [este artículo](/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv) para ver una guía paso a paso sobre cómo proceder.

## Exportar Datos

Exporte los datos de su espacio de trabajo para copias de seguridad, informes o migración.

### Pasos

1. Vaya al objeto que desea exportar
2. Configure la vista con las columnas que necesita
3. Haga clic en **⋮** → **Exportar vista**
4. Guarde el archivo CSV

<Note>**Solo se exportan las columnas visibles.** El archivo CSV contendrá únicamente las columnas que se muestran en su vista actual. Agregue u oculte columnas antes de exportar para controlar qué datos se incluyen.</Note>

<Note>**Límites de exportación**: hasta 20.000 registros por exportación.</Note>

## Permisos

La importación y exportación de datos requieren permisos específicos:

* **Importación**: requiere el permiso "Importar CSV"
* **Exportación**: requiere el permiso "Exportar CSV"

Póngase en contacto con el administrador de su espacio de trabajo si no tiene estos permisos.

## Próximos Pasos

* [Prepare sus archivos CSV](/l/es/user-guide/data-migration/how-tos/prepare-your-csv-files)
* [Importe relaciones entre objetos](/l/es/user-guide/data-migration/how-tos/import-relations-between-objects-via-csv)
* [Importe mediante API para conjuntos de datos grandes](/l/es/user-guide/data-migration/how-tos/import-data-via-api)