Repository navigation
Releases
ProXML v1.3.0
ProXML v1.3.0
O ProXML passa a conferir os cálculos de IBS e CBS das notas autorizadas: refaz as contas de cada item e dos totais e aponta o que não fecha na grade, no Resumo e num relatório novo. A tela Sobre ganha os links do site e do Apoia.se.
Download
Recomendado: instalador
- Baixe o ProXML-Setup.exe.
- Execute e siga as telas. O ProXML é instalado só para o seu usuário, em
%LocalAppData%\ProXML, sem pedir administrador, com atalho no Menu Iniciar e (opcional, já marcado) na Área de Trabalho.
Aviso do Windows (SmartScreen): o instalador não tem assinatura digital, então o Windows pode mostrar "O Windows protegeu o computador". Clique em Mais informações e depois em Executar assim mesmo.
Já usa o instalador da v1.2.0? Basta executar o setup novo: ele substitui o programa e mantém a pasta db\ (configurações). O banco é atualizado sozinho na primeira execução.
Versão portátil
- Baixe o ProXML.zip.
- Extraia para uma pasta (ex.:
C:\ProXML): botão direito → Extrair tudo. - Execute o
ProXML.exe.
Atualizando a versão portátil
Não substitua a pasta
db\. O pacote traz umnotas.dbvazio: se você copiar a pastadb\por cima da sua, as configurações de e-mail são apagadas. Copie o resto e mantenha a suadb\; o banco antigo é atualizado sozinho na primeira execução, sem perder dados.
Quem ainda usa o instalador antigo (setupProXML.exe) encontra o passo a passo para trocar no README.
Novidades
Conferência de IBS/CBS
O ProXML refaz as contas de IBS e CBS de cada item e dos totais das notas autorizadas e mostra o resultado na coluna IBS/CBS da tela Notas, no Resumo e no relatório Divergências IBS/CBS. A conferência só informa: não muda os totais, os cards nem os contadores. Ela segue a NT 2025.002 v1.53, a NT 2026.005 v1.00 (Simples Nacional) e a tabela de cClassTrib v1.71 e não substitui a validação da SEFAZ nem a análise fiscal.
| Nível | O que confere | Resultado |
|---|---|---|
| 1. Conta do item | IBS UF, IBS municipal e CBS = base × alíquota (com a alíquota efetiva quando há redução) e IBS = IBS UF + IBS municipal | Erro |
| 2. Itens × totais | A soma dos itens bate com os totais da nota (IBSCBSTot) |
Erro |
| 3. Base de cálculo | A base do item comparada com a soma do valor do produto, frete, seguro e outras despesas, menos o desconto e os tributos que saem da base em 2026 (ICMS, PIS, Cofins, ISS e FCP) | Alerta |
| 4. Alíquota, redução e CST | Alíquota esperada para o ano da emissão, redução coerente com o CST e o cClassTrib, diferimento e grupos previstos na tabela oficial | Alerta |
- Simples Nacional (NT 2026.005): nas notas com o grupo do Simples (
gTribSN), o ProXML confere se a soma do IBS e da CBS do Simples dos itens bate com o total da nota e se o grupo vem nos itens e no total. A alíquota do Simples depende do anexo e da faixa de faturamento e não é conferida. - Tela Notas: coluna IBS/CBS, sempre visível, com OK, Alerta ou Erro (vazia nas notas sem IBS/CBS). A dica de cada célula explica o resultado, e o clique no título ordena por gravidade (Erro primeiro).
- Resumo: bloco no fim dos Detalhes da leitura, com uma linha de resumo e uma linha por divergência, com o valor do XML e o esperado.
- Relatórios: novo relatório Divergências IBS/CBS, com uma linha por divergência (nota, item, nível, tipo, campo, valor no XML e esperado) e a contagem de notas com Erro e com Alerta.
- Exportar CSV: coluna Conferência IBS/CBS no fim, com OK, Alerta ou Erro. As outras colunas não mudam de lugar.
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.
Tela Sobre
- Links para o site (https://proxml.vercel.app) e para o repositório no GitHub, e o botão Apoiar no Apoia.se, para quem quiser apoiar o desenvolvimento do ProXML, que é gratuito e sem anúncios.
Atenção
NF-e (55): entradas e saídas são somadas juntas, sem distinção. Se a pasta tiver compras e vendas misturadas, os totais misturam as duas. Para conferir só as vendas, processe uma pasta com apenas as notas de saída.
Limitações conhecidas
Conferência de IBS/CBS
- Não é uma validação fiscal completa. Use a coluna, o Resumo e o relatório como indicação para conferir.
- Casos sem conferência na v1.3.0 (o Resumo informa, sem contar como divergência):
- tributação monofásica (CST 620) e os totais do monofásico e do estorno de crédito;
- transferência de crédito (CST 800);
- ajustes de competência e da ZFM (CST 810 e 811) e o crédito presumido da ZFM;
- compras governamentais;
- alíquotas que a lei ainda não fixou: CBS a partir de 2027 e IBS a partir de 2029;
- base e alíquotas de devoluções e a base de notas complementares, de ajuste, de crédito e de débito.
- Simples Nacional: só a soma do grupo do Simples (
gTribSN) com o total da nota é conferida; a base e a alíquota do Simples, não. - As regras ficam dentro do programa (NT 2025.002 v1.53, NT 2026.005 v1.00 e tabela de cClassTrib v1.71). Uma versão nova da NT ou da tabela pode mudar o resultado; as versões usadas aparecem no relatório Divergências IBS/CBS.
Gerais
- Caminho com mais de 259 caracteres (pasta + nome do arquivo): o XML não é lido. Use uma pasta com caminho mais curto (ex.:
C:\XMLs). - Caractere fora do padrão do Windows em português no nome da pasta (ex.: emoji, alguns idiomas): ele se perde e a pasta não é encontrada. Renomeie a pasta.
- Layout do DANFE corrompido em
Report\: o PDF não sai e o programa só volta para a tela Notas, sem mensagem. Execute o instalador de novo ou, na versão portátil, copie a pastaReport\doProXML.zip. - Caixas de SSL e TLS pequenas ao arrastar a janela para um monitor com escala maior: continuam funcionando; feche e abra o ProXML nesse monitor para o tamanho certo.
- Faixa de erro na tela Enviar pode fazer aparecer uma barra de rolagem: role a tela, tudo continua acessível.
- Tamanho mínimo da janela cresce com a escala (1024×640 vezes a escala: 1280×800 em 125%, 1536×960 em 150%), limitado ao tamanho da tela.
- Nota cancelada continua somada: o cancelamento é um evento separado e o XML da nota continua autorizado. Retire da pasta os XMLs das notas canceladas.
- Chave com "…" na grade com a janela no tamanho mínimo: Copiar chave copia a chave inteira; aumente a janela para vê-la.
- 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 como referência.
- Senha do e-mail sem criptografia no
db\notas.db: não compartilhe esse arquivo.
Requisitos
- Windows 10 ou 11 (32 ou 64 bits).
Mais informações
Tutorial, como gerar o DANFE e dúvidas sobre a Reforma Tributária (IBS e CBS) no site: https://proxml.vercel.app
Verificação
| Arquivo | SHA-256 |
|---|---|
ProXML-Setup.exe |
8394a89eff7bd380028d8728bd0e28c16c0e5b26e750254e5f5829146d37aa71 |
ProXML.zip |
083cbfa4a619277c13128278cdf7219877c5a3690976359bd5ceb151a7e95f3f |
ProXML v1.2.0
ProXML v1.2.0
O ProXML ganha um instalador para Windows e passa a enviar os XMLs por e-mail num anexo .zip criado pelo próprio programa, sem precisar do WinRAR. A versão portátil agora é um .zip, que o Windows abre sem programas extras.
Download
Recomendado: instalador
- Baixe o ProXML-Setup.exe.
- Execute e siga as telas. O ProXML é instalado só para o seu usuário, em
%LocalAppData%\ProXML, sem pedir administrador, com atalho no Menu Iniciar e (opcional, já marcado) na Área de Trabalho.
Aviso do Windows (SmartScreen): o instalador não tem assinatura digital, então o Windows pode mostrar "O Windows protegeu o computador". Clique em Mais informações e depois em Executar assim mesmo.
Para atualizar nas próximas versões, basta executar o setup novo: a pasta db\ (configurações) é mantida. Ao desinstalar pelo Windows, a pasta db\ e o que estiver em NFCe\ ficam em %LocalAppData%\ProXML.
Versão portátil
- Baixe o ProXML.zip.
- Extraia para uma pasta (ex.:
C:\ProXML): botão direito → Extrair tudo. - Execute o
ProXML.exe.
Atualizando a partir da v1.1.0 (portátil)
Não substitua a pasta
db\. O pacote traz umnotas.dbvazio: se você copiar a pastadb\por cima da sua, as configurações de e-mail são apagadas. Copie o resto e mantenha a suadb\; o banco antigo é atualizado sozinho na primeira execução.
Se preferir passar para o instalador: instale com o ProXML-Setup.exe e, com o ProXML fechado, copie o db\notas.db da pasta antiga para %LocalAppData%\ProXML\db, substituindo o arquivo que está lá. O WinRAR.exe que estiver na pasta antiga não é mais usado.
Quem usou o instalador antigo (setupProXML.exe)
O instalador novo não substitui o antigo. Para trocar:
- Se quiser manter as configurações, copie antes o
db\notas.dbda pasta do ProXML antigo para um lugar seguro. - Desinstale a versão antiga pelo Windows (Configurações → Aplicativos).
- Instale com o
ProXML-Setup.exe. - Com o ProXML fechado, copie o
notas.dbguardado para%LocalAppData%\ProXML\db, substituindo o arquivo que está lá.
Novidades
- Instalador (
ProXML-Setup.exe): instalação por usuário, sem administrador, com atalhos no Menu Iniciar e na Área de Trabalho. Atualizar é só executar o setup novo, sem perder as configurações. - E-mail sem WinRAR: os XMLs vão num anexo
NFCe_ProXML.zip, criado pelo próprio ProXML. Não é mais preciso copiar oWinRAR.exepara a pasta do programa. - Versão portátil em
.zip(ProXML.zip), que o Windows abre sem programas extras.
Correções
- O ProXML encontra o banco e as configurações mesmo quando é aberto por um atalho ou por outro programa que inicia em outra pasta.
- Se não for possível montar o anexo do e-mail (ex.: arquivo em uso ou disco cheio), aparece uma mensagem clara e o e-mail não é enviado.
Atenção
NF-e (55): entradas e saídas são somadas juntas, sem distinção. Se a pasta tiver compras e vendas misturadas, os totais misturam as duas. Para conferir só as vendas, processe uma pasta com apenas as notas de saída.
Limitações conhecidas
- Caminho com mais de 259 caracteres (pasta + nome do arquivo): o XML não é lido. Use uma pasta com caminho mais curto (ex.:
C:\XMLs). - Caractere fora do padrão do Windows em português no nome da pasta (ex.: emoji, alguns idiomas): ele se perde e a pasta não é encontrada. Renomeie a pasta.
- Layout do DANFE corrompido em
Report\: o PDF não sai e o programa só volta para a tela Notas, sem mensagem. Execute o instalador de novo ou, na versão portátil, copie a pastaReport\doProXML.zip. - Caixas de SSL e TLS pequenas ao arrastar a janela para um monitor com escala maior: continuam funcionando; feche e abra o ProXML nesse monitor para o tamanho certo.
- Faixa de erro na tela Enviar pode fazer aparecer uma barra de rolagem: role a tela, tudo continua acessível.
- Tamanho mínimo da janela cresce com a escala (1024×640 vezes a escala: 1280×800 em 125%, 1536×960 em 150%), limitado ao tamanho da tela.
- Nota cancelada continua somada: o cancelamento é um evento separado e o XML da nota continua autorizado. Retire da pasta os XMLs das notas canceladas.
- Chave com "…" na grade com a janela no tamanho mínimo: Copiar chave copia a chave inteira; aumente a janela para vê-la.
- 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 como referência.
- Senha do e-mail sem criptografia no
db\notas.db: não compartilhe esse arquivo.
Requisitos
- Windows 10 ou 11 (32 ou 64 bits).
Verificação
| Arquivo | SHA-256 |
|---|---|
ProXML-Setup.exe |
04833ce0286277405ee0bf1cfa0a429edd3791e5ac2c5f1c0b8173b8da70dace |
ProXML.zip |
dc632fb545b3d063dfd1649875f36958586d6c7b22075288cfa41904477fdc08 |
ProXML v1.1.0
ProXML v1.1.0
O ProXML passa a ler NF-e (55) além da NFC-e (65), com os totais de IBS/CBS da Reforma Tributária, e ganha uma interface toda nova: janela redimensionável, processamento sem travar a tela, busca na grade e relatórios redesenhados.
Download
- Baixe o ProXML.rar.
- Extraia para uma pasta (ex.:
C:\ProXML). - Execute o
ProXML.exe.
Atualizando de uma versão anterior? Não substitua a pasta
db\. O pacote traz umnotas.dbvazio: se você copiar a pastadb\por cima da sua, as configurações de e-mail são apagadas. Copie o resto e mantenha a suadb\; o banco antigo é atualizado sozinho na primeira execução.
Novidades fiscais
- NF-e (55) e NFC-e (65) na mesma pasta. Outros modelos são ignorados e aparecem nos detalhes da leitura.
- Nota autorizada =
cStat100 ou 150, lido do protocolo. Notas não autorizadas (ex.: denegadas) ficam fora de todos os totais e aparecem com o código. - IBS e CBS (NT 2025.002): leitura do grupo
IBSCBSTot(Base IBS/CBS, IBS UF, IBS municipal, IBS e CBS), com cards próprios e o novo Relatório IBS/CBS. - Filtro de modelo (Todos, NF-e 55, NFC-e 65) valendo para cards, grade, CSV, relatórios e e-mail.
- DANFE por modelo: NFC-e no DANFCe A4; NF-e no layout retrato ou paisagem, conforme o
tpImpdo XML. - Chave de acesso lida da própria nota (44 dígitos) e conferida com o protocolo.
- Aviso no Resumo quando os totais incluem notas de homologação ou NF-e de entrada.
Interface nova
- Janela redimensionável e maximizável, que lembra o tamanho, a posição e a última pasta.
- Menu lateral Resumo, Notas, Relatórios, Enviar, Configurações, com o item ativo destacado, e tela Sobre.
- 5 cards no topo (Valor Total, Base ICMS, ICMS, IBS, CBS) em
R$ 1.234,56. - Arrastar e soltar a pasta na janela.
- Processamento em segundo plano com "X de N arquivos", Cancelar e resumo com contadores (Autorizadas, Ignoradas, Com erro), tempo e detalhes da leitura.
- Tela Notas com busca por número ou chave, ordenação pelo título, Copiar chave, Gerar DANFE (também no duplo clique) e Exportar CSV pronto para o Excel em português.
- Tela Relatórios com o Relatório de Notas e o Relatório IBS/CBS num layout novo: período, modelo, pasta, colunas alinhadas, valores em R$ e "Página X de Y".
- Tela Enviar mostra o anexo (quantidade e tamanho) antes de enviar; o envio acontece em segundo plano.
- Configurações com validação dos campos e Testar conexão (não envia e-mail).
- Atalhos: Ctrl+O, F5, Esc, Ctrl+F, Ctrl+C, Ctrl+D, e uso completo pelo teclado.
- Suporte à escala do Windows: 100%, 125%, 150% e dois monitores com escalas diferentes.
Correções
- A tela não congela mais durante a leitura dos XMLs nem durante o envio do e-mail.
- O botão Processar não fica mais travado depois de um erro na leitura.
- Os valores não dependem mais do idioma configurado no Windows.
- Os totais aparecem com separador de milhar.
- Gerar o DANFE não fica mais esperando para sempre quando o PDF não sai.
- Abrir as telas Relatório e Enviar não grava nem compacta mais nada sem você pedir.
- Erros ao salvar ou ler as configurações de e-mail agora aparecem na tela.
- O DANFE paisagem mostra "Folha 1/1" no lugar de "Folha 1/0".
- O DANFCe A4 não tem mais a linha cortando "Emissão … Via Consumidor".
- O Relatório de Notas tem as colunas alinhadas e a coluna Data.
- O envio por e-mail funciona com o ProXML numa pasta com espaço no nome.
- Se um XML não estiver mais na pasta, o e-mail não sai mais sem ele: aparece um aviso.
- XMLs em pastas com caminho longo (mais de 200 caracteres) passam a gerar DANFE e ir no e-mail.
- Os XMLs do anexo saem com o nome certo (
<chave>-nfe.xml, e não-nfe-nfe.xml). - Erros de digitação e mensagens com "!!" foram revisados em toda a interface.
Atenção
NF-e (55): entradas e saídas são somadas juntas, sem distinção. Se a pasta tiver compras e vendas misturadas, os totais misturam as duas. Para conferir só as vendas, processe uma pasta com apenas as notas de saída.
Limitações conhecidas
- Caminho com mais de 259 caracteres (pasta + nome do arquivo): o XML não é lido. Use uma pasta com caminho mais curto (ex.:
C:\XMLs). - Caractere fora do padrão do Windows em português no nome da pasta (ex.: emoji, alguns idiomas): ele se perde e a pasta não é encontrada. Renomeie a pasta.
- Layout do DANFE corrompido em
Report\: o PDF não sai e o programa só volta para a tela Notas, sem mensagem. Reinstale a pastaReport\do pacote. - Caixas de SSL e TLS pequenas ao arrastar a janela para um monitor com escala maior: continuam funcionando; feche e abra o ProXML nesse monitor para o tamanho certo.
- Faixa de erro na tela Enviar pode fazer aparecer uma barra de rolagem: role a tela, tudo continua acessível.
- Tamanho mínimo da janela cresce com a escala (1024×640 vezes a escala: 1280×800 em 125%, 1536×960 em 150%), limitado ao tamanho da tela.
- E-mail depende do
WinRAR.exena pasta do ProXML: copie-o para lá (o ZIP nativo vem na v1.2.0). - Nota cancelada continua somada: o cancelamento é um evento separado e o XML da nota continua autorizado. Retire da pasta os XMLs das notas canceladas.
- Chave com "…" na grade com a janela no tamanho mínimo: Copiar chave copia a chave inteira; aumente a janela para vê-la.
- 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 como referência.
- Senha do e-mail sem criptografia no
db\notas.db: não compartilhe esse arquivo.
Requisitos
- Windows 10 ou 11 (32 ou 64 bits).
- Para o e-mail:
WinRAR.exena pasta do ProXML.
Verificação
SHA-256 ProXML.rar: fa292bfc0d023fa5b360f453144f4dc862ccd6d5f697bb6f29bdb9815a60e16a
Pro XML v1.0.0
Pro XML v1.0.0
Primeira versão publicada do Pro XML — leitura e totalização de XMLs de NFC-e (modelo 65).
Download
Baixe o arquivo ProXML.rar abaixo, extraia em uma pasta (ex.: C:\ProXML) e execute ProXML.exe.
O que tem nesta versão
- Processamento em lote de XMLs de NFC-e com validação de modelo e autorização
- Totais de Valor, Base de ICMS e ICMS
- Geração de DANFCe em PDF e cópia da chave de acesso
- Relatório das notas processadas
- Envio dos XMLs compactados por e-mail (requer
WinRAR.exena pasta do programa)
Requisitos
- Windows (32 ou 64 bits)
SHA-256 ProXML.rar: 243951918d75d0ed0e1443dfd00dafb07dad0e5e9ee645f2bd7e918fd3db0dbc