Importando cadastros de planilha
Traga produtos, clientes, fornecedores e transportadoras de uma planilha Excel ou CSV, com prévia antes de gravar.
4 min de leitura · Intermediário · atualizado em 06/10/2026
Digitar centenas de cadastros um a um é lento e sujeito a erro. O assistente de importação lê a sua planilha, mostra o que vai acontecer e só grava depois que você confirma. Quem está migrando de outro sistema, ou recebeu a lista do fornecedor em Excel, ganha horas.
O que dá para importar
- Produtos: em Cadastros › Produtos, botão Importar CSV.
- Clientes: em Cadastros › Clientes, botão Importar planilha.
- Fornecedores: em Cadastros › Fornecedores, botão Importar planilha.
- Transportadoras: em Cadastros › Transportadoras, botão Importar planilha.
A importação cria e altera cadastros em massa, por isso é restrita a quem tem a permissão de importar (em geral, o administrador). Sem a permissão, o botão não aparece.
O assistente em 4 passos
O assistente mostra a trilha 1. Arquivo, 2. Colunas, 3. Prévia, 4. Resultado.
1Arquivo
Baixe o modelo (link Excel (.xlsx, recomendado) ou CSV) e preencha com os seus dados, mantendo a primeira linha com o nome das colunas. Também serve o CSV exportado da própria listagem. O arquivo pode ter até 2 MB e 1.000 linhas.
Escolha O que fazer:
- Somente criar registros novos;
- Somente atualizar registros existentes;
- Criar os novos e atualizar os existentes.
Para atualizar, o sistema localiza o cadastro pelo CPF/CNPJ (ou pelo código, se não houver documento) em clientes e fornecedores, e pelo código (SKU) ou código de barras em produtos. Célula em branco não apaga nada.
2Colunas
O sistema mostra cada coluna do seu arquivo com exemplos e sugere para qual campo ela vai, em Vai para o campo. Corrija o que estiver errado ou deixe — ignorar — nas colunas que não interessam. Em seguida, Validar e ver a prévia.
3Prévia
Nada foi gravado ainda. Você vê quantas linhas serão para criar, para atualizar e com erro (ficam de fora), linha por linha, com as observações de cada uma. Marque Mostrar só erros e avisos para focar no que precisa de correção. As mesmas regras do cadastro valem aqui: campos obrigatórios, formatos e duplicidade.
4Resultado
Clique em Importar N linha(s) válida(s) e confirme. No final aparece Importação concluída, com os totais de criados, atualizados e ignorados. As linhas com erro ficam listadas: corrija-as na planilha e importe só elas, com Nova importação.
Cuidados por tipo
- Produtos: os campos são código (SKU), nome, tipo, código de barras, referência, descrição, grupo, marca, categoria, unidade, ativo, peso bruto, e (para quem tem permissão) NCM, CEST, origem, custo e preço de venda. Marque Criar marcas, grupos e categorias que não existirem se quiser que o sistema crie o que faltar. Para importar preço, escolha a Tabela de preço. Produtos novos nascem como rascunho: complete e coloque em linha depois.
- Clientes: documento e nome são obrigatórios para criar. Aceita ainda endereço (CEP, logradouro, número, bairro, município, UF, código IBGE), condição e forma de pagamento, grupo, tabela de preço, vendedor e limite de crédito. Cliente estrangeiro, outros endereços e contatos ficam para a tela do cliente.
- Fornecedores: retenções, contas bancárias, fornecedor estrangeiro e contatos adicionais são completados na tela do fornecedor.
- Transportadoras: usa os mesmos campos do cadastro (razão social, documento, IE, RNTRC e endereço).
Faça um teste com poucas linhas antes da carga completa. A prévia mostra exatamente como o sistema interpretou cada coluna.
Condição de pagamento, forma de pagamento, grupo, tabela de preço e vendedor precisam existir nos cadastros auxiliares. Cadastre-os antes (veja "Preços e pagamentos") para que a coluna seja reconhecida.
Quer avaliar este guia ou usar o sistema? Entre ou cadastre-se.