NF-e

NF-e na localização brasileira do Odoo 16: os processos do começo ao fim, os guias e cada cenário com exemplo calculado, passo a passo e vídeo curto com legendas.

NF-e: emissão, rejeição e consulta

As etapas deste processo, na ordem em que acontecem: 12 no total, 3 com vídeo curto e legendas. As que ainda não funcionam na 16.0 levam ao motivo e à alternativa.

  1. Transmitir a NF-e e acompanhar a autorização (disponível em parte, vídeo de 1 min)

  2. Enviar a NF-e ao cliente por e-mail (disponível em parte, vídeo de 2 min)

  3. Ler uma rejeição, corrigir e retransmitir (não disponível na 16.0)

  4. Tratar uma NF-e denegada (não disponível na 16.0)

  5. Consultar a situação na SEFAZ e recuperar o protocolo (não disponível na 16.0)

  6. Reimprimir o DANFE e baixar o XML autorizado (não disponível na 16.0)

  7. Emitir NF-e em lote (não disponível na 16.0)

  8. Prorrogar o prazo da suspensão de ICMS por evento (não disponível na 16.0)

  9. Referenciar a nota original por item na devolução (não disponível na 16.0)

  10. Emitir NF-e com data de emissão retroativa (disponível em parte, vídeo de 2 min)

  11. Registrar o comprovante de entrega e o ator interessado (não disponível na 16.0)

  12. Registrar mercadoria sinistrada em trânsito com nota de retorno simbólica (não disponível na 16.0)

NF-e: contingência

As etapas deste processo, na ordem em que acontecem: 2 no total, 0 com vídeo curto e legendas. As que ainda não funcionam na 16.0 levam ao motivo e à alternativa.

  1. Emitir em contingência SVC (não disponível na 16.0)

  2. Emitir em contingência offline ou EPEC (não disponível na 16.0)

Guias

Outros cenários desta seção

Ainda não disponível na 16.0

O que este assunto ainda não cobre na versão 16.0 da localização brasileira, com a alternativa possível. Precisa de alguma destas funções? Fale com a KMEE.

Ler uma rejeição, corrigir e retransmitir

Não disponível na 16.0. Cenário NFE-03.

A rejeição nasce de uma resposta real da SEFAZ. Neste ambiente (empresa sem integração) o Enviar autoriza na hora, então a tela de rejeição nunca aparece. O código da 16.0 trata o estado Rejeitada (alerta com o motivo, Set to Draft para voltar a rascunho, Invalidar Numeração), mas o roteiro só pode ser gravado contra a homologação da SEFAZ. Correções de lote recusado em silêncio, recusa que apaga auditoria e rejeição 573 estão nos PRs OCA/l10n-brazil 5300 a 5306. Cobrir com homologação em outra fase.

Sem a resposta da SEFAZ não há como produzir a rejeição pela interface. Catálogo de rejeições da pesquisa, para ler cada código por causa e ação: erro de dado (corrigir a nota e reenviar), problema cadastral do emitente (regularizar na SEFAZ) e mudança de validação da UF. Códigos citados pelas fontes: 221, 291, 301, 307, 321, 328, 539, 546, 563, 573, 596, 599, 626, 863, 1001 e 1022. O fórum do ACBr registra o caso de um CST que a SEFAZ de SP aceitava e passou a rejeitar em dezembro de 2024. As fontes são de fornecedor e de fórum; o texto de cada rejeição está na tabela da nota técnica vigente.

Tratar uma NF-e denegada

Não disponível na 16.0. Cenário NFE-04.

A denegação depende de resposta real da SEFAZ, que o ambiente sem integração não gera. A 16.0 trata o estado Denegada: o alerta com o motivo e a ação Invalidar Numeração, que fica liberada para documento rejeitado ou denegado. A inutilização em si só funciona com SEFAZ (Inutilizar uma faixa de numeração). Cobrir com homologação em outra fase.

Sem a resposta da SEFAZ não há como produzir a denegação pela interface. Denegação por situação cadastral do emitente (301) ou por bloqueio da UF de destino (307) se resolve regularizando a situação na SEFAZ, e não corrigindo o XML. Antes de emitir, a consulta ao cadastro de contribuintes (CCC) e ao Sintegra evita a surpresa. Fonte de fornecedor, a conferir na norma.

Emitir em contingência SVC

Não disponível na 16.0. Cenário NFE-08.

Existem o seletor Transmission Type (Emissão Normal, SVC-AN, SVC-RS, FS-IA, FS-DA, EPEC) na empresa e a opção nfe_enable_contingency_ws, que manda emissão, cancelamento e consulta ao webservice de contingência. Não há troca automática quando a SEFAZ cai nem regularização posterior, e sem SEFAZ nada é verificável. A contingência ainda não tem fluxo na 16.0.

Sem a SEFAZ não há como exercitar o desvio de serviço pela interface. SVC-AN e SVC-RS variam por UF e são ativados pela SEFAZ do estado, não pelo emitente (fontes de fórum e de fornecedor, a conferir). O EPEC aparece como bloqueado para PR e PB (rejeição 121) em 05/10/2026 segundo o fórum do ACBr: data prevista, a conferir na norma vigente.

Emitir em contingência offline ou EPEC

Não disponível na 16.0. Cenário NFE-09.

