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:
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:
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:
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.
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:
A mensagem de resposta de um pedido DELETE indica-te quantas excepções foram eliminadas.