Guia · Preparação de dados
Como preparar um arquivo Excel ou CSV para importar no Odoo
A maioria das importações para o Odoo não falha por um problema do ERP -- falha porque o arquivo chega com pressupostos que não se cumprem naquela instância específica. Este guia revisa o que checar antes de enviar um CSV ou Excel, sem assumir que você já sabe o que é um External ID ou um mapeamento de colunas.
O que checar antes de importar
Os cabeçalhos coincidem com os campos reais do Odoo
O importador nativo do Odoo (Configurações > Técnico > Importar/Exportar, ou o assistente ao enviar um arquivo) mapeia colunas por nome. Se o seu Excel diz "Email" e o Odoo espera "email" mas em outro idioma ou grafia, o mapeamento automático falha ou fica vazio silenciosamente.
As relações existem na sua instância, não na genérica
Uma categoria de produto, uma etapa de CRM ou uma moeda que "deveria" existir pode não estar cadastrada na sua base real. O Odoo não inventa o valor: rejeita a linha ou a deixa sem essa relação.
Cada linha tem um identificador único (External ID)
Sem uma coluna id (External ID) ou uma chave única real (como o email em Contatos), reimportar o mesmo arquivo duas vezes pode criar registros duplicados em vez de atualizar os existentes.
Os formatos de número e data são consistentes
Separador decimal, formato de data e encoding do arquivo (UTF-8) variam conforme de onde você exportou o Excel. Uma inconsistência entre linhas faz o Odoo interpretar o valor errado em algumas e certo em outras.
Não há linhas com campos obrigatórios vazios
Cada módulo tem campos que o Odoo exige para criar o registro (por exemplo, preço em Vendas ou fornecedor em Compras). Uma célula vazia ali nem sempre dá um erro visível antes da importação real.
Como a OMI aborda isso
A OMI valida seu arquivo contra as regras reais do módulo e da versão do Odoo que você escolheu (14 a 19), geradas lendo o código-fonte do Odoo, não um checklist genérico. Agrupa cada problema por tipo, aplica as correções que pode resolver automaticamente e marca para revisão manual as que exigem seu critério -- por exemplo, um preço zerado que poderia ser um erro ou poderia ser real.
O resultado é um Quality Score de 0 a 100, um relatório técnico em PDF e um arquivo corrigido, numerado conforme a ordem de importação recomendada entre módulos relacionados. Nada disso usa IA: é determinístico, então o mesmo arquivo sempre produz o mesmo resultado.
Quer ver isso com o seu próprio arquivo?
Envie um CSV ou Excel e em segundos você tem o relatório completo, sem custo.
Analisar meus dados grátis →