Skip to content Skip to main navigation Skip to footer

Web

Fennoa: Myyntilaskuaineistosiirto

Tämä ohje koskee Maxtech Pro™ -palvelua. Maxtech Easy™ käyttäjille on olemassa erilliset ohjeet.

Tämä toiminnallisuus kuuluu seuraaviin tuotteisiin ja vaatii toimiakseen seuraavat moduulit:

TUOTTEETmoduulit
Laskutusrivit, -aineistot ja kateraportti™Fennoa-myyntilaskut

Perustiedot

Tiedoston nimiN/A (palvelujen välinen tiedonsiirto)
Järjestelmien välinen tiedonsiirtotapaPalvelujen välinen tiedonsiirto
Tiedostoformaattixml (Finvoice 2.0)
MerkistöUTF-8
PäivämääräformaattiYYYY-MM-DD (esimerkiksi: 2022-06-22)
Desimaalierotinpiste (.)
TuhaterotinEi käytössä

Rajapinnassa siirrettävät tiedot

Myyjän tiedot

Myyjän tiedot tulevat laskulle Fennoasta.

Ostajan tiedot (BuyerPartyDetails)

Maxtech-JÄRJESTELMÄN kenttäXML-ELEMENTTI
Sähköisen laskutuksen ovt-tunnus (asiakkaan tiedoista)MessageTransmissionDetails -> MessageReceiverDetails -> ToIdentifier
Sähköisen laskutuksen välittäjätunnus (asiakkaan tiedoista)MessageTransmissionDetails -> MessageReceiverDetails -> ToIntermediator
Nimi (asiakkaan tiedoista)BuyerOrganisationName
Y-tunnus (yksityisasiakkaalla asiakasnumero)BuyerPartyIdentifier (jos Y-tunnus on validi, laskulle muodostuu myös BuyerOrganisationTaxCode eli ALV-tunnus)
Osoite (katu)BuyerStreetName
Osoite (kaupunki)BuyerTownName
Osoite (postinumero)BuyerPostCodeIdentifier

Laskun tiedot (InvoiceDetails)

Laskuille luodaan laskunumero Fennoassa ja laskut tallentuvat Fennoaan luonnoksina.

Maxtech-JÄRJESTELMÄN kenttäXML-ELEMENTTI
Kiinteästi ’INV01’ (Tavallinen lasku)InvoiceTypeCode
Kiinteästi ’Lasku’InvoiceTypeText
Kiinteästi ’Original’OriginCode
Kuluva päiväInvoiceDate
Viitteemme (Laskulla) (asiakkaan tiedoista)SellerReferenceIdentifier
Viitteenne (Laskulla) (asiakkaan tiedoista)BuyerReferenceIdentifier
Laskurivien yhteenlaskettu veroton summaInvoiceTotalVatExcludedAmount
Laskurivien yhteenlaskettu veron summaInvoiceTotalVatAmount
Laskurivien yhteenlaskettu verollinen summaInvoiceTotalVatIncludedAmount
VerokantaerittelyVatSpecificationDetails
Laskutuksen lisätiedot (asiakkaan tiedoista)InvoiceFreeText
Maksuehto, ensisijaisesti asiakkaan laskutustiedoista ja toissijaisesti organisaation asetuksistaPaymentTermsDays
Eräpäivä, lasketaan ensisijaisesti asiakkaan laskutustiedoissa ja toissijaisesti organisaation asetuksissa olevan maksuehdon perusteella (kuluva päivä + maksuehto)InvoiceDueDate
Kiinteästi ’Viivästyskorko’PaymentOverDueFineFreeText
Viivästyskorkoprosentti, ensisijaisesti asiakkaan laskutustiedoista ja toissijaisesti organisaation asetuksistaPaymentOverDueFinePercent

Laskurivin tiedot (InvoiceRow)

Maxtech-JÄRJESTELMÄN kenttäXML-ELEMENTTI
Tuotenumero (tuotteen tiedoista)ArticleIdentifier
Nimike (tuotteen tiedoista)ArticleName
Määrä (tapahtuman laskurivin tiedoista)InvoicedQuantity
Yksikkö (tuotteen tiedoista)InvoicedQuantity[QuantityUnitCode]
Veroton yksikköhinta (tapahtuman laskurivin tiedoista)UnitPriceAmount
Yksikköhinnan ja tuotteen veroprosentin perusteella laskettu verollinen hintaUnitPriceVatIncludedAmount
Rivin järjestysnumeroRowPositionIdentifier
Kommentti laskuriville (tuotteen tiedoista)RowFreeText
Alv% (tuotteen tiedoista)RowVatRatePercent
Kiinteästi ’S’ (normaali ALV-käsittely)RowVatCode
Laskurivin verojen määrä yhteensä (RowAmount-RowVatExcludedAmount)RowVatAmount
Laskurivin veroton kokonaishinta (InvoicedQuantity * UnitPriceAmount)RowVatExcludedAmount
Laskurivin verollinen kokonaishinta (InvoicedQuantity * UnitPriceVatIncludedAmount)RowAmount

ESS -> Maxtech: Lomien ja muiden poissaolotapahtumien siirron kuvaus

Tämä ohje koskee Maxtech Pro™ -palvelua. Maxtech Easy™ käyttäjille on olemassa erilliset ohjeet.

Olet mahdollisesti kiinnostunut myös tästä: Personec FK -palkka-aineistosiirto

Tämä toiminnallisuus kuuluu seuraaviin tuotteisiin ja vaatii toimiakseen seuraavat moduulit:

TUOTTEETMODUULIT
TES-tulkinta, lisäpalkkarivit ja palkka-aineistot™

Perustiedot

Tässä on kuvattu Maxtech Pro -järjestelmän ESS -> Maxtech loma- ja poissaolosiirron asetukset. Rajapinnan asetuksia voidaan muuttaa erilaisiksi asiakaskohtaisesti järjestelmän vientiasetuksilla. Kenttien järjestystä ei saa muuttaa.

