Revisar y solucionar problemas de errores de importación
Última actualización: enero 18, 2023
Requisitos
Todos los productos y planes |
Al importar registros o actividades a HubSpot, puedes encontrar errores. A continuación, descubre cómo resolver un error detectado durante una importación, descargar un archivo de errores, ver detalles de error y corregir problemas en tu archivo de importación o Salesforce.
Antes de iniciar una importación o corregir un archivo con errores, descubre los términos y requisitos relevantes para importar a HubSpot.
Resolver errores durante una importación
Antes de completar una importación, HubSpot comprueba si hay ciertos errores en las tres primeras filas del archivo. Si se detecta alguno de los siguientes errores, se te informará mientras se asignan las propiedades en el proceso de importación:
- No se pudo encontrar el propietario
- No se pudo analizar la fecha
- No se pudo analizar la cantidad
- Validación fallida
- Dominio no válido
- Correo no válido
- Opción de enumeración no válida
- ID de registro inválido
Para resolver estos errores desde la pantalla Asigna columnas de tu archivo a propiedades de HubSpot:
- Coloca el cursor sobre el exclamation icono de exclamación y haz clic en Corregir errores de importación en el cuadro emergente.
- En el panel de la derecha, ve más detalles sobre el tipo de error, incluyendo qué columna y filas están afectadas.
- Si hay una solución recomendada, aparecerá la sección Corregir este error. Ve la solución recomendada y, en función del error, selecciona una opción:
-
- Haz clic en Editar propiedad de [nombre]. El editor de propiedades aparecerá en el panel derecho. Actualiza la propiedad basándote en la recomendación y haz clic en Guardar.
- Si una propiedad es de solo lectura (por ejemplo, ciertas propiedades predeterminadas de HubSpot), puedes hacer clic en Ver propiedad de [nombre] para ver los detalles de la propiedad. No puedes editar una propiedad de solo lectura, por lo que tendrás que actualizar y volver a importar tu archivo para resolver el error.
- Haz clic en el menú desplegable para actualizar el formato (por ejemplo, formato de Fecha ).
- En la sección Otras opciones:
- Haz clic a la derecha para ampliar y ver cada opción adicional.
- Para ver más detalles sobre la propiedad a la que estás asignando, haz clic en Ver propiedad de [nombre].
- Para obtener más información sobre el error específico, haz clic en Más información acerca de este error.
- Una vez que hayas resuelto un error, aparecerá una marca de verificación success en la columna Mapeado.
Nota: como HubSpot solo detecta errores en las tres primeras filas, puede haber errores adicionales en el resto de tu archivo que no se hayan resuelto.
Revisar errores después de una importación
Una vez que completes una importación, se te dirigirá automáticamente a un resumen de la importación, incluyendo una descripción general de los errores. También puedes revisar un resumen de una importación completada anteriormente.
- En la tarjeta Resumen, ve el número de filas importadas, los nuevos registros creados y los registros existentes actualizados. Más información sobre cómo analizar las importaciones.
- Si la importación ha tenido errores, aparecerá la sección Importar errores. En la tabla, consulta la siguiente información:
- Importar columna desde el archivo: el encabezado de la columna en el archivo que fue afectado por el error.
- Tipo de objeto: el objeto o actividad de CRM asignado a la columna afectada.
- Propiedad HubSpot: la propiedad en HubSpot que fue emparejada con la columna afectada.
- Tipo de error: el tipo de error para la columna afectada. Más información sobre todos los errores de importación.
- Impacto del error: el número de filas o valores de propiedad que no se importaron como resultado del error. Si no se importa una fila, significa que no se pueden importar todas las columnas de la fila afectada. Si no se importa un valor, significa que el valor en la columna de esa propiedad específica no se puede importar, pero se pueden importar otras columnas en la fila.
- Para ver más información sobre un error, coloca el cursor sobre la fila y luego haz clic en Ver detalles.
- Para descargar la lista de errores en un archivo, en la parte superior de la tabla, haz clic en Descargar errores como archivo.
- Extrae el archivo CSV del archivo zip descargado y luego abre el archivo CSV.
- En el archivo, identifica el código de error en la columna Código de error, el objeto del registro afectado en la columna Tipo de objeto, la razón del error en la columna Razón y los valores de propiedad del registro en columnas adicionales.
Una vez que hayas identificado los errores de importación, descubre cómo resolver errores específicos.
Importación de archivo de errores
La siguiente es una lista de códigos de error en orden alfabético, detalles del error y posibles pasos para resolución. En algunos casos, se importarán registros o actividades con errores que pueden corregirse en HubSpot, o corrigiendo el archivo de importación y volviéndolo a importar. En otros casos, los registros o las actividades no se importarán y será necesario corregir el archivo de importación antes de volver a importarlo.
Nota: los códigos de error en un archivo descargado contienen letras mayúsculas y caracteres de subrayado, pero se listan en el texto normal dentro de este artículo. Por ejemplo, el error aparecerá como AMBIGUOUS_ENUMERATION_OPTION en el archivo, pero lo encontrarás como Ambiguous enumeration option en la lista de abajo.
Opción de enumeración ambigua
Qué significa el error
El mismo registro coincide con más de una de las opciones existentes definidas para una propiedad de enumeración. Esto se aplica a las propiedades de selección múltiple, selección desplegable, selección de radio y casilla de comprobación.
También puedes ver este error si el valor en tu archivo es la etiqueta de la opción de propiedad en lugar de tu valor interno. Esto se aplica a las opciones de propiedades de enumeración en las que la etiqueta es diferente al valor interno.
Los registros afectados se importaron, pero la propiedad de enumeración no contiene un valor.
Cómo resolver el error
También puedes actualizar manualmente el valor de la propiedad en los registros afectados.
No se pudo encontrar el propietario
Qué significa el error
El archivo de importación contiene un propietario de registro que no coincide con un usuario en HubSpot. Los registros afectados se importaron, pero el campo Propietario no contiene un valor.
Cómo resolver el error
Actualiza los datos en la columna Propietario de tu archivo de importación para incluir el nombre y el apellido o el correo electrónico de un usuario en tu cuenta. Si la persona a la que deseas asignar al registro aún no es un usuario en la cuenta, agrégalos como usuario, luego vuelve a importar con su nombre o correo electrónico, como aparece en la cuenta.
No se pudo analizar la fecha
Qué significa el error
El archivo de importación contiene valores de fecha que no coinciden con el formato que seleccionaste durante el proceso de importación. Los registros afectados se importaron, pero la propiedad fecha no contiene un valor.
Cómo resolver el error
Actualiza tu archivo de importación con el valor correcto y vuelve a importar o actualiza el valor de propiedad manualmente en los registros afectados.
No se pudo analizar la cantidad
Qué significa el error
El archivo de importación contiene un valor para una propiedad de número con caracteres no numéricos. Los registros afectados se importaron, pero la propiedad de número no contiene un valor.
Cómo resolver el error
Actualiza tu archivo de importación con el valor numérico correcto y vuelve a importar o actualiza el valor de propiedad en los registros afectados.
No se pudo analizar la fila
Qué significa el error
El archivo de importación contiene una fila con datos que no se pueden procesar. Si es una propiedad obligatoria, no se importaron los registros. Si no es una propiedad obligatoria, se importaron los registros, pero esa propiedad no contiene un valor.
Cómo resolver el error
Verifica que tu valor de datos coincida con el formato correcto para la propiedad que estás importando, arreglar cualquier error y vuelve a importar el archivo. También puedes actualizar el valor de la propiedad manualmente en los registros afectados.
No se pudo analizar el término
Qué significa el error
El archivo de importación contiene un valor para un período de tiempo que no coincide con un formato de término aceptado. Los registros afectados aún se importaron, pero la propiedad de término no contiene un valor.
Cómo resolver el error
Actualiza los valores de término en tu archivo para que sea un número entero de meses o en Formato de duración ISO8601 (por ejemplo, un período de tiempo de tres años, seis meses, cuatro días sería P3Y6M4D) y luego vuelve a importar el archivo. También puedes actualizar el valor de la propiedad manualmente en los registros afectados.
ID alternativo duplicado
Qué significa el error
El mismo ID alternativo se usó varias veces dentro de tus archivos. Se importarán tus datos, pero puede haber duplicados del mismo registro en HubSpot. Si intentabas asociar, no se asociaron tus registros.
Cómo resolver el error
- Para evitar duplicados, utilice Correo electrónico para los contactos, Nombre de dominio de la empresa para las empresas, o Registrar ID para cualquier objeto
- A registros de asociados, uso Correo electrónico, Nombre de dominio de la empresa, Registro ID, o elija una propiedad de uno a varios en la que un valor sea único para los muchos registros asociados a él (por ejemplo, Nombre de la empresa como único, que se asociará a muchos contactos que trabajan en la misma empresa) Consulta los archivos de importación de muestra para obtener más orientación.
ID de asociación duplicado
Qué significa el error
El ID de asociación que elegiste para asociar tus registros no es único.
Cómo resolver el error
Elige un encabezado de columna diferente para actuar como la columna común entre tus dos archivos. Para obtener mejores resultados, elige una propiedad uno a muchos donde un valor sea único para los muchos registros asociados con ella (por ejemplo, Nombre de la empresa como el valor único, que se asociará con muchos contactos que trabajan en la misma empresa). Consulta los archivos de importación de muestra para obtener más orientación. Una vez que hayas seleccionado un nuevo ID de asociación, vuelve a importar tus archivos.
ID de registro duplicado
Qué significa el error
El mismo registro ID se utilizó varias veces en sus archivos. Los registros afectados no se actualizaron o se asociaron en HubSpot.
Cómo resolver el error
Actualice su archivo de importación para que sólo haya una fila con ese ID de registro. Mantén la fila con la información más actualizada que deseas incluir en HubSpot. Una vez que hayas eliminado duplicados, vuelve a importar los archivos.
Contenido de la fila duplicado
Qué significa el error
HubSpot detectó que el archivo de importación contiene objetos duplicados. La importación no creará un nuevo registro.
Cómo resolver el error
Elimina el duplicado en el archivo de importación y vuelve a importarlo.
Duplicar valor de propiedad único
Qué significa el error
El mismo valor único se usó varias veces dentro de tus archivos. Se importarán tus datos, pero puede haber duplicados del mismo registro en HubSpot. Si intentabas asociar, no se asociaron tus registros.
Cómo resolver el error
- Para evitar duplicados, utilice Correo electrónico para los contactos, Nombre de dominio de la empresa para las empresas, o Registrar ID para cualquier objeto
- A registros de asociados, uso Correo electrónico, Nombre de dominio de la empresa, Registro ID, o elija una propiedad de uno a varios en la que un valor sea único para los muchos registros asociados a él (por ejemplo, Nombre de la empresa como único, que se asociará a muchos contactos que trabajan en la misma empresa) Consulta los archivos de importación de muestra para obtener más orientación.
No se pudo crear la asociación
Qué significa el error
HubSpot no puede asociar tus registros en su formato actual. Los registros se importaron, pero no estaban asociados.
Cómo resolver el error
Verifica que hayas reunido los requisitos de archivos para asociar tus registros. Si importas en un archivo, es posible que debas agregar un identificador único para cada objeto. Si importas en dos archivos, es posible que debas seleccionar una columna diferente para asociar correctamente. Haz los cambios en tu archivo y vuelve a importar o asocia manualmente tus registros.
No se pudo cancelar la suscripción del contacto
Qué significa el error
HubSpot no pudo cancelar la suscripción a ciertos contactos en el archivo de cancelación de suscripción.Cómo resolver el error
No se pudo procesar el objeto con valores de propiedad vacíos
Qué significa el error
Tu archivo contiene valores vacíos para múltiples columnas y HubSpot no pudo procesar el registro. No se importaron tus datos en esa fila.
Cómo resolver el error
Completa los valores de propiedad faltantes de tu archivo de importación y luego vuelve a importar el archivo.
Falló la validación de la etapa del Correo electrónico, el Negocio/Ticket o Pipeline de negocios/ticket
Qué significa el error
Cómo resolver el error
No se encontró el archivo
Qué significa el error
No se encontró el archivo que seleccionaste. No se importaron tus datos.
Cómo resolver el error
Verifica que hayas guardado tu archivo en tu equipo y que es el tipo de archivo correcto. Una vez que hayas hecho eso, vuelve a cargar el archivo.
Correo electrónico de lista negra de RGPD
Qué significa el error
El archivo de importación contiene uno o más correos electrónicos bloqueados de comunicación debido al RGPD. No se importaron estos contactos.
Cómo resolver el error
El archivo de importación seguirá importando tus otros contactos, pero no puedes agregar los contactos bloqueados a través de importación. Puedes agregar estos contactos manualmente, pero se cancelarán automáticamente las comunicaciones de marketing.
Número incorrecto de columnas
Qué significa el error
El archivo de importación contiene al menos una columna sin un encabezado. No se importaron los datos en columnas sin encabezados.
Cómo resolver el error
Confirma si los datos de la(s) columna(es) deberían importarse, agregar encabezados apropiados o eliminar la (s) columna (s), luego, vuelve a importar el archivo.
ID de alternativo no válido
Qué significa el error
El archivo de importación contiene un valor no válido importado como dirección de correo electrónico, nombre de dominio oID de registro. La importación no creó ni actualizó el registro.
Cómo resolver el error
Actualice su archivo de importación con el valor correcto de correo electrónico, nombre de dominio o ID de registro, y vuelva a importar el archivo.
Identificador de asociación no válido
Qué significa el error
El archivo de importación no contiene un valor único adecuado para asociar tus registros. Los datos se importaron, pero los registros resultantes no se asociaron en HubSpot.
Cómo resolver el error
Actualice su archivo de importación para incluir un identificador de asociación válido (por ejemplo, el correo electrónico para los contactos, el nombre de dominio de la empresa para las empresas o los identificadores de registro) y, a continuación, vuelva a importar el archivo. Descubre cómo configurar correctamente tus archivos para importar y asociar múltiples objetos.
Opción de enumeración no válida
Qué significa el error
El archivo de importación contiene un valor no válido que no coincide con una opción existente en una propiedad de enumeración. Esto se aplica a las propiedades de selección múltiple, selección desplegable, selección de radio y casilla de comprobación. Los registros afectados aún se importaron, pero la propiedad de enumeración no contiene un valor.
Cómo resolver el error
Identifica el valor incorrecto comparando tu archivo de importación con la propiedad en HubSpot. Puedes elegir actualizar el valor en tu archivo de importación para que coincida con una opción existente o agregar el valor como opción personalizada a tu propiedad. Una vez que hayas terminado, vuelve a importar el archivo o actualiza el valor de la propiedad manualmente en los registros afectados.
Tipo de archivo no válido.
Qué significa el error
El archivo de importación es el tipo de archivo incorrecto para importar a HubSpot. Tus datos no fueron importados.
Cómo resolver el error
Convierte tu archivo en un archivo .csv, .xls, o .xlsx y luego vuelve a importar. Revisa los requisitos de archivos adicionales para importar a HubSpot.
Tamaño de número no válido
Qué significa el error
El archivo de importación contiene un valor numérico que es demasiado pequeño o demasiado grande. Las filas afectadas se importaron, pero la propiedad numérica no contiene un valor.
Cómo resolver el error
Confirma los requisitos de formato de tu propiedad específica o el tipo de propiedad, actualiza tu archivo para que coincida con el formato correcto y luego vuelve a importar. También puedes actualizar manualmente el valor de la propiedad en los registros afectados.
ID de registro inválido
Qué significa el error
Durante la importación,se seleccionó la casilla de verificación para actualizar los registros existentes utilizandolos ID de los registros. Sin embargo, el registro ID que aparece en el archivo no coincide con un ID existente en HubSpot. No se importaron los registros.
Cómo resolver el error
Asegúrese de que los ID de los registros son correctos. Es posible que tenga que exportar sus registros existentes para obtener los ID de registro correctos. Si no estás actualizando o asociando objetos existentes en HubSpot, no selecciones la casilla de comprobación durante el proceso de importación.
Propiedad obligatoria no válida
Qué significa el error
Una propiedad obligatoria en el archivo de importación contiene un valor no válido. No se importaron los datos en esa fila.
Cómo resolver el error
Confirma los requisitos de formato de tu propiedad específica o el tipo de propiedad, actualiza tu archivo para que coincida con el formato correcto y luego vuelve a importar.
Recuento de hojas no válido
Qué significa el error
El archivo de importación contiene más de una hoja. No se importaron tus datos.
Cómo resolver el error
Elimina cualquier hoja adicional de tu archivo de importación y luego vuelve a importar. Revisa los requisitos de archivos adicionales para importar a HubSpot.
Hoja de cálculo no válida
Qué significa el error
El archivo de importación no es un archivo de hoja de cálculo válido. No se importaron tus datos.
Cómo resolver el error
Convierte tu archivo en un archivo .csv, .xls, o .xlsx y luego vuelve a importar. Revisa los requisitos de archivos adicionales para importar a HubSpot.
Límite excedido
Qué significa el error
HubSpot no puede crear el registro debido a un límite. Es posible que tu archivo sea demasiado grande o hayas alcanzado un límite de cuenta, como llegar a tu número máximo de listas. No se importaron tus datos.
Cómo resolver el error
Confirme que su archivo es inferior a 150 MB, 1.000 columnas y 1.048.576 filas. El número de filas que puede importar cada día también está limitado por las suscripciones de su cuenta:
- Si utilizas las herramientas gratuitas de HubSpot, puedes importar hasta 500.000 filas al día
- Para el resto de suscripciones, puede importar hasta 10.000.000 de filas al día.
Estos límites se aplican a un período continuo de 24 horas y no se restablecen a una hora específica del día. Si el archivo es más grande, separe los datos en varios archivos. A continuación, reimporte durante varios días. Si el archivo tiene el tamaño correcto, obtén más información sobre tu suscripción de HubSpot y sus limitaciones.
Varias empresas con este dominio
Qué significa el error
El archivo de importación contiene un valor de Nombre de dominio de la empresa que coincide con varias empresas en tu cuenta de HubSpot. La importación no actualizó el registro de la empresa.
Cómo resolver el error
Busca el valor de Nombre de dominio de la empresa en tu página de inicio de empresas para encontrar los dominios duplicados. Combina estos registros de empresas o elimina uno de ellos, luego vuelve a importar el archivo.
Se encontraron varios propietarios
Qué significa el error
El archivo de importación contiene un valor de Propietario que coincide con más de un usuario en la cuenta. Esto suele ocurrir para nombres (por ejemplo, hay dos usuarios de John Doe en tu cuenta de HubSpot y el archivo de importación contiene el nombre «John Doe»). Los registros afectados se importaron, pero la propiedad Propietario no contiene un valor.
Cómo resolver el error
Reemplaza el nombre del propietario con su dirección de correo electrónico en tu archivo de importación y luego vuelve a importar el archivo. También puedes actualizar el valor de propiedad Propietario manualmente en los registros afectados.
Fuera del intervalo de fechas válido
Qué significa el error
El archivo de importación contiene un valor para un período de tiempo que se encuentra fuera del intervalo de fechas aceptado. Los registros afectados se importaron, pero la propiedad de término no contiene un valor.
Cómo resolver el error
Actualiza los valores de término en tu archivo para que se encuentre dentro del intervalo de tiempo aceptado (un número total mayor o igual a 1 mes), luego vuelve a importar el archivo. También puedes actualizar el valor de la propiedad manualmente en los registros afectados.
Fuera del intervalo de tiempo válido
Qué significa el error
El archivo de importación contiene un valor para un período de tiempo que se encuentra fuera del intervalo de tiempo aceptado. Los registros afectados se importaron, pero la propiedad de rango de tiempo no contiene un valor.
Cómo resolver el error
Actualiza los valores de intervalo de tiempo en tu archivo para que esté dentro del intervalo de tiempo aceptado (menos de 1000 años), luego vuelve a importar el archivo. También puedes actualizar el valor de la propiedad manualmente en los registros afectados.
No se encontró la definición de propiedad
Qué significa el error
El archivo de importación contiene un encabezado de columna que no coincide con una propiedad de HubSpot. No se importaron los datos de esa columna.
Cómo resolver el error
Durante la importación, haz que tus columnas coincidan correctamente seleccionando una propiedad existente o creando una nueva propiedad en las columnas de mapa en tu archivo hasta la página de propiedades de [objeto]. También puedes elegir omitir las columnas sin coincidencias.
Error en la regla de validación de la propiedad
Qué significa el error
El archivo de importación contiene un valor que no cumple los requisitos de las reglas de validación de una propiedad (por ejemplo, el valor contiene caracteres especiales, es demasiado largo, demasiado corto, etc.). Los registros afectados fueron importados, pero la propiedad no contiene un valor.
Cómo resolver el error
Vea o edite las reglas de validación de la propiedad en su configuración. Actualice su archivo de importación para incluir un valor que siga las reglas de la propiedad, y luego vuelva a importar el archivo. También puedes actualizar el valor de la propiedad manualmente en los registros afectados.
No se encontró el valor de propiedad
Qué significa el error
En el archivo de importación falta un valor para una propiedad obligatoria. No se importaron los datos en esa fila.
Cómo resolver el error
Actualiza tu archivo de importación para que incluya un valor para la propiedad obligatoria y luego vuelve a importar el archivo.
ID de registro de asociación desconocido
Qué significa el error
Durante la importación,se seleccionó la casilla de verificación para actualizar los registros existentes utilizando los ID de losregistros . Sin embargo, los registros requeridos IDs no se incluyeron en los archivos. Los datos se importaron, pero los registros resultantes no se asociaron en HubSpot.
Cómo resolver el error
Actualice su archivo de importación para incluir los identificadores de los registros y, a continuación, vuelva a importar el archivo. Es posible que tenga que exportar sus registros existentes para obtener los ID de registro correctos. Descubre cómo configurar correctamente tus archivos para importar y asociar múltiples objetos.
Solicitud incorrecta desconocida
Qué significa el error
El archivo de importación contenía un ID de registro no válido que no coincide con ningún registro existente en tu cuenta de HubSpot. La importación no pudo actualizar el registro, ya que los datos no coinciden con ningún registro existente.
Cómo resolver el error
Verifique que tiene el ID de registrocorrecto. Si encuentra un ID incorrecto, actualice su archivo de importación con el ID de registro correcto y vuelva a importar el archivo.
Error desconocido
Qué significa el error
HubSpot no puede procesar el archivo debido a un error desconocido. Tus datos no se importaron.
Cómo resolver el error
Confirma que tu archivo cumple con todos los requisitos. Intenta volver a importar después de borrar el caché de tu navegador o usa otro navegador. Si aún ves un error, publícalo en la Comunidad (todos los usuarios) o contacta al equipo de asistencia técnica (solo cuentas Starter, Pro y Enterprise).
Errores de importación de Salesforce
- Navegue hasta sus registros:
- Contactos: En tu cuenta de HubSpot, dirígete a Contactos > Contactos.
- Empresas: En tu cuenta de HubSpot, dirígete a Contactos > Empresas.
- Negocios: En tu cuenta de HubSpot, dirígete a Ventas > Negocios.
- Tickets: En tu cuenta de HubSpot, dirígete a Servicio > Tickets.
- Objetos personalizados: en tu cuenta de HubSpot, navega a Contactos > Contactos, luego haz clic en el menú desplegable en la parte superior izquierda y selecciona el nombre del objeto personalizado.
- Productos: En tu cuenta de HubSpot, haz clic en elicono de configuración settings en la barra de navegación principal. En la barra lateral izquierda del menú, navega a Objetos > Productos y cotizaciones.
- En la parte superior derecha, haz clic en Importar. Si estás en la página de índice de productos, haz clic en el menú desplegable Acciones y selecciona Importar.
- Coloca el cursor sobre la importación de Salesforce que tiene errores y luego haz clic en Ver errores de importación.
- En la tabla Errores de importación, coloca el cursor sobre un error y haz clic en Ver detalles para ver más información.
- El panel derecho mostrará una descripción del error junto con la información sobre la resolución. Además verás una lista de los registros afectados por el error. Haz clic en el enlace de un registro para acceder al registro y hacer los cambios necesarios.

Contenido relacionado
-
Asignar propiedad de registros
HubSpot utiliza las propiedades de Propietario de [objeto] para establecer la propiedad de un registro de...
Base de conocimientos -
Ver y filtrar registros
Cada objeto de CRM en HubSpot (contactos, empresas, ofertas, tickets y objetos personalizados) tiene una...
Base de conocimientos -
Configurar archivos de importación
Tanto si HubSpot es tu primer CRM como si te mudas desde otro sistema, la importación te ayuda a crear...
Base de conocimientos