Quais as considerações para importar documentos cancelados?

Em algumas situações, a TAG de cancelamento do documento fiscal não está no mesmo arquivo XML da nota original. Isso ocorre porque o XML com situação regular é gerado primeiro e, posteriormente, é criado apenas o XML de cancelamento ou um novo arquivo com a informação de substituição. Por isso, para que o sistema importe o documento como cancelado, é necessário analisar a estrutura do XML e as TAGs utilizadas em cada tipo de importação, pois as regras de cancelamento podem variar conforme o modelo do documento e o tipo de importação. Confira abaixo:
 
NF-e Arquivo XML
Na importação de NF-e por arquivo XML, o sistema utiliza o valor da TAG cStat para identificar a situação do documento. Para que a NF-e seja importada como 'Cancelada', considere as orientações abaixo:
 
• O código informado na TAG cStat preenche o campo Situação da nota fiscal. Se o XML conter um código correspondente a 'Documento Cancelado', a NF-e será importada com a situação 'Documento Cancelado'.
 
Se o código da TAG cStat for diferente dos códigos de cancelamento, a nota será importada como 'Documento Regular'. Veja a tabela de códigos:
 
Tabela de situação fiscal da nota Situação no sistema Domínio
100     Autorizado o uso da NF-e Documento Regular
101     Cancelamento de NF-e homologado Documento Cancelado
102     Inutilização de número homologado NF-e ou CT-e Numeração Inutilizada  
110     Uso Denegado NF-e ou CT-e denegado
135     Evento registrado e vinculado a NF-e Documento Cancelado
301     Uso Denegado: Irregularidade fiscal do emitente NF-e ou CT-e denegado
302    
Uso Denegado: Irregularidade fiscal do destinatário  
NF-e ou CT-e denegado
 
Exemplo:
 
<protNFe versao="2.00">
  <infProt>
    <tpAmb>1</tpAmb>
    <verAplic>2.10.00</verAplic>
    <chNFe>0000000000000000000000000000000000000000000000</chNFe>
    <dhRecbto>1899-12-30T00:00:00</dhRecbto>
    <nProt>000000000000000</nProt>
    <digVal>t9QV0ad/CGwqufaALtTygWLvfefM=</digVal>
    <cStat>101</cStat>
    <xMotivo>Evento registrado e vinculado a NF-e</xMotivo>
  </infProt>
</protNFe>
 
Neste exemplo, a TAG 'cStat' está com o valor '101', que, conforme a tabela, indica 'Cancelamento de NF-e homologado - Documento Cancelado'.
 
Importante!
Quando o sistema classifica o documento como 'Cancelado', ele pode excluir os dados de produtos, parcelas e lançamentos contábeis, caso essa opção esteja definida na configuração de importação.
 
Documento Cancelado junto com o Documento Regular
Outra situação ocorre quando o Documento Cancelado está junto ao Documento Regular. Nesses casos, observe o seguinte:
 
• Ao importar 'Notas de entradas e cadastros', 'Notas de saídas e cadastros' ou selecionar a opção 'Todos', o sistema avalia as TAGs 'retEvento/infEvento\xEvento' presentes no arquivo.
 
Exemplo 2:
<retEvento versao="1.00">
  <infEvento>
    <tpAmb>1</tpAmb>
    <verAplic>MS_NFE_5.1.7</verAplic>
    <cOrgao>50</cOrgao>
    <cStat>135</cStat>
    <xMotivo>Evento registrado e vinculado a NF-e</xMotivo>
    <chNFe>121212121212121212121212121212121212121212</chNFe>
    <tpEvento>110111</tpEvento>
    <xEvento>Cancelamento</xEvento>
  </infEvento>
</retEvento>
 
Caso encontre a informação de cancelamento no evento, o sistema importará a nota com a situação 'Documento cancelado'.

NFC-e Arquivo XML
Na importação de NFC-e por Arquivo XML, o sistema identifica o documento como 'Cancelado' pelas informações de evento de cancelamento presentes no XML. Na tela de importação em Utilitários > Importação > Importação Padrão > NFC-e Arquivo XML, ao marcar a opção '[x] Notas canceladas' no quadro Importar, os documentos cancelados devem conter as seguintes informações:
 
