ausente (Pré-visualização)

absentify é uma solução abrangente de gestão de ausências concebida para o Microsoft 365. Este conector permite uma integração fluida, permitindo-lhe automatizar fluxos de trabalho com base nos pedidos de licença dos empregados, acompanhar os estados de aprovação e sincronizar os dados de ausências entre os seus sistemas empresariais.

Este conector está disponível nos seguintes produtos e regiões:

Serviço	Class	Regiões
Estúdio Copiloto	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps , exceto as seguintes:      - Regiões do Azure Government      - Regiões do Azure China      - Departamento de Defesa dos EUA (DoD)
Aplicações Power	Premium	Todas as regiões do Power Apps , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)
Automatize o poder	Premium	Todas as regiões do Power Automatic , exceto as seguintes:      - Governo dos EUA (CCG)      - Governo dos EUA (GCC High)      - China Cloud operado pela 21Vianet      - Departamento de Defesa dos EUA (DoD)

Contato
Nome	Suporte ausente
URL	https://absentify.com/docs
Email	support@absentify.com

Metadados do conector
Editora	Soluções BrainCore
Sítio Web	https://absentify.com
Política de privacidade	https://absentify.com/privacy-policy
Categorias	Recursos Humanos; Gestão Empresarial

Ausente

O Absentify é uma ferramenta gratuita especificamente concebida para o ambiente Microsoft 365 para gerir de forma eficiente as ausências da sua equipa ou colaboradores. Fornece uma visão abrangente de todo o tempo de folga e das razões apresentadas, eliminando a necessidade de folhas Excel volumosas. absentify oferece a forma mais fácil de aprovar pedidos de férias e feriados, totalmente integrado com o Microsoft Teams e Microsoft 365.

Editora: BrainCore Solutions GmbH

Pré-requisitos

Para usar este conector, precisa de uma conta de trabalho, escola ou pessoal da Microsoft. Deve também aceitar as permissões e o consentimento para ausência seguindo um destes passos:

• Teams: Instala a aplicação Absentify Teams, inicia-a e aceita as permissões e o consentimento.
• Web: Abra o aplicativo Web ausente e aceite as permissões e o consentimento.

Além disso, precisa do Essentials Plan ou superior para usar os gatilhos deste conector.

Operações suportadas

O conector suporta as seguintes operações:

Acionadores

When a leave request is created

Este gatilho é ativado quando um novo pedido é criado na sua empresa.

When a leave request status changes

Este gatilho é ativado quando o estado de um pedido existente muda.

Operações API (Plano Plus necessário)

As seguintes operações requerem o plano absentify Plus:

Members

• [Plus] Get all members - Recuperar todos os membros com filtros opcionais para departamentos, estatuto, datas de emprego e mais.
• [Plus] Invite a member - Convidar um novo membro para o espaço de trabalho.
• [Plus] Get member by ID - Recuperar um membro específico pelo seu ID único.
• [Plus] Update a member - Atualizar a informação de um membro existente.
• [Plus] Delete a member - Eliminar um membro permanentemente.
• [Plus] Get member by Microsoft ID - Recuperar um membro pelo seu ID de utilizador Microsoft.
• [Plus] Get member by email - Recuperar um membro pelo seu endereço de email.
• [Plus] Get member by custom ID - Recuperar um membro pelo seu ID personalizado.
• [Plus] Update member approvers - Atualizar os aprovadores para um membro específico.
• [Plus] Update member allowance - Atualizar o subsídio de um membro para um ano específico.
• [Plus] Add member schedule - Adicionar um novo horário de trabalho para um membro.

Departmentos

• [Plus] Get all departments - Recuperar todos os departamentos do espaço de trabalho.
• [Plus] Create a department - Criar um novo departamento.
• [Plus] Update a department - Atualizar um departamento existente.
• [Plus] Delete a department - Apaga um departamento.

Tipos de Folhas

• [Plus] Get all leave types - Recuperar todos os tipos de folhas configurados no espaço de trabalho.
• [Plus] Create a leave type - Criar um novo tipo de folha.
• [Plus] Update a leave type - Atualizar um tipo de licença existente.
• [Plus] Delete a leave type - Apagar um tipo de saída.

Requests

• [Plus] Get all requests - Recuperar todos os pedidos de licença com filtros opcionais.
• [Plus] Create a request - Criar um novo pedido de licença para um membro.
• [Plus] Get request by ID - Recuperar um pedido de licença específico pelo seu ID.
• [Plus] Update a request - Atualizar o estado de um pedido de licença (aprovar, recusar ou cancelar).
• [Plus] Delete a request - Apagar permanentemente um pedido de licença.

Feriados

• [Plus] Get all public holiday calendars - Recuperar todos os calendários de feriados públicos.
• [Plus] Create a public holiday calendar - Criar um novo calendário de feriados públicos.
• [Plus] Get public holiday calendar by ID - Recuperar um calendário específico com todos os seus feriados.
• [Plus] Update a public holiday calendar - Atualizar um calendário existente.
• [Plus] Delete a public holiday calendar - Apaga um calendário.

Espaço de trabalho

• [Plus] Get workspace settings - Recuperar as definições e configuração do espaço de trabalho.

