> 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-uploads-and-connections.md).

# Solucionar problemas de cargas y conexiones de catálogos de productos

Antes de que impact.com pueda procesar un catálogo de productos, debe recibir correctamente el archivo del catálogo. Esta guía está organizada por método de carga, así que ve a la sección correspondiente al método que usa tu catálogo: [*Obtener desde URL*](#pull-from-url-recommended), [*Importación desde un carrito de compras integrado*](#integrated-shopping-cart-import-recommended), [*servidor FTP de impact.com*](#impact.com-ftp-server), [*servidor SFTP de impact.com*](#impact.com-sftp-server), o [*Carga directa*](#direct-upload). Si no sabes qué método usa tu catálogo, edítalo y consulta su configuración de [*Método de carga* configuración](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md#upload-your-product-catalog).

impact.com recomienda *Obtener desde URL* o *Importación desde un carrito de compras integrado*, porque impact.com controla cuándo se obtiene tu catálogo y con qué frecuencia se actualiza. Si usas el servidor FTP de impact.com, el servidor SFTP de impact.com o *Carga directa*, eres responsable de proporcionar datos actualizados del catálogo periódicamente, preferiblemente a diario, aunque semanalmente también funciona.

Si impact.com recibió tu archivo, pero tu catálogo muestra errores o advertencias, consulta [Solucionar errores y advertencias del catálogo de productos](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md).

## Obtener desde URL (recomendado)

Los protocolos compatibles con *Obtener desde URL* son `http://`, `https://`, `ftp://`y `sftp://`. Si tu catálogo no se carga, no se actualiza o no se procesa correctamente, usa la siguiente tabla para identificar y resolver el problema.

| Problema                                                     | Qué comprobar                                                                                                                                                                                                                                                                                                                                                                                                          | Cómo solucionarlo                                                                                                                                                                                                                                                                                                                     |
| ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| La URL no es un enlace de descarga directa                   | Abre la URL en un navegador. Si te redirige a una página de inicio de sesión o 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 para que apunte a una dirección 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 del 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 del archivo de carga* para que coincida exactamente con el nombre de tu archivo. Una pequeña diferencia provoca un error de *No catalog found for the request* .                                                                                                                                                 |
| El formato o el delimitador no coinciden                     | 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 o barra vertical) coincida con el configurado.                                                                                                                                                                                                         | Corrige el formato o el delimitador en la configuración del catálogo. Una discrepancia provoca *No se encontraron registros válidos* errores.                                                                                                                                                                                         |
| FTP/SFTP: credenciales o ruta no válidas                     | Verifica que la 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 formato URL (por ejemplo, `@` se convierte en `%40`).                                                                                                                                        | Prueba las credenciales con un cliente FTP, como FileZilla. Actualiza la URL con las credenciales corregidas y la ruta completa del archivo.                                                                                                                                                                                          |
| La solicitud agota el tiempo de espera o no logra conectarse | Es posible que el firewall de tu servidor esté bloqueando las solicitudes de impact.com.                                                                                                                                                                                                                                                                                                                               | Ponte en contacto con tu proveedor de alojamiento o equipo de TI para añadir a la lista de permitidos los rangos de direcciones IP de impact.com.                                                                                                                                                                                     |
| La URL requiere autenticación                                | Este método de carga no admite la autenticación basada en sesiones o cookies.                                                                                                                                                                                                                                                                                                                                          | Usa una URL de descarga directa de acceso público, autenticación básica HTTP integrada en la URL (`https://user:pass@host/path`) o FTP/SFTP con las credenciales en la URL. Si tu feed requiere iniciar sesión desde un navegador, cambia tu catálogo a otro método de carga, como *Carga directa* o el *servidor FTP de impact.com*. |
| La URL supera los 2048 caracteres                            | Las URL firmadas de almacenamiento en la nube pueden superar el límite de 2048 caracteres y truncarse.                                                                                                                                                                                                                                                                                                                 | Usa un acortador de URL que conserve la descarga directa o aloja el archivo en una URL más corta.                                                                                                                                                                                                                                     |
| El catálogo se queda atascado en «Procesando» o «Pendiente»  | Comprueba si el archivo sigue estando disponible en la URL y si su tamaño es inusualmente grande para la frecuencia de descarga.                                                                                                                                                                                                                                                                                       | Verifica que el archivo esté disponible. Si el catálogo permanece en *Procesando* o *Pendiente*, [ponte en contacto con el servicio de asistencia](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 cambiaron el nombre del archivo, el formato o la configuración de acceso al servidor.                                                                                                                                                                                                                                                                    | Restaura el archivo en la URL original o actualiza la configuración del catálogo para reflejar la nueva URL o el nuevo nombre del archivo. En catálogos grandes (1 000 000 de elementos o más), considera reducir la frecuencia de descarga para evitar que se agote el tiempo de espera.                                             |
| Faltan campos o datos después de la carga                    | Confirma que los nombres de los campos coincidan con las especificaciones del formato seleccionado, por ejemplo, los [campos de Google Merchant Center](https://support.google.com/merchants/answer/7052112) para el formato GMC. Asigna los campos personalizados que no se ajusten a las especificaciones estándar a los espacios para campos personalizados de impact.com (`Numeric1`, `Text1`y así sucesivamente). | Descarga de impact.com el catálogo que subiste y compáralo con el archivo de origen para detectar dónde se están perdiendo datos. Actualiza los nombres o las asignaciones de los campos según sea necesario y vuelve a cargarlo.                                                                                                     |

## Importación desde un carrito de compras integrado (recomendado)

Este método obtiene tu catálogo de una plataforma de comercio electrónico existente. La mayoría de los problemas de conexión se deben a credenciales incorrectas o a la falta de permisos de lectura. Busca tu plataforma a continuación.

### Shopify (recomendado)

Si aparece un error como *Unsuccessful HTTP status code when connecting to Shopify: 401* o *No valid records were found in the catalog file*, normalmente la causa son los datos de autenticación o los permisos.

* Tu contraseña debe ser el **token de acceso a la API de administración**, que empieza por `shpat_` (o `shap_`). Lo encontrarás en el panel de administración de Shopify, en **Aplicaciones** **→** **Credenciales de API** **→** **token de acceso a la API de administración**.
* Si no ves el **token de acceso a la API de administración**, selecciona **Instalar aplicación** en Shopify para generarlo.
* Confirma que se haya concedido a la aplicación el permiso (ámbito) `read_products` . Sin este permiso, Shopify devuelve un error que indica que la acción requiere la aprobación del comerciante para el ámbito `read_products` .
* Para encontrar el ID de una colección, ve al panel de administración de Shopify y selecciona **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/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog).

### Amazon (recomendado)

La integración del carrito de compras de Amazon es exclusiva para las marcas con [suscripciones de vendedor](https://help.impact.com/brand/es/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) y no es una función de autoservicio. La importación automática del catálogo de Amazon está limitada a 1.000 productos debido a las restricciones de la API de Amazon. Si tu catálogo de vendedor tiene más de 1.000 productos, utiliza un método de carga de archivos, como *Importar desde URL*, en su lugar.

Para ver los pasos de configuración, consulta la [guía de integración de Amazon](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-amazon).

### BigCommerce

Para conectar BigCommerce se necesitan dos valores y los permisos de solo lectura adecuados.

* Introduce el **hash de la tienda** y el **token de acceso** en la interfaz de usuario de impact.com. El hash de la tienda es el identificador que aparece en la ruta de la API de tu tienda.
* Al crear la cuenta de API en BigCommerce, configura los permisos de **Productos** y **Información y configuración** como de solo lectura.

Como referencia, consulta la guía de BigCommerce para [crear tokens de API](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token).

### WooCommerce

Si ves *No se pudo establecer la conexión con WooCommerce. Inténtalo de nuevo*, comprueba tus credenciales y la configuración de la API.

* Tu **nombre de usuario de la API** es tu *clave de consumidor*, y tu **contraseña de la API** es tu *secreto de consumidor*.
* Activa la API REST heredada en WooCommerce: **WooCommerce** **→** **Ajustes** **→** **Avanzado** **→** **API heredada**, luego marca la casilla para activarla.

Para más información, consulta la [documentación de la API REST de WooCommerce](https://woocommerce.com/document/woocommerce-rest-api/).

### Shoplazza

Tu aplicación privada de Shoplazza necesita acceso de lectura a los siguientes recursos: `product`, `collection`, y `shop`.

Para ver 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).

## servidor FTP de impact.com

La mayoría de los problemas de FTP se deben a la configuración de la 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 las credenciales de FTP   | Necesitas el usuario y la contraseña de FTP asignados a tu cuenta para conectarte. | Busca tus *credenciales del sistema de datos de productos por FTP* en la configuración técnica de tu cuenta. Si no las encuentras o no puedes acceder a ellas, [contacta con el equipo de soporte](https://app.impact.com/support/portal.ihtml). |

## servidor SFTP de impact.com

El servidor SFTP de impact.com es un método de carga especializado, reservado para integraciones específicas.

| Problema                                   | Qué comprobar                                                                                                                                        | Cómo solucionarlo                                                                                                                                                                                                                                                   |
| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Tu plataforma de feeds no puede conectarse | Confirma que tu plataforma se está conectando al host `products.impact.com` en el puerto `22`, y que las credenciales son las asignadas a tu cuenta. | Prueba las mismas credenciales en un cliente SFTP estándar, como FileZilla o Cyberduck. Si el cliente se conecta, pero tu plataforma de feeds sigue sin poder hacerlo, cambia el catálogo a *Obtener de una URL* siguiendo los pasos que se indican a continuación. |

### Cambiar de envío push a extracción pull

impact.com recomienda extraer (pull) el feed en lugar de enviarlo (push). Cuando impact.com extrae el feed directamente del servidor SFTP de tu plataforma de feeds (por ejemplo, SFTPGo), impact.com controla cuándo y con qué frecuencia se actualiza tu catálogo, y ya no dependes del servidor SFTP de impact.com. Cambiar a la extracción también resuelve los errores de conexión que puede tener tu plataforma de feeds (por ejemplo, Feedonomics) al enviar archivos al servidor SFTP de impact.com.

Antes de cambiar, pide a tu plataforma de feeds (por ejemplo, Feedonomics) que configure una ubicación SFTP de salida para tu feed y que te proporcione:

* Host y puerto SFTP/FTP (por ejemplo, sftpgo.feedonomics.com:22)
* Nombre de usuario y contraseña
* Ruta del archivo (por ejemplo, incoming/catalog\_feed.txt.gz)

{% hint style="warning" %}
**Advertencia:** Actualiza tu catálogo existente en lugar de crear uno nuevo. Un nuevo catálogo que use el mismo *Nombre de archivo de carga* devuelve un error de *Nombre de archivo ya en uso* y es posible que tu catálogo actual ya alimente otros programas.
{% endhint %}

1. En el menú de navegación de la izquierda, selecciona ![](https://3147719151-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **Contenido** **→** **Productos** **→** [**Catálogos de productos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Pasa el cursor sobre tu catálogo actual y selecciona **Editar**.
3. En la sección *Método de carga* selecciona **Extraer desde URL**.
4. Selecciona el **Formato** que coincida con el archivo de tu feed.
5. Introduce el **Nombre de archivo de carga**, exactamente igual al nombre del archivo, incluida la extensión.
6. Introduce la **URL de extracción** con el formato `sftp://[username]:[password]@[host]:22/[path/to/file]`.
   * Codifica en URL los caracteres especiales de tus credenciales. Por ejemplo, `@` se convierte en `%40`.
7. Selecciona la **Frecuencia de obtención**, **Hora de obtención**, y la **Zona horaria**.
8. Selecciona **Guardar**.

## Carga directa

Los problemas con la carga directa suelen deberse a un formato o nombre de archivo que no coincide, o a que el archivo supera el límite de 1 GB.

| Problema                            | Qué comprobar                                                                                                                                                                                         | Cómo solucionarlo                                                                                                                                                                                      |
| ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Formato seleccionado incorrecto     | El formato que elegiste (por ejemplo, TXT) no coincide con el del archivo que subiste (por ejemplo, XML).                                                                                             | Vuelve a cargar el archivo y selecciona el formato que corresponda. Los archivos XML usan la extensión `.xml` y los archivos CSV usan `.csv`, y los archivos delimitados por tabulaciones usan `.txt`. |
| El nombre del archivo no coincide   | El nombre del archivo que subas debe coincidir exactamente con *Nombre del archivo que se subirá* configurado en los ajustes de tu catálogo, incluida la extensión.                                   | Cambia el nombre del archivo o actualiza el *Nombre del archivo que se subirá* para que ambos coincidan exactamente.                                                                                   |
| No se procesa el archivo comprimido | impact.com admite archivos gzip y archivos comprimidos con el formato ZIP estándar. Un archivo comprimido puede usar una segunda extensión para indicar la compresión; por ejemplo, `catalog.xml.gz`. | Confirma que el 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.                                                        |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/es/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