O EPEC aparece apenas como opção do seletor Transmission Type: não há rotina de evento nem de envio do EPEC no código da 16.0. A contingência offline (tipo de emissão 9) só é aplicada à NFC-e, quando a transmissão falha por falta de comunicação, e não vale para NF-e modelo 55. A contingência ainda não tem fluxo na 16.0. A NFC-e offline é o cenário Emitir NFC-e em contingência off-line.

O EPEC não existe na 16.0; o offline só serve à NFC-e e exige SEFAZ. Uma NF-e rejeitada depois do EPEC muda a chave (rejeições 467 e 610), e o EPEC se concilia em 30 dias (fontes de fornecedor, a conferir). O EPEC aparece como bloqueado para PR e PB (rejeição 121) em 05/10/2026 segundo o fórum do ACBr: data prevista, a conferir na norma vigente.

Consultar a situação na SEFAZ e recuperar o protocolo

Não disponível na 16.0. Cenário NFE-10.

A ação existe: Ação -> Document Status abre o assistente e o botão Get Status consulta. No ensaio, sem processador, a janela abre e a consulta volta sem chave nem situação, então não mostra nem recupera protocolo. O botão Consultar Recibo, para nota Enviada, só aparece depois do envio assíncrono real. Roteiro só com a homologação da SEFAZ.

No ambiente sem integração a consulta volta vazia. A consulta é só pela chave de acesso, e vale guardar o código numérico (cNF) da nota. Para reenviar uma nota sem retorno sem duplicar, a leitura das fontes é: a rejeição 204 significa que a nota já foi enviada, a 539 que a chave difere da já registrada e a 241 que a nota existe; consulte antes de reenviar (fontes de fórum e de fornecedor, a conferir). Esse caminho, que separa o erro de rede da rejeição real, não pode ser roteirizado sem SEFAZ.

Reimprimir o DANFE e baixar o XML autorizado

Não disponível na 16.0. Cenário NFE-11.

No ensaio, com a NF-e autorizada por simulação, View PDF mostra No PDF file generated, View XML mostra No XML file generated e Imprimir -> DANFE devolve erro 500 (o servidor de captura também não tem wkhtmltopdf). O DANFE depende da chave de acesso, do protocolo e do XML autorizado, que só a SEFAZ devolve. Roteiro só com homologação e wkhtmltopdf no servidor.

Sem a autorização real não existe XML autorizado nem DANFE com chave.

Emitir NF-e em lote

Não disponível na 16.0. Cenário NFE-12.

Na lista de NF-e a Ação, com os documentos selecionados, só oferece Document Status (e Excluir ao analista fiscal): não há Enviar em lote. O módulo l10n_br_fiscal_queue enfileira o envio de cada documento em segundo plano (queue_document_send na empresa), sem tela de lote. A emissão por planilha CSV, com fila, revisão e acompanhamento, é proposta para a 18.0 como módulo privado l10n_br_batch_invoice, sem código na 16.0.

A 16.0 não tem ação de envio em lote na lista de NF-e.

Prorrogar o prazo da suspensão de ICMS por evento

Não disponível na 16.0. Cenário NFE-13.

Os eventos de prorrogação (111500 a 111503) e as respostas do fisco (411500 a 411503) aparecem só como proposta de desenho. Nada em l10n_br_nfe trata esses eventos. Fontes da pesquisa: tópicos 85894 e 81184 do fórum do ACBr. Prazo e rito por estado: conferir na norma vigente.

Não há evento de prorrogação na 16.0, então o cenário não pode ser roteirizado. Sem o pedido a remessa pode virar saída tributada quando o prazo vence. A regra é estadual: o fórum do ACBr cita Minas Gerais com o pedido só por evento desde 01/12/2025, data que está para conferir na norma do estado.

Referenciar a nota original por item na devolução

Não disponível na 16.0. Cenário NFE-14.

O grupo DFeReferenciado aparece só em comentário do código de l10n_br_nfe. O ajuste correspondente da reforma tributária não tem PR. Fontes da pesquisa: tópicos 94204 e 93915 do fórum do ACBr e artigo 360010190894 da central da TecnoSpeed (regras de validação da devolução, entre elas 321, 328, 546 e 863).

A 16.0 referencia a nota original só no documento, não por item. A data em que a regra entra em produção diverge entre as fontes (o fórum aponta 05/10/2026 e um cronograma de mercado aponta 03/11/2026 para a NT 2025.002): previsto, conferir na norma vigente.

Registrar o comprovante de entrega e o ator interessado

Não disponível na 16.0. Cenário NFE-16.

Os eventos 110130 (comprovante de entrega) e 110150 (ator interessado) estão só como proposta de desenho. Nada em l10n_br_nfe os emite. Fontes da pesquisa: artigos 4402106952727 e 4418698200087 da central da TecnoSpeed e tópico 87759 do fórum do ACBr.

Não há esses eventos na 16.0. A NF-e de saída hoje só exporta o autorizado a baixar o XML (autXML), que é outro recurso.

Registrar mercadoria sinistrada em trânsito com nota de retorno simbólica

Não disponível na 16.0. Cenário NFE-17.

Nenhum fluxo da 16.0 emite retorno sem recebimento físico: a devolução parte de uma entrada de mercadoria (Emitir a nota de entrada de devolução de venda a consumidor pessoa física, Devolver mercadoria ao fornecedor). A busca no código não encontrou esse caminho. Fonte da pesquisa: caso 3 do fórum Contábeis.

Cenário de nicho (caso do fórum do Contábeis). A orientação fiscal depende do estado, do ICMS cobrado em fronteira e do aceite do remetente, e deve ser confirmada pelo contador.