Ausências

• [Plus] Get absences - Recuperar faltas para um intervalo de datas específico.

Obtenção de credenciais

Para usar este conector, precisa de uma conta de trabalho, escola ou pessoal da Microsoft, com a qual pode iniciar sessão diretamente.

Introdução

Instale o absentify por um dos seguintes métodos:

• Teams: Instala a aplicação Absentify Teams, inicia-a e aceita as permissões e o consentimento.
• Web: Abra o aplicativo Web ausente e aceite as permissões e o consentimento.

Para configurar totalmente a sua conta, siga este guia de início rápido. Certifique-se de que está no Essentials Plan ou superior para triggers, ou no Plus Plan para operações da API.

Agora estás pronto para começar.

Problemas conhecidos e limitações

• No Plano Essenciais, só podes criar três gatilhos. Após o terceiro disparador, receberá uma mensagem de erro e terá de eliminar um gatilho existente antes de criar um novo.
• As operações da API (marcadas com [Plus]) requerem o plano absentify Plus. Se tentar usar estas operações sem o plano Plus, receberá um erro.

Instruções de implantação

Por favor, siga estas instruções para implementar este conector como um conector personalizado no Microsoft Power Automate e Power Apps.

A criar uma ligação

O conector suporta os seguintes tipos de autenticação:

Conexão OAuth	Conexão OAuth	Todas as regiões	Não compartilhável
Padrão [DEPRECATED]	Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.	Todas as regiões	Não compartilhável

Conexão OAuth

ID de autenticação: indefinido

Aplicável: Todas as regiões

Conexão OAuth

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Padrão [DEPRECATED]

Aplicável: Todas as regiões

Esta opção é apenas para conexões mais antigas sem um tipo de autenticação explícita e é fornecida apenas para compatibilidade com versões anteriores.

Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.

Limites de Limitação

Nome	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

[Além disso] Adicionar calendário de membros	Adicione um novo horário de trabalho para um membro. Requer o plano Absentify Plus.
[Além disso] Apagar um pedido	Apaga permanentemente um pedido de licença. Requer o plano Absentify Plus.
[Além disso] Arranja todos os tipos de licença	Recuperar todos os tipos de licença configurados no espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Atualizar aprovadores de membros	Atualize os aprovadores de um membro específico. Suporta gestores de perfil Microsoft, definições de departamento ou aprovadores personalizados. Requer o plano Absentify Plus.
[Além disso] Atualizar o subsídio dos membros	Atualize a subsídio de um membro para um tipo e ano específicos. Requer o plano Absentify Plus.
[Além disso] Atualizar um departamento	Atualize um departamento existente. Requer o plano Absentify Plus.
[Além disso] Atualizar um pedido	Atualize o estado de um pedido de licença (aprovar, recusar ou cancelar). Requer o plano Absentify Plus.
[Além disso] Atualize um calendário de feriados públicos	Atualize um calendário de feriados públicos existente. Requer o plano Absentify Plus.
[Além disso] Atualize um membro	Atualize as informações de um membro existente. Requer o plano Absentify Plus.
[Além disso] Atualize um tipo de licença	Atualize um tipo de licença existente. Requer o plano Absentify Plus.
[Além disso] Consulte o calendário de feriados públicos por ID	Consulte um calendário específico de feriados públicos com todos os seus feriados. Requer o plano Absentify Plus.
[Além disso] Consulte todos os calendários de feriados públicos	Recupere todos os calendários de feriados públicos configurados no espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Convide um membro	Convide um novo membro para o espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Cria um departamento	Crie um novo departamento no espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Crie um calendário de feriados públicos	Crie um novo calendário de feriados públicos no espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Crie um pedido	Crie um novo pedido de licença para um membro. Requer o plano Absentify Plus.
[Além disso] Crie um tipo de folha	Cria um novo tipo de folha no espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Eliminar um calendário de feriados públicos	Apague um calendário de feriados públicos do espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Eliminar um departamento	Apagar um departamento do espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Eliminar um membro	Apague um membro. Todos os dados serão eliminados permanentemente. Requer o plano Absentify Plus.
[Além disso] Eliminar um tipo de saída	Apaga um tipo de saída do espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Obtenha as definições do espaço de trabalho	Recupere as definições e configuração do espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Obtenha faltas	Recuperar faltas para um intervalo de datas específico. As declarações são aprovadas para pedidos de licença dentro do período especificado. Requer o plano Absentify Plus.
[Além disso] Obtenha membro por ID	Recupere um membro específico pelo seu ID único. Requer o plano Absentify Plus.
[Além disso] Obtenha um membro por email	Recupere um membro através do seu endereço de email. Requer o plano Absentify Plus.
[Além disso] Obter membro por ID Microsoft	Recupere um membro pelo seu ID de utilizador Microsoft. Requer o plano Absentify Plus.
[Além disso] Obter membro por ID personalizado	Recupera um membro pelo seu ID personalizado. Requer o plano Absentify Plus.
[Além disso] Receba pedido por ID	Recupere um pedido de licença específico pelo seu ID único. Requer o plano Absentify Plus.
[Além disso] Receba todos os pedidos	Recupera todos os pedidos de licença com filtros opcionais. Requer o plano Absentify Plus.
[Além disso] Reúne todos os departamentos	Recolha todos os departamentos do espaço de trabalho. Requer o plano Absentify Plus.
[Além disso] Reúne todos os membros	Obtenha todos os membros com filtros opcionais por departamentos, estatuto, datas de emprego, estatuto administrativo, processo de aprovação, aprovadores, tipos de subsídios, nome, mês de aniversário e tipo de gestor. Requer o plano Absentify Plus.

