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

# Cancelar

`DELETE /cte/{referencia}`

## Request

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

Apenas CT-es, CT-e OS e CT-e Simplificado com status "autorizado" podem ser cancelados. O cancelamento é definitivo e não pode ser desfeito.

Este endpoint possui retorno **síncrono**. Como resposta você poderá receber os campos descritos abaixo. Os exemplos de resposta mostram os campos retornados de acordo com o status do CT-e/CT-e OS/CT-e Simplificado.

## Path parameters

- `referencia` string, required

## Request body

- object
  - `justificativa` string, required: Justificativa para o cancelamento (mínimo 15 caracteres).

## Response `200`

Requisição processada com sucesso

- union
  - CancelamentoResponse
    - `status` string: Status do CTe/CTeOS
    - `status_sefaz` string: Status da SEFAZ
    - `mensagem_sefaz` string: Mensagem da SEFAZ
    - `caminho_xml` string: Caminho do XML do CTe/CTeOS
  - ErroCancelamentoResponse
    - `status` string: Status do CTe/CTeOS
    - `status_sefaz` string: Status da SEFAZ
    - `mensagem_sefaz` string: Mensagem da SEFAZ

## Other responses

- `400`: Requisição inválida
- `401`: Não autorizado
- `404`: Recurso não encontrado
- `415`: O tipo de mídia especificado no cabeçalho Content-Type da requisição não é suportado pelo servidor.

---

[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)