---
title: "Cancelar evento"
method: DELETE
path: "/cte/{referencia}/evento"
tags: ["CTe/CTeOs"]
---

# Cancelar evento

`DELETE /cte/{referencia}/evento`

## Request

- Base URL: `https://api.focusnfe.com.br/v2`
- URL: `https://api.focusnfe.com.br/v2/cte/{referencia}/evento`
- Auth: HTTP basic

Alguns eventos têm a possibilidade de serem cancelados. O tipo do evento
a ser cancelado é informado pelo parâmetro `tipo_evento`.


Este endpoint possui retorno **síncrono**.

## Path parameters

- `referencia` string, required

## Request body

- CancelamentoEventoCteRequest
  - `tipo_evento` 'insucesso_entrega', required: Tipo do evento a ser cancelado. Informar um dos códigos abaixo: - insucesso_entrega: Cancelamento do último evento de insucesso na entrega registrado para o CT-e

## Response `200`

Requisição processada com sucesso

- EventoCteResponse
  - `evento` string: Nome do evento enviado
  - `status_sefaz` string: Status do evento na SEFAZ
  - `mensagem_sefaz` string: Mensagem descritiva da SEFAZ detalhando o status
  - `status` 'autorizado' | 'erro_autorizacao': Autorizado, se o evento for registrado com sucesso, ou erro_autorizacao, se houve algum erro no registro do evento
  - `caminho_xml_evento_[NOME_DO_EVENTO]` string: Caso o evento tenha sido registrado, será informado aqui o caminho para download do XML
  - `numero_evento_[NOME_DO_EVENTO]` string: Número sequencial do evento
  - `numero_protocolo` string: Número do protocolo do evento

## Other responses

- `400`: Requisição inválida
- `401`: Não autorizado
- `404`: Recurso não encontrado
- `422`: O servidor entendeu a requisição, mas os dados são inválidos ou não podem ser processados

---

[API](https://skmtc.dev/focusnfe/apis/cte-cteos.md) - [All operations](https://skmtc.dev/focusnfe/apis/cte-cteos/llms.txt) - [OpenAPI document](https://skmtc.dev/focusnfe/apis/cte-cteos/revisions/08b71d5f64bf?raw)