[Além disso] Adicionar calendário de membros

ID da Operação:

AddMemberSchedule

Adicione um novo horário de trabalho para um membro. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de Membro	id	True	string	O identificador exclusivo do membro.
Da Data	from		string	Data de início deste horário (YYY-MM-DD).
Segunda-feira AM Ativado	monday_am_enabled		boolean	Se a segunda-feira de manhã está ativada.
Segunda-feira à tarde Ativado	monday_pm_enabled		boolean	Se a segunda-feira à tarde está ativada.
Terça-feira AM Ativado	tuesday_am_enabled		boolean	Se a terça-feira de manhã está ativada.
Terça-feira PM Ativado	tuesday_pm_enabled		boolean	Se a tarde de terça-feira está ativada.
Quarta-feira AM Ativado	wednesday_am_enabled		boolean	Se a manhã de quarta-feira está ativada.
Quarta-feira PM Ativado	wednesday_pm_enabled		boolean	Se a tarde de quarta-feira está ativada.
Quinta-feira de manhã Ativado	thursday_am_enabled		boolean	Se a manhã de quinta-feira está ativada.
Quinta-feira PM Ativado	thursday_pm_enabled		boolean	Se a tarde de quinta-feira está ativada.
Sexta-feira AM Ativado	friday_am_enabled		boolean	Se a manhã de sexta-feira está ativada.
Sexta-feira PM Ativado	friday_pm_enabled		boolean	Se a sexta-feira à tarde está ativada.
Sábado AM Ativado	saturday_am_enabled		boolean	Se o sábado de manhã está ativado.
Sábado PM Ativado	saturday_pm_enabled		boolean	Se o sábado à tarde está ativado.
Domingo AM Ativado	sunday_am_enabled		boolean	Se o domingo de manhã está ativado.
Domingo PM Ativado	sunday_pm_enabled		boolean	Se o domingo à tarde está ativado.

Regressos

O ID do horário.

response

string

[Além disso] Apagar um pedido

ID da Operação:

DeleteRequest

Apaga permanentemente um pedido de licença. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de solicitação	id	True	string	O identificador único do pedido.

Regressos

O ID do pedido apagado.

response

string

[Além disso] Arranja todos os tipos de licença

ID da Operação:

GetLeaveTypes

Recuperar todos os tipos de licença configurados no espaço de trabalho. Requer o plano Absentify Plus.

Regressos

response

array of LeaveType

[Além disso] Atualizar aprovadores de membros

ID da Operação:

UpdateMemberApprovers

Atualize os aprovadores de um membro específico. Suporta gestores de perfil Microsoft, definições de departamento ou aprovadores personalizados. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de Membro	id	True	string	O identificador exclusivo do membro.
Processo de aprovação	approval_process	True	string	Tipo de processo de aprovação.
ID de Membro	member_id		string	Identificação do membro aprovador.
ID de Gestor Antecessor	predecessor_manager_id		string	ID do gestor antecessor (para aprovação linear).

Regressos

A identificação do membro.

response

string

[Além disso] Atualizar o subsídio dos membros

ID da Operação:

UpdateMemberAllowance

Atualize a subsídio de um membro para um tipo e ano específicos. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de Membro	id	True	string	O identificador exclusivo do membro.
ID do tipo de franquia	allowance_type_id	True	string	O identificador único do tipo de permissão.
Ano	year	True	integer	O ano da mesada.
Subsídio	allowance	True	number	Montante total da mesada.
Tempo de Descanso Compensatório	compensatory_time_off	True	number	Tempo compensatório para acrescentar.
Avançado	brought_forward		number	Subsídio antecipado do ano anterior.
Reason	reason		string	Razão para a atualização da concessão.
Sobrescrição Antecipada	overwrite_brought_forward		boolean	Se deve sobrescrever o valor avançado.
Predefinir	set_as_default		boolean	Se deve definir este tipo de permissão como padrão para o membro.
Disabled	disabled		boolean	Se deve desativar este tipo de autorização para o membro.

Regressos

A identificação do membro.

response

string

[Além disso] Atualizar um departamento

ID da Operação:

UpdateDepartment

Atualize um departamento existente. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID do departamento	id	True	string	O identificador único do departamento.
Nome	name		string	Nome do departamento.

Regressos

O ID do departamento atualizado.

response

string

[Além disso] Atualizar um pedido

ID da Operação:

UpdateRequest

Atualize o estado de um pedido de licença (aprovar, recusar ou cancelar). Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de solicitação	id	True	string	O identificador único do pedido.
Situação	status	True	string	Novo estado para o pedido.
Reason	reason		string	Razão para a alteração de estatuto.

Regressos

O ID do pedido atualizado.

response

string