Tuonnissa ei ole mukana tapahtuman kestoa, joten tapahtumat tuodaan järjestelmään koko päivän kestävinä tapahtumina ja kesto haetaan työntekijän työaikatiedoista järjestelmästä.

Tiedoston nimiSovitaan erikseen, tyypillisesti lomat_t.csv (tuntipalkkaiset), lomat_k.csv (kk-palkkaiset), poissaolot_t.csv (tuntipalkkaiset), poissaolot_k.csv (kk-palkkaiset)
Tiedonsiirtotapacsv-muotoiset tiedostot siirretään Maxtechin ylläpitämälle levynkulmapalvelimelle, josta ne luetaan ajastetusti järjestelmään
TiedostoformaattiCSV
Kenttien erotinmerkkipuolipiste (;)
MerkistöUTF-8
PäivämääräformaattiDD.MM.YYYYesimerkiksi: 23.02.2022
Desimaalierotinpilkku (,)
TuhaterotinEi käytössä
Kenttien otsikotKäytössä
Kenttien järjestysDynaaminen, vastaa otsikkoja

Rajapinnassa siirrettävät tiedot

  • Lomat ja poissaolot ja niiden päivämäärävälit henkiöittäin
  • Tapahtumien hyväksynnän tila ja ilmoituspäivämäärät
  • Poissaolojen syykoodit ja tekstimuotoiset nimet (esim. Sairauspoissaolo)

Lomat ja muut poissaolot

ESS-loma- ja poissaolosiirron formaatti on csv-tiedosto, jossa on header. Header sisältää kenttien nimet. Tässä esimerkkitiedostoja:

Lomat

Henkilonro;Alkupäivä;Loppupäivä;Ess-tila;Poissaolon ilmoitusaika;
10109;31.08.2022;02.09.2022;Hyväksytty;01.08.2022;

Poissaolot

Henkilonro;Alkupäivä;Loppupäivä;Poissaolos;Poissaolon syy;Ess-tila;Poissaolon ilmoitusaika;
10109;17.08.2022;18.08.2022;20;Sairausloma;Hyväksytty;17.08.2022;

Siirron ajastus

Lomat ja poissaolot siirretään csv-tiedostoina sovitulle levynkulmapalvelimelle (SFTP), josta ne luetaan ajastetusti eräajona, tyypillisesti kerran vuorokaudessa aamulla ennen työpäivän alkua, järjestelmään.

ESS:stä tuotujen tapahtumien muokkaaminen

Mikäli tulee tarve muokata ESS:stä tuotua tapahtumaa, täytyy toimia niin, että ensin vie tuodun tapahtuman roskakoriin sellaisenaan, ja sen jälkeen luo manuaalisesti uuden tapahtuman halutuilla muutoksilla. Tapahtumia ei saa poistaa roskakorista, koska muuten ESS tuo ne tapahtumat uudelleen.

Vientiasetukset

Vientiasetuksilla voidaan määritellä tiettyjä siirtoon liittyviä asioita. Itse viennin konfigurointi suoritetaan Maxtechin ylläpitäjien toimesta. Tässä listaus asioista, joihin asetuksilla voidaan vaikuttaa:

  • SFTP-kirjautumistiedot (palvelimen osoite, portti, käyttäjätunnus ja salasana)
  • Kansiot, joihin onnistuneesti / epäonnistuneesti siirretyt vientitiedostot siirretään sisäänluvun jälkeen
  • Poissaolotiedot sisältävän tiedoston tiedostonimi
  • Lomatiedot sisältävän tiedoston tiedostonimi
  • Aineiston poimintaväli, esim +-3kk ajohetkestä (aiemmin ESS:stä tuodut tapahtumat, joita ei löydy annetulla aikavälillä järjestelmästä, eikä ole aineistossa mukana, poistetaan)
  • Oletustapahtumatyyppi poissaoloille / lomille
  • Luoduissa poissaolo/lomatapahtumissa käytettävä Sisäinen viite
  • ESS-poissaolokoodeille voidaan määrittää vastaavuustaulukko, jonka perusteella poissaolokoodit tulkitaan tuonnissa halutuiksi tapahtumatyypeiksi. Mikäli koodille ei löydy taulukosta vastaavaa tapahtumatyyppiä, käytetään yllämainittua poissaolojen oletustapahtumatyyppiä

Personec FK: Palkka-aineistosiirto (kiinteämittaiset sarakkeet)

Tämä ohje koskee Maxtech Pro™ -palvelua. Maxtech Easy™ käyttäjille on olemassa erilliset ohjeet.

Palkka-aineistosiirtojen yleiset ohjeet

Lue täältä palkka-aineistosiirtojen yleiset ohjeet.

Olet mahdollisesti kiinnostunut myös tästä: ESS -> Maxtech Lomien ja muiden poissaolotapahtumien siirto

Tämä toiminnallisuus kuuluu seuraaviin tuotteisiin ja vaatii toimiakseen seuraavat moduulit:

Tuotteetmoduulit
TES-tulkinta, lisäpalkkarivit ja palkka-aineistot™

Perustiedot

Tässä on kuvattu Maxtech Pro -järjestelmän Personec FK -palkkasiirto (kiinteämittaisilla sarakkeilla). Erikseen on olemassa Personec W -palkkasiirto.

Tiedoston nimiYYYYMMDDhhmmss_personec.txt (esimerkiksi:20190605120146_personec.txt)
Järjestelmien välinen tiedonsiirtotapaTiedostopohjainen siirto, ladataan käyttäjän koneelle ja viedään manuaalisesti kohdejärjestelmään
TiedostoformaattiKiinteäpaikkainen tekstitiedosto
MerkistöISO-8859-1
PäivämääräformaattiYYYY.MM.DD (esim. 2019.12.24)
Kellonaikaformaattihh.mm.ss (esim. 14.32.02)
DesimaalierotinEi käytössä, luvut ilmoitetaan kerrottuna sadalla.
TuhaterotinEi käytössä
Kenttien otsikotEi käytössä
Kenttien järjestysKiinteä

Rajapinnassa siirrettävät tiedot

Tietueissa on kiinteästi arvot seuraavasti:

