Guia rápido
Consulta pública da NFS-e
Dá para consultar qualquer NFS-e do Portal Nacional sem login e sem certificado digital, desde que você tenha a chave de acesso ou o QR Code do DANFSe. Veja como fazer, o que a consulta mostra e o que ela não entrega.
Como consultar, passo a passo
- Acesse nfse.gov.br/consultapublica.
- Informe a chave de acesso de 50 dígitos da NFS-e. Ela aparece no DANFSe e no XML.
- Preencha o código de verificação da tela e confirme.
- A nota aparece com os dados de resumo e a situação atual — ativa ou cancelada.
Se você tem o DANFSe em mãos, o caminho mais curto é apontar a câmera do celular para o QR Code impresso nele: o código leva direto ao registro da nota, sem digitar nada.
O que a consulta pública NÃO faz
Ela não entrega o XML autenticado e não lista todas as notas de um CNPJ. Serve para verificar uma nota da qual você já tem a chave. Para ter os arquivos e o histórico completo, é preciso certificado digital.
Consulta pública x acesso com certificado
| O que você quer | Consulta pública | Com certificado |
|---|---|---|
| Saber se a nota existe | Sim | Sim |
| Ver se foi cancelada | Sim | Sim |
| Baixar o XML autenticado | Não | Sim |
| Listar todas as notas do CNPJ | Não | Sim |
| Precisa de chave em mãos | Sim | Não |
A nota não aparece. E agora?
- Confira a chave antes de suspeitar do portal. Um dígito trocado invalida a busca inteira. Nossa ferramenta gratuita de validação diz na hora se a chave é válida, de qual município e de que mês — sem enviar nada para servidor.
- O município pode não ter aderido ao padrão nacional. Nesse caso a nota existe, mas vive no sistema da prefeitura, não no Portal Nacional.
- A nota pode ser recente demais. Há uma defasagem entre a emissão e a disponibilização para consulta.
Quando a consulta uma a uma deixa de servir
A consulta pública foi feita para verificar uma nota. Ela resolve bem a pergunta “este documento é legítimo?”. O que ela não resolve é a rotina de quem precisa de todas as notas de uma competência — e é aí que o trabalho manual vira gargalo: sem a chave, não há o que consultar; com centenas de notas, não há tempo.
Para esse caso existe o caminho oficial inverso: em vez de perguntar nota por nota, o CNPJ pede à Receita Federal todos os documentos destinados a ele. É o que faz a API do Ambiente de Dados Nacional, acessada com certificado digital.
Precisa das notas em lote, não de uma?
O NFSe Downloader é uma extensão do Chrome que usa a API oficial com o seu certificado digital e devolve, num único ZIP, os XMLs autenticados, os PDFs (DANFSe) e uma planilha com uma linha por nota — emitidas e recebidas, sem captcha e sem digitar chave.