Importar cadastros na virada do sistema
Na virada de outro sistema para o Odoo, o administrador leva clientes e fornecedores de uma planilha. O Odoo liga cada coluna ao seu campo, valida o CNPJ como no cadastro manual, testa e cria os contatos. Na carga seguinte, com a planilha corrigida, o ID externo faz o Odoo atualizar os contatos em vez de criar outros.
Antes de começar
Tenha a planilha do sistema anterior, em CSV ou em planilha, com cabeçalho e um contato por linha: ID externo, nome, CNPJ, telefone, se é empresa e se é cliente ou fornecedor. O CNPJ precisa ser válido e sem repetição na base, e o cabeçalho pode usar os rótulos dos campos do Odoo. A inscrição estadual entra em outra coluna do mesmo arquivo, quando o contato tem. O exemplo é a Guatambu Móveis e Utilidades Ltda, que carrega três clientes (Canjerana Móveis Comércio, Timbaúva Móveis e Decorações e Bracatinga Móveis) e três fornecedores (Guaçatonga Ferragens e Estamparia, Distribuidora Vereda Grande e Pitangueira Distribuidora de Utilidades). Vale no Brasil como está: o CNPJ passa pela mesma validação do cadastro manual (dígitos verificadores) e a importação grava só os dígitos.
Passo a passo
1. Confira a planilha
Confira que cada linha tem um contato, com ID externo, CNPJ, telefone e a marca de cliente ou fornecedor. A planilha do exemplo tem 6 linhas de dados e 8 colunas, entre elas o marcador Carga da virada.
2. Abra a importação e carregue o arquivo
Abra o aplicativo Contatos, clique na engrenagem ao lado do título e escolha Importar registros. Clique em Carregar arquivo de dados e escolha a planilha. O Odoo liga cada coluna ao seu campo: confira o mapeamento. Se uma coluna ficar sem campo, escolha o campo na lista da coluna ou renomeie o cabeçalho do arquivo.
3. Teste antes de gravar
Clique em Teste: a mensagem Tudo parece válido confirma as linhas. Se uma linha tiver problema, como um CNPJ inválido, o teste a aponta e nada é gravado enquanto houver erro: corrija o valor no arquivo e carregue de novo.
4. Importe os contatos
Clique em Importar e passe para a lista: os seis contatos entram, com o CNPJ e o telefone, três clientes e três fornecedores.
5. Corrija a planilha e carregue de novo
Na conferência da carga, o telefone da Timbaúva e o da Pitangueira estavam errados: corrija na planilha (Timbaúva de (51) 3341-7250 para (51) 3341-7259 e Pitangueira de (31) 3412-6580 para (31) 3412-6850), mantendo os mesmos IDs externos. Repita a importação: engrenagem, Importar registros, Carregar arquivo de dados, Teste e Importar. O Odoo reconhece o ID externo e atualiza os contatos em vez de criar outros.
6. Confira a lista
Abra a lista de contatos: continuam seis contatos, sem duplicar, e os dois telefones foram atualizados.
Resultado esperado
Seis contatos (três clientes e três fornecedores) importados da planilha, com o CNPJ validado, e atualizados pela mesma planilha corrigida sem duplicar: continuam seis, com os telefones da Timbaúva e da Pitangueira corrigidos.
Se algo der errado
Se o Teste mostrar erro numa linha, como CNPJ inválido, a linha não passa na validação do cadastro: corrija o CNPJ na planilha e carregue de novo. Se depois da segunda carga aparecerem contatos repetidos, a coluna ID externo foi importada vazia ou com valores diferentes dos da primeira carga: arquive os repetidos, confira que o ID externo da planilha é o da primeira carga e importe de novo. Se a importação recusar por CNPJ duplicado, o CNPJ já existe na base em um contato sem aquele ID externo: retire a linha da planilha ou dê ao contato existente o mesmo ID externo e importe de novo.
Veja na prática, com vídeo
- Importar cadastros em loteImporta vários parceiros de uma vez por arquivo CSV, com teste antes de gravar. É o caminho para migrar a base de clientes e fornecedores de outro sistema.Vídeo de 1 min
- Importar clientes e fornecedores com ID externo e atualizá-los na viradaNa virada de outro sistema para o Odoo, o administrador leva clientes e fornecedores de uma planilha que traz o ID externo de cada contato.Vídeo de 2 min
Manual do Odoo 18
Os recursos padrão do Odoo 18 usados nesta tarefa, do manual oficial.