EVENTO de CANCELAMENTO - Como cancelar NFS-e pelo Emissor: dúvidas, URL, manuais e exemplos

Contribuinte API Nacional
1

Temos recebido vários questionamentos sobre o cancelamento de uma NFS-e, antes de pensar em executar o Cancelamento, entenda o que deve ser feito.

Invista um tempo de leitura antes de sair fazendo. Entendemos que seguindo um exemplo, a assimilação as vezes é mais fácil, mas devem enteder como gerar, onde buscar as informações, como preencher para casos de erro, enfim, ficar sob controle quando tiver algum problema.

No Link postado pela Elisabete, é indicado a documentação e onde buscar, favor olharem o tópico abaixo:

Uma vez com os documentos, em mãos, entenda como funcionam os eventos, existem vários códigos de eventos e cada qual com sua parametrização. No documento do ANEXO_II-SEFIN_ADN-PEDREGEVT_EVT-SNNFSe.xlsx, tem todos os tipos de eventos e informações que necessitar.

Para o evento de Cancelamento, será usado o evento “e101101“.

image
image2570×297 20.5 KB

A documentação das APIS foi informado pela Elisabete e copiado acima.

Produção Restrita:

http://sefin.producaorestrita.nfse.gov.br/SefinNacional/nfse/{chaveAcesso}/eventos

Produção:

http://sefin.nfse.gov.br/SefinNacional/nfse/{chaveAcesso}/eventos

Um exemplo de chamada completo com dump de rede e a respectiva resposta foram colocados na pasta de arquvivos compartilhados, alguns dados sensíveis foram suprimidos.

ARQUIVOS COMPARTILHADOS grupo “Integracao ADN”

https://drive.google.com/drive/folders/1AlLg13p2nrH_yTaw8HocyNfgl7oPBpjD

Boa leitura e boa sorte.

At.te,

Emir Toktar

2 curtidas
2

Estou enviando o XML de cancelamento da NFS-e para o endpoint https://sefin.producaorestrita.nfse.gov.br/SefinNacional/nfse/{chNFSe}/eventos.
O XML é aceito e a API retorna sucesso, sem erros (campo erro: []), conforme abaixo:

{
  "tipoAmbiente": 2,
  "versaoAplicativo": "SefinNac_Pre_1.4.0",
  "dataHoraProcessamento": "2025-11-20T22:11:54.8758252-03:00",
  "erro": []
}

Apesar disso, o cancelamento não ocorre — a nota permanece ativa no Painel Municipal.
Com o XML abaixo, estou fazendo o procedimento correto? Existe algum passo adicional para que o cancelamento seja efetivamente registrado no ambiente municipal?

(XML enviado incluído abaixo para conferência)

<?xml version="1.0" encoding="UTF-8"?>

<evento xmlns="http://www.sped.fazenda.gov.br/nfse" versao="1.00">
    <infEvento Id="EVT00000000000000000000000000000000000000000000000000000027001">
        <verAplic>2.26.28</verAplic>
        <ambGer>1</ambGer>
        <nSeqEvento>001</nSeqEvento>
        <dhProc>2025-11-20T22:11:12-03:00</dhProc>
        <nDFe>27</nDFe>
        <pedRegEvento versao="1.00">
            <infPedReg Id="PRE52119091212053489000149000000000002725115338549171101101001">
                <tpAmb>2</tpAmb>
                <verAplic>2.26.28</verAplic>
                <dhEvento>2025-11-20T00:00:00-03:00</dhEvento>
                <CNPJAutor>12053489000149</CNPJAutor>
                <chNFSe>52119091212053489000149000000000002725115338549171</chNFSe>
                <nPedRegEvento>1</nPedRegEvento>
                <e101101>
                    <xDesc>Cancelamento de NFS-e</xDesc>
                    <cMotivo>1</cMotivo>
                    <xMotivo>Erro na Emissao</xMotivo>
                </e101101>
            </infPedReg>
        </pedRegEvento>
    </infEvento>
</evento>
3

Aderbal,

Consigo enviar, porém dá o erro 500 no servidor e tendo retorno igual ao seu.

image
image1186×270 19.4 KB

5

Olá pessoal.

Primeiro, identifique o ambiente e se é EMISSOR ou FORNECEDOR, senão tem que adivinhar pelo o que estão tentando fazer.

FORNECEDOR compartilha no ADN o evento,

EMISSOR, SOLICITA o EVENTO, não cria o mesmo, resumindo, faz o e não o

O exemplo já foi colocado no google drive passado aqui no fórum, go grupo Whats “Integracao ADN”.

Pesquisem por favor e vejam, o que estão fazendo comparando com o EVENTO de CANCELANENTO disponível.

Depois, se tiver algum problema ainda, questionem no fórum.

ARQUIVOS COMPARTILHADOS grupo “Integracao ADN”

https://drive.google.com/drive/folders/1AlLg13p2nrH_yTaw8HocyNfgl7oPBpjD

Avisem se deu certo ou não para fechar o tópico por favor.

At.te,

Emir Toktar

6

Aderbal,

Você está enviando o EVENTO, este formato já é a RESPOSTA autorizando o pedido de Cancelamento. Ou o Município é o Autorizador do documento e os contribuintes enviam para a prefeitura, e esta AUTORIZA a emissão e o CANCELAMENTO e gera o envelope “evento” e compartilha para o ADN.

Se você é um contribuintes, ou seja, emissor enviando para o Ambiente Nacional ou para um Município que use o xml padrão nacional, você envia o PEDIDO do CANCELAMENTO, e não o EVENTO.

image
image1361×1268 142 KB

Na pasta compartilha tem os exemplos de um EMISSOR (Contribuinte) executando um pedido de Cancelamento e recebendo a resposta, ok?

