Sense România · Integrare tehnică
O integrare bună începe cu datele și regulile.
Sense oferă Open API și webhooks, plus documentație pentru date de angajat, pontaj și evenimente de calendar. Pagina ajută echipele IT și HR să definească un transfer către sistemul existent. Metoda de apel, câmpurile, filtrele și permisiunile diferă între endpoint-uri; un API de pontaj nu este o interfață generală de localizare live.
Pornim de la o locație, un proces și sistemele pe care le folosești.

Alege interfața după date, nu după numele API-ului
Employee Core Data API
Date despre angajați și identificatori Sense. Verifică filtrele și câmpurile necesare; nu importa implicit tot dosarul.
Attendance API
Program și pontaj zilnic, intrări, ieșiri, pauze și evenimente asociate intervalului. Documentația descrie o cerere POST și preluare asincronă prin GET.
Calendar Events API
Evenimente de lucru și absență, cu stare de aprobare. Se apelează prin POST cu parametri JSON; nu reutiliza automat convențiile Attendance API.
Documentația Employee Core Data API ↗ · Documentația Attendance API ↗ · Documentația Calendar Events API ↗


Trei detalii care schimbă implementarea
Attendance API documentează o limită de interval de 30 de zile și preluarea rezultatului din adresa Location. Calendar Events API avertizează că identificatorii invalizi pot elimina filtrarea, că evenimentele în așteptare sunt incluse și că duration nu trebuie folosit pentru calculul drepturilor de concediu. Validează răspunsul, nu doar codul HTTP.
Documentația Attendance API ↗ · Documentația Calendar Events API ↗
Definește sursa principală și reconcilierea
Propunere tehnică: mapează identificatorii, fusul orar și orele, apoi stabilește tratamentul corecțiilor, plecărilor și înregistrărilor lipsă. Separă transferul pontajului de localizare, sarcini sau evenimente WMS. Exemplul Personio din notele de versiune este o conexiune documentată, nu un contract universal de integrare.
Securitate și test de acceptare
Ține cheile în infrastructura server, nu în blocul HTML. Limitează datele, accesul și jurnalele. Calendar API poate returna informații despre sănătate; evită transferul lor dacă nu sunt necesare și validate juridic. Testează autorizarea, intervalul, filtrele invalide, timeout-ul, reluarea și comparația sursă–destinație înainte de producție.
Documentația Calendar Events API ↗ · Documentația Employee Core Data API ↗
Întrebări despre datele și api-urile documentate
Attendance API returnează poziția live a angajaților?
Nu îl prezentăm astfel. Documentația verificată descrie pontaj zilnic, program, pauze și evenimente; alte date cer o interfață și o validare separate.
Se folosesc aceiași parametri pentru toate endpoint-urile?
Nu. Attendance folosește un flux asincron POST/GET; Calendar Events folosește POST cu corp JSON. Urmează documentația fiecărei interfețe.
Pot calcula soldul concediilor însumând duration?
Documentația Calendar Events avertizează să nu folosești duration pentru calculul drepturilor sau al soldului. Ia aceste valori din evidența corespunzătoare.
Unde se păstrează cheile API?
Pe server, cu acces limitat și administrare controlată. Nicio cheie sau adresă privată de endpoint nu trebuie inclusă în această pagină publică.
Continuă cu detaliile relevante pentru proiect.
Începe cu un flux pe care îl poți verifica.
Discutăm problema, datele necesare și sistemele existente. Alegem ce trebuie demonstrat înainte de o decizie.
Discută despre proiectul tău Sense