Vastuu Groupin rajapinnat ja palvelut
Mikä on rajapinta?
- Tekninen rajapinta (API) mahdollistaa palveluiden välisen tiedonsiirron.
- API (Application Programming Interface) on rajapinta, jonka avulla eri ohjelmistot voivat kommunikoida keskenään. Se tarjoaa säännöt ja määrittelyt siitä, miten tietoa voidaan pyytää ja toimittaa ohjelmien välillä.
- API mahdollistaa sen, että sovellukset ja palvelut voivat hyödyntää toistensa toiminnallisuuksia ilman, että niiden sisäistä koodia tarvitsee muuttaa.
Vastuu Groupin rajapinnat:
- Raporttinoutaja, LuotettavaKumppani API
API tarjoaa dataa Luotettava Kumppani -palveluversion sekä Luotettava Kumppani tilaajavastuutiedot -palveluversion osalta. Luotettava Kumppani -yritysten raporttien tiedot ovat saatavilla JSON ja PDF-muodossa. Voit näyttää järjestelmässäsi Luotettava Kumppani -raporttien ajantasaisen tilan käyttäjän kaikkien toimittajayritysten osalta tai hakea yrityksen Luotettava Kumppani -raportin hankintajärjestelmässä tarjouspyyntöä tehdessä. - Person API
Järjestelmäsi käyttötapauksista ja tietotarpeista riippuen voit myös täydentää Valttikortilla olevia työntekijätietoja Person API -henkilötietorajapinnastamme. Person API:n kautta voit esimerkiksi hakea järjestelmääsi työmaan päätoteuttajana toimivaa asiakastasi varten kaikki Verohallinnon työntekijäraportille tarvittavat tiedot. - Korttivarasto
Valttikortti on RFID-tunnisteen sisältävä älykortti, jota voi hyödyntää erilaisissa kulunvalvonnan järjestelmäratkaisuissa. Valttikortin tiedot voit hakea järjestelmääsi Korttivarasto API:sta Valttikortilta lukijalaitteella luetulla RFID-tunnisteella tai viivakoodilla. Korttivarastossa on tiedot kaikista aktivoiduista Valttikorteista. Korttivarasto on rajapinta vahvistettujen henkilökorttien todentamiseen. Korttivarastosta löytyy myös suljettujen korttien tiedot. - Competence Input API
Competence Input API:n avulla kouluttajaorganisaatio voi tuoda tietoja suoritetuista pätevyyksistä Vastuu Groupin pätevyysrekisteriin ja sitä kautta Valtti+ -palvelua käyttävien työnantajien nähtäviksi. Rajapinta on tarkoitettu kouluttajille, jotka ovat tehneet kouluttajasopimuksen Vastuu Groupin kanssa ja joille on annettu oikeus määritettyjen pätevyystyyppien tuomiseen. Pätevyyden tuonti pätevyysrekisteriin ei edellytä, että kyseinen henkilö löytyy Vastuu Groupin rekisteristä. Kaikki pätevyydet ja tunnistetiedot tallennetaan järjestelmään, vaikka tunnistetta vastaavaa työntekijää ei tuontihetkellä löytyisikään. Kun työntekijä myöhemmin lisätään, jonka tunnistetiedot vastaavat pätevyysrekisterissä olevaa pätevyyttä, yhdistetään kyseiselle työntekijälle tämä pätevyys. Pätevyydellä on pakollisena tietona voimassaoloaika. Normaalisti pätevyyksiä ei erikseen tarvitse poistaa, vaan ne poistuvat rekisteristä automaattisesta tietyn ajan kuluttua voimassaoloajan päättymisestä. Pätevyyksien yhteydessä näytetään ulospäin kouluttajayrityksen nimenä kouluttajan yritystilillä määritelty yrityksen nimi. - Työmaarekisteri
Työmaarekisteri API:n kautta voit järjestelmässäsi perustaa työmaita ja muokata hallinnoimiesi työmaiden tietoja Työmaarekisterissä. Mikäli sinulla tai asiakkaallasi on jo Työmaarekisteri käytössä, voit helposti hakea Työmaarekisteri API:n kautta listan työmaista ja ladata niiden tiedot suoraan järjestelmääsi. Voit myös tallentaa työmaahan liittyvät urakka-/laskutustiedot Erämies API:n kautta ja työmaan kulkutiedot Kulkuri API:n kautta Työmaarekisteriin. Työmaarekisterin kautta voit näppärästi lähettää suoraan Verohallinnolle urakkaraportin ja työntekijäraportin, jotka muodostuvat automaattisesti tallentamiesi urakka-/laskutustietojen ja kulkuleimatietojen perusteella. - Kulkuri, Erämies, Vahti
Voit tallentaa työmaahan liittyvät urakka-/laskutustiedot Erämies API:n kautta ja työmaan kulkutiedot Kulkuri API:n kautta Työmaarekisteriin. Työmaarekisterin kautta voit näppärästi lähettää suoraan Verohallinnolle urakkaraportin ja työntekijäraportin, jotka muodostuvat automaattisesti tallentamiesi urakka-/laskutustietojen ja kulkuleimatietojen perusteella. - Valtti+ Tarkastaja API
Valtti+ Tarkastaja API:n kautta voi hakea työntekijöiden perustietoja, työntekijään liittyviä dokumentteja (henkilöllisyyden todistaminen, oleskelulupa ja A1-todistus) liitetiedostoineen sekä pätevyyksiä liitetiedostoineen. Tiedot ovat pääosin työnantajien järjestelmään syöttämiä tietoja. Tiedot on saatavilla vain niiltä työnantajilta, jotka ovat ottaneet käyttöönsä maksullisen Valtti+ -palvelun, ja jotka ovat luvittaneet yrityksensä työntekijöiden tiedot tietoja hakevalle yritykselle (yleensä työmaan päätoteuttaja). Rajapinnan ensisijainen käyttötarkoitus on tietojen välittäminen työnantajalta työmaan päätoteuttajille tarkastettavaksi työntekijän perehdytyksen yhteydessä. Rajapinta on maksullinen tietoja hakevalle yritykselle. Käyttö edellyttää, että tietoja hakevalla yrityksellä (yleensä päätoteuttaja) on voimassaoleva lisenssi.
Linkki API-dokumentaatioon.