Definição
Quebra de integridade de arquivo fiscal é a situação em que um documento fiscal eletrônico, como o XML de uma NF-e, é alterado ou corrompido depois de assinado digitalmente. Qualquer mudança, mesmo pequena, faz a assinatura deixar de corresponder ao conteúdo, e o arquivo perde a confiabilidade como prova da operação.
Também conhecido como: Fiscal file integrity breach, Violação de integridade do XML fiscal, XML fiscal adulterado, Arquivo fiscal corrompido, Quebra de integridade do XML
O que significa quebra de integridade de arquivo fiscal?
Documentos fiscais eletrônicos, como NF-e, NFC-e, CT-e, MDF-e e, em muitos casos, NFS-e, são arquivos XML assinados digitalmente com um certificado da ICP-Brasil. A assinatura funciona como um lacre: ela garante que o conteúdo não mudou desde o momento em que foi assinado.
Quando esse conteúdo é modificado ou danificado depois da assinatura, dizemos que houve quebra de integridade. O arquivo pode até abrir normalmente e parecer correto, mas a verificação técnica mostra que ele não é mais idêntico ao original assinado.
Como o sistema percebe que o arquivo foi alterado?
No momento da assinatura, é calculado um hash do conteúdo, uma espécie de impressão digital matemática do XML. Esse hash fica registrado dentro da própria assinatura, protegido pela chave privada do certificado.
Para verificar a integridade, o software recalcula o hash do arquivo atual e compara com o que está na assinatura. Se forem diferentes, a integridade foi quebrada. Basta trocar uma letra, um número ou até alguns espaços dentro da parte assinada para que a comparação falhe.
Quais são as causas mais comuns?
A causa mais conhecida é a edição manual do XML para corrigir um dado, como endereço ou valor. Mas há causas involuntárias e frequentes em integrações: reformatar o XML para deixá-lo mais legível (indentação), converter a codificação de caracteres (por exemplo, de UTF-8 para outra), trocar quebras de linha entre sistemas operacionais ou remover acentos automaticamente.
Também acontece por falhas de armazenamento e transmissão: campos de banco de dados com tamanho limitado que cortam o final do arquivo, conversões malfeitas para Base64, downloads interrompidos ou bibliotecas que reescrevem o XML ao lê-lo e salvá-lo de novo.
Quais as consequências de um arquivo fiscal com integridade quebrada?
Se a alteração ocorre antes do envio, o órgão autorizador rejeita o documento por divergência na assinatura, e a nota não é autorizada. Se ocorre depois da autorização, o arquivo guardado deixa de servir como comprovação confiável da operação.
Na prática, o destinatário pode não conseguir importar o XML no seu sistema, a contabilidade pode recusar o arquivo e, em uma fiscalização, a empresa pode ter dificuldade para comprovar suas operações, já que a legislação exige a guarda do XML original durante o prazo legal.
Como evitar e como corrigir a quebra de integridade?
A regra principal é tratar o XML assinado como um arquivo intocável: armazená-lo exatamente como foi recebido, em formato binário ou texto sem transformações, e nunca editá-lo. Se for preciso exibir os dados de forma amigável, use o documento auxiliar (DANFE, DACTE, DAMDFE, DANFCE) ou leia as informações sem regravar o arquivo.
Se um arquivo guardado estiver corrompido, a solução é obter novamente o original, por meio do download do XML no emissor, da API de emissão ou da distribuição de DF-e. Se o problema for um erro no conteúdo da nota, a correção deve ser feita pelos caminhos oficiais, como Carta de Correção Eletrônica, cancelamento ou emissão de documento complementar, e não pela edição do XML.
Qual a diferença entre quebra de integridade e erro de validação fiscal?
O erro de validação fiscal acontece quando os dados do documento não seguem as regras: um campo obrigatório ausente, um CFOP incompatível ou um formato fora do esquema XML. O problema está no conteúdo informado.
Na quebra de integridade, o conteúdo pode até estar correto, mas não é mais o mesmo que foi assinado. O problema está na correspondência entre o arquivo e sua assinatura digital.
Exemplos de Quebra de integridade de arquivo fiscal
- Um ERP grava o XML autorizado da NF-e em uma coluna de banco de dados com limite de caracteres; notas com muitos itens são cortadas no final e, ao serem enviadas ao cliente, falham na verificação de assinatura.
- Um desenvolvedor usa uma biblioteca que formata o XML com indentação antes de transmiti-lo; a SEFAZ rejeita o documento porque a assinatura difere do conteúdo recebido.
- Um funcionário abre o XML de um CT-e em um editor de texto e corrige o nome do destinatário; o arquivo deixa de ser válido e o embarcador não consegue importá-lo.
- Uma plataforma de vendas recupera o XML original via API de emissão após identificar que a cópia armazenada estava corrompida, restaurando a guarda correta do documento.
Perguntas frequentes
Posso corrigir um dado editando o XML autorizado?
Não. Qualquer edição quebra a integridade e invalida a assinatura. Correções devem ser feitas por Carta de Correção Eletrônica, quando permitida, ou por cancelamento e nova emissão, conforme o caso e o tipo de documento.
Abrir o XML para leitura quebra a integridade?
Apenas abrir e ler, não. O risco está em salvar o arquivo novamente, pois alguns editores e bibliotecas alteram espaços, quebras de linha ou codificação ao regravar o conteúdo.
Como saber se um XML guardado está íntegro?
Use um validador de assinatura digital ou a própria biblioteca de emissão para recalcular o hash e conferir a assinatura. Se a verificação falhar, baixe novamente o arquivo original na fonte.
O DANFE serve como substituto de um XML corrompido?
Não. O DANFE é apenas uma representação simplificada. O documento fiscal com validade jurídica é o XML assinado e autorizado, que deve ser guardado sem alterações.
Atualizado em · Como produzimos este glossário