MerkitTieto
1-6Palkanlaskentayksikkö
7-18Henkilötunnus
19Palvelussuhteen tunnus
20-25Työaikaryhmä
26-29Palkka/työaikatekijäkoodi
30-49Lisätunnisteen tunnus
50-59Päivämäärä
60-67Kellonaika
68-77Alkupäivä
78-87Loppupäivä
88Muutoslaji
89Tietuelaji
90-Tietuelajin lisätiedot (katso tarkemmin Personec FK:n siirtotiedoston dokumentaatiosta)

Erityistä huomioitavaa

Siirtotiedoston merkit 90+ merkin ylittävältä osalta ovat tietuelajikohtaisia.

Käyttäjäoikeuksien suunnittelu

Yhtenäisiä käyttäjätunnuksia on helppo hallita. Hyvällä etukäteissuunnittelulla saavutetaan pitkällä aikajänteellä merkittävästi ajansäästöä ja helpotetaan hallintaa. Suunnittelun keskeisenä tavoitteena on hyvä pitää sitä, että profiileja muodostetaan käyttötarkoituksen mukainen vähimmäismäärä, jolla kyseisiä oikeuksia pystytään hallinnoimaan. Eli toisin sanoen mitä vähemmän eri variaatioita ja profiileja on, sen parempi.

Seuraava vaiheistus on tarkoitettu auttamaan organisaationne käyttäjätunnusten suunnittelussa.

Vaiheistus

Tunnista ja listaa organisaationne toimenkuvat ja roolit. Järjestelmän käyttäjäprofiilit muodostetaan myöhemmin näiden toimenkuvien ja roolien pohjalta. Alla esimerkkejä:

  • Työntekijät, esihenkilöt, työmaapäälliköt, palkanlaskijat, pääkäyttäjät jne.

Tunnista ja listaa rooleille tarpeelliset käyttötapaukset. Esimerkiksi:

  • Työntekijä: työtuntien ja äkillisten poissaolojen kirjaaminen, poissaolojen anominen, saldojen tarkastelu
  • Esihenkilö: työtuntien tarkastaminen ja hyväksyntä, poissaoloanomusten käsittely
  • Työmaamestari: työntekijätietojen ilmoittaminen verottajalle, työmaakäyntien hallinta, työmaan läsnäolotietojen tarkastelu
  • Palkanlaskija: palkkarivien tarkastaminen, palkka-aineiston toimittaminen palkanmaksuun
  • Pääkäyttäjä: organisaation yleisten asetusten ja henkilöstön tietojen hallinta

Tunnista ja listaa käyttötapausten tarvitsemat toiminnot. Esimerkiksi:

Lisää järjestelmään toimintoprofiilit. Nimeä toimintoprofiilit roolin mukaisesti, esimerkiksi ”Työntekijä”.

  • Työntekijä:
    • Työtuntien ja äkillisten poissaolojen kirjaaminen -> Tuntikirjaus
    • Poissaolojen anominen -> Poissaoloanomusten lähettäminen
    • Saldojen tarkastelu -> Saldoraportti (vain luku)
  • Esihenkilö:
    • Työtuntien tarkastaminen ja hyväksyntä -> Tuntiraportti
    • Poissaoloanomusten käsittely -> Poissaoloanomusten käsittely
  • Palkanlaskija:
    • Palkkarivien tarkastaminen -> Bruttopalkkaraportti
    • Palkka-aineiston toimittaminen palkanmaksuun-> Bruttopalkkaraportti
  • Työmaamestari:
    • Työntekijätietojen ilmoittaminen verottajalle -> Työntekijätiedot (verottajalle)
    • Työmaakäyntien hallinta -> Työmaakäynnit
    • Työmaan läsnäolotietojen tarkastelu -> Läsnäoloraportti
  • Pääkäyttäjä:
    • Organisaation yleisten asetusten ja henkilöstön hallinta -> Kaikki moduulit ja toiminnot

Tunnista ja listaa roolien tarvitsemat oikeudet sisältöön, kuten oikeudet yksiköihin, henkilöstöön ja asiakkaisiin, kohteisiin ja ajoneuvoihin.

Lisää järjestelmään tarvittavat sisältöprofiilit. Käytännössä näitä tarvitsevat esihenkilöt.

  • Työntekijä-tyyppinen käyttäjä, jonka tarvitsee nähdä vain omat kirjaukset ei tarvitse sisältöprofiilia.
  • Esihenkilö tarvitsee yleensä oikeuden alaistensa kirjauksiin, joten hänen sisältöprofiilille tulee sallia henkilöstöä tai antaa oikeus haluttuun yksikköön, mikäli organisaatiossa on yksikkörakenne käytössä.
  • Palkanlaskijalle sallitaan yleensä organisaation kaikki sisältö.
  • Pääkäyttäjälle useimmiten sallitaan organisaation kaikki sisältö.

Lisää tunnistettujen roolien mukaiset käyttäjäprofiilit. Esimerkiksi: Työntekijä, Esihenkilö, Pääkäyttäjä

  • Voit nimetä nämä vastaavasti kuin toimintoprofiilit ja valita niille tarvittavat oikeudet
  • Työntekijä: valitse sopiva toimintoprofiili, ja sopiva kirjausmalli määrittämään, miten käyttäjä voi kirjata tunteja
  • Esihenkilö: valitse sopiva toimintoprofiili ja sisältöprofiili, valitse sopiva kirjausmalli ja anna tarvittaessa hyväksyntäoikeudet (“peukutus”). Valitse, onko käyttäjällä oikeus palauttaa roskakoriin laitettuja tapahtumia ja sallitaanko kalenteritapahtumatyökaluja.
  • Pääkäyttäjä: valitse sopiva toimintoprofiili ja anna kaikki sisältöoikeudet. Anna tarvittaessa hyväksyntäoikeudet sekä oikeudet roskakorien hallintaan ja kalenteritapahtumatyökaluihin.

