Kotiček za razvijalce
Kazalo
Splošno o spletnih vmesnikih
Z uporabo spletne storitve oz. vmesnika lahko določene postopke za ZZZS urejate neposredno iz vašega kadrovskega/računovodskega programa oziroma programa za obračun plač ali programa za vodenje evidence časa zaposlenih.
Portal SPOT omogoča:
- Vmesnik eBOL in eNDM, ki omogočata prenos elektronskih bolniških listov in elektronskih potrdil o darovanju krvi - eBOL in oddajo zahtevkov za refundacijo nadomestila plače. in
- Kadrovski vmesnik za urejanje obrazcev M-1, M-2, M-3 in M12.
Vmesnik eBOL in eNDM
Od uvedbe eBOL je vmesnik za prenos e-potrdil o zadržanosti od dela in oddajo elektronskih zahtevkov za refundacijo nadomestila plače sestavljen iz dveh modulov, in sicer:
- eBOL - modul eBOL omogoča pregled in prenos elektronskih bolniških listov (eBOL) za zaposlene. Od 1.1.2024 je na seznamu e-potrdil o zadržanosti od dela omogočen tudi dostop do elektronskih potrdil o darovanju krvi (ePODK).
- eNDM - modul eNDM, ki omogoča oddajo e-zahtevkov za refundacijo.
Modul eBOL - za prenos elektronskih potrdil o zadržanosti od dela (eBOL in od 1.1.2024 tudi ePODK) delodajalcu omogoča, da sproti prevzema potrdila o upravičeni zadržanosti od dela, ki se nanašajo na njegove delavce. Uporabi jih za vodenje evidence delovnega časa, obračun nadomestil plač ter pripravo zahtevkov za refundacijo nadomestila plače. Od 1. 2. 2020 tiskani bolniški listi (razen v izjemnih primerih) niso več na voljo, od 1.1.2024 so na voljo prav tako potrdila o darovanju krvi, ki ne bodo več izdajala v tiskani različici.
Kako pričnem z uporabo vmesnika eBOL in eNDM?
1. Prijava in vpis novega programa na testno okolje
Razvijalec programske rešitve, ki želi uporabljati vmesnik eBOL in eNDM, mora pred pričetkom uporabe oddati vlogo za Prijavo odjemalca za Vmesnik eBOL in eNDM.
- Obrazec "Prijava odjemalca za vmesnik eBOL in eNDM" se nahaja v desnem stolpcu pri sklopu eBOL in eNDM/Vloga
- Vlogo pošljete na: Ministrstvo za digitalno preobrazbo, Davčna ulica 1, 1000 Ljubljana.
- Če je obrazec s strani zakonitega zastopnika elektronsko podpisan z digitalnim potrdilom ali ročno podpisan in žigosan, ga lahko pošljete na elektronski naslov gp.mdp@gov.si.
Za lažjo pripravo vloge uporabite povezavo: https://ws.spot.gov.si/spot-ndm/cert/register.ndm.
Sistem bo podatke o digitalnem potrdilu dobil avtomatsko. Nadaljujete pa do koraka generiranje vloge, ki jo v PDF obliki natisnete, skenirate in podpišite ter pošljite na Ministrstvo za digitalno preobrazbo (MDP) na elektronski naslov gp.mdp@gov.si.
Za uporabo vmesnika so potrebni podati o kvalificiranem digitalnem potrdilu, s katerim se bo vaš program pri vzpostavitvi varne SSL povezave vedno predstavil sistemu vmesnika eBOL in eNDM.
Uporabite lahko kvalificirano digitalno potrdilo, ki je lahko strežniško potrdilo, potrdilo za splošne namene, osebno kvalificirano digitalno potrdilo in ga v prijavi navedete, kot lastno potrdilo. )
Ko poteče že obstoječe digitalno potrdilo preko katerega ste prijavljeni v vmesnik eBOL in eNDM, morate po pridobitvi novega le-tega prav tako prijaviti na isti način, kot da bi vpisali novega odjemalca, to je izpolniti vnosni vlogo/obrazec in ga poslati na MDP kot je prikazano v točki 1.
Pomembno!
Razvijalcem programskih rešitev, ki že uporabljate modul eNDM, želite pa ga nadgraditi še z modulom eBOL ali pa uporabljate modul eBOL in ga želite nadgraditi z modulom eNDM ponovna prijava ni potrebna.
2. Tehnična dokumentacija za vmesnik
Tehnična dokumentacija se nahaja v desnem stolpcu - eBOL in eNDM/Tehnična dokumentacija.
3. Testiranje
eNDM
- Priporočamo da razvijalci programov, katerih stranke želijo uporabljati modul eNDM, z ZZZS opravijo testiranje modula eNDM, ki omogoča oddajo eZahtevkov za refundacije z uporabo e-potrdil o zadržanosti od dela.
Vlagatelj pri uporabi modula eNDM navede številko e-potrdila o zadržanosti od dela (eBOL ali ePODK). K eObračunu se skenira samo potrdilo o sobivanju, sodba sodišča in morebitne druge priloge.
eBOL
- Za uporabo modula eBOL izvedba testiranja z ZZZS ni potrebna. Za potrebe lastnega testiranja so ponudnikom programov na voljo testni podatki. Uporaba vmesnika eBOL ni pogojena z uporabo vmesnika eNDM, je pa uporaba modula eNDM pogojena z uporabo modula eBOL, saj delodajalec z uporabo modula eBOL pridobi številke elektronskih bolniških listov, ki jih mora navesti na eObračunu na eZahtevku za refundacijo nadomestila plač.
- ePODK je podobno kot eBOL, elektronski dokument v obliki XML. ePODK je elektronsko podpisan s strani pooblaščenega zdravstvenega delavca transfuzijske službe. Številka ePODK je večja ali enaka od 100.000.000.000, kar zagotavlja, da se številke ePODK ne prekrivajo s številkami eBOL.
4. Vpis na produkcijsko okolje
eBOL
- Ko boste v vašem programu uspešno prevzeli elektronske bolniške liste (eBOL) in elektronska potrdila o darovanju krvi (ePODK) nas na elektronski naslov: spot.operativa@gov.si obvestite, da vas za uporabo modula eBOL vpišemo na produkcijsko okolje vmesnika.
eNDM
- Za uporabo modula eNDM priporočamo, da uspešno opravite testiranje (na podlagi nekaj ključnih scenarijev), ki ga potrdi ZZZS. ZZZS obvesti Ministrstvo za digitalno preobrazbo (MDP), da ste uspešno prestali testiranje. Na MDP vas vpišemo v evidenco uporabnikov modula eNDM in lahko pričnete z uporabo.
Kadrovski vmesnik eHRS
S kadrovskim vmesnikom - eHRS lahko poslovni subjekti preko programa, ki ga uporabljajo za urejanje in vodenje kadrovskih evidenc (HR sistem) uredijo prijavo, spremembo, odjavo v obvezna socialna zavarovanja (obrazce M1, M2, M3) in sicer za zaposlene, družbenike, samostojne podjetnike in druge osebe. Preko kadrovskega vmesnika - eHRS je omogočeno tudi urejanje prijav v zavarovanje za primer poškodbe pri delu in poklicne bolezni (obrazec M12).
Kako pričnem z uporabo vmesnika eHRS?
1. Prijava in vpis novega kadrovskega programa na testno okolje
Razvijalec programske rešitve, ki želi uporabljati kadrovski vmesnik mora pred pričetkom uporabe oddati vlogo za Prijavo odjemalca za Kadrovski vmesnik.
- Obrazec "Prijava odjemalca kadrovski vmesnik" se nahaja v desnem stolpcu pri sklopu eHRS/Vloga
- Vlogo pošljete na: Ministrstvo za digitalno preobrazbo, Davčna ulica 1, 1000 Ljubljana ali pošljete digitalno podpisano skenirano vlogo na gp.mdp@gov.si.
Za lažjo pripravo vloge uporabite povezavo: https://ws.spot.gov.si/spot-hrs/cert/register.hrs
Sistem bo podatke o digitalnem potrdilu pridobil avtomatsko. Sledite korakom in izpisano kodo vpišite na obrazec za prijavo odjemalca.
Za uporabo vmesnika so potrebni podatki o kvalificiranem digitalnem potrdilu, s katerim se bo vaš program pri vzpostavitvi varne SSL povezave vedno predstavil sistemu vmesnika eHRS.
Uporabite lahko kvalificirano digitalno potrdilo, ki je lahko strežniško potrdilo, potrdilo za splošne namene, osebno kvalificirano digitalno potrdilo in ga v prijavi navedete, kot lastno potrdilo.
Ko vam poteče veljavnost kvalificiranega digitalnega potrdila s katerim se prijavljate v vmesnik eHRS ali želite dodati dodatne certifikat za delo z vmesnikom eHRS, morate prijaviti novo digitalno potrdilo na isti način, kot je opisan v točki 1.
2. Tehnična dokumentacija
- Tehnična dokumentacija se nahaja v desnem stoplcu - eHRS/Tehnična dokumentacija.
Ostali pomembni dokumenti
3. Testiranje
Na novo prijavljen sistem oziroma program mora uspešno opraviti testne klice na kadrovski vmesnik - eHRS. ZZZS vsak kadrovski sistem pred vpisom na produkcijsko okolje verificira. Testna namestitev novega eHRS sistema je popolna kopija v delovanju in zahtevah produkcijskega sistema eHRS. Oddane vloge se obdelajo v testnem sistemu ZZZS, izvede se popolni cikel od oddaje vloge do zaključka postopka oziroma prejema sklepa s strani ZZZS.
4. Prijava v produkcijsko okolje
Po uspešno izvedenem testiranju, ki ga potrdi (verificira) ZZZS, se novega uporabnika kadrovskega vmesnika eHRS vpiše v produkcijsko okolje. Ob vpisu v produkcijsko okolje pridobite enotni enolični identifikator, s katerim se prijavite v kadrovski vmesnik eHRS.
Ko je vaš kadrovski sistem/programska rešitev s strani ZZZS verificiran in vpisan na produkcijsko okolje lahko začnete z uporabo.