# Como cancelar uma nota fiscal emitida via api

> ```
> POST /api/v1/invoice/{invoiceId}/cancel
> ```
> Você encontra a documentação mais detalhada desse endpoint nas [documentações de api](/api#tag/invoice/POST/api/v1/invoice/{correlationID}/cancel)

## Endpoint 

```
POST /api/v1/invoice/{invoiceId}/cancel
```
Você encontra a documentação mais detalhada desse endpoint nas [documentações de api](/api#tag/invoice/POST/api/v1/invoice/{correlationID}/cancel)

Para cancelar uma nota fical é necessário o id de uma nota fical já emidida posteriormente, após a requisição de cancelamento, os documentos virão marcados como nota fiscal cancelada.

### Erros mapeados

* `Invoice not found`
* `Integration not found`
* `Cannot cancel a not confirmed invoice`

### Exemplos em código

  

**Shell + cURL**

```sh
 curl --request POST \
     --url https://api.woovi.com/api/v1/invoice/{id}/cancel \
     --header 'Authorization: {AUTHORIZATION TOKEN}' \
     --header 'content-type: application/json'
```

**JavaScript + Fetch**

```js
fetch('https://api.woovi.com/api/v1/invoice/{id}/cancel', {
  method: 'POST',
  headers: {
    Authorization: {AUTHORIZATION TOKEN},
    'Content-Type': 'application/json',
  },
}).then(async (res) => res.json())
```