[Além disso] Atualize um calendário de feriados públicos

ID da Operação:

UpdatePublicHoliday

Atualize um calendário de feriados públicos existente. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID do Calendário de Feriados Públicos	id	True	string	O identificador único do calendário de feriados oficiais.
Nome	name		string	Nome do calendário de feriados públicos.
Country	country		string	Código do país para feriados públicos.

Regressos

O ID do calendário de feriados públicos atualizado.

response

string

[Além disso] Atualize um membro

ID da Operação:

UpdateMember

Atualize as informações de um membro existente. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de Membro	id	True	string	O identificador exclusivo do membro.
É administrador	is_admin		boolean	Se o membro deve ser administrador.
ID do departamento	id		string	ID do departamento.
Data de Início de Emprego	employment_start_date		string	Data de início de emprego.
Data de Término do Emprego	employment_end_date		string	Data de fim de emprego.
ID do Calendário de Feriados Públicos	public_holiday_id		string	ID do calendário de feriados públicos a atribuir.
Aniversário	birthday		string	Aniversário do membro.
ID personalizado	custom_id		string	Identificador personalizado para o membro.
Situação	status		string	Estado do membro.

Regressos

O ID do membro atualizado.

response

string

[Além disso] Atualize um tipo de licença

ID da Operação:

UpdateLeaveType

Atualize um tipo de licença existente. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
Deixar ID do Tipo	id	True	string	O identificador único do tipo de licença.
Nome	name		string	Nome do tipo de licença.
Unidade de Licença	leave_unit		string	Unidade para este tipo de licença.
Cor	color		string	Código de cores para este tipo de folha.
Ícone	icon		string	Ícone para este tipo de folha.

Regressos

O ID do tipo de licença atualizado.

response

string

[Além disso] Consulte o calendário de feriados públicos por ID

ID da Operação:

GetPublicHolidayById

Consulte um calendário específico de feriados públicos com todos os seus feriados. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID do Calendário de Feriados Públicos	id	True	string	O identificador único do calendário de feriados oficiais.

Regressos

Calendário detalhado de feriados públicos com feriados.

Detalhes do Calendário de Feriados Públicos

PublicHolidayCalendarDetail

[Além disso] Consulte todos os calendários de feriados públicos

ID da Operação:

GetPublicHolidays

Recupere todos os calendários de feriados públicos configurados no espaço de trabalho. Requer o plano Absentify Plus.

Regressos

response

array of PublicHolidayCalendar

[Além disso] Convide um membro

ID da Operação:

InviteMember

Convide um novo membro para o espaço de trabalho. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
Nome	name	True	string	Nome do membro a convidar.
Email	email		string	Endereço de email do membro.
ID do departamento	id		string	ID do departamento.
Data de Início de Emprego	employment_start_date		string	Data de início de emprego.
ID do Calendário de Feriados Públicos	public_holiday_id	True	string	ID do calendário de feriados públicos a atribuir.
Aniversário	birthday		string	Aniversário do membro.
ID personalizado	custom_id		string	Identificador personalizado para o membro.

Regressos

O documento de identificação do membro convidado.

response

string

[Além disso] Cria um departamento

ID da Operação:

CreateDepartment

Crie um novo departamento no espaço de trabalho. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
Nome	name	True	string	Nome do departamento.

Regressos

O ID do departamento criado.

response

string

[Além disso] Crie um calendário de feriados públicos

ID da Operação:

CreatePublicHoliday

Crie um novo calendário de feriados públicos no espaço de trabalho. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
Nome	name	True	string	Nome do calendário de feriados públicos.
Country	country		string	Código do país para feriados públicos.

Regressos

O ID do calendário de feriados públicos criado.

response

string

[Além disso] Crie um pedido

ID da Operação:

CreateRequest

Crie um novo pedido de licença para um membro. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de Membro	member_id	True	string	Identificação do membro que pede licença.
Deixar ID do Tipo	leave_type_id	True	string	Identificação do tipo de licença.
Data de início	start	True	string	Data de início da licença (YYYY-MM-DD).
Hora de Início	start_at		string	Hora do dia em que a licença começa.
Data de fim	end	True	string	Data de fim da licença (YYY-MM-DD).
Hora de Término	end_at		string	Hora do dia em que a licença termina.
Reason	reason		string	Motivo do pedido de licença.

Regressos

O ID do pedido criado.

response

string

[Além disso] Crie um tipo de folha

ID da Operação:

CreateLeaveType

Cria um novo tipo de folha no espaço de trabalho. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
Nome	name	True	string	Nome do tipo de licença.
Unidade de Licença	leave_unit		string	Unidade para este tipo de licença.
Cor	color		string	Código de cores para este tipo de folha.
Ícone	icon		string	Ícone para este tipo de folha.

Regressos

O ID do tipo de licença criado.

response

string

[Além disso] Eliminar um calendário de feriados públicos

ID da Operação:

DeletePublicHoliday

Apague um calendário de feriados públicos do espaço de trabalho. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID do Calendário de Feriados Públicos	id	True	string	O identificador único do calendário de feriados oficiais.

Regressos

O ID do calendário de feriados públicos apagado.

response

string

[Além disso] Eliminar um departamento

