> 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-errors-and-warnings.md).
# Resolver erros e avisos de catálogos de produtos
Cada catálogo de produtos tem uma pontuação de saúde que mostra quaisquer problemas no seu catálogo. Use este guia para resolver os erros e avisos que a impact.com relata depois de processar seu catálogo e para corrigir problemas de visibilidade do parceiro, para que seu catálogo permaneça na *Excelente* faixa.
Se a impact.com não conseguir receber o arquivo do seu catálogo, consulte [Solucionar problemas de uploads e conexões de catálogo de produtos](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/solucionar-problemas-de-envio-e-conexao-de-catalogo-de-produtos.md).
{% hint style="info" %}
**Dica:** Um catálogo saudável é mais do que apenas eliminar erros. Siga as [Melhores práticas de catálogo de produtos](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/product-catalog-best-practices.md) para manter seus dados completos, bem estruturados e configurados para uma forte visibilidade e desempenho.
{% endhint %}
{% embed url="" %}
## Pontuações de saúde do catálogo
1. No menu de navegação à esquerda, selecione  **\[Engajar]** **→** **Conteúdo** **→** **Produtos** **→** [**Catálogos de produtos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml).
2. Se um catálogo tiver erros, avisos ou itens de linha duplicados, a *Saúde* coluna mostra quantos de cada tipo estão presentes.
* Os métodos de upload automatizados atualizam seu catálogo na próxima busca agendada.
Cada catálogo mostra um dos seguintes indicadores de saúde na *Saúde* coluna:
* *Pendente*: Seu catálogo de produtos está aguardando o primeiro upload ou a primeira busca de dados.
* *Processando*: Seu catálogo de produtos está sendo processado.
* *Excelente*: Indica um catálogo saudável. Este conjunto de dados de produtos está completo e bem estruturado, o que lhe dá a melhor chance de desempenho eficaz.
* *Bom*: Indica que alguns campos sugeridos que contêm dados cruciais, como categoria ou descrição, podem estar ausentes. Corrigir essas lacunas melhora a qualidade geral do seu catálogo.
* *Ruim*: Indica que informações obrigatórias estão ausentes em mais de 10% dos registros que você forneceu. Este catálogo precisa ser corrigido e reenviado.
## Solucionar erros e avisos após o upload
Assim que um arquivo é recebido, a impact.com valida cada registro. Erros impedem que os registros sejam processados, enquanto avisos sinalizam dados que foram aceitos, mas podem causar problemas. Use as seções abaixo para interpretá-los e resolvê-los.
### Ver erros e avisos
1. Na *Saúde* coluna, selecione o link de **erros**, **avisos**, ou **duplicados** .
* Você será redirecionado para uma página com mais detalhes. Apenas o primeiro item em um conjunto de duplicados é representado na impact.com; todos os itens duplicados do primeiro são ignorados.
2. Opcionalmente, use o *campo de pesquisa* e os filtros no topo da página para classificar os problemas.
3. Revise os problemas e faça as alterações necessárias, depois envie novamente seu catálogo de produtos.
Use os seguintes filtros na página de detalhes para restringir os problemas:
* *Tipo de erro*: Filtrar especificamente por *Erros*, *Avisos*, *Duplicados*, ou *Todos* problemas.
* *Obrigatório*: Filtrar por qualquer campo obrigatório específico ausente do catálogo de produtos, ou *Todos* campos.
* *Sugerido*: Filtrar por qualquer campo recomendado específico ausente do catálogo de produtos, ou *Todos* campos.
* *Inválido*: Filtrar por qualquer erro específico baseado em validação, como um SKU duplicado, um Código de Categoria do Google inválido ou outros erros.
### Mensagens comuns de erro e aviso
Encontre a mensagem exibida pelo seu catálogo, seja na *Status do upload* coluna ou na página de detalhes que você abrir a partir da *Saúde* coluna. Use a explicação para resolvê-la.
| Mensagem | Explicação |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| *Registro 'X': Campo(s) obrigatório(s) ausente(s): (nome do campo)* | A linha especificada está sem um ou mais campos obrigatórios. |
| *Registro 'X': CatalogItemId(CatalogItemId): Campo(s) obrigatório(s) ausente(s): (nome do campo)* | Uma linha no arquivo de dados está sem um campo obrigatório. |
| *Nenhum catálogo encontrado para a solicitação. Verifique se o nome do arquivo enviado é o mesmo registrado no catálogo* | O *Nome do arquivo de upload* definido na seção *Método de upload* ao criar o catálogo não corresponde exatamente ao nome do arquivo que você enviou. |
| *Nenhum atributo presente no arquivo do catálogo* | O arquivo de dados do catálogo de produtos não tem dados processáveis. |
| *Item do catálogo com ID ocorre mais de uma vez no catálogo, e os que vêm depois do primeiro serão ignorados* | Dois ou mais itens têm o mesmo ID. Todos os produtos exigem um valor exclusivo, e itens duplicados não são processados. |
| *Registro 'X' tem um erro: (linha X) caractere inválido entre o token encapsulado e o delimitador* | Uma linha contém uso inválido de aspas duplas. Envolva o campo entre aspas duplas e substitua todas as outras aspas duplas por duas aspas duplas. |
| *(Linha inicial X) EOF alcançado antes de o token encapsulado terminar* | EOF significa "fim do arquivo". A linha inicial mencionada tem uma aspa dupla de abertura sem uma aspa dupla de fechamento, ou uma quebra de linha inesperada interrompeu o fluxo de dados. |
| *Erro ao analisar o campo (tipo de catálogo): com valor: (campo)* | O campo do produto é inválido e não pode ser aceito. |
| *O registro (recordNumber) tem um erro: o número de valores delimitados (FieldsLength) não corresponde ao esperado (ColumnNamesLength)* | Para uma determinada linha, existem dados em uma coluna que não tem cabeçalho. |
| *Nenhum registro válido foi encontrado no arquivo do catálogo. Verifique o conteúdo do arquivo em relação ao formato do catálogo configurado e envie-o novamente.* | A impact.com leu o arquivo, mas ele não contém nenhum registro de produto. Verifique se o arquivo inclui seus produtos e corresponde ao formato de catálogo selecionado e, em seguida, envie-o novamente. |
| *Mais de 10% dos registros no arquivo apresentaram erros, então o catálogo não foi atualizado. Revise e corrija os registros e reenvie o arquivo.* | Há muitos registros com erros para que o catálogo seja atualizado. Isso inclui arquivos em que todos os registros têm erros. Consulte [*Entenda o limite de erro de 10%*](#understand-the-10-error-threshold) abaixo. |
| *O arquivo de catálogo não é um XML válido e não pôde ser lido. Certifique-se de que o arquivo esteja bem formado em XML e reenvie-o.* | O arquivo XML está vazio, foi truncado ou tem tags não fechadas, então a impact.com não pode lê-lo. Corrija o XML para que fique bem formado e envie novamente. |
| *O arquivo não parece ser um formato válido de feed RSS ou Atom. Verifique se o arquivo corresponde ao formato de catálogo configurado e envie-o novamente.* | O arquivo não é um feed RSS ou Atom, por exemplo, quando uma página de erro da web é salva no lugar do seu feed. Um arquivo de catálogo XML deve conter `rss`, `RDF`, ou `feed` em seu elemento inicial. |
| *Não foi possível ler o conteúdo do arquivo do seu catálogo...* | A impact.com não consegue ler o conteúdo do arquivo. Causas comuns são um arquivo vazio, uma estrutura de arquivo inesperada, delimitadores inválidos ou uma codificação de caractere incorreta. Verifique se o arquivo corresponde ao formato de catálogo selecionado e, em seguida, envie-o novamente. Se o problema persistir, [entre em contato com o suporte](https://app.impact.com/support/portal.ihtml). |
| *Não foi possível recuperar o arquivo do catálogo a partir da URL de pull configurada. Verifique a URL e se o arquivo está acessível.* | A impact.com não consegue baixar o arquivo da *URL de pull* nas configurações do seu catálogo. Consulte [*Pull From URL*](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/solucionar-problemas-de-envio-e-conexao-de-catalogo-de-produtos.md#pull-from-url-recommended) em Solucionar problemas de uploads e conexões de catálogo de produtos para solucionar a URL. |
| *O processamento falhou devido a um erro interno do sistema...* | Nenhuma ação é necessária da sua parte. O último catálogo processado com sucesso continua disponível para os parceiros. Consulte a [página de status da impact.com](https://status.impact.com/) para detalhes sobre interrupções de serviço. |
| *O campo (nome do campo) com valor (valor do campo) não tem um protocolo válido* | O valor do campo não é uma URL formatada corretamente. |
### Avisos de formatação e delimitadores
Em arquivos delimitados (CSV e TSV), um delimitador ou quebra de linha fora de lugar pode dividir seus dados no lugar errado e impedir que os registros sejam processados corretamente. Use a tabela abaixo para resolver esses avisos.
| Problema | Como corrigir |
| -------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Problemas de delimitador: uma vírgula, tabulação ou linha em branco incorreta quebra o limite entre os campos. | Corrija o uso de delimitadores no arquivo do catálogo para que cada campo seja separado de forma consistente e, em seguida, reenvie-o. |
| Novas linhas em um campo de descrição interrompem o processamento do registro. | Novas linhas não são compatíveis com formatos de texto delimitado (CSV e TSV). Remova as quebras de linha de campos de texto, como descrições, antes de fazer o upload. |
{% hint style="info" %}
**Formato do eBay Commerce Merchant Center:** Em um `.csv` arquivo, substitua os espaços nos valores da coluna de campo (categorias) por sublinhados. Por exemplo, use `Item_Title` em vez de `Item Title`.
{% endhint %}
### Erros de formato do Google Merchant Center
Se você usar o formato do Google Merchant Center (GMC), a maioria dos problemas surge na `seção de Categoria` do formato, nos valores de campo predefinidos ou na estrutura XML.
#### Categoria de produto do Google ausente
Quando você seleciona *erros* na *Catálogos de produtos* tela, você pode ver *Categoria de produto do Google ausente* na *Sugestões* coluna. Isso significa que nenhum Código de Categoria do Google nem a string completa da categoria do Google foi incluído no seu catálogo.
Para resolver isso, consulte sua [conta do Google Merchant Center](https://merchants.google.com/). O Google sugere categorias automaticamente para itens; use essas sugestões ao enviar o catálogo corrigido.
#### Incompatibilidade na categoria de produto do Google
Quando você seleciona *erros* na *Catálogos de produtos* tela, você pode ver *Incompatibilidade na categoria de produto do Google* na *Inválido* coluna. Isso significa que a categoria usada para os itens no seu catálogo não corresponde ao esperado [código de taxonomia](https://www.google.com/basepages/producttype/taxonomy-with-ids.en-US.txt) (por exemplo, 7386) ou ao formato de categoria completo fornecido pelo Google, por exemplo:
`Animais e Produtos para Animais > Produtos para Animais > Produtos para Pássaros > Acessórios para Gaiolas de Pássaros > Comedouros e Bebedouros para Gaiolas de Pássaros`
Para resolver isso, corrija o formato em que as Categorias de Produto do Google estão listadas e, em seguida, reenvie seu catálogo.
#### Valor de disponibilidade não aceito
Um erro como *Não foi possível analisar o campo: disponibilidade com valor* significa que um campo predefinido está usando um valor que o GMC não reconhece. Para catálogos GMC, categorias e valores devem ser exatos.
* Use `disponibilidade` para o campo de disponibilidade.
* Os valores de disponibilidade compatíveis são `em estoque`, `fora de estoque`, `pré-venda`, e `sob encomenda`.
* Verifique símbolos especiais que podem afetar a formatação, como um símbolo de moeda aparecendo em um campo de valor.
#### Erros de estrutura XML
Se você enviar um catálogo do Google Merchant Center (formato XML) e vir *O arquivo não parece ser um formato válido de feed RSS ou Atom*, a estrutura XML provavelmente está incorreta.
O arquivo XML deve conter `rss`, `RDF`, ou `feed` em seu elemento inicial. Corrija o elemento raiz e reenvie.
Se você vir *O arquivo de catálogo não é um XML válido e não pôde ser lido*, o arquivo está vazio, truncado ou tem tags não fechadas. Corrija o XML para que fique bem formado e reenvie.
### Entenda o limite de erro de 10%
Se mais de 10% dos registros em um arquivo enviado contiverem erros, o arquivo não será processado. Quando isso acontecer:
* Seu catálogo continua mostrando a versão do último upload bem-sucedido, portanto, um *carimbo de data/hora da última submissão bem-sucedida* mais antigo é esperado.
* O **Ver produtos** opção só aparece se um arquivo tiver sido enviado com sucesso anteriormente para esse ID de catálogo.
Corrija os registros sinalizados para que menos de 10% contenham erros e, em seguida, envie novamente.
## Solucionar problemas de visibilidade do parceiro e de links de rastreamento
Um catálogo saudável ainda não chegará aos seus parceiros até que você [o disponibilize](#partners-cant-see-the-catalog) e cumpra os [requisitos de visibilidade do parceiro](#partners-cant-see-or-search-specific-products). Use esta seção se seu catálogo foi processado com sucesso, mas os parceiros estiverem enfrentando problemas de visibilidade, acesso ao produto ou links de rastreamento.
### Os parceiros não conseguem ver o catálogo
Verifique as duas configurações a seguir:
* Certifique-se de que o catálogo esteja disponível para uso:
1. Selecione  **\[Engajar]** **→** **Conteúdo** **→** **Produtos** **→** [**Catálogos de produtos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) e encontre o catálogo.
2. Selecione  **\[Mais]** e então escolha **Tornar disponível para uso**.
* Verifique se o acesso do parceiro está restrito:
1. Selecione  **\[Engajar]** **→** **Conteúdo** **→** **Produtos** **→** [**Catálogos de produtos**](https://app.impact.com/secure/advertiser/engage/ads/productcatalogs/manage-ads-product-catalog-flow.ihtml) e encontre o catálogo.
2. Passe o mouse sobre o catálogo e, em seguida, selecione **Editar**.
3. Na *Restringir acesso de parceiros* seção, verifique se **Permitir acesso apenas a Parceiros específicos** está  ativado.
4. Se estiver, .svg?alt=media\&token=a85366cd-4b70-41a6-83df-319f89597ede) desative-o e selecione **Salvar**.
{% hint style="success" %}
**Observação:** O **Tornar disponível para uso** opção só aparece para catálogos com *Excelente* ou *Bom* saúde que estão *Inativo* ou *Pendente de ativação*.
{% endhint %}
### Os parceiros não conseguem ver ou pesquisar produtos específicos
Para que um produto seja visível na interface do parceiro, ele deve atender a todos os seguintes requisitos:
* O preço original é maior que US$ 2,00.
* A Disponibilidade de estoque do produto não é *Fora de estoque.*
* O produto tem uma URL válida que leva a uma página de detalhes do produto ativa.
* O produto tem uma URL de imagem.
* O produto está em um catálogo sem [regras](/brand/pt-br/what-would-you-like-to-learn-about/platform-features/product-catalogs/create-and-manage-product-catalog-rules.md) aplicadas.
### Os links de rastreamento do parceiro retornam um erro de "formatado incorretamente"
Se os parceiros virem "O link em que você clicou está formatado incorretamente" ao usar links de rastreamento dos seus produtos, o deep linking geralmente não está habilitado ou o domínio da página de destino do produto não está definido como um domínio permitido. Para habilitar o deep linking, defina seus domínios permitidos e resolver esse erro, consulte [Configurar domínios permitidos para deep linking](/brand/pt-br/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 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-errors-and-warnings.md?ask=&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.
