Come faccio a connettere il tuo ERP con Sesame tramite API REST
L'integrazione tra un ERP aziendale e una piattaforma HR è uno dei progetti di digitalizzazione più frequenti nelle aziende enterprise. Sesame HR facilita questa integrazione grazie alla sua API REST documentata secondo la specifica OpenAPI 3.0, che permette di sincronizzare dati dei dipendenti, strutture organizzative ed eventi HR in modo automatizzato.
Mantenere i dati sincronizzati tra l'ERP e Sesame HR elimina la duplicazione delle informazioni, riduce gli errori di inserimento manuale e permette ai team IT, finance e HR di lavorare con un'unica fonte di verità.
Processo di integrazione
💡 Prima di iniziare, assicurati di avere attivato l'Add On API nel tuo account Sesame HR e di disporre del tuo token di autenticazione. |
1. Autenticazione
L'API di Sesame HR utilizza l'autenticazione tramite Bearer Token. L'amministratore può generare e gestire i token dal pannello di amministrazione, in Impostazioni > Integrazioni > API. Ogni richiesta all'API deve includere il token nell'header di autorizzazione.
|
GET /core/v3/employees Host: api-eu1.sesametime.com Authorization: Bearer {il_tuo_token} Accept: application/json |
2. Mappatura delle entità
Prima di avviare la sincronizzazione, è necessario mappare le entità dell'ERP con quelle di Sesame HR. Le risorse principali da mappare sono:
Entità ERP |
Risorsa Sesame API |
Endpoint |
Dipendente / Lavoratore |
Employees |
/core/v3/employees |
Dipartimento / Unità |
Departments |
/core/v3/departments |
Centro di costo / Sede |
Offices |
/core/v3/offices |
Contratto lavorativo |
Contracts |
/contract/v1/contracts |
Dati salariali |
Salaries |
/contract/v1/salaries |
3. Sincronizzazione di assunzioni e dimissioni
Quando viene registrato un nuovo dipendente nell'ERP, è possibile attivare automaticamente la creazione della sua scheda in Sesame HR tramite una chiamata POST all'endpoint dei dipendenti. Allo stesso modo, quando un dipendente cessa il rapporto nell'ERP, è possibile aggiornare o disattivare il suo registro su Sesame.
|
POST /core/v3/employees Content-Type: application/json Authorization: Bearer {il_tuo_token}
{ "firstName": "Maria", "lastName": "López", "email": "maria.lopez@azienda.com", "departmentId": "uuid-del-dipartimento", "officeId": "uuid-dell'ufficio" } |
4. Trasferimento delle variabili per la busta paga
Sesame HR può fungere da fonte di verità per le incidenze che impattano sulla busta paga. Tramite l'API puoi esportare automaticamente verso il sistema di busta paga:
- Ore extra e timbrature: tramite gli endpoint di Work Entries (/schedule/v1/work-entries).
- Assenze e permessi: tramite Vacation e Absence Day Off Requests (/schedule/v1/vacation-day-off-requests).
- Compensazioni variabili mensili: tramite Monthly Variable Compensations (/contract/v1/monthly-variable-compensations).
- Gruppi di contribuzione: tramite Contribution Groups (/contract/v1/contribution-groups).
5. Monitoraggio e webhook
Sesame HR permette di configurare webhook per notificare i sistemi esterni quando si verificano eventi rilevanti. Questo consente all'ERP di mantenersi aggiornato in tempo reale senza necessità di polling periodico. Consulta la sezione Webhook di questa guida per maggiori dettagli.
🛠️ Hai bisogno di aiuto con l'integrazione? Il nostro team tecnico può supportarti nella progettazione e nell'implementazione. Contatta il tuo Account Manager o apri un ticket di supporto. |