Liitä käyttäjäprofiilit halutuille käyttäjille Käyttäjät-sivulla.

  • Voit lisätä alla mainitut käyttäjäprofiilit kätevästi massamuokkauksella
  • Työntekijälle: Työntekijä-käyttäjäprofiili
  • Esihenkilölle: Esihenkilö-käyttäjäprofiili
  • Palkanlaskijalle: Palkanlaskija-käyttäjäprofiili
  • Pääkäyttäjille: Pääkäyttäjä-käyttäjäprofiili

Sisältöprofiilit

Maxtech Pro™

KÄYTTÄJÄTKÄYTTÄJÄPROFIILITTOIMINTOPROFIILITSISÄLTÖPROFIILIT

Sisältöprofiililla määritellään mihin sisältöön on oikeus.

Yleistä

Sisältöprofiili ei ole pakollinen käyttäjätunnuksen toimivuuden kannalta. Sisältöprofiilia voidaan käyttää, mikäli käyttäjän (esim. esihenkilö) tarvitsee nähdä omien kirjausten lisäksi myös muiden käyttäjien kirjaukset, tai jos käyttäjältä tulee rajata jotain muuta sisältöä pois. Sisältöprofiililla määritellään oikeuksia järjestelmässä oleviin sisältöihin, kuten henkilöstöön ja asiakkaisiin.

Käyttäjälle mahdollisesti asetettu oma henkilö on aina käyttäjälle sallittu, kaikista rajoituksista riippumatta.

Sisältöprofiilit-sivulla näkee kaikki organisaation sisältöprofiilit. Sisältöprofiilin nimi, mihin käyttäjäprofiileihin se on liitetty ja oikeuksien rajoitukset.

Yhdellä Käyttäjäprofiililla suositellaan käytettävän yhtä sisältöprofiilia, jotta hallinnointi olisi mahdollisimman yksinkertaista.


Sisältöprofiilin lisääminen

Anna sisältöprofiilille nimi sekä mahdolliset lisätiedot. Lisätietoihin voi kirjata esimerkiksi yksikön nimen, jolloin on helpompi hahmottaa mikä sisältöprofiili tulee valita, kun yksikköön tulee uusi esihenkilö.

Oikeudet

Oikeudet-sivulla voidaan valita tiettyjä sisältötyyppejä, joiden rivejä halutaan sallia tai estää. Sisältötyyppejä ovat: Henkilöstö, Yksiköt, Kohteet, Kalusto, Asiakkaat ja Asiakasluokat.

Jos sisältötyypille ei ole valittu sallittuja rivejä eikä asetusta “Estä kaikki nykyiset ja tulevat”, kaikki paitsi estetyiksi valitut rivit ovat sallittuja.

Jos sisältötyypille valitaan sallittuja rivejä, loput saman sisältötyypin riveistä estetään. (Huom! Vain estetyiksi valitut rivit estävät rivien näkymisen myös silloin, kun toinen yhtä aikaa käytössä oleva sisältöprofiili sallisi ne.)

Esimerkki:

  • ”Sisältöprofiili 1” sallii kaksi valittua henkilöä ja estää loput
  • ”Sisältöprofiili 2” sallii kaikki paitsi kaksi estetyksi valittua

Tässä tapauksessa käyttäjälle näkyy kaikki henkilöt pois lukien Sisältöprofiililla 2 estetyksi valitut.

Jos käytössä on useita sisältöprofiileja, estetään kaikki ne rivit ja sisältötyypit, jotka yksikään profiili estää. Jos jokin profiileista sallii jonkin sisältötyypin kaikki rivit, kaikki kyseisen sisältötyypin rivit sallitaan. Muutoin sisältötyyppien riveistä sallitaan kaikki ne, jotka niille on yhteensä valittu sallituksi kaikissa profiileissa.

Yksikkörajoitusten vaikutus sallittuihin henkilöihin ja kalustoon

Yksiköt rajoittavat henkilöitä, jos molemmat näistä ehdoista täyttyvät:

  • Yksittäisiä yksiköitä on valittu sallituksi
  • Kaikki paitsi mahdollisesti erikseen estetyt henkilöt ovat sallittuja

Ehtojen täyttyessä sallitaan kaikki sallituille yksiköille kuuluvat henkilöt, joita ei ole erikseen estetty, ja lisäksi “Tyhjä” henkilö sekä tapahtumien “Kuka tahansa” -henkilövalinta.

Yksiköt rajoittavat vastaavasti kalustoa, jos samat ehdot täyttyvät vastaavasti yksiköille ja kalustolle. Tällöin sallitaan kaikki sallituille yksiköille kuuluva kalusto, paitsi erikseen estetyt rivit, ja “Tyhjä” kalusto.

Alla olevassa esimerkissä sallitaan yksikkö X:ään liittyvät sisällöt.


Salli kaikki paitsi estetyt

Tämän voi valita esimerkiksi, jos halutaan sallia kaikki muut paitsi erikseen estetyt.


Estä kaikki nykyiset ja tulevat

Estää sisältötyypiltä kaikki muut paitsi ”Tyhjät”.

Esimerkki: esihenkilön pitää nähdä henkilöiden tuntikirjaukset, mutta ei ajotapahtumia.


Salli sisällön lisääminen ja sisältöoikeuksien laajeneminen

Asetus tuo käyttäjälle näkyviin Lisää-painikkeen esimerkiksi sisältötyypin hallintasivulle. Mikäli tätä ei ole sallittu, niin sallitut rivit näkyvät ja niitä voi muokata, mutta uusia ei voi lisätä.


Asiakasluokkien vaikutus sallittuihin asiakkaisiin ja kohteisiin

a) Jos kaikki asiakasluokat paitsi mahdollisesti erikseen estetyt ovat sallittuja, ja organisaatiossa on vähintään yksi asiakasluokka:

  • Kaikki paitsi mahdollisesti erikseen estetyt asiakkaat ja kohteet ovat sallittuja
  • “Tyhjä” asiakas ja “Tyhjä” kohde ovat sallittuja

