Lyhytliittymä
Tiedostomuoto
Siirtotiedosto on positioeroteltua tekstimuotoista dataa. Tietuepituus 200 + 2.
Tietueet eroteltuna. Tietueet päättyvät joko CR+LF, CR tai LF -merkkeihin.
Negatiiviset luvut: kentän ensimmäinen nolla (0) korvataan miinus (-) merkillä.
Rajaukset
- Työntekijät työntekijänumerolla 0 eivät tule osaksi aineistoa
Aineiston tietueet – lyhytliittymä
| Positiot | Sarakkeen nimi | Sääntöjoukon kentän nimi | Muoto | Kuvaus |
|---|---|---|---|---|
| 1-3 | Yritysnumero | Lisätään automaattisesti, ei korvattavissa | String | Yrityksen tunnus Sonet-järjestelmässä. Infotieto. Tapahtumat ohjautuvat valittuna olevalle yritykselle. |
| 4-6 | Siirtotunnus | Lisätään automaattisesti, ei korvattavissa | String | Siirtomateriaalin tunnus, joka siirtyy sellaisenaan palkkatapahtumalle. Voidaan käyttää lähdeaineiston tunnistamisessa ja poistossa. Siirtyy aina tyhjänä. |
| 7 | Palkansaajantunnisteen tyyppi | Lisätään automaattisesti, ei korvattavissa | String |
Tyyppi ilmaisee, millä tunnisteella palkansaaja tunnistetaan liittymässä. Käytössä olevat tyyppikoodit:
Siirtyy aina aineistossa arvolla 1. |
| 8-22 | Palkansaajan tunniste | Lisätään automaattisesti, ei korvattavissa | String |
Palkansaajan tunniste. Sisältö määräytyy em. tyypin mukaan. Muoto:
|
| 23-27 | Palkkalaji | SalaryCode | String | Tapahtuman palkkalajin tunnus. Jos liittymässä tulee Sonetin palkkalaji, tuodaan palkkalaji liittymässä sen muotoisena kuin se Sonetissa on (etunollat). |
| 28 | String | Tyhjää | ||
| 29 | Vastaavuustarkistetunnus | String |
Tuodaan 1, jos vastaavuustaulukko on käytössä, muuten tyhjä. Vastaavuustaulukko määritellään siirron ohjauksessa. Tapahtuman palkkalajille voidaan määritellä eri palkkalajin tunnus Sonet-järjestelmässä. Lisäksi voidaan määritellä poikkeussääntöjä ja kustannuspaikan ohjausta. Siirtyy aina aineistossa tyhjänä |
|
| 30-40 | Eurosumma | String |
Tapahtuman rahasumma. Palkkatapahtuman rahasumma voidaan myös laskea palkkalajikohtaisten laskentakaavojen avulla muiden siirtotapahtumalla ja palkkaustiedoissa olevien tietojen perusteella (esim. tunnit * palkka). HUOM. Jos tässä kentässä tuodaan euroja, siirtyvät ne suoraan tapahtumarivin summaksi, eli tällöin liittymässä ei suoriteta laskentoja. Siirtyy aina aineistossa tyhjänä |
|
| 41-49 | Tunnit | "Amount" field if unitType = 'H', 'S' or 'J' | Numeric | Tapahtuman tunnit. Laskukaavassa: SK01 |
| 50 -56 | Määrä | "Amount" field if unitType = 'U', 'D', or 'C' | Numeric | Tapahtuman määrätieto, esim. päivät. Laskukaavassa: SK04 |
| 57-66 | Kustannuspaikka | String |
Kustannuspaikka tapahtumalla, mikäli tyhjä, kustannuspaikaksi oletetaan henkilön kustannuspaikka. Aineistossa siiryy tapahtumalle valitun projektin koodi |
|
| 67-76 | Tili | String |
Kirjanpidon tili, mikäli tyhjä, siirrossa päätellään tapahtuman tili joko henkilöltä tai palkkalajilta. Siirtyy aineistossa aina tyhjänä |
|
| 77-79 | Lomasääntö | String |
Palkkatapahtuman lomasääntö, vain erillissopimuksesta käytössä Siirtyy aina aineistossa tyhjänä |
|
| 80-93 | Varatila | String | Siirtyy aina aineistossa tyhjänä | |
| 94-96 | Poissaolokoodi | String | Poissaolon syykoodi. Siirtyy aina aineistossa tyhjänä. | |
| 97-116 | Viite | String | Viitetieto tapahtumalle. Siirtyy aina aineistossa tyhjänä | |
| 117-124 | AlkuPvm | StartDateTime (date format will be converted automatically) | String | Tapahtuman alkupäivä. Hinnoittelu yleensä tämän päivän mukaan. Jos tyhjä, niin palkkakauden alkupäivä tapahtumalle. Siirtyy aina alkupäivä muodossa PPKKVVVV |
| 125-132 | Loppupvm | EndDateTime (date format will be converted automatically) | String | Tapahtuman loppupäivä. Jos tyhjä, niin palkkakauden loppupäivä tapahtumalle. Siirtyy aina loppupäivä muodossa PPKKVVVV |
| 133-172 | Henkilönimi | String | Infotieto, ei siirry liittymässä. Tietue on aina tyhjä. | |
| 173-200 | Varalla | String | Tyhjää |
Esimerkki - lyhytliittymä
001 144 000000000000000007500000000190 0102201801022018 001 144 000000000000000007500000000190 0202201802022018 001 144 000000000000000007500000000190 0502201805022018 001 144 000000000000000007500000000190 0602201806022018
Parametroitu liittymä
Liittymää voidaan käyttää yhdessä Sonet Premiumin kanssa.
Tiedostomuoto – parametroitu liittymä
Siirtotiedosto on UTF-8 muotoista puolipisteellä (;) eroteltua tekstimuotoista dataa. Rivinvaihtona toimii carriage return line feed (CR+LF)
Kenttien pituuksille ei ole määritelty ylärajaa. Sonetiin määritellään tiedoston luentaan tätä aineistoa vastaavat sarakkeet ja käsittelysäännöt.
Tiedosiirto on mahdollista ottaa käyttöön myös vain yhdellä projektikohdenteella.
Rajaukset – parametroitu liittymä
- Työntekijät työntekijänumerolla 0 eivät tule osaksi aineistoa
Aineiston tietueet – parametroitu liittymä
| Sarake | Kentän nimi | Formaatti | Kuvaus |
|---|---|---|---|
| A | Yritysnumero | string | Siirretään oletuksena arvolla 001. Voidaan ohittaa sääntöjoukon säännössä kentällä SonetCompanyNumber. |
| B | Henkilönumero | string | Henkilön Sonet-tunnus / henkilönumero |
| C | Palkkalajikoodi | string | Voidaan ohittaa sääntöjoukon säännössä kentällä OverrideSalaryCode |
| D | Palkkalajin alakoodi | string | Voidaan ohittaa sääntöjoukon säännössä kentällä OverrideSubSalaryCode |
| E | Tuntimäärä | decimal | 2 desimaalin tarkkuudella, desimaalierottimena on piste (.). Voidaan ohittaa sääntöjoukon säännössä kentällä OverrideHourAmount |
| F | Määrä yksikköinä | string | 2 desimaalin tarkkuudella, desimaalierottimena on piste (.). Voidaan ohittaa sääntöjoukon säännössä kentällä OverrideUnitAmount. |
| G | Alkupvm | date | Päivämäärän muoto: YYYY-MM-DD |
| H | Alkukellonaika | string | Ajan muoto: hh:mm:ss |
| I | Loppupvm | date | Päivämäärän muoto: YYYY-MM-DD |
| J | Loppukellonaika | string | Ajan muoto: hh:mm:ss |
| K | Palkkalajikoodin kuvaus | string | Palkkalajin kuvaus. Voidaan ohittaa sääntöjoukon säännössä kentällä RowDescription |
| L | Palkkalajin alakoodin kuvaus | string | Tarkempi palkkalajin kuvaus. Jos esimerkiksi palkkalajikoodin kuvaus on "Palkallinen poissaolo", sen alakoodin kuvaus voisi esimerkiksi olla "Omat vihkiäiset". Voidaan ohittaa sääntöjoukon säännössä kentällä SonetSubRowDescription. |
| M | Tapahtuman kuvaus | string | Tapahtuman kuvaus / kommentti. |
| N | Projektikoodi 1 | string | Projektikoodi 1 |
| O | Projektikoodi 2 | string | Projektikoodi 2 |
| P | Projektikoodi 3 | string | Projektikoodi 3 |
| Q | Projektikoodi 4 | string | Projektikoodi 4 |
| R | Projektikoodi 5 | string | Projektikoodi 5 |
| S | Projektikoodi 6 | string | Projektikoodi 6 |
| T | Projektikoodit ketjutettuna | string | Jos projektikoodi 1 on "A" ja projektikoodi 2 on "B", tämän kolumnin arvona olisi "AB". Voidaan ohittaa sääntöjoukon säännössä kentällä SonetConcatenatedProjects. |
| U | Projektikoodi 1:n dimensio 1 | string |
Dimensiotiedoissa esitetään ensimmäinen projektikoodi, joka on jaettu osiin merkillä Voidaan ohittaa sääntöjoukon säännössä kentällä |
| V | Projektikoodi 1:n dimensio 2 | string | Voidaan ohittaa sääntöjoukon säännössä kentällä SonetProjectDimension2 |
| W | Projektikoodi 1:n dimensio 3 | string | Voidaan ohittaa sääntöjoukon säännössä kentällä SonetProjectDimension3 |
| X | Projektikoodi 1:n dimensio 4 | string | Voidaan ohittaa sääntöjoukon säännössä kentällä SonetProjectDimension4 |
| Y | Projektikoodi 1:n dimensio 5 | string | Voidaan ohittaa sääntöjoukon säännössä kentällä SonetProjectDimension5 |
| Z | Projektikoodi 1:n dimensio 6 | string | Voidaan ohittaa sääntöjoukon säännössä kentällä SonetProjectDimension6 |
Esimerkki – parametroitu liittymä
001;44;;;7.50;0;2018-02-28;00:00:00;2018-02-28;23:59:00;Palkaton poissaolo;Vanhempainvapaa;;190;;;;;;190;190;;;;;
001;15;;;10.00;0;2018-02-01;00:00:00;2018-02-28;23:59:59;Työpäivien lukumäärä;;;;;;;;;;;;;;;