«Temos tudo num Excel.» É um bom ponto de partida, mas não significa que os dados possam ser importados sem preparação. Uma folha de cálculo pode estar organizada para quem a utiliza e, ainda assim, criar problemas ao transformar linhas e colunas em produtos WooCommerce, projetos, documentos ou outros conteúdos WordPress.
A diferença está na estrutura: uma pessoa interpreta contexto, formatação e informação implícita; um importador precisa de regras e valores identificáveis. Preparar o ficheiro é, por isso, tão importante como escolher a ferramenta de importação.
Primeiro, definir o que representa cada linha
Antes de olhar para o formato do ficheiro, é necessário perceber que registos se pretendem criar ou atualizar. Numa estrutura simples, cada linha corresponde a um registo e cada coluna a um atributo desse registo.
| Conteúdo a importar | Identificador | Exemplos de campos |
|---|---|---|
| Produto | SKU A001 | Nome, preço, categoria |
| Projeto | Código P001 | Título, ano, cliente |
| Documento | Código D001 | Título, tipo, ficheiro |
O problema surge quando uma linha mistura várias entidades: um projeto, os dados do cliente, dois documentos e um contacto. Alguns desses elementos podem ser campos do projeto; outros podem precisar de registos próprios, ligados por identificadores.
Não existe uma única estrutura correta para todos os websites. O modelo de dados deve ser definido em função do destino, incluindo campos personalizados, categorias e relações entre conteúdos. Em certos casos, várias folhas relacionadas são mais úteis do que uma tabela gigantesca.
Uma folha legível nem sempre contém dados explícitos
No Excel, é habitual recorrer a células unidas, cores, negritos e agrupamentos para facilitar a leitura. Essa organização visual nem sempre é interpretada por um importador, sobretudo depois de exportar para CSV.
| Como aparece na folha | Como preparar para importar |
|---|---|
2026 / Lisboa / Industrial na coluna «Informação» | Separar em «Ano», «Local» e «Setor» |
| «Construção» escrita uma vez para três produtos | Repetir «Construção» no campo de categoria de cada produto |
| Fundo amarelo significa «Por rever» | Criar um campo «Estado» com o valor «Por rever» |
| Colunas «Nome», «Nome 2» e «Outros» | Usar cabeçalhos que identifiquem claramente cada campo |
Cada coluna deve ter um significado consistente. É possível guardar vários valores na mesma célula, mas apenas quando existe uma convenção definida que a ferramenta consegue interpretar.
Também convém eliminar espaços adicionais, quebras de linha indevidas e caracteres invisíveis em campos usados para identificar ou relacionar registos. «Industrial» e «Industrial » podem parecer iguais e ser tratados de forma diferente.
Identificadores, duplicados e categorias precisam de regras
Um nome não é um identificador fiável: pode mudar ou repetir-se. Num catálogo, o produto «Cadeira de Escritório Preta» pode passar a chamar-se «Cadeira Ergonómica Preta» sem deixar de ser o mesmo artigo. Se conservar o SKU CAD-001, continua a existir uma referência estável para o reconhecer.
O importador CSV do WooCommerce utiliza, nomeadamente, IDs e SKUs para associar linhas a produtos existentes durante uma atualização. Noutros conteúdos WordPress, pode ser necessário criar um código externo e configurar a correspondência através da ferramenta escolhida. Os IDs internos do WordPress, por si só, não são necessariamente transferíveis entre websites.
Os duplicados exigem atenção semelhante. ABC123, ABC-123 e abc123 podem representar o mesmo produto, mas também podem ser referências distintas. Não se deve eliminar ou fundir registos apenas porque os valores são parecidos: primeiro definem-se regras de normalização e analisam-se os conflitos.
O mesmo se aplica às categorias. «Industrial», «Indústria» e «Ind.» não devem ser automaticamente tratadas como equivalentes. Uma lista de designações aprovadas evita categorias repetidas por diferenças de escrita. Para campos com múltiplos valores, é necessário definir separadores e hierarquias: no CSV nativo do WooCommerce, por exemplo, as categorias podem ser separadas por vírgulas e os níveis hierárquicos por >.
Datas, preços, códigos e fórmulas podem ser alterados na conversão
Nem tudo o que parece um número deve ser tratado como quantidade. E o formato apresentado no Excel nem sempre corresponde ao valor que será exportado.
| Tipo de dado | Risco | Preparação recomendada |
|---|---|---|
| Data | 04/05/2026 pode ser interpretado de duas formas | Usar um formato inequívoco, como 2026-05-04, se compatível com o importador |
| Preço | 1.250,50 € pode não ser aceite como valor numérico | Adaptar ao formato exigido, por exemplo 1250.50 |
| SKU ou referência | 00123 pode passar a 123 | Tratar o identificador como texto desde a origem |
| Código numérico longo | O Excel pode alterar algarismos depois do 15.º | Preservar o valor como texto, sem conversão numérica |
| Fórmula | Resultado desatualizado ou erro como #REF! | Validar o cálculo e decidir que valor será importado |
Um cuidado importante: formatar uma célula como texto depois de o Excel ter eliminado zeros ou alterado dígitos não recupera automaticamente o valor original. A proteção tem de começar na entrada ou leitura dos dados.
No caso das fórmulas, importa decidir se o WordPress recebe apenas o resultado ou se o cálculo deve continuar noutro sistema. Se os preços forem recalculados regularmente num ficheiro, o projeto pode exigir uma integração recorrente, e não uma importação única.
Imagens, variações e traduções exigem relações explícitas
Imagens e documentos
Uma imagem colada numa célula pode ser útil para apresentar um catálogo, mas não fornece automaticamente ao importador um ficheiro associável ao produto. A folha deve indicar uma referência identificável, como um nome de ficheiro existente na biblioteca multimédia ou um URL direto e acessível, conforme a ferramenta utilizada.
No CSV nativo do WooCommerce, a coluna Images pode incluir várias imagens, sendo a primeira utilizada como imagem principal. Antes de importar, é necessário confirmar a acessibilidade dos ficheiros e a sua associação aos produtos. O mesmo princípio aplica-se a PDFs, fichas técnicas e outros documentos ligados a projetos ou artigos.
Variações, relações e traduções
Uma T-shirt com tamanhos S, M e L não corresponde simplesmente a três nomes numa célula. No WooCommerce, é necessário representar o produto principal, os atributos e as variações, com referências que permitam associá-las. Por exemplo, uma variação com SKU TSH-001-M pode apontar para o produto principal TSH-001 através do campo Parent, respeitando o formato de importação utilizado.
Relações entre projetos e documentos, ou entre produtos relacionados, precisam igualmente de referências válidas. Se os registos associados ainda não existirem, a ordem da importação ou um processamento posterior pode ser determinante.
Num website multilingue, identificar o idioma também não chega. As versões portuguesa e inglesa de um conteúdo têm de ficar ligadas como traduções. Ferramentas como o WPML disponibilizam processos próprios para estabelecer essas relações durante a importação.
CSV ou XLSX: o formato não resolve dados mal preparados
O CSV é muito utilizado porque representa dados tabulares de forma simples, sem depender das cores, células unidas ou outros elementos visuais do Excel. O WooCommerce inclui um importador CSV de produtos, com correspondência entre colunas do ficheiro e campos da loja.
Já o WordPress não dispõe, de origem, de um importador genérico capaz de converter qualquer ficheiro Excel em projetos, utilizadores ou conteúdos com campos personalizados. Para esses casos, podem ser necessários plugins, mapeamentos específicos ou um processo de importação desenvolvido à medida. Alguns aceitam .xlsx diretamente; outros trabalham com CSV ou XML.
Ao exportar do Excel, há ainda três cuidados importantes:
- Folhas:
- a gravação em CSV conserva apenas a folha ativa; se os dados estiverem distribuídos por várias folhas, é preciso preparar a exportação de cada uma e manter as relações.
- Codificação e separadores:
- confirmar UTF-8, caracteres portugueses, delimitadores e utilização correta de aspas quando os valores contêm separadores.
- Campos:
- verificar se os cabeçalhos e valores correspondem ao formato esperado, incluindo campos obrigatórios, categorias, imagens e atributos.
A documentação oficial do importador CSV do WooCommerce descreve essas convenções e permite consultar os campos suportados. Na importação, é possível rever a correspondência entre colunas e campos, mas um mapeamento correto não corrige categorias incoerentes, identificadores errados ou relações em falta.
Como preparar e validar a importação
Uma importação segura começa por definir regras e só termina depois de confirmar os resultados. A sequência recomendada é:
- Definir os campos e as relações. Identificar o tipo de registo, os campos obrigatórios, as categorias, as chaves estáveis e a forma de criar ou atualizar conteúdos existentes.
- Limpar e validar os dados. Rever duplicados, valores vazios, datas, preços, fórmulas, caracteres especiais e referências a imagens ou outros registos.
- Guardar uma versão de importação. Separá-la do ficheiro que a equipa continua a editar, identificando a origem, a data e a versão utilizada.
- Testar uma amostra representativa. Incluir registos simples e casos mais complexos, como várias categorias, imagens, variações, traduções ou valores em falta. Quando possível, testar num ambiente de testes e assegurar uma cópia de segurança antes de alterar dados existentes.
- Confirmar os resultados antes de avançar. Verificar registos criados e atualizados, erros, campos, relações e apresentação no website. Em volumes elevados, executar por lotes pode facilitar o controlo e a correção de problemas.
Lista de verificação final
Antes da importação completa, confirme:
- Cada linha e cada coluna têm um significado definido.
- Existem identificadores estáveis e os duplicados foram analisados.
- Os campos obrigatórios estão preenchidos ou têm tratamento previsto.
- Categorias, valores múltiplos e espaços indevidos estão normalizados.
- Datas, preços, códigos e fórmulas foram validados.
- Imagens e documentos têm referências utilizáveis.
- Variações, conteúdos relacionados e traduções têm ligações definidas.
- O formato, as folhas exportadas e a codificação são compatíveis com o importador.
- Existe uma versão identificada do ficheiro e uma forma segura de recuperar os dados afetados.
- A amostra foi verificada no resultado final, não apenas no relatório de importação.
Conclusão
Um Excel pode estar bem organizado para a equipa e continuar inadequado para uma importação automática. O trabalho decisivo está em transformar informação implícita em dados consistentes, identificáveis e relacionados. Só depois faz sentido escolher o importador e executar o processo. Assim, reduz-se o risco de criar milhares de registos aparentemente válidos, mas com erros difíceis de corrigir mais tarde.