b) Jos jotkut erikseen valitut asiakasluokat ovat sallittuja, ja sallittuja asiakkaita ei ole erikseen valittu, eikä kaikkia ole estetty asetuksella “Estä kaikki nykyiset ja tulevat”:

  • Kaikki sallituille asiakasluokille kuuluvat asiakkaat ovat sallittuja, paitsi erikseen estetyt
  • Jos yksikin asiakas sallittiin tällä perusteella, sallitaan myös “Tyhjä” asiakas

Jos yllä oleva salli yhdenkin asiakkaan ja sallittuja kohteita ei ole erikseen valittu, eikä kaikkia ole estetty asetuksella “Estä kaikki nykyiset ja tulevat”:

  • Sallitaan kaikki sallituille asiakkaille kuuluvat kohteet, paitsi erikseen estetyt
  • Jos yksikin kohde sallittiin tällä perusteella, sallitaan myös “Tyhjä” kohde

Poikkeuksen tähän muodostaa organisaatioasetus “Rajoita käyttäjäoikeuksia kohteisiin yksikön perusteella”. Jos se on päällä, näitä ei noudateta.

Toimintoprofiilit

Maxtech Pro™

KÄYTTÄJÄTKÄYTTÄJÄPROFIILITTOIMINTOPROFIILITSISÄLTÖPROFIILIT

Toimintoprofiililla määritellään käyttäjälle näytettävät toiminnot.

Yleistä

Toimintoprofiilit-sivulla näkee kaikki organisaation toimintoprofiilit. Toimintoprofiilin nimi, mihin käyttäjäprofiileihin se on liitetty, käyttöliittymien käyttöoikeudet, valitut moduulit sekä toiminnot.


Toimintoprofiilin lisääminen

Yleiset

Klikkaa Lisää-painiketta ja anna nimi, haluamasi lisätiedot ja käyttöliittymien käyttöoikeudet. Mikäli toimintoprofiililla sallitaan web-käyttöliittymä käyttö, niin Web-käyttöliittymän toiminnot -välilehdellä määritetään valikkorakenne. Mikäli sallittuna on vain mobiilikäyttöliittymä ei Käyttöliittymien käyttöoikeudet -kenttään tarvitse valita mitään.

Moduulit

Moduuleilla voidaan määrittää, mitkä ominaisuudet ovat käytössä web-järjestelmässä ja mobiilisovelluksella. Esimerkki:

  1. Käyttäjälle halutaan näkymään web-järjestelmän Raportit > Tuntiraportti: aktivoi Tuntiraportti-moduuli sekä Toiminnot-välilehdeltä Tuntiraportti.
  2. Käyttäjälle halutaan näkymään mobiilisovelluksessa tuntikirjaus: aktivoi Tuntikirjaus (mobiili) -moduuli.

Kaikki moduulit, joiden lopussa lukee “(mobiili)”, vaikuttavat mobiilisovellukseen.

Toiminnot

Toiminnot määrittävät web-järjestelmän päävalikon rakenteen. Lisäksi joillekin toiminnoille voidaan valita vain lukuoikeudet, jolloin niissä voidaan vain lukea tietoa, mutta ei muokata.

Käyttäjäprofiilit

Maxtech Pro™

KÄYTTÄJÄTKÄYTTÄJÄPROFIILIT TOIMINTOPROFIILITSISÄLTÖPROFIILIT

Käyttäjäprofiili sisältää toiminto- ja sisältöprofiilit sekä muita asetuksia. Käyttäjäprofiilille pitää aina valita toimintoprofiili, jotta käyttäjätunnus toimii. Sisältöprofiili ei ole pakollinen, mikäli käyttäjän tarvitsee nähdä vain omat tapahtumat.

Yleistä

Käyttäjäprofiilit-sivulla näkyvät kaikki organisaation käyttäjäprofiilit. Taulukosta näet kunkin käyttäjäprofiilin nimen, ne käyttäjät, joilla kyseinen profiili on käytössä, sekä siihen sisältyvät toiminto- ja sisältöprofiilit.


Käyttäjällä voi olla useampi käyttäjäprofiili, jota hän voi vaihtaa sivun vasemmasta alakulmasta.

Käyttäjällä voi olla myös oikeudet useampaan organisaatioon, jolloin organisaation vaihtaminen onnistuu myös sivun vasemmasta alakulmasta. Mikäli käyttäjälle on tarvetta antaa oikeudet useampaan organisaatioon, olethan yhteydessä Maxtechin tukeen tuki@maxtech.fi tai soittamalla p. 010 229 6200 (arkisin 8-16).


Käyttäjäprofiilin lisääminen

Klikkaa Lisää-painiketta ja anna käyttäjäprofiilille nimi

Oikeudet-välilehti

Käyttäjäprofiilille valitaan mitkä toiminto- ja sisältöprofiilit sekä kirjausmallit ovat käytössä. Näkymä voi vaihdella organisaatiossa käytössä olevien tuotteiden mukaan. Huomioi, että kaikki kentät eivät suinkaan ole pakollisia ja oletuksena ei ole oikeuksia (kenttään ei ole valittu mitään).

