# Create

## Criar Ficheiro SAF-T(PT)

## Inicia a criação de um novo ficheiro SAF-T(PT).

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

{% hint style="danger" %}
Gerar um ficheiro SAF-T(PT) é uma tarefa pesada que pode levar vários minutos a terminar, dependendo do volume de vendas a ser contemplado. Por essa razao, o processo é feito assíncronamente pelos servidores CloudInvoice.

A resposta a este endpoint será dada imediatamente, mas isso não significa que o processo tenha sido concluído.

Para verificar o estado do processo, poderá usar o endpoint [/check](/documentacao-api/saf-t-pt/check.md).
{% endhint %}

{% hint style="info" %}
A API CloudInvoice permite apenas a criação de ficheiros SAF-T(PT) Mensais.\
A criação de ficheiros SAF-T de auditoria deverá ser feita a partir do BackOffice CloudInvoice.
{% endhint %}

#### Request Body

| Name                                                  | Type                                                                           | Description                                                                                                 |
| ----------------------------------------------------- | ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| file\_initial\_date<mark style="color:red;">\*</mark> | <p>date<br><sub><mark style="color:$info;">Format: yyyy-mm-dd</mark></sub></p> | Data de Início                                                                                              |
| file\_final\_date<mark style="color:red;">\*</mark>   | <p>date<br><sub><mark style="color:$info;">Format: yyyy-mm-dd</mark></sub></p> | Data de Fim                                                                                                 |
| location\_id                                          | integer                                                                        | <p>Localização<br><br>Consulte Tabela Localizações no Backoffice.</p>                                       |
| send\_saft\_by\_email                                 | boolean                                                                        | <p>Enviar por E-mail<br><br>Envia o ficheiro por e-mail imediatamente após gerado.</p>                      |
| email\_address                                        | string                                                                         | Endereço de E-mail                                                                                          |
| accountant\_email\_address                            | string                                                                         | <p>Endereço de Email do Contabilista<br><br>Este endereço é guardado nas configurações para uso futuro.</p> |

{% hint style="info" %}
A Resposta a este pedido traz um URL (check\_url) que poderá ser usado para verificação do estado do processo que está a correr assíncronamente nos servidores CloudInvoice. Mais informações em [/check](/documentacao-api/saf-t-pt/check.md).
{% endhint %}

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

```shell
curl -X POST https://api.cloudinvoice.net/saft/new/
    -d '{
        "file_initial_date": "2025-12-01",
        "file_final_date": "2025-12-31"
    }'
```

{% endtab %}

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

```json
{
    "task_id": "c3383434-d4de-46af-b0a9-1fbfe5118322",
    "message": "O ficheiro SAF-T(PT) está a ser gerado. Use o URL em 'check_url' para verificar o estado do processo.",
    "check_url": "https://api.cloudinvoice.net/saft/c3383434-d4de-46af-b0a9-1fbfe5118322/check/"
}
```

{% 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/create.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.