Notas canceladas e duplicadas no lote de XMLs: como encontrar antes de fechar

Três tipos de arquivo distorcem o fechamento sem fazer barulho: a nota que foi cancelada mas continua somando, a nota que aparece duas vezes no lote e a nota de teste emitida em homologação. Nenhuma delas dá erro ao abrir. Todas inflam o total.
Este artigo mostra como reconhecer cada caso direto no XML e como a mesa do xml2xlsx sinaliza esses arquivos antes da exportação.
Por que esses problemas aparecem
Os XMLs chegam de várias origens: e-mail do fornecedor, exportação do sistema emissor, pastas compartilhadas, downloads feitos em dias diferentes. É comum o mesmo arquivo vir duas vezes com nomes distintos. Também é comum a nota chegar num mês e o evento de cancelamento chegar depois, em outro arquivo.
O ponto central é este: o cancelamento não altera o XML da nota. Ele é registrado como um evento separado, vinculado à nota pela chave de acesso. Se você olhar só o arquivo da nota, ela parece perfeitamente válida.
Notas canceladas: o evento de cancelamento
Como o cancelamento aparece no XML
Segundo o Manual de Orientação do Contribuinte (MOC 7.0) da NF-e e NFC-e, o cancelamento é feito por evento, e o XML de distribuição do evento tem raiz procEventoNFe. Os campos mais importantes do evento são:
chNFe: a chave de acesso da nota à qual o evento se refere;tpEvento: o código do evento;nSeqEvento: o número sequencial do evento;detEvento: os detalhes, que no cancelamento incluemnProt(protocolo de autorização da nota) exJust(justificativa).
Os códigos de cancelamento listados no MOC são:
- 110111, Cancelamento: o cancelamento da NF-e ou NFC-e pelo emitente.
- 110112, Cancelamento por substituição: criado pela NT 2018.004. O MOC informa que esse evento é específico para NFC-e e serve para cancelar, em prazo não superior a 168 horas, uma NFC-e emitida em duplicidade que não acobertou a operação. Nesse caso, o evento traz também
chNFeRef, a chave da NFC-e substituta. O MOC registra que esse prazo pode ser reduzido a critério de cada unidade federada.
Um recorte simplificado, com dados fictícios:
<procEventoNFe versao="1.00">
<evento versao="1.00">
<infEvento>
<tpAmb>1</tpAmb>
<chNFe>35261199888777000100550010000012341000012340</chNFe>
<tpEvento>110111</tpEvento>
<nSeqEvento>1</nSeqEvento>
<detEvento versao="1.00">
<descEvento>Cancelamento</descEvento>
<nProt>000000000000000</nProt>
<xJust>Exemplo ficticio de justificativa</xJust>
</detEvento>
</infEvento>
</evento>
</procEventoNFe>
Outros documentos
No CT-e, o MOC versão 4.00 também lista o evento 110111, Cancelamento, aplicável aos modelos 57, 67 e 64. Na NFS-e Padrão Nacional, os esquemas XSD oficiais usam outra codificação: e101101 para o evento de cancelamento e e105102 para o cancelamento por substituição. O manual da API do Emissor Público Nacional explica que, quando uma DPS é enviada para substituir uma NFS-e já gerada, o sistema gera o evento de cancelamento por substituição vinculado à nota original.
O que fazer na prática
Para saber se uma nota está cancelada pelo lote, você precisa ter o XML do evento junto com o XML da nota. Se o lote veio só com as notas, a ausência de evento no lote não prova que nenhuma foi cancelada. Nesse caso, a confirmação da situação deve ser feita nos canais oficiais de consulta.
Notas duplicadas: a chave de acesso
A chave de acesso identifica cada documento. Na NF-e e no CT-e ela tem 44 dígitos; na NFS-e Nacional, 50 dígitos. Dois arquivos com a mesma chave são o mesmo documento, não importa o nome do arquivo nem a data de download.
Duplicidade no lote quase sempre vem de:
- o mesmo XML salvo duas vezes, como
nota.xmlenota (1).xml; - downloads repetidos de fontes diferentes;
- junção de pastas de meses vizinhos.
Comparar pelo número da nota não basta: emitentes diferentes podem ter a mesma numeração, e o mesmo emitente pode ter séries diferentes. A comparação confiável é pela chave.
Não confunda duplicidade no lote com a situação descrita no evento 110112. Ali são duas NFC-e diferentes, com chaves diferentes, emitidas para a mesma operação. Aqui é o mesmo arquivo repetido.
Notas de homologação: SEM VALOR FISCAL
O campo tpAmb indica o ambiente: 1 para Produção e 2 para Homologação. Isso vale para NF-e, NFC-e, CT-e e também para a DPS da NFS-e Nacional. Documentos de homologação são testes e não têm valor fiscal.
O leiaute da NF-e reforça isso de forma visível. Em homologação, o nome do destinatário deve ser "NF-E EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL". Na NFC-e, a descrição do primeiro item deve ser "NOTA FISCAL EMITIDA EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL". No CT-e, a razão social do remetente segue regra semelhante, com o texto "CTE EMITIDO EM AMBIENTE DE HOMOLOGACAO - SEM VALOR FISCAL".
Esses arquivos aparecem no lote quando a empresa testa um sistema novo ou quando a pasta de testes do emissor é copiada junto com a de produção.
Resumo dos três casos
| Caso | Como identificar no XML | Efeito no fechamento | Como a mesa sinaliza |
|---|---|---|---|
| Cancelada | Evento com tpEvento 110111 (ou 110112, NFC-e) e a mesma chave da nota | A nota não deveria compor o total | Alerta "canceladas"; valor vai para o card de canceladas, fora do total |
| Duplicada | Dois arquivos com a mesma chave de acesso | O valor é somado duas vezes | Alerta "duplicadas" |
| Homologação | tpAmb igual a 2; textos "SEM VALOR FISCAL" | Documento de teste no meio dos reais | Alerta "homologação" |
Como a mesa do xml2xlsx sinaliza cada caso
O xml2xlsx é uma mesa de trabalho gratuita no navegador, sem cadastro. Os XMLs são lidos no servidor só para extrair os dados e não ficam guardados lá; a conversa fica salva no seu próprio navegador. Ela aceita NF-e, NFC-e, CT-e, NFS-e Padrão Nacional e eventos de cancelamento e carta de correção, até 2.000 notas por conversa.
Ao soltar o lote, a mesa cruza os arquivos e mostra três alertas:
- Canceladas: quando o evento de cancelamento da mesma chave está no lote. O valor dessas notas aparece no card de canceladas do Panorama, separado do total.
- Duplicadas: quando dois ou mais arquivos têm a mesma chave.
- Homologação: quando o documento tem
tpAmbigual a 2.
Um único botão desmarca canceladas e duplicadas de uma vez. Se mudar de ideia, use desfazer. O card de total marcado considera apenas as notas válidas que continuam marcadas, então você vê na hora o efeito da limpeza.
Para conferir um caso específico, use a busca e os filtros da tabela de notas e abra o painel de detalhe. Depois, exporte o XLSX com as abas "Notas", "Itens" e "Resumo por tipo", ou o ZIP com os XMLs originais, o XLSX e um LEIAME. A aba "Exportações" guarda o histórico e permite baixar de novo com as mesmas notas.
Os alertas ajudam a encontrar os problemas, mas a decisão sobre o tratamento contábil e fiscal de cada documento é sua. Em caso de dúvida, confirme com a legislação do seu estado ou município.
Antes de repassar o lote
Se o lote vai para outra pessoa (o contador, o cliente ou outro setor da empresa), a regra muda um pouco:
- Duplicadas saem. O segundo arquivo da mesma chave não acrescenta nada e só dobra o valor.
- Canceladas ficam, junto com o evento. Quem recebe o lote precisa saber que a nota existiu e foi cancelada. A contabilidade deve ser informada das notas canceladas, mesmo quando elas não representam receita. Na mesa, desmarque só as duplicadas: com as canceladas marcadas, o ZIP leva cada nota com o seu evento de cancelamento, e a planilha mostra essas notas separadas das válidas, fora da soma.
- Homologação sai. Documento de teste não tem valor fiscal e não deve ir para o fechamento.
Limpe o lote antes de fechar
Junte as notas e os eventos do período, solte tudo na mesa e resolva os alertas antes de exportar. Leva poucos minutos e evita refazer o fechamento depois. Abrir a mesa
Fontes
- Contabilidade.com: Preciso enviar as notas fiscais canceladas para o contador? (abre em nova aba)
- Portal Nacional da NF-e: Manuais (abre em nova aba)
- Manual de Orientação ao Contribuinte (MOC) 7.0, NF-e e NFC-e (PDF) (abre em nova aba)
- MOC 7.0, Anexo I: Leiaute e Regras de Validação, NF-e e NFC-e (PDF) (abre em nova aba)
- Portal do CT-e: Manuais (abre em nova aba)
- MOC CT-e, Visão Geral, versão 4.00 (PDF) (abre em nova aba)
- MOC CT-e, Anexo I: Leiaute e Regras de Validação, versão 4.00 (PDF) (abre em nova aba)
- Esquemas XSD da NFS-e Nacional v1.01 (ZIP) (abre em nova aba)
- Manual de Contribuintes: API do Emissor Público Nacional NFS-e (PDF) (abre em nova aba)
- NF-e
- cancelamento
- duplicidade
- homologação
- fechamento mensal