Cos'è l'API di Sesame e a cosa serve?
L'API di Sesame è uno strumento per facilitare l'integrazione con altri software della nostra piattaforma. Questa capacità è fondamentale per le aziende che lavorano con ecosistemi tecnologici complessi e che hanno bisogno che i dati HR scorrano in modo automatico e sicuro tra sistemi.
Se lavori con diversi strumenti per gestire i tuoi processi delle risorse umane, buste paga, controllo presenze o Business Intelligence, l'API di Sesame ti permette di connettere tutto in modo programmato e senza modifiche manuali.
Quali risorse puoi gestire con l'API?
L'API ti da la possibilità di accedere e manipolare le principali risorse della piattaforma in modo programmatico. Di seguito vedremo i dettagli di tutte le aree disponibili:
|
Risorse |
Cosa puoi fare |
👤 |
Dipendenti |
Crea, aggiorna, elimina e consulta le schede dei dipendenti. Gestisci profili, assegna responsabili, dipartimenti e uffici da sistemi esterni come ERP o piattaforme di onboarding. |
📄 |
Contratti |
Gestisci i contratti dei dipendenti con i relativi tipi, allegati e cessazioni. Consulta i contratti attivi, i dati del payroll e i livelli di inquadramento. |
💰 |
Salari e compensi |
Amministra gli stipendi base, le compensazioni fisse e variabili mensili. Gestisci i gruppi di contribuzione per l'integrazione con i sistemi di busta paga. |
⏰ |
Controllo orario |
Registra le timbrature con clock-in/clock-out, gestisci le pause (work break), valida i registri e gestisci le anomalie di timbratura. |
🏖️ |
Assenze e ferie |
Crea e gestisci le richieste di ferie e assenze, configura i calendari delle ferie e i festivi, approva o rifiuta le richieste. |
📁 |
Documenti |
Elenca le cartelle documenti dell'azienda, carica documenti associati ai dipendenti e scarica file in modo automatizzato. |
🏢 |
Struttura organizzativa |
Consulta e aggiorna dipartimenti, uffici, gruppi di entità, ruoli e assegnazioni dei dipendenti a ciascuna unità. |
💼 |
Selezione |
Crea e gestisci candidati, carica documenti dei candidati e consulta lo stato delle candidature per offerta di lavoro. |
📊 |
Progetti e tempo |
Gestisci progetti, clienti e attività pianificate. Registra il tempo per ogni progetto con start/stop. |
🎓 |
Formazione |
Crea percorsi di formazione, assegna dipendenti e monitora lo stato di completamento di ciascuna formazione.
|
💸 |
Spese |
Consulta le spese aziendali, le categorie di spesa e i metodi di pagamento configurati. |
🔄 |
Turni e pianificazione |
Gestisci turni, modelli di orario, pianificatori e assegnazioni di turno ai dipendenti. |
📋 |
Sondaggi |
Consulta le valutazioni aziendali e rispondi alle valutazioni di selezione dei candidati. |
🔧 |
Campi personalizzati |
Crea, aggiorna ed elimina campi personalizzati per adattare i dati dei dipendenti alle esigenze di ciascuna organizzazione. |
📨 |
Richieste |
Consulta le richieste personalizzate e le relative tipologie, accedi ai documenti allegati a ciascuna richiesta. |
📈 |
Statistiche |
Accedi ai dati statistici del controllo orario e della banca ore per la generazione di report. |
Quali vantaggi prevede l'utilizzo dell'API?
Con l'Add On API potrai sincronizzare automaticamente i dati tra Sesame e altre piattaforme, permettendoti di:
- Ridurre le attività manuali e gli errori di duplicazione sincronizzando in automatico dipendenti, contratti e dati salariali.
- Centralizzare le informazioni dei tuoi dipendenti, rendendo Sesame l'unica fonte di verità collegata a tutti i tuoi sistemi.
- Automatizzare i processi operativi come timbrature, assenze, gestione dei contratti o l'imputazione delle ore per progetto.
- Alimentare la tua Business Intelligence esportando dati HR verso strumenti come Power BI o Tableau.
Casi d'uso
Ecco alcune delle integrazioni più comuni che i nostri clienti realizzano con l'API di Sesame HR:
Sincronizzazione ERP ↔ Sesame
Sincronizza automaticamente assunzioni, dimissioni e modifiche contrattuali tra il tuo ERP aziendale (SAP, Oracle, Microsoft Dynamics, ecc.) e Sesame HR. Quando un dipendente viene registrato nell'ERP, viene creato automaticamente in Sesame con tutti i suoi dati.
Integrazione con la busta paga
Trasferisci automaticamente i dati salariali completi (stipendio base, compensazioni, variabili mensili e gruppi di contribuzione) verso il tuo software di busta paga, eliminando l'inserimento manuale dei dati mese dopo mese.
Controllo degli accessi fisici
Collega i sistemi di controllo degli accessi fisici (tornelli, lettori di badge, terminali biometrici) con Sesame HR per registrare le timbrature in tempo reale tramite gli endpoint di clock-in e clock-out.
Esportazione verso Business Intelligence
Estrai dati HR (statistiche delle timbrature, assenze, ore per progetto, turnover) verso strumenti di BI come Power BI, Tableau o Looker per generare dashboard esecutive.
Imputazione delle ore per progetto
Collega strumenti di gestione dei progetti con gli endpoint di Time Entries per registrare automaticamente le ore dedicate a ciascun progetto e cliente.
Automatizzazione della selezione
Integra piattaforme ATS esterne con Sesame per sincronizzare candidati, documenti e stati del processo di selezione in modo automatico.
Dettagli tecnici dell'API di Sesame
Autenticazione
L'API utilizza l'autenticazione Bearer Token. Devi includere il tuo token nell'header
Authorization: Bearer {il_tuo_token_qui} |
Puoi ottenere e gestire il tuo token da Configurazione > Integrazioni > API all'interno del tuo pannello di Sesame HR.
URL base y server regionali
L'API dispone di server regionali per garantire la residenza dei dati. La URL base segue il formato:
https://api-{region}.sesametime.com |
Dove {region} corrisponde all'ID della tua regione (ad esempio, eu1 per Europa).
Specifiche e versionamento
L'API segue la specifica OpenAPI 3.0 (OAS 3.0) ed è documentata in formato Swagger, il che ne facilita l'integrazione con qualsiasi linguaggio di programmazione, piattaforma tecnologica o strumento di generazione di codice.
Documentazione interattiva
Puoi esplorare tutti gli endpoint, testare le richieste e consultare gli schemi di dati nella nostra documentazione Swagger su: apidocs.sesametime.com
🚀 L'API di Sesame è disponibile come Add On. Se non l'hai ancora attivato, contatta il tuo Account Manager o scrivici tramite la chat di supporto. |