Valide seu catálogo CSV antes de importar dez mil linhas
Verifique dez linhas de catálogo: SKUs duplicados, variantes incompletas, preços mal formatados e texto corrompido. Exemplo com resultados verificáveis.
TL;DR: Para validar um CSV de catálogo, verifique primeiro como o destino o interpreta; depois revise colunas, identificadores, variantes e valores. Teste uma amostra com erros conhecidos e valide o arquivo completo antes de carregá-lo. O fato de dez linhas passarem não prova que as demais estejam corretas nem que uma atualização preserve todos os dados.
Conteúdo
Validar um CSV de catálogo começa por saber o que mudará ao importá-lo. Depois vêm as colunas, os identificadores e os valores. Uma planilha que se abre sem avisos pode conter dois produtos com o mesmo SKU ou um tamanho sem valor. Um arquivo aceito também pode atualizar o produto errado.
O teste a seguir serve para aprender a distinguir essas falhas. São dez linhas inventadas, com resultados verificáveis. Não é uma amostra de uma loja real nem um arquivo preparado para Shopify ou Frihet: é um esquema didático próprio que você terá que substituir pelo do destino.
Comece pelo destino, não pelo arquivo do fornecedor
Baixe um modelo vigente ou exporte um produto representativo da ferramenta que receberá os dados. Anote se você vai criar, atualizar ou combinar ambas as operações; o que identifica um registro; quais campos são exigidos; e o que significa deixar uma célula vazia. Mantenha essa definição junto ao arquivo de trabalho.
No Shopify, por exemplo, a sobrescrita é baseada no identificador de URL, chamado handle. Sua documentação também exige revisar as dependências entre campos de variante e opções. Nossa regra de SKU não descreve como esse importador identifica produtos. Formato de produtos do Shopify.
Se você move dados entre sistemas, separe esta revisão da conexão entre loja e gestão (em inglês). Um conector disponível não prova que ele aceita as colunas do seu fornecedor.
Defina regras que você possa verificar
No exercício, cada linha representa um item vendável. product_key agrupa suas variantes; sku deve estar presente e ser único. name é obrigatório. Uma variante precisa de option_name e option_value; ambos vazios significam que não declaramos uma opção. Se estiverem completos, sua combinação com product_key não pode se repetir.
O arquivo utiliza UTF-8, vírgulas entre campos e oito colunas na ordem mostrada. price admite números não negativos com ponto e duas casas decimais, sem separador de milhares. Em currency exigimos EUR para este teste. São condições escolhidas para este teste, não regras universais nem preços comerciais. Não há conversão de moeda nem cálculo fiscal.
Os SKUs são preservados como texto: 001 não se converte em 1. A Microsoft explica como evitar conversões automáticas ao carregar identificadores no Excel. Defina o tipo de coluna antes de transformar os dados; alterar sua aparência depois não reconstrói o original. Conservar zeros iniciais no Excel.
Dez linhas, incluindo uma que parece correta
Copie o bloco como texto para examiná-lo. A última linha tem uma coluna a menos deliberadamente. row_id é o identificador do teste; R01 está na segunda linha do arquivo, porque a primeira contém os cabeçalhos. Os nomes dos produtos em espanhol são valores fixos, iguais em todas as edições, para que os resultados sejam reproduzíveis.
row_id,product_key,sku,name,option_name,option_value,price,currencyR01,P01,001,Taza,Color,Natural,19.90,EURR02,P01,002,Taza,Color,Ink,19.90,EURR03,P02,001,Bolsa,,,29.00,EURR04,P03,,Cuaderno,,,8.50,EURR05,P04,005,Café,,,6.00,EURR06,P05,006,Vaso,,,"12,50",EURR07,P06,007,Camiseta,Size,,24.00,EURR08,P01,008,Taza,Color,Natural,19.90,EURR09,P07,009,,,,15.00,EURR10,P08,010,Bandeja,,,25.00| Linha | Resultado esperado | O que investigar |
|---|---|---|
| R01 | Bloquear: SKU e variante duplicados | Comparar com R03 e R08; esta linha também não é aprovada. |
| R02 | Passa nas regras do exercício | Manter como controle; não demonstra compatibilidade com o destino. |
| R03 | Bloquear: SKU duplicado | 001 também identifica a caneca de R01. |
| R04 | Bloquear: falta SKU | Pedir a referência; não inventá-la a partir do nome. |
| R05 | Revisar texto | Comparar Café com o original do fornecedor. |
| R06 | Bloquear: formato de preço | A vírgula decimal contradiz a regra escolhida. |
| R07 | Bloquear: variante incompleta | Há Size sem valor. |
| R08 | Bloquear: variante duplicada | P01 + Color + Natural já aparece em R01, mesmo que o SKU mude. |
| R09 | Bloquear: falta nome | Identificar o produto antes de continuar. |
| R10 | Bloquear: estrutura incompleta | Há sete campos; esperava-se também a coluna de moeda. |
O resultado é oito linhas bloqueadas, uma pendente de revisão e uma que passa. São estados de linhas, não oito erros independentes: R01 tem dois conflitos. Você pode verificar cada resultado comparando as chaves entre linhas e os campos com as regras anteriores.
Um duplicado não se resolve escolhendo a primeira linha
R01 parece completa quando lida sozinha. O conflito aparece ao percorrer todo o conjunto: compartilha SKU com uma bolsa e combinação de variante com outra caneca. Por isso, a verificação deve marcar todos os membros do grupo, não aprovar o primeiro e rejeitar o último.
Peça a quem mantém o catálogo que confirme se há uma referência equivocada, um produto repetido ou uma variante mal descrita. Guarde a decisão com o valor anterior, o novo e o seu motivo. Não exclua R08 apenas porque seu nome coincide; um catálogo real pode distinguir material, tamanho ou outras opções que esta planilha simplificada não inclui.
Para o seu lote real, compare também com as referências que já existem no destino. Um SKU único dentro do CSV ainda pode coincidir com outro produto fora do arquivo. Defina também como tratar espaços e diferenças de maiúsculas antes de normalizar: limpar um identificador pode unir referências que deveriam permanecer separadas.
Separe formato, texto e significado
R06 contém "12,50": as aspas mantêm o preço em uma única célula. Contar vírgulas manualmente daria um diagnóstico incorreto; utilize um leitor CSV. O RFC 4180 descreve essa convenção de aspas, mas não define quais colunas um catálogo precisa nem como interpretar um preço. A sintaxe CSV de R06 é válida; o valor do preço é que não atende à regra do campo.
Não faça uma substituição global de vírgulas por pontos: você mudaria tanto separadores quanto conteúdo. Identifique primeiro o campo, confirme o formato de origem e converta seu valor de forma controlada. Um vazio também não equivale a zero; registrar preço zero seria uma decisão comercial que ninguém confirmou.
R05 exige outra verificação. O texto Café está salvo com bytes UTF-8 válidos; isso não prova que o nome esteja correto. O aviso deste exercício está preparado para esse valor concreto, não é um detector universal de codificação. Compare o nome com a fonte e revise em qual etapa ele foi deformado. Voltar a salvar texto já danificado como UTF-8 não recupera automaticamente seus caracteres.
Antes de atualizar, verifique o que é preservado
Uma coluna ausente e uma célula vazia podem produzir mudanças distintas. O Shopify documenta que, ao sobrescrever, um campo opcional presente, mas vazio, pode apagar o valor existente; omitir sua coluna pode preservá-lo. Também adverte que uma importação iniciada não pode ser cancelada e recomenda uma cópia prévia. Condições de importação do Shopify.
A identidade de uma variante também pode mudar: o Shopify adverte que modificar valores de opções elimina seus identificadores anteriores e cria outros novos. Revise as conexões que dependam deles antes de corrigir uma opção via CSV. Opções e identificadores de variantes.
Prepare uma comparação entre estado anterior, mudança prevista e resultado observado. Inclua os campos que devem permanecer iguais. Teste em um ambiente de teste disponível e mantenha juntas as linhas relacionadas de um produto; dez linhas consecutivas nem sempre representam dez produtos completos.
Em uma operação real, você escolheria casos distintos: produto simples, várias opções, caracteres acentuados, preço vazio e atualização de uma referência existente. Essa amostra testa o percurso. Depois aplique as regras ao arquivo completo: os duplicados podem estar separados por milhares de linhas. Consulte as integrações para identificar as ferramentas do seu fluxo, e confirme as regras de dados de cada uma.
Registre uma decisão que outra pessoa possa revisar
Antes de carregar, anote a versão do arquivo, destino, responsável, regras aplicadas, problemas resolvidos e comparação do teste. Se faltar uma confirmação, mantenha o lote pendente; uma mensagem de “importado” não substitui essa revisão.
Frihet admite importação CSV de produtos, dentro de suas funções de gestão. O esquema e as verificações manuais deste artigo são independentes: não testam campos admitidos nem validações automáticas da Frihet. Use o modelo do seu importador e comece esclarecendo as linhas cujo resultado você ainda não consegue explicar.
Este artigo foi útil?
Perguntas frequentes
Estas verificações substituem as regras do importador?
Não: o esquema e as verificações manuais são um exercício independente. Use o modelo atual do sistema de destino e verifique suas regras para criação, atualização e campos vazios.
Validar dez linhas garante que o restante do catálogo está correto?
Não. A amostra serve para testar o fluxo; depois, aplique as regras ao arquivo completo e compare com as referências existentes no destino, pois pode haver duplicatas fora da amostra.