Está no Link de arquivos compartilhados já postado neste tópico.

Depois avisa se deu certo.

At.te,

Emir Toktar

7

Emir Toktar, obrigado pela ajuda!
Depois de assistir ao vídeo https://www.youtube.com/watch?v=IYny0tUQSZI , consegui entender melhor alguns pontos e identifiquei erros que eu mesmo estava cometendo.

  1. Estou desenvolvendo a integração diretamente para a prefeitura, portanto todas as transmissões devem ser feitas para o Ambiente Gerador 1 – Sistema próprio do município.

  2. Após o vídeo, descobri que o envio é realizado pela url da DF-e.
    No meu caso, a URL correta é:
    https://adn.producaorestrita.nfse.gov.br/dfe

Com isso, acredito que meu XML de evento esteja corretamente montado e assinado.

Peço desculpas se minhas perguntas às vezes ficam vagas — é meu primeiro contato com integração da NFS-e, e agradeço muito pela ajuda.

Depois desses ajustes, corrigi meu sistema e realizei um novo envio. Agora recebo uma mensagem de erro diferente:

 {"Lote":[{"NsuRecepcao":"","StatusProcessamento":"PROCESSADO_COM_ERROS","Erros":[{"Mensagem":{},"Codigo":"E1262","Descricao":"CNPJ não autorizado a compartilhar DF-e pelo município conveniado ao Sistema Nacional NFS-e."}]}],"TipoAmbiente":"HOMOLOGACAO","VersaoAplicativo":"1.0.0.0","DataHoraProcessamento":"2025-11-22T09:41:57.151541-03:00"}

Erro E1262 – CNPJ não autorizado a compartilhar DF-e pelo município conveniado ao Sistema Nacional NFS-e.

Aparentemente minha configuração de ambiente está correta.

image
image1157×818 61.1 KB

O evento esta sendo enviado para o mesmo ambiente gerador que a nota foi enviada.

Alguém mais já passou por esse problema?

8

Boa Tarde, pessoal.

É normal no ambiente de homologação o XML de cancelamento vir com os dados abaixo com zero?

nSeqEvento>0</nSeqEvento

nDFe>0</nDFe

9

Oi Aderbal

Estava a sua sua situação como sendo por emissor, pois você adicionou sua dúvida em um post para emissor.

É importante separar pois são tratamentos diferentes e endpoints diferentes.

Estou olhando na documentação e o endereço é outro: https://adn.producaorestrita.nfse.gov.br/adn/DFe

10

Obrigado pelo retorno Elizabete.

Estou me baseando nesse swagger:

image
image1920×1080 312 KB

Existe outro Swagger mais atual? Porque me parece que este está desatualizado.

11

Elizabete, segui as orientações que você mencionou, mas ainda continuo com o mesmo erro.

URL: https://adn.producaorestrita.nfse.gov.br/adn/DFe

XML de cancelamento:

<?xml version="1.0" encoding="UTF-8"?>
<evento xmlns="http://www.sped.fazenda.gov.br/nfse" versao="1.00">
    <infEvento Id="........">
        <verAplic>2.26.28</verAplic>
        <ambGer>1</ambGer>
        <nSeqEvento>001</nSeqEvento>
        <dhProc>2025-12-01T07:30:59-03:00</dhProc>
        <nDFe>29</nDFe>
        <pedRegEvento versao="1.00">
            <infPedReg Id=".......">
                <tpAmb>2</tpAmb>
                <verAplic>2.26.28</verAplic>
                <dhEvento>2025-12-01T00:00:00-03:00</dhEvento>
                <CNPJAutor>......</CNPJAutor>
                <chNFSe>.......</chNFSe>
                <nPedRegEvento>1</nPedRegEvento>
                <e101101>
                    <xDesc>Cancelamento de NFS-e</xDesc>
                    <cMotivo>1</cMotivo>
                    <xMotivo>Erro na Emissao</xMotivo>
                </e101101>
            </infPedReg>
        </pedRegEvento>
    </infEvento>
</evento>

Resposta :

{
   "Lote":[
      {
         "NsuRecepcao":"",
         "StatusProcessamento":"PROCESSADO_COM_ERROS",
         "Erros":[
            {
               "Mensagem":{
                  
               },
               "Codigo":“E1262”,
               "Descricao":"CNPJ não autorizado a compartilhar DF-e pelo município conveniado ao Sistema Nacional NFS-e."
            }
         ]
      }
   ],
   "TipoAmbiente":"HOMOLOGACAO",
   "VersaoAplicativo":“1.0.0.0”,
   "DataHoraProcessamento":"“2025-12-01T07":"31":"24.474442-03":00”
}

E, no meu caso, o correto seria abrir o post na categoria ‘Geral’?

12

Oi Aderbal

Essa documentação é antiga, os Swaggers corretos estão neste endereço.
Vou com outros integradores se estão tendo o mesmo problema.

image
image1636×919 209 KB

13

Oi Aderbal

Conferi com outros integradores e está funcionando.

É muito estranha esta sua situação, pois caso o município tem emissor próprio ele deve assinar com certificado do município e subir o cancelamento para o ADN.

Sobre a pergunta: E, no meu caso, o correto seria abrir o post na categoria ‘Geral’?
R: Tem categoria de municípios.

14

Sobre estar funcionando, também achei estranho, porque consigo enviar notas fiscais pelo mesmo endpoint. Então, em teoria, o cancelamento também deveria funcionar. Porém, quando envio o XML de cancelamento pelo mesmo endpoint indicado na documentação que você mencionou, o erro continua ocorrendo.

E me parece ser um erro de configuração. Já verifiquei tudo e está conforme deveria, e não vejo nada nos parâmetros que possa estar causando esse problema.

Então consigo enviar o xml de NFS-e mais não o cancelamento.