Através deste endpoint, é possível cancelar uma NFS-e autorizada no seu respectivo município enviando o conteúdo no respectivo layout em JSON ou XML.
URL
Produção: POST https://nfsenacional.ns.eti.br/nfse/cancel
Dados de entrada
| Campo | Descrição | Ocorrência | Observação |
|---|---|---|---|
| X-AUTH-TOKEN | Token de Acesso do Usuário | 0-1 | Pode ser enviado no cabeçalho da requisição |
| chNFSe | Chave de acesso da NFSe | 1-1 | |
| tpAmb | Tipo de ambiente de autorização | 1-1 | 1 - Produção, 2 - Homologação |
| dhEvento | Data e hora da ocorrência do cancelamento | 1-1 | |
| nDFSe | Numeração da nota fiscal | 1-1 | |
| dhProc | Data e hora da ocorrência do cancelamento | 1-1 | |
| CNPJAutor | CNPJ do emitente da nota | 1-1 | |
| cMotivo | Código de justificativa de cancelamento | 1-1 | 1 - Erro na emissão; 2 - Serviço não Prestado; 9 - Outros; |
| xMotivo | Justificativa de cancelamento | 1-1 | |
Exemplo de requisição
Requisição de cancelamento de NFS-e Nacional
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"chNFSe": "31062000000000000000000000000000005126038849685261",
"tpAmb": "2",
"dhEvento": "2026-03-20T10:33:00-03:00",
"nDFSe": "50",
"dhProc": "2026-03-20T10:33:00-03:00",
"CNPJAutor": "00000000000000",
"cMotivo": "1",
"xMotivo": "NFS-e cancelado para teste de desenvolvimento de software de integração"
}'\
https://nfsenacional.ns.eti.br/nfse/cancel
Dados retornados
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "NFSe cancelado com sucesso",
"retEvento": {
"cStat": "135",
"xMotivo": "Evento registrado e vinculado a NFSe com sucesso",
"idEvento": "31062000000000000000000000000000005326035549455611110111",
"chNFSe": "02200008000000000000000000005326035549455611",
"dhRegEvento": "2026-03-20T14:26:27-03:00",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><evento versao=\"1.01\" xmlns=\"http://www.sped.fazenda.gov.br/nfse\"><infEvento Id=\"EVT31062000000000000000000000000000005326035549455611101101001\"><verAplic>SefinNacional_1.6.0</verAplic><ambGer>2</ambGer><nSeqEvento>1</nSeqEvento><dhProc>2026-03-20T14:26:27-03:00</dhProc><nDFSe>0</nDFSe><pedRegEvento versao=\"1.01\"...
}
}
Retorno sem sucesso
{
"status": -3,
"motivo": "Nao foi possivel vincular o evento ao NFSe",
"erro": {
"codigo": "E0840",
"xMotivo": "O Sistema Nacional NFS-e não pode recepcionar o EVENTO DE CANCELAMENTO DE NFS-e, pois o evento de Cancelamento de NFS-e já está vinculado à NFS-e indicada no evento enviado, impedindo sua recepção."
}
}