O sistema utiliza o conteúdo da TAG 'descEvento' para identificar a nota como 'Documento cancelado'. Essa TAG deve conter uma das seguintes descrições:
 
• Cancelamento;
• Cancelamento por Substituição;
• Cancelamento por substituicao (sem acentos).
 
Ao identificar uma dessas informações, o sistema verifica se a chave da NFC-e informada no XML está registrada na empresa, tanto nas Entradas quanto nas Saídas. Se a chave for localizada, a situação da nota é alterada para 'Documento cancelado'.
 
Importante!
Quando o sistema classifica o documento como 'Cancelado', são aplicadas as funcionalidades de cancelamento da NFC-e, conforme as configurações de importação:
 
• Zerar os valores das guias Principal, Complementar, Estadual, Exportação e PIS/COFINS;
• Excluir os valores da guia Estoque, se marcada a opção '[x] Excluir movimentação de produtos';
• Excluir os valores da guia Parcelas, se marcada a opção '[x] Excluir parcelas';
• Excluir os valores da guia Contabilidade, se marcada a opção '[x] Excluir lançamentos contábeis'.
 
Em caso de dúvidas sobre as configurações de exclusão das notas canceladas, consulte as Soluções Relacionadas.
 
Exemplo 1:
 
<procEventoNFe xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.00">
  <evento xmlns="http://www.portalfiscal.inf.br/nfe" versao="1.00">
    <infEvento Id="ID0000000000000000000000000000000000000000000000000000">
      <cOrgao>24</cOrgao>
      <tpAmb>1</tpAmb>
      <CNPJ>11111111000191</CNPJ>
      <chNFe>12121212121212121212121212121212121212121212</chNFe>
      <dhEvento>2015-02-27T09:06:38-03:00</dhEvento>
      <tpEvento>110111</tpEvento>
      <nSeqEvento>1</nSeqEvento>
      <verEvento>1.00</verEvento>
      <detEvento versao="1.00">
        <descEvento>Cancelamento</descEvento>
        <nProt>333333333333333</nProt>
        <xJust>Nota Fiscal Eletronica inconsistente.</xJust>
      </detEvento>
    </infEvento>
  </evento>
</procEventoNFe>
 
Neste exemplo, a TAG descEvento contém "Cancelamento". O sistema considera o XML como cancelamento e importa a NFC-e com a situação Documento cancelado, desde que a chave do documento esteja registrada no sistema.
 
Exemplo 2:
 
<?xml version="1.0" encoding="UTF-8"?>
<infEvento Id="ID3333333333333333333333333333333333333333333333333333">
    <cOrgao>51</cOrgao>
    <tpAmb>1</tpAmb>
    <CNPJ>11111111000191</CNPJ>
    <chNFe>11111111111111111111111111111111111111111111</chNFe>
    <dhEvento>2014-12-10T10:29:59-03:00</dhEvento>
    <tpEvento>111111</tpEvento>
    <nSeqEvento>1</nSeqEvento>
    <verEvento>1.00</verEvento>
    <detEvento versao="1.00">
        <descEvento>Cancelamento por Substituição</descEvento>
        <nProt>000000000000000</nProt>
        <xJust>Cancelamento automático devido a erro de comunicação com o sefaz</xJust>
    </detEvento>
</infEvento>
 
Neste exemplo, a TAG descEvento contém "Cancelamento por Substituição". O sistema reconhece essa informação como cancelamento. Também será aceita a descrição 'Cancelamento por substituicao', sem acentuação, importando a NFC-e com a situação Documento cancelado.

NFS-e - Arquivo XML - ABRASF
Na importação de NFS-e Arquivo XML - ABRASF, o sistema identifica notas como 'Canceladas' por meio de TAGs específicas de cancelamento. Ao marcar a opção '[x] Notas fiscais de serviço cancelada' em Utilitários > Importação > Importação Padrão > NFS-e Arquivo XML - ABRASF, os documentos cancelados devem conter as seguintes informações:
 
