Pular para o conteúdo

📥 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)

Nesta seção

Ficou com alguma dúvida?

Nossa equipe pode auxiliar você na configuração deste processo no seu ambiente.

Abrir chamado de suporte →