SD Worx (Erot) -integraation avulla menneiden maksukausien muutokset lisätään vientipuskuriin reaaliajassa sitä mukaa, kun ne tallennetaan Neptoniin. Nykyisiin tai tuleviin maksukausiin tehtyjä muutoksia ei lisätä vientipuskuriin reaaliajassa, vaan ne on vietävä joko manuaalisesti tai automaattisesti integraation ajastuksella. Kun menneeseen maksukauteen tehdään muutos, muokkausta edeltäneen ja muokkauksen jälkeisen tapahtuman välinen ero lisätään vientipuskuriin.
Hyvä tietää
- Työntekijät henkilönumerolla 0 eivät tule osaksi aineistoa.
- Tapahtuma voidaan tallentaa menneelle maksukaudelle, vaikka integraatiossa olisi ongelmia. Esimerkiksi virheellinen integraatiosääntö tai SFTP-palvelimen ongelma ei estä tapahtuman tallentamista. Käyttäjälle ilmoitetaan virheestä.
- Integraatiolle on mahdollista määrittää useita sääntöjoukkoja. Jos useita sääntöjoukkoja on määritelty, tapahtuman tallentaminen voi kestää hieman kauemmin.
Asetukset
Maksuryhmät
Yleiset ohjeet maksuryhmien lisäämiseen ja määrittämiseen löytyvät kohdasta Maksuryhmät.
Maksuryhmälle on määritettävä maksujaksot, ja jokaisella maksujaksolla on oltava hyväksymispäivämäärä. Kun hyväksymispäivämäärä on umpeutunut, maksujakso on menneisyydessä, ja kaikki kyseisen ajanjakson tapahtumiin tehdyt muutokset lähetetään vientipuskuriin reaaliajassa muutosta edeltävien ja muutoksen jälkeisten tapahtumien erotuksena.
Liittymän asetukset
1. Henkilöiden tunnusten määrittäminen
Henkilötunnisteet voidaan määrittää kohdassa Työsuhde > Henkilön tiedot > Tunnisteet.
Mikäli henkilön SD Worx-tunnusta ei ole asetettu, käytetään henkilönumeroa.
2. Kohdepalvelimen lisäys
Jos liittymälle ei vielä ole kohdepalvelinta, lisää se työyhteisön asetuksista kohdasta Liittymät > Liittymien kohdepalvelimet. Katso Työajan vientiliittymien kohdepalvelimet yleiset ohjeet kohdepalvelimen lisäykseen ja kohdepalvelimen SFTP-asetuksien asetukseen.
Kohdepalvelimen SFTP-asetuksissa tulee määrittää vähintään SFTP-palvelimen osoite, SFTP-käyttäjätunnus sekä SFTP-salasana (tai public key -autentikointi).
3. Liittymän asetukset
Liittymän käyttöönottoa varten tulee määrittää sääntöjoukko, jolla muodostetaan poissaoloaineisto. Sääntöjoukon asetuksissa valitaan viennin tiedostomuodoksi SD Worx (Erot).
Valitse liittymälle kohdepalvelin, jonka lisäsit kohdassa 2.
Vientitiedoston nimeen tulee lisätä tarkka aikaleima [timestamp-ms], kuten alla olevassa esimerkissä. Mikäli aikaleimaa ei käytetä, jokaisella tiedostolla on sama nimi ja ne ylikirjoittavat toisensa.
4. Viennin ajastus kohdepalvelimelle
Viimeisenä kohdepalvelimen puskurille tarvitsee määrittää viennin ajastus. Tästä voit lukea lisää artikkelista Työajan vientiliittymien kohdepalvelimet.
Tiedostomuoto
Siirtotiedosto on ISO-8859-1-muotoiltua tekstidataa, joka on erotettu puolipisteillä (;). Rivinvaihto on LF. Siirtotiedoston lopussa on yksi tyhjä rivi.
Aineiston tietueet
| Sarake | Kenttä | Sääntöjoukon nimi | Muoto | Kuvaus |
|---|---|---|---|---|
| A | Business ID | Lisätään automaattisesti | merkkijono | Business ID. Voidaan ohittaa sääntöjoukon säännössä kentällä SDWorxDifferenceBusinessId. |
| B | Henkilönumero | Lisätään automaattisesti | merkkijono | Henkilön SD Worx tunnus / henkilönumero. |
| C | Maksuryhmän koodi | Lisätään automaattisesti | merkkijono | Maksuryhmän koodi. Voidaan ohittaa sääntöjoukon säännössä kentällä SDWorxDifferencePaymentGroupCode. |
| D | Työsuhteen alkupäivä | Lisätään automaattisesti | merkkijono | Työsuhteen alkupäivä muodossa DD.MM.YYYY. Voidaan ohittaa sääntöjoukon säännössä kentällä SDWorxDifferenceWorkRelationshipStartDate. |
| E | Palkkalajikoodi | SalaryCode | merkkijono | Voidaan ohittaa sääntöjoukon säännössä kentällä OverrideSalaryCode
|
| F | Määrä tunneissa | "Amount"-kenttä, jos yksikkötyyppi on 'H' tai 'S', muuten tyhjä | desimaali | Tuntien määrä kahden desimaalin tarkkuudella. , desimaalierottimena. Tämä kenttä sisältää tietoa, jos tieto otetaan ulos tunteina. |
| G | Määrä päivissä | "Amount"-kenttä, jos yksikkötyyppi on 'J', muuten tyhjä | desimaali | Päivien määrä kahden desimaalin tarkkuudella. , desimaalierottimena. Tämä kenttä sisältää tietoa, jos kenttä otetaan ulos päivinä. |
| H | Määrä desimaalina / yksikkönä | "Amount"-kenttä, jos yksikkötyyppi on 'U' tai 'D', muuten tyhjä | desimaali | Määrä kahden desimaalin tarkkuudella. , desimaalierottimena. Tämä kenttä sisältää tietoa, jos kenttä otetaan ulos desimaalilukuna tai yksiköinä. |
| I | Alkupäivä | StartDateTime | merkkijono | Muoto DD.MM.YYYY |
| J | Loppupäivä | EndDateTime | merkkijono | Muoto DD.MM.YYYY |
| K | Määrä, valuutta | "Amount" kenttä, jos UnitType on'C', muuten tyhjä | desimaali | Valuutan määrä kahden desimaalin tarkkuudella. , desimaalierottimena. Tämä kenttä sisältää tietoa, jos kenttä otetaan ulos valuuttana. |
Alla oleva aineisto on esimerkki 8 tunnin työkirjauksen viennistä ilman ruokataukoa.
1234567-1;219354;10;01.01.2025;1000;3,50;;;02.06.2025;05.06.2025;
1234567-1;219354;10;01.01.2025;1000;4,00;;;05.06.2025;05.06.2025;
Ongelmatilanteet
Asetusmuutokset
Palkka-aineistoon vaikuttavia asetusmuutoksia ei ole suositeltavaa tehdä jälkikäteen. Esimerkiksi työpäivän pituuden muuttaminen päiväkohtaisesti kalenterinäkymässä voi muuttaa myös palkallisia tunteja. Tällaisia muutoksia tehdessä liittymää ei suoriteta ja SD Worxiin jää sinne mahdollisesti aiemmin viety tieto tapahtuman palkallisuudesta. Tällaisessa tilanteessa tulee toimia seuraavasti:
- Poista tapahtuma Neptonista. Tämä lähettää tiedoston, joka sisältää poistettavan eron.
- Poista kaikki tapahtuman tiedot SD Worxista. Rivejä voi olla useita sääntöjoukon määrityksistä riippuen.
- Lisää tapahtuma uudelleen.