• O sistema reconhece o cancelamento ao localizar a TAG 'Numero', filha das TAGs, nesta ordem: NfseCancelamento > Confirmacao > Pedido > InfPedidoCancelamento > IdentificacaoNfse > Numero.
 
Além da estrutura principal, o sistema considera as seguintes variações caso alguma TAG da estrutura original acima não exista:
 
• Se não encontrar a TAG 'NfseCancelamento', considera a TAG 'CancelamentoNfse';
• Se não encontrar a TAG 'Confirmacao', considera a TAG 'ConfirmacaoCancelamento';
• Se não encontrar a TAG 'Pedido', considera a TAG 'PedidoCancelamento';
• Se não encontrar a TAG 'IdentificacaoNfse', considera a TAG 'Numero' ou 'NumeroNfse' filha da TAG 'InfPedidoCancelamento';
• Se não encontrar a TAG 'Numero', considera a TAG 'NumeroNfse' da TAG 'IdentificacaoNfse'.
 
Ao identificar uma das estruturas aceitas de cancelamento, o sistema importa a nota como 'Documento cancelado'. Após a classificação como 'Cancelado', são aplicadas as funcionalidades de cancelamento existentes para a NFS-e, conforme a configuração de importação, como exclusão de parcelas e lançamentos contábeis da nota cancelada. Para dúvidas sobre essas configurações, consulte as Soluções Relacionadas.
 
Exemplo 1:
 
<NfseCancelamento>
  <Confirmacao Id="159805">
    <Pedido>
      <InfPedidoCancelamento Id="159805">
        <IdentificacaoNfse>
          <Numero>729</Numero>
          <Cnpj>11111111000191</Cnpj>
          <InscricaoMunicipal>00000</InscricaoMunicipal>
          <CodigoMunicipio>3501608</CodigoMunicipio>
        </IdentificacaoNfse>
        <CodigoCancelamento>9</CodigoCancelamento>
      </InfPedidoCancelamento>
    </Pedido>
    <DataHoraCancelamento>2015-01-26T10:32:00</DataHoraCancelamento>
  </Confirmacao>
</NfseCancelamento>
 
Exemplo 2:
 
<CancelamentoNfse>
    <ConfirmacaoCancelamento id="id">
        <PedidoCancelamento>
            <InfPedidoCancelamento>
                <IdentificacaoNfse>
                    <Numero>32553</Numero>
                    <CodigoMunicipio>1</CodigoMunicipio>
                </IdentificacaoNfse>
            </InfPedidoCancelamento>
            <Signature>signature</Signature>
        </PedidoCancelamento>
        <InfConfirmacaoCancelamento>
            <Sucesso>true</Sucesso>
        </InfConfirmacaoCancelamento>
    </ConfirmacaoCancelamento>
    <Signature>signature</Signature>
</CancelamentoNfse>

NFS-e Padrão Nacional
Criamos a dica abaixo para o padrão nacional, com considerações e orientações de importação:
 
 
Em caso de dúvidas sobre as configurações de exclusão de notas de cancelamento na importação, consulte as Soluções Relacionadas.

CT-e - Arquivo XML
O modelo de nota CT-e Arquivo XML será importado como 'Cancelado' quando, na tela Utilitários > Importação > Importação Padrão > CT-e e CT-eOS > Arquivo XML, a opção '[x] Notas canceladas' estiver marcada e os documentos cancelados apresentarem as seguintes informações no momento da importação:
 
• Os documentos devem conter a TAG <CancCTe> ou <evCancCTe> para cancelamento;
• Se o arquivo tiver a TAG <CancCTe>, o sistema deve verificar se a chave do CT-e informada na TAG <Id>, considerando apenas os números, filha da TAG <infCte>, está registrada na empresa como 'Regular', tanto nas Entradas quanto nas Saídas;
• Se o arquivo tiver a TAG <evCancCTe>, o sistema deve verificar se a chave do CT-e informada na TAG <chCTe>, filha da TAG <infEvento> , está registrada na empresa, tanto nas Entradas quanto nas Saídas;
• Se a chave do CT-e estiver registrada no sistema, a situação do documento será alterada para 'Documento cancelado'.
 
