Cancelamento de CT-e

Através do serviço de cancelamento do CT-e é possível cancelar um conhecimento previamente autorizado através da API.

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

URL

Versão 3.00

Produção: POST https://cte.ns.eti.br/cte/cancel/300

Dados de entrada

Campo	Descrição	Observação
X-AUTH-TOKEN	Token de acesso do usuário
chCTe	Chave de acesso do CT-e
tpAmb	Tipo do ambiente de autorização do CT-e: 1 – Produção, 2 – Homologação
dhEvento	Data e hora da ocorrência do cancelamento	Padrão Sefaz (com UTC) AAAA-MM-DDTHH:MM:SS Ex.: 2016-06-13T15:04:10-03:00
nProt	Número do protocolo de autorização do CT-e
xJust	Descrição literal do motivo de cancelamento do CT-e	Mínimo 15 caracteres

Exemplo de requisição

Requisição de cancelamento de CT-e

curl -X POST 
    \-H "Content-Type: application/json" 
    \-d '{
      "X-AUTH-TOKEN":"...", 
      "chCTe":"43160612936829000344570000000010801000010620", 
      "tpAmb":"2", 
      "dhEvento":"2016-06-27T11:24:49-03:00",      
      "nProt":"143160000336628", 
      "xJust":"Conhecimento emitido para teste de integracao"
     }' \
    https://cte.ns.eti.br/cte/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 dados de processamento do CT-e	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.chCTe	Chave de acesso do CT-e
retEvento.dhRegEvento	Data e hora de registro do evento na Sefaz	Padrão Sefaz (com UTC) AAAA-MM-DDTHH:MM:SS Ex.: 2016-06-13T15:04:10-03:00
retEvento.nProt	Número do protocolo de autorização do evento
xml	XML de distribuição do evento de cancelamento	Somente em status = 200
erros	Array contendo a lista de erros durante a validação das informações do cancelamento de acordo com o tipo de dados	Somente em status = -4
erros.codigo	Código do erro ocorrido	Somente em status = -5
erros.descricao	Descrição literal do erro ocorrido	Somente em status = -5

Exemplos de retorno

Retorno com sucesso

{
    "status": 200,
    "motivo": "CT-e cancelado com sucesso",
    "retEvento": {
        "cStat": 135,
        "xMotivo": "Evento registrado e vinculado a CT-e",
        "chCTe": "43160612936129000195570000000010841000010620",
        "dhRegEvento": "2016-06-28T07:56:35-03:00",
        "nProt": "143160000339043"
    },
    "xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><procEventoCTe versao=\"2.00\" xmlns=\"http://www.portalfiscal.inf.br/cte\">...</procEventoCTe>"
}

Códigos de retorno

Código	Descrição
200	CT-e cancelado com sucesso
-2	Campos obrigatórios na requisição não informados
-3	Chave de acesso inválida
-4	Erro de informações de acordo com o tipo de dados
-5	Erro ao enviar o cancelamento para a Sefaz. Verificar os campos codigo e descricao para mais informações

Download do Cancelamento de CT-e

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 CT-e API.

NS CTe

URL