NFS-e Nacional: Consulta Distribuição DF-e

O que é?

A Consulta de Distribuição de DF-e (Documento Fiscal eletrônico) da NFS-e Nacional permite que você consulte, pelo PlugNotas, as NFS-e e os eventos armazenados no ambiente nacional em que o seu CPF ou CNPJ conste como prestador, tomador ou intermediário do serviço.

Com ela, você ganha mais transparência, controle fiscal, apoio ao planejamento tributário e facilidade para conciliar informações.

O manual de instruções e a documentação técnica da distribuição da NFS-e Nacional estão disponíveis neste endereço.

Este artigo explica como ativar a consulta, como a sincronização funciona e quais rotas estão disponíveis no PlugNotas. 

Pré-requisitos

Antes de ativar a consulta, confira:

• A empresa está cadastrada no PlugNotas.
• O certificado digital A1 da empresa está configurado. O certificado deve ser de pessoa física (com o CPF) ou de pessoa jurídica (com o CNPJ) do ator que fará a consulta.
• O CPF ou CNPJ do ator constar nos campos de prestador, tomador ou intermediário da NFS-e. Só assim a nota (e os eventos que a referenciam) pode ser distribuída a ele.
   

Como ativar a consulta

A ativação é feita no cadastro da empresa, pela interface web do PlugNotas ou pela API.

Pela interface web: acesse o cadastro da empresa e ative a opção de consulta de Distribuição DF-e da NFS-e Nacional.

O ambiente da consulta segue o ambiente configurado na empresa:

As notas retornadas correspondem ao ambiente consultado.
 

Como funciona a sincronização

Depois da ativação, não é preciso fazer mais nada: o PlugNotas cuida da comunicação com o webservice do Ambiente Nacional.

• Frequência: a consulta é executada automaticamente pelo PlugNotas a cada hora cheia (09h, 10h, 11h, 12h...), respeitando as regras do manual para evitar consumo indevido. 
• Primeira execução: se você ativar a consulta às 13h30, a primeira execução ocorrerá às 14h.

• Controle do NSU: você pode informar o NSU (Número Sequencial Único) inicial da consulta. A partir dele, o PlugNotas controla a sequência automaticamente, o que evita erros. Caso o NSU inicial não seja informado, a consulta se iniciará pelo NSU 0. Na carga inicial, o volume de documentos pode ser grande e a sincronização pode levar mais tempo. 

• Armazenamento: o PlugNotas guarda tanto as notas quanto os eventos retornados pelo Ambiente Nacional.
• Webhook: se você tiver um webhook configurado, o PlugNotas notifica você sempre que uma nova nota ou um novo evento chegar à base.

Ordem dos documentos

A sincronização não segue a ordem cronológica de emissão ou de geração pelo sistema gerador da NFS-e (municipal ou Sefin Nacional). O NSU é gerado conforme a ordem em que o Ambiente de Dados Nacional da NFS-e recebe cada documento.

Data usada nos filtros

A data dos filtros corresponde à data em que o PlugNotas recebeu a nota, que pode ser diferente da data de autorização ou de emissão.

Eventos que podem ser consultados

O prestador, o tomador e o intermediário podem receber eventos da nota, e você pode consultá-los pelo PlugNotas.

Rotas disponíveis no PlugNotas

Os detalhes de cada rota estão na documentação oficial do PlugNotas (NFS-e Nacional).

• Solicitar a sincronização de eventos ou solicitar a manifestação de uma nota através do id
  • Consultar todos os eventos vinculados a um id
• Solicitar a sincronização de eventos ou solicitar a manifestação de uma nota por cpf/cnpj do ator e chave de acesso.
  • Consulta todos os eventos vinculados a nota por cpf/cnpj do ator e chave de acesso.
• Consultar um evento específico vinculado a nota por cpf/cnpj do ator, chave de acesso e protocolo
• Consultar um evento específico vinculado a nota por id e protocolo
• Consultar todas as notas armazenadas por cnpj e período
• Consultar PDF de uma nota
• Baixar o xml de uma nota
• Baixar o xml de um evento

Filtro por ator

Nas rotas de consulta, você pode usar o parâmetro ator para filtrar as notas em que o CNPJ seja o prestador, o tomador ou o intermediário, separadamente. O parâmetro está documentado em cada rota.

Glossário