Pular para o conteúdo

Exemplo de trabalho · 24 de outubro de 2026

Três produtos, três alertas: como ler uma verificação de catálogo.

Um arquivo legível ainda pode ter informações incompletas. O perfil local v1 ajuda a encontrá-las; não determina quais dados são verdadeiros.

Neste cenário fictício, três produtos têm os identificadores A, B e A. O produto B está sem título. Todos os outros campos obrigatórios seguem o perfil. O resultado esperado é preciso: três alertas, um para cada membro do identificador duplicado A e outro para o título ausente de B.

O exemplo acompanha a versão 1 da verificação local de catálogos CSV em português. Os produtos são inventados. Não se afirma ter testado um catálogo real ou uma conexão com uma loja.

Um produto nem sempre ocupa uma única linha

O cabeçalho ocupa a linha física 1. O primeiro produto começa na linha 2; sua descrição, entre aspas, ocupa três linhas. O segundo produto começa, portanto, na linha 5, e o terceiro na linha 6. Contar apenas as quebras de linha faria perder a correspondência entre produtos e alertas.

Resultado esperado do exemplo fictício
ProdutoLinha inicialAlerta
1, identificador A2DUPLICATE_ID
2, identificador B5REQUIRED, título
3, identificador A6DUPLICATE_ID

A RFC 4180 descreve campos entre aspas, aspas duplicadas e quebras de linha dentro de uma célula. O perfil local também aceita ponto e vírgula, útil em exportações com vírgula decimal. Se os dois separadores forem plausíveis, é necessário escolher um explicitamente.

Verificar as colunas antes de avaliar os produtos

O perfil exige identificador, título, URL, preço, moeda e disponibilidade. A prévia permite associar cada campo a uma coluna. Cabeçalhos iguais são diferenciados pela posição. Um mapeamento ambíguo não é decidido silenciosamente. As colunas adicionais são identificadas como ignoradas.

Uma linha com células demais recebe um erro de estrutura. A ferramenta não deduz um preço inválido ou um título ausente a partir de campos deslocados. Os próximos produtos podem ser analisados se seus limites forem seguros, mas o relatório geral permanece incompleto. A verificação de duplicados considera então apenas os registros estruturalmente legíveis.

O alerta explica uma regra, sem inventar uma correção

O preço “15,00” é aceito. “15.00 EUR” também é aceito quando a moeda informada é EUR. “1,234.56” é recusado: o perfil não adivinha separadores de milhares. Um código de moeda fora da lista incorporada fica sem avaliação, impedindo uma conclusão global sem anomalias. Os valores técnicos de disponibilidade permanecem iguais em todos os idiomas: in_stock, out_of_stock, preorder e backorder.

A verificação não preenche nenhuma célula. Não pode escolher qual dos dois A está errado, inventar o título de B ou confirmar o estoque. Mesmo uma URL HTTP(S) com sintaxe válida pode apontar para uma página inexistente; a ferramenta não a acessa. Corrija a fonte dos dados do produto e importe uma nova exportação.

Manter os limites ao baixar o relatório

O relatório CSV separado conserva a versão do perfil, o estado da verificação, as posições e as regras. As células de texto recebem um apóstrofo de proteção. Não o remova: salvar o arquivo novamente em uma planilha pode eliminar proteções. A OWASP explica esses riscos dos arquivos CSV.

O processamento é local, sem salvamento automático. Uma nova importação invalida imediatamente o relatório anterior. Baixe-o de forma explícita antes de fechar ou limpar a página. Um resultado sem anomalias se limita às regras do perfil: não é uma certificação UCP/ACP nem uma garantia de aceitação por um marketplace.

Este exemplo precisa ser revisto se mudarem o perfil, a lista de moedas, o analisador CSV ou o formato de exportação. A lista de preparação do comerciante situa a verificação em um processo mais amplo.