Conversor de XML de Cancelamento NF-e

Novo Avanço → procEventoNFe

Download do programa aqui

📌 1. Contexto

O sistema Novo Avanço gera XMLs de NF-e no formato nfeProc, contendo:


Quando uma nota é cancelada, o sistema não gera o XML do evento de cancelamento completo, apenas registra o cancelamento dentro do protocolo da NF-e.

Por outro lado, algumas integrações, auditorias fiscais e ferramentas externas exigem o XML no formato:

procEventoNFe

Este produto resolve exatamente esse gap.

🎯 2. Objetivo do Produto

Converter XMLs de NF-e canceladas (formato nfeProc) em XMLs no formato completo de evento:

procEventoNFe

Garantindo:

⚙️ 3. Funcionamento Geral

O conversor executa o seguinte fluxo:

🔄 Fluxo de execução

  1. Usuário seleciona pasta de origem (XMLs do Novo Avanço)
  2. Usuário seleciona pasta de destino
  3. Sistema percorre todos os XMLs
  4. Para cada XML:
    • Lê os dados necessários
    • Monta a estrutura procEventoNFe
    • Gera um novo XML
  5. Exibe progresso e logs em tempo real

image.png

🧠 4. Estrutura dos XMLs

📥 Entrada (Novo Avanço)

Formato:

nfeProc
 ├── NFe
 └── protNFe
      └── infProt

Contém:

📤 Saída (Gerado pelo Conversor)

Formato:

procEventoNFe
 ├── evento
 │    ├── infEvento
 │    └── Signature
 └── retEvento
      └── infEvento

🔗 5. Correspondência de Campos

Campo destino Origem Regra
cOrgao ide/cUF Direto
tpAmb ide/tpAmb Direto
CNPJ emit/CNPJ Direto
chNFe protNFe/infProt/chNFe Direto
dhEvento dhRecbto Padrão (ou manual)
tpEvento — Fixo: 110111
nSeqEvento — Fixo: 1
verEvento — Fixo: 1.00
descEvento — Fixo: Cancelamento
nProt (evento) protNFe/nProt Direto
xJust xMotivo Padrão (ou manual)

📌 Retorno (retEvento)

Campo Origem
tpAmb tpAmb
verAplic verAplic
cOrgao cUF
cStat cStat
xMotivo xMotivo
chNFe chNFe
tpEvento Fixo
xEvento "CANCELAMENTO"
nSeqEvento Fixo
dhRegEvento dhRecbto
nProt nProt

🧩 6. Tratamento dos Campos

🔹 tpEvento

🔹 nSeqEvento

🔹 xJust

🔹 dhEvento

🔹 Signature

🖥️ 7. Interface do Sistema

A interface web local permite:

📂 Seleção de pastas

🧾 Campos configuráveis

Todos já vêm com valores padrão.

📊 Execução

🛑 Controle

▶️ 8. Como Usar

Passo a passo

  1. Abrir o programa
  2. Selecionar pasta de origem
  3. Selecionar pasta de destino
  4. (Opcional) Ajustar campos
  5. Clicar em Iniciar conversão

Durante a execução

Cancelamento

Resultado

<nome_original>_procEventoNFe.xml

⚠️ 9. Limitações

🔒 10. Considerações Técnicas

🧪 11. Compatibilidade

🏁 12. Conclusão

O Conversor de XML de Cancelamento do Novo Avanço:

 

⚙️ Regras de Alteração dos Campos

Esta seção define quais campos podem ser alterados pelo usuário, quais não devem ser alterados, e quais são sensíveis para integridade fiscal.

🔒 1. Campos NÃO editáveis (fixos / controlados pelo sistema)

Esses campos são definidos automaticamente pelo conversor e não devem ser alterados, pois fazem parte da estrutura fiscal obrigatória.

Campo Origem Motivo
cOrgao XML original Define a UF (SEFAZ responsável)
tpAmb XML original Ambiente (produção/homologação)
CNPJ XML original Emitente da nota
chNFe XML original Identificação única da NF-e
nProt XML original Protocolo da nota
cStat XML original Status fiscal
xMotivo XML original Retorno da SEFAZ
verEvento Fixo (1.00) Versão do layout
descEvento Fixo (Cancelamento) Tipo do evento
xEvento Fixo (CANCELAMENTO) Descrição padronizada
verAplic XML original Versão da aplicação SEFAZ

⚠️ Importante

Alterar qualquer um desses campos pode:

🟡 2. Campos editáveis com restrição

Esses campos podem ser alterados, mas com cuidado.

🔹 xJust (Justificativa do cancelamento)

✔ Padrão:

xMotivo do XML

✔ Pode ser alterado?

Sim

⚠️ Regras:

❗ Riscos ao alterar:

🔹 dhEvento (Data/hora do evento)

✔ Padrão:

dhRecbto do XML

✔ Pode ser alterado?

Sim

⚠️ Regras:

YYYY-MM-DDTHH:mm:ss-03:00

❗ Riscos ao alterar:

🟢 3. Campos editáveis seguros

Esses campos são controlados, mas não afetam integridade fiscal diretamente.

🔹 tpEvento

✔ Padrão:

110111

✔ Pode ser alterado?

Não recomendado

⚠️ Motivo:

🔹 nSeqEvento

✔ Padrão:

1

✔ Pode ser alterado?

Sim (com ressalvas)

⚠️ Regras:

❗ Riscos:

🧠 4. Resumo Geral

Campo Pode alterar? Nível de risco
xJust ✔ Sim Médio
dhEvento ✔ Sim Médio
nSeqEvento ✔ Sim Baixo
tpEvento ⚠ Não recomendado Alto
Demais campos ❌ Não Crítico

🎯 5. Recomendação de Uso

Para uso seguro:

🏁 Conclusão

O conversor já define automaticamente todos os campos necessários para gerar um XML válido.

As alterações devem ser feitas apenas quando houver necessidade real, evitando inconsistências fiscais ou divergências com o registro original da NF-e.

Revision #1
Created 30 March 2026 01:03:01 by Luiz Paulo
Updated 30 March 2026 01:13:27 by Luiz Paulo