RoboFiscalRotina fiscal e contador
Como baixar as NFS-e que recebi sem passar pelo captcha da prefeitura?
Use a distribuição do Ambiente de Dados Nacional (ADN): uma API em que a empresa se identifica com o próprio certificado digital e baixa, pela sequência de NSU, as NFS-e em que aparece como tomadora, sem login de portal nem captcha. Ela traz as notas emitidas pelo padrão nacional e as que as prefeituras compartilham com o ambiente nacional. O RoboFiscal faz essa coleta quatro vezes por dia com o A1 da empresa e guarda o XML de cada nota; o portal da prefeitura só continua necessário para nota que não chegou ao ADN.
Fatos e fontes
- O manual do ADN para contribuintes, versão 1.0 de 12/02/2026, descreve APIs para consultar documentos fiscais de serviço em que o contribuinte figura como emitente, tomador ou intermediário.Fonte: Portal NFS-e: APIs do ADN para contribuintes.
- A consulta é feita com certificado digital, que pode ter o mesmo CNPJ raiz do contribuinte consultado, e o método GET /DFe/{NSU} devolve o documento associado a cada número sequencial (NSU).Fonte: Portal NFS-e: APIs do ADN para contribuintes.
- Desde 1º/01/2026, a LC 214/2025 (art. 62) exige que o município com emissor próprio compartilhe as notas com o ambiente nacional.Fonte: Planalto: Lei Complementar 214/2025, art. 62.
- Na tabela oficial de 28/09/2026, 5.543 dos 5.571 entes aparecem como aderentes ao Ambiente Nacional.Fonte: Portal NFS-e: tabela de municípios aderentes de 28/09/2026.
- A API do RoboFiscal lista e sincroniza as notas recebidas pelas rotas GET /recebidas e POST /recebidas/sincronizar.Fonte: RoboFiscal: contrato OpenAPI público.
Nesta página
Por que o portal pede captcha e a API não?
O portal da prefeitura é feito para consulta manual, e o captcha existe para barrar robôs na tela. A distribuição do ADN é um serviço para sistemas: a identificação é o certificado da empresa, e não há tela. Automatizar o portal é frágil e esbarra no captcha; a API do ADN é o caminho previsto para baixar notas em volume.
Quais notas aparecem no ADN?
Aparecem as NFS-e emitidas pelo padrão nacional e as que as prefeituras com sistema próprio compartilham com o ambiente nacional, como exige a LC 214/2025. Nota de um município que ainda não compartilhou fica só no sistema dele; nesse caso, o portal da prefeitura ou o próprio fornecedor continuam sendo o caminho. A coleta segue a sequência de NSU, então cada documento chega uma vez e a consulta seguinte continua de onde parou.
Dá para baixar as notas antigas?
Só o que estiver disponível no ADN para o CNPJ. A coleta percorre o que o ambiente nacional tiver, mas não há garantia de histórico completo: notas antigas de sistemas municipais que nunca foram compartilhadas não aparecem.
E as notas de produto (NF-e)?
A NF-e de mercadorias vem por outro canal, a distribuição da SEFAZ, e pode chegar só como resumo, sem os itens. O RoboFiscal consulta os dois canais na mesma coleta.
| Canal | Como a empresa se identifica | O que traz |
|---|---|---|
| Portal da prefeitura | Login da prefeitura; pode exigir captcha | Notas do sistema municipal, consulta por consulta |
| API do ADN | Certificado digital da empresa | NFS-e do padrão nacional e as compartilhadas pelas prefeituras, por NSU |
| RoboFiscal | O certificado A1 já cadastrado | Coleta quatro vezes por dia, com XML e PDF de cada nota no painel e na API |
Passo a passo
- Cadastre a empresa e o certificado A1 autorizado no RoboFiscal.
- Abra Recebidas e clique em Sincronizar para a primeira coleta.
- Confira as notas trazidas: prestador, valor, data e situação.
- Baixe o XML ou o PDF de cada nota, ou use a API para levar a lista ao seu sistema.
- Para nota que não aparecer, confira se a prefeitura do prestador compartilha com o ADN e peça o arquivo ao fornecedor.
Erros comuns
- Concluir que a nota não existe porque não apareceu: ela pode estar só no sistema de uma prefeitura que ainda não compartilhou.
- Consultar com o certificado de outra empresa: o ADN só entrega notas do CNPJ do certificado ou do mesmo CNPJ raiz.
- Lançar em dobro a nota baixada por dois caminhos: confira pela chave de acesso.
Como o RoboFiscal ajuda
O RoboFiscal resolve o download das notas tomadas sem captcha. Com o A1 que a empresa já cadastrou, ele consulta o ADN quatro vezes por dia, segue a sequência de NSU sem duplicar notas e guarda o XML de cada uma. Na tela Recebidas aparecem prestador, valor e data, com XML e PDF para baixar; pela API, GET /recebidas leva a lista ao seu sistema, e o webhook recebida.nova avisa quando chega uma nota. As recebidas também entram no pacote mensal do contador.
Crie a conta, cadastre o certificado A1 da empresa e faça a primeira coleta das notas que você recebeu.
Perguntas relacionadas
Preciso da senha da prefeitura ou da conta gov.br?
Não para a coleta do ADN: a identificação é o certificado A1 da empresa. Não envie senhas ao suporte.
A coleta inclui as notas que eu mesmo emiti?
Não. O ADN também distribui as notas em que a empresa é emitente, mas a tela Recebidas mostra só as tomadas; as emitidas ficam na lista de notas da empresa.
Continue lendo
Revisado em · Equipe RoboFiscal. Versão em texto