Pentru IT și companiile mari
API pentru pontaj și integrări cu sistemele HR
Verifică datele de prezență și pontaj documentate, identificatorii angajaților și destinația transferului. Personio oferă un exemplu oficial; orice altă conexiune se confirmă pe câmpuri și fluxuri.
Arhitectura
Sistemul actual poate rămâne sursa de adevăr.
Schemă conceptuală. Datele și destinația se validează pentru fiecare integrare.
Un conector existent poate reduce munca de integrare. În lipsa lui, se definește un serviciu de integrare propriu, cu mapări, autentificare, gestionarea erorilor și reconciliere.
Date documentate astăzi
Ce poți prelua din Sense.
| API | Date și utilizare | Contract și limite |
|---|---|---|
| Employee Core Data | Identificator stabil, persoană, funcții, departamente, locații organizaționale, date de angajare și manageri. | POST; cheie API în Authorization, fără prefix Bearer; listă opțională de IP-uri. Locațiile organizaționale nu sunt coordonate live. |
| Attendance | Program zilnic, prima intrare, ultima ieșire, pauze și evenimente de calendar. Date pentru comparații și reconciliere. | POST de inițiere, apoi GET la adresa din Location; 202 cât timp se pregătește, 200 cu rezultat. Fereastră de maximum 30 de zile, conform ghidului. Nu este un flux în timp real. |
| Calendar Events | Concedii, absențe, ore suplimentare și alte evenimente configurate, inclusiv starea aprobării. | Identificare prin plannerEventId + senseHrId. Ghidul descrie GET, dar exemplele folosesc POST: metoda trebuie confirmată cu Sense. Nu calculăm soldul concediilor din duration. |
Conectori și notificări
Separă promisiunea comercială de contractul tehnic.
Personio
Exemplu oficial pentru înregistrări de pontaj din hardware Sense, inclusiv actualizare și ștergere. Verifică identificatorii și configurația în proiect.
REST și webhook-uri
Pagina Open API menționează endpoint-uri REST și abonamente la evenimente. Catalogul concret, livrarea, reîncercările și autentificarea se confirmă pentru integrarea aleasă.
Sisteme locale și platforme pentru companii mari
SAP, Oracle, Workday, HR local, ERP sau WMS sunt destinații de evaluat. Nu sunt prezentate aici ca integrări native confirmate.
Ce nu este confirmat
Nu presupune că harta este disponibilă prin API.
Documentația consultată nu confirmă expunerea coordonatelor RTLS brute, a zonelor live sau a unui flux SOS prin API-urile publice descrise.
Capabilitatea din Presence Hub nu implică automat o interfață publică pentru aceleași date.
Pagina comercială Open API menționează OAuth2 și chei API. Ghidurile specifice consultate cer cheie API brută. Implementarea urmează ghidul endpoint-ului și confirmarea Sense.
Înainte de integrare
Un contract care poate fi verificat.
Mapare și minimizare
Folosește senseHrId ca identificator stabil și validează lista înainte de cerere: filtrele invalide pot întoarce toate persoanele. Preia numai câmpurile necesare.
Timp și corecții
Confirmă fusul orar, turele peste miezul nopții, valori null și înregistrări corectate. Nu transforma prima intrare și ultima ieșire în ore plătite fără reguli și aprobări.
Operare și securitate
Păstrează cheile pe server. Configurează timeout, reîncercări controlate, jurnalizare fără date excesive și reconciliere. Verifică limitele, planul și responsabilul de suport.
Următorul pas
Spune-ne ce folosești acum și verificăm cum se poate conecta.
Începe cu numele platformei și câmpurile de care ai nevoie.