---
title: "Cancelar nota fiscal na SEFAZ"
method: POST
path: "/notas/{idNota}/cancelar"
tags: ["Notas"]
---

# Cancelar nota fiscal na SEFAZ

`POST /notas/{idNota}/cancelar`

## Request

- Base URL: `https://api.tiny.com.br/public-api/v3`
- URL: `https://api.tiny.com.br/public-api/v3/notas/{idNota}/cancelar`
- Auth: HTTP bearer

Transmite à SEFAZ o evento de cancelamento da NF-e ou NFC-e autorizada. Retorna 403 quando um estorno ou o cancelamento da venda é solicitado sem permissão, 409 quando a nota já está cancelada na SEFAZ, 422 quando a nota não pode ser cancelada ou a SEFAZ rejeita o cancelamento (cStat e xMotivo nos detalhes) e 502 quando há falha de comunicação com a SEFAZ.

## Path parameters

- `idNota` integer, required

## Request body

- CancelarNotaFiscalModelRequest: 
  - `justificativa` string, required: Motivo do cancelamento, entre 15 e 255 caracteres
  - `estornarEstoque` boolean: Estorna o estoque lançado pela nota. Ignorado quando não há estoque lançado
  - `estornarContas` boolean: Estorna as contas lançadas pela nota. Ignorado quando não há contas lançadas
  - `cancelarVenda` boolean: Cancela a venda de origem da nota. Ignorado quando a origem não é uma venda

## Response `200`

OK

- CancelarNotaFiscalModelResponse: 
  - `situacao` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10: - 1 - Pendente - 2 - Emitida - 3 - Cancelada - 4 - Enviada Aguardando Recibo - 5 - Rejeitada - 6 - Autorizada - 7 - Emitida Danfe - 8 - Registrada - 9 - Enviada Aguardando Protocolo - 10 - Denegada
  - `cStat` integer: Código de status retornado pela SEFAZ para o evento de cancelamento
  - `motivo` string: Motivo retornado pela SEFAZ para o evento de cancelamento

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

## Changes

- **2026-11-03** `107f8d039de2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/olist/apis/olist-erp-api-v3/changes/notas/:idNota/cancelar/post.md)

---

[API](https://skmtc.dev/olist/apis/olist-erp-api-v3.md) - [All operations](https://skmtc.dev/olist/apis/olist-erp-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/olist/apis/olist-erp-api-v3/revisions/107f8d039de2?raw)