ID da Operação:

DeleteDepartment

Apagar um departamento do espaço de trabalho. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID do departamento	id	True	string	O identificador único do departamento.

Regressos

O ID do departamento apagado.

response

string

[Além disso] Eliminar um membro

ID da Operação:

DeleteMember

Apague um membro. Todos os dados serão eliminados permanentemente. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de Membro	id	True	string	O identificador exclusivo do membro.

Regressos

O ID do membro eliminado.

response

string

[Além disso] Eliminar um tipo de saída

ID da Operação:

DeleteLeaveType

Apaga um tipo de saída do espaço de trabalho. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
Deixar ID do Tipo	id	True	string	O identificador único do tipo de licença.

Regressos

O ID do tipo de licença eliminado.

response

string

[Além disso] Obtenha as definições do espaço de trabalho

ID da Operação:

GetWorkspace

Recupere as definições e configuração do espaço de trabalho. Requer o plano Absentify Plus.

Regressos

Definições e configuração do espaço de trabalho.

Espaço de trabalho

Workspace

[Além disso] Obtenha faltas

ID da Operação:

GetAbsences

Recuperar faltas para um intervalo de datas específico. As declarações são aprovadas para pedidos de licença dentro do período especificado. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
Data de início	start	True	date	Data de início para a consulta de ausências (YYY-MM-DD).
Data de fim	end	True	date	Data de término da consulta de ausência (YYYY-MM-DD).
ID de Membro	member_id		string	Filtrar por ID de membro.
ID do departamento	department_id		string	Filtrar por ID de departamento.

Regressos

response

array of Absence

[Além disso] Obtenha membro por ID

ID da Operação:

GetMemberById

Recupere um membro específico pelo seu ID único. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de Membro	id	True	string	O identificador exclusivo do membro.

Regressos

Informações detalhadas sobre membros, incluindo horários.

Detalhes do Membro

MemberDetail

[Além disso] Obtenha um membro por email

ID da Operação:

GetMemberByEmail

Recupere um membro através do seu endereço de email. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
Email	email	True	string	O endereço de email do membro.

Regressos

Informações detalhadas sobre membros, incluindo horários.

Detalhes do Membro

MemberDetail

[Além disso] Obter membro por ID Microsoft

ID da Operação:

GetMemberByMicrosoftId

Recupere um membro pelo seu ID de utilizador Microsoft. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de Utilizador Microsoft	microsoft_user_id	True	string	O ID de utilizador da Microsoft.

Regressos

Informações detalhadas sobre membros, incluindo horários.

Detalhes do Membro

MemberDetail

[Além disso] Obter membro por ID personalizado

ID da Operação:

GetMemberByCustomId

Recupera um membro pelo seu ID personalizado. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID personalizado	custom_id	True	string	O ID personalizado do membro.

Regressos

Informações detalhadas sobre membros, incluindo horários.

Detalhes do Membro

MemberDetail

[Além disso] Receba pedido por ID

ID da Operação:

GetRequestById

Recupere um pedido de licença específico pelo seu ID único. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de solicitação	id	True	string	O identificador único do pedido.

Regressos

Um pedido de licença.

Solicitação

Request

[Além disso] Receba todos os pedidos

ID da Operação:

GetRequests

Recupera todos os pedidos de licença com filtros opcionais. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
ID de Membro	member_id		string	Filtrar por ID de membro.
Situação	status		string	Filtrar pelo estado do pedido.
Comece a partir de	start_from		string	Filtrar por data de início (de).
Começar a	start_to		string	Filtrar por data de início (para).
Fim de	end_from		string	Filtrar por data de término (de).
Fim de	end_to		string	Filtrar por data de término (para).
Deixar ID do Tipo	leave_type_id		string	Filtrar por ID do tipo de folha.
ID do departamento	department_id		string	Filtrar por ID de departamento.

Regressos

response

array of Request

[Além disso] Reúne todos os departamentos

ID da Operação:

GetDepartments

Recolha todos os departamentos do espaço de trabalho. Requer o plano Absentify Plus.

Regressos

response

array of Department

[Além disso] Reúne todos os membros

ID da Operação:

GetMembers

Obtenha todos os membros com filtros opcionais por departamentos, estatuto, datas de emprego, estatuto administrativo, processo de aprovação, aprovadores, tipos de subsídios, nome, mês de aniversário e tipo de gestor. Requer o plano Absentify Plus.

Parâmetros

Nome	Chave	Necessário	Tipo	Descrição
IDs de departamento	department_ids		array	Filtrar por IDs de departamento.
Situação	status		string	Filtrar por estado de membro.
Início de Emprego	employment_start_date_from		string	Filtrar por data de início de emprego (de).
Início de Emprego	employment_start_date_to		string	Filtrar por data de início de emprego (para).
Fim do emprego a partir de	employment_end_date_from		string	Filtrar por data de fim de emprego (de).
Emprego Fim a	employment_end_date_to		string	Filtrar por data de fim de emprego (para).
É administrador	is_admin		boolean	Filtrar por estado de administrador.
Processo de aprovação	approval_process		string	Filtrar por tipo de processo de aprovação.
Tem Aprovadores	has_approvers		boolean	Filtrar por se o membro tem aprovadores.
ID do tipo de franquia	allowance_type_id		string	Filtrar por ID do tipo de permissão.
Nome	name		string	Filtrar por nome de membro.
Mês de Aniversário	birthday_month		integer	Filtrar por mês de aniversário (1-12).
Tipo de Gestor	manager_type		string	Filtra por tipo de gestor.

