Cancelar CT-e

POST /cte/:accessKey/cancelar

Cancela um CT-e autorizado na SEFAZ.

Autenticação

Authorization: Bearer {token}

Parâmetros de URL

Campo	Tipo	Descrição
accessKey	string	Chave de acesso do CT-e (44 dígitos)

Body

Campo	Tipo	Obrigatório	Descrição
justificativa	string	✅	Motivo do cancelamento (mín. 15 caracteres)

Exemplo

curl -X POST https://api.engineapi.com.br/cte/35260212345678000190570010000000011000000019/cancelar \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "justificativa": "Erro nos dados de transporte do conhecimento" }'

Resposta (200)

{
  "success": true,
  "message": "CT-e cancelado com sucesso",
  "data": {
    "accessKey": "35260212345678000190570010000000011000000019",
    "status": "CANCELED",
    "protocolo": "135260000000002"
  }
}

Regras

• Prazo máximo de cancelamento: 168 horas (7 dias) após autorização
• A justificativa deve ter no mínimo 15 caracteres
• CT-e já cancelado retorna erro