> 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/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-uploads-and-connections.md).

# Solucionar problemas de envio e conexão de catálogo de produtos

Antes que a impact.com possa processar um catálogo de produtos, ela precisa receber o arquivo do catálogo. Este guia está organizado por método de upload. Acesse a seção correspondente ao método usado pelo seu catálogo: [*Busca por URL*](#pull-from-url-recommended), [*Importação integrada do carrinho de compras*](#integrated-shopping-cart-import-recommended), [*Servidor FTP da impact.com*](#impact.com-ftp-server), [*Servidor SFTP da impact.com*](#impact.com-sftp-server), ou [*Upload direto*](#direct-upload). Se você não souber qual método seu catálogo usa, edite o catálogo e verifique as [*Método de upload* configurações de](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/add-product-catalogs-as-a-brand.md#upload-your-product-catalog).

A impact.com recomenda *Busca por URL* ou *Importação integrada do carrinho de compras*, pois a impact.com controla quando seu catálogo é buscado e com que frequência é atualizado. Se você usar o servidor FTP da impact.com, o servidor SFTP da impact.com ou *Upload direto*, você será responsável por fornecer dados atualizados do catálogo regularmente, de preferência diariamente, embora a atualização semanal também seja adequada.

Se a impact.com recebeu seu arquivo, mas seu catálogo apresenta erros ou avisos, consulte [Solucionar erros e avisos do catálogo de produtos](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/troubleshoot-product-catalog-errors-and-warnings.md).

## Busca por URL (recomendado)

Os protocolos compatíveis com *Busca por URL* são `http://`, `https://`, `ftp://`e `sftp://`. Se seu catálogo não estiver sendo carregado, atualizado ou processado corretamente, use a tabela abaixo para identificar e resolver o problema.

| Problema                                           | O que verificar                                                                                                                                                                                                                                                                                                                                                                                 | Como corrigir                                                                                                                                                                                                                                                                                                             |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A URL não é um link de download direto             | Abra sua URL em um navegador. Se ela redirecionar para uma página de login ou para uma página inicial de armazenamento em nuvem, ou retornar um erro 404 ou 403, a URL não é um link de download direto.                                                                                                                                                                                        | Atualize a URL para uma que baixe o arquivo diretamente ou o exiba como dados brutos quando aberta em um navegador.                                                                                                                                                                                                       |
| O nome do arquivo não corresponde                  | O *Nome do arquivo de upload* nas configurações do catálogo deve corresponder exatamente ao nome real do arquivo na URL, incluindo a extensão (`.csv`, `.xml`, `.txt`, `.gz`).                                                                                                                                                                                                                  | Atualize o *Nome do arquivo de upload* para que corresponda exatamente ao nome do arquivo. Mesmo uma pequena diferença causa o erro *No catalog found for the request* .                                                                                                                                                  |
| O formato ou delimitador não corresponde           | Confirme se o formato selecionado (CSV, TXT, XML, GMC) corresponde ao seu arquivo. Se você usar um arquivo delimitado, confirme se o delimitador (vírgula, tabulação ou barra vertical) corresponde ao que está configurado.                                                                                                                                                                    | Corrija o formato ou o delimitador nas configurações do catálogo. Uma incompatibilidade causa *Nenhum registro válido encontrado* erros.                                                                                                                                                                                  |
| FTP/SFTP: credenciais ou caminho inválidos         | Verifique se o URL está no formato `sftp://{username}:{password}@{host}/{file_path}`. O caminho deve apontar para o arquivo exato, não apenas para um diretório. Caracteres especiais nas credenciais devem ser codificados para URL (por exemplo, `@` se torna `%40`).                                                                                                                         | Teste suas credenciais com um cliente FTP, como o FileZilla. Atualize o URL com as credenciais corrigidas e o caminho completo do arquivo.                                                                                                                                                                                |
| A busca expira ou não consegue se conectar         | O firewall do seu servidor pode estar bloqueando as solicitações do impact.com.                                                                                                                                                                                                                                                                                                                 | Entre em contato com seu provedor de hospedagem ou equipe de TI para adicionar os intervalos de endereços IP do impact.com à lista de permissões.                                                                                                                                                                         |
| O URL exige autenticação                           | Este método de upload não é compatível com autenticação baseada em sessão ou em cookies.                                                                                                                                                                                                                                                                                                        | Use um URL de download direto acessível publicamente, autenticação HTTP Basic incorporada ao URL (`https://user:pass@host/path`), ou FTP/SFTP com as credenciais no URL. Se o feed exigir login pelo navegador, altere o método de upload do catálogo para outro, como *Upload direto* ou o *servidor FTP do impact.com*. |
| O URL excede 2.048 caracteres                      | URLs assinados de armazenamento em nuvem podem ultrapassar o limite de 2.048 caracteres e ser truncados.                                                                                                                                                                                                                                                                                        | Use um encurtador de URL que preserve o download direto ou hospede o arquivo em um URL mais curto.                                                                                                                                                                                                                        |
| Catálogo travado em Processando ou Pendente        | Verifique se o arquivo ainda está acessível no URL e se o tamanho dele é excepcionalmente grande para a frequência de busca configurada.                                                                                                                                                                                                                                                        | Verifique se o arquivo está disponível. Se o catálogo continuar em *Processando* ou *Pendente*, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml) para solicitar um novo processamento manual.                                                                                                |
| O catálogo parou de ser atualizado automaticamente | Verifique se o arquivo ainda está disponível no mesmo URL e se o nome do arquivo, o formato ou as configurações de acesso ao servidor foram alterados.                                                                                                                                                                                                                                          | Restaure o arquivo no URL original ou atualize as configurações do catálogo para refletir o novo URL ou nome do arquivo. Para catálogos grandes (1.000.000 ou mais itens), considere reduzir a frequência de busca para evitar tempos limite.                                                                             |
| Campos ou dados ausentes após o upload             | Confirme se os nomes dos campos correspondem às especificações do formato selecionado, por exemplo, [campos do Google Merchant Center](https://support.google.com/merchants/answer/7052112) para o formato GMC. Mapeie os campos personalizados que não fazem parte das especificações padrão para os espaços de campos personalizados do impact.com (`Numeric1`, `Text1`, e assim por diante). | Baixe o catálogo enviado pelo impact.com e compare-o com o arquivo de origem para identificar onde os dados estão sendo perdidos. Atualize os nomes ou mapeamentos dos campos conforme necessário e faça o upload novamente.                                                                                              |

## Importação por carrinho de compras integrado (recomendado)

Este método busca seu catálogo em uma plataforma de comércio eletrônico existente. A maioria dos problemas de conexão se deve a credenciais incorretas ou à falta de permissões de leitura. Encontre sua plataforma abaixo.

### Shopify (recomendado)

Se você vir um erro como *Unsuccessful HTTP status code when connecting to Shopify: 401* ou *No valid records were found in the catalog file*, geralmente a causa são os dados de autenticação ou as permissões.

* Sua senha deve ser o **token de acesso à API de administração**, que começa com `shpat_` (ou `shap_`). Você o encontrará no painel de administração da Shopify, em **Apps** **→** **Credenciais da API** **→** **token de acesso à API de administração**.
* Se você não encontrar o **token de acesso à API de administração**, selecione **Instalar app** na Shopify para gerá-lo.
* Confirme se a permissão (escopo) `read_products` foi concedida ao app. Sem ela, a Shopify retorna um erro informando que a ação exige a aprovação do lojista para o `read_products` escopo.
* Para encontrar o ID de uma coleção, acesse o painel de administração da Shopify e vá até **Produtos** **→** **Coleções**. Selecione a coleção; o ID aparece no final do URL da página.

Para ver as etapas completas de configuração, consulte o [guia de integração do catálogo de produtos da Shopify](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-shopify/shopify-product-catalog).

### Amazon (recomendado)

A integração do carrinho de compras da Amazon é exclusiva para marcas com [assinaturas de vendedor](https://help.impact.com/brand/pt-br/what-would-you-like-to-learn-about/seller-program/amazon-seller-program/amazon-seller-program-explained.md) e não é um recurso de autoatendimento. A importação automática do catálogo da Amazon é limitada a 1.000 produtos devido às restrições da API da Amazon. Se o catálogo do seu vendedor tiver mais de 1.000 produtos, use um método de envio de arquivo, como *Importar de URL*.

Para ver as etapas de configuração, consulte o [guia de integração da Amazon](https://integrations.impact.com/integration-guides/for-brands/plugin-integrations/e-commerce/integrate-with-amazon).

### BigCommerce

Para conectar o BigCommerce, são necessários dois valores e as permissões corretas, somente para leitura.

* Insira o **hash da loja** e o **token de acesso** na interface do impact.com. O hash da loja é o identificador presente no caminho da API da sua loja.
* Ao criar a conta da API no BigCommerce, defina as permissões de **Produtos** e **Informações e configurações** como somente leitura.

Para referência, consulte o guia do BigCommerce sobre [como criar tokens de API](https://developer.bigcommerce.com/docs/storefront-auth/tokens#create-a-token).

### WooCommerce

Se você vir *Não foi possível conectar ao WooCommerce. Tente novamente*, confira suas credenciais e as configurações da API.

* Seu **nome de usuário da API** é sua *chave de consumidor*, e sua **senha da API** é seu *segredo de consumidor*.
* Ative a API REST legada no WooCommerce: **WooCommerce** **→** **Configurações** **→** **Avançado** **→** **API legada**, depois marque a caixa para ativá-la.

Para referência, consulte a [documentação da API REST do WooCommerce](https://woocommerce.com/document/woocommerce-rest-api/).

### Shoplazza

Seu aplicativo privado da Shoplazza precisa de acesso de leitura aos seguintes recursos: `product`, `collection`e `shop`.

Para ver as etapas de configuração, consulte o guia da Shoplazza sobre como [criar aplicativos privados](https://www.shoplazza.dev/reference/quick-construction-of-private-apps).

## servidor FTP da impact.com

A maioria dos problemas de FTP está relacionada às configurações de conexão ou às credenciais.

| Problema                            | O que verificar                                                                      | Como corrigir                                                                                                                                                                                                                        |
| ----------------------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Não é possível conectar ao servidor | Confirme se você está se conectando ao host `products.impact.com` na porta `21`.     | Atualize seu cliente FTP com o host e a porta corretos e conecte-se novamente.                                                                                                                                                       |
| Credenciais de FTP ausentes         | Para se conectar, você precisa do login e da senha de FTP fornecidos para sua conta. | Encontre suas *credenciais do sistema de dados de produtos FTP* nas configurações técnicas da sua conta. Se não conseguir encontrá-las ou acessá-las, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml). |

## servidor SFTP da impact.com

O servidor SFTP da impact.com é um método de envio especializado, reservado para integrações específicas.

| Problema                                        | O que verificar                                                                                                                                  | Como corrigir                                                                                                                                                                                                                                        |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sua plataforma de feed não consegue se conectar | Confirme se sua plataforma está se conectando ao host `products.impact.com` na porta `22`, e se as credenciais são as fornecidas para sua conta. | Teste as mesmas credenciais em um cliente SFTP padrão, como o FileZilla ou o Cyberduck. Se o cliente se conectar, mas sua plataforma de feed continuar sem conseguir se conectar, altere o catálogo para *Buscar por URL* seguindo as etapas abaixo. |

### Mudar de envio por push para pull

A impact.com recomenda buscar seu feed em vez de enviá-lo. Quando a impact.com busca o feed diretamente no servidor SFTP da sua plataforma de feed (por exemplo, SFTPGo), ela controla quando e com que frequência seu catálogo é atualizado, e você deixa de depender do servidor SFTP da impact.com. A mudança para pull também resolve erros de conexão que sua plataforma de feed (por exemplo, Feedonomics) pode apresentar ao enviar arquivos para o servidor SFTP da impact.com.

Antes de fazer a mudança, peça à sua plataforma de feed (por exemplo, Feedonomics) que configure um local SFTP de saída para o seu feed e forneça:

* Host e porta SFTP/FTP (por exemplo, sftpgo.feedonomics.com:22)
* Nome de usuário e senha
* Caminho do arquivo (por exemplo, incoming/catalog\_feed.txt.gz)

{% hint style="warning" %}
**Aviso:** Atualize seu catálogo existente em vez de criar um novo. Um novo catálogo que use o mesmo *Nome do arquivo de upload* retorna um erro *Nome de arquivo já em uso* e seu catálogo existente talvez já seja usado por outros programas.
{% endhint %}

1. No menu de navegação à esquerda, selecione ![](https://526234278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** **→** **Conteúdo** **→** **Produtos** **→** [**Catálogos de produtos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Passe o cursor sobre seu catálogo existente e selecione **Editar**.
3. Na seção *Método de upload* selecione **Buscar por URL**.
4. Selecione o **Formato** que corresponde ao arquivo do seu feed.
5. Insira o **Nome do arquivo de upload**, exatamente como aparece no nome do arquivo, incluindo a extensão.
6. Insira o **URL de busca** no formato `sftp://[username]:[password]@[host]:22/[path/to/file]`.
   * Codifique em URL os caracteres especiais das suas credenciais. Por exemplo, `@` se torna `%40`.
7. Selecione a **Frequência de busca**, **Horário de busca**e o **Fuso horário**.
8. Selecione **Salvar**.

## Upload direto

Problemas com o upload direto geralmente ocorrem por incompatibilidade de formato ou nome de arquivo, ou porque o arquivo excede o limite de 1 GB.

| Problema                              | O que verificar                                                                                                                                                                                           | Como corrigir                                                                                                                                                             |
| ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Formato selecionado incorreto         | O formato escolhido (por exemplo, TXT) não corresponde ao arquivo enviado (por exemplo, XML).                                                                                                             | Envie o arquivo novamente e selecione o formato correspondente. Arquivos XML usam a extensão `.xml` Arquivos CSV usam `.csv`, e arquivos delimitados por TAB usam `.txt`. |
| O nome do arquivo não corresponde     | O nome do arquivo enviado precisa corresponder exatamente ao *Nome do arquivo enviado* definido nas configurações do catálogo, incluindo a extensão.                                                      | Renomeie o arquivo ou atualize o *Nome do arquivo enviado* para que os dois correspondam exatamente.                                                                      |
| O arquivo compactado não é processado | A impact.com oferece suporte a arquivos gzip e arquivos compactados no formato zip padrão. Um arquivo compactado pode usar uma segunda extensão para indicar a compactação, por exemplo `catalog.xml.gz`. | Confirme se o tipo de compactação é gzip ou zip e se o arquivo usa as extensões corretas para o formato e para a compactação.                                             |


---

# 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/pt-br/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.
