Monitor de NFS-e
Monitor de NFS-e nacional (Distribuição DF-e)
Este módulo baixa as NFS-e nacionais emitidas contra o CNPJ da empresa pela API de distribuição do ADN (Ambiente de Dados Nacional) e as coloca na mesma caixa de entrada do monitor de DF-e.
A NF-e continua no webservice SOAP NFeDistribuicaoDFe. A NFS-e nacional usa um cliente REST com certificado digital (mTLS) e não passa por esse fluxo.
Principais funcionalidades
Consulta por NSU em GET /contribuintes/DFe/{NSU}, com paginação do lote.
Gravação em l10n_br_fiscal_dfe.document e l10n_br_fiscal_dfe.dfe, com o tipo fiscal nfse.
Notas completas e eventos. O cancelamento atualiza a situação do documento já recebido.
Importação do XML nacional como documento fiscal de serviço (modelo SE), com uma linha de serviço.
Cron e canal queue_job reutilizados pelo motor genérico de DF-e.
Table of contents
Installation
Este módulo depende de:
l10n_br_fiscal_dfe
l10n_br_nfse
l10n_br_fiscal_certificate
queue_job (exigido pelo motor de DF-e)
Bibliotecas Python: nfelib (>= 3.2.0) consulta o lote e os eventos no ADN. requests e cryptography continuam na leitura da nota por chave na Sefin Nacional.
A empresa precisa de um certificado e-CNPJ A1 válido, o mesmo já utilizado pela localização fiscal.
Configuration
Canal queue_job
A distribuição reutiliza o canal root.dfe já registrado por l10n_br_fiscal_dfe. Mantenha a capacidade desse canal em 1 job simultâneo para não disparar o limite de requisições do ADN (HTTP 429).
[queue_job]
channels = root:2,root.dfe:1
Empresa
Em Faturamento > Configuração > Empresas, aba Fiscal > NFS-e DF-e:
Ambiente ADN: Produção ou Produção restrita. O padrão é produção restrita. Este campo não é o ambiente 1/2 da emissão municipal.
Busca automática: liga o cron que chama _cron_dfe_search_documents('nfse').
Produto padrão de importação: produto de serviço preenchido no assistente quando a NFS-e é importada.
Último NSU: cursor da próxima consulta. Pode ser ajustado para reprocessar a partir de um ponto.
O certificado e-CNPJ fica na configuração fiscal já existente.
Usage
Caixa de entrada
Acesse Faturamento > Fiscal > Consultas DF-e > Third-party NFS-e.
A listagem mostra as NFS-e em que a empresa é tomadora. O último NSU, a próxima consulta e o ambiente ficam na empresa, na aba Fiscal > NFS-e DF-e.
Em cada documento:
XML: baixa o arquivo nacional recebido do ADN.
Importar: abre o assistente de importação com o XML completo. O assistente cria um l10n_br_fiscal.document do tipo SE (entrada), com o prestador como emitente e uma linha de serviço. Se o prestador ainda não existe, ele é criado na confirmação a partir do prest da DPS (o emit só completa dados quando o CNPJ é o mesmo). O produto e a operação fiscal podem ser ajustados antes de confirmar. Se l10n_br_account estiver instalado, a confirmação existente do assistente gera a fatura de fornecedor.
A pesquisa específica aceita a chave de acesso de 50 dígitos ou um NSU. A nota é consultada na Sefin Nacional e os eventos no ADN. Não há manifestação do destinatário neste fluxo: a NFS-e nacional já chega com o XML da nota.
Bug Tracker
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.
Credits
Contributors
-
Marcel Savegnago <marcel.savegnago@escodoo.com.br>
Maintainers
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 maintainer:
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.
Metadata
Release files for odoo-addon-l10n-br-nfse-dfe 18.0.1.0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| odoo_addon_l10n_br_nfse_dfe-18.0.1.0.1.1-py3-none-any.whl | Python 3 | none | any | Details for odoo_addon_l10n_br_nfse_dfe-18.0.1.0.1.1-py3-none-any.whl |
Release files / odoo_addon_l10n_br_nfse_dfe-18.0.1.0.1.1-py3-none-any.whl
| Download URL | odoo_addon_l10n_br_nfse_dfe-18.0.1.0.1.1-py3-none-any.whl |
|---|---|
| Size | 74.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f66b376125e864d6da46ebe51f14f4f3d9dcdeb963ef811bde967f5026623258
|
|
BLAKE2b-256 checksum How to use checksums |
10884a3b50d60f82887c8f12879e832a0b33bb18408fd3fd5ee72844296aab09
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.4
|
Security for odoo-addon-l10n-br-nfse-dfe 18.0.1.0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.