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ä;;;;;;;;;;;;;;;