# Check

## Verificar Estado da Criação do Ficheiro SAF-T(PT)

## Verifica o estado do processo assíncrono de criação do novo ficheiro SAF-T(PT).

<mark style="color:blue;">`GET`</mark> `https://api.cloudinvoice.net/saft/:task_id/check/`

{% hint style="info" %}
Em caso de necessidade de aguardar pelo final do processo, este endpoint poderá ser usado para fazer polling ao estado do processo de criação do SAF-T(PT) com intervalos de alguns segundos.
{% endhint %}

#### Path Parameters

| Name     | Type   | Description                                                                                                                                                        |
| -------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| task\_id | string | <p>ID da Tarefa Assíncrona<br><br>Este ID é obtido na resposta ao pedido de criação do Ficheiro SAF-T(PT) em <a href="/pages/A1jnGqIYfs0NSbNSwb79">Create</a>.</p> |

{% hint style="info" %}
Após concluído o processo de criação do SAF-T(PT), a resposta a este pedido tomará um aspeto idêntico à de um pedido [Get](/documentacao-api/saf-t-pt/get.md) comum.
{% endhint %}

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

```shell
curl https://api.cloudinvoice.net/saft/c3383434-d4de-46af-b0a9-1fbfe5118322/check/
    -H "Content-Type: application/json"
```

{% endtab %}

{% tab title="Ex. Resposta (Em execução)" %}

```json
{
    "id": "c3383434-d4de-46af-b0a9-1fbfe5118322",
    "name": "generate_saft",
    "status": "running"
}
```

{% endtab %}

{% tab title="Ex. Resposta (concluído)" %}

```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",
    "is_file_canceled": false,
    "cancel_date": null,
    "cancel_user_name": "",
    "cancel_reason": null
}
```

{% endtab %}
{% endtabs %}

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.cloudinvoice.net/documentacao-api/saf-t-pt/check.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.