Regressos

response

array of Member

Gatilhos

Pedido criado	Esse gatilho é executado quando uma nova solicitação é criada na sua empresa.
Status da solicitação atualizado	Esse gatilho é executado se o status de uma solicitação existente for alterado.

Pedido criado

ID da Operação:

TriggerRequestCreated

Esse gatilho é executado quando uma nova solicitação é criada na sua empresa.

Regressos

Body

RequestWebhookPayloadV1

Status da solicitação atualizado

ID da Operação:

TriggerRequestStatusChanged

Esse gatilho é executado se o status de uma solicitação existente for alterado.

Regressos

Body

RequestWebhookPayloadV1

Definições

RequestWebhookPayloadV1

Nome	Percurso	Tipo	Descrição
id	id	string	id
pedido criado em	createdAt	string	pedido criado em
pedido atualizado em	updatedAt	string	pedido atualizado em
Solicitar data de início	start	string	Solicitar data de início
Pedido de início em	start_at	string	Pedido de início em
Data de fim do pedido	end	string	Data de fim do pedido
Pedido terminado em	end_at	string	Pedido terminado em
Duração do pedido substracted	duration	float	Duração do pedido substracted
Ano do pedido	year	integer	Ano do pedido
Estado do pedido	details.status	string	Estado do pedido
Pedido deduzido da franquia do utilizador	details.deducted	float	Pedido deduzido da franquia do utilizador
Motivo do pedido	details.reason	string	Motivo do pedido
Processo de aprovação	details.approval_process	string	Processo de aprovação
Solicitar aprovadores	details.request_approvers	array of object	Solicitar aprovadores
Uuid interno	details.request_approvers.uuid	string	Uuid interno
Situação	details.request_approvers.status	string	Situação
Alterado por e-mail	details.request_approvers.status_changed_by_member.email	string	Alterado por e-mail
Alterado pelo nome	details.request_approvers.status_changed_by_member.name	string	Alterado pelo nome
Alterado por id	details.request_approvers.status_changed_by_member.id	string	Alterado por id
Alterado por id personalizado	details.request_approvers.status_changed_by_member.custom_id	string	Alterado por id personalizado
Data de alteração do estado	details.request_approvers.status_change_date	date-time	Data de alteração do estado
Solicitação predecessora ID do aprovador de membro	details.request_approvers.predecessor_request_member_approver_id	string	Há algum antecessor que precise aprovar antes?
Reason	details.request_approvers.reason	string	Reason
Solicitar e-mail do solicitante	details.requester_member.email	string	Solicitar e-mail do solicitante
Solicitar nome do solicitante	details.requester_member.name	string	Solicitar nome do solicitante
Solicitar ID do solicitante	details.requester_member.id	string	Solicitar ID do solicitante
Solicitar ID personalizado do solicitante	details.requester_member.custom_id	string	Solicitar ID personalizado do solicitante
Subsídios	details.requester_member.allowances	array of object	Subsídios
Subsídio	details.requester_member.allowances.allowance	number	Subsídio
Transitado	details.requester_member.allowances.brought_forward	number	Transitado
Folgas compensatórias	details.requester_member.allowances.compensatory_time_off	number	Folgas compensatórias
Restantes	details.requester_member.allowances.remaining	number	Restantes
Tomadas	details.requester_member.allowances.taken	number	Tomadas
Ano	details.requester_member.allowances.year	number	Ano
Data de aprovação do pedido (preterido)	details.approved_date	string	Data de aprovação do pedido (preterido)
Motivo do pedido de cancelamento	details.cancel_reason	string	Motivo do pedido de cancelamento
Solicitar data de cancelamento	details.canceld_date	string	Solicitar data de cancelamento
Data de solicitação recusada (preterida)	details.declined_date	string	Data de solicitação recusada (preterida)
Motivo de recusa da solicitação (preterido)	details.decline_reason	string	Motivo de recusa da solicitação (preterido)
Solicitar e-mail do aprovador (preterido)	details.approver_member.email	string	Solicitar e-mail do aprovador (preterido)
Solicitar nome do aprovador (preterido)	details.approver_member.name	string	Solicitar nome do aprovador (preterido)
Solicitar ID do aprovador (preterido)	details.approver_member.id	string	Solicitar ID do aprovador (preterido)
Solicitar ID personalizado do aprovador (preterido)	details.approver_member.custom_id	string	Solicitar ID personalizado do aprovador (preterido)
Pedido cancelado por email	details.canceld_by_member.email	string	Pedido cancelado por email
Pedido cancelado pelo nome	details.canceld_by_member.name	string	Pedido cancelado pelo nome
Pedido cancelado por id	details.canceld_by_member.id	string	Pedido cancelado por id
Pedido cancelado por id personalizado	details.canceld_by_member.custom_id	string	Pedido cancelado por id personalizado
Pedido recusado por e-mail (preterido)	details.declined_by_member.email	string	Pedido recusado por e-mail (preterido)
Pedido recusado por nome (preterido)	details.declined_by_member.name	string	Pedido recusado por nome (preterido)
Solicitação recusada por id (preterido)	details.declined_by_member.id	string	Solicitação recusada por id (preterido)
Solicitação recusada por id personalizada (preterida)	details.declined_by_member.custom_id	string	Solicitação recusada por id personalizada (preterida)
Deixar id do tipo	details.leave_type.id	string	Deixar id do tipo
Deixar nome do tipo	details.leave_type.name	string	Deixar nome do tipo

