Monitor nacional de NFS-e (Distribuição DF-e)
Este módulo descarga las NFS-e nacionales emitidas contra el CNPJ de la empresa mediante la API de distribución del ADN (Ambiente de Datos Nacional) y las coloca en la misma bandeja de entrada del monitor de DF-e.
La NF-e continúa en el webservice SOAP NFeDistribuicaoDFe. La NFS-e nacional usa un cliente REST con certificado digital (mTLS) y no pasa por ese flujo.
Principales funcionalidades
- Consulta por NSU en GET /contribuintes/DFe/{NSU}, con paginación del lote.
- Grabación en l10n_br_fiscal_dfe.document y l10n_br_fiscal_dfe.dfe, con el tipo fiscal nfse.
- Notas completas y eventos. La cancelación actualiza la situación del documento ya recibido.
- Importación del XML nacional como documento fiscal de servicio (modelo SE), con una línea de servicio.
- Cron y canal queue_job reutilizados por el motor genérico de DF-e.
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.0Descarga automáticamente las facturas de servicio nacionales NFS-e emitidas contra el CNPJ de tu empresa desde la API de distribución de ADN y las coloca en la misma bandeja de entrada DF-e utilizada para otros documentos fiscales, donde puedes importarlas como documentos fiscales de servicio o generar un PDF DANFSE.
Este módulo añade la NFS-e nacional (facturas de servicios) al monitor DF-e existente. En lugar de recibir solo NF-e, la empresa ahora también puede obtener las NFS-e emitidas contra su CNPJ desde el entorno nacional ADN.
Dónde aparece en Odoo: - Un nuevo menú "NFS-e de terceros" bajo la raíz del monitor DF-e, que lista los documentos NFS-e recibidos. - Nuevos campos en el formulario de la empresa: entorno ADN de NFS-e (producción o producción restringida), último/máximo NSU, fecha y estado de la última consulta, próxima consulta programada, un interruptor "Obtener NFS-e automáticamente" y un producto de servicio predeterminado usado al importar. - Una tarea programada "DF-e - Buscar documentos NFS-e" que consulta el ADN periódicamente cuando la obtención automática está habilitada.
Qué hace automáticamente: - Consulta el ADN por lotes según el NSU, respetando los límites de frecuencia y programando la siguiente consulta. - Almacena las notas y los eventos en la bandeja de entrada DF-e, marcando el tipo fiscal como NFS-e. - Vincula cada documento con un partner existente por CNPJ y marca los documentos emitidos por la propia empresa. - Cuando llega un evento de cancelación, cambia la situación del documento a cancelado, independientemente del orden de llegada. - Registra el resultado de cada consulta y notifica a los usuarios sobre los documentos recién recibidos.
En una NFS-e recibida puede importar el XML mediante el asistente de importación, que crea un documento fiscal de servicio (modelo SE) con una línea de servicio y copia del XML los importes de ISS, IBS, CBS, PIS/COFINS y retenciones. También puede generar el PDF DANFSE a partir del XML completo.
Lo necesitan otros módulos
Menús que añade
Modelos y campos (8)
- res.company · amplía un modelo existentenfse_max_nsu (NFS-e Max NSU), nfse_last_nsu (NFS-e Last NSU), nfse_auto_fetch (Auto-fetch NFS-e), nfse_dfe_last_query (NFS-e DF-e Last Query), nfse_dfe_next_query (NFS-e Next Scheduled Query), nfse_dfe_environment (NFS-e ADN Environment), nfse_dfe_last_status (NFS-e DF-e Last Status), nfse_import_product_id (Default NFS-e Import Product), nfse_dfe_last_status_code (NFS-e DF-e Last Status Code)
- l10n_br_fiscal_dfe.dfe · amplía un modelo existentefiscal_type
- l10n_br_fiscal.document · amplía un modelo existente
- dfe.specific.search.wizard · amplía un modelo existentefiscal_type
- l10n_br_fiscal_dfe.document · amplía un modelo existentefiscal_type
- l10n_br_fiscal.document.line · amplía un modelo existente
- l10n_br_fiscal_dfe.distribution_log · amplía un modelo existentefiscal_type
- l10n_br_fiscal.document.import.wizard · amplía un modelo existenteproduct_id (Service Product)
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: 2 confirmadas, 7 sin información de 9 versiones.
Fuentes · Odoo 16.0
Confirmado el 2026-11-03 en la rama 16.0 de OCA/l10n-brazil.
terminal Instalación y uso
Documentación de OCA · Odoo 18.0Instalación
Fuente · Odoo 18.0Este módulo depende de:
l10n_br_fiscal_dfel10n_br_nfsel10n_br_fiscal_certificatequeue_job(exigido por el motor de DF-e)
Bibliotecas Python: nfelib (>= 3.2.0) consulta el lote y los eventos en el ADN. requests y cryptography continúan en la lectura de la nota por clave en la Sefin Nacional.
La empresa necesita un certificado e-CNPJ A1 válido, el mismo ya utilizado por la localización fiscal.
Configuración
Fuente · Odoo 18.0Cola de trabajos channel_job
La distribución reutiliza el canal root.dfe ya registrado por l10n_br_fiscal_dfe. Mantenga la capacidad de ese canal en 1 job simultáneo para no disparar el límite de solicitudes del ADN (HTTP 429).
[queue_job]
channels = root:2,root.dfe:1Empresa
En Facturación > Configuración > Empresas, pestaña Fiscal > NFS-e DF-e:
- Entorno ADN: Producción o Producción restringida. El valor predeterminado es producción restringida. Este campo no es el entorno
1/2de la emisión municipal. - Búsqueda automática: activa el cron que llama a
_cron_dfe_search_documents('nfse'). - Producto predeterminado de importación: producto de servicio rellenado en el asistente cuando se importa la NFS-e.
- Último NSU: cursor de la próxima consulta. Puede ajustarse para reprocesar desde un punto.
El certificado e-CNPJ se encuentra en la configuración fiscal ya existente.
Bandeja de entrada
Acceda a Facturación > Fiscal > Consultas DF-e > Third-party NFS-e.
El listado muestra las NFS-e en las que la empresa es tomadora. El último NSU, la próxima consulta y el entorno quedan en la empresa, en la pestaña Fiscal > NFS-e DF-e.
En cada documento:
- XML: descarga el archivo nacional recibido del ADN.
- Importar: abre el asistente de importación con el XML completo. El asistente crea un
l10n_br_fiscal.documentdel tipoSE(entrada), con el prestador como emisor y una línea de servicio. Si el prestador aún no existe, se crea en la confirmación a partir delprestde la DPS (elemitsolo completa datos cuando el CNPJ es el mismo). El producto y la operación fiscal pueden ajustarse antes de confirmar. Sil10n_br_accountestá instalado, la confirmación existente del asistente genera la factura de proveedor.
La búsqueda específica acepta la clave de acceso de 50 dígitos o un NSU. La nota se consulta en la Sefin Nacional y los eventos en el ADN. No hay manifestación del destinatario en este flujo: la NFS-e nacional ya llega con el XML de la nota.
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.