Skip to Content

📥 Importação de XML de NF-e

Importar o XML da NF-e do fornecedor evita redigitar nota de entrada. O Odoo lê o arquivo, cria o documento eletrônico com todos os dados do emitente, dos produtos e dos impostos, e deixa tudo pronto para virar fatura de compra e entrada no estoque.

Importar o XML da NF-e do fornecedor evita redigitar nota de entrada. O Odoo lê o arquivo, cria o documento eletrônico com todos os dados do emitente, dos produtos e dos impostos, e deixa tudo pronto para virar fatura de compra e entrada no estoque.

Abrir o assistente

Vá em Painel Fiscal → NFes (Edocs) → Importar XML. O atalho Importar XML também fica no card "XML importado" do Painel Fiscal.

🖥️
Tela no Sistema: Assistente Importar NFe do Odoo com as opções importar Zip, carregar arquivos XML e selecionar a empresa

Os campos do assistente

  • Importar Zip? — marque quando for subir um arquivo .zip com vários XML dentro. É o caminho para importar um mês inteiro de uma vez.
  • XML da NFe — o botão Carregar arquivos aceita seleção múltipla; dá para escolher vários .xml na mesma operação.
  • Empresa — só preencha quando quiser forçar a empresa de destino. Em branco, o Odoo usa a tag de destinatário do próprio XML para descobrir qual empresa do grupo recebeu a nota.

Clique em Importar e o sistema processa os arquivos.

O que acontece depois

  1. Cada XML vira um documento eletrônico na situação Importado, visível em NFes (Edocs) → Notas Fiscais.
  2. O emitente é procurado pelo CNPJ. Se não existir cadastro, o Odoo cria o contato com os dados do XML.
  3. As linhas trazem código do produto no fornecedor, NCM, CFOP, quantidade, valor e os impostos destacados.
  4. O valor total importado passa a somar no card XML importado do Painel Fiscal.

De XML importado a fatura de compra

Com o documento importado aberto, use a ação para gerar a fatura de fornecedor. O Odoo faz o de-para entre o código do produto no fornecedor e o seu produto interno; na primeira importação de cada item você confirma a correspondência, e nas próximas ele já entra sozinho.

Erros comuns

  • XML de outro destinatário — o CNPJ do destinatário não bate com nenhuma empresa cadastrada. Selecione a empresa no assistente para forçar a importação.
  • Arquivo já importado — a chave de acesso é única; o sistema recusa a duplicata. Procure pela chave na lista de documentos.
  • XML de cancelamento ou de evento — o assistente importa o XML da nota (procNFe). Eventos são tratados separadamente.

Importação automática

Quem usa o MD-e não precisa pedir o XML ao fornecedor: ao dar ciência e confirmar a operação, o Odoo baixa o documento completo da SEFAZ e ele entra pela mesma esteira do XML importado.

Guia Complementar — Importação de XML

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)

In this section

Still have questions?

Our team can help you configure this workflow in your environment.

Open support ticket →