Importação de XML

Updated on 11/08/2026 · Odoo 17.0

O novo módulo de importação de XML permite a importação de NFes de forma manual através de arquivos .xml individuais ou pacotes .zip. A funcionalidade pode ser acessada por:

Menu: NFes (Edocs) > Importar XML
Painel: Botão IMPORT XML

Pop-up de Importação

Carregar arquivos: Permite anexar arquivos .xml ou .zip
Importar Zip?: Ativa a leitura múltipla em lote (arquivo .zip)
Empresa: Permite definir manualmente a empresa que receberá os XMLs, mesmo que a tag dest do documento indique outra. Útil para importação de dados legados ou notas de terceiros.

⚙️ Configuração da Empresa

Para habilitar o preenchimento automático de dados durante a importação, verifique no cadastro da empresa (menu Configurações > Empresas) os seguintes campos na seção NFE:

Cadastra parceiro? ✅ Cria automaticamente o fornecedor (emitente da NFe)
Cadastra produto do parceiro? ✅ Cria os produtos listados no XML, caso não encontrados

Lógica de Identificação de Dados

Parceiro (Fornecedor): A verificação é feita pelo CNPJ da tag <CNPJ>00000000000</CNPJ>.

Se não houver correspondente no sistema e a flag de criação estiver ativada, o fornecedor será cadastrado automaticamente com base em dados como:

xNome, xFant, xLgr, nro, bairro, UF, CEP, fone, etc.

📦 Produtos

A correspondência do produto é feita com base nos seguintes campos do XML:

<cProd> → Referência interna (campo 'default_code' no Odoo)
<cEAN>  → Código de barras (campo 'barcode')

Exemplo no Odoo

Para garantir o correto vínculo durante a importação, cadastre o produto no Odoo com:

Referência interna = <cProd>
Código de barras = <cEAN>

E se ambos não forem localizados em nenhum produto cadastrado?

Se a empresa estiver com a opção "Cadastra produto do parceiro?" marcada, o produto será criado automaticamente.
Caso contrário, o EDOC será preenchido sem vínculo com produto, mas trará informações como descrição, NCM, CFOP, quantidade, valor unitário, e impostos.

Veja abaixo um exemplo de correspondência:

XML	Produto no Odoo
<cProd>102222327</cProd>	Referência Interna = 102222327
<cEAN>9786599441295</cEAN>	Código de Barras = 9786599441295

Atenção

Se o produto não for localizado e não for criado automaticamente, o XML será parcialmente importado. O EDOC será gerado, mas os itens não terão vínculo com produtos do sistema — impactando na gestão de estoque, custo e integração contábil.

Por isso, é imprescindível orientar os usuários a preencher corretamente os campos "Referência interna" e "Código de barras" nos produtos cadastrados.

Caso o produto não seja localizado, ainda é possível adicionar o produto manualmente. Para isso basta retornar a importação para rascunho (reset to draft).

Em seguida selecione a linha do item e selecione o produto no pop-up. Veja que a edição só fica disponível quando a importação está em provisório.

Você também pode se interessar:

Módulo MDe (recebimento de NF fornecedores automática pelo sistema)