OdooWiki OCA HUB

Monitor de NF-e

l10n_br_nfe_dfe folder_open OCA/l10n-brazil open_in_new
Sin categoría Licencia: AGPL-3

Monitor de NF-e (Distribuição de DFe)

Este módulo implementa la funcionalidad de monitoreo, descarga y procesamiento automático de Notas Fiscais Eletrônicas (NF-e, modelo 55) emitidas contra el CNPJ de su empresa. Opera conectándose directamente al Web Service de Distribuição de DF-e de la SEFAZ (Ambiente Nacional).

Este módulo extiende el framework abstracto genérico l10n_br_fiscal_dfe e incorpora las necesidades y especificidades exclusivas aplicadas a la Nota Fiscal Eletrônica (como Manifestação do Destinatário y los schemas XML de la NF-e).

Principales Funcionalidades

  • Consulta Automática (Polling): Tarea programada (Cron) que consulta periódicamente el servicio de la SEFAZ, garantizando que usted tenga acceso rápido a todas las NF-es emitidas contra su CNPJ sin necesidad de solicitar el archivo al proveedor.
  • Procesamiento Especializado: Identifica y separa los payloads descargados en sus debidos formatos: XMLs Completos con protocolo (procNFe), Resumos da NF-e (resNFe) y Eventos da Nota Fiscal (resEvento / procEventoNFe).
  • Manifestação do Destinatário (MD-e): Funcionalidad nativa para acusar el recibo o rechazo de la NF-e ante la SEFAZ:
  • Ciência da Operação: Confirmación previa para liberar la descarga del XML completo.
  • Confirmação da Operação.
  • Desconhecimento da Operação.
  • Operação não Realizada.
  • Manifestação Automática: Opción para que Odoo aplique el evento de "Ciência da Operação" instantánea y automáticamente a todas las nuevas notas resumidas identificadas, acelerando el recibo del archivo completo para importación.
  • Importação Inteligente: Botón de acción que convierte instantáneamente el XML válido descargado en un borrador de Documento Fiscal estándar de Odoo (l10n_br_fiscal.document), pre-poblando los impuestos, CFOPs, emisores y destinatarios.
  • Geração de DANFE: Generación del documento PDF del DANFE utilizando la biblioteca brazilfiscalreport.
  • Notificações: Notifica a los usuarios suscritos, directamente en el inbox de Odoo, en caso de que nuevas NF-es emitidas por terceros sean detectadas en el servidor de la Receita Federal.

Este módulo es implementado en estricta conformidad con la Nota Técnica 2014.002 v1.30.

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.0

Descarga automáticamente las facturas entrantes de NF-e (modelo 55) emitidas contra el CNPJ de tu empresa desde el servicio nacional de distribución de la SEFAZ, y te permite ver, importar, imprimir el DANFE y enviar manifestaciones del destinatario desde Odoo.

Este módulo conecta Odoo con el servicio web de distribución DF-e de SEFAZ para que las facturas NF-e emitidas contra el CNPJ de tu empresa se obtengan automáticamente, sin pedir el XML a los proveedores.

Dónde aparece: - Un nuevo menú "NF-e de Terceiros" (bajo el menú raíz DF-e) lista los documentos NF-e entrantes con fecha, clave de acceso, emisor, CNPJ, importe, CFOPs, estado de manifestación y estado. - En cada documento tienes botones: XML (descargar), DANFE (generar el PDF), Import (crear el documento fiscal a partir del XML), Invoice (abrir el documento creado) y Manifest (enviar una manifestación del receptor). - Los ajustes de la empresa incorporan una página "NF-e DF-e" con la versión de DF-e, las opciones de obtención automática y manifestación automática, además del último/máximo NSU, la fecha de la última consulta, el último estado y la próxima consulta programada.

Comportamiento automático: - Un trabajo programado se ejecuta cada 5 minutos para consultar al servicio de distribución si hay nuevos documentos NF-e. - Cuando llega un documento resumen y está habilitada la "Automatic Recipient Manifestation", se crea y confirma un evento Ciência en segundo plano; confirmar un Ciência reprograma la siguiente consulta poco después, de modo que se recupera el XML completo. - El estado del documento se muestra con etiquetas de NF-e (Autorizada, Denegada, Cancelada) y los CFOPs se leen del XML completo.

Extiende el documento DF-e, el evento de manifestación de NF-e y los ajustes de la empresa, y se apoya en el framework genérico de DF-e.

Depende de

l10n_br_fiscal_dfel10n_br_nfe

Lo necesitan otros módulos

l10n_br_fiscal_dfe_mock

Menús que añade

NF-e de Terceiros
Modelos y campos (3)
  • res.company · amplía un modelo existentenfe_max_nsu (NF-e Max NSU), nfe_last_nsu (NF-e Last NSU), nfe_auto_fetch (Auto-fetch NF-e DF-e), nfe_dfe_version (NF-e DF-e Version), auto_manifest_nfe (Automatic Recipient Manifestation (NF-e)), nfe_dfe_last_query (NF-e DF-e Last Query), nfe_dfe_next_query (NF-e Next Scheduled Query), nfe_dfe_last_status (NF-e DF-e Last Status), nfe_dfe_last_status_code (NF-e DF-e Last Status Code)
  • l10n_br_nfe.md_event · amplía un modelo existentedfe_document_id (DF-e Document)
  • l10n_br_fiscal_dfe.document · amplía un modelo existentecfop_ids (CFOPs), manifestations_ids (Manifestations), manifestation_status

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. Ver el código en GitHub

Disponibilidad por versión