Kenttämerkitys
Käyttäjällä on vain lukuoikeudet järjestelmäänKäyttäjäprofiililla on vain lukuoikeus järjestelmän tietoihin, mikäli tämä on määritelty Kyllä-asentoon.
ToimintoprofiilitValitse mitkä toimintoprofiilit käyttäjäprofiililla on käytössä. Kenttä on pakollinen.
Pikaoikeudet sisältöönHenkilökohtainen käyttöoikeus – käyttäjälle asetettu oma henkilö on aina käyttäjälle sallittu.
Henkilöstön esihenkilömäärityksiin perustuvat oikeudet – sallii oikeudet kaikkiin henkilöihin joiden esimies käyttäjälle asetettu henkilö on. (Hallinta > Henkilöstö > lisää/muokkaa > Yleiset-välilehti > Oma esimies -kenttä)
Henkilöstöryhmän esihenkilömäärityksiin perustuvat oikeudet – sallii oikeudet kaikkiin henkilöihin jotka kuuluvat henkilöstöryhmään, jonka esimies käyttäjälle asetettu henkilö on. (Hallinta > Henkilöstö > Henkilöstöryhmät > lisää/muokkaa > Ryhmän esihenkilöt)
Yksiköiden esihenkilömäärityksiin perustuvat oikeudet – sallii oikeudet tyhjään ja kaikkiin niihin yksiköihin joiden esihenkilö käyttäjälle asetettu henkilö on sekä henkilöihin ja ajoneuvoihin, jotka kuuluvat kyseisiin yksiköihin.
(Hallinta > Henkilöstö > Yksiköt > lisää/muokkaa > Yksikön esimiehet)
SisältöprofiilitValitse mitkä sisältöprofiilit käyttäjäprofiililla on käytössä. Huom! Tämä kenttä ei ole pakollinen
Sallitut tapahtumailmoitusmallitVoidaan määrittää mitkä tapahtumailmoitusmallit käyttäjäprofiililla on käytössä. Mikäli mitään ei ole valittuna niin kaikki tapahtumailmoitusmallit ovat sallittuja.
Sallitut näkymäasetuksetVoidaan määrittää mitkä näkymäasetukset käyttäjäprofiililla on käytössä. Mikäli mitään ei ole valittuna niin kaikki näkymäasetukset ovat sallittuja.
Tapahtumien kirjaus- ja muutosoikeudetVoidaan määrittää onko tapahtumien lukitseminen ja avaaminen sallittua. Sallitaanko muuttaa tapahtumien tilaa (pyydetty, suunniteltu, toteutunut). Voiko nähdä valmistelussa olevia tapahtumia.
Tapahtumien hyväksyntäoikeudetVoidaan määrittää, millä tasolla käyttäjäprofiili voi hyväksyä tapahtumia
Roskakorien hallintaoikeudetVoidaan määrittää roskakorien näkyminen käyttäjällä, tapahtumien roskakori sekä hallintatietojen roskakori.
KalenteritapahtumatyökalutVoidaan määrittää näkyvätkö Lisää poissaolo- ja Lisää useita tapahtumia -toiminnot
Näytä työparit mobiilityövuorolistallaAsetus vaikuttaa Maxtech-mobiilisovelluksen työvuorolistaan. Työvuorolistalla näytetään samassa vuorossa olevien henkilöiden nimet.
Oikeus siirtää ylityöt työaikaliukumaan / maksuunVoiko käyttäjä merkitä tapahtumille ohjaustiedon, jolla ylityöt siirretään työaikaliukumaan tai maksuun
Oikeus vain käyttäjälle kuuluvan henkilön matkalaskuihinNäkeekö käyttäjä vain käyttäjätunnukselle määritellyn henkilön matkalaskut

Asetukset-välilehti

Asetukset-välilehdellä voidaan määrittää oletussuodattimia sekä kirjauksiin liittyviä rajoituksia.

Kenttämerkitys
Oletussivu kirjautumisen jälkeenVoidaan määrittää mikä sivu käyttäjälle näytetään kirjautumisen jälkeen. Jos muu kuin tyhjä on valittu, ohjataan käyttäjä web-järjestelmään kirjautuessa etusivun sijaan valittuun näkymään. Jos käyttäjän käyttäjäoikeudet eivät salli kyseisen näkymän avaamista, ohjataan hänet etusivulle ja näytetään virheilmoitus oletusnäkymän oikeuksista.
OletuskirjausmalliVoidaan valita käyttäjille oletuskirjausmalli, joka tallennetaan tapahtumalle mikäli muuta ei ole määritelty.
Piilota valikkoPiilottaa vasemmassa reunassa olevan päävalikon
Rajoita tulevien ja menneiden tietojen näkyvyyttäVoidaan rajoittaa menneiden ja tulevien tapahtumien näkyvyyttä päivillä tai kalenteriviikoilla.
OletussuodattimetVoidaan määrittää oletussuodattimet, jotka ovat valittuna kun käyttäjä kirjautuu järjestelmään

Käyttäjät

Maxtech Pro™

KÄYTTÄJÄTKÄYTTÄJÄPROFIILITTOIMINTOPROFIILITSISÄLTÖPROFIILIT

Käyttäjätunnuksella kirjaudutaan Maxtech web- ja mobiilikäyttöliittymään. Käyttäjään yhdistyy käyttäjäprofiili, joka sisältää toiminto- sekä mahdollisesti sisältöprofiilit.


Yleistä

Käyttäjät-sivulla näkyy kaikki organisaation käyttäjät. Näkymää voidaan suodattaa tunnuksien tilan, käyttäjätyypin ja käyttäjäprofiilin mukaan. Sivulla määritellään käyttäjätunnuksen yleiset tiedot, kirjautumiseen liittyvät asetukset sekä muutamia yksittäisiä oikeuksia.

Taulukosta näkee käyttäjätunnuksen, nimen, käyttäjätyypin, käyttäjälle kuuluvan henkilön, käyttäjätunnuksen sähköpostiosoitteen, käyttäjälle valitut käyttäjäprofiilit, käyttäjän tilan sekä viimeisimmän muokkaushetken.

HUOM! Käyttäjätunnuksella voi näkyä myös tieto, että käyttäjällä on käyttöoikeudet useisiin organisaatioihin. Mikäli käyttäjälle on tarvetta antaa oikeudet useampaan organisaatioon, olethan yhteydessä Maxtechin tukeen tuki@maxtech.fi tai soittamalla p. 010 229 6200 (arkisin 8-16).

Salasanan vaihtamislinkin lähettäminen

Voit lähettää käyttäjälle/käyttäjille salasanan vaihtamislinkin määriteltyihin sähköpostiosoitteisiin valitsemalla käyttäjätunnukset ja klikkaamalla Lähetä salasanan vaihtamislinkki sähköpostiin -painiketta. Salasanan vaihtamislinkki on voimassa 72h. Mikäli aikaikkuna ehtii umpeutua, voi käyttäjä tilata uuden linkin pro.maxtech.fi sivulta. Tarkistathan, että sähköpostiosoite on toimiva ennen kuin lähetät salasanan vaihtamislinkin.

Käyttäjän lisääminen

