Saltar al contenido principal

​
Resumen

Esta guía explica cómo importar relaciones entre objetos—por ejemplo, vincular Personas con Empresas u Oportunidades con Personas.
Qué se puede importar: Solo relaciones de uno a muchos que apunten a un único tipo de objeto. Las relaciones que apuntan a varios tipos de objeto (como Notas vinculadas a Personas Y Empresas) aún no son compatibles con la importación.

​
Comprender las relaciones

​
¿Qué es una relación “de uno a muchos”?

En una relación de uno a muchos:
  • Una Empresa tiene muchas Personas (empleados)
  • Una Empresa tiene muchas Oportunidades
  • Una Persona tiene muchas Tareas
El lado “uno” es el padre. El lado “muchos” es el hijo.

​
Relaciones comunes en Twenty

RelaciónLado “Uno” (Padre)Lado “Muchos” (Hijo)
Empresas → PersonasEmpresaPersonas
Empresas → OportunidadesEmpresaOportunidades
Personas → TareasPersonaTareas
Personas → NotasPersonaNotas

​
Paso 1: Identificar los lados “Uno” y “Muchos”

Antes de importar, determine qué objeto es el padre y cuál es el hijo. Pregúntese: “¿UNO [Objeto A] tiene MUCHOS [Objeto B]?”
  • Una Empresa → Muchas Personas ✓ (la Empresa es el padre)
  • Una Persona → Muchas Empresas ✗ (Esto es incorrecto: una persona pertenece a una sola empresa)

​
Paso 2: Importar primero los registros padre

El padre (lado “uno”) debe existir en Twenty antes de poder hacer referencia a él. Orden de importación:
  1. Empresas primero (sin dependencias)
  2. Personas en segundo lugar (enlazadas a Empresas)
  3. Oportunidades en tercer lugar (enlazadas a Empresas y/o Personas)
  4. Tareas/Notas (enlazadas a cualquiera de las anteriores)
Si el registro padre no existe, la importación fallará.Verifique siempre que las Empresas estén importadas antes de importar Personas con referencias a Empresas.

​
Paso 3: Anotar el identificador único del padre

Debe hacer referencia al registro padre mediante un identificador único. Opciones disponibles:
Objeto padreIdentificadores únicos disponibles
Empresasid (UUID), domain (recomendado) o cualquier campo único personalizado
Personasid (UUID), email o cualquier campo único personalizado
Miembros del espacio de trabajoid (UUID), email (no el nombre)
Objetos personalizadosid (UUID) o cualquier campo marcado como único
Recomendado: Use domain para Empresas y email para Personas. Son legibles para humanos y fáciles de verificar en su hoja de cálculo.

​
Cómo encontrar el identificador

Si necesita el id:
  1. Exporte los registros padre desde Twenty
  2. La exportación incluye la columna id
  3. Use estos IDs en su archivo de registros hijo

​
Paso 4: Verificar que el campo de relación exista

Antes de importar, asegúrese de que exista el campo de relación entre sus objetos. Para revisar o crear:
  1. Vaya a Configuración → Modelo de datos
  2. Seleccione su objeto hijo (p. ej., Personas)
  3. Busque un campo de relación que apunte al padre (p. ej., Empresa)
  4. Si no existe, créelo:
    • Haga clic en + Add field
    • Seleccione el tipo Relation
    • Elija el objeto padre

​
Paso 5: Preparar su archivo CSV

Agregue una columna a su archivo CSV de registros hijo que haga referencia al padre utilizando su identificador único.

​
Ejemplo: Personas vinculadas a Empresas

Su CSV de Personas: 
firstName,lastName,email,jobTitle,companyDomain
John,Smith,john@acme.com,CEO,https://acme.com
Jane,Doe,jane@widgets.co,CTO,https://widgets.co
Bob,Johnson,bob@techstart.io,Developer,https://techstart.io
La columna companyDomain hace referencia al dominio de la Empresa.

​
Requisitos de formato