Quando o sistema classificar o documento como 'Cancelado', ele irá:
 
• Zerar todos os valores das guias Principal, Complementar, Estadual, Exportação e PIS/COFINS;
• Zerar todos os valores da guia Municipais, caso o cancelamento seja realizado por arquivo com a TAG <CancCTe>;
• Excluir os valores da guia Parcelas se a opção '[x] Excluir parcelas' estiver selecionada na configuração de importação, e excluir os valores da guia Contabilidade se a opção '[x] Excluir lançamentos contábeis' estiver selecionada.
 
Exemplo:
<procEventoCTe xmlns="http://www.portalfiscal.inf.br/cte" dhConexao="2025-10-17T11:49:26-03:00" ipTransmissor="34.237.169.102" nPortaCon="56503" versao="4.00">
    <eventoCTe versao="4.00">
        <infEvento Id="ID00000000000000000000000000000000000000000000000000000">
            <cOrgao>52</cOrgao>
            <tpAmb>1</tpAmb>
            <CNPJ>11111111000191</CNPJ>
            <chCTe>000000000000000000000000000000000000000000000</chCTe>
            <dhEvento>2025-10-17T11:49:18-03:00</dhEvento>
            <tpEvento>110111</tpEvento>
            <nSeqEvento>1</nSeqEvento>
            <detEvento versaoEvento="4.00">
                <evCancCTe>
                    <descEvento>Cancelamento</descEvento>
                    <nProt>111111111111111</nProt>
                    <xJust>ERRO DE DIGITACAO</xJust>
                </evCancCTe>
            </detEvento

NFCom - Arquivo XML
O arquivo XML do modelo NFCom será importado como 'Cancelado' quando, na tela Utilitários > Importação > Importação Padrão > NFCom - Arquivo XML, estiver marcada a opção NFCom canceladas e os documentos cancelados apresentarem as seguintes condições:
 
• A chave NFCom na tag 'chNFCom' deve ser igual à chave da nota registrada no sistema que será cancelada, pois a nota regular precisa estar gravada para permitir a importação da nota cancelada;
• O documento cancelado deve conter a TAG 'descEvento' com a descrição "Cancelamento".
 
Ao localizar a chave e o evento de cancelamento conforme as TAGs acima, após a importação, o sistema altera a situação do documento para 'Documento cancelado'. Quando o documento é classificado como 'Cancelado', o sistema pode excluir os dados de produtos, parcelas e lançamentos contábeis, conforme definido na configuração de importação. Em caso de dúvidas sobre essa configuração, acesse as Soluções Relacionadas.
 
Exemplo:
 
<eventoNFCom xmlns="http://www.portalfiscal.inf.br/nfcom" versao="1.00">
    <infEvento Id="ID1111111111111111111111111111111111111111111111111111">
        <cOrgao>42</cOrgao>
        <tpAmb>2</tpAmb>
        <CNPJ>13144391000160</CNPJ>
        <chNFCom>00000000000000000000000000000000000000000000</chNFCom>
        <dhEvento>2024-04-14T11:25:11-03:00</dhEvento>
        <tpEvento>110111</tpEvento>
        <nSeqEvento>01</nSeqEvento>
        <detEvento versaoEvento="1.00">
            <evCancNFCom xmlns="http://www.portalfiscal.inf.br/NFCom">
                <descEvento>Cancelamento</descEvento>
                <nProt>2222222222222222</nProt>
                <xJust>1 TESTE CANCELAMENTO</xJust>
            </evCancNFCom>
        </detEvento>
    </infEvento>
</eventoNFCom>
 
Informação Complementar
O comportamento de exclusão de itens, parcelas e lançamentos contábeis seguirá as definições disponíveis para cada tipo de importação e respectivas configurações. Se possuir dúvidas, acesse as Soluções Relacionadas.

Marcar todos como lidos