Käyttäjiä voidaan lisätä kolmesta paikasta (A, B tai C):

A) Toiminnossa Hallinta > Käyttäjäoikeudet > Käyttäjät > Lisää-painiketta klikkaamalla

Käyttäjät sivulta lisääminen

B) Toiminnossa Hallinta > Henkilöstö > Käyttäjäoikeudet-sarakkeessa olevaa lisäys-painiketta klikkaamalla

C) Toiminnossa Hallinta > Henkilöstö > profiilikäyttäjätunnusten massalisäyksen kautta

Toiminnallisuus lyhykäisyydessään: valitse henkilöt kenelle haluat luoda käyttäjätunnuksen ja klikkaa sivun alareunasta  Lisää profiilikäyttäjät -painiketta. Valitse käyttäjäprofiili sekä lähetetäänkö salasanan asetuslinkki. Voit halutessasi määrittää milloin käyttöoikeus alkaa / päättyy > klikkaa lopuksi Lisää profiilikäyttäjät -painiketta.


Käyttäjätiedot, henkilötiedot ja oikeudet

  1. Kirjoita käyttäjätunnus (suosittelemme käyttämään sähköpostiosoitetta)
  2. Valitse lähetetäänkö tallennuksen yhteydessä käyttäjän sähköpostiin linkki salasanan vaihtamiseksi
  3. Valitse tarvittaessa salasanan vanhenemispäivä
  4. Valitse tarvittaessa salasanan automaattinen vanhenemispäivä
  5. Kaksivaiheinen kirjautuminen: käyttäjän puhelinnumeroon lähetetään varmennenumero, joka syötetään kirjautumisen yhteydessä
  6. Valitse käyttäjätyyppi (pää- tai profiilikäyttäjä)
  7. Valitse Käyttäjäprofiili (mikäli useita niin valitse myös oletus-käyttäjäprofiili)
  8. Valitse henkilö kenelle käyttäjätunnus kuuluu > kenttien tiedot haetaan henkilölle tallennetuista tiedoista automaattisesti. Käyttäjällä on automaattisesti oikeus valittuun henkilöön ja henkilön tapahtumiin.
  9. Valitse saako käyttäjä lisätä/muokata käyttäjätunnuksia (näkyy mikäli käyttäjätyyppi on pääkäyttäjä)
  10. Saako käyttäjä hallita sivu- ja näkymäkohtaisia ohjeita (käyttäjän kirjoittamat ohjeet näkyvät kaikille organisaation käyttäjille)
  11. Tilin käyttöoikeuden voi tarvittaessa rajata antamalla aloitus- ja lopetuspäivämäärät.

Netvisor: Laskutusaineistosiirto

Tämä ohje koskee Maxtech Pro™ -palvelua. Maxtech Easy™ käyttäjille on olemassa erilliset ohjeet.

Tämä toiminnallisuus kuuluu seuraaviin tuotteisiin ja vaatii toimiakseen seuraavat moduulit:

TUOTTEETmoduulit
Laskutusrivit, -aineistot ja kateraportti™

Perustiedot

Tiedoston nimiN/A (palvelujen välinen tiedonsiirto)
Järjestelmien välinen tiedonsiirtotapaPalvelujen välinen tiedonsiirto
Tiedostoformaattixml
MerkistöUTF-8
PäivämääräformaattiYYYY-MM-DD (esimerkiksi: 2022-06-22)
Desimaalierotinpiste (.)
TuhaterotinEi käytössä

Rajapinnassa siirrettävät tiedot

Laskun tiedot (SalesInvoice)

Maxtech-JÄRJESTELMÄN kenttäXML-ELEMENTTI
Kuluva päiväSalesInvoiceDate
Laskun summa (brutto)SalesInvoiceAmount
Vaihtoehtoinen myyjän nimi, asetettavana laskutusdialogissa, ei siirretä jos tyhjäSellerName
Viennin tyyppi, valittavana laskutusdialogissa, myyntilasku (invoice) / myyntitilaus (order)InvoiceType
Jos viennin tyypiksi on valittu myyntilasku, ’unsent’, muuten ’undelivered’SalesInvoiceStatus
Laskua koskevat Työnumerot pilkulla eroteltuina.
Mikäli dialogissa on valittuna Lisää tapahtumien ajankohta laskulle lisätiedoksi, myös työskentelyn ajankohta (ensimmäisen ja viimeisen tapahtuman pvm:t).
Mikäli tapahtumaan liitetylle Työlle on asetettu Yhteyshenkilö (laskulla) (Työ -> Laskutus-välilehti), lisätään myös se omalle rivilleen
SalesInvoiceFreeTextBeforeLines
Viitteemme (kaikki arvot Asiakkaan ja Töiden takaa), pilkulla eroteltuinaSalesInvoiceOurReference
Viitteenne (kaikki arvot Asiakkaan ja Töiden takaa), pilkulla eroteltuinaSalesInvoiceYourReference
Asiakkaan asiakasnroInvoicingCustomerIdentifier
Toimitusasiakkaan tiedot, lisätään mikäli tapahtumaan liitetyn Työn takana on asetettu Käytä erillisiä toimitusasiakkaan tietoja (Työ -> Seurantatasot-välilehti). Toimitusosoitetiedot voidaan syöttää käsin suoraan Työn taakse tai käyttää valitun toimitusasiakkaan osoitetietoja.DeliveryAddressName
DeliveryAddressLine
DeliveryAddressPostNumber
DeliveryAddressTown
Kiinteästi 14PaymentTermNetDays
Ulkoinen tilausnumero, lisätään mikäli tapahtumaan liitetyn Työn takana on asetettu Ulkoinen tilausnumero (laskulla) (Työ -> Laskutus-välilehti)OrderNumber

Laskurivin tiedot (InvoiceLines -> InvoiceLine)

Mikäli asiakkaan asetuksissa on määritelty Laskutuslisä (tuote), lisätään jokaiselle laskulle laskurivi, jolla 1kpl määriteltyä tuotetta.

