Através do serviço de cancelamento de NFCom é possível cancelar uma nota fiscal previamente autorizada através da API.
URL
Produção POST: https://nfcom.ns.eti.br/nfcom/cancel
Dados de Entrada
| chNFCom | Chave de acesso da NFCom | N | 1-1 | |
|---|---|---|---|---|
| tpAmb | Tipo do ambiente de autorização da NFCom | N | 1-1 | 1 - Produção 2 - Homologação |
| dhEvento | Data e hora da ocorrência do cancelamento | D | 1-1 | Padrão Sefaz AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-02:00 |
| nProt | Número do protocolo de autorização da NFCom | N | 1-1 | |
| xJust | Descrição literal do motivo de cancelamento da NFCom | A | 1-1 | Mínimo 15 caracteres |
Exemplo de requisição
Requisição de cancelamento de NFCom
curl -X POST \
-H "Content-Type: application/json" \
-d '{
"chNFCom": "43250907364617000135620000000001341051247156",
"tpAmb": 2,
"dhEvento": "2025-09-04T10:40:00-03:00",
"nProt": "1432500028009091",
"xJust": "teste de integração"
}'\
https://nfcom.ns.eti.br/nfcom/cancel
Dados Retornados
| Campo | Descrição | Pai | Tipo | Ocorrência | Observações |
|---|---|---|---|---|---|
| status | Código de status do processamento | N | 1-1 | ||
| motivo | Descrição literal do status de processamento | A | 1-1 | ||
| retEvento | Objeto contendo os dados de processamento do cancelamento na Sefaz | Pai | O | 0-1 | Somente em status = 135 ou -135 |
| cStat | Código de situação do processamento | retEvento | N | 1-1 | |
| xMotivo | escrição literal da situação do processamento na Sefaz | retEvento | A | 1-1 | |
| chNFCom | Chave de acesso da NFCom | retEvento | N | 0-1 | Somente em cStat = 135 |
| dhRegEvento | Data e hora de registro do evento na Sefaz | retEvento | D | 0-1 | Padrão Sefaz AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-03:00 Somente em cStat = 135 |
| nProt | Número do protocolo de autorização do evento pela Sefaz | retEvento | N | 0-1 | Somente em cStat = 135 |
| xml | XML de distribuição do evento | retEvento | A | 0-1 | Somente em cStat = 135 |
Retorno com Sucesso
{
"status": 200,
"motivo": "NFCom cancelado com sucesso",
"retEvento": {
"cStat": "135",
"xMotivo": "Evento registrado e vinculado a NFCom ",
"idEvento": "11011143251007364617000135620440000000011012345674001",
"chNFCom": "43251007364617000135620440000000011012345674",
"dhRegEvento": "2025-10-28T10:08:18-03:00",
"nProt": "1432500033800971",
"xml": "..."
}
}
Códigos de Retorno
| Código | Descrição |
|---|---|
| 135 | NFCom cancelado com sucesso |
| -3 | Nao foi possivel vincular o evento ao NFCom |
| -400 | Campos obrigatórios não informados O campo motivo terá maiores informações |
| -401 | Sem permissões para gerenciar documentos do CNPJ contribuinte |
| -999 | Erro interno ao processar a requisição O campo motivo terá maiores informações |