Pular para o conteúdo
ProXML, página inicial

Como abrir arquivos XML de nota fiscal e somar os valores

O XML é o arquivo oficial da NF-e e da NFC-e, mas não foi feito para ser lido a olho. Com o ProXML, você abre uma pasta inteira de XMLs e vê o valor total, o ICMS, o IBS e a CBS somados, nota por nota. Este tutorial mostra cada passo.

  1. Baixe e instale o ProXML

    Baixe o instalador na página de download do ProXML. Execute o ProXML-Setup.exe e siga as telas. Na tela “Selecione o Local de Destino”, mantenha a pasta sugerida (%LocalAppData%\ProXML) e clique em Avançar. O ProXML é instalado só para o seu usuário, sem pedir senha de administrador.

    No fim, abra o ProXML pelo atalho no Menu Iniciar ou na Área de Trabalho. O atalho da Área de Trabalho é opcional e já vem marcado no instalador.

    Se o Windows mostrar “O Windows protegeu o computador”, clique em Mais informações e depois em Executar assim mesmo. Entenda por que esse aviso aparece. Prefere não instalar nada? Use a versão portátil (.zip).

    Voltar ao sumário

  2. Abra o ProXML

    Na primeira vez, a tela mostra “Nenhuma pasta processada”. À esquerda fica o menu com as telas Resumo, Notas, Relatórios, Enviar e Configurações. O link Sobre, no canto do cabeçalho, mostra a versão e os créditos, com os links para o site do ProXML e para o repositório no GitHub e o botão Apoiar no Apoia.se, para quem quiser apoiar o desenvolvimento.

    A janela pode ser redimensionada e maximizada. O ProXML lembra o tamanho e a posição da janela para a próxima vez.

    Janela do ProXML recém-aberta, sem pasta selecionada: menu lateral com Resumo, Notas, Relatórios, Enviar e Configurações, cards zerados e a mensagem “Nenhuma pasta processada” com o botão Selecionar pasta…. (ampliar imagem)

    Voltar ao sumário

  3. Selecione a pasta com os XMLs

    Clique em Selecionar… (ou no campo da pasta, ou aperte Ctrl+O) e escolha a pasta onde estão os XMLs das notas. Você também pode arrastar a pasta do Explorador de Arquivos para a janela do ProXML.

    O ProXML lembra a última pasta usada. Dica: prefira uma pasta com caminho curto, como C:\XMLs. XMLs em caminhos com mais de 259 caracteres (pasta + nome do arquivo) não são lidos.

    Diálogo do Windows “Selecione a pasta com os XMLs”, em tema escuro, aberto sobre o ProXML na pasta C:\XMLs\Empresa Exemplo, com a subpasta 2026-11 e o botão Selecionar pasta. (ampliar imagem)

    Voltar ao sumário

  4. Clique em Processar

    Clique em Processar (ou aperte F5). A leitura acontece em segundo plano: a janela continua respondendo e mostra o progresso em “X de N arquivos”. Para parar, clique em Cancelar ou aperte Esc.

    Só as notas autorizadas entram nos totais: as que têm cStat 100 (autorizado o uso) ou 150 (autorizado fora de prazo) no protocolo de autorização. Notas não autorizadas (por exemplo, denegadas), XMLs de outros modelos e arquivos que não são Nota Fiscal ficam de fora e aparecem nos Detalhes da leitura com o motivo.

    Voltar ao sumário

  5. Confira os totais e o Resumo

    No alto ficam os cinco cards de totais: Valor Total, Base ICMS, ICMS, IBS e CBS. Na tela Resumo aparecem os contadores (Autorizadas, Ignoradas e Com erro), o tempo da leitura e os Detalhes da leitura, arquivo por arquivo. No fim dos Detalhes da leitura fica o bloco da conferência de IBS/CBS.

    Os cards IBS e CBS mostram os tributos novos da Reforma Tributária, lidos do XML de cada nota. Entenda o que são o IBS e a CBS.

    Se os totais incluírem notas de homologação (ambiente de testes, sem valor fiscal) ou NF-e de entrada, o Resumo mostra um aviso para você conferir se a pasta é a certa.

    Tela Resumo do ProXML depois de processar a pasta de exemplo: cards Valor Total, Base ICMS, ICMS, IBS e CBS preenchidos, 20 notas autorizadas, 0 ignoradas, 0 com erro e os Detalhes da leitura, com o filtro em Todos. (ampliar imagem)

    Atenção ao conferir os totais

    • Nas NF-e (55), as notas de entrada e de saída são somadas juntas, sem distinção. Para conferir só as vendas, processe uma pasta que tenha apenas as notas de saída.
    • Nota cancelada continua somada. O cancelamento é um evento separado e o XML da nota continua autorizado. Retire da pasta os XMLs das notas canceladas antes de processar.

    Voltar ao sumário

  6. Filtre por modelo: NF-e ou NFC-e

    Na barra de cima, escolha Todos, NF-e 55 ou NFC-e 65. Os cards, a grade de notas, o CSV, os relatórios e o e-mail mudam na hora, sem processar de novo.

    Tela Notas do ProXML com o filtro de modelo em NF-e 55: a grade mostra só as 12 NF-e e os cards de totais ficam recalculados para elas. (ampliar imagem)

    Voltar ao sumário

  7. Veja as notas, copie a chave e exporte o CSV

    A tela Notas mostra uma grade com Nº, Modelo, Data, Chave (44 dígitos), valores e, por último, a coluna IBS/CBS, com o resultado da conferência de IBS/CBS. As colunas Base ICMS, ICMS, IBS e CBS aparecem conforme a largura da janela; a coluna IBS/CBS fica sempre visível.

    • Buscar: digite o número ou a chave no campo de busca (Ctrl+F). Esc limpa a busca.
    • Ordenar: clique no título da coluna.
    • Copiar chave: copia a chave de acesso inteira da nota selecionada (Ctrl+C na grade).
    • Gerar DANFE: gera o PDF da nota selecionada (Ctrl+D ou duplo clique). Veja como gerar o DANFE e o DANFCe.
    • Exportar CSV: salva as notas visíveis na lista (com o filtro e a busca) num arquivo que abre no Excel em português: separado por ponto e vírgula, com vírgula decimal e acentos corretos. A última coluna, Conferência IBS/CBS, traz OK, Alerta ou Erro.

    O botão direito do mouse na grade também tem Copiar chave e Gerar DANFE.

    Tela Notas do ProXML com 26 notas na grade (Nº, Modelo, Data, Chave, Valor, ICMS, IBS, CBS e IBS/CBS), ordenada pela coluna IBS/CBS: 3 notas com Erro, 3 com Alerta e as demais com OK, e os botões Copiar chave, Gerar DANFE e Exportar CSV. (ampliar imagem)

    Voltar ao sumário

  8. Confira os cálculos de IBS/CBS

    Ao processar a pasta, o ProXML refaz as contas de IBS e CBS de cada item e dos totais das notas autorizadas. A conferência só informa: os cards, os totais e os contadores continuam com os valores do XML. Veja o que o ProXML confere em cada nível.

    Na tela Notas: a coluna IBS/CBS

    • OK: os cálculos de IBS/CBS foram conferidos, sem divergência.
    • Alerta: há indicações para conferir (base, alíquota ou CST). Não quer dizer que a nota está errada.
    • Erro: alguma conta de IBS/CBS não fecha com os valores do próprio XML, no item ou nos totais.
    • Vazia: a nota não tem IBS/CBS e fica fora da conferência.

    Uma nota com Erro e Alerta aparece como Erro. Passe o mouse sobre a célula para ver a dica com o resultado da nota, por exemplo quantas contas não fecham ou quantas indicações há para conferir. Clique no título da coluna para ordenar por gravidade: no primeiro clique, as notas com Erro ficam no topo.

    Na tela Resumo: o bloco da conferência

    No fim dos Detalhes da leitura, uma linha resume a conferência (“Conferência de IBS/CBS: N notas conferidas, …”) e, depois dela, vem uma linha por divergência, com o valor do XML e o esperado. Por exemplo:

    • Nota Fiscal 910003, item 1: IBS UF R$ 0,50, esperado R$ 0,24 (R$ 238,13 × 0,1000%) (erro).
    • Nota Fiscal 910014, item 1: alíquota do IBS UF 0,0500% no XML e 0,1000% para 2026; confira (alerta).

    O Resumo também informa as notas com partes que ficaram sem conferência (por exemplo, tributação monofásica), sem contar como divergência. Os Detalhes da leitura valem para a pasta inteira e não mudam com o filtro de modelo; a grade e o relatório seguem o filtro.

    No relatório Divergências IBS/CBS

    Na tela Relatórios, o terceiro quadro gera o relatório Divergências IBS/CBS em A4, com uma linha por divergência: Nº, modelo, data, item (ou “Total”, quando a diferença está entre os itens e o total da nota), nível, tipo (Erro ou Alerta), campo, valor no XML e esperado. No fim vêm a contagem de notas com Erro e com Alerta e as versões das regras usadas. Se não houver divergência, o relatório mostra “Nenhuma divergência de IBS/CBS”.

    No CSV da tela Notas, a última coluna, Conferência IBS/CBS, traz o mesmo OK, Alerta ou Erro da grade.

    Alerta não é erro

    O ProXML marca como Alerta o que depende da operação e da regra legal: base de cálculo, alíquota, redução, CST e cClassTrib. É uma indicação para conferir a nota com quem cuida da parte fiscal, não uma afirmação de que a nota está errada. Erro indica uma conta que não fecha com os próprios valores do XML, no item ou nos totais.

    Relatório Divergências IBS/CBS do ProXML na pré-visualização, com o período, o modelo, a pasta de origem e uma linha por divergência nas colunas Nº, Mod., Data, Item, Nível, Tipo, Campo, Valor no XML e Esperado. (ampliar imagem)

    Voltar ao sumário

  9. Gere os relatórios

    A tela Relatórios tem três opções, cada uma com o botão Gerar relatório, que grava as notas e abre a visualização:

    • Relatório de Notas: Nº, modelo, data, chave, valor, base de cálculo do ICMS e ICMS de cada nota, com os totais no fim.
    • Relatório IBS/CBS: Base IBS/CBS, IBS UF, IBS municipal, IBS e CBS das notas que têm o grupo IBS/CBS.
    • Divergências IBS/CBS: os erros e alertas da conferência de IBS/CBS, um por linha. Veja como ler esse relatório.

    Os relatórios saem em A4, com o período das notas, o modelo do filtro, a pasta de origem, a linha de total e o rodapé com a data e a página. Eles usam as notas do modelo selecionado na barra de cima; a busca da tela Notas não é aplicada.

    Tela Relatórios do ProXML com três opções, Relatório de Notas, Relatório IBS/CBS e Divergências IBS/CBS (3 notas com Erro e 3 com Alerta), cada uma com o botão Gerar relatório, e o indicador Modelo: Todos · 26 notas. (ampliar imagem)

    Voltar ao sumário

  10. Configure o e-mail de envio

    Em Configurações, informe o Servidor SMTP, a Porta, marque SSL e/ou TLS conforme o seu provedor e preencha E-mail (usuário), Senha e a Mensagem padrão do e-mail.

    Clique em Testar conexão: o ProXML conecta e autentica no servidor sem enviar e-mail. Se der certo, clique em Salvar.

    Exemplo para o Gmail: servidor smtp.gmail.com, porta 465 com SSL ou 587 com TLS, usando uma senha de app.

    A senha fica gravada sem criptografia no arquivo db\notas.db, na pasta do ProXML. Não compartilhe esse arquivo depois de configurado.

    Tela Configurações do ProXML com o servidor SMTP smtp.exemplo.com.br, a porta 587 com TLS marcado, o e-mail contato@exemplo.com.br, a senha oculta, a mensagem padrão e os botões Testar conexão e Salvar. (ampliar imagem)

    Voltar ao sumário

  11. Envie os XMLs por e-mail

    A tela Enviar mostra o anexo antes do envio: a quantidade de XMLs e o tamanho. Preencha o e-mail do destinatário em Para, ajuste a Mensagem e clique em Enviar.

    Os XMLs só são compactados quando você clica em Enviar, num arquivo NFCe_ProXML.zip criado pelo próprio ProXML (não precisa do WinRAR). O envio acontece em segundo plano. Se não for possível montar o anexo (por exemplo, arquivo em uso ou disco cheio), aparece uma mensagem e o e-mail não é enviado.

    Tela Enviar por e-mail do ProXML com o anexo de 20 XMLs (.zip), o destinatário contato@exemplo.com.br, uma mensagem de exemplo e o botão Enviar. (ampliar imagem)

    Voltar ao sumário

