Vai al contenuto

HR e personale – costruisci su Flowtly

Usa questo snapshot curato dello schema OpenAPI di Flowtly per pianificare integrazioni, automatizzare workflow e sincronizzare i dati su cui i tuoi team fanno affidamento.

Stato della documentazione

Ultima sincronizzazione il 2026-04-03 18:31 (versione app 2.0.0)

Solo un sottoinsieme di entità è reso pubblico. Esegui entrambi i comandi di sincronizzazione per aggiornare questa documentazione quando l'app Flowtly introduce nuove funzionalità.

HR e personale

Profili dipendenti, reparti, posizioni, benefit e struttura organizzativa.

Panoramica entità

Dipendente

Crea e gestisci dipendenti per assegnazioni, approvazioni e controllo degli accessi.

Endpoint

GET https://api.flowtly.eu/employees

Elenca dipendenti

Recupera la raccolta di risorse Employee.

POST https://api.flowtly.eu/employees

Crea dipendente

Crea una risorsa Employee.

GET https://api.flowtly.eu/employees/me

Elenca me

Recupera la raccolta di risorse Employee.

GET https://api.flowtly.eu/employees/preview

Elenca anteprima

Recupera la raccolta di risorse Employee.

GET https://api.flowtly.eu/employees/search

Elenca ricerca

Recupera la raccolta di risorse Employee.

GET https://api.flowtly.eu/employees/{id}

Ottieni dipendente per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/employees/{id}

Elimina dipendente

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/employees/{id}

Aggiorna dipendente

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/employees/{id}/documents

Ottieni dipendente per ID

Recupera una singola risorsa tramite il suo identificatore.

GET https://api.flowtly.eu/employees/{id}/feedback-suggestion

Ottieni dipendente per ID

Recupera una singola risorsa tramite il suo identificatore.

GET https://api.flowtly.eu/employees/{id}/project-rates

Ottieni dipendente per ID

Recupera una singola risorsa tramite il suo identificatore.

POST https://api.flowtly.eu/employees/{id}/user

Crea una risorsa Employee.

Crea una risorsa Employee.

DELETE https://api.flowtly.eu/employees/{id}/user

Elimina dipendente

Rimuovi la risorsa.

GET https://api.flowtly.eu/employees/{id}/working-hours-stats/{date}

Ottieni dipendente per ID

Recupera una singola risorsa tramite il suo identificatore.

Casi d'uso

Esegui il provisioning delle nuove assunzioni dal tuo HRIS affinché compaiano in Flowtly fin dal primo giorno.
Sincronizza le modifiche all'organigramma per mantenere aggiornate le assegnazioni di progetto e le catene di approvazione.

Campi dello schema

Employee-employee.read_employee.detail
Campo Tipo Descrizione
id integer Campo id.
userId integer Campo userId.
companyEmail string Campo companyEmail.
contactEmail string Campo contactEmail.
contactPhone string Campo contactPhone.
birthday string Campo birthday.
firstname string Campo firstname.
lastname string Campo lastname.
roles array Campo roles.
phoneTextAllowed boolean Campo phoneTextAllowed.
department string Campo department.
reportsTo string Campo reportsTo.
directReports array Campo directReports.
departments array Campo departments.
activeAgreement string Campo activeAgreement.

Panoramica entità

Reparto

Gestisci la gerarchia dei reparti per gestire il controllo degli accessi, l'allocazione del budget e il reporting sulle risorse umane.

Endpoint

GET https://api.flowtly.eu/departments

Elenca reparti

Recupera la raccolta di risorse Department.

POST https://api.flowtly.eu/departments

Crea reparto

Crea una risorsa Department.

GET https://api.flowtly.eu/departments/{id}

Ottieni reparto per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/departments/{id}

Aggiorna reparto

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Rispecchia l'organigramma per reparti del tuo HRIS in Flowtly per un reporting organizzativo unificato.
Crea reparti per segmentare i dashboard di budget e utilizzo.

Campi dello schema

Department-department.read_employee.preview
Campo Tipo Descrizione
id integer Campo id.
name string Campo name.
code string | null Campo code.
manager object Campo manager.

Panoramica entità

Posizione

Definisci posizioni standardizzate per gestire l'assegnazione basata sui ruoli, i template contrattuali e la pianificazione dell'organico.

Endpoint

GET https://api.flowtly.eu/positions

Elenca posizioni

Recupera la raccolta di risorse Position.

POST https://api.flowtly.eu/positions

Crea posizione

Crea una risorsa Position.

GET https://api.flowtly.eu/positions/{id}

Ottieni posizione per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/positions/{id}

Elimina posizione

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/positions/{id}

Aggiorna posizione

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Sincronizza le posizioni aperte dal tuo ATS per monitorare la pipeline di assunzione in Flowtly.
Mappa le posizioni ai costi per i calcoli automatizzati della redditività dei progetti.

Campi dello schema

Position-position.read_responsibility.read
Campo Tipo Descrizione
id string Campo id.
name string Campo name.
roles array Campo roles.
responsibilities object Campo responsibilities.

Panoramica entità

Benefit

Gestisci il catalogo benefit, i prezzi e l'iscrizione per dipendente per mantenere sincronizzati i dati retributivi HR.

Endpoint

GET https://api.flowtly.eu/benefits

Elenca benefit

Recupera la raccolta di risorse EmployeeBenefit.

POST https://api.flowtly.eu/benefits

Crea benefit

Crea una risorsa EmployeeBenefit.

GET https://api.flowtly.eu/benefits/{id}

Ottieni benefit per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/benefits/{id}

Aggiorna benefit

Aggiorna i campi della risorsa tramite JSON Merge Patch.

POST https://api.flowtly.eu/benefit-prices

Crea benefit

Crea una risorsa EmployeeBenefit.

GET https://api.flowtly.eu/benefit-prices/{id}

Ottieni benefit per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/benefit-prices/{id}

Elimina benefit

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/benefit-prices/{id}

Aggiorna benefit

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/employee-benefits

Elenca benefit

Recupera la raccolta di risorse EmployeeBenefit.

POST https://api.flowtly.eu/employee-benefits

Crea benefit

Crea una risorsa EmployeeBenefit.

GET https://api.flowtly.eu/employee-benefits/{id}

Ottieni benefit per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/employee-benefits/{id}

Aggiorna benefit

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Importa i piani benefit dal tuo broker e iscriviti automaticamente ai dipendenti idonei.
Tieni traccia dei costi dei benefit per dipendente per il reporting sulla retribuzione totale.

Campi dello schema

BenefitPrice-benefit.read_benefit_price.read
Campo Tipo Descrizione
id integer Campo id.
validFrom string Campo validFrom.
validTo string | null Campo validTo.
price number Campo price.
taxPercent number Campo taxPercent.
defaultCompanyCoverageAmount number Campo defaultCompanyCoverageAmount.

Panoramica entità

Nota dipendente

Archivia e recupera note HR per valutazioni delle performance, stato di onboarding e memo interni.

Endpoint

GET https://api.flowtly.eu/employee-notes

Elenca note dipendente

Recupera la raccolta di risorse EmployeeNote.

POST https://api.flowtly.eu/employee-notes

Crea nota dipendente

Crea una risorsa EmployeeNote.

GET https://api.flowtly.eu/employee-notes/{id}

Ottieni nota dipendente per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/employee-notes/{id}

Elimina nota dipendente

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/employee-notes/{id}

Aggiorna nota dipendente

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Invia i feedback dei manager dal tuo strumento 1:1 nei record dipendente di Flowtly.
Allega note di conformità o background check ai profili dei dipendenti.

Campi dello schema

EmployeeNote-employee_note.read
Campo Tipo Descrizione
id string Campo id.
employee string Campo employee.
author string Campo author.
note string Campo note.
createdAt string Campo createdAt.

Panoramica entità

Salute e sicurezza dipendente

Tieni traccia delle certificazioni di formazione OHS (BHP) obbligatorie, delle date di scadenza e dello stato di conformità.

Endpoint

GET https://api.flowtly.eu/employee-bhps

Elenca salute e sicurezza dipendenti

Recupera la raccolta di risorse EmployeeBhp.

POST https://api.flowtly.eu/employee-bhps

Crea salute e sicurezza dipendente

Crea una risorsa EmployeeBhp.

GET https://api.flowtly.eu/employee-bhps/{id}

Ottieni salute e sicurezza dipendente per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/employee-bhps/{id}

Aggiorna salute e sicurezza dipendente

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Sincronizza il completamento delle formazioni sulla sicurezza dal tuo LMS in Flowtly.
Avvisa i manager quando la certificazione OHS di un dipendente sta per scadere.

Campi dello schema

EmployeeBhp-employee_bhp.read
Campo Tipo Descrizione
id integer Campo id.
employee string | null Campo employee.
dateFrom string Campo dateFrom.
dateTo string | null Campo dateTo.
note string | null Campo note.

Panoramica entità

Responsabilità

Definisci le responsabilità, raggruppale e assegnale a dipendenti o posizioni per una responsabilizzazione strutturata.

Endpoint

GET https://api.flowtly.eu/position-responsibilities

Elenca responsabilità

Recupera la raccolta di risorse ResponsibilityGroup.

POST https://api.flowtly.eu/position-responsibilities

Crea responsabilità

Crea una risorsa ResponsibilityGroup.

GET https://api.flowtly.eu/position-responsibilities/{id}

Ottieni responsabilità per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/position-responsibilities/{id}

Elimina responsabilità

Rimuovi la risorsa.

GET https://api.flowtly.eu/responsibilities

Elenca responsabilità

Recupera la raccolta di risorse ResponsibilityGroup.

POST https://api.flowtly.eu/responsibilities

Crea responsabilità

Crea una risorsa ResponsibilityGroup.

GET https://api.flowtly.eu/responsibilities/{id}

Ottieni responsabilità per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/responsibilities/{id}

Aggiorna responsabilità

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/responsibility-employees

Elenca responsabilità

Recupera la raccolta di risorse ResponsibilityGroup.

POST https://api.flowtly.eu/responsibility-employees

Crea responsabilità

Crea una risorsa ResponsibilityGroup.

GET https://api.flowtly.eu/responsibility-employees/{id}

Ottieni responsabilità per ID

Recupera una singola risorsa tramite il suo identificatore.

DELETE https://api.flowtly.eu/responsibility-employees/{id}

Elimina responsabilità

Rimuovi la risorsa.

PATCH https://api.flowtly.eu/responsibility-employees/{id}

Aggiorna responsabilità

Aggiorna i campi della risorsa tramite JSON Merge Patch.

GET https://api.flowtly.eu/responsibility-groups

Elenca responsabilità

Recupera la raccolta di risorse ResponsibilityGroup.

POST https://api.flowtly.eu/responsibility-groups

Crea responsabilità

Crea una risorsa ResponsibilityGroup.

GET https://api.flowtly.eu/responsibility-groups/{id}

Ottieni responsabilità per ID

Recupera una singola risorsa tramite il suo identificatore.

PATCH https://api.flowtly.eu/responsibility-groups/{id}

Aggiorna responsabilità

Aggiorna i campi della risorsa tramite JSON Merge Patch.

Casi d'uso

Mappa i doveri di conformità ai ruoli affinché gli strumenti di audit possano verificarne la copertura.
Costruisci una matrice RACI sincronizzando le responsabilità con il tuo strumento di project management.

Campi dello schema

Responsibility-responsibility.read_responsibility_employee.read
Campo Tipo Descrizione
id integer Campo id.
parent object Campo parent.
responsibilityGroup string Campo responsibilityGroup.
name string Campo name.
description string Campo description.
children array Campo children.
responsibilityEmployees array Campo responsibilityEmployees.

Panoramica entità

Feedback

Raccogli, gestisci e interroga il feedback tra pari e dei manager per i cicli di valutazione delle performance.

Endpoint

GET https://api.flowtly.eu/feedback

Elenca feedback

Recupera la raccolta di risorse FeedbackRequest.

POST https://api.flowtly.eu/feedback

Crea feedback

Crea una risorsa FeedbackRequest.

GET https://api.flowtly.eu/feedback/{id}

Ottieni feedback per ID

Recupera una singola risorsa tramite il suo identificatore.

GET https://api.flowtly.eu/feedback-requests

Elenca feedback

Recupera la raccolta di risorse FeedbackRequest.

POST https://api.flowtly.eu/feedback-requests

Crea feedback

Crea una risorsa FeedbackRequest.

GET https://api.flowtly.eu/feedback-requests/{id}

Ottieni feedback per ID

Recupera una singola risorsa tramite il suo identificatore.

Casi d'uso

Attiva le richieste di feedback dalla tua piattaforma di gestione delle performance.
Recupera i punteggi di feedback aggregati nei dashboard dei talenti.

Campi dello schema

Feedback-feedback.read
Campo Tipo Descrizione
id string Campo id.
employee string | null Campo employee.
authorEmployee string | null Campo authorEmployee.
description string Campo description.
details string | null Campo details.
visibility string Campo visibility.
rate string Campo rate.
createdAt string Campo createdAt.

Panoramica entità

Utente organizzazione

Gestisci chi ha accesso all'area di lavoro Flowtly, invia inviti e rimuovi utenti.

Endpoint

GET https://api.flowtly.eu/organization-users

Elenca utenti organizzazione

Recupera la raccolta di risorse OrganizationUserInvitation.

DELETE https://api.flowtly.eu/organization-users/{id}

Elimina utente organizzazione

Rimuovi la risorsa.

GET https://api.flowtly.eu/organization-user-invitations

Elenca utenti organizzazione

Recupera la raccolta di risorse OrganizationUserInvitation.

POST https://api.flowtly.eu/organization-user-invitations/{id}/accept

Crea una risorsa OrganizationUserInvitation.

Crea una risorsa OrganizationUserInvitation.

POST https://api.flowtly.eu/organization-user-invitations/{id}/reject

Crea una risorsa OrganizationUserInvitation.

Crea una risorsa OrganizationUserInvitation.

Casi d'uso

Invita automaticamente le nuove assunzioni quando vengono registrate nel tuo identity provider.
Revoca l'accesso quando i dipendenti vengono disattivati nel tuo HRIS.

Campi dello schema

OrganizationUser-organization_user.read_user.read
Campo Tipo Descrizione
id string Campo id.
user object Campo user.
type string Campo type.
Whatsapp