Revisado: 2026-11-03
Confirmado (verificado en repositorio y rama) Estimado (sin verificar) Sin información

Estado de confirmación: 3 confirmadas, 6 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.0

Instalación

Fuente · Odoo 18.0

Este módulo requiere los siguientes componentes y dependencias para funcionar correctamente:

  • Dependencias Odoo:
  • l10n_br_fiscal_dfe (El framework de distribución abstracto de la OCA)
  • l10n_br_nfe (El módulo base de emisión y gestión de modelos de la NF-e)
  • queue_job (Siempre requerido por el framework base para agendamientos y llamadas asíncronas)
  • Dependencias Python:
  • nfelib: La biblioteca moderna que consolida los bindings y clientes de comunicación para NF-e/CT-e/MDF-e.
  • brazilfiscalreport: Necesaria para realizar el parse del XML y dibujar la salida en formato PDF (DANFE).

Para instalar las bibliotecas de sistema Python:

pip install nfelib brazilfiscalreport

Configuración Pre-Requisito Obligatoria

La SEFAZ bloquea y rechaza las llamadas a los Web Services en caso de que su empresa no esté perfectamente configurada en Odoo. Antes de ejecutar las consultas:

  • Acceda al registro de Empresas y complete correctamente el Estado (UF) y el CNPJ/CPF (solamente numéricos o formateado).
  • En la pestaña Fiscal -> Certificados, realice la carga y valide el Certificado Digital A1 con la contraseña correcta. Este certificado será utilizado activamente por el módulo para el intercambio de claves con el Ambiente Nacional de la SEFAZ.

Configuración

Fuente · Odoo 18.0

Cola 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 consultas concurrentes a la SEFAZ pueden causar error 656 (consumo indebido) y bloqueo temporal del CNPJ.

En el archivo de configuración de Odoo:

[queue_job]
channels = root:2,root.dfe:1

O mediante variable de entorno:

ODOO_QUEUE_JOB_CHANNELS=root:2,root.dfe:1

Configuración de la empresa

En Facturación > Configuración > Empresas, en la pestaña Fiscal > DF-e (Configuraciones DF-e):

  • Versión DF-e: versión del servicio (predeterminado: 1.01)
  • Ambiente DF-e: Producción o Homologación
  • Búsqueda automática de DF-e: habilita la consulta automática vía cron
  • Manifestación Automática del Destinatario (NF-e): envía ciencia de la operación automáticamente para cada resumen de NF-e recibido

La empresa necesita tener un certificado digital A1 configurado en el módulo l10n_br_fiscal_certificate.

Notificación de documentos (por usuario)

En Preferencias del Usuario, el campo Notificación DF-e habilita la recepción de notificaciones en la bandeja de entrada cuando nuevos documentos de terceros son encontrados por la distribución DF-e.

Uso

Fuente · Odoo 18.0

Configuración

Para habilitar la búsqueda y el procesamiento automático de notas:

  • Acceda a Configuración > Usuarios y Empresas > Empresas.
  • Abra el registro de su empresa y localice la pestaña o sección NF-e DF-e.
  • Marque la opción Auto-fetch NF-e para que Odoo realice las consultas periódicas de forma programada en background.
  • Opcionalmente, active la Manifestación Automática si desea que el sistema registre el evento de "Ciencia de la Operación" automáticamente tan pronto como la SEFAZ alerte sobre la existencia de una nota nueva. Esto acelera significativamente la liberación del XML completo para descarga.

Panel de Control (Dashboard)

Acceda a la vista principal navegando por Facturación > Fiscal > Consultas DF-e > NF-e de Terceros.

En la parte superior del listado, el sistema muestra un panel de estado en tiempo real de su comunicación con la SEFAZ:

  • Estado del Entorno: Indica si está operando en Producción o Homologación.
  • Progreso del NSU: Muestra la numeración en la que se encuentra su Odoo (Último NSU) comparado con el NSU máximo registrado en la base de la Receita Federal para su CNPJ. Cuando los números se igualan, se muestra la etiqueta verde "Sincronizado".
  • Importaciones Pendientes: Un contador de alerta que muestra cuántas notas completas ya fueron descargadas en XML, pero aún no fueron efectivamente importadas como Documentos Fiscales en Odoo.

Flujo de Trabajo y Acciones Disponibles

Al hacer clic en un documento del listado, podrá identificar su situación a través de los colores (Azul para Resumen, Verde para XML Completo). El flujo estándar permite las siguientes acciones:

  • Manifestar: Botón que abre el asistente para que usted envíe oficialmente un evento a la SEFAZ (Ciencia, Confirmación, Desconocimiento u Operación No Realizada). Recuerde: por reglas de la SEFAZ, el XML completo con validez jurídica (procNFe) solo se libera para descarga tras una manifestación de Ciencia o Confirmación.
  • Importar como Documento Fiscal: Disponible solo cuando el XML completo ya fue descargado. Este botón convierte el XML inmediatamente en un registro de l10n_br_fiscal.document, rellenando automáticamente los proveedores, CFOPs y valores para su uso en los módulos de compras y stock.
  • Download PDF: Utiliza los datos del XML para generar y descargar el archivo PDF del DANFE.
  • Búsqueda Específica: En el panel superior de los listados, encontrará el asistente de búsqueda específica. Permite saltar el secuencial de NSU y forzar la solicitud puntual de una NF-e utilizando únicamente su Chave de Acesso (44 dígitos), ideal para notas de recepción urgente.

Traducción automática al español (DeepSeek) de la documentación original de OCA; los comandos y el código no se traducen.

info

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.