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.

Important

This is an alpha version, the data model and design can change at any time without warning. Only for development or testing purpose, do not use in production. More details on development status

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.