---
title: "Cancelar"
method: DELETE
path: "/nfe/{referencia}"
tags: ["NFe"]
---

# Cancelar

`DELETE /nfe/{referencia}`

Cancela uma NFe já autorizada.

Este método é **síncrono**, ou seja, a comunicação com a SEFAZ será feita imediatamente.

A NFe poderá ser cancelada em até 24 horas após a emissão. No entanto, alguns estados 
podem permitir um prazo maior para o cancelamento.

## Path parameters

- `referencia` string, required

## Request body

- CancelamentoNFeRequest
  - `justificativa` string, required — Justificativa do cancelamento (15 a 255 caracteres)

## Response `200`

NFe cancelada com sucesso

- CancelamentoNFeResponse
  - `status` 'cancelado' | 'erro_cancelamento' — Status do cancelamento
  - `status_sefaz` string — Status na SEFAZ
  - `mensagem_sefaz` string — Mensagem descritiva da SEFAZ
  - `caminho_xml_cancelamento` string — Caminho para download do XML de cancelamento

## 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.
- `422` — O servidor entendeu a requisição, mas os dados são inválidos ou não podem ser processados

---

[API](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele.md) · [All operations](https://skmtc.net/focusnfe/apis/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/focusnfe/cte-cte-os-e-cte-simplificado-conhecimento-de-transporte-ele/revisions/a32e528fc383/schema)
