Framework genérico para monitoramento de documentos fiscais eletrônicos recebidos via os web services de Distribuição de DF-e da SEFAZ (Ambiente Nacional).
Este módulo é agnóstico ao tipo de documento fiscal: ele implementa toda a lógica comum de distribuição DF-e — paginação de NSUs, agendamento inteligente baseado na resposta da SEFAZ (138, 137, 656), desduplicação, notificações, logs SOAP e o painel (banner) — parametrizado por tipo de documento (fiscal_type).
Os módulos específicos implementam apenas o que é particular de cada documento fiscal:
Funcionalidades genéricas:
Table of contents
Os módulos específicos declaram suas próprias dependências (ex.: l10n_br_nfe_dfe requer nfelib e brazilfiscalreport).
O queue_job precisa ser carregado na inicialização do Odoo. Adicione na configuração do servidor:
[options] server_wide_modules = web,queue_job
Ou via variável de ambiente:
SERVER_WIDE_MODULES=web,queue_job
Em produção, o Odoo deve rodar com workers > 0 para que o jobrunner inicie como processo dedicado.
Com --workers=0 (modo threaded / desenvolvimento), o queue_job funciona normalmente — ele cria uma thread extra no mesmo processo.
O módulo registra os jobs de distribuição DF-e no canal root.dfe. É obrigatório configurar este canal com capacidade máxima de 1 job simultâneo, caso contrário consultas concorrentes à SEFAZ podem causar erro 656 (consumo indevido) e bloqueio temporário do CNPJ.
No arquivo de configuração do Odoo:
[queue_job] channels = root:2,root.dfe:1
Ou via variável de ambiente:
ODOO_QUEUE_JOB_CHANNELS=root:2,root.dfe:1
A configuração por empresa (ambiente, busca automática, NSU, etc.) é feita nos módulos específicos de cada documento fiscal (ex.: aba NF-e DF-e do módulo l10n_br_nfe_dfe).
Cada usuário pode ativar a preferência DF-e Notification em Preferências para receber notificações no Inbox quando novos documentos de terceiros forem encontrados.
Este módulo é uma base técnica. O uso funcional acontece nos módulos específicos de cada documento fiscal:
O menu Faturamento > Consultas DF-e também dá acesso às visões genéricas (todos os documentos, registros DF-e brutos e logs de distribuição) para depuração.
Bugs are tracked on GitHub Issues. In case of trouble, please check there if your issue has already been reported. If you spotted it first, help us to smash it by providing a detailed and welcomed feedback.
Do not contact contributors directly about support or help with technical issues.
This module is maintained by the OCA.
OCA, or the Odoo Community Association, is a nonprofit organization whose mission is to support the collaborative development of Odoo features and promote its widespread use.
Current maintainers:
This module is part of the OCA/l10n-brazil project on GitHub.
You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.