ROEN Contact & demo
  1. Acasă
  2. Integrări
  3. Dezvoltatori · API HR Lite

API HR Lite pentru dezvoltatori

Trimiteți date de personal către IQ.HR direct din sistemul vostru

API-ul HR Lite este calea prin care sistemele HR, ERP-urile sau platformele de grup, precum Workday, transmit angajări, modificări de contract, suspendări și încetări. Fiecare cerere este primită, validată și pusă în revizuirea HR înainte să ajungă în dosarul angajatului, în salarizare sau în REGES Online.

Explorează referința API Descarcă OpenAPI (YAML)
POST /new-employees/{badge}
POST /hr-lite/v1/new-employees/E2400
Authorization: Bearer <token>
Idempotency-Key: 3f0c…b71e
Content-Type: application/json

{
  "fields": [
    { "fieldKey": "lastName",  "value": "Popescu" },
    { "fieldKey": "firstName", "value": "Ana-Maria" },
    { "fieldKey": "hireDate",  "value": "2026-11-03" },
    { "fieldKey": "grossSalary", "value": "8500" }
  ]
}

201 Created · salvat pentru revizuirea HR
  • OpenAPI 3.0Specificație citibilă automat
  • OAuth 2.0Client credentials, pe fiecare mediu
  • JSON prin HTTPSResurse REST, erori problem+json
  • IdempotentReîncercări sigure, Idempotency-Key opțional
  • 300 / minLimita implicită de scrieri pe integrare

Cum funcționează

Din sistemul vostru până în salarizare, cu HR-ul în control

Un răspuns de succes înseamnă că datele au fost primite și salvate pentru revizuirea HR. Cererea nu creează și nu modifică singură un angajat, iar nimic nu se transmite automat în REGES Online.

  1. Voi trimiteți

    Sistemul vostru apelează API-ul la o angajare, o modificare de contract, o suspendare sau o încetare, cu identificatori aleși de voi.

  2. Noi validăm

    Câmpurile sunt verificate față de catalogul și nomenclatoarele publicate. Primiți o chitanță sau o eroare clară pentru fiecare câmp respins.

  3. HR revizuiește

    HR completează datele cerute în România și rezolvă eventualele conflicte dintre valorile voastre și propriile corecturi.

  4. Se aplică

    Modificarea aprobată ajunge în dosarul angajatului, în salarizare și, prin modulul Revisal, în REGES Online.

Resurse

Patru resurse, plus catalogul

Identificatorii sunt aleși de sistemul vostru și rămân stabili pe toată durata înregistrării. Datele de angajare și de modificare de contract se trimit ca listă de perechi câmp–valoare, așa că un câmp nou nu vă strică integrarea.

Înainte de trimitere, citiți GET /catalogue pentru câmpurile acceptate și GET /dictionaries/{key} pentru codurile valide, precum companii, tipuri de contract sau motive de absență. Valorile din sistemul vostru pot fi mapate o singură dată de IQ.HR.

ResursăCreareActualizare
Angajat nouPOST /new-employees/{badge}PUT înlocuire completă
Modificare contractPOST /cim-changes/{id}PUT înlocuire completă
SuspendarePOST /suspensions/{id}PATCH parțial
ÎncetarePOST /terminations/{id}PATCH parțial
Oricare dintre eleGET starea curentăPOST …/withdrawals

Esențial pentru integrare

Ce trebuie să știe dezvoltatorii voștri

Autentificare

OAuth 2.0 client credentials. Cereți un token cu client ID-ul și secretul emise de IQ.HR și trimiteți-l ca bearer token. Compania și integrarea sunt legate de credențial.

Reîncercări sigure

O cerere identică repetată întoarce UNCHANGED. Un Idempotency-Key UUID opțional reia chitanța inițială, deci o reîncercare după timeout nu dublează datele.

Erori clare

Erorile au un code stabil, un correlationId pe care ni-l puteți comunica și, la validare, o listă errors cu fiecare câmp exact cum l-ați trimis.

Valorile câmpurilor

Valorile sunt texte sau null: date YYYY-MM-DD, zecimale cu punct, booleeni "true"/"false". Câmpurile de business lipsă nu blochează preluarea.

Limite

Până la 300 de scrieri pe minut pe integrare, 500 de câmpuri și 1 MiB pe cerere. Răspunsurile 429 includ Retry-After.

Securitate

Doar HTTPS, credențiale pe fiecare mediu, date separate pe client. IQ.HR este certificată ISO/IEC 27001, ISO/IEC 27701 și ISO 9001 și deține un raport ISAE 3402 privind controale auditate independent.

Primii pași

De la primul apel la lansare

Adresele din specificația publicată sunt exemple. Vă trimitem adresele de bază, adresa pentru token și credențialele fiecărui mediu la configurarea integrării.

Cere acces la API

Întrebări tehnice: office@iqhr.ro

  1. Cereți acces

    Spuneți-ne ce sistem va trimite datele și ce evenimente vreți să transmiteți.

  2. Mapați valorile

    Comparați codurile voastre cu catalogul și nomenclatoarele; noi configurăm maparea valorilor din sistemul vostru.

  3. Testați

    Trimiteți date de test în mediul de test și verificați rezultatul împreună cu HR.

  4. Lansați

    Treceți pe credențialele de producție. Fiecare cerere rămâne trasabilă prin correlation ID.

Referință API

HR Lite External Ingestion API

Toate endpoint-urile, parametrii, schemele și exemplele. Documentația tehnică este în limba engleză, iar referința este doar pentru consultare: din această pagină nu se trimit cereri.

Descarcă OpenAPI (YAML)