Atalhos de teclado do ProXML

Dá para usar o ProXML inteiro pelo teclado, com Tab, Enter, Espaço e os atalhos abaixo.

AtalhoAção
Ctrl+OSelecionar a pasta
F5Processar
EscCancelar a leitura (durante o processamento)
Ctrl+FIr para a busca da tela Notas
Esc (no campo de busca)Limpar a busca
Ctrl+C (na grade)Copiar a chave da nota selecionada
Ctrl+D ou duplo cliqueGerar o DANFE da nota selecionada
Tab, Enter, EspaçoNavegar entre os controles e acionar botões

Limitações conhecidas

O que aconteceO que fazer
XMLs em caminhos com mais de 259 caracteres (pasta + nome do arquivo) não são lidos.Use uma pasta com caminho mais curto (ex.: C:\XMLs).
Caracteres fora do padrão do Windows em português no nome da pasta (ex.: emoji, alguns idiomas) se perdem, e a pasta não é encontrada.Renomeie a pasta usando só letras, números e acentos comuns.
Se um layout do DANFE (pasta Report\) estiver corrompido, o PDF não sai e o programa só volta para a tela Notas, sem mensagem de erro.Execute o instalador de novo ou, na versão portátil, copie a pasta Report\ do ProXML.zip.
Ao arrastar a janela para um monitor com escala maior, as caixas de SSL e TLS ficam pequenas.Continuam funcionando. Para o tamanho certo, feche e abra o ProXML nesse monitor.
Na tela Enviar, a faixa de erro pode fazer aparecer uma barra de rolagem.Role a tela: todos os campos e botões continuam acessíveis.
O tamanho mínimo da janela cresce com a escala do Windows (1024×640 vezes a escala: 1280×800 em 125%, 1536×960 em 150%), limitado ao tamanho da tela.Nada: é o espaço que o conteúdo precisa nessa escala.
Nota cancelada continua somada. O cancelamento é um evento separado e o XML da nota continua autorizado.Retire da pasta os XMLs das notas canceladas antes de processar.
Com a janela no tamanho mínimo, a Chave pode aparecer cortada com “…” na grade.Copiar chave copia a chave inteira. Para vê-la na grade, aumente a janela.
Fora da escala de 100%, a visualização do relatório na tela pode ficar um pouco diferente do PDF.O PDF não depende da escala: use o PDF como referência.
A conferência de IBS/CBS não é uma validação fiscal completa: alguns casos ficam sem conferência e, no Simples Nacional, a alíquota do Simples não é conferida.Use a coluna, o Resumo e o relatório como indicação para conferir. Veja o que fica sem conferência.
A senha do e-mail fica sem criptografia no db\notas.db.Não compartilhe o arquivo db\notas.db.

Baixe o ProXML e comece agora

Grátis, para Windows 10 e 11. Ainda tem dúvidas? Veja as perguntas frequentes sobre o ProXML.