Portal Nacional com captcha: como continuar baixando NFS-e em lote em 2026
Desde 1º de junho de 2026 o Portal Contribuinte exige hCaptcha no download de XML e PDF — e as automações por login e senha pararam de funcionar. Veja o que mudou e qual caminho continua aberto.
Se você usava uma extensão do Chrome ou um robô pra baixar NFS-e do Portal Nacional e, de uma hora pra outra, tudo parou de funcionar — não é bug. É o novo captcha.
Desde 1º de junho de 2026, o Portal Contribuinte (nfse.gov.br) exige a verificação hCaptcha para baixar XML e PDF das notas. Neste artigo, explicamos o que mudou, por que as ferramentas de automação quebraram e quais caminhos continuam funcionando.
O que mudou no Portal Nacional da NFS-e
Até maio de 2026, era possível automatizar o download de notas usando apenas login e senha do portal. Extensões de navegador e scripts se aproveitavam disso para baixar notas em sequência, simulando os cliques de um usuário.
Com o hCaptcha ativo, cada download passou a exigir uma verificação "não sou um robô" — que, por definição, um robô não consegue passar. Resultado: as automações baseadas em login e senha pararam de funcionar da noite pro dia.
A mudança gerou reação do setor: a FENACON enviou ofício à Receita Federal pedindo revisão da exigência. Até lá, o captcha é a realidade de quem depende do portal.
Por que as extensões do Chrome quebraram (e por que isso vai se repetir)
A maioria das extensões de download em lote funciona "raspando" a tela do portal: elas abrem as páginas, localizam os botões e clicam por você. É uma solução engenhosa, mas frágil — qualquer mudança no portal quebra tudo:
Mudou o layout? Quebrou.
Entrou captcha? Quebrou.
Portal fora do ar ou lento? Travou no meio de 500 notas.
E tem o custo invisível: alguém do seu escritório precisa ficar com o navegador aberto, esperando. Com 5, 10, 200 CNPJs pra baixar todo mês, isso não é automação — é trabalho manual com etapas a mais.
O caminho que o captcha não afeta: a API oficial com certificado digital
O que muita gente não sabe: a Receita Federal disponibiliza uma via oficial de acesso às notas, a API do ADN (Ambiente de Dados Nacional), autenticada por certificado digital — não por login, senha e captcha.
É a via que o próprio governo desenhou para sistemas se conectarem ao portal. O certificado digital A1 da empresa (o mesmo usado pra emitir notas) identifica quem está consultando, com validade jurídica. Sem tela, sem clique, sem captcha.
A diferença na prática:
Extensão / robô de tela | API oficial (certificado) | |
|---|---|---|
Afetado pelo captcha | ❌ Sim — parou em junho | ✅ Não |
Precisa de navegador aberto | ❌ Sim | ✅ Não — roda sozinho |
Quebra quando o portal muda | ❌ Sim | ✅ Não |
XML autenticado | Depende | ✅ Sim |
Vários CNPJs de uma vez | Um por vez | ✅ Todos automaticamente |
Como o ServLink faz isso pelo seu escritório
O ServLink se conecta à API oficial do Portal Nacional usando o certificado A1 de cada cliente do seu escritório. A partir daí:
Cadastre os CNPJs e os certificados A1 (uma única vez);
A sincronização roda sozinha — as notas emitidas e recebidas de todos os clientes chegam ao painel automaticamente, em mais de 5.500 municípios;
Filtre e baixe em lote — XML e PDF, por CNPJ, período ou número da nota, de todos os clientes de uma vez;
Receba alertas de vencimento de certificado, antes que uma sincronização pare por certificado vencido.
Nenhuma etapa passa pela tela do portal. Por isso o captcha de junho não afetou nenhum cliente ServLink — e a próxima mudança de layout do portal também não vai afetar.
Quanto custa
Plano único de R$ 50/mês, sem limite de CNPJs nem de notas. Você pode testar por 30 dias grátis, sem cadastrar cartão de crédito.
Perguntas frequentes
O captcha do Portal Nacional é permanente?
Não há prazo anunciado para remoção. A FENACON solicitou revisão à Receita Federal, mas enquanto não houver mudança, o download manual pelo portal exige a verificação a cada operação.
Preciso de certificado digital pra usar o ServLink?
Sim, o certificado A1 de cada empresa consultada — o mesmo já usado na rotina fiscal. É ele que garante o acesso pela via oficial, sem captcha.
O ServLink baixa notas emitidas e recebidas?
Sim, ambas, com o XML autenticado e o PDF (DANFSe).
Funciona pro meu município?
Se o município já aderiu ao padrão nacional da NFS-e (são mais de 5.500), sim. Na dúvida, teste no período grátis.
E se eu já uso uma extensão que voltou a funcionar?
Extensões que se adaptaram ao captcha continuam dependendo da estrutura do portal — a cada mudança, há risco de parar de novo. A via da API oficial não tem esse risco, e o ServLink ainda elimina a etapa de operar o navegador CNPJ por CNPJ.