Como Importar Itens e Pessoas por Planilha
Importe itens e pessoas em massa por planilha do Excel ou CSV, com modelo pronto para baixar e a lista das linhas que não entraram.
O Importador de Dados cadastra itens e pessoas em massa a partir de uma planilha do Excel (.xlsx) ou arquivo CSV. Ao final, a tela mostra quantas linhas entraram e lista, uma a uma, as que foram recusadas e o motivo.
Antes de começar
- Tenha a planilha com uma linha por registro e a primeira linha com os nomes das colunas.
- Se estiver começando do zero, use o botão Baixar planilha modelo na própria tela: ele entrega o arquivo já com as colunas certas e uma linha de exemplo.
Passo a passo
- 1Acesse Gomos › Importador.
- 2Em O que você quer importar, escolha Itens ou Pessoas.
- 3Clique em Baixar planilha modelo se quiser partir do modelo do sistema.
- 4Em Escolha a planilha, selecione o arquivo do seu computador (.xlsx ou .csv).
- 5Clique em Importar dados.
Resultado esperado
Abaixo do formulário aparece o Resultado da importação com três números: linhas na planilha, importadas e não importadas. Havendo recusas, uma tabela mostra o número da linha, o registro e o motivo de cada uma — corrija essas linhas na planilha e envie o arquivo de novo.
As linhas que já entraram não são duplicadas no reenvio: o sistema recusa item com nome, código ou referência repetidos, e pessoa com CPF/CNPJ já cadastrado.
Colunas aceitas
Os nomes das colunas podem estar em português ou em inglês. Colunas que o sistema não reconhece são ignoradas, então a planilha pode ter colunas a mais.
Itens — obrigatórias: nome e preco.
| Coluna | Para que serve |
|---|---|
nome | Nome do produto ou serviço |
preco | Preço de venda |
sku | Vai para o campo Referência, usado nos marketplaces |
codigo | Código interno. Em branco, o sistema gera o próximo da sequência da empresa |
descricao | Descrição do item |
estoque | Quantidade inicial, lançada como ajuste de entrada |
custo | Preço de custo |
unidade | UN, KG, CX, L… (padrão: UN) |
tipo | PRODUCT ou SERVICE (padrão: PRODUCT) |
ncm e cest | Códigos fiscais |
altura, largura, profundidade, peso | Medidas e peso da embalagem |
codigo_barras | Código de barras (EAN/GTIN) |
Pessoas — obrigatórias: nome, documento, endereco, numero, bairro, cep, cidade, uf.
| Coluna | Para que serve |
|---|---|
nome | Nome ou razão social |
documento | CPF ou CNPJ |
email e telefone | Contato |
endereco, numero, complemento, bairro, cep | Endereço |
cidade | Código IBGE do município (exemplo: 4302105) |
uf | Sigla do estado (RS, SP…) |
pais | Sigla ou nome (BR, Brasil). Em branco, assume Brasil |
Ao importar pessoas com CNPJ, o Berga consulta a Receita Federal e completa nome e endereço com os dados oficiais — a razão social gravada pode ficar diferente da que está na planilha.
Como preencher
- Números decimais podem usar vírgula (
14,90) ou ponto (14.90). - CPF e CNPJ podem vir com ou sem pontuação.
- No CSV, o separador pode ser ponto e vírgula ou vírgula — o sistema identifica sozinho.
- Planilha do Excel com várias abas: o sistema procura a aba que tem as colunas reconhecidas.
Se der errado
| Mensagem | O que fazer |
|---|---|
| A planilha não parece ser de itens (ou de pessoas) | O tipo escolhido não corresponde ao arquivo. Troque o tipo no passo 1 ou envie a outra planilha |
| A planilha não tem nenhuma linha de dados | O arquivo só tem o cabeçalho. Preencha ao menos uma linha |
| Nome muito curto / Preço inválido | Corrija a linha indicada na tabela de recusas |
| Já existe um produto com este nome | O item já está cadastrado. Remova a linha ou ajuste o nome |
| Já existe um cadastro com este CPF/CNPJ | A pessoa já existe no Berga |
| Não foi possível falar com o servidor | Verifique a conexão e envie a planilha novamente |
Artigos Relacionados
Precisa de Ajuda?
- E-mail: meajuda@prosperatecnologia.com.br
- Telefone: (54) 3321-0214