Odoo Community Association

A1 fiscal certificate management for Brazil

Production/Stable License: AGPL-3 OCA/l10n-brazil Translate me on Weblate Try me on Runboat

Gerencia os certificados digitais A1 (e-CNPJ e e-NF-e) usados para assinar e transmitir os documentos fiscais eletrônicos brasileiros.

O módulo não define um modelo próprio de certificado: ele estende o módulo nativo certificate do Odoo (modelo certificate.certificate), reaproveitando o armazenamento do arquivo PKCS#12 (.pfx/.p12), a extração do certificado e da chave em PEM, o cálculo de validade e as telas do core, e acrescenta o que é específico do Brasil:

Esse ponto único de acesso é usado pelos módulos fiscais:

A migração 18.0.2.0.0 converte automaticamente os certificados cadastrados no modelo antigo (l10n_br_fiscal.certificate) para o modelo nativo, preservando o arquivo, a senha e a empresa que os utilizava.

Table of contents

Usage

Cadastro do certificado

  1. Importe o certificado A1 (arquivo .pfx ou .p12) em Fiscal > Configuração > Outros > Certificados, informando a senha do arquivo. Para empresas brasileiras o campo “Scope” já vem preenchido com “Brazilian Fiscal”.
  2. Na ficha da empresa (Configurações > Empresas), aba Fiscal, página Certificados, escolha o certificado no campo Certificado (certificate_id). O certificado também pode ser criado direto por esse campo.

Cada empresa usa um único certificado. Uma filial sem certificado próprio usa o certificado da matriz: nesse caso, o campo Certificate in Use (certificate, somente leitura) mostra o certificado que será utilizado.

Uso

O certificado é usado automaticamente para assinar e transmitir os documentos fiscais eletrônicos (NF-e, NFC-e e NFS-e), para os eventos de manifestação do destinatário e a inutilização de numeração (NF-e) e para a distribuição de DF-e. Não é preciso configurar nada nos módulos de cada documento.

A validade é conferida a cada uso: um certificado vencido impede a assinatura e a transmissão, com uma mensagem de erro indicando o período de validade do certificado.

Para renovar, importe o novo certificado e troque o campo Certificado da empresa.

Alerta de expiração

Em Configurações, o campo Alerta de Certificado Expirado define a antecedência, em dias, do alerta de expiração do certificado (padrão: 30 dias).

Changelog

18.0.2.0.0 (2026)

Reaproveitamento do módulo nativo certificate: o modelo próprio l10n_br_fiscal.certificate foi substituído por uma extensão de certificate.certificate e os campos certificate_nfe_id e certificate_ecnpj_id da empresa por um único certificate_id. Os campos type e subtype (NF-e / e-CNPJ) deixaram de existir: agora a empresa tem um único certificado, marcado com o escopo l10n_br. Uma migração converte os certificados existentes para o modelo nativo.

14.0.1.0.0 (2023)

Primeira versão do módulo: o código vinha sendo desenvolvido desde a versão 8 mas estava integrado dentro módulo l10n_br_fiscal. O código foi extraído para deixar o módulo l10n_br_fiscal mais leve.

Bug Tracker

Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.

Do not contact contributors directly about support or help with technical issues.

Credits

Authors

  • Akretion

Maintainers

This module is maintained by the OCA.

Odoo Community Association

OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.

Current maintainer:

renatonlima

This module is part of the OCA/l10n-brazil project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.