IdentificadorFormatoEjemplo
DominioFormato de URLhttps://acme.com
Correo electrónicoCorreo electrónico estándarjohn@acme.com
IDUUIDc776ee49-f608-4a77-8cc8-6fe96ae1e43f
¡El formato del dominio importa!Use https://domain.com (no solo domain.com). Esto coincide con cómo Twenty almacena los dominios de las Empresas y evita errores de coincidencia.

​
Reglas importantes

  1. Se requiere coincidencia exacta — el valor debe coincidir exactamente con el registro padre
  2. Asigne solo UN identificador único — no incluya companyId Y companyDomain
  3. Sensible a mayúsculas/minúsculas — Acme.com ≠ acme.com

​
Paso 6: Cargar y asignar la relación

  1. Vaya al objeto hijo (p. ej., Personas)
  2. Haga clic en ⋮ → Importar registros
  3. Cargue su archivo CSV
  4. En el paso de asignación de campos:
    • Encuentre su columna de relación (p. ej., companyDomain)
    • Asígnela al campo de relación Company
  5. Complete las asignaciones restantes
  6. Revise los errores y confirme
Twenty vinculará automáticamente cada registro hijo con el padre correspondiente.

​
Paso 7: Verificar la importación

Después de importar:
  1. Abra algunos registros hijo (p. ej., Personas)
  2. Verifique que el campo de relación muestre el padre correcto (p. ej., Empresa)
  3. Abra un registro padre y revise la sección de registros relacionados

​
Errores comunes que se deben evitar

ErrorProblemaSolución
Orden de importación incorrectoImportar Personas antes que EmpresasImporte siempre primero los padres y luego los hijos
Formato de dominio incorrectoUsar acme.com en lugar de https://acme.comUse el formato de URL completo con https://
Varios campos únicosAsignar ambos companyId Y companyDomainAsigne solo UN identificador único
Falta el campo de relaciónEl campo de relación no existe en el modelo de datosCréelo en Configuración → Modelo de datos antes de importar
Registros inexistentesEl registro padre no existe en TwentyImporte primero los registros padre o verifique si hay errores tipográficos
Diferencia de mayúsculas y minúsculasAcme.com en el archivo pero acme.com en TwentyAsegure una coincidencia exacta de mayúsculas y minúsculas

​
Vincular a miembros del espacio de trabajo

Al vincular a miembros del espacio de trabajo (su equipo):
  • Use su dirección de correo electrónico, no su nombre
  • Ejemplo: owner@yourcompany.com, no “John Smith”
taskName,assignedTo
Follow up with client,john@yourcompany.com
Review proposal,jane@yourcompany.com

​
Preguntas frecuentes

Tiene dos opciones:
  1. Use el id de Twenty (exporte los registros padre para obtener sus IDs)
  2. Cree un campo único personalizado en su modelo de datos para almacenar un ID externo de su sistema anterior
¡Sí! Incluya el identificador único del registro hijo (p. ej., email para Personas) y el nuevo valor de la relación. La importación actualizará la relación.
Las relaciones de muchos a muchos aún no son compatibles con la importación. Está previsto para el primer semestre de 2026.
Las relaciones que apuntan a varios tipos de objeto aún no son compatibles con la importación/exportación. Esto está en nuestra hoja de ruta.
La importación mostrará un error para esa fila. Puedes hacerlo de las siguientes maneras:
  • Importe el registro padre primero y luego vuelva a importar
  • Corrija el valor de la referencia
  • Elimine la fila de la importación
Causas comunes:
  • Formato incorrecto (use https://domain.com para dominios)
  • Diferencia de mayúsculas y minúsculas (verifique la ortografía exacta)
  • El padre no existe (importe primero los padres)
  • Asignar varios identificadores (use solo uno)
Recuerde: los registros eliminados lógicamente cuentan para la unicidad.Si recibe errores de “no encontrado” pero el registro parece existir, consulte Menú de comandos → Ver registros eliminados. Es posible que el padre haya sido eliminado lógicamente.

​
Solución de Problemas

¿Tiene problemas? Revise: