absentify (anteprima)

absentify è una soluzione completa di gestione delle assenze progettata per Microsoft 365. Questo connettore consente l'integrazione senza problemi, consentendo di automatizzare i flussi di lavoro in base alle richieste di uscita dei dipendenti, tenere traccia degli stati di approvazione e sincronizzare i dati sulle assenze nei sistemi aziendali.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti:      - Aree di Azure per enti pubblici      - Aree di Azure Cina      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Di alta qualità	Tutte le aree di Power Apps , ad eccezione dei seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti:      - Governo degli Stati Uniti (GCC)      - Us Government (GCC High)      - China Cloud gestito da 21Vianet      - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	supporto absentify
URL	https://absentify.com/docs
Email	support@absentify.com

Metadati del connettore
Editore	Soluzioni BrainCore
Sito web	https://absentify.com
Informativa sulla privacy	https://absentify.com/privacy-policy
Categorie	Risorse umane; Gestione aziendale

absentify

absentify è uno strumento gratuito appositamente progettato per l'ambiente Microsoft 365 per gestire in modo efficiente le assenze del team o dei dipendenti. Offre una panoramica completa di tutto il tempo libero e i motivi indicati, eliminando la necessità di fogli di Excel complessi. absentify offre il modo più semplice per approvare le richieste di ferie e le vacanze, completamente integrato con Microsoft Teams e Microsoft 365.

Editore: BrainCore Solutions GmbH

Prerequisiti

Per usare questo connettore, è necessario un account Microsoft aziendale, dell'istituto di istruzione o personale. È anche necessario accettare le autorizzazioni e il consenso per absentify seguendo uno dei passaggi seguenti:

• Teams: installare l'app Teams assente, avviarla e accettare le autorizzazioni e il consenso.
• Web: aprire l'app Web absentify e accettare le autorizzazioni e il consenso.

Inoltre, è necessario il piano Essentials o versione successiva per usare i trigger di questo connettore.

Operazioni supportate

Il connettore supporta le operazioni seguenti:

Attivatori

When a leave request is created

Questo trigger viene attivato quando viene creata una nuova richiesta nell'azienda.

When a leave request status changes

Questo trigger viene attivato quando lo stato di una richiesta esistente cambia.

Operazioni API (più piano obbligatorio)

Le operazioni seguenti richiedono il piano absentify Plus:

Members

• [Plus] Get all members - Recuperare tutti i membri con filtri facoltativi per reparti, stato, date di impiego e altro ancora.
• [Plus] Invite a member - Invitare un nuovo membro nell'area di lavoro.
• [Plus] Get member by ID - Recuperare un membro specifico in base al relativo ID univoco.
• [Plus] Update a member - Aggiornare le informazioni di un membro esistente.
• [Plus] Delete a member - Eliminare un membro in modo permanente.
• [Plus] Get member by Microsoft ID - Recuperare un membro in base all'ID utente Microsoft.
• [Plus] Get member by email - Recuperare un membro in base al proprio indirizzo di posta elettronica.
• [Plus] Get member by custom ID - Recuperare un membro in base al relativo ID personalizzato.
• [Plus] Update member approvers - Aggiornare i responsabili approvazione per un membro specifico.
• [Plus] Update member allowance - Aggiornare l'indennità di un membro per un anno specifico.
• [Plus] Add member schedule - Aggiungere una nuova pianificazione di lavoro per un membro.

Departments

• [Plus] Get all departments - Recuperare tutti i reparti nell'area di lavoro.
• [Plus] Create a department - Creare un nuovo reparto.
• [Plus] Update a department - Aggiornare un reparto esistente.
• [Plus] Delete a department - Eliminare un reparto.

Lasciare i tipi

• [Plus] Get all leave types - Recuperare tutti i tipi di uscita configurati nell'area di lavoro.
• [Plus] Create a leave type - Crea un nuovo tipo di uscita.
• [Plus] Update a leave type - Aggiornare un tipo di uscita esistente.
• [Plus] Delete a leave type - Eliminare un tipo di uscita.

Requests

• [Plus] Get all requests - Recuperare tutte le richieste di uscita con filtri facoltativi.
• [Plus] Create a request - Creare una nuova richiesta di uscita per un membro.
• [Plus] Get request by ID - Recuperare una richiesta di uscita specifica in base al relativo ID.
• [Plus] Update a request - Aggiornare lo stato di una richiesta di uscita (approvare, rifiutare o annullare).
• [Plus] Delete a request - Eliminare una richiesta di uscita in modo permanente.

Giorni festivi

• [Plus] Get all public holiday calendars - Recupera tutti i calendari delle festività pubbliche.
• [Plus] Create a public holiday calendar - Crea un nuovo calendario delle festività pubbliche.
• [Plus] Get public holiday calendar by ID - Recupera un calendario specifico con tutte le festività.
• [Plus] Update a public holiday calendar - Aggiornare un calendario esistente.
• [Plus] Delete a public holiday calendar - Eliminare un calendario.

Workspace

• [Plus] Get workspace settings - Recuperare le impostazioni e la configurazione dell'area di lavoro.

Assenze

• [Plus] Get absences - Recupera le assenze per un intervallo di date specifico.

Recupero delle credenziali

Per usare questo connettore, è necessario un account Microsoft aziendale, dell'istituto di istruzione o personale, che è possibile accedere direttamente.

Come iniziare

Installare absentify tramite uno dei metodi seguenti:

• Teams: installare l'app Teams assente, avviarla e accettare le autorizzazioni e il consenso.
• Web: aprire l'app Web absentify e accettare le autorizzazioni e il consenso.

Per configurare completamente l'account, seguire questa guida introduttiva. Assicurarsi di essere nel piano Essentials o versione successiva per i trigger o di più pianificare le operazioni API.

A questo momento si è pronti per iniziare.

Problemi noti e limitazioni

• Nel piano Essentials è possibile creare solo tre trigger. Dopo il terzo trigger, si riceverà un messaggio di errore e sarà necessario eliminare un trigger esistente prima di crearne uno nuovo.
• Le operazioni API (contrassegnate con [Plus]) richiedono il piano absentify Plus. Se si tenta di usare queste operazioni senza il piano Plus, verrà visualizzato un errore.

Istruzioni per la distribuzione

Seguire queste istruzioni per distribuire questo connettore come connettore personalizzato in Microsoft Power Automate e Power Apps.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:

Connessione OAuth	Connessione OAuth	Tutte le aree geografiche	Non condivisibile
Impostazione predefinita [DEPRECATO]	Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.	Tutte le aree geografiche	Non condivisibile

Connessione OAuth

ID autenticazione: non definito

Applicabile: tutte le aree

Connessione OAuth

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Impostazione predefinita [DEPRECATO]

Applicabile: tutte le aree

Questa opzione è solo per le connessioni meno recenti senza un tipo di autenticazione esplicito e viene fornita solo per la compatibilità con le versioni precedenti.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

[Plus] Aggiornare i responsabili approvazione dei membri	Aggiornare i responsabili approvazione per un membro specifico. Supporta responsabili dei profili Microsoft, impostazioni del reparto o responsabili approvazione personalizzati. Richiede un piano absentify Plus.
[Plus] Aggiornare l'indennità dei membri	Aggiornare l'indennità di un membro per un tipo di indennità e un anno specifici. Richiede un piano absentify Plus.
[Plus] Aggiornare un calendario delle festività pubbliche	Aggiornare un calendario delle festività pubbliche esistente. Richiede un piano absentify Plus.
[Plus] Aggiornare un membro	Aggiornare le informazioni di un membro esistente. Richiede un piano absentify Plus.
[Plus] Aggiornare un reparto	Aggiornare un reparto esistente. Richiede un piano absentify Plus.
[Plus] Aggiornare un tipo di uscita	Aggiornare un tipo di uscita esistente. Richiede un piano absentify Plus.
[Plus] Aggiornare una richiesta	Aggiornare lo stato di una richiesta di uscita (approvare, rifiutare o annullare). Richiede un piano absentify Plus.
[Plus] Aggiungere la pianificazione dei membri	Aggiungere una nuova pianificazione di lavoro per un membro. Richiede un piano absentify Plus.
[Plus] Creare un calendario festività pubblico	Creare un nuovo calendario delle festività pubbliche nell'area di lavoro. Richiede un piano absentify Plus.
[Plus] Creare un reparto	Creare un nuovo reparto nell'area di lavoro. Richiede un piano absentify Plus.
[Plus] Creare un tipo di uscita	Creare un nuovo tipo di uscita nell'area di lavoro. Richiede un piano absentify Plus.
[Plus] Creare una richiesta	Creare una nuova richiesta di uscita per un membro. Richiede un piano absentify Plus.
[Plus] Eliminare un calendario delle festività pubbliche	Eliminare un calendario festività pubblico dall'area di lavoro. Richiede un piano absentify Plus.
[Plus] Eliminare un membro	Eliminare un membro. Tutti i dati verranno eliminati definitivamente. Richiede un piano absentify Plus.
[Plus] Eliminare un reparto	Eliminare un reparto dall'area di lavoro. Richiede un piano absentify Plus.
[Plus] Eliminare un tipo di uscita	Eliminare un tipo di uscita dall'area di lavoro. Richiede un piano absentify Plus.
[Plus] Eliminare una richiesta	Eliminare una richiesta di uscita in modo permanente. Richiede un piano absentify Plus.
[Plus] Invitare un membro	Invitare un nuovo membro all'area di lavoro. Richiede un piano absentify Plus.
[Plus] Ottenere assenze	Recuperare le assenze per un intervallo di date specifico. Restituisce le richieste di uscita approvate entro il periodo specificato. Richiede un piano absentify Plus.
[Plus] Ottenere il calendario delle festività pubbliche in base all'ID	Recuperare un calendario festività pubblico specifico con tutte le festività. Richiede un piano absentify Plus.
[Plus] Ottenere le impostazioni dell'area di lavoro	Recuperare le impostazioni e la configurazione dell'area di lavoro. Richiede un piano absentify Plus.
[Plus] Ottenere tutte le richieste	Recuperare tutte le richieste di uscita con filtri facoltativi. Richiede un piano absentify Plus.
[Plus] Ottenere tutti i membri	Ottenere tutti i membri con filtri facoltativi per reparti, stato, date di impiego, stato amministratore, processo di approvazione, responsabili approvazione, tipi di indennità, nome, mese di compleanno e tipo di manager. Richiede un piano absentify Plus.
[Plus] Ottenere tutti i reparti	Recuperare tutti i reparti nell'area di lavoro. Richiede un piano absentify Plus.
[Plus] Ottenere tutti i tipi di lasciare	Recuperare tutti i tipi di uscita configurati nell'area di lavoro. Richiede un piano absentify Plus.
[Plus] Ottenere un membro in base all'ID	Recuperare un membro specifico in base al relativo ID univoco. Richiede un piano absentify Plus.
[Plus] Ottenere un membro in base all'ID Microsoft	Recuperare un membro in base all'ID utente Microsoft. Richiede un piano absentify Plus.
[Plus] Ottenere un membro in base all'ID personalizzato	Recuperare un membro in base al relativo ID personalizzato. Richiede un piano absentify Plus.
[Plus] Ottenere un membro tramite posta elettronica	Recuperare un membro in base al proprio indirizzo di posta elettronica. Richiede un piano absentify Plus.
[Plus] Ottenere una richiesta in base all'ID	Recuperare una richiesta di uscita specifica in base al relativo ID univoco. Richiede un piano absentify Plus.
[Plus] Ottieni tutti i calendari delle festività pubbliche	Recuperare tutti i calendari festivi pubblici configurati nell'area di lavoro. Richiede un piano absentify Plus.

[Plus] Aggiornare i responsabili approvazione dei membri

ID operazione:

UpdateMemberApprovers

Aggiornare i responsabili approvazione per un membro specifico. Supporta responsabili dei profili Microsoft, impostazioni del reparto o responsabili approvazione personalizzati. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID membro	id	True	string	Identificatore univoco del membro.
Processo di approvazione	approval_process	True	string	Tipo di processo di approvazione.
ID membro	member_id		string	ID del membro responsabile approvazione.
ID gestione predecessori	predecessor_manager_id		string	ID del gestore predecessore (per l'approvazione lineare).

Restituisce

ID del membro.

response

string

[Plus] Aggiornare l'indennità dei membri

ID operazione:

UpdateMemberAllowance

Aggiornare l'indennità di un membro per un tipo di indennità e un anno specifici. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID membro	id	True	string	Identificatore univoco del membro.
ID tipo di indennità	allowance_type_id	True	string	Identificatore univoco del tipo di indennità.
Anno	year	True	integer	L'anno per l'indennità.
Indennità	allowance	True	number	Importo totale dell'indennità.
Time off per la compensazione	compensatory_time_off	True	number	Time off di compensazione da aggiungere.
Portato avanti	brought_forward		number	Indennità inoltrata dall'anno precedente.
Motivo	reason		string	Motivo dell'aggiornamento dell'indennità.
Sovrascrittura portata avanti	overwrite_brought_forward		boolean	Se sovrascrivere il valore inoltrato.
Imposta come predefinito	set_as_default		boolean	Indica se impostare questo tipo di indennità come predefinito per il membro.
Disabled	disabled		boolean	Indica se disabilitare questo tipo di indennità per il membro.

Restituisce

ID del membro.

response

string

[Plus] Aggiornare un calendario delle festività pubbliche

ID operazione:

UpdatePublicHoliday

Aggiornare un calendario delle festività pubbliche esistente. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID calendario festività pubblica	id	True	string	Identificatore univoco del calendario delle festività pubbliche.
Nome	name		string	Nome del calendario delle festività pubbliche.
Paese	country		string	Codice paese per le festività pubbliche.

Restituisce

ID del calendario delle festività pubbliche aggiornato.

response

string

[Plus] Aggiornare un membro

ID operazione:

UpdateMember

Aggiornare le informazioni di un membro esistente. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID membro	id	True	string	Identificatore univoco del membro.
Amministratore	is_admin		boolean	Indica se il membro deve essere un amministratore.
ID reparto	id		string	ID reparto.
Data di inizio dell'occupazione	employment_start_date		string	Data di inizio dell'occupazione.
Data di fine impiego	employment_end_date		string	Data di fine dell'occupazione.
ID calendario festività pubblica	public_holiday_id		string	ID del calendario delle festività pubbliche da assegnare.
Compleanno	birthday		string	Compleanno del membro.
ID personalizzato	custom_id		string	Identificatore personalizzato per il membro.
stato	status		string	Stato del membro.

Restituisce

ID del membro aggiornato.

response

string

[Plus] Aggiornare un reparto

ID operazione:

UpdateDepartment

Aggiornare un reparto esistente. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID reparto	id	True	string	Identificatore univoco del reparto.
Nome	name		string	Nome del reparto.

Restituisce

ID del reparto aggiornato.

response

string

[Plus] Aggiornare un tipo di uscita

ID operazione:

UpdateLeaveType

Aggiornare un tipo di uscita esistente. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Lasciare l'ID tipo	id	True	string	Identificatore univoco del tipo di uscita.
Nome	name		string	Nome del tipo di uscita.
Lasciare l'unità	leave_unit		string	Unità per questo tipo di uscita.
Colore	color		string	Codice colore per questo tipo di uscita.
Icona	icon		string	Icona per questo tipo di uscita.

Restituisce

ID del tipo di uscita aggiornato.

response

string

[Plus] Aggiornare una richiesta

ID operazione:

UpdateRequest

Aggiornare lo stato di una richiesta di uscita (approvare, rifiutare o annullare). Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID richiesta	id	True	string	Identificatore univoco della richiesta.
stato	status	True	string	Nuovo stato per la richiesta.
Motivo	reason		string	Motivo della modifica dello stato.

Restituisce

ID della richiesta aggiornata.

response

string

[Plus] Aggiungere la pianificazione dei membri

ID operazione:

AddMemberSchedule

Aggiungere una nuova pianificazione di lavoro per un membro. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID membro	id	True	string	Identificatore univoco del membro.
Dal	from		string	Data di inizio per questa pianificazione (AAAA-MM-DD).
Lunedì AM abilitato	monday_am_enabled		boolean	Indica se lunedì mattina è abilitato.
Lunedì PM abilitato	monday_pm_enabled		boolean	Indica se lunedì pomeriggio è abilitato.
Martedì AM abilitato	tuesday_am_enabled		boolean	Indica se martedì mattina è abilitato.
Martedì PM abilitato	tuesday_pm_enabled		boolean	Indica se martedì pomeriggio è abilitato.
Mercoledì AM abilitato	wednesday_am_enabled		boolean	Indica se mercoledì mattina è abilitato.
Mercoledì PM abilitato	wednesday_pm_enabled		boolean	Indica se mercoledì pomeriggio è abilitato.
Giovedì AM abilitato	thursday_am_enabled		boolean	Indica se giovedì mattina è abilitato.
Giovedì PM abilitato	thursday_pm_enabled		boolean	Indica se giovedì pomeriggio è abilitato.
Venerdì AM abilitato	friday_am_enabled		boolean	Indica se venerdì mattina è abilitato.
Venerdì PM abilitato	friday_pm_enabled		boolean	Indica se venerdì pomeriggio è abilitato.
Sabato AM abilitato	saturday_am_enabled		boolean	Indica se sabato mattina è abilitato.
Sabato PM abilitato	saturday_pm_enabled		boolean	Indica se il sabato pomeriggio è abilitato.
Domenica AM abilitato	sunday_am_enabled		boolean	Indica se la domenica mattina è abilitata.
Domenica PM abilitata	sunday_pm_enabled		boolean	Indica se domenica pomeriggio è abilitato.

Restituisce

ID della pianificazione.

response

string

[Plus] Creare un calendario festività pubblico

ID operazione:

CreatePublicHoliday

Creare un nuovo calendario delle festività pubbliche nell'area di lavoro. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome	name	True	string	Nome del calendario delle festività pubbliche.
Paese	country		string	Codice paese per le festività pubbliche.

Restituisce

ID del calendario festività pubblico creato.

response

string

[Plus] Creare un reparto

ID operazione:

CreateDepartment

Creare un nuovo reparto nell'area di lavoro. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome	name	True	string	Nome del reparto.

Restituisce

ID del reparto creato.

response

string

[Plus] Creare un tipo di uscita

ID operazione:

CreateLeaveType

Creare un nuovo tipo di uscita nell'area di lavoro. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome	name	True	string	Nome del tipo di uscita.
Lasciare l'unità	leave_unit		string	Unità per questo tipo di uscita.
Colore	color		string	Codice colore per questo tipo di uscita.
Icona	icon		string	Icona per questo tipo di uscita.

Restituisce

ID del tipo di uscita creato.

response

string

[Plus] Creare una richiesta

ID operazione:

CreateRequest

Creare una nuova richiesta di uscita per un membro. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID membro	member_id	True	string	ID del membro che richiede il congedo.
Lasciare l'ID tipo	leave_type_id	True	string	ID del tipo di uscita.
Data di inizio	start	True	string	Data di inizio dell'uscita (AAAA-MM-DD).
Ora di avvio	start_at		string	Ora del giorno in cui inizia il congedo.
Data di fine	end	True	string	Data di fine del congedo (AAAA-MM-DD).
Ora di fine	end_at		string	Ora del giorno in cui termina il congedo.
Motivo	reason		string	Motivo della richiesta di uscita.

Restituisce

ID della richiesta creata.

response

string

[Plus] Eliminare un calendario delle festività pubbliche

ID operazione:

DeletePublicHoliday

Eliminare un calendario festività pubblico dall'area di lavoro. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID calendario festività pubblica	id	True	string	Identificatore univoco del calendario delle festività pubbliche.

Restituisce

ID del calendario delle festività pubbliche eliminato.

response

string

[Plus] Eliminare un membro

ID operazione:

DeleteMember

Eliminare un membro. Tutti i dati verranno eliminati definitivamente. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID membro	id	True	string	Identificatore univoco del membro.

Restituisce

ID del membro eliminato.

response

string

[Plus] Eliminare un reparto

ID operazione:

DeleteDepartment

Eliminare un reparto dall'area di lavoro. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID reparto	id	True	string	Identificatore univoco del reparto.

Restituisce

ID del reparto eliminato.

response

string

[Plus] Eliminare un tipo di uscita

ID operazione:

DeleteLeaveType

Eliminare un tipo di uscita dall'area di lavoro. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Lasciare l'ID tipo	id	True	string	Identificatore univoco del tipo di uscita.

Restituisce

ID del tipo di uscita eliminato.

response

string

[Plus] Eliminare una richiesta

ID operazione:

DeleteRequest

Eliminare una richiesta di uscita in modo permanente. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID richiesta	id	True	string	Identificatore univoco della richiesta.

Restituisce

ID della richiesta eliminata.

response

string

[Plus] Invitare un membro

ID operazione:

InviteMember

Invitare un nuovo membro all'area di lavoro. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Nome	name	True	string	Nome del membro da invitare.
Email	email		string	Indirizzo di posta elettronica del membro.
ID reparto	id		string	ID reparto.
Data di inizio dell'occupazione	employment_start_date		string	Data di inizio dell'occupazione.
ID calendario festività pubblica	public_holiday_id	True	string	ID del calendario delle festività pubbliche da assegnare.
Compleanno	birthday		string	Compleanno del membro.
ID personalizzato	custom_id		string	Identificatore personalizzato per il membro.

Restituisce

ID del membro invitato.

response

string

[Plus] Ottenere assenze

ID operazione:

GetAbsences

Recuperare le assenze per un intervallo di date specifico. Restituisce le richieste di uscita approvate entro il periodo specificato. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Data di inizio	start	True	date	Data di inizio per la query di assenza (AAAA-MM-DD).
Data di fine	end	True	date	Data di fine per la query di assenza (AAAA-MM-DD).
ID membro	member_id		string	Filtrare in base all'ID membro.
ID reparto	department_id		string	Filtrare in base all'ID reparto.

Restituisce

response

array of Absence

[Plus] Ottenere il calendario delle festività pubbliche in base all'ID

ID operazione:

GetPublicHolidayById

Recuperare un calendario festività pubblico specifico con tutte le festività. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID calendario festività pubblica	id	True	string	Identificatore univoco del calendario delle festività pubbliche.

Restituisce

Calendario delle festività pubbliche dettagliato con le festività.

Dettagli Calendario festività pubblica

PublicHolidayCalendarDetail

[Plus] Ottenere le impostazioni dell'area di lavoro

ID operazione:

GetWorkspace

Recuperare le impostazioni e la configurazione dell'area di lavoro. Richiede un piano absentify Plus.

Restituisce

Impostazioni e configurazione dell'area di lavoro.

Workspace

Workspace

[Plus] Ottenere tutte le richieste

ID operazione:

GetRequests

Recuperare tutte le richieste di uscita con filtri facoltativi. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID membro	member_id		string	Filtrare in base all'ID membro.
stato	status		string	Filtrare in base allo stato della richiesta.
Inizia da	start_from		string	Filtra in base alla data di inizio (da).
Inizia a	start_to		string	Filtra in base alla data di inizio (a).
End From	end_from		string	Filtra in base alla data di fine (da).
End To	end_to		string	Filtra in base alla data di fine (a).
Lasciare l'ID tipo	leave_type_id		string	Filtrare per lasciare l'ID del tipo.
ID reparto	department_id		string	Filtrare in base all'ID reparto.

Restituisce

response

array of Request

[Plus] Ottenere tutti i membri

ID operazione:

GetMembers

Ottenere tutti i membri con filtri facoltativi per reparti, stato, date di impiego, stato amministratore, processo di approvazione, responsabili approvazione, tipi di indennità, nome, mese di compleanno e tipo di manager. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID reparto	department_ids		array	Filtrare in base agli ID del reparto.
stato	status		string	Filtrare in base allo stato del membro.
Inizio occupazione	employment_start_date_from		string	Filtra in base alla data di inizio dell'occupazione (da).
Inizio dell'occupazione	employment_start_date_to		string	Filtra in base alla data di inizio dell'occupazione (a).
Fine dell'occupazione	employment_end_date_from		string	Filtra in base alla data di fine dell'occupazione (da).
Fine dell'occupazione	employment_end_date_to		string	Filtrare in base alla data di fine dell'impiego (a).
Amministratore	is_admin		boolean	Filtrare in base allo stato dell'amministratore.
Processo di approvazione	approval_process		string	Filtrare in base al tipo di processo di approvazione.
Dispone di responsabili approvazione	has_approvers		boolean	Filtrare in base al fatto che il membro disponga di responsabili approvazione.
ID tipo di indennità	allowance_type_id		string	Filtrare in base all'ID del tipo di indennità.
Nome	name		string	Filtrare in base al nome del membro.
Mese di compleanno	birthday_month		integer	Filtra per mese di compleanno (1-12).
Tipo di manager	manager_type		string	Filtrare in base al tipo di gestore.

Restituisce

response

array of Member

[Plus] Ottenere tutti i reparti

ID operazione:

GetDepartments

Recuperare tutti i reparti nell'area di lavoro. Richiede un piano absentify Plus.

Restituisce

response

array of Department

[Plus] Ottenere tutti i tipi di lasciare

ID operazione:

GetLeaveTypes

Recuperare tutti i tipi di uscita configurati nell'area di lavoro. Richiede un piano absentify Plus.

Restituisce

response

array of LeaveType

[Plus] Ottenere un membro in base all'ID

ID operazione:

GetMemberById

Recuperare un membro specifico in base al relativo ID univoco. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID membro	id	True	string	Identificatore univoco del membro.

Restituisce

Informazioni dettagliate sui membri, incluse le pianificazioni.

Dettagli membro

MemberDetail

[Plus] Ottenere un membro in base all'ID Microsoft

ID operazione:

GetMemberByMicrosoftId

Recuperare un membro in base all'ID utente Microsoft. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID utente Microsoft	microsoft_user_id	True	string	ID utente Microsoft.

Restituisce

Informazioni dettagliate sui membri, incluse le pianificazioni.

Dettagli membro

MemberDetail

[Plus] Ottenere un membro in base all'ID personalizzato

ID operazione:

GetMemberByCustomId

Recuperare un membro in base al relativo ID personalizzato. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID personalizzato	custom_id	True	string	ID personalizzato del membro.

Restituisce

Informazioni dettagliate sui membri, incluse le pianificazioni.

Dettagli membro

MemberDetail

[Plus] Ottenere un membro tramite posta elettronica

ID operazione:

GetMemberByEmail

Recuperare un membro in base al proprio indirizzo di posta elettronica. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Email	email	True	string	Indirizzo di posta elettronica del membro.

Restituisce

Informazioni dettagliate sui membri, incluse le pianificazioni.

Dettagli membro

MemberDetail

[Plus] Ottenere una richiesta in base all'ID

ID operazione:

GetRequestById

Recuperare una richiesta di uscita specifica in base al relativo ID univoco. Richiede un piano absentify Plus.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID richiesta	id	True	string	Identificatore univoco della richiesta.

Restituisce

Richiesta di uscita.

Richiesta

Request

[Plus] Ottieni tutti i calendari delle festività pubbliche

ID operazione:

GetPublicHolidays

Recuperare tutti i calendari festivi pubblici configurati nell'area di lavoro. Richiede un piano absentify Plus.

Restituisce

response

array of PublicHolidayCalendar

Trigger

Richiesta creata	Questo trigger viene eseguito quando viene creata una nuova richiesta nell'azienda.
Stato della richiesta aggiornato	Questo trigger viene eseguito se lo stato di una richiesta esistente viene modificato.

Richiesta creata

ID operazione:

TriggerRequestCreated

Questo trigger viene eseguito quando viene creata una nuova richiesta nell'azienda.

Restituisce

Corpo

RequestWebhookPayloadV1

Stato della richiesta aggiornato

ID operazione:

TriggerRequestStatusChanged

Questo trigger viene eseguito se lo stato di una richiesta esistente viene modificato.

Restituisce

Corpo

RequestWebhookPayloadV1

Definizioni

RequestWebhookPayloadV1

Nome	Percorso	Tipo	Descrizione
id	id	string	id
richiesta creata all'indirizzo	createdAt	string	richiesta creata all'indirizzo
richiesta aggiornata all'indirizzo	updatedAt	string	richiesta aggiornata all'indirizzo
Data di inizio della richiesta	start	string	Data di inizio della richiesta
Inizio della richiesta all'inizio	start_at	string	Inizio della richiesta all'inizio
Data di fine della richiesta	end	string	Data di fine della richiesta
Fine della richiesta all'indirizzo	end_at	string	Fine della richiesta all'indirizzo
Durata della richiesta sottratta	duration	float	Durata della richiesta sottratta
Anno richiesta	year	integer	Anno richiesta
Stato della richiesta	details.status	string	Stato della richiesta
Richiesta detratta dall'indennità dell'utente	details.deducted	float	Richiesta detratta dall'indennità dell'utente
Motivo della richiesta	details.reason	string	Motivo della richiesta
Processo di approvazione	details.approval_process	string	Processo di approvazione
Responsabili approvazione della richiesta	details.request_approvers	array of object	Responsabili approvazione della richiesta
uuid interno	details.request_approvers.uuid	string	uuid interno
stato	details.request_approvers.status	string	stato
Modifica tramite posta elettronica	details.request_approvers.status_changed_by_member.email	string	Modifica tramite posta elettronica
Modifica in base al nome	details.request_approvers.status_changed_by_member.name	string	Modifica in base al nome
Modifica in base all'ID	details.request_approvers.status_changed_by_member.id	string	Modifica in base all'ID
Modificato dall'ID personalizzato	details.request_approvers.status_changed_by_member.custom_id	string	Modificato dall'ID personalizzato
Data di modifica dello stato	details.request_approvers.status_change_date	date-time	Data di modifica dello stato
ID responsabile approvazione del membro della richiesta predecessore	details.request_approvers.predecessor_request_member_approver_id	string	Esiste un predecessore che deve approvare in precedenza?
Motivo	details.request_approvers.reason	string	Motivo
Indirizzo di posta elettronica del richiedente richiesta	details.requester_member.email	string	Indirizzo di posta elettronica del richiedente richiesta
Nome richiedente richiesta	details.requester_member.name	string	Nome richiedente richiesta
ID richiedente richiesta	details.requester_member.id	string	ID richiedente richiesta
ID personalizzato del richiedente richiesta	details.requester_member.custom_id	string	ID personalizzato del richiedente richiesta
Indennità	details.requester_member.allowances	array of object	Indennità
Indennità	details.requester_member.allowances.allowance	number	Indennità
Trasportato	details.requester_member.allowances.brought_forward	number	Trasportato
Time off per la compensazione	details.requester_member.allowances.compensatory_time_off	number	Time off per la compensazione
Rimanente	details.requester_member.allowances.remaining	number	Rimanente
Preso	details.requester_member.allowances.taken	number	Preso
Anno	details.requester_member.allowances.year	number	Anno
Data di approvazione della richiesta (deprecata)	details.approved_date	string	Data di approvazione della richiesta (deprecata)
Richiedi motivo di annullamento	details.cancel_reason	string	Richiedi motivo di annullamento
Data di annullamento della richiesta	details.canceld_date	string	Data di annullamento della richiesta
Data richiesta rifiutata (deprecata)	details.declined_date	string	Data richiesta rifiutata (deprecata)
Motivo rifiuto richiesta (deprecato)	details.decline_reason	string	Motivo rifiuto richiesta (deprecato)
Messaggio di posta elettronica del responsabile approvazione richiesta (deprecato)	details.approver_member.email	string	Messaggio di posta elettronica del responsabile approvazione richiesta (deprecato)
Nome del responsabile approvazione della richiesta (deprecato)	details.approver_member.name	string	Nome del responsabile approvazione della richiesta (deprecato)
ID responsabile approvazione richiesta (deprecato)	details.approver_member.id	string	ID responsabile approvazione richiesta (deprecato)
ID personalizzato del responsabile approvazione della richiesta (deprecato)	details.approver_member.custom_id	string	ID personalizzato del responsabile approvazione della richiesta (deprecato)
Richiesta annullata tramite posta elettronica	details.canceld_by_member.email	string	Richiesta annullata tramite posta elettronica
Richiesta annullata per nome	details.canceld_by_member.name	string	Richiesta annullata per nome
Richiesta annullata per ID	details.canceld_by_member.id	string	Richiesta annullata per ID
Richiesta annullata dall'ID personalizzato	details.canceld_by_member.custom_id	string	Richiesta annullata dall'ID personalizzato
Richiesta rifiutata tramite posta elettronica (deprecata)	details.declined_by_member.email	string	Richiesta rifiutata tramite posta elettronica (deprecata)
Richiesta rifiutata per nome (deprecata)	details.declined_by_member.name	string	Richiesta rifiutata per nome (deprecata)
Richiesta rifiutata per ID (deprecato)	details.declined_by_member.id	string	Richiesta rifiutata per ID (deprecato)
Richiesta rifiutata dall'ID personalizzato (deprecato)	details.declined_by_member.custom_id	string	Richiesta rifiutata dall'ID personalizzato (deprecato)
Lasciare l'ID tipo	details.leave_type.id	string	Lasciare l'ID tipo
Lasciare il nome del tipo	details.leave_type.name	string	Lasciare il nome del tipo

MemberReference

Riferimento a un membro.

Nome	Percorso	Tipo	Descrizione
ID membro	id	string	Identificatore univoco del membro.
ID personalizzato	custom_id	string	Identificatore personalizzato per il membro.
Nome	name	string	Nome del membro.
Email	email	string	Indirizzo di posta elettronica del membro.

LeaveTypeV2

Informazioni sul tipo di uscita.

Nome	Percorso	Tipo	Descrizione
Lasciare l'ID tipo	id	string	Identificatore univoco del tipo di uscita.
Lasciare il nome del tipo	name	string	Nome del tipo di uscita.
Lasciare l'unità	leave_unit	string	Unità del tipo di uscita.

AllowanceTypeV2

Informazioni sul tipo di indennità.

Nome	Percorso	Tipo	Descrizione
ID tipo di indennità	id	string	Identificatore univoco del tipo di indennità.
Nome tipo di indennità	name	string	Nome del tipo di indennità.
Ignora limite	ignore_allowance_limit	boolean	Indica se il limite di indennità deve essere ignorato.
Unità di indennità	allowance_unit	string	Unità dell'indennità.

RequestApproverV2

Informazioni su un responsabile approvazione della richiesta.

Nome	Percorso	Tipo	Descrizione
Stato approvazione	status	string	Stato di approvazione corrente.
Motivo del responsabile approvazione	reason	string	Motivo fornito dal responsabile approvazione.
Data modifica stato	status_changed_date	string	Data di modifica dello stato di approvazione.
Membro	status_changed_by_member	MemberReference	Riferimento a un membro.
Membro	approver_member	MemberReference	Riferimento a un membro.

Membro

Membro nell'area di lavoro.

Nome	Percorso	Tipo	Descrizione
ID membro	id	string	Identificatore univoco del membro.
ID personalizzato	custom_id	string	Identificatore personalizzato per il membro.
Nome	name	string	Nome del membro.
Email	email	string	Indirizzo di posta elettronica del membro.
Creato all'indirizzo	createdAt	string	Timestamp al momento della creazione del membro.
Aggiornato all'indirizzo	updatedAt	string	Timestamp dell'ultimo aggiornamento del membro.
stato	status	string	Stato corrente del membro.
Compleanno	birthday	string	Compleanno del membro.
Data di inizio dell'occupazione	employment_start_date	string	Data di inizio dell'occupazione del membro.
Data di fine impiego	employment_end_date	string	Data di fine dell'occupazione del membro.
Amministratore	is_admin	boolean	Indica se il membro è un amministratore.
Processo di approvazione	approval_process	string	Tipo di processo di approvazione per questo membro.
Departments	departments	array of MemberDepartment	Reparti a cui appartiene il membro.
Indennità	allowances	array of MemberAllowance	Indennità per il membro.

MemberDetail

Informazioni dettagliate sui membri, incluse le pianificazioni.

Nome	Percorso	Tipo	Descrizione
ID membro	id	string	Identificatore univoco del membro.
ID personalizzato	custom_id	string	Identificatore personalizzato per il membro.
Nome	name	string	Nome del membro.
Email	email	string	Indirizzo di posta elettronica del membro.
Creato all'indirizzo	createdAt	string	Timestamp al momento della creazione del membro.
Aggiornato all'indirizzo	updatedAt	string	Timestamp dell'ultimo aggiornamento del membro.
stato	status	string	Stato corrente del membro.
Compleanno	birthday	string	Compleanno del membro.
Data di inizio dell'occupazione	employment_start_date	string	Data di inizio dell'occupazione del membro.
Data di fine impiego	employment_end_date	string	Data di fine dell'occupazione del membro.
Amministratore	is_admin	boolean	Indica se il membro è un amministratore.
Processo di approvazione	approval_process	string	Tipo di processo di approvazione per questo membro.
Departments	departments	array of MemberDepartment	Reparti a cui appartiene il membro.
Indennità	allowances	array of MemberAllowance	Indennità per il membro.
Responsabili dell'approvazione	has_approvers	array of ApproverInfo	Elenco di responsabili approvazione per questo membro.
Schedules	schedules	array of Schedule	Pianificazioni di lavoro per il membro.

MemberDepartment

Assegnazione di reparto per un membro.

Nome	Percorso	Tipo	Descrizione
ID reparto	id	string	Identificatore univoco del reparto.
Nome reparto	name	string	Nome del reparto.
Tipo di manager	manager_type	string	Ruolo del membro del reparto.

MemberAllowance

Informazioni sull'indennità per un membro.

Nome	Percorso	Tipo	Descrizione
ID indennità	id	string	Identificatore univoco del record di quote.
Anno	year	integer	Anno per questa indennità.
Indennità	allowance	number	Importo totale dell'indennità.
Preso	taken	number	Quantità di indennità già presa.
Rimanente	remaining	number	Importo rimanente dell'indennità.
Portato avanti	brought_forward	number	Indennità inoltrata dall'anno precedente.
Time off per la compensazione	compensatory_time_off	number	Time off di compensazione aggiunto.
Tipo di indennità	allowance_type	AllowanceTypeV2	Informazioni sul tipo di indennità.

ApproverInfo

Informazioni su un responsabile approvazione.

Nome	Percorso	Tipo	Descrizione
Membro	member	MemberReference	Riferimento a un membro.

Calendario

Pianificazione del lavoro per un membro.

Nome	Percorso	Tipo	Descrizione
ID pianificazione	id	string	Identificatore univoco della pianificazione.
Dal	from	string	Data di inizio di questa pianificazione.
Creato all'indirizzo	createdAt	string	Timestamp al momento della creazione della pianificazione.
Aggiornato all'indirizzo	updatedAt	string	Timestamp dell'ultimo aggiornamento della pianificazione.

Reparto

Reparto nell'area di lavoro.

Nome	Percorso	Tipo	Descrizione
ID reparto	id	string	Identificatore univoco del reparto.
Nome	name	string	Nome del reparto.
Creato all'indirizzo	createdAt	string	Timestamp al momento della creazione del reparto.
Aggiornato all'indirizzo	updatedAt	string	Timestamp dell'ultimo aggiornamento del reparto.

LeaveType

Tipo di uscita nell'area di lavoro.

Nome	Percorso	Tipo	Descrizione
Lasciare l'ID tipo	id	string	Identificatore univoco del tipo di uscita.
Nome	name	string	Nome del tipo di uscita.
Lasciare l'unità	leave_unit	string	Unità per questo tipo di uscita.
Colore	color	string	Codice colore per questo tipo di uscita.
Icona	icon	string	Icona per questo tipo di uscita.
Creato all'indirizzo	createdAt	string	Timestamp al momento della creazione del tipo di uscita.
Aggiornato all'indirizzo	updatedAt	string	Timestamp dell'ultimo aggiornamento del tipo di uscita.

Richiesta

Richiesta di uscita.

Nome	Percorso	Tipo	Descrizione
ID richiesta	id	string	Identificatore univoco della richiesta.
Creato all'indirizzo	createdAt	string	Timestamp al momento della creazione della richiesta.
Aggiornato all'indirizzo	updatedAt	string	Timestamp dell'ultimo aggiornamento della richiesta.
Data di inizio	start	string	Data di inizio della richiesta.
Ora di avvio	start_at	string	Ora del giorno in cui inizia il congedo.
Data di fine	end	string	Data di fine della richiesta.
Ora di fine	end_at	string	Ora del giorno in cui termina il congedo.
stato	status	string	Stato corrente della richiesta.
Motivo	reason	string	Motivo della richiesta di uscita.
Durata	duration	number	Durata del congedo.
Durata del giorno lavorativo	workday_absence_duration	number	Durata nei giorni lavorativi.
Lasciare l'unità	leave_unit	string	Unità per questa uscita.
Membro	requester_member	MemberReference	Riferimento a un membro.
Tipo di congedo	leave_type	LeaveTypeV2	Informazioni sul tipo di uscita.
Responsabili dell'approvazione	request_approvers	array of RequestApproverV2	Elenco di responsabili approvazione per questa richiesta.

PublicHolidayCalendar

Calendario delle festività pubbliche.

Nome	Percorso	Tipo	Descrizione
ID calendario	id	string	Identificatore univoco del calendario.
Nome	name	string	Nome del calendario delle festività pubbliche.
Paese	country	string	Paese per le festività pubbliche.
Creato all'indirizzo	createdAt	string	Timestamp al momento della creazione del calendario.
Aggiornato all'indirizzo	updatedAt	string	Timestamp dell'ultimo aggiornamento del calendario.

PublicHolidayCalendarDetail

Calendario delle festività pubbliche dettagliato con le festività.

Nome	Percorso	Tipo	Descrizione
ID calendario	id	string	Identificatore univoco del calendario.
Nome	name	string	Nome del calendario delle festività pubbliche.
Paese	country	string	Paese per le festività pubbliche.
Vacanze	holidays	array of PublicHoliday	Elenco delle festività in questo calendario.

PublicHoliday

Una festa pubblica.

Nome	Percorso	Tipo	Descrizione
ID festività	id	string	Identificatore univoco della festività.
Nome	name	string	Nome della vacanza.
Date	date	string	Data della festività.
Durata	duration	number	Durata della vacanza (0,5 per mezza giornata, 1 per giorno intero).

Workspace

Impostazioni e configurazione dell'area di lavoro.

Nome	Percorso	Tipo	Descrizione
ID area di lavoro	id	string	Identificatore univoco dell'area di lavoro.
Nome	name	string	Nome dell'area di lavoro.
Creato all'indirizzo	createdAt	string	Timestamp al momento della creazione dell'area di lavoro.
Aggiornato all'indirizzo	updatedAt	string	Timestamp dell'ultimo aggiornamento dell'area di lavoro.

Assenze

Voce di assenza.

Nome	Percorso	Tipo	Descrizione
ID assenza	id	string	Identificatore univoco dell'assenza.
Date	date	string	Data dell'assenza.
Durata	duration	number	Durata dell'assenza.
Membro	member	MemberReference	Riferimento a un membro.
Tipo di congedo	leave_type	LeaveTypeV2	Informazioni sul tipo di uscita.
ID richiesta	request_id	string	ID della richiesta di uscita associata.

corda

Si tratta del tipo di dati di base 'string'.