Busca XML: como buscar e baixar XMLs de notas fiscais automaticamente
O XML da nota fiscal eletrônica é, hoje, a matéria-prima da rotina fiscal: é dele que saem os lançamentos nos livros fiscais, as apurações e — desde a Reforma Tributária — os campos de IBS e CBS que as empresas precisam passar a informar. E, ainda assim, uma parte considerável dos escritórios continua dependendo do cliente para "mandar as notas" por e-mail, WhatsApp ou pasta compartilhada. O resultado é sempre o mesmo: nota que o cliente esquece, documento que chega incompleto, apuração travada esperando arquivo.
O BuscaXML resolve exatamente esse gargalo. O sistema se conecta ao ambiente da SEFAZ usando o certificado digital da empresa, baixa automaticamente os XMLs das notas emitidas contra o CNPJ do cliente (notas de entrada) e permite manifestar o destino de cada documento — tudo sem depender de envio manual. Menos cobrança ao cliente, menos erro humano e um fluxo de documentos completo desde o primeiro dia, inclusive na chegada de cliente novo.
Neste #SuperDica, você aprende a instalar e configurar o BuscaXML: cadastro da empresa e do certificado, parâmetros de busca, o primeiro download de notas e a ativação do monitoramento automático da SEFAZ.
O que o BuscaXML elimina da sua rotina
Antes do passo a passo, vale dimensionar o ganho. Com o BuscaXML rodando:
Não há mais "cliente que esqueceu a nota": o sistema busca na SEFAZ todo documento autorizado com o CNPJ do cliente no destinatário, direto na fonte;
A equipe para de digitar e importar manualmente: os XMLs chegam padronizados, prontos para alimentar os módulos fiscais;
A manifestação do destinatário acontece em tempo: a ciência da emissão e a manifestação da nota são feitas pelo próprio sistema, evitando "nota fantasma" de terceiros na contabilidade do cliente;
O escritório ganha histórico completo por empresa: os XMLs ficam organizados em pasta definida por você, acessível à equipe (inclusive em rede).
E há um gancho estratégico: com os campos de IBS e CBS chegando aos documentos fiscais da Reforma Tributária, ter o XML completo e organizado deixa de ser conforto e passa a ser pré-requisito da apuração nova. Quem estrutura essa rotina agora sai na frente.
Passo a passo: instalação e primeiro uso
1. Instalação e acesso ao sistema
Após instalar o BuscaXML na máquina, será criado um atalho na área de trabalho — dê duplo clique para abrir o sistema.
2. Cadastro da empresa e do certificado digital
Com o sistema aberto, acesse a aba Configurações e clique em Cadastrar Nova Empresa. Em seguida:
Clique no botão para selecionar o Certificado Digital da empresa que está sendo configurada;
O sistema apresenta os certificados detectados na máquina. Se houver vários, clique em "Mais opções" para visualizar todas as opções, selecione o certificado da empresa e clique em OK;
O sistema exibirá as informações constantes no certificado. Informe o tipo: A1 ou A3;
No campo "Último NSU", deixe o valor zero — esse parâmetro faz o sistema buscar todas as notas disponíveis para download na SEFAZ. Atenção: isso não garante o resgate de todo o histórico de notas já recebidas, porque a própria SEFAZ limita a busca retroativa;
Defina o caminho onde os XMLs serão gravados. Se os arquivos devem ser acessados por vários usuários, salve em pasta da rede de computadores do escritório; se o acesso for apenas de quem opera o sistema, salve na própria máquina;
No campo "Procurar novas notas a cada … minutos", mantenha 70: a SEFAZ está impedindo buscas em intervalos menores de uma hora;
Confira todos os campos, corrija o que for preciso e clique em Salvar. O sistema confirmará que os dados da empresa foram salvos.
Observação importante sobre o certificado: no tipo A3, o token precisa estar plugado e instalado no computador, e o PIN será solicitado a cada consulta. Para não digitar a senha o tempo todo, a recomendação é usar certificado A1 — detalhe que também trava uma funcionalidade lá na frente (veja o passo 5).
3. Primeira busca de notas
Com a configuração concluída, acesse a aba Notas Fiscais. O sistema apresentará a mensagem sobre a Ciência da Emissão: as notas só são baixadas com sucesso após essa ciência ser registrada. Leia, confirme e clique em OK.
No topo da aba, confira de qual empresa os XMLs serão baixados. Então clique no botão "Buscar NFe Sefaz". O sistema exibirá a mensagem com as novas regras da SEFAZ para a baixa dos arquivos — leia com atenção e confirme.
Se a configuração estiver correta, a conexão com a SEFAZ será feita com sucesso: o status da conexão aparece na parte superior direita da aba Notas Fiscais.
4. Download, manifestação e demais ações por nota
Pelo botão "XML", você realiza as operações sobre cada documento:
Download do XML da nota;
Manifestação do destinatário (ciência da emissão, confirmação da operação, operação não realizada, desconhecimento);
Exclusão da nota da grade;
Verificação da grade de notas.
5. Monitoramento automático da SEFAZ
Feita a primeira busca completa, dois modos automatizam o dia a dia:
Ocultar e monitorar: o sistema fica minimizado na máquina, monitorando as notas autorizadas na SEFAZ com o CNPJ da empresa no destinatário (notas de entrada);
Monitorar Sefaz (aba Configurações): com essa opção marcada, o próprio BuscaXML entra na SEFAZ periodicamente e baixa automaticamente os XMLs emitidos contra o CNPJ — ao abrir a pasta definida na configuração, os arquivos já estarão lá.
Limitação que vale memorizar: o Monitorar Sefaz não funciona com certificado A3, porque a baixa exige o preenchimento do PIN a cada consulta. Escritórios que querem o monitoramento 100% automático devem adotar o A1.
Erros comuns e onde encontrar ajuda
Se alguma mensagem de inconsistência aparecer — certificado não encontrado, XMLs que não baixam, erro ao manifestar nota, problema de NSU —, o manual do BuscaXML tem uma base de conhecimento dedicada com as soluções de cada caso: veja a página de inconsistências do BuscaXML. A configuração mais frequente de problema é o certificado (A3 sem PIN informado ou leitor/token mal instalado).
Conclusão: documento na fonte, apuração sem lacuna
O fluxo ideal do escritório é simples de enunciar e poderoso quando instalado: XML baixado direto da SEFAZ, manifestado em tempo, salvo em pasta compartilhada e alimentando os módulos fiscais sem digitação. O BuscaXML fecha essa ponte na ponta da entrada de documentos — e conversa com o restante do ecossistema: os XMLs baixados alimentam o Livros Fiscais (que já prepara os campos de IBS e CBS da Reforma Tributária) e estruturam a rotina do cliente desde a migração, como mostramos no guia de migração de clientes contábeis. Automatize a entrada de documentos e o resto da rotina fiscal anda sozinho.
Comentários