Perguntas frequentes sobre o ProXML
Respostas curtas sobre segurança, instalação, leitura dos XMLs, conferência de IBS/CBS, DANFE, relatórios e e-mail. As dúvidas sobre IBS, CBS e a Reforma Tributária estão na página da Reforma Tributária.
Sobre o ProXML
Quanto custa o ProXML?
Nada. O ProXML é grátis e não tem anúncios. Se quiser ajudar o projeto, você pode apoiar o ProXML no Apoia.se, mas não é obrigatório.
O que o ProXML faz?
Lê uma pasta de XMLs de NF-e (55) e NFC-e (65), soma os valores das notas autorizadas (Valor Total, Base ICMS, ICMS, IBS e CBS), refaz as contas de IBS e CBS de cada nota e ajuda a conferir, imprimir e enviar esses arquivos: grade com busca, DANFE em PDF, relatórios, CSV e envio por e-mail. Veja todas as funcionalidades.
Funciona com NFC-e?
Sim. O ProXML lê NFC-e (modelo 65) e NF-e (modelo 55), inclusive misturadas na mesma pasta. O filtro Todos / NF-e 55 / NFC-e 65 separa os totais por modelo, e o DANFCe da NFC-e sai em PDF A4.
Lê outros documentos, como CT-e ou NFS-e?
Não. O ProXML lê só NF-e (55) e NFC-e (65). Arquivos de outros modelos ou que não são Nota Fiscal ficam de fora dos totais e aparecem nos Detalhes da leitura com o motivo.
Segurança, internet e instalação
O ProXML é seguro?
Sim. O ProXML lê os XMLs no seu computador e não manda as suas notas para nenhum servidor. O instalador não pede senha de administrador, e o projeto é publicado no repositório do ProXML no GitHub.
Baixe sempre pela página de download ou pela página de Releases do GitHub.
Meus XMLs vão para a internet?
Não. A leitura, os totais, o DANFE e os relatórios são feitos no seu computador. Os XMLs só saem dele se você usar a tela Enviar: nesse caso, vão num .zip para o e-mail que você digitar em Para.
Precisa de internet?
Só para baixar o programa e para enviar e-mails. Ler os XMLs, ver os totais, gerar o DANFE, os relatórios e o CSV funciona sem internet.
Por que o Windows mostra “O Windows protegeu o computador”?
Porque o instalador não tem assinatura digital, e o Windows SmartScreen avisa sobre programas sem assinatura baixados da internet. Clique em Mais informações e depois em Executar assim mesmo. Veja o passo a passo do aviso do SmartScreen.
Em qual Windows o ProXML funciona?
Windows 10 ou 11, 32 ou 64 bits. Não há versão para Mac ou Linux.
Instalador ou versão portátil: qual escolher?
O instalador é o recomendado: cria os atalhos e facilita a atualização, mantendo as suas configurações. A versão portátil (.zip) não instala nada: você extrai numa pasta e abre o ProXML.exe. Compare as duas opções na página de download.
Como atualizar sem perder as configurações?
No instalador, execute o setup da versão nova: ele mantém a pasta db\. Na versão portátil, copie os arquivos novos por cima, mas não substitua a sua pasta db\. Veja os detalhes da atualização.
Leitura dos XMLs e totais
Por que algumas notas ficaram de fora dos totais?
Porque só entram as notas autorizadas: cStat 100 (autorizado o uso) ou 150 (autorizado fora de prazo), lido do protocolo de autorização. Notas não autorizadas (por exemplo, denegadas), sem protocolo, de outros modelos ou arquivos que não puderam ser lidos ficam de fora. O motivo de cada uma aparece nos Detalhes da leitura, na tela Resumo.
Nota cancelada entra no total?
Sim, 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.
O ProXML separa notas de entrada e de saída?
Não. Nas NF-e (55), as notas de entrada e de saída são somadas juntas. Quando há NF-e de entrada, o Resumo mostra um aviso. Para conferir só as vendas, processe uma pasta que tenha apenas as notas de saída.
E as notas de homologação (ambiente de testes)?
Elas são somadas aos totais, mas o Resumo mostra um aviso com a quantidade, para você conferir se a pasta é a certa. Notas de homologação não têm valor fiscal.
Como abrir o CSV no Excel?
Abra o arquivo direto no Excel, sem importar. O CSV do ProXML é feito para o Excel em português: separado por ponto e vírgula, com vírgula decimal e acentos corretos. Ele traz as notas visíveis na lista, com o filtro de modelo e a busca aplicados.
O ProXML tem alguma limitação conhecida?
Sim, e todas têm um jeito de contornar. Por exemplo: XMLs em caminhos com mais de 259 caracteres não são lidos (use uma pasta como C:\XMLs). Veja a lista completa de limitações conhecidas.
Conferência de IBS/CBS
O ProXML diz que a minha nota tem erro de IBS/CBS. E agora?
Erro quer dizer que uma conta não fecha com os próprios valores do XML: no item (por exemplo, base vezes alíquota, ou IBS UF mais IBS municipal) ou entre os itens e os totais da nota (soma diferente ou grupo de total faltando). Para ver o que não fecha:
- Na tela Notas, passe o mouse sobre a célula Erro da coluna IBS/CBS: a dica diz quantas contas não fecham.
- Veja o bloco da conferência no fim dos Detalhes da leitura, na tela Resumo, ou gere o relatório Divergências IBS/CBS na tela Relatórios. Cada linha mostra a nota, o item, o campo, o valor no XML e o esperado.
- Leve essas informações a quem emitiu a nota ou a quem cuida da parte fiscal, para avaliarem o que fazer.
A conferência só informa: os cards continuam somando os valores do XML. Veja como ler a conferência no tutorial.
Qual a diferença entre Erro e Alerta?
Erro indica uma conta que não fecha com os próprios valores do XML, no item ou nos totais. Alerta é o que depende da operação e da regra legal: base de cálculo, alíquota, redução, CST e cClassTrib.
Alerta não é erro: é uma indicação para conferir a nota com quem cuida da parte fiscal, não uma afirmação de que a nota está errada. Uma nota com Erro e Alerta aparece como Erro na coluna IBS/CBS.
Por que a coluna IBS/CBS está vazia em algumas notas?
Porque essas notas não têm IBS/CBS no XML e ficam fora da conferência. Elas continuam entrando no Valor Total e nos totais de ICMS normalmente.
O ProXML confere tudo do IBS e da CBS?
Não. A conferência não é uma validação fiscal completa e não substitui a validação da SEFAZ nem a análise fiscal. Na versão 1.3.0, ficam sem conferência a tributação monofásica, a transferência de crédito, os ajustes da ZFM e de competência, as compras governamentais, as alíquotas que ainda dependem da alíquota de referência ou da lei de cada ente (CBS a partir de 2027 e IBS a partir de 2029), a base e as alíquotas de devoluções, a base de notas complementares, de ajuste, de crédito e de débito e as alíquotas de algumas notas de crédito. O Resumo informa esses casos, sem contar como divergência.
Nos itens do Simples Nacional com o grupo do Simples, o ProXML confere a soma do IBS e da CBS do Simples com o total da nota, se o grupo vem nos itens e no total, e o cClassTrib. A alíquota do Simples depende do anexo e da faixa de faturamento e não é conferida. Quando o item também traz o grupo de cálculo do IBS/CBS, ele é conferido como nas outras notas. As regras seguem a NT 2025.002 v1.53, a NT 2026.005 v1.00 e a tabela de cClassTrib v1.71. Veja o que o ProXML confere.
DANFE, relatórios e e-mail
Onde ficam os PDFs do DANFE?
Na pasta NFCe\danfePDF do ProXML. Quem usou o instalador encontra essa pasta em %LocalAppData%\ProXML\NFCe\danfePDF. O PDF também abre sozinho quando fica pronto. Veja como gerar o DANFE a partir do XML.
Quais relatórios o ProXML gera?
Três, na tela Relatórios: o Relatório de Notas (valor, base do ICMS e ICMS de cada nota), o Relatório IBS/CBS (só com as notas que têm o grupo IBS/CBS) e o Divergências IBS/CBS (os erros e alertas da conferência de IBS/CBS, um por linha). Os três saem em A4, com o período, o modelo, a pasta e a linha de total.
Preciso do WinRAR para enviar os XMLs?
Não. Desde a versão 1.2, o próprio ProXML cria o anexo NFCe_ProXML.zip na hora de enviar.
Como configurar o envio pelo Gmail?
Em Configurações, use o servidor smtp.gmail.com, porta 465 com SSL ou 587 com TLS, o seu e-mail e uma senha de app do Google. Clique em Testar conexão antes de salvar. Veja o passo da configuração do e-mail.
Minha senha de e-mail fica salva?
Sim, sem criptografia, no arquivo db\notas.db da pasta do ProXML. Não compartilhe esse arquivo depois de configurado.
Dúvidas sobre IBS, CBS e a Reforma Tributária
O que são o IBS e a CBS, o que muda em 2026 e se o ProXML calcula esses valores: veja as perguntas frequentes sobre a Reforma Tributária. Para o detalhe técnico das tags, veja IBS e CBS no XML da NF-e.