NF-e no Odoo: como funciona a emissão na prática

Se você vende produtos no Brasil, mais cedo ou mais tarde precisa emitir Nota Fiscal Eletrônica. A NF-e substituiu o talão de papel há mais de uma década, mas o que acontece “por trás” da emissão continua sendo uma caixa-preta para a maioria dos gestores. Este post explica o básico — o que é cada modelo, como o documento viaja até a Receita e volta autorizado, e o que muda quando essa operação roda dentro do Odoo com a localização fiscal da comunidade OCA.

NF-e (modelo 55) e NFC-e (modelo 65): qual é a diferença

São dois documentos da mesma família, com finalidades distintas:

• NF-e (modelo 55) — a nota fiscal de mercadoria “completa”. Usada em vendas para outra empresa (B2B), transferências entre filiais, remessas, devoluções e qualquer operação que precise identificar o destinatário por CNPJ/CPF. Gera o DANFE (o documento auxiliar em papel ou PDF que acompanha a mercadoria).
• NFC-e (modelo 65) — a nota fiscal do consumidor final, que substituiu o antigo cupom fiscal e a impressora ECF. É a nota do balcão, do PDV (ponto de venda), do varejo. Gera o DANFE-NFC-e, geralmente um cupom com QR Code que o cliente pode consultar no site da SEFAZ.

A regra prática: vendeu para quem vai revender ou usar como insumo, é NF-e; vendeu no varejo para o consumidor final na loja, é NFC-e.

O ciclo de emissão: do XML à autorização

Toda nota eletrônica é, na essência, um arquivo XML assinado digitalmente. O fluxo é sempre o mesmo:

1. Geração do XML — o sistema monta o arquivo com emitente, destinatário, produtos, impostos (ICMS, IPI, PIS, COFINS), CFOP, NCM e CST/CSOSN.
2. Assinatura digital — o XML é assinado com o certificado da empresa (mais sobre isso abaixo).
3. Transmissão à SEFAZ — o XML é enviado ao webservice da Secretaria da Fazenda do estado.
4. Validação e autorização — a SEFAZ valida estrutura, impostos e cadastros. Se tudo bate, devolve um protocolo de autorização com a chave de acesso de 44 dígitos.
5. Emissão do DANFE — só depois de autorizada a nota vira o DANFE que acompanha a mercadoria.

Se algo estiver errado (NCM inválido, base de cálculo incoerente, destinatário irregular), a SEFAZ rejeita e devolve um código de erro. A nota não existe legalmente até receber o status “autorizada”.

Certificado digital: a identidade da empresa

A assinatura do XML exige um certificado digital ICP-Brasil. Há dois tipos: o A1 (arquivo instalado no servidor, validade de 1 ano) e o A3 (em token/cartão, exige hardware). Para emissão automatizada em servidor, o A1 é quase sempre a escolha. Tratamos a configuração de cada um em detalhe no post sobre ICP-Brasil A1/A3 no Odoo.

E quando a SEFAZ cai? Contingência

A SEFAZ tem manutenções e indisponibilidades. Para não travar o faturamento, existem os modos de contingência — principalmente o EPEC (evento prévio de emissão em contingência) e a contingência offline para NFC-e, em que a nota é emitida localmente e transmitida assim que o serviço volta. Um sistema fiscal sério precisa tratar contingência sem intervenção manual caótica.

Como o Odoo emite NF-e e NFC-e de forma nativa

Aqui está a diferença que importa para o bolso e para a soberania da operação. Boa parte dos ERPs proprietários no Brasil terceiriza a emissão para um middleware fiscal e cobra por documento emitido — um custo recorrente que cresce com o volume de notas.

No Odoo com a localização fiscal mantida pela comunidade open-source OCA — com a KMEE entre as mantenedoras principais — a emissão é nativa:

• O módulo l10n_br_nfe gera, assina e transmite a NF-e modelo 55 direto para a SEFAZ, dentro do próprio Odoo.
• O módulo l10n_br_pos_nfce integra a NFC-e ao ponto de venda do Odoo, com tratamento de contingência offline.
• Os campos do XML (nfe40_*) são gerados a partir dos XSD oficiais da SEFAZ, o que mantém o sistema aderente ao layout vigente.
• Não há custo por documento cobrado por terceiro: o XML sai do seu Odoo direto para a Receita.

Há um ponto estratégico nisso. Como o código é upstream na OCA, e não um fork fechado, você não fica refém de um único fornecedor. Se quiser trocar de integradora amanhã, qualquer empresa do ecossistema OCA pega de onde a anterior parou. Migrar para a OCA significa, inclusive, não ficar refém da própria KMEE.

Resumindo

A NF-e é um XML assinado, validado e autorizado pela SEFAZ antes de virar DANFE. NF-e (55) é para mercadoria/B2B; NFC-e (65) é para o varejo. Você precisa de certificado ICP-Brasil e de um tratamento de contingência confiável. E, no Odoo com a localização OCA, tudo isso roda nativo, sem mensalidade por nota.

Leituras relacionadas

• Localização Fiscal Brasileira no Odoo — o panorama completo da localização fiscal.
• ICP-Brasil A1/A3 no Odoo — como configurar o certificado digital.
• Manifestação do destinatário (DF-e) no Odoo — o outro lado: quando você recebe NF-e de fornecedores.
• Glossário fiscal — CFOP, CST, CSOSN, NCM e os demais termos.