Como importar um arquivo CSV ou Excel no PrestaShop
A importação nativa do PrestaShop funciona, desde que o arquivo esteja perfeito. Veja o método passo a passo, os erros que mais travam a importação e outro caminho: o ListoMax lê o seu CSV ou Excel e publica cada linha pelo WebService. E para um produto com várias cores, o recurso Série publica 12 fichas de produtos em menos de 2 minutos.
Pela equipe ListoMax · Atualizado em
Como importar CSV no PrestaShop 8 ou 9?
Pela ferramenta de importação do painel administrativo: você envia o arquivo, associa as colunas e inicia a importação. Antes de tudo, reserve tempo para preparar bem o arquivo.
Abra a ferramenta de importação
Na lista de produtos do catálogo, o botão de importação leva à página Importar, que também fica em Parâmetros Avançados.
Escolha o tipo de dados
Selecione Produtos, envie o arquivo e informe o idioma, o separador de campos e o separador de valores múltiplos.
Associe as colunas
Cada coluna do arquivo é ligada a um campo do PrestaShop: nome, referência, preço, categorias, endereços das imagens. Uma coluna mal associada desloca a ficha inteira.
Importe e confira
Depois, verifique os produtos no catálogo: categorias, preços, imagens, visibilidade.
E no PrestaShop 1.7?
O princípio é o mesmo no PrestaShop 1.7, 8 e 9: arquivo, separadores, associação das colunas. Só as telas mudam um pouco. Antes de uma importação grande, faça um teste com poucas linhas.
Dá para importar uma planilha Excel no PrestaShop?
Sim, a ferramenta de importação aceita planilhas Excel além do CSV. Na prática, muitos lojistas ainda preferem o CSV, que é mais previsível.
Várias abas, células mescladas, fórmulas: uma planilha pode trazer surpresas. O CSV é texto puro. Se você parte do Excel, salve uma cópia no formato CSV UTF-8 para que os acentos continuem legíveis.
Ponto e vírgula ou vírgula: qual separador escolher?
Em um computador configurado em português, o Excel costuma salvar o CSV com ponto e vírgula. É também o separador proposto por padrão na importação do PrestaShop; a vírgula serve então para separar valores múltiplos dentro de uma mesma célula (várias categorias, várias imagens). O essencial é que o separador informado seja o mesmo do arquivo; caso contrário, todas as colunas acabam em uma só.
Qual modelo de CSV usar para importar produtos no PrestaShop?
Uma linha por produto, uma coluna por informação e uma primeira linha de cabeçalhos. A página de importação do PrestaShop oferece arquivos de exemplo para baixar.
No ListoMax, um modelo CSV e um modelo Excel podem ser baixados no próprio software, já preenchidos com um exemplo. Os cabeçalhos abaixo são reconhecidos automaticamente, com os equivalentes para cada idioma.
| Informação | Cabeçalho reconhecido pelo ListoMax |
|---|---|
| Nome por idioma | name_fr, name_en, name_es, name_de |
| Referência | reference ou sku |
| Preço e promoção | price, sale_price |
| Estoque, peso, código de barras | quantity, weight, ean |
| Classificação | category, tags |
| Textos | description_fr, short_fr (e outros idiomas) |
| Imagens e visibilidade | images, active |
| SEO | seo_title_fr, seo_desc_fr, seo_kw_fr |
Colunas desconhecidas são ignoradas sem travar a importação, e as seis primeiras linhas aparecem antes do envio. Os detalhes estão na página de importação em massa do ListoMax.
Como importar produtos no PrestaShop com imagens?
Na importação nativa, o arquivo contém os endereços web das imagens, não os arquivos em si. Esses endereços precisam estar acessíveis publicamente.
Fotos guardadas no seu disco não podem ser lidas pela loja: é preciso hospedá-las e depois colar cada endereço. Um endereço errado e o produto chega sem imagem.
No ListoMax, vários endereços de imagens cabem na mesma célula, separados por uma barra vertical. E no formulário você arrasta diretamente seus arquivos JPG, PNG, WEBP ou GIF (até 8 MB): eles são enviados em resolução total para a loja, e o primeiro vira a imagem de capa. Para grandes volumes de fotos, leia nosso guia para subir imagens de produtos em massa.
Como importar combinações por CSV no PrestaShop?
Na importação nativa, as combinações são tratadas à parte: um segundo arquivo, importado depois dos produtos, liga cada combinação ao seu produto principal.
Cada linha descreve uma combinação: produto, atributos, referência, estoque, impacto no preço. Dez modelos em cinco tamanhos e quatro cores são duzentas linhas para escrever sem erro.
O ListoMax resolve o problema pelo outro lado. Você informa os eixos, o software gera todas as combinações, cada uma com referência, acréscimo de preço, estoque e código EAN, e depois as cria como combinações do produto. Tudo está explicado na nossa página sobre combinações do PrestaShop em massa.
Por que a importação CSV do PrestaShop não funciona?
Na maioria das vezes, o problema está no arquivo, não na loja.
Os acentos aparecem estranhos
O arquivo não está codificado em UTF-8. Salve-o de novo no formato CSV UTF-8 a partir da sua planilha.
Todos os dados ficam em uma coluna
O separador informado não é o do arquivo: ponto e vírgula de um lado, vírgula do outro.
Os produtos chegam sem imagem
Os endereços não são públicos, têm um erro de digitação ou o servidor que os hospeda não responde rápido o suficiente.
Produtos duplicados
O mesmo arquivo importado de novo cria novas fichas se nenhuma chave, como a referência, permitir reconhecer os produtos existentes.
A importação para no meio
Um arquivo muito longo pode ultrapassar os limites da hospedagem: divida-o em lotes.
Impossível saber qual linha deu problema
No ListoMax, cada falha é listada com o número da linha e o motivo, e uma opção permite continuar apesar dos erros.
Para erros de conexão ou de permissões, a página de ajuda para conectar o PrestaShop detalha cada configuração do WebService.
Como importar a planilha do fornecedor no PrestaShop sem refazer tudo?
Mantenha o arquivo como está: o ListoMax reconhece as colunas úteis e publica cada linha como uma ficha completa.
| Importação nativa do PrestaShop | Importação no ListoMax | |
|---|---|---|
| Preparação | Arquivo no formato esperado, colunas para associar | Colunas reconhecidas automaticamente, prévia das seis primeiras linhas |
| Formatos | CSV e planilhas Excel | CSV e Excel, separador detectado |
| Acompanhamento | Conferência manual depois | Contador em tempo real, erros numerados |
| Depois da importação | Correções no painel administrativo | Fichas no catálogo, editáveis e republicáveis |
| Várias lojas | Uma importação por loja | Lojas marcadas, PrestaShop e WooCommerce |
Cada linha é enviada pelo WebService do PrestaShop, com uma breve pausa entre dois envios. Você também vende no WordPress? Veja como importar produtos no WooCommerce via CSV ou como publicar os mesmos produtos em várias lojas.
Para ir além: a página cadastrar produtos em massa no PrestaShop detalha tudo o que é criado na loja, e nosso guia para traduzir fichas de produtos em 8 idiomas cobre as colunas multilíngues. O software é instalado em poucos minutos: veja a instalação do ListoMax no Windows.
Respostas para as suas dúvidas
Qual é a diferença entre a importação CSV do PrestaShop 1.7, 8 e 9?
O princípio é o mesmo nas três versões: um arquivo, separadores e a associação das colunas. As telas mudam um pouco. O ListoMax publica no PrestaShop 1.7, 8 e 9 pelo WebService oficial.
Preciso converter minha planilha Excel em CSV?
Para a importação nativa, costuma ser mais seguro, no formato CSV UTF-8. No ListoMax, não é necessário: a primeira aba da planilha Excel é lida diretamente.
Qual separador usar em um CSV para o PrestaShop?
O ponto e vírgula é o mais comum e é o proposto por padrão na importação do PrestaShop. O que importa é que ele corresponda à configuração escolhida. O ListoMax detecta o separador automaticamente.
Quanto tempo leva para publicar uma linha de produtos em várias cores?
Com o recurso Série, menos de 2 minutos para publicar 12 fichas de produtos completas, segundo a medição do editor. Você preenche a ficha uma vez e informa os valores; o ListoMax monta e envia as fichas.
Dá para importar um CSV no PrestaShop e no WooCommerce ao mesmo tempo?
Com o ListoMax, sim. Você escolhe as lojas de destino antes de iniciar a importação, e cada linha é enviada para todas as lojas marcadas.
Dá para testar a importação sem risco?
Sim. O teste grátis oferece 5 publicações reais, sem cartão de crédito. Desmarque Produto ativo durante os testes: a ficha é criada na loja, mas fica invisível para os clientes. As licenças estão detalhadas na página de preços.
Teste nas suas próprias lojas
5 publicações reais grátis, sem cartão de crédito. Depois, uma licença vitalícia: €49 para um computador, €149 para até 20 computadores.