> For the complete documentation index, see [llms.txt](https://apidocs.cloudinvoice.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.cloudinvoice.net/documentacao-api/saf-t-pt/cancel.md).

# Cancel

## Cancelar Ficheiro SAF-T(PT)

## Marca o registo do ficheiro SAF-T(PT) como cancelado.

<mark style="color:green;">`POST`</mark> `https://api.cloudinvoice.net/saft/:id/cancel/`

{% hint style="info" %}
O cancelamento do ficheiro SAF-T(PT) é apenas uma forma de o marcar como inválido.\
Poderá ser útil no caso de haver uma rectificação de forma a manter a versão inicial, sabendo imediatamente que não se trata de um SAF-T(PT) válido.
{% endhint %}

#### Path Parameters

| Name | Type    | Description                                     |
| ---- | ------- | ----------------------------------------------- |
| id   | integer | O ID do registo SAF-T(PT) que pretende cancelar |

#### Request Body

| Name                                             | Type   | Description                                                                                             |
| ------------------------------------------------ | ------ | ------------------------------------------------------------------------------------------------------- |
| cancel\_reason<mark style="color:red;">\*</mark> | string | <p>Razão do Cancelamento<br><br>Serve apenas como uma nota interna, sem qualquer relevância fiscal.</p> |

{% tabs %}
{% tab title="Exemplo de Pedido" %}

```shell
curl -X POST https://api.cloudinvoice.net/saft/1/cancel/
    -d '{"cance_reason": "Para exemplificação"}'
```

{% endtab %}

{% tab title="Exemplo de Resposta" %}

<pre class="language-json"><code class="lang-json">{
    "id": 1,
    "saft_file_type_id": 3101,
    "saft_file_type": {
        "code": "M",
        "description": "Mensal"
    },
    "location_id": null,
    "location": {
        "code": "__all__",
        "description": "Todas"
    },
    "file_year": 2025,
    "file_month": 12,
    "file_initial_date": "2025-12-01",
    "file_final_date": "2025-12-31",
    "emission_date": "2026-01-01",
    "emission_user_name": "Utilizador",
<strong>    "is_file_canceled": true,
</strong><strong>    "cancel_date": "2026-04-13 13:54:23",
</strong><strong>    "cancel_user_name": "Utilizador",
</strong><strong>    "cancel_reason": "Para exemplificação"
</strong>}
</code></pre>

{% endtab %}
{% endtabs %}

Para ver exemplos de pedidos nas várias linguagens, consulte a página[ Exemplos de Pedidos.](/introducao/exemplos-de-pedidos.md)