Skip to main content
Odoo Community Association

Monitor de NFS-e

Alpha License: AGPL-3 OCA/l10n-brazil Translate me on Weblate Try me on Runboat

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:

  1. XML: baixa o arquivo nacional recebido do ADN.

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

Authors

  • Escodoo

Contributors

Maintainers

This module is maintained by the OCA.

Odoo Community Association

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:

marcelsavegnago

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 16.0.1.0.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for odoo-addon-l10n-br-nfse-dfe 16.0.1.0.0.5
File Interpreter ABI Platform Actions
odoo_addon_l10n_br_nfse_dfe-16.0.1.0.0.5-py3-none-any.whl Python 3 none any Details for odoo_addon_l10n_br_nfse_dfe-16.0.1.0.0.5-py3-none-any.whl

Release files / odoo_addon_l10n_br_nfse_dfe-16.0.1.0.0.5-py3-none-any.whl

Download URL odoo_addon_l10n_br_nfse_dfe-16.0.1.0.0.5-py3-none-any.whl
Size 76.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5025e75aae690ee24134d792cb28c7e363b40c96ad228291c63cef9bdc9a62e8
BLAKE2b-256 checksum
How to use checksums
6fac45fadc6b78d8c531ffb7a6030c5c3f306ddd71f350915690dbfee031ffd1
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 16.0.1.0.0.5

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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page