Maxtech-JÄRJESTELMÄN kenttäXML-ELEMENTTI
Tuotenumero (tuotteen tiedoista)ProductIdentifier
Nimike (tuotteen tiedoista)ProductName
Veroton yksikköhinta (tuotteen tiedoista)ProductUnitPrice
Alv% (tuotteen tiedoista)ProductVatPercentage
Määrä (tapahtuman laskutusrivin tiedoista)SalesInvoiceProductLineQuantity
Kommentti (tuotteen tiedoista)SalesInvoiceProductLineFreeText
Kirjanpidon verollinen myyntitili (tuotteen tiedoista, ei viedä jos tyhjä)accountingaccountsuggestion
Seurantatasot laskutusdialogin valintojen mukaan (DimensionName ja DimensionItem per dimensio)Dimension -> DimensionName ja DimensionItem
Kuvaus (tuotteen tiedoista), sekä valinnaiset, vientidialogissa valittavat tiedot, ks. kuva allaInvoiceLine -> SalesInvoiceCommentLine -> Comment

Tietojen synkronointi

Viennin yhteydessä on mahdollista synkronoida asiakkaiden ja tuotteiden tietoja Maxtechistä Netvisoriin vientidialogin valinnalla:

Asiakkailta synkronoidaan seuraavat tiedot:

Synkronoitava tietueMAXTECH-JÄRJESTELMÄN KENTTÄ
customerbaseinformation:
internalidentifierAsiakasnumero (tämän perusteella tarkistetaan, päivitetäänkö olemassaolevan asiakkaan tiedot vai perustetaanko uusi)
externalidentifierY-tunnus
nameAsiakkaan nimi (tai laskutusasiakkaan, mikäli käytetään erillisiä laskutusasiakkaan tietoja)
nameextensionAsiakkaan / laskutusasiakkaan nimitarkenne
streetaddressAsiakkaan / laskutusasiakkaan katuosoite
cityAsiakkaan / laskutusasiakkaan postitoimipaikka
postnumberAsiakkaan / laskutusasiakkaan postinumero
phonenumberMatkapuhelin
emailSähköpostiosoite
homepageuriWww-sivu
customerfinvoicedetails:(mikäli Sähköisen laskutuksen ovt-tunnus / välittäjätunnus asetettu)
finvoiceaddressSähköisen laskutuksen ovt-tunnus
finvoiceroutercodeSähköisen laskutuksen välittäjätunnus
customerdeliverydetails:(mikäli Käytä erillisiä toimitusasiakkaan tietoja on valittu)
deliverynameToimitusasiakas + Toimitusasiakkaan tarkenne
deliverystreetaddressToimitusosoitteen katuosoite
deliverycityToimitusosoitteen postitoimipaikka
deliverypostnumberToimitusosoitteen postinumero
customercontactdetails:
contactpersonYhteyshenkilö
contactpersonemailYhteyshenkilön email-osoite
contactpersonphoneYhteyshenkilön puhelin

Tuotteilta synkronoidaan seuraavat tiedot:

Synkronoitava tietueMAXTECH-JÄRJESTELMÄN KENTTÄ
productbaseinformation:
productcodeTuotenumero (tämän perusteella tarkistetaan, päivitetäänkö olemassaolevan tuotteen tiedot vai perustetaanko uusi)
productgroupTuoteryhmän numero
nameNimike
unitpriceÁ-hinta
unitYksikkö
purchasepriceHankintahinta
isactiveKiinteästi ’1’
issalesproductKiinteästi ’0’
productbookkeepingdetails:
defaultvatpercentageAlv%

Netvisorin hintakertoimien ja asiakashintojen huomioiminen

Viennissä on mahdollista käyttää myös Netvisor-hinnoittelua valitsemalla vientidialogissa ”Käytä Netvisorin tuotehinnoittelua nollahintaisille tuotteille”. Mikäli valinta on valittuna, kaikille nollahintaisille laskutusriveille käytetään Netvisorin hintakertoimia ja asiakashinnoittelua.

Heeros: Palkka-aineistosiirto

Tämä ohje koskee Maxtech Pro™ -palvelua. Maxtech Easy™ käyttäjille on olemassa erilliset ohjeet.

Palkka-aineistosiirtojen yleiset ohjeet

Lue täältä palkka-aineistosiirtojen yleiset ohjeet.

Tämä toiminnallisuus kuuluu seuraaviin tuotteisiin ja vaatii toimiakseen seuraavat moduulit:

TUOTTEETmoduulit
TES-tulkinta, lisäpalkkarivit ja palkka-aineistot™

Perustiedot

Tiedoston nimiYYYYMMDDhhmmss_schema.csv (esimerkiksi: 20220804120146_schema.csv)
Tiedostonimi voidaan muodostaa tarpeiden mukaiseksi vientiasetuksilla.
Järjestelmien välinen tiedonsiirtotapaTiedostopohjainen siirto, ladataan käyttäjän koneelle ja viedään manuaalisesti kohdejärjestelmään. Voidaan myös lähettää suoraan sähköpostilla tai konfiguroida sftp-suorasiirto kohdepalvelimeen.
TiedostoformaattiKiinteäpaikkainen csv-formaatti
CSV-kenttien erotinpuolipiste (;)
MerkistöUTF-8
Desimaalierotinpiste (.)
TuhaterotinEi käytössä
Kenttien otsikotKäytössä
Kenttien järjestysKiinteä

Siirtotiedoston kuvaus

Sarakearvo / Maxtech-JÄRJESTELMÄN kenttäKohdejärjestelmän kenttä
A *)HenkilönumeroHlo
B *)Schema-palkkalajinumeroLaji
C *)Palkkarivin tunnit / kplLkm
DPalkkarivin á-hintaA-hinta
EPalkkarivin kerroinProsentti
FTyön numeroProj
GKustannuspaikan numeroKustannuspaikka
HPalkkarivin summaYhteensä
IHakuaikavälin alkupvm, muodossa YYYYMM (esimerkiksi 202208)Kausi

*) Pakollinen kenttä, muita kenttiä voidaan jättää aineistosta pois konfiguroimalla vientiasetuksia