Create

Criar Ficheiro SAF-T(PT)

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

POST https://api.cloudinvoice.net/saft/new/

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.

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.

Request Body

Name	Type	Description
file_initial_date*	date Format: yyyy-mm-dd	Data de Início
file_final_date*	date Format: yyyy-mm-dd	Data de Fim
location_id	integer	Localização Consulte Tabela Localizações no Backoffice.
send_saft_by_email	boolean	Enviar por E-mail Envia o ficheiro por e-mail imediatamente após gerado.
email_address	string	Endereço de E-mail
accountant_email_address	string	Endereço de Email do Contabilista Este endereço é guardado nas configurações para uso futuro.

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.

Exemplo de Pedido

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

Exemplo de Resposta

Para ver exemplos de pedidos nas várias linguagens, consulte a página Exemplos de Pedidos.