> 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 salud que indica qué problemas, si los hay, están presentes en tu catálogo. Para llevar tu catálogo al *excelente* rango, debes solucionar y corregir cualquier error, advertencia y duplicado presente en él.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FZTsEfqMM8xnWruw90lbm%2Feng-350-5.mp4?alt=media&token=80c0e779-2118-482b-9a88-10ff3da3f8a4>" %}

1. Desde el menú de navegación de la izquierda, 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 partidas duplicadas, verás cuántas de cada una están presentes en la *Salud* columna.

   <div data-with-frame="true"><figure><img src="/files/4358fda3965bb68fc8d10cf5b123ee597073b236" alt="" width="563"><figcaption></figcaption></figure></div>

   * Los métodos de carga que obtienen automáticamente el catálogo deberían actualizarse automáticamente cuando ocurra el siguiente evento de recuperación.

<details>

<summary>Descripciones de salud</summary>

| Indicador de salud | Descripción                                                                                                                                                                         |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pendiente**      | Tu catálogo de productos se está cargando.                                                                                                                                          |
| **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 posibilidad de rendir eficazmente.                       |
| **Bueno**          | Indica que ciertos campos sugeridos que contienen datos cruciales, como la categoría o el estado, podrían faltar. Abordar estas lagunas mejorará la calidad general de tu catálogo. |
| **Deficiente**     | Indica que falta información obligatoria en más del 10 % de los registros que enviaste. Este catálogo tendrá que corregirse y volver a cargarse.                                    |

</details>

#### Ver errores y advertencias

1. En la *Salud* columna, selecciona el **errores**, **advertencias**, o **duplicados** enlace.
   * Se te redirigirá a una página con más detalles sobre los errores o advertencias. Solo el primer elemento de un conjunto de duplicados se representará en impact.com; todos los elementos que dupliquen al primero se ignorarán.
2. Opcionalmente, usa el *Búsqueda* campo y los filtros en la parte superior de la página para ordenar los problemas.

<details>

<summary>Descripciones de filtros</summary>

|                   |                                                                                                                                                                       |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tipo de error** | puedes filtrar específicamente por *Errores*, *Advertencias*, *Duplicados*, o *Todos* problemas.                                                                      |
| **Obligatorio**   | Puedes filtrar por cualquier campo específico del catálogo de productos obligatorio que falte o *Todos* campos.                                                       |
| **Sugerido**      | Puedes filtrar por cualquier campo específico recomendado del catálogo de productos que falte o *Todos* campos.                                                       |
| **Inválido**      | Puedes filtrar por cualquier error específico basado en la validación. Puede tratarse de un SKU duplicado, un código de categoría de Google inválido u otros errores. |

</details>

3. Revisa los problemas y haz los cambios necesarios. Luego, vuelve a cargar tu catálogo de productos.

<details>

<summary>Mensajes comunes de error y advertencia</summary>

