---
title: "Cancelar NFCe"
method: DELETE
path: "/v2/fiscal/nfce/{referencia}"
tags: ["API Local NFCe"]
---

# Cancelar NFCe

`DELETE /v2/fiscal/nfce/{referencia}`

## Request

- Base URL: `http://localhost:55555`
- URL: `http://localhost:55555/v2/fiscal/nfce/{referencia}`
- Auth: none declared

Cancela uma NFCe pela referência. O conteúdo do cancelamento deve informar a justificativa com 15 a 200 caracteres.

Utilizamos a mesma referência de emissão para o cancelamento, contudo, sua extensão é alterada para **.canc** e, em seu conteúdo, deve ser enviado a justificativa do cancelamento da nota contendo de 15 à 200 caracteres.

Após processado o cancelamento um arquivo com nome formado por 'referencia + _canc_ + timestamp' será gravado no diretório "retornos" contendo um JSON simples com o resultado da operação indicando se houve sucesso ou erro.

## Path parameters

- `referencia` string, required

## Request body

- NfceCancelamentoRequest
  - `justificativa` string, required: Justificativa do cancelamento.

## Response `200`

Documento cancelado com sucesso

- FiscalOperationResponse
  - `ref` string: Referência do documento fiscal.
  - `status` string: Status da operação.
  - `mensagem` string: Mensagem descritiva do resultado da operação.
  - `cpf_cnpj_emitente` string: CPF ou CNPJ do emitente vinculado ao documento.
  - `chave_nfe` string: Chave do documento fiscal autorizado.
  - `chave_nfe_cancelamento` string: Chave do evento de cancelamento, quando houver.
  - `numero` string: Número do documento fiscal.

---

[API](https://skmtc.dev/focusnfe/apis/comunicador-offline.md) - [All operations](https://skmtc.dev/focusnfe/apis/comunicador-offline/llms.txt) - [OpenAPI document](https://skmtc.dev/focusnfe/apis/comunicador-offline/revisions/ccd736f412a3?raw)