Pular para o conteúdo
KMEEEntrar

Importação de planilhas

  • Módulo base_import
  • Origem: Odoo padrão
  • Licença LGPL-3
  • Odoo 18.0

Carrega registros em lote a partir de uma planilha CSV ou Excel. O Odoo liga cada coluna ao campo certo, testa o arquivo antes de gravar e mostra os erros linha a linha. Serve para cadastros iniciais de clientes, fornecedores, produtos e lançamentos, e também para atualizar registros que já existem.

Quando usar

  • Trazer clientes e fornecedores do sistema anterior na virada.
  • Carregar produtos, saldos e lançamentos de uma planilha.
  • Atualizar em lote dados de registros já cadastrados, como telefones e preços.
  • Corrigir um cadastro inteiro em uma planilha e importar de novo sem duplicar.

Como configurar

  1. Abra a lista do cadastro, como Contatos, clique na engrenagem ao lado do título e escolha Importar registros.
  2. Clique em Carregar arquivo de dados e escolha a planilha.
  3. Confira o mapeamento, em que cada coluna do arquivo vai para um campo do Odoo.
  4. Clique em Teste e confirme a mensagem Tudo parece válido.
  5. Clique em Importar. Os registros entram e a lista mostra o resultado.
  6. Para atualizar registros existentes, inclua a coluna ID externo na planilha e importe de novo com os mesmos IDs.

Cuidados

  • Use ID externo em cada linha quando a mesma planilha puder ser importada outra vez. Os registros com o mesmo ID são atualizados e não duplicados.
  • O teste aponta as linhas com problema antes de gravar, então corrija a planilha e teste de novo.
  • Os campos dependem de cada cadastro. Colunas como CNPJ são validadas pelas mesmas regras do formulário.
  • A importação precisa de permissão de criação no cadastro de destino.

Veja na prática

Cenários do manual que usam este módulo, do começo ao fim, com exemplo calculado, passo a passo e vídeo curto com legendas.

Módulos relacionados

Código e fontes