| Mensaje de error                                                                                                                                                                                                                                                                                                                                                                              | Explicación                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Registro 'X': faltan campos obligatorios: (nombre del campo)*                                                                                                                                                                                                                                                                                                                                | La línea especificada no tiene uno o más campos obligatorios.                                                                                                                                                                                                                                                                                                         |
| *Registro 'X': CatalogItemId(CatalogItemId): faltan campos obligatorios: (nombre del campo)*                                                                                                                                                                                                                                                                                                  | Una línea del archivo de datos no tiene 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 del archivo cargado* establecido en el *método de carga* sección al crear un catálogo de productos 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 ID aparece más de una vez en el catálogo, y los que estén después del primero se ignorarán*                                                                                                                                                                                                                                                                     | 2 o más elementos tienen el mismo ID: todos los productos requieren un valor único. Los elementos duplicados no se procesarán.                                                                                                                                                                                                                                        |
| *Registro 'X' tiene un error: (línea X) carácter no válido entre el token encapsulado y el delimitador*                                                                                                                                                                                                                                                                                       | Una línea del archivo de datos contiene un uso no válido de comillas dobles. Esto debe gestionarse correctamente encerrando el campo entre comillas dobles y reemplazando todas las demás comillas dobles por 2 comillas dobles (p. ej., *3" floppy* se convierte en *"3"" floppy"*).                                                                                 |
| *(Línea de inicio X) se alcanzó EOF antes de que el token encapsulado terminara*                                                                                                                                                                                                                                                                                                              | <p>EOF significa "fin de archivo". La línea de inicio mencionada tiene una comilla doble de apertura sin una comilla doble de cierre. Este error se ha producido porque no se encontró una comilla doble de cierre, incluso al leer hasta el final del archivo.</p><p>Como alternativa, un salto de línea inesperado podría haber interrumpido el flujo de datos.</p> |
| *Error al analizar el campo (tipo de catálogo): con 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 de datos determinada, si existen datos en una columna sin encabezado, se producirá este error.                                                                                                                                                                                                                                                          |
| *No se encontraron registros válidos en el archivo del catálogo*                                                                                                                                                                                                                                                                                                                              | O bien el archivo de datos está vacío (es decir, no hay datos), los datos detectados no son válidos o el nombre de archivo especificado es incorrecto.                                                                                                                                                                                                                |
| *Más del 10 % de los registros del archivo contenían errores.*                                                                                                                                                                                                                                                                                                                                | El archivo de datos no se puede procesar si se produce este error.                                                                                                                                                                                                                                                                                                    |
| *El procesamiento falló debido a un error interno del sistema. No se requiere ninguna acción por parte del usuario. Nuestro equipo de ingeniería ha sido notificado y está trabajando para resolver el problema. El último catálogo procesado correctamente seguirá estando disponible para los Media Partners. Ponte en contacto con el soporte de impact.com si necesitas más información.* | Consulta la [página de estado de impact.com](https://status.impact.com/) para obtener detalles sobre las interrupciones del servicio.                                                                                                                                                                                                                                 |
| *El campo (nombre del campo) con valor (valor del campo) no tiene un protocolo válido*                                                                                                                                                                                                                                                                                                        | El valor del campo no es una URL con formato correcto.                                                                                                                                                                                                                                                                                                                |

</details>

#### Errores de formato de Google Merchant

Hay 2 problemas que podrías encontrar si usas el formato de Google Merchant Center como la taxonomía de tu catálogo de productos, y es probable que los problemas surjan en torno a la `categoría` sección.

{% tabs %}
{% tab title="Falta la categoría de producto de Google" %}
Cuando seleccionas *errores* en la *Catálogos de productos* pantalla, es posible que veas *Falta la categoría de producto de Google* en las *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 resolver este problema, consulta tu cuenta de Google Merchant Center. Google sugiere automáticamente categorías para los elementos; esta sugerencia debe usarse al cargar el catálogo corregido.

<div data-with-frame="true"><figure><img src="/files/b70dee07d095621183423069dbd7bf502c2e997a" alt=""><figcaption></figcaption></figure></div>
{% endtab %}

{% tab title="Desajuste de categoría de producto de Google" %}
Cuando seleccionas *errores* en las *Catálogos de productos* pantalla, es posible que veas *Desajuste de categoría de producto de Google* en las *Inválido* columna.

Esto significa que la categoría usada para los elementos de tu catálogo no coincide con el [código de taxonomía](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) (p. ej., 7386) ni con el formato completo de categoría que proporciona Google. Mira el ejemplo siguiente de un formato completo de categoría de Google.

`Animales y suministros para mascotas > Suministros para mascotas > Suministros para aves > Accesorios para jaulas de aves > Platos para comida y agua para jaulas de aves`

Para resolver este problema, corrige el formato en que se enumeran las categorías de producto de Google en tu catálogo y luego vuelve a cargar tu catálogo.

<div data-with-frame="true"><figure><img src="/files/405f765b7efa714e289e48ed682c4758be75bdec" alt=""><figcaption></figcaption></figure></div>
{% endtab %}
{% endtabs %}

#### Solucionar problemas *Extraer desde URL* problemas

Si tu catálogo está configurado para extraerse desde una URL y no se carga, actualiza o procesa correctamente, usa la tabla siguiente para identificar y resolver el problema.

<table><thead><tr><th width="230.53125">Problema</th><th width="258">Qué comprobar</th><th>Cómo solucionarlo</th></tr></thead><tbody><tr><td><em>La URL no es un enlace de descarga directa</em></td><td>Abre tu URL en un navegador. Si redirige a una página de inicio de sesión, una página de destino de almacenamiento en la nube o devuelve un error 404/403, la URL no es un enlace de descarga directa.</td><td>Actualiza la URL a una que descargue el archivo directamente o lo muestre como datos sin formato al abrirla en un navegador.</td></tr><tr><td><em>Discordancia en el nombre del archivo</em></td><td>El <em>nombre del archivo cargado</em> en la configuración de tu catálogo debe coincidir exactamente con el nombre real del archivo en la URL, incluida la extensión (<code>.csv</code>, <code>.xml</code>, <code>.txt</code>, <code>.gz</code>).</td><td>Actualiza el <em>nombre del archivo cargado</em> nombre del archivo cargado <em>No se encontró ningún catálogo para la solicitud</em> error.</td></tr><tr><td><em>Discordancia de formato o delimitador</em></td><td>Confirma que el formato seleccionado (CSV, TXT, XML, GMC) coincide con tu archivo. Si usas un archivo delimitado, confirma que el delimitador (coma, tabulación, barra vertical) coincide con lo configurado.</td><td>Corrige el formato o el delimitador en la configuración de tu catálogo. Un desajuste provoca <em>No se encontraron registros válidos</em> errores.</td></tr><tr><td><em>FTP/SFTP: credenciales o ruta no válidas</em></td><td>Verifica que tu URL use el formato: <code>sftp://{username}:{password}@{host}/{file_path}</code>. La ruta debe apuntar al archivo exacto, no solo a un directorio. Los caracteres especiales en las credenciales deben codificarse en URL (p. ej., <code>@</code> → <code>%40</code>).</td><td>Prueba tus credenciales con un cliente FTP como FileZilla. Actualiza la URL con las credenciales corregidas y la ruta completa del archivo.</td></tr><tr><td><em>La extracción agota el tiempo de espera o no logra conectarse</em></td><td>El firewall de tu servidor podría estar bloqueando las solicitudes de impact.com.</td><td>Contacta a tu proveedor de alojamiento o al equipo de TI para incluir en la lista blanca los rangos de direcciones IP de impact.com.</td></tr><tr><td><em>La URL requiere autenticación</em></td><td>Extraer desde URL no admite autenticación basada en sesión ni en cookies.</td><td>Usa una de las siguientes opciones en su lugar: una URL de descarga directa de acceso público, autenticación básica HTTP incrustada en la URL (<code>https://user:pass@host/path</code>), o FTP/SFTP con credenciales en la URL. Si tu feed requiere inicio de sesión basado en navegador, cambia a <em>Carga directa</em> o <em>FTP Push</em>.</td></tr><tr><td><em>La URL supera los 2.048 caracteres</em></td><td>Las URL firmadas de almacenamiento en la nube pueden superar el límite de 2.048 caracteres y pueden truncarse.</td><td>Usa un acortador de URL que conserve la descarga directa o aloja el archivo en una URL más corta.</td></tr><tr><td><em>El catálogo se quedó atascado en Procesando o Pendiente</em></td><td>Comprueba si el archivo sigue siendo accesible en la URL y si el tamaño del archivo es inusualmente grande para tu frecuencia de extracción.</td><td>Verifica que el archivo esté disponible. Si el catálogo sigue en <em>Procesando</em> o <em>Pendiente</em>, <a href="https://app.impact.com/support/portal.ihtml?createTicket=true">contacta con soporte</a> para solicitar un reprocesamiento manual.</td></tr><tr><td><em>El catálogo dejó de actualizarse automáticamente</em></td><td>Comprueba si el archivo sigue disponible en la misma URL y si el nombre del archivo, el formato o la configuración de acceso del servidor han cambiado.</td><td>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 del archivo. Para catálogos grandes (más de 1 millón de elementos), considera reducir la frecuencia de extracción para evitar tiempos de espera.</td></tr><tr><td><em>Faltan campos o datos después de la carga</em></td><td>Confirma que los nombres de tus campos coincidan con la especificación del formato seleccionado; por ejemplo, <a href="https://support.google.com/merchants/answer/7052112">campos de Google Merchant Center</a> para el formato GMC. Mapea los campos personalizados fuera de la especificación estándar a las ranuras de campo personalizado de impact.com (<code>Numeric1</code>, <code>Text1</code>, etc.).</td><td>Descarga tu catálogo cargado desde impact.com y compáralo con tu archivo de origen para identificar dónde se están perdiendo datos. Actualiza los nombres o asignaciones de los campos según sea necesario y luego vuelve a cargarlo.</td></tr></tbody></table>


---

# 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=<question>&goal=<endgoal>
```

`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.
