A1 fiscal certificate management for Brazil
Gestiona los certificados digitales A1 (e-CNPJ y e-NF-e) usados para firmar y transmitir los documentos fiscales electrónicos brasileños.
El módulo no define un modelo propio de certificado: extiende el módulo nativo certificate de Odoo (modelo certificate.certificate), reutilizando el almacenamiento del archivo PKCS#12 (.pfx/.p12), la extracción del certificado y de la clave en PEM, el cálculo de validez y las pantallas del core, y añade lo que es específico de Brasil:
- el ámbito l10n_br ("Brazilian Fiscal"), que identifica los certificados fiscales brasileños y filtra los certificados ofrecidos en los campos de certificado del sistema;
- los campos calculados owner_cnpj_cpf (CNPJ/CPF del titular, leído del subject), issuer_name (emisor) y name (titular y validez);
- el campo certificate_id en la empresa, mostrado en la página "Certificados" de la pestaña Fiscal, que sustituye a los antiguos certificate_nfe_id y certificate_ecnpj_id: ahora cada empresa tiene un único certificado;
- la herencia de certificado entre empresas: una sucursal sin certificado propio usa el de la matriz (campo calculado certificate), lo que es aceptado por la SEFAZ por tener la misma raíz de CNPJ;
- los métodos _get_br_certificate() y _get_br_ecertificate(), punto único de acceso al certificado para firma y transmisión, con validación de vigencia (y del CNPJ, cuando la operación exige un e-CNPJ).
Ese punto único de acceso es usado por los módulos fiscales:
- l10n_br_nfe: firma y transmisión de NF-e y NFC-e, eventos de manifestación del destinatario (MDE) e inutilización de numeración;
- l10n_br_mdfe: firma y transmisión de MDF-e;
- l10n_br_cte: firma y transmisión de CT-e;
- l10n_br_nfe_dfe: distribución de DF-e (consulta de los documentos por NSU);
- l10n_br_nfse: firma y transmisión de NFS-e;
- l10n_br_ie_search: consulta de inscripción estadual en la SEFAZ.
La migración 18.0.2.0.0 convierte automáticamente los certificados registrados en el modelo antiguo (l10n_br_fiscal.certificate) al modelo nativo, preservando el archivo, la contraseña y la empresa que los utilizaba.
Traducción automática al español (DeepSeek) de la descripción original de OCA, que está en inglés.
auto_awesome Qué hace este módulo
Generado por IA a partir del código · Odoo 19.0Permite a las empresas brasileñas almacenar y seleccionar sus certificados digitales A1 (e-CNPJ/e-NF-e) en Odoo, mostrando el CNPJ/CPF del titular y el emisor, y verifica el certificado antes de que se utilice para firmar documentos fiscales.
Este módulo añade el manejo fiscal brasileño a la funcionalidad estándar de certificados de Odoo, de modo que una empresa puede mantener su certificado digital A1 (el archivo usado para firmar y enviar documentos fiscales electrónicos) dentro de Odoo.
Dónde aparece: - Un nuevo menú "Certificates" bajo los menús de configuración fiscal, visible solo para los responsables fiscales, que lista los certificados filtrados por el tipo fiscal brasileño. - Una página "Certificates" en el formulario de la empresa (pestaña Fiscal) donde un responsable elige el certificado de la empresa. - Un ajuste "Certificate expiration alert" (30 días por defecto) en los ajustes generales.
Qué añade: - Los certificados obtienen un tipo "Brazilian Fiscal", y en las empresas brasileñas este tipo viene preseleccionado. - Para los certificados brasileños, el formulario y la lista muestran el CNPJ/CPF del titular (leído del nombre del titular del certificado) y el nombre del emisor, además de la fecha de fin. - El nombre del certificado se construye automáticamente a partir del nombre del titular y la fecha de fin de validez. - Una empresa sin certificado propio usa automáticamente el certificado de su empresa matriz más cercana.
Reglas de negocio: - Antes de firmar o enviar un documento fiscal, Odoo comprueba que existe un certificado y que sigue siendo válido; de lo contrario, bloquea la operación con un mensaje claro. - Algunas operaciones pueden requerir un certificado e-CNPJ (CNPJ de 14 dígitos); otros tipos de certificado se rechazan. - Un certificado caducado también se rechaza con un mensaje que muestra su periodo de validez.
En los datos de demostración, se crean certificados de prueba falsos para las empresas de demostración.
Depende de
Lo necesitan otros módulos
Menús que añade
Modelos y campos (3)
- res.company · amplía un modelo existentecertificate (Certificate in Use), certificate_id (Certificate)
- res.config.settings · amplía un modelo existentecert_expired_alert (Certificate Expired Alert)
- certificate.certificate · amplía un modelo existentename, scope, issuer_name (Issuer), owner_cnpj_cpf (CNPJ/CPF)
Texto generado por IA (DeepSeek) al leer el código de la versión 19.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 6 confirmadas, 3 sin información de 9 versiones.
Fuentes · Odoo 17.0
Confirmado el 2026-11-03 en la rama 17.0 de OCA/l10n-brazil.
terminal Instalación y uso
Documentación de OCA · Odoo 19.0Registro del certificado
- Importe el certificado A1 (archivo
.pfxo.p12) en Fiscal > Configuración > Otros > Certificados, indicando la contraseña del archivo. Para empresas brasileñas el campo "Scope" ya viene rellenado con "Brazilian Fiscal". - En la ficha de la empresa (Configuración > Empresas), pestaña Fiscal, página Certificados, elija el certificado en el campo Certificado (
certificate_id). El certificado también puede crearse directamente desde ese campo.
Cada empresa usa un único certificado. Una sucursal sin certificado propio usa el certificado de la matriz: en ese caso, el campo Certificate in Use (certificate, solo lectura) muestra el certificado que se utilizará.
Uso
El certificado se usa automáticamente para firmar y transmitir los documentos fiscales electrónicos (NF-e, NFC-e y NFS-e), para los eventos de manifestación del destinatario y la inutilización de numeración (NF-e) y para la distribución de DF-e. No es necesario configurar nada en los módulos de cada documento.
La validez se comprueba en cada uso: un certificado vencido impide la firma y la transmisión, con un mensaje de error que indica el periodo de validez del certificado.
Para renovar, importe el nuevo certificado y cambie el campo Certificado de la empresa.
Alerta de expiración
En Configuración, el campo Alerta de Certificado Expirado define la antelación, en días, de la alerta de expiración del certificado (predeterminado: 30 días).
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen. Sin información verificada en OCA: Instalación, Configuración.
Las instrucciones de instalación, el paquete de distribución, las dependencias y los pasos de configuración no se muestran porque todavía no se han verificado en la documentación del módulo para ninguna versión.
Datos importados de GitHub: esta ficha refleja la última revisión del catálogo, no una consulta en directo. Verifica siempre en la documentación del módulo y en staging antes de instalar en producción.