---
title: Excepções ao posto de trabalho/pessoa
description: Aqui aprenderás a criar, atualizar e eliminar excepções de postos de trabalho e de pessoas. As excepções são pausas nas capacidades de um posto de trabalho ou nos turnos de uma pessoa. Uma exceção de máquina pode ser, por exemplo,…
url: "https://skyplanner.ai/pt-br/docs/excepcoes-ao-posto-de-trabalho-pessoa/"
updated: "2025-10-08"
category: Integrações
tags:
  - API
  - Integração
---

# Excepções ao posto de trabalho/pessoa

Aqui aprenderás a criar, atualizar e eliminar excepções de postos de trabalho e de pessoas. As excepções são pausas nas capacidades de um posto de trabalho ou nos turnos de uma pessoa. Uma exceção de máquina pode ser, por exemplo, uma interrupção de serviço ou de manutenção e uma exceção de pessoa pode ser um feriado, uma baixa por doença ou umas férias.

#### Excepções à estação de trabalho

As excepções de estação de trabalho podem ser acedidas a partir do ponto final /workstation-exceptions.

As excepções de pessoas podem ser acedidas a partir do ponto final /person-exceptions.

#### Obtenção de excepções

Vai buscar as excepções existentes enviando pedidos GET como este:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-2.png)
**Fig. 1.** Obter as excepções de uma pessoa

Podes obter as excepções da estação de trabalho por **tipo**, **workstation_id**, **external_id** ou condições **modificadas**.

Podes ir buscar excepções de pessoas por **tipo**, **person_id** ou condições **modificadas**

#### Criar uma exceção

Podes criar uma exceção de estação de trabalho enviando um pedido POST como este:

![](https://skyplanner.ai/wp-content/uploads/2025/04/image-5.png)
**Fig. 2.** Criar uma exceção de estação de trabalho

Para especificar a estação de trabalho para a qual a exceção está programada, utiliza o campo **workstation_id**.

Os **tipos** de excepções permitidos para as estações de trabalho são: **Manutenção**, **Limpeza** e**Deslocação/Organização**.

Nota que também podes fornecer um **external_id** para uma exceção de estação de trabalho.

Para criar uma exceção de pessoa, envia um pedido POST como este:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image.png)
**Fig. 3.** Criar uma exceção de pessoa

Para especificar para que pessoa é criada a exceção, tens de utilizar o **person_id**.

Os **tipos** de excepções permitidos para as pessoas são: **Férias, licença por doença, licença flexível e licença sem vencimento**.

#### Atualizar uma exceção

Para atualizar uma exceção, tens de utilizar o **ID da exceção** que podes obter enviando pedidos GET ou a partir da mensagem de resposta quando crias essa exceção.

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-1.png)
**Fig. 4.** Atualizar uma exceção

#### Eliminar excepções

A eliminação de excepções da estação de trabalho pode ser feita fornecendo **IDs de exceção internos**, **external_ids**ou**workstation_ids**.

A eliminação de excepções de pessoas pode ser feita fornecendo **ids de exceção internos** ou **person_ids**.

Podem ser eliminados vários conjuntos de excepções num único pedido, fornecendo os ids numa matriz:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-4.png)
**Fig. 5.** Eliminar excepções da estação de trabalho

A mensagem de resposta de um pedido DELETE indica-te quantas excepções foram eliminadas.