Cancelamento de NFe

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

Obs.: O cancelamento de NF-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://nfe.ns.eti.br/nfe/cancel

Dados de entrada

Campo	Descrição	Ocorrência	Observações
X-AUTH-TOKEN	Token de acesso do usuário	1-1
chNFe	Chave de acesso da NF-e	1-1
tpAmb	Tipo de ambiente de autorização da NF-e 1 - Produção 2 - Homologação	1-1
dhEvento	Data e hora da ocorrência do cancelamento	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 NF-e	1-1
xJust	Descrição literal do motivo de cancelamento da NF-e	1-1	Mínimo 15 caracteres

Exemplo de requisição

Requisição de Cancelamento de NF-e

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
         "X-AUTH-TOKEN": "SEU_TOKEN", 
         "chNFe": "43161107364617000135550000000099601000094832",
         "tpAmb": "2", 
         "dhEvento": "2016-11-28T19:06:14-02:00", 
         "nProt": "143160001510168", 
         "xJust": "NF-e cancelada para teste de desenvolvimento de software de integração"
        }'\
    https://nfe.ns.eti.br/nfe/cancel

Dados retornados

Campo	Descrição	Observação
status	Código de status do processamento
motivo	Descrição literal do status de processamento
retEvento	Objeto contendo os dados de processamento do cancelamento na Sefaz	Somente em status = 200
retEvento.cStat	Código de situação do processamento
retEvento.xMotivo	Descrição literal da situação do processamento na Sefaz
retEvento.chNFe	Chave de acesso da NF-e
retEvento.dhRegEvento	Data e hora de registro do evento na Sefaz	Padrão Sefaz AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-03:00
retEvento.nProt	Número do protocolo de autorização do evento pela Sefaz
erro	Objeto contendo as informações de erro caso o cancelamento não possa ser realizado com sucesso	Somente em status diferente de 200
erro.cStat	Código de status do erro
erro.xMotivo	Descrição literal do erro

Exemplo de retorno

Retorno com sucesso

{
  "status": 200,
  "motivo": "NF-e cancelada com sucesso",
  "retEvento": {
    "cStat": 135,
    "xMotivo": "Evento registrado e vinculado a NF-e",
    "chNFe": "43161107364617000135550000000099601000094832",
    "dhRegEvento": "2016-11-28T19:09:04-02:00",
    "nProt": "143160001510173"
  }
}

Códigos de retorno

Código	Descrição
200	NF-e cancelada com sucesso
-2	Chave de acesso inválida
-3	Não foi possível cancelar a NF-e Verifique o objeto erro para maiores informações

Download do cancelamento de NFe

Você pode fazer o download das informações completas de distribuição do cancelamento em XML ou JSON e também de uma representação gráfica do mesmo em formato PDF. Para isso confira o método Download de Evento na NS NF-e API.

NS NFe

URL