# Importação de planilhas

> Carrega registros em lote a partir de uma planilha CSV ou Excel. Módulo base_import no Odoo 18: quando usar, como configurar e cuidados.

Fonte: https://docs.kmee.com.br/odoo/18.0/modulos/administracao/base-import/

- 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.

- [Importar cadastros em lote](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/administracao/importar-clientes-e-fornecedores-em-lote/) Vídeo de 1 min
- [Importar clientes e fornecedores com ID externo e atualizá-los na virada](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/implantacao/importar-e-atualizar-cadastros-por-id-externo/) Vídeo de 2 min
- [Importar lançamentos de uma planilha](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/contabilidade/importar-lancamentos-planilha/) Vídeo de 1 min
- [Importar os saldos de abertura do balancete do sistema anterior](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/contabilidade/importar-saldos-de-abertura-do-balancete/) Vídeo de 2 min
- [Lançar a folha do escritório com o líquido de cada funcionário](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/contabilidade/lancar-folha-com-liquido-de-cada-funcionario/) Vídeo de 3 min
- [Lançar o adiantamento salarial e compensá-lo na folha mensal](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/contabilidade/lancar-adiantamento-compensar-folha-mensal/) Vídeo de 3 min
- [Carregar o orçamento anual por planilha e aprová-lo](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/contabilidade/carregar-orcamento-anual-e-aprovar/) Vídeo de 2 min
- [Importar por planilha os títulos a receber em dólar do sistema anterior](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/financeiro/importar-titulos-a-receber-em-dolar/) Vídeo de 2 min
- [Reimportar a planilha da virada para atualizar um título e conferir o total em aberto](https://docs.kmee.com.br/odoo/18.0/localizacoes/brasil/financeiro/reimportar-titulos-e-conferir-em-aberto/) Vídeo de 3 min

## Módulos relacionados

- [Usuários, empresas e contatos](https://docs.kmee.com.br/odoo/18.0/modulos/administracao/base/)
- [Listas, filtros e visões da tela](https://docs.kmee.com.br/odoo/18.0/modulos/administracao/web/)
- [Localização brasileira, cadastros básicos](https://docs.kmee.com.br/odoo/18.0/modulos/localizacao-brasileira/l10n-br-base/)

## Código e fontes

- Código-fonte: [odoo/odoo](https://github.com/odoo/odoo)
- [Código-fonte do módulo no Odoo (18.0)](https://github.com/odoo/odoo/tree/18.0/addons/base_import)