Importar produtos via planilha CSV

Se você tem mais de 20 produtos pra cadastrar, fazer um por um é cansativo. A importação via CSV permite cadastrar todos de uma vez a partir de uma planilha. Aceita arquivos .csv exportados do Excel, Google Sheets, LibreOffice ou direto de outros sistemas.

Tenha em mãos: sua planilha de produtos. Se você ainda não tem, baixe o modelo do programa (passo 1 abaixo) e preencha — é mais rápido do que criar do zero.

Baixe o modelo de planilha

Vá em Menu lateralCadastrosProdutos e clique no botão Importar CSV no topo. Na primeira tela do assistente, clique em Baixar modelo.

O programa baixa um arquivo modelo-produtos.csv na sua pasta de Downloads, com cabeçalho pré-preenchido e 2 linhas de exemplo.

Tela do assistente de importação — botão de baixar modelo

Preencha a planilha

Abra o modelo-produtos.csv no Excel ou Google Sheets. As colunas são:

Coluna	Obrigatório	Exemplo	Notas
`codigo_interno`	não	`P001`	Seu SKU
`descricao`	sim	`Camiseta básica branca P`	Aparece na NF-e
`ncm`	sim	`61091000`	8 dígitos
`cfop`	sim	`5102`	4 dígitos
`unidade`	sim	`UN`	UN, KG, M, M2, L, PC, CX
`valor_unitario`	sim	`29,90`	Vírgula como decimal
`origem`	sim	`0`	0 = Nacional
`csosn_ou_cst`	sim	`102`	102 pra MEI/Simples
`gtin`	não	`7891234567890`	EAN-13 ou `SEM GTIN`

Importante sobre formato: use vírgula como separador decimal (29,90, não 29.90). NCM e CFOP devem estar como texto, não número — senão o Excel remove os zeros à esquerda.

Truque pro Excel não comer os zeros:

Selecione as colunas NCM e CFOP antes de digitar
Formate como Texto (Ctrl+1 → Texto)
Aí pode digitar 61091000 que ele mantém os 8 dígitos

Planilha pronta com produtos preenchidos

Salve a planilha como CSV

Quando terminar:

Excel: ArquivoSalvar comoCSV (separado por vírgulas)

Google Sheets: ArquivoFazer downloadValores separados por vírgula (.csv)

LibreOffice: ArquivoSalvar comoTexto CSV

Encoding: se aparecerem caracteres estranhos (Ã§ no lugar de ç), salve como UTF-8. No Excel: "CSV UTF-8 (separado por vírgulas)". No Google Sheets já vem UTF-8 por padrão.

Faça o upload no programa

Volte ao assistente de importação. Arraste o .csv pra área indicada (ou clique pra escolher pelo navegador de arquivos).

O programa lê a planilha e mostra um preview com as primeiras 5 linhas:

Preview da importação — confira se as colunas estão certas

Confira se cada coluna está sendo lida corretamente. Se algo estiver desalinhado, o problema é no separador (use vírgula) ou encoding (use UTF-8).

Revise a validação

Clique em Validar. O programa percorre todas as linhas verificando:

✅ Campos obrigatórios preenchidos
✅ NCM existe na tabela oficial
✅ CFOP é válido
✅ Valor numérico (vírgula decimal)
✅ CSOSN/CST compatível com regime do emitente

Aparece uma tela com 2 listas:

Linhas válidas (vão ser importadas)
Linhas com erro (mostra qual coluna e qual problema)

Resultado da validação — verde pra ok, vermelho pra erro por linha

Você pode:

Corrigir os erros na planilha e fazer upload de novo
Importar só as linhas válidas (ignora as com erro)
Cancelar e revisar tudo

Confirme a importação

Clique em Importar X produtos. O programa grava todos de uma vez. Pra 100 produtos demora ~5 segundos.

Quando termina, mostra o resumo:

✅ 87 produtos importados ⚠ 3 ignorados (erros de NCM)

Os produtos aparecem na lista normal. Agora você pode editar individualmente ou usar nas notas.

Importação atualizando produtos existentes

Se você importar um CSV onde o codigo_interno já existe, o programa pergunta o que fazer:

Atualizar — sobrescreve dados do produto existente
Ignorar — pula essa linha
Criar duplicado — cria novo produto com mesmo código (raramente é o que você quer)

Pra atualizar preços em massa, basta exportar a planilha atual, alterar a coluna valor_unitario e importar com "Atualizar".

Próximo passo

Produtos cadastrados. Agora vamos cadastrar os clientes (destinatários) — quem vai receber as notas que você emite.