OdooWiki OCA HUB

Fiscal Queue

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

Este módulo permite transmitir documentos fiscales electrónicos (NF-e, NFC-e, etc.) a la SEFAZ de forma asíncrona, a través de queue_job.

Sin él, la transmisión a la SEFAZ ocurre en la misma transacción de la acción del usuario: la petición queda bloqueada durante todo el ida y vuelta con el webservice de la SEFAZ, que puede llevar de unos segundos a más de un minuto en picos o indisponibilidad del organismo. Esto retiene un worker HTTP y degrada la respuesta para todos los usuarios.

Con este módulo, la operación fiscal puede configurarse para encolar la transmisión: la acción del usuario retorna inmediatamente y el envío a la SEFAZ se ejecuta en un worker de queue_job, fuera del camino de la petición.

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 16.0

Te permite elegir, por operación fiscal, si los documentos fiscales electrónicos (NF-e, NFC-e, etc.) se envían a SEFAZ de inmediato o se ponen en cola en segundo plano, para que la pantalla del usuario no se bloquee mientras espera a la autoridad fiscal.

Este módulo añade una opción en cada operación fiscal: enviar el documento fiscal a SEFAZ de inmediato, o enviarlo más tarde a través de la cola de trabajos en segundo plano. El ajuste se llama "Transmission moment" y aparece en el formulario de operación fiscal, justo después del campo document purpose.

Cuando una operación fiscal está configurada como "Send Later", pulsar la acción de envío en un documento fiscal ya no espera al servicio web de SEFAZ. El documento conserva su estado actual y se crea un trabajo en segundo plano para realizar la transmisión fuera de la petición del usuario. El trabajo se ejecuta en un canal dedicado llamado "edocument".

  • Si el documento no está en un estado enviable (open, rejected o sending), el trabajo en segundo plano no hace nada y simplemente registra que no hay nada que transmitir.
  • Los documentos cuya operación está configurada como "Send Immediately" siguen transmitiéndose de forma síncrona, exactamente como antes.
  • Cuando se seleccionan varios documentos a la vez, el módulo los separa: los configurados para más tarde van a la cola, el resto se envían de inmediato.

El módulo extiende los modelos de documento fiscal y operación fiscal y añade el nuevo campo al formulario de operación fiscal existente. Se apoya en los módulos queue_job y l10n_br_fiscal_edi.

Modelos y campos (2)
  • l10n_br_fiscal.document · amplía un modelo existente
  • l10n_br_fiscal.operation · amplía un modelo existentequeue_document_send (Transmission moment)

Texto generado por IA (DeepSeek) al leer el código de la versión 16.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: 1 confirmada, 8 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 16.0

Este módulo depende de l10n_br_fiscal_edi (flujo de emisión de documentos fiscales en la serie 16.0) y de queue_job.

En cada operación fiscal (Fiscal / Configuración / Operaciones Fiscales), el campo Momento de la transmisión (queue_document_send) define el comportamiento de envío de los documentos generados por esa operación:

  • Send Immediately (predeterminado): transmite a la SEFAZ en la misma transacción (síncrono), preservando el comportamiento original.
  • Send Later: encola la transmisión como un queue_job, en el canal root.edocument.

El queue_job necesita estar con el job runner activo para que los jobs encolados sean procesados. Consulte la documentación del queue_job para configurar el runner y los canales.

Al confirmar y enviar un documento fiscal cuya operación está configurada como Send Later, la transmisión a la SEFAZ se encola en lugar de ejecutarse al momento. El documento permanece en el estado Aguardando envio hasta que el job sea procesado por el queue_job; concluida la transmisión, el estado avanza normalmente (autorizada, rechazada, etc.), como en el envío síncrono.

Los jobs encolados pueden ser acompañados en Job Queue / Jobs, en el canal root.edocument.

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.