Cancelamento de NFCe

Cancelamento de NFC-e

Através do serviço de cancelamento de NFC-e é possível cancelar uma nota fiscal previamente autorizada através da API.

Obs.: O cancelamento de NFC-e possui regras e prazos definidos pela Secretaria da Fazenda que devem ser consideradas e respeitadas. Para maiores informações clique aqui e verifique a versão mais atualizada o Manual de Orientações do Contribuinte da Sefaz.

URL

Produção: POST https://nfce.ns.eti.br/v1/nfce/cancel

Dados de entrada

Campo	Descrição	Tipo	Ocorrência	Observação
chNFe	Chave de acesso da NFC-e	N	1-1
tpAmb	Tipo do ambiente de autorização da NFC-e	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 NFC-e	N	1-1
xJust	Descrição literal do motivo de cancelamento da NFC-e	A	1-1	Mínimo 15 caracteres

Exemplo de requisição

Requisição de cancelamento de NFC-e

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
        "X-AUTH-TOKEN": "SEU_TOKEN", 
        "chNFe": "43171007364617000135650010000064951000021614",                 
        "tpAmb": "2", 
        "dhEvento": "2017-10-13T18:36:14-03:00", 
        "nProt": "143170001690109", 
        "xJust": "NFC-e cancelado para teste de desenvolvimento de software de integração"
}'\
    http://nfce.ns.eti.br/v1/nfce/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
chNFe	Chave de acesso da NF-e	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

Exemplos de retorno

Retorno com sucesso

{
  "status": 135,
  "motivo": "NFC-e cancelada com sucesso",
  "retEvento": {
    "cStat": 135,
    "xMotivo": "Evento registrado e vinculado a NF-e",
    "chNFe": "43171007364617000135650010000064951000021614",
    "dhRegEvento": "2017-10-13T18:36:15-03:00",
    "nProt": "143160001510173"
  }
}

Códigos de retorno

Código	Descrição
135	NFC-e cancelada com sucesso
-135	Não foi possível cancelar a NFC-e
-996	Sem permissões para gerenciar documentos do CNPJ contribuinte
-997	Campos obrigatórios não informados O campo motivo terá maiores informações
-999	Erro interno ao processar a requisição O campo motivo terá maiores informações

Download do Cancelamento de NF-e

Você pode fazer o download das informações completas de distribuição do cancelamento em XML utilizando o método de Download na NS NFC-e API.

OBS: O download do evento é feito com a chave de autorização da NFC-e, pois ao fazer a consulta da chave após já ter feito o cancelamento retornará o XML e o PDF do evento.

NS NFCe