Palkka API on Procountor API:iin tehty palkanlaskennan rajapinta. Se on turvallinen, dokumentoitu ja automaatiota tukeva integraatio palkoille. Palkka API hyödyntää M2M-autentikointimallia ja API-Avainta. Procountor Palkka API on avoin, johon ohjelmistokumppanit voivat tehdä oman yhteyden. Useampaan eri ohjelmistoon tehtävä tietojen päivittäminen jää pois, sillä tiedot voi päivittää suoraan API:a hyödyntäen.
Kun integraatio on valmis, voidaan Api-rajapinnan kautta:
luoda, päivittää ja hakea henkilö-ja työsuhdetietoja.
luoda, päivittää, ja hakea palkkalistoja ja palkkalaskelmia sekä hyväksyä palkkalaskelmia.
hakea ja päivittää palkkalaskelman kirjanpitotiedot esimerkiksi dimensioilla.
API:n tekniseen kuvaukseen pääset tästä.
Käyttöönotto
Jotta Palkka-Api voidaan ottaa käyttöön, tulee Procountorissa sallia ensin API-rajapinnan käyttö:
Salli API-rajapinnan käyttö Procountor-ympäristössä. Tämä onnistuu ohjelman kohdassa Hallinta > Yrityksen tiedot > Käyttöasetukset lisäämällä valinnan kohtaan Salli laskutettavien rajapintojen käyttö.
Valitse tai luo Procountorin käyttäjätunnus (API-käyttäjä) , johon integraatio liitetään.
Varmista, että käyttäjälle on Prcountorissa asetettu integraatiossa tarvittavat käyttöoikeudet. Voit käyttää esimerkiksi valmista roolia Palkanlaskija sekä merkitse, että käyttäjäroolille sallitaan vain M2M-kirjautuminen.
Ota integraatio käyttöön toisessa järjestelmässä. Käyttöönotto edellyttää tunnistautumista rajapinnassa. Tunnistautuminen tapahtuu Procountoriin luodulla käyttäjätunnuksella. Autentikointimenetelmä vaatii API-avainta.
M2M-mallissa on kaksi tapaa, kuinka integraattori voi vastaanottaa API-avaimen:
Käyttäjä voi itse luoda API-avaimen Procountorin käyttöliittymässä ja toimittaa sen eteenpäin. Toisessa järjestelmässä voi esimerkiksi olla kenttä, johon API-avain tulee syöttää. Luovuttaessaan API-avaimen, käyttäjä antaa integraattorille valtuutuksen luoda yhteys.
Integraatiossa on voitu myös ottaa tunnistautumisessa käyttöön API-kirjautumissivu, jolloin kirjautumisella annetaan integraattorille valtuutus luoda yhteys ja noutaa API-avain rajapinnan kautta.
Procountorissa tulee myös määritellä yrityksen tiedot ja palkanlaskennan asetukset valmiiksi.
Ympäristön valmistelu Palkka API:n käyttöönottoa varten (esimerkki)
Syötä yrityksen tiedot Procountoriin:
Huomioi myös loma-asetukset, työajanlyhennysvapaa-, ja keskituntiansion laskenta asetukset.
Palkka-Apin käyttäminen käyttäjän näkökulmasta (esimerkki)
Kun Procountorin palkanlaskennan käyttöönotto on suoritettu ja tarvittavat tiedot löytyvät Procountorista:
voidaan palkansaajat perustaa Procountorin henkilö- ja palkansaajarekisteriin toisen ohjelmiston kautta.
tarkistaa ja hyväksyä tuntitietoja toisessa ohjelmistossa ja siirtää ne Procountoriin, jolloin Procountor luo tiedoista palkkalistan ja palkkalaskelmat.
palkkalaskelmat voidaan hyväksyä toisessa ohjelmistossa tai vaihtoehtoisesti hyväksyä ne Procountorissa, mikäli mukana ei tuoda dimensioita.
Jos dimensiotiedot tuodaan toisesta ohjelmistosta, ovat palkkalaskelmat Procountorissa Hyväksytty -tilassa siirron jälkeen.
Siirron onnistumisen tarkastus toisessa ohjelmistossa
Procountor lähettää mahdolliset virheviestit toiseen ohjelmistoon (virheviestit eivät näy Procountorissa). Ohjelmistotoimittaja on voinut toteuttaa integraation myös niin, että tiedot eivät siirry, jos niissä on virheellisiä tietoja.
Palkkalaskelmien ja –listojen maksu tapahtuu vielä normaalisti Procountorin käyttöliittymässä.
HUOM! hyväksytyn palkkalaskelman muokkaaminen muuttaa myös toisesta ohjelmistosta tuodut dimensiot oletusten mukaiseksi.
Palkka-API:n irtisanominen
Ohjeet Palkka-API:n irtisanomiseen löydät täältä. Palkka-API käyttää M2M -autentikointimallia.