A1 fiscal certificate management for Brazil
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:
o escopo l10n_br (“Brazilian Fiscal”), que identifica os certificados fiscais brasileiros e filtra os certificados oferecidos nos campos de certificado do sistema;
os campos calculados owner_cnpj_cpf (CNPJ/CPF do titular, lido do subject), issuer_name (emissor) e name (titular e validade);
o campo certificate_id na empresa, exibido na página “Certificados” da aba Fiscal, que substitui os antigos certificate_nfe_id e certificate_ecnpj_id: agora cada empresa tem um único certificado;
a herança de certificado entre empresas: uma filial sem certificado próprio usa o da matriz (campo calculado certificate), o que é aceito pela SEFAZ por terem a mesma raiz de CNPJ;
os métodos _get_br_certificate() e _get_br_ecertificate(), ponto único de acesso ao certificado para assinatura e transmissão, com validação de vigência (e do CNPJ, quando a operação exige um e-CNPJ).
Esse ponto único de acesso é usado pelos módulos fiscais:
l10n_br_nfe: assinatura e transmissão de NF-e e NFC-e, eventos de manifestação do destinatário (MDE) e inutilização de numeração;
l10n_br_mdfe: assinatura e transmissão de MDF-e;
l10n_br_cte: assinatura e transmissão de CT-e;
l10n_br_nfe_dfe: distribuição de DF-e (consulta dos documentos por NSU);
l10n_br_nfse: assinatura e transmissão de NFS-e;
l10n_br_ie_search: consulta de inscrição estadual na SEFAZ.
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
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”.
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
Contributors
-
Renato Lima <renato.lima@akretion.com.br>
Raphaël Valyi <raphael.valyi@akretion.com.br>
KMEE:
Luis Felipe Mileo <mileo@kmee.com.br>
-
Antônio Neto <netosjb@yahoo.com.br>
Maintainers
This module is maintained by the OCA.
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:
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.
1 maintainer
Release files for odoo-addon-l10n-br-fiscal-certificate 18.0.2.0.0.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| odoo_addon_l10n_br_fiscal_certificate-18.0.2.0.0.7-py3-none-any.whl | Python 3 | none | any | Details |
Release files / odoo_addon_l10n_br_fiscal_certificate-18.0.2.0.0.7-py3-none-any.whl
| Download URL | odoo_addon_l10n_br_fiscal_certificate-18.0.2.0.0.7-py3-none-any.whl |
|---|---|
| Size | 44.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
00ca802ef148771e4b22b3f83c641f36c469bea12ccec712d5f41468c439594d
|
|
BLAKE2b-256 checksum How to use checksums |
0ed2033a26613de86e7829943ded14037be63012fc538a2161583bc8e849b24c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
