Verificado em 31 de agosto de 2026: o Catálogo do Pinterest separa ingestão de distribuição. Um arquivo pode ser baixado corretamente enquanto alguns produtos falham; da mesma forma, um produto pode ser ingerido sem se qualificar para distribuição orgânica ou paga.
Prática recomendada: exporte o Diagnóstico, preserve o feed que falhou, corrija uma família de erros por vez e compare a próxima ingestão programada. Não reescreva o feed inteiro com base apenas no resumo do painel.
Comece pela camada correta do diagnóstico
O diagnóstico do Catálogo do Pinterest separa:
- Problemas de ingestão: falhas no envio, erros em linhas e avisos de metadados;
- Problemas de distribuição: produtos não qualificados para anúncios ou distribuição orgânica.
Exporte os detalhes da aba afetada. Registre catálogo, fonte de dados, data e hora da ingestão, total de produtos, linhas processadas com sucesso, avisos e falhas.
Confirme o acesso ao feed antes de investigar as linhas
Os requisitos do Pinterest para catálogos determinam que uma fonte hospedada deve permitir download direto por HTTP ou HTTPS, FTP ou SFTP, ou WebDAV compatíveis. Ela não pode exigir inclusão de IP ou chave SSH em lista de permissões nem etapas extras de navegação; URLs diretas devem usar as portas 80 ou 443.
- 100: o Pinterest não conseguiu baixar a fonte de dados. Teste a URL, as credenciais, os redirecionamentos, o status HTTP e se a resposta entrega diretamente o arquivo.
- 152: a fonte não contém o mínimo de linhas válidas. Confirme que há um cabeçalho, pelo menos uma linha de produto e acesso para o rastreador.
- 2: a ingestão terminou antecipadamente porque a fonte não mudou. Trata-se de um aviso, não necessariamente de uma falha no feed.
- 1013: a quantidade de produtos mudou significativamente. Verifique se a paginação, os filtros ou os processos que geram a exportação omitiram produtos.
Corrija os campos obrigatórios dos produtos
- 107: falta a descrição. Preencha uma descrição real do produto.
- 111: falta o campo
image_link. Forneça uma URL pública e acessível para a imagem do produto. - 112: falta a disponibilidade. Use um valor aceito, como in stock, out of stock ou preorder.
- 113: o formato do preço é inválido. Forneça um valor numérico com o código de moeda ISO 4217 correto.
- 151: falta o preço obrigatório. Adicione o preço atual real do produto.
- 1001: a imagem não foi encontrada. Confira o status HTTP, os redirecionamentos, as diferenças entre maiúsculas e minúsculas no caminho e o acesso público.
- 1007: o arquivo de imagem é inválido. Substitua-o por uma imagem compatível e atualize a URL.
Valide exatamente o arquivo exportado, não apenas os valores exibidos no CMS da loja.
Corrija identificadores, domínios e duplicidades
- 123: há IDs de itens duplicados. Cada item ou variação precisa de um ID único e estável.
- 139: os links dos itens não correspondem ao domínio verificado. Corrija o host de destino ou reivindique o site correto.
- 179: o GTIN está formatado incorretamente. O Pinterest aceita 8, 12, 13 ou 14 dígitos, sem hífens.
- 154: há tipos de produto demais. O Pinterest aceita no máximo cinco na lista.
Consulte o guia para reivindicar o site antes de alterar todos os links de produto para contornar o código 139.
Corrija os campos de preço, moeda, frete e promoção
- 125: o preço promocional é maior que o preço normal ou de tabela. Corrija os valores na fonte e as datas de vigência.
- 169: a moeda parece incomum para o local de venda. Confira as configurações de mercado e do feed.
- 180: os campos de preço contêm moedas incompatíveis. Use a moeda correta e consistente no contexto de cada item.
- 182: o preço promocional é muito menor que o preço normal. Confirme que o desconto é legítimo e não resulta de erro decimal ou de moeda.
- 131: o formato do frete é inválido. O Pinterest espera a estrutura documentada país:região:serviço:preço, incluindo todos os dois-pontos obrigatórios.
Corrija os avisos de taxonomia e metadados
- 126: a categoria de produto do Google tem poucos níveis. Informe o caminho de taxonomia aplicável mais específico.
- 157: falta a categoria de produto do Google.
- 158: a categoria de produto do Google está formatada incorretamente.
- 116: falta a condição do produto. Use um valor aceito, como new, used ou refurbished.
- 155: há mais de dez imagens adicionais. Reduza a lista.
- 115: a descrição ultrapassa 10.000 caracteres e é truncada.
Os avisos podem não impedir a ingestão, mas prejudicar a correspondência ou a qualidade da distribuição. Corrija primeiro as falhas e depois os avisos, começando pelos que afetam mais linhas.
Corrija códigos específicos do Shopify e das políticas comerciais
- 4057: os produtos do Shopify não estão ativos ou disponíveis no canal de vendas do Pinterest.
- 4058: os produtos não estão disponíveis na loja virtual hospedada pelo Shopify, como exigido.
- 4059: os produtos não estão traduzidos para o idioma padrão da fonte de dados.
- 4042: os produtos não atendem às Diretrizes para Comerciantes. Remova ou corrija o item em desacordo; mudar apenas o formato dos metadados não resolverá a falta de qualificação causada pelas políticas da plataforma.
Sempre confirme a descrição atual na referência oficial do Pinterest sobre códigos de erro, pois o Pinterest pode adicionar ou revisar códigos.
Siga um ciclo controlado de correção
- Arquive o feed com falha e o diagnóstico exportado.
- Agrupe as linhas afetadas por código de erro.
- Corrija as falhas no nível do arquivo antes dos erros em linhas específicas.
- Corrija os dados no sistema de comércio que gera o feed, não apenas uma cópia avulsa do CSV.
- Valide localmente a codificação, o delimitador, os cabeçalhos obrigatórios e algumas linhas de amostra.
- Publique a nova fonte e verifique o download direto.
- Aguarde a próxima ingestão ou acione-a, se essa opção estiver disponível.
- Compare as contagens e exporte novamente o diagnóstico.
Relacione o Catálogo aos Pins avançados e ao status de comerciante
Um catálogo não equivale à marcação de Pins avançados em cada página. As páginas de produto ainda precisam apresentar dados corretos e atuais. Consulte o guia de Pins avançados para os metadados da página e a auditoria do programa de Comerciantes Verificados quando o funcionamento do catálogo fizer parte dos critérios de qualificação.
A regra para diagnosticar o catálogo
Preserve a entrada que falhou, corrija a fonte original por família de códigos e confira os números da ingestão seguinte. Um envio de arquivo exibido em verde não prova que todos os produtos estão qualificados para distribuição.
Continue aprimorando seu sistema no Pinterest
Continue com o guia que corresponde à sua próxima etapa:
Experimente a extensão Notestopin para Chrome
Adicione notas privadas a qualquer Pin, organize-as com etiquetas e encontre depois tudo o que você salvou.
Adicionar ao Chrome