Ajuda da tela
Importar produtos (CSV)
Cadastre ou atualize muitos produtos de uma vez a partir de uma planilha CSV, conferindo o mapeamento das colunas antes de importar.
Onde fica no Ferpus
CadastrosFerramentasImportar produtos
Dentro do Ferpus, aperte F1 nesta tela para voltar a esta página.
Nesta página · 6 seções
A importação lê uma planilha CSV, sugere qual coluna vai para qual campo do Ferpus, mostra uma prévia e só então grava. Produto que já existe (mesmo SKU ou, na falta dele, mesmo GTIN) é atualizado; produto novo é criado. Linhas com problema não travam o resto: elas aparecem numa lista ao final, com o número da linha e o motivo.
Também abre pelo botão Importar CSV da lista de produtos.
Antes de começar
- Tenha a planilha com o cabeçalho na primeira linha e uma linha por produto, salva como CSV UTF-8. O separador pode ser
;,,ou tabulação: o Ferpus descobre pela primeira linha. - As colunas SKU / código e Nome / descrição são obrigatórias no mapeamento.
- Seu usuário precisa poder cadastrar produtos.
Exemplo de planilha que o Ferpus mapeia sozinho:
Código;Descrição;Preço;Custo;EAN;NCM;Unidade;Origem;Situação
CAM-BAS-PRT;Camiseta Básica Preta;59,90;29,95;7891234567895;61091000;UN;0;Ativo
CAM-BAS-BRC;Camiseta Básica Branca;59,90;29,95;;61091000;UN;0;Ativo
Como importar
- Em O que importar, deixe Produtos.
- Em Arquivo CSV, escolha a planilha.
- Clique em Analisar arquivo.
- Confira o Mapeamento das colunas: para cada Coluna do arquivo, o Campo no Ferpus sugerido. Corrija o que estiver errado e use Ignorar coluna para o que não deve entrar.
- Confira a Prévia das primeiras linhas (5 linhas) e o total, por exemplo 250 linhas para importar.
- Clique em Iniciar importação.
- Acompanhe a barra de progresso. Quando a etiqueta mudar para Concluída, veja os totais Criados, Atualizados e Com erro.
- Se houver Linhas com erro, corrija essas linhas na planilha e importe só elas de novo.
Pronto: clique em Ver registros importados para abrir a lista de produtos. Passo a passo com exemplo: Como importar produtos por planilha.
Campos
Envio do arquivo
| Campo | Obrigatório | O que informar | Exemplo |
|---|---|---|---|
| O que importar | Sim (vem Produtos) | Produtos ou Contatos (clientes e fornecedores). | Produtos |
| Arquivo CSV | Sim | Planilha .csv com cabeçalho na primeira linha. | produtos-loja.csv |
Campos do Ferpus no mapeamento (Produtos)
| Campo no Ferpus | Obrigatório | Como a célula deve vir | Exemplo | Cabeçalhos que o Ferpus reconhece sozinho |
|---|---|---|---|---|
| SKU / código | Sim | Código único do produto. Também decide se a linha atualiza um produto existente. | CAM-BAS-PRT | SKU, Código, Cod, Referência, Ref |
| Nome / descrição | Sim no mapeamento; na célula, só para produto novo | Nome do produto. | Camiseta Básica Preta | Nome, Descrição, Produto, Título |
| Descrição longa | Não | Texto do produto. | Camiseta 100% algodão, gola careca. | Descrição completa, Descrição longa, Detalhes |
| Preço de venda | Não | Valor em reais, com ou sem R$ e pontos de milhar. | 1.234,56 | Preço, Preço venda, Valor, PVP |
| Custo | Não | Valor em reais, como o preço. | 29,95 | Custo, Preço custo, Custo médio |
| GTIN / EAN | Não | Código de barras com dígito verificador válido. | 7891234567895 | GTIN, EAN, EAN13, Código de barras |
| NCM | Não | 8 números, com ou sem pontos. | 6109.10.00 | NCM |
| CEST | Não | 7 números, com ou sem pontos. | 28.038.00 | CEST |
| Unidade | Não | Até 6 letras; o Ferpus põe em maiúsculas. | un | Unidade, UN, UND, Unid |
| Origem | Não | Número de 0 a 8 (origem da mercadoria na NF-e). | 0 | Origem |
| Situação | Não | Inativo, inactive, 0, nao ou não grava Inativo; qualquer outro valor grava Ativo. | Ativo | Situação, Status |
| Tipo | Não | simple, kit, composite, service ou raw_material. Em branco, o produto novo entra como simples. | composite | Tipo |
Botões e ações
| Ação | Onde fica | O que faz |
|---|---|---|
| Analisar arquivo | Abaixo do arquivo | Lê a planilha, sugere o mapeamento e mostra a prévia. Nada é gravado ainda. |
| Iniciar importação | Abaixo da prévia | Grava os produtos em segundo plano. Só libera com SKU / código e Nome / descrição mapeados. |
| Nova importação | Abaixo da prévia e no resultado | Descarta o arquivo atual e volta ao início. |
| Ver registros importados | No resultado | Abre a lista de produtos. |
Situações da importação
| Situação | Significado |
|---|---|
| Na fila | A importação foi aceita e vai começar. |
| Processando… | Gravando; a tela mostra Processadas X de Y linhas. |
| Concluída | Terminou. Veja Criados, Atualizados e Com erro. |
| Falhou | Parou no meio; o motivo aparece em vermelho. As linhas já processadas ficam gravadas. |
Erros comuns
Os erros de linha aparecem na tabela Linhas com erro. A Linha é a da planilha (o cabeçalho é a linha 1).
| Mensagem | Causa | O que fazer |
|---|---|---|
| Mapeie uma coluna para o campo obrigatório: SKU / código, Nome / descrição. | Falta mapear um dos campos obrigatórios. | No Mapeamento das colunas, escolha a coluna do código e a do nome. |
| Não foi possível processar o arquivo. Confira se é um CSV válido e tente novamente. Arquivo vazio: envie um CSV com cabecalho e ao menos uma linha | Arquivo só com cabeçalho, vazio ou não é CSV. | Salve a planilha como CSV com ao menos uma linha de produto. |
SKU obrigatorio | Linha sem código. | Preencha o SKU da linha. |
SKU "CAM-01" repetido no arquivo | Duas linhas com o mesmo SKU. | Deixe uma linha por SKU. |
GTIN invalido: 7891234567890 | Dígito verificador errado ou quantidade de dígitos fora de 8, 12, 13 ou 14. | Copie o GTIN da embalagem ou deixe a célula vazia. |
GTIN 7891234567895 repetido no arquivo | Duas linhas com o mesmo GTIN. | Deixe o GTIN em uma só linha. |
NCM invalido: 6109.10 | NCM sem 8 números. | Use os 8 números do NCM. |
CEST invalido: 28038 | CEST sem 7 números. | Use os 7 números do CEST ou deixe vazio. |
Preco invalido: -10 / Custo invalido: abc | Valor negativo ou com letras. | Use número positivo, ex.: 59,90. |
Origem invalida: 9 | Origem fora de 0 a 8. | Use um número de 0 a 8. |
Tipo invalido: Kit Promo | Tipo fora da lista aceita. | Use simple, kit, composite, service ou raw_material. |
Nome obrigatorio para novo produto | SKU novo com a célula do nome vazia. | Preencha o nome da linha. |
Produto CAM-01 ja atualizado por outra linha do arquivo | Duas linhas apontam para o mesmo produto (uma pelo SKU, outra pelo GTIN). | Junte as duas linhas em uma. |
| Não foi possível processar o arquivo. Confira se é um CSV válido e tente novamente. Permissao necessaria: catalog.product.write | Seu usuário não pode cadastrar produtos. | Peça a permissão ao administrador. |