MemberReference

Referência a um membro.

Nome	Percurso	Tipo	Descrição
ID de Membro	id	string	Identificador único do membro.
ID personalizado	custom_id	string	Identificador personalizado para o membro.
Nome	name	string	Nome do membro.
Email	email	string	Endereço de email do membro.

LeaveTypeV2

Informação sobre o tipo de licença.

Nome	Percurso	Tipo	Descrição
Deixar ID do Tipo	id	string	Identificador único do tipo de licença.
Deixar Nome do Tipo	name	string	Nome do tipo de licença.
Unidade de Licença	leave_unit	string	Unidade do tipo de licença.

AllowanceTypeV2

Informação sobre o tipo de subsídio.

Nome	Percurso	Tipo	Descrição
ID do tipo de franquia	id	string	Identificador único do tipo de permissão.
Nome do tipo de franquia	name	string	Nome do tipo de subsídio.
Ignorar o Limite	ignore_allowance_limit	boolean	Se o limite da concessão deve ser ignorado.
Unidade de Subsídio	allowance_unit	string	Unidade da mesada.

RequestApproverV2

Informação sobre um aprovador de pedidos.

Nome	Percurso	Tipo	Descrição
Estatuto de Aprovador	status	string	Estado atual da aprovação.
Razão do Aprovador	reason	string	Razão fornecida pelo aprovador.
Data de alteração de estatuto	status_changed_date	string	Data em que o estado da aprovação foi alterado.
Membro	status_changed_by_member	MemberReference	Referência a um membro.
Membro	approver_member	MemberReference	Referência a um membro.

Membro

Um membro no espaço de trabalho.

Nome	Percurso	Tipo	Descrição
ID de Membro	id	string	Identificador único do membro.
ID personalizado	custom_id	string	Identificador personalizado para o membro.
Nome	name	string	Nome do membro.
Email	email	string	Endereço de email do membro.
Criado em	createdAt	string	Carimbo temporal em que o membro foi criado.
Atualizado em	updatedAt	string	Carimbo temporal de quando o membro foi atualizado pela última vez.
Situação	status	string	Estado atual do membro.
Aniversário	birthday	string	Aniversário do membro.
Data de Início de Emprego	employment_start_date	string	Data de início de emprego do membro.
Data de Término do Emprego	employment_end_date	string	Data de fim de emprego do membro.
É administrador	is_admin	boolean	Se o membro é administrador.
Processo de aprovação	approval_process	string	Tipo de processo de aprovação para este membro.
Departmentos	departments	array of MemberDepartment	Departamentos a que pertence o membro.
Subsídios	allowances	array of MemberAllowance	Permissões para o membro.

MemberDetail

Informações detalhadas sobre membros, incluindo horários.

Nome	Percurso	Tipo	Descrição
ID de Membro	id	string	Identificador único do membro.
ID personalizado	custom_id	string	Identificador personalizado para o membro.
Nome	name	string	Nome do membro.
Email	email	string	Endereço de email do membro.
Criado em	createdAt	string	Carimbo temporal em que o membro foi criado.
Atualizado em	updatedAt	string	Carimbo temporal de quando o membro foi atualizado pela última vez.
Situação	status	string	Estado atual do membro.
Aniversário	birthday	string	Aniversário do membro.
Data de Início de Emprego	employment_start_date	string	Data de início de emprego do membro.
Data de Término do Emprego	employment_end_date	string	Data de fim de emprego do membro.
É administrador	is_admin	boolean	Se o membro é administrador.
Processo de aprovação	approval_process	string	Tipo de processo de aprovação para este membro.
Departmentos	departments	array of MemberDepartment	Departamentos a que pertence o membro.
Subsídios	allowances	array of MemberAllowance	Permissões para o membro.
Aprovadores	has_approvers	array of ApproverInfo	Lista de aprovadores para este membro.
Horários	schedules	array of Schedule	Horários de trabalho para o membro.

Departamento de Membros

Atribuição de departamento para um membro.

Nome	Percurso	Tipo	Descrição
ID do departamento	id	string	Identificador único do departamento.
Nome do Departamento	name	string	Nome do departamento.
Tipo de Gestor	manager_type	string	Papel do membro no departamento.

Subsídio de Membro

Informação sobre o subsídio para um membro.

