Verificado em 27 de agosto de 2026: Os Catálogos do Pinterest separam a ingestão da distribuição. Um arquivo pode ser baixado com sucesso enquanto produtos individuais falham, e um produto pode ser ingerido com sucesso enquanto permanece inelegível para distribuição orgânica ou paga.
Melhor prática: exportar Diagnósticos, preservar o feed com falha, corrigir uma família de erros de cada vez e comparar a próxima ingestão programada. Não reescreva todo o feed a partir de um resumo do painel.
Comece com a camada de diagnóstico correta
Diagnósticos de catálogo do Pinterest separa:
- Problemas de ingestão: uploads com falha, falhas de linha e avisos de metadados;
- Problemas de distribuição: produtos inelegíveis para anúncios ou posicionamento orgânico.
Exporte os detalhes da guia afetada. Registre o catálogo, a fonte de dados, o carimbo de data/hora de ingestão, o total de produtos, linhas bem-sucedidas, avisos e falhas.
Confirme o acesso ao feed antes de depurar linhas
Requisitos do catálogo do Pinterest diga que uma fonte hospedada deve ser diretamente baixável via HTTP/HTTPS, FTP/SFTP ou acesso WebDAV suportado. Não pode exigir lista branca de IP/chave SSH ou navegação extra; as portas de URL diretas devem ser 80 ou 443.
- 100: O Pinterest não pôde baixar a fonte de dados. Teste a URL, credenciais, redirecionamentos, status e uma resposta direta do arquivo.
- 152: a fonte não possui o mínimo de linhas válidas. Confirme um cabeçalho mais pelo menos uma linha de produto e acesso do rastreador.
- 2: a ingestão terminou cedo porque a fonte não mudou. Isto é um aviso, não necessariamente um feed com falha.
- 1013: A contagem de produtos mudou significativamente. Verifique se a paginação de exportação, os filtros ou os trabalhos a montante não omitiram produtos.
Corrigir campos obrigatórios do produto
- 107: descrição ausente. Preencha uma descrição real do produto.
- 111: faltando
link_da_imagem. Forneça um URL de imagem do produto acessível. - 112: disponibilidade ausente. Use os valores suportados, como em estoque, fora de estoque ou pré-venda.
- 113: formato de preço inválido. Forneça um preço numérico com o código de moeda correto ISO-4217.
- 151: preço obrigatório ausente. Adicione o preço atual real do produto.
- 1001: imagem não encontrada. Confirme o status, redirecionamentos, caminho sensível a maiúsculas e minúsculas e disponibilidade pública.
- 1007: arquivo de imagem inválido. Substitua-o por uma imagem válida suportada e atualize o URL.
Valide o arquivo exportado exato, não apenas os valores dos produtos dentro do CMS de comércio.
Corrigir identificadores, domínios e duplicatas
- 123: IDs de itens duplicados. Cada item/variante distinto precisa de um ID único estável.
- 139: os links do item não correspondem ao domínio verificado. Corrija o host de destino ou reivindique o site correto.
- 179: GTIN está formatado incorretamente. A documentação do Pinterest indica que comprimentos válidos de dígitos são 8, 12, 13 ou 14, sem traços.
- 154: muitos tipos de produto. O Pinterest suporta até cinco na lista.
Use o guia de reivindicação de site antes de alterar cada link de produto para contornar o código 139.
Corrigir campos de preço, moeda, envio e venda
- 125: O preço de venda excede o preço regular/de tabela. Corrija os valores de origem e as datas de validade.
- 169: A moeda parece incomum para o local de venda. Verifique a configuração do mercado e do feed.
- 180: os campos relacionados a preço contêm moedas inconsistentes. Use uma moeda correta por contexto de item.
- 182: o preço de venda é muito mais baixo do que o preço normal. Confirme se é legítimo e não um erro de decimal ou de moeda.
- 131: o formato de envio é inválido. O Pinterest espera a estrutura documentada país:região:serviço:preço com os dois-pontos obrigatórios.
Corrigir avisos de taxonomia e metadados
- 126: A categoria de produto do Google tem poucos níveis; forneça o caminho taxonômico mais específico aplicável.
- 157: A categoria de produto do Google está ausente.
- 158: A categoria de produto do Google está formatada incorretamente.
- 116: condição faltando; use um valor suportado, como novo, usado ou recondicionado.
- 155: mais de 10 imagens adicionais; limite a lista.
- 115: a descrição excede 10.000 caracteres e foi truncada.
Avisos podem permitir a ingestão, mas reduzem a correspondência ou a qualidade da distribuição. Corrija primeiro as falhas e depois os avisos pelo volume de linhas afetadas.
Corrigir códigos da Shopify e códigos específicos de políticas
- 4057: Os produtos da Shopify não estão ativos/disponíveis para o canal de vendas do Pinterest.
- 4058: os produtos não possuem a disponibilidade necessária de loja online hospedada pela Shopify.
- 4059: os produtos não são traduzidos para o idioma padrão da fonte de dados.
- 4042: os produtos não atendem às Diretrizes do Comerciante. Remova ou corrija o item não conforme; apenas a formatação de metadados não resolverá a inelegibilidade de política.
Sempre confirme a redação atual em Referência oficial de códigos de erro do Pinterest, que pode adicionar ou revisar códigos.
Use um ciclo de remediação controlado
- Arquive o feed com falha e os diagnósticos exportados.
- Agrupe as linhas afetadas pelo código de erro.
- Corrija falhas em nível de arquivo antes de erros em nível de linha.
- Corrija os dados de comércio a montante, não apenas uma cópia única em CSV.
- Validar codificação, delimitador, cabeçalhos obrigatórios e linhas de amostra localmente.
- Publique a nova fonte e verifique o download direto.
- Aguarde ou acione a próxima ingestão suportada.
- Compare as contagens e exporte os diagnósticos novamente.
Conecte Catálogos aos Pins Ricos e ao status de comerciante
Um catálogo não é o mesmo que marcação de Rich Pin em nível de página. As páginas de produtos ainda devem expor dados precisos e atualizados. Use o Guia do Pin Rico para metadados da página e o Auditoria de Comerciante Verificado quando o sucesso do catálogo faz parte da elegibilidade.
A regra do catálogo
Mantenha a entrada com falha, corrija a fonte upstream por família de código e verifique a próxima ingestão quantitativamente. Um upload de arquivo verde não prova que todo produto é elegível para distribuição.
Continue construindo seu sistema do Pinterest
Continue com o guia que corresponde ao seu próximo passo:
Obtenha a extensão Notestopin do Chrome
Adicione notas privadas a qualquer Pin, marque-os e pesquise seus salvamentos mais tarde.
Adicionar ao Chrome