# Cancelar Nota Fiscal
`DELETE /v1/invoices/notas/:notaid`
**Área:** Notas Fiscais

**Scopes necessários:** `nota.fiscal/write`

Cancela na prefeitura uma nota fiscal já autorizada. O identificador é o `invoiceId` da listagem.

O motivo vai na query string, e não no corpo: parte dos clientes HTTP descarta body em requisições DELETE.

Só é possível cancelar notas da própria conta e que estejam autorizadas. O status é reconferido antes do cancelamento: nota em processamento ou já cancelada é recusada com `NF_NOT_AUTHORIZED`.

O prazo de cancelamento é definido pela prefeitura do município emissor. Passada essa janela, o cancelamento é recusado com `NF_CANCEL_FAILED` e a correção passa a exigir substituição da nota.

Case de uso:

_Como prestador, quero cancelar uma nota emitida com valor errado, dentro do prazo permitido pelo município._

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `notaid` | **sim** | Notaid |

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `motivo` | não | Justificativa enviada à prefeitura - required |

### Resposta 200 — 200

```json
{
  "success": true,
  "invoiceId": "nf_1788101026585_uqaspo7bn"
}
```

### Resposta 400 — 400 - não autorizada

```json
{
    "error": {
        "message": "Nota fiscal não está autorizada para cancelamento",
        "code": "NF_NOT_AUTHORIZED",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

### Resposta 404 — 404

```json
{
    "error": {
        "message": "Nota fiscal não encontrada",
        "code": "NOTA_NOT_FOUND",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/delete-cancelar-nota-fiscal
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json