> 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/create.md).

# 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)