Framework genérico para el monitoreo de documentos fiscales electrónicos recibidos a través de los web services de Distribución de DF-e de la SEFAZ (Ambiente Nacional).
Este módulo es agnóstico al tipo de documento fiscal: implementa toda la lógica común de distribución DF-e — paginación de NSUs, programación inteligente basada en la respuesta de la SEFAZ (138, 137, 656), desduplicación, notificaciones, logs SOAP y el panel (banner) — parametrizado por tipo de documento (fiscal_type).
Los módulos específicos implementan únicamente lo que es particular de cada documento fiscal:
- l10n_br_nfe_dfe — DF-e de NF-e (NFeDistribuicaoDFe, NT 2014.002)
- l10n_br_cte_dfe — DF-e de CT-e (CTeDistribuicaoDFe) — futuro
Funcionalidades genéricas:
- Motor de distribución en res.company, parametrizado por fiscal_type (campos {fiscal_type}_last_nsu, {fiscal_type}_max_nsu, {fiscal_type}_dfe_last_query, etc. definidos por los módulos específicos)
- Modelos genéricos: l10n_br_fiscal_dfe.dfe (payload XML por NSU) y l10n_br_fiscal_dfe.document (documento agrupado por clave de acceso)
- Consulta manual — asistente de búsqueda específica por clave de acceso (con validación del dígito verificador) o por NSU
- Panel (banner) genérico — componente Owl DfeBanner, alimentado por res.company.dfe_get_banner_data(fiscal_type), mostrado en las listas de los módulos específicos mediante la js_class dfe_document_list
- Notificaciones en el Inbox — notifica a los usuarios sobre nuevos documentos de terceros (preferencia por usuario)
- Matching automático de socio por el CNPJ de la clave de acceso
- Log de distribución con request/response SOAP para depuración
- Soporte multiempresa con record rules
- Canal queue_job root.dfe para las consultas automáticas
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 18.0Monitoriza los documentos fiscales electrónicos brasileños entrantes (DF-e) recibidos de SEFAZ, almacenándolos en una bandeja de entrada donde los usuarios pueden verlos, descargar los XML, emparejar contactos e importarlos. Añade un banner en la lista de documentos con el estado de la consulta y botones para buscar todos los documentos o documentos específicos.
Este módulo proporciona el motor compartido para obtener documentos fiscales electrónicos (DF-e) desde el servicio web de distribución de la SEFAZ. Es agnóstico al tipo de documento y funciona para NF-e y CT-e.
Los usuarios obtienen una nueva área de menú con tres listas: Documentos de terceros (la bandeja de entrada de documentos recibidos), Registros DF-e (cada payload sin procesar recibido, con NSU, tipo, evento y XML formateado) y Registros de distribución (solicitud/respuesta SOAP y mensajes).
En la lista de documentos, un banner muestra la última consulta, la próxima consulta programada, el último estado, el progreso del NSU, si el NSU está sincronizado, el recuento de terceros de hoy, las importaciones pendientes y una advertencia de inactividad. Desde él, los usuarios pueden lanzar una búsqueda completa o abrir un asistente para buscar un documento específico por clave de acceso o NSU.
Reglas de negocio: los documentos se deduplican por NSU o clave de acceso; la próxima consulta se programa automáticamente según el código de estado de la SEFAZ (éxito, sin documentos, límite de tasa, error); un tiempo de espera bloquea las búsquedas manuales demasiado pronto; el CNPJ de la empresa se compara con la clave de acceso para marcar los documentos propios; el partner se empareja por CNPJ; y los usuarios que han optado por recibirlas reciben notificaciones en la bandeja de entrada para los nuevos documentos de terceros. Un trabajo programado ejecuta la distribución automáticamente para las empresas con la obtención automática habilitada. Los usuarios pueden descargar un único XML o un zip de XMLs completos, e importar o generar PDFs a través de los módulos específicos del tipo de documento.
Depende de
Lo necesitan otros módulos
Menús que añade
Modelos y campos (6)
- res.users · amplía un modelo existentedfe_notification (DF-e Notification)
- res.company · amplía un modelo existente
- l10n_br_fiscal_dfe.dfe · modelo nuevonsu (NSU), access_key, company_id (Company), xml_pretty (XML Pretty), fiscal_type, schema_type, attachment_id, event_type_dfe (Event Type), operation_type, dfe_document_id (DF-e Document), document_type_dfe (DF-e Type), event_type_dfe_label (Event)
- dfe.specific.search.wizard · modelo nuevonsu (NSU), access_key, company_id (Company), fiscal_type, search_type
- l10n_br_fiscal_dfe.document · modelo nuevovat (CNPJ/CPF), serie, dfe_ids (DF-e records), emitter, access_key, company_id, partner_id (Partner), currency_id, fiscal_type, color_status, document_state (State Code), document_amount (Document Total Value), document_number, is_own_document (Own Document), fiscal_document_id (Fiscal Document), document_state_label (State), document_emission_date (Emission Date)
- l10n_br_fiscal_dfe.distribution_log · modelo nuevomessage, log_type, company_id, fiscal_type, request_xml (SOAP Request), response_xml (SOAP Response)
Texto generado por IA (DeepSeek) al leer el código de la versión 18.0 en GitHub; puede contener errores, así que verifícalo en el código antes de decidir. El módulo es muy grande y solo se ha leído una parte del código. Ver el código en GitHub
Disponibilidad por versión
Revisado: 2026-11-03Estado de confirmación: 5 confirmadas, 4 sin información de 9 versiones.
Fuentes · Odoo 18.0
Confirmado el 2026-11-03 en la rama 18.0 de OCA/l10n-brazil.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Instalación
Fuente · Odoo 18.0Dependencias Python
erpbrasil.base— validación de clave de acceso (dígito verificador)
Los módulos específicos declaran sus propias dependencias (ej.: l10n_br_nfe_dfe requiere nfelib y brazilfiscalreport).
queue_job como server wide module
El queue_job debe cargarse en el inicio de Odoo. Añada en la configuración del servidor:
[options]
server_wide_modules = web,queue_jobO mediante variable de entorno:
SERVER_WIDE_MODULES=web,queue_jobEn producción, Odoo debe ejecutarse con workers > 0 para que el jobrunner se inicie como proceso dedicado.
Con --workers=0 (modo threaded / desarrollo), el queue_job funciona normalmente — crea un hilo extra en el mismo proceso.
Configuración
Fuente · Odoo 18.0Canal queue_job
El módulo registra los jobs de distribución DF-e en el canal root.dfe. Es obligatorio configurar este canal con capacidad máxima de 1 job simultáneo, de lo contrario las consultas concurrentes a la SEFAZ pueden causar el error 656 (consumo indebido) y el bloqueo temporal del CNPJ.
En el archivo de configuración de Odoo:
[queue_job]
channels = root:2,root.dfe:1O mediante variable de entorno:
ODOO_QUEUE_JOB_CHANNELS=root:2,root.dfe:1Configuración de la empresa
La configuración por empresa (entorno, búsqueda automática, NSU, etc.) se realiza en los módulos específicos de cada documento fiscal (ej.: pestaña NF-e DF-e del módulo l10n_br_nfe_dfe).
Notificaciones
Cada usuario puede activar la preferencia DF-e Notification en Preferencias para recibir notificaciones en el Inbox cuando se encuentren nuevos documentos de terceros.
Este módulo es una base técnica. El uso funcional ocurre en los módulos específicos de cada documento fiscal:
- NF-e: instale
l10n_br_nfe_dfey acceda a Facturación > Consultas DF-e > NF-e de Terceros.
El menú Facturación > Consultas DF-e también da acceso a las vistas genéricas (todos los documentos, registros DF-e brutos y logs de distribución) para depuración.
Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.
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.