Nome	Percurso	Tipo	Descrição
Allowance ID	id	string	Identificador único do registo de concessão.
Ano	year	integer	Ano para esta mesada.
Subsídio	allowance	number	Montante total da mesada.
Tomadas	taken	number	Quantia já recebida da mesada.
Restantes	remaining	number	Valor restante da mesada.
Avançado	brought_forward	number	Subsídio antecipado do ano anterior.
Tempo de Descanso Compensatório	compensatory_time_off	number	Tempo compensatório adicionado.
Tipo de subsídio	allowance_type	AllowanceTypeV2	Informação sobre o tipo de subsídio.

ApproverInfo

Informação sobre um aprovador.

Nome	Percurso	Tipo	Descrição
Membro	member	MemberReference	Referência a um membro.

Schedule

Horário de trabalho para um membro.

Nome	Percurso	Tipo	Descrição
ID da agenda	id	string	Identificador único do calendário.
Da Data	from	string	Data de início deste horário.
Criado em	createdAt	string	Carimbo temporal em que o horário foi criado.
Atualizado em	updatedAt	string	Carimbo temporal quando o horário foi atualizado pela última vez.

Departamento

Um departamento no espaço de trabalho.

Nome	Percurso	Tipo	Descrição
ID do departamento	id	string	Identificador único do departamento.
Nome	name	string	Nome do departamento.
Criado em	createdAt	string	Carimbo temporal em que o departamento foi criado.
Atualizado em	updatedAt	string	Carimbo temporal de quando o departamento foi atualizado pela última vez.

LeaveType

Um tipo de licença no espaço de trabalho.

Nome	Percurso	Tipo	Descrição
Deixar ID do Tipo	id	string	Identificador único do tipo de licença.
Nome	name	string	Nome do tipo de licença.
Unidade de Licença	leave_unit	string	Unidade para este tipo de licença.
Cor	color	string	Código de cores para este tipo de folha.
Ícone	icon	string	Ícone para este tipo de folha.
Criado em	createdAt	string	Carimbo temporal em que o tipo de licença foi criado.
Atualizado em	updatedAt	string	Carimbo temporal em que o tipo de licença foi atualizado pela última vez.

Solicitação

Um pedido de licença.

Nome	Percurso	Tipo	Descrição
ID de solicitação	id	string	Identificador único do pedido.
Criado em	createdAt	string	Carimbo temporal em que o pedido foi criado.
Atualizado em	updatedAt	string	Carimbo temporal em que o pedido foi atualizado pela última vez.
Data de início	start	string	Data de início do pedido.
Hora de Início	start_at	string	Hora do dia em que a licença começa.
Data de fim	end	string	Data final do pedido.
Hora de Término	end_at	string	Hora do dia em que a licença termina.
Situação	status	string	Estado atual do pedido.
Reason	reason	string	Motivo do pedido de licença.
Duração	duration	number	Duração da licença.
Duração do Dia de Trabalho	workday_absence_duration	number	Duração em dias úteis.
Unidade de Licença	leave_unit	string	Unidade para esta licença.
Membro	requester_member	MemberReference	Referência a um membro.
Tipo de Licença	leave_type	LeaveTypeV2	Informação sobre o tipo de licença.
Aprovadores	request_approvers	array of RequestApproverV2	Lista de aprovadores para este pedido.

CalendárioFeriadoPúblico

Um calendário de feriados públicos.

Nome	Percurso	Tipo	Descrição
ID do calendário	id	string	Identificador exclusivo do calendário.
Nome	name	string	Nome do calendário de feriados públicos.
Country	country	string	País para os feriados públicos.
Criado em	createdAt	string	Carimbo temporal em que o calendário foi criado.
Atualizado em	updatedAt	string	Carimbo temporal quando o calendário foi atualizado pela última vez.

Detalhe do CalendárioDeFeriado Público

Calendário detalhado de feriados públicos com feriados.

Nome	Percurso	Tipo	Descrição
ID do calendário	id	string	Identificador exclusivo do calendário.
Nome	name	string	Nome do calendário de feriados públicos.
Country	country	string	País para os feriados públicos.
Feriados	holidays	array of PublicHoliday	Lista de feriados neste calendário.

Feriado Público

Um feriado público.

Nome	Percurso	Tipo	Descrição
Cartão de Natal	id	string	Identificador único do feriado.
Nome	name	string	Nome do feriado.
Date	date	string	Data do feriado.
Duração	duration	number	Duração do feriado (0,5 para meio dia, 1 para dia inteiro).

Espaço de trabalho

Definições e configuração do espaço de trabalho.

Nome	Percurso	Tipo	Descrição
ID do espaço de trabalho	id	string	Identificador exclusivo do espaço de trabalho.
Nome	name	string	Nome do espaço de trabalho.
Criado em	createdAt	string	Carimbo temporal em que o espaço de trabalho foi criado.
Atualizado em	updatedAt	string	Carimbo temporal da última atualização do espaço de trabalho.

Ausência

Uma entrada por ausência.

Nome	Percurso	Tipo	Descrição
ID de ausência	id	string	Identificador único da ausência.
Date	date	string	Data da ausência.
Duração	duration	number	Duração da ausência.
Membro	member	MemberReference	Referência a um membro.
Tipo de Licença	leave_type	LeaveTypeV2	Informação sobre o tipo de licença.
ID de solicitação	request_id	string	Identificação do pedido de licença associado.

cadeia (de caracteres)

Este é o tipo de dados básico 'string'.