Notas não sendo Buscadas na API

Boa tarde,

Em relação à API
https://adn.nfse.gov.br/contribuintes/DFe/{nsu},
utilizada para a captura de NFSe do Ambiente Nacional, informamos que até a madrugada de 01/01/2026 as consultas estavam ocorrendo normalmente. Contudo, a partir desse momento, o serviço passou a retornar a informação de inexistência de documentos para consulta, sem que tenha havido qualquer alteração em nosso sistema ou no fluxo de integração.

Diante disso, solicitamos esclarecimentos:

  1. O serviço apresenta alguma instabilidade no momento?

  2. Houve alguma alteração recente em regras, parâmetros ou forma de uso da API que possa ter impactado as consultas?

Ressaltamos que as NFSe ainda podem ser recuperadas individualmente pelo endpoint
https://adn.nfse.gov.br/municipios/NFSe/{chave}/Eventos, e na consulta pela Chave ele encontrou as notas, porém como a consulta é individual se torna inviável em altos volumes.

Aguardamos retorno para que possamos orientar os municípios afetados,

como Itapema/SC ( 4209309 ) e Imperatriz/MA ( 2105302 ).

Atenciosamente,
Maicon Thomaz

1 curtida

Boa tarde!

Deve haver alguma falha na aplicação local, pois, estamos recebendo DF-e (NFS-e e eventos) normalmente desde sempre.

Olá

Vocês já estão fazendo as buscas da nota pelo certificado digital matriz?

Não houve falha de entendimento técnico da nossa parte. O que se observa é a desconsideração do contexto real da operação ou a ausência de domínio técnico na resposta apresentada.

A Prefeitura realiza a emissão de NFS-e exclusivamente pelo Portal Nacional. A aplicação local, conforme evidenciado para comprovação nos testes realizados, não participa do processo de emissão nem é utilizada para validação dos dados. O consumo realizado limita-se à consulta das informações já disponibilizadas pelo ambiente nacional. Dessa forma, não procede qualquer atribuição do problema à aplicação local.

A validação foi executada diretamente nos serviços oficiais, por meio do Postman, utilizando o certificado digital da própria Prefeitura (File → Settings → Certificates). Foi realizada uma requisição GET, para explicação caso não tenham conhecimento é exclusivamente a consulta de dados existentes, sem qualquer operação de gravação, interferência, cache ou influência de camada de aplicação.

O retorno obtido em ambiente de PRODUÇÃO foi o seguinte:

{
  "StatusProcessamento": "NENHUM_DOCUMENTO_LOCALIZADO",
  "LoteDFe": [],
  "Alertas": [],
  "Erros": [
    {
      "Mensagem": {},
      "Codigo": "E2220",
      "Descricao": "Nenhum documento localizado - não existem documentos fiscais para o Contribuinte a partir do NSU informado."
    }
  ],
  "TipoAmbiente": "PRODUCAO",
  "VersaoAplicativo": "1.0.0.0",
  "DataHoraProcessamento": "2026-01-07T20:55:36.0962287-03:00"
}

Esse retorno é incompatível com a realidade operacional de uma Prefeitura de grande porte, que possui alto volume diário de emissão de NFS-e. Não se trata de ausência de documentos, mas de falha clara na disponibilização/consulta dos dados no ambiente nacional.

Ressalte-se ainda que o último endpoint que retornou qualquer documento foi:
https://adn.nfse.gov.br/contribuintes/DFe/93
Mesmo assim, o volume retornado é irrisório, totalmente discrepante da quantidade efetiva de notas emitidas.

Portanto, reforçamos de forma objetiva:

  • não há uso de aplicação local para validação;

  • não há interferência de cache, integração ou consumo indevido;

  • o problema reside na resposta do serviço nacional, que não está refletindo os documentos efetivamente emitidos.

Aguardamos uma análise técnica concreta, e para finalizar em busca trago situação similar em damais municipio Problema ao capturar as notas do Ambiente Nacional onde a reposta “foi um pouco diferente.”

Alguma novidade sobre a situação ?

Sim, foi feito a busca com o Certificado da Prefeitura em ambiente de produção.

Sim, agora é possível, porém tem que passar o cnpj da consulta.

não entendi sua resposta, o problema não é a filtragem e sim que não está retornando TODAS AS NOTAS EMITIDAS.

Estou com esse mesmo problema, começou a acontecer ontem por volta das 10 da manhã, alguma novidade?

Identifiquei um comportamento semelhante ao relatado.

Há uma empresa do município de Papanduva/SC (4212205) que realizou emissões de NFSe pelo ambiente da própria prefeitura. Parte dessas notas foi integrada ao Ambiente Nacional (não a totalidade), porém, ao realizar a consulta via API do Ambiente Nacional utilizando o certificado da própria empresa, essas NFSe não são retornadas.

Na consulta, no máximo, é apresentada uma NFSe emitida para essa mesma empresa em outro município, Itaiópolis/SC (4208104), onde a emissão ocorre diretamente pelo Ambiente Nacional. As demais notas, apesar de visíveis no portal do Ambiente Nacional, não são recuperadas pela API de consulta por NSU.

Esse comportamento sugere uma possível inconsistência entre as notas disponíveis no ambiente e aquelas retornadas pelo serviço de consulta.

Fico à disposição para fornecer mais detalhes, caso necessário.

Constatei esse mesmo problema, quando entro no painel administrativo do Portal NFSe tem várias notas recente, porém quando realiza a busca pela api não aparece muitas dessas notas.