> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md). # Solucionar errores y advertencias de catálogos de productos Cada catálogo de productos tiene una puntuación de estado que indica qué problemas, si los hay, están presentes en tu catálogo. Los problemas pueden aparecer en cualquier etapa: cuando el archivo se carga o conecta, después de procesarse o cuando tus socios intentan ver y promocionar tus productos. Usa esta guía para resolver los problemas en cada etapa y llevar tu catálogo al *excelente* rango. {% hint style="info" %} **Consejo:** Un catálogo saludable implica más que eliminar errores. Sigue las [Mejores prácticas para catálogos de productos](/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) para mantener tus datos completos, bien estructurados y preparados para lograr una buena visibilidad y un buen rendimiento. {% endhint %} {% embed url="" %} ## Puntuaciones de estado del catálogo 1. En el menú de navegación izquierdo, selecciona ![](/files/fe7777a565e5a85579aeb006aa379fcc1b594c29) **\[Engage]** **→** **Contenido** **→** **Productos** **→** [**Catálogos de productos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml). 2. Si un catálogo tiene errores, advertencias o líneas duplicadas, la *Estado* columna muestra cuántos hay de cada uno. * Los métodos de carga que recuperan automáticamente el catálogo se actualizan solos la próxima vez que se produce un evento de recuperación.
Descripciones de estado | Indicador de estado | Descripción | | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Pendiente** | Tu catálogo de productos está a la espera de su primera carga o extracción de datos. | | **Procesando** | Tu catálogo de productos se está procesando. | | **Excelente** | Indica un catálogo saludable. Este conjunto de datos de productos está completo y bien estructurado, lo que le da la mejor oportunidad de rendir eficazmente. | | **Bueno** | Indica que podrían faltar ciertos campos sugeridos que contienen datos cruciales, como la categoría o la descripción. Corregir estas lagunas mejora la calidad general de tu catálogo. | | **Deficiente** | Falta información obligatoria en más del 10 % de los registros que proporcionaste. Este catálogo debe corregirse y volver a cargarse. |
## Soluciona los problemas de carga y conexión Antes de que se pueda procesar un catálogo, impact.com debe recibirlo correctamente. Los pasos siguientes están agrupados por el método de carga que seleccionaste al crear el catálogo. Si no estás seguro de qué método se está usando, selecciona el catálogo y revisa su *Método de carga* configuración. ### Carga directa Los problemas de Carga directa suelen deberse a una discrepancia de formato o de nombre de archivo, o a un archivo que supera el límite de 1 GB. | Problema | Qué comprobar | Cómo solucionarlo | | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Formato incorrecto seleccionado | El formato que elegiste (por ejemplo, TXT) no coincide con el archivo que cargaste (por ejemplo, XML). | Vuelve a cargarlo y selecciona el formato que coincida con tu archivo. Los archivos XML usan la `.xml` los archivos CSV usan `.csv`, y los archivos delimitados por TAB usan `.txt`. | | El nombre del archivo no coincide | El nombre del archivo que cargaste debe coincidir exactamente con el *Nombre de archivo de carga* configurado en la configuración de tu catálogo, incluida la extensión. | Cambia el nombre de tu archivo o actualiza el *Nombre de archivo de carga* para que ambos coincidan exactamente. | | El archivo comprimido no se procesará | impact.com admite archivos comprimidos gzip y zip estándar. Un archivo comprimido puede usar una segunda extensión para indicar la compresión, por ejemplo `catalog.xml.gz`. | Confirma que tu tipo de compresión sea gzip o zip, y que el archivo use las extensiones correctas tanto para su formato como para su compresión. | ### Servidor FTP de impact.com La mayoría de los problemas de FTP se deben a la configuración de conexión o a las credenciales. | Problema | Qué comprobar | Cómo solucionarlo | | -------------------------------- | --------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | No se puede conectar al servidor | Confirma que te estás conectando al host `products.impact.com` en el puerto `21`. | Actualiza tu cliente FTP con el host y el puerto correctos y vuelve a conectarte. | | Faltan credenciales de FTP | Necesitas el inicio de sesión y la contraseña de FTP emitidos para tu cuenta para conectarte. | Localiza tus *credenciales del Sistema de datos de productos FTP* en la configuración técnica de tu cuenta. Si no puedes encontrarlas o acceder a ellas, [contacta con soporte](https://app.impact.com/support/portal.ihtml). | ### Obtener desde URL Los protocolos compatibles para *Obtener desde URL* son `http://`, `https://`, `ftp://`, y `sftp://`. Si tu catálogo no se está cargando, actualizando o procesando correctamente, usa la tabla siguiente para identificar y resolver el problema. | Problema | Qué comprobar | Cómo solucionarlo | | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | La URL no es un enlace de descarga directa | Abre tu URL en un navegador. Si redirige a una página de inicio de sesión, a una página de destino de almacenamiento en la nube o devuelve un error 404 o 403, la URL no es un enlace de descarga directa. | Actualiza la URL a una que descargue el archivo directamente o lo muestre como datos sin procesar al abrirla en un navegador. | | El nombre del archivo no coincide | El *Nombre de archivo de carga* en la configuración de tu catálogo debe coincidir exactamente con el nombre real del archivo en la URL, incluida la extensión (`.csv`, `.xml`, `.txt`, `.gz`). | Actualiza el *Nombre de archivo de carga* para que coincida exactamente con el nombre de tu archivo. Una pequeña discrepancia provoca un *No se encontró ningún catálogo para la solicitud* error. | | Discrepancia de formato o delimitador | Confirma que el formato seleccionado (CSV, TXT, XML, GMC) coincida con tu archivo. Si usas un archivo delimitado, confirma que el delimitador (coma, tabulación, barra vertical) coincida con lo configurado. | Corrige el formato o el delimitador en la configuración de tu catálogo. Una discrepancia provoca *No se encontraron registros válidos* errores. | | FTP/SFTP: credenciales o ruta no válidas | Verifica que tu URL use el formato `sftp://{username}:{password}@{host}/{file_path}`. La ruta debe apuntar al archivo exacto, no solo a un directorio. Los caracteres especiales de las credenciales deben codificarse en URL (por ejemplo, `@` se convierte en `%40`). | Prueba tus credenciales con un cliente FTP como FileZilla. Actualiza la URL con las credenciales corregidas y la ruta completa del archivo. | | La obtención caduca o no logra conectarse | El firewall de tu servidor podría estar bloqueando las solicitudes de impact.com. | Contacta a tu proveedor de alojamiento o al equipo de TI para incluir en la lista de permitidos los rangos de direcciones IP de impact.com. | | La URL requiere autenticación | Este método de carga no admite autenticación basada en sesión ni en cookies. | Usa una URL de descarga directa de acceso público, con autenticación básica HTTP incrustada en la URL (`https://user:pass@host/path`), o FTP/SFTP con credenciales en la URL. Si tu feed requiere inicio de sesión en el navegador, cambia tu catálogo a otro método de carga, como *Carga directa* o *Servidor FTP de impact.com*. | | La URL supera los 2.048 caracteres | Las URL firmadas de almacenamiento en la nube pueden superar el límite de 2.048 caracteres y truncarse. | Usa un acortador de URL que preserve la descarga directa o aloja el archivo en una URL más corta. | | Catálogo atascado en Procesando o Pendiente | Comprueba si el archivo sigue siendo accesible en la URL y si el tamaño del archivo es inusualmente grande para tu frecuencia de obtención. | Verifica que el archivo esté disponible. Si el catálogo sigue en *Procesando* o *Pendiente*, [contacta con soporte](https://app.impact.com/support/portal.ihtml) para solicitar un reprocesamiento manual. | | El catálogo dejó de actualizarse automáticamente | Comprueba si el archivo sigue disponible en la misma URL y si el nombre del archivo, el formato o la configuración de acceso al servidor han cambiado. | Restaura el archivo en la URL original o actualiza la configuración de tu catálogo para reflejar la nueva URL o el nuevo nombre de archivo. Para catálogos grandes (más de 1.000.000 de elementos), considera reducir la frecuencia de obtención para evitar caducidades. | | Faltan campos o datos después de la carga | Confirma que los nombres de tus campos coincidan con la especificación del formato seleccionado, por ejemplo [campos de Google Merchant Center](https://support.google.com/merchants/answer/7052112) para el formato GMC. Asigna los campos personalizados fuera de la especificación estándar a los espacios de campos personalizados de impact.com (`Numeric1`, `Text1`, y así sucesivamente). | Descarga tu catálogo cargado desde impact.com y compáralo con tu archivo de origen para encontrar dónde se están perdiendo los datos. Actualiza los nombres de los campos o los mapeos según sea necesario y, luego, vuelve a cargarlo. | ### Importación integrada de carrito de compras Este método extrae tu catálogo desde una plataforma de comercio electrónico existente. La mayoría de los problemas de conexión se deben a credenciales incorrectas o a permisos de lectura faltantes. Selecciona tu plataforma a continuación. {% tabs %} {% tab title="Shopify" %} Si ves un error como *Código de estado HTTP no exitoso al conectar con Shopify: 401* o *No se encontraron registros válidos en el archivo del catálogo*, normalmente la causa son tus datos de autenticación o permisos. * Tu contraseña debe ser el **token de acceso de la API de administración**, que comienza con `shpat_` (o `shap_`). Lo encontrarás en tu panel de Shopify en **Aplicaciones** **→** **Credenciales de API** **→** **token de acceso de la API de administración**. * Si no ves la **token de acceso de la API de administración**selecciona **Instalar aplicación** en Shopify para generarlo. * Confirma el `read_products` permiso (ámbito) esté concedido a la aplicación. Sin él, Shopify devuelve un error que indica que la acción requiere la aprobación del comerciante para el `read_products` ámbito. * Para las colecciones, encuentra el ID de la colección en tu Shopify Admin en **Productos** **→** **Colecciones**. Selecciona la colección; su ID aparece al final de la URL de la página. Para ver los pasos completos de configuración, consulta la [guía de integración del catálogo de productos de Shopify](https://integrations.impact.com/impact-brand/docs/shopify-product-catalog). {% endtab %} {% tab title="WooCommerce" %} Si ves *La conexión con WooCommerce no se realizó correctamente. Inténtalo de nuevo*, comprueba tus credenciales y la configuración de la API. * Tu **nombre de usuario de la API** es tu WooCommerce *clave del consumidor*, y tu **contraseña de la API** es tu *secreto del consumidor*. * Activa la API REST heredada en WooCommerce: **WooCommerce** **→** **Configuración** **→** **Avanzado** **→** **API heredada**, y luego marca la casilla para activarla. Como referencia, consulta la [documentación de la API REST de WooCommerce](https://woocommerce.com/document/woocommerce-rest-api/). {% endtab %} {% tab title="BigCommerce" %} Conectar BigCommerce requiere dos valores y los permisos de solo lectura correctos. * Introduce tu **hash de la tienda** y **token de acceso** en la interfaz de impact.com. Tu hash de tienda es el identificador en la ruta de API de tu tienda. * Establece los **Productos** y **permisos de Información y configuración** como solo lectura cuando crees la cuenta de API en BigCommerce. Como referencia, consulta la guía de BigCommerce para [crear tokens de API](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token). {% endtab %} {% tab title="Shoplazza" %} Tu aplicación privada de Shoplazza necesita acceso de lectura a los siguientes recursos: `producto`, `colección`, y `tienda`. Para los pasos de configuración, consulta la guía de Shoplazza para [crear aplicaciones privadas](https://www.shoplazza.dev/reference/quick-construction-of-private-apps). {% endtab %} {% endtabs %} ## Soluciona errores y advertencias después de la carga Una vez que se recibe un archivo, impact.com valida cada registro. Los errores impiden que los registros se procesen, mientras que las advertencias señalan datos que fueron aceptados pero que pueden causar problemas. Usa las secciones siguientes para interpretarlos y resolverlos. ### Ver errores y advertencias 1. En la *Estado* columna, selecciona el **errores**, **advertencias**, o **duplicados** enlace. * Se te redirigirá a una página con más detalles. Solo el primer elemento de un conjunto de duplicados se representa en impact.com; todos los elementos que dupliquen al primero se ignoran. 2. Opcionalmente, usa el *campo de búsqueda* y los filtros en la parte superior de la página para revisar los problemas. 3. Revisa los problemas y realiza los cambios necesarios, luego vuelve a cargar tu catálogo de productos.
Descripciones de filtros | Filtro | Descripción | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | Tipo de error | Filtra específicamente por *Errores*, *Advertencias*, *Duplicados*, o *Todos* los problemas. | | Obligatorio | Filtra cualquier campo específico obligatorio que falte en el catálogo de productos, o *Todos* campos. | | Sugerido | Filtra cualquier campo específico recomendado que falte en el catálogo de productos, o *Todos* campos. | | Inválido | Filtra cualquier error específico basado en validación, como un SKU duplicado, un código de categoría de Google no válido u otros errores. |
Mensajes comunes de error y advertencia | Mensaje | Explicación | | -------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | *Registro 'X': faltan campos obligatorios: (nombre del campo)* | La línea especificada carece de uno o más campos obligatorios. | | *Registro 'X': CatalogItemId(CatalogItemId): faltan campos obligatorios: (nombre del campo)* | Una línea del archivo de datos carece de un campo obligatorio. | | *No se encontró ningún catálogo para la solicitud. Comprueba si el nombre del archivo cargado es el mismo que el registrado con el catálogo* | El *Nombre de archivo de carga* establecido en la *Método de carga* sección al crear el catálogo no coincide exactamente con el nombre del archivo que cargaste. | | *No hay atributos presentes en el archivo del catálogo* | El archivo de datos del catálogo de productos no tiene datos procesables. | | *El elemento del catálogo con ese ID aparece más de una vez en el catálogo, y los posteriores al primero se ignorarán* | Dos o más elementos tienen el mismo ID. Todos los productos requieren un valor único y los elementos duplicados no se procesan. | | *El registro 'X' tiene un error: (línea X) carácter no válido entre el token encapsulado y el delimitador* | Una línea contiene un uso no válido de comillas dobles. Encierra el campo entre comillas dobles y reemplaza todas las demás comillas dobles por dos comillas dobles. | | *(Línea de inicio X) se alcanzó el EOF antes de que terminara el token encapsulado* | EOF significa "fin de archivo". La línea de inicio mencionada tiene una comilla doble de apertura sin una comilla doble de cierre, o un salto de línea inesperado interrumpió el flujo de datos. | | *Error al analizar el campo (tipo de catálogo): con el valor: (campo)* | El campo de producto no es válido y no puede aceptarse. | | *El registro (recordNumber) tiene un error: el número de valores delimitados (FieldsLength) no coincide con el esperado (ColumnNamesLength)* | Para una fila determinada, existen datos en una columna que no tiene encabezado. | | *No se encontraron registros válidos en el archivo del catálogo* | El archivo de datos está vacío, los datos detectados no son válidos o el nombre de archivo especificado es incorrecto. | | *Más del 10 % de los registros del archivo tenían errores* | El archivo de datos no se puede procesar si esto ocurre. Consulta *Comprender el umbral de error del 10 %* a continuación. | | *El procesamiento falló debido a un error interno del sistema...* | No se requiere ninguna acción por tu parte. El último catálogo que se procesó correctamente sigue estando disponible para los socios de medios. Consulta la [página de estado de impact.com](https://status.impact.com/) para obtener detalles sobre interrupciones del servicio. | | *El campo (nombre del campo) con el valor (valor del campo) no tiene un protocolo válido* | El valor del campo no es una URL con formato correcto. |
### Advertencias de formato y delimitador | Problema | Cómo solucionarlo | | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Problemas de delimitador: una coma, tabulación o línea vacía incorrecta rompe el límite entre campos. | Corrige el uso del delimitador en el archivo del catálogo para que cada campo quede separado de forma coherente y, luego, vuelve a cargarlo. | | Los saltos de línea en un campo de descripción interrumpen el procesamiento del registro. | Los saltos de línea no son compatibles con los formatos de texto delimitado (CSV y TSV). Elimina los saltos de línea de campos de texto como las descripciones antes de cargarlo. | ### Errores del formato de Google Merchant Center Si usas el formato de Google Merchant Center (GMC), la mayoría de los problemas surgen en torno a la `sección de categoría` , los valores de campo predefinidos o la estructura XML. {% tabs %} {% tab title="Falta la categoría de producto de Google" %} Cuando seleccionas *errores* en la *Catálogos de productos* pantalla, puedes ver *Falta la categoría de producto de Google* en la *columna de sugerencias* columna. Esto significa que no se incluyó ningún código de categoría de Google ni ninguna cadena completa de categoría de Google en tu catálogo. Para resolverlo, consulta tu [cuenta de Google Merchant Center](https://merchants.google.com/). Google sugiere automáticamente categorías para los elementos; usa estas sugerencias al cargar el catálogo corregido.
{% endtab %} {% tab title="Desajuste de la categoría de producto de Google" %} Cuando seleccionas *errores* en la *Catálogos de productos* pantalla, puedes ver *Desajuste de la categoría de producto de Google* en la *Inválido* columna. Esto significa que la categoría usada para los elementos de tu catálogo no coincide con la [código de taxonomía](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) (por ejemplo, 7386) o con el formato completo de categoría que proporciona Google, por ejemplo: `Animals & Pet Supplies > Pet Supplies > Bird Supplies > Bird Cage Accessories > Bird Cage Food & Water Dishes` Para resolverlo, corrige el formato en que se enumeran las categorías de producto de Google y, luego, vuelve a cargar tu catálogo.
{% endtab %} {% tab title="Valor de disponibilidad no aceptado" %} Un error como *No se pudo analizar el campo: availability con el valor* significa que un campo predefinido está usando un valor que GMC no reconoce. Para los catálogos GMC, las categorías y los valores deben ser exactos. * Usa `availability` para el campo de disponibilidad. * Los valores de disponibilidad admitidos son `in_stock`, `out_of_stock`, `preorder`, y `backorder`. * Comprueba si hay símbolos especiales que puedan afectar al formato, como un símbolo de moneda que aparezca en un campo de valor. {% endtab %} {% tab title="XML: no se encontraron registros válidos" %} Si sube un catálogo de Google Merchant Center (formato XML) y ve *No se encontraron registros válidos en el archivo del catálogo. Corrija el archivo y vuelva a cargarlo*, es probable que la estructura XML sea incorrecta. El archivo XML debe contener `rss`, `RDF`, o `feed` en su elemento inicial. Corrija el elemento raíz y vuelva a cargarlo. {% endtab %} {% endtabs %} {% hint style="info" %} **Formato de eBay Commerce Merchant Center:** En un `.csv` archivo, reemplace los espacios en los valores de la columna de campos (categorías) con guiones bajos. Por ejemplo, use `Item_Title` en lugar de `Item Title`. {% endhint %} ### Comprender el umbral de error del 10 % Si más del 10 % de los registros de un archivo cargado contienen errores, el archivo no se procesa. Cuando esto sucede: * Su catálogo sigue mostrando la versión de la última carga correcta, por lo que se espera una marca de tiempo más antigua de *último envío correcto* . * El **Ver productos** la opción solo aparece si anteriormente se cargó correctamente un archivo para ese ID de catálogo. Corrija los registros marcados para que menos del 10 % contengan errores y luego vuelva a cargarlo. ## Haga que su catálogo esté disponible para los socios Un catálogo en buen estado aún no llegará a sus socios hasta que lo haga disponible y cumpla los requisitos de visibilidad para socios. Use esta sección si su catálogo se procesó correctamente, pero los socios están teniendo problemas de visibilidad, acceso al producto o enlaces de seguimiento. ### Los socios no pueden ver el catálogo Compruebe las dos configuraciones siguientes: * Asegúrese de que el catálogo esté disponible para su uso: 1. Seleccione ![](/files/fe7777a565e5a85579aeb006aa379fcc1b594c29) **\[Engage]** **→** **Contenido** **→** **Productos** **→** [**Catálogos de productos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) y busque el catálogo. 2. Seleccione ![](/files/e623b6985bea839e92dc82c3889750228a7b7af5) **\[Más]** y luego elija **Hacer disponible para uso**. * Compruebe si el acceso de los socios está restringido: 1. Seleccione ![](/files/fe7777a565e5a85579aeb006aa379fcc1b594c29) **\[Engage]** **→** **Contenido** **→** **Productos** **→** [**Catálogos de productos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) y busque el catálogo. 2. Pase el cursor sobre el catálogo y luego seleccione **Editar**. 3. En la *Restringir acceso de socios* sección, compruebe si **Permitir acceso solo a socios específicos** está ![](/files/56e1fcd9ba564ade1200e6210703a468dfffe350) activado. 4. Si lo está, ![](/files/0f1119e23ac8b4454d420dab256ff17170f23a06) desactívelo y seleccione **Guardar**. ### Los socios no pueden ver ni buscar productos específicos Para que un producto sea visible en la interfaz de usuario del socio, debe cumplir todos los siguientes requisitos: * El precio original es superior a 2,00 USD. * La disponibilidad de stock del producto no es *Sin existencias.* * El producto tiene una URL de producto válida que lleva a una página activa de detalles del producto. * El producto tiene una URL de imagen. * El producto está en un catálogo sin [reglas](/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/create-and-manage-product-catalog-rules.md) aplicadas. ### Los enlaces de seguimiento de los socios devuelven un error de "malformado" Si los socios ven "El enlace en el que hizo clic está mal formado" al usar enlaces de seguimiento de sus productos, normalmente no está habilitado el enlace profundo, o el dominio de la página de destino del producto no está configurado como dominio permitido. Para habilitar el enlace profundo, configure sus dominios permitidos y resuelva este error; consulte [Configurar dominios permitidos para el enlace profundo](/brand/es/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/set-up-permitted-domains-for-deep-linking.md). --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.