Visma Fivaldi Rajapinnat

Transkriptio

1 Visma Fivaldi Rajapinnat

2 Sisällys 1 Yleistä Visma Fivaldin rajapinnoista Muut aiheeseen liittyvät käsikirjat XML- siirrot CSV-tiedostojen siirrot: Reskontrasiirrot Tositteiden tuonti kirjanpitoon XML-siirto XML-siirron käyttöönotto Manuaalinen siirto Automatisoitu siirto Esimerkkejä CSV-siirto Yleistä Käyttöoikeuksien määrittely Palvelunhallinnassa Mallitiedostojen luonti Siirtotiedostojen täyttämisessä huomioitavaa Yritysrekisterin kentät Tuoterekisterin kentät Budjettien tuonnin kentät Palkansaajien tuonnin kentät Palkkatietojen tuonnin kentät Visma Expense -matkalaskujärjestelmän aineiston tuonti CSV-tiedoston lataus Yritys-/tuorerekisterin ulosvienti Reskontrasiirrot Myyntireskontra Ostoreskontra Esimerkkitiedostot Reskontratietojen tuonti Tuontiaineiston perustiedot ja sisäänluku Tositteiden tuonti kirjanpitoon Tositteiden luku Fivaldi kirjanpitoon Tiedon vienti Exceliin Visma Fivaldi 2

3 1 Yleistä Visma Fivaldin rajapinnoista Visma Fivaldin rajapinnat mahdollistavat tiedon sisäänluvun ulkopuolisista järjestelmistä (esim. nettikaupat, tilausjärjestelmät, toiminnanohjausjärjestelmät, työajanseurantajärjestelmät jne.) sekä tiedon ulosviemisen CSV- ja XML-muodoissa. Tietoja voidaan siirtää järjestelmien välillä automatisoidusti (XML) tai lkäyttäjän manuaalisesti tekemänä (XML, CSV, TXT). Web service interface -rajapinta kuvataan erillisessä dokumentissa. Rajapintojen tarkoituksena on tehostaa informaatiokulkua kahden tai useamman eri järjestelmän välillä. Jotta voidaan varmistaa, että aineistot siirtyvät ja tallentuvat järjestelmään halutulla tavalla, suosittelemme että rajapinnat otetaan käyttöön aina yhdessä konsulttimme kanssa. Huomioi kuitenkin, että Visma Fivaldin konsultit eivät voi auttaa varsinaisen aineiston muodostamisessa, aineistot pitää aina tehdä itse tai saada kolmannelta osapuolelta. Konsultoinnin tilauslomakkeen löydät täältä, mutta halutessasi konsultointia voi tilata myös suoraan Visma Fivaldin myynnistä. 1.1 Muut aiheeseen liittyvät käsikirjat Visma Fivaldi Web Services -rajapinnat Visma Payroll -aineistojen tuonti Visma Fivaldiin 1.2 XML- siirrot Sekä Visma Fivaldin Web-puolen XML-rajapinnan (ylävalikosta Muut > Rajapinnat) että IP-rajapinnan kautta voidaan siirtää seuraavat XML-aineistot: myyntitilaukset (sisäänluku ja ulosvienti) yritysrekisteri (asiakkaat ja toimittajat) (sisäänluku ja ulosvienti) tuoterekisteri (sisäänluku ja ulosvienti) palkanlaskennan tapahtumat (sisäänluku) kiinteistöhallinnon tiedot (ulosvienti) Vain IP-rajapinnan ylitse voidaan edellisten lisäksi hakea seuraavat XML-aineistot: myyntihistoria kirjanpidon kaikki viennit projektin/seurantakohteen tapahtumat kirjanpidossa XML-siirrot on kuvattu tarkemmin luvussa CSV-tiedostojen siirrot: CSV-tiedoston lataus -sovelluksella (Visma Fivaldin Java-puolella Muut > Rajapinnat - CSV-tiedoston lataus) voidaan siirtää: tuoterekisteri (sisäänluku ja ulosvienti) yritysrekisteri (asiakkaat ja toimittajat) (sisäänluku ja ulosvienti) kirjanpidon talousarviot (sisäänluku ja ulosvienti) Visma Fivaldi 3

4 palkanlaskennan tapahtumat (sisäänluku) palkansaajat (sisäänluku) CSV-siirrot on kuvattu tarkemmin luvussa Reskontrasiirrot Myyntireskontra tietojen tuonti -toiminnolla (Visma Fivaldin Java-puolella Muut > Rajapinnat - Myyntireskontra tietojen tuonti) voidaan tuoda: myyntireskontraan laskut/saldot (toisella järjestelmällä laskutetut laskut) Ostoreskontra tietojen tuonti -toiminnolla (Visma Fivaldin Java-puolella Muut > Ostoreskontra tietojen tuonti) voidaan tuoda: ostoreskontraan laskut/saldot Reskontrasiirrot on kuvattu tarkemmin luvussa Tositteiden tuonti kirjanpitoon Kirjanpidon Tositteiden tuonti kirjanpitoon -toiminnolla (Visma Fivaldin Java-puolella Taloushallinto > Kirjanpito, sitten ylävalikosta Kirjanpito > Tositteiden tuonti kirjanpitoon) voidaan tuoda: viennit/tositteet Fivaldi kirjanpitoon Kirjanpidon Tiedon vienti -toiminnolla (Visma Fivaldin Java-puolella Taloushallinto > Kirjanpito, sitten ylävalikosta Kirjanpito > Tiedon vienti) voidaan siirtää CSV-muodossa: kaikki viennit tositteittain Fivaldi kirjanpidosta kaikki viennit tileittäin Fivaldi kirjanpidosta Tositteiden tuonti kirjanpitoon on kuvattu tarkemmin luvussa Visma Fivaldi 4

5 2 XML-siirto XML-rajapintoihin liittyvä skeema löytyy osoitteesta XML-siirron käyttöönotto Etukäteisvalmistelut, manuaalinen siirto selaimesta Ympäristön pääkäyttäjä tilaa XML-rajapinnan Visma Fivaldin myynnistä / tilitoimistolta. XML-rajapinnan tilauksen yhteydessä voi tilata asiantuntijan tekemään ympäristöön tarvittavat määrittelyt. Tämä kannattaa mainita tilauksen yhteydessä. Konsultoinnin tilauslomake löytyy myös täältä. Visma avaa sovellukset halutulle käyttäjämäärälle Etukäteisvalmistelut, automatisoitu siirto Ympäristön pääkäyttäjä tilaa XML-rajapinnan Visma Fivaldin myynnistä / tilitoimistolta. XML-rajapinnan tilauksen yhteydessä voi tilata asiantuntijan tekemään ympäristöön tarvittavat määrittelyt. Tämä kannattaa mainita tilauksen yhteydessä. Konsultoinnin tilauslomake löytyy myös täältä. Visma avaa sovellukset halutulle käyttäjämäärälle. Visma toimittaa vain tätä yhteyttä varten uuden käyttäjätunnuksen. Käyttäjätunnusta ei tule käyttää muuhun tarkoitukseen. Käyttöönottajan yhteyshenkilö toimittaa lähettävän sovelluksen kiinteän IP-osoitteen Vismalle yhteyden avaamista varten. Siirrossa tarvittava skeemanumero: Siirry vapaavalintaiselle raportille (esim. Taloushallinnon raportti Pääkirja) siinä yrityksessä, johon tietoja lähetetään tai haetaan. Katso selaimen osoitekentästä allaolevaan kuvaan keltaisella merkitty kohta. Kyseessä on siirrossa käytettävä skeemanumero. Alla olevan kuvan esimerkissä skeemanumero on fv005. Tiedoston automatisoitu siirto muualta Fivaldiin on selitetty tarkemmin luvussa 2.3.1, ja Fivaldista muualle luvussa Käyttöoikeuksien avaaminen Ympäristön pääkäyttäjä avaa siirtoa varten uuden käyttäjätunnuksen sekä antaa tunnukselle tarvittavat käyttöoikeudet Palvelunhallinnassa. Kaikkiin siirrettäviin aineistoihin liittyviin sovelluksiin annetaan käyttö-, muutos- ja lisäysoikeudet. Oikeudet, jotka tulee lisätä rajapintaa varten luodulle käyttäjätunnukselle: Web-sovellukset: XML-aineiston muodostus Visma Fivaldi 5

6 XML-aineiston sisäänluku XML-siirtojen listaus XML-siirtojen perustiedot Rekisterit: Yritysrekisteri Tuoterekisteri Yrityksen perustiedot Sovellukset: Tilaustenkäsittely Palkanlaskenta Varastonhallinta (mikäli päivitetään varastosaldoja) Visma Fivaldi 6

7 2.1.4 XML-siirtojen perustietojen määritys Avaa määritysnäkymä valitsemalla Fivaldi Webin puolella Muut > XML-siirtojen perustiedot. Avautuvassa näkymässä tulee tehdä valinnat jokaiseen neljään kohtaan (Yritysrekisteri, Tuoterekisteri, Myyntitilaukset, Palkkatapahtumat) ja tallentaa muutokset, vaikka aikoisit siirtää tietoja vain tuoterekisteriin. Tällöin asetukset tallentuvat oikein Visma Fivaldi 7

8 Yritysrekisteri-kohdan määritykset: Lisää uudet tietueet (ei päivitystä) o Käyttötapa: Uudet asiakkaat tuodaan aina aineiston kautta Fivaldiin. o Kaikki aineiston sisältämät arvot tuodaan uuden asiakkaan luonnissa yritysrekisteriin. o Ylläpito voi tapahtua ensimmäisen aineistotuonnin jälkeen suoraan Fivaldissa tai uusien tietojen osalta aineistosta. HUOM. Tämä vaihtoehto aiheuttaa ongelman, jos asiakkaita luodaan Fivaldiin manuaalisesti ja jos aineistot eivät kata kaikkia tarpeellisia tietoja (esim. asiakkaan verkkolaskuosoitteita). Silloin käy niin, että manuaalisesti perustetun asiakkaan osalta, ensimmäisellä tuontikerralla tyhjentyvät kaikki ne tiedot joita ei ollut aineistossa. Seuraavan tuonnin yhteydessä tätä ongelmaa ei enää ole. Mikäli asiakkaita perustetaan myös manuaalisesti, valitse silloin vaihtoehto Päivitä kaikki tietueet, säilytä kentät joita ei aineistossa. Päivitä kaikki tietueet o Käyttötapa: Uudet asiakkaat tuodaan aina aineiston kautta Fivaldiin. o Ylläpito tapahtuu vain aineiston tietojen perusteella. o Valitaan silloin kun asiakkaiden tiedot ylläpidetään toisessa järjestelmässä. o Viimeisin tilanne tuodaan aina aineiston perusteella Fivaldiin. Huom! Tämä valinta tyhjentää olemassa olevat tiedot, jos tietoa ei tuoda aineistossa. Päivitä kaikki tietueet, säilytä kentät joita ei aineistossa o Käyttötapa: Uudet asiakkaat tuodaan aineiston kautta tai perustetaan manuaalisesti Fivaldiin. o Ylläpito voi tapahtua suoraan Fivaldiin tai aineiston tietojen perusteella. o Valitse tämä vaihtoehto jos uusia asiakkaita perustetaan suoraan Fivaldiin sekä aineiston kautta ja jos aineistot eivät sisällä aina kaikkia tarvittavia tietoja. o Tämä vaihtoehto säilyttää aina asiakkaan sellaisetkin tiedot joita aineisto ei sisältänyt. Tuoterekisteri-kohdan määritykset: Lisää uudet tietueet (ei päivitystä) Tuo vain uudet yritystunnukset, ei koske olemassa oleviin yritystunnuksiin. Päivitä kaikki tietueet Tuo uudet tuotteet ja päivittää olemassa olevien tuotteiden kentät siirtotiedoston tiedoilla. Päivittää myös kentät, joita ei ole siirtotiedostossa. Huom! Tämä valinta tyhjentää olemassa olevat tiedot, jos tietoa ei tuoda aineistossa. Poista kaikki tuotteet ensin, lisää aineiston tuotteet Tuo uudet tuotteet ja päivittää olemassa olevien tuotteiden kentät siirtotiedoston tiedoilla. Ei koske kenttiin, joita ei ole siirtotiedostossa. Myyntitilaukset-kohdan määritykset: Lisää uudet tietueet (ei päivitystä) Tuo vain myyntitilaukset joiden SalesOrderNumber on uusi Visma Fivaldi 8

9 Päivitä kaikki tietueet Päivittää myyntitilausten tiedot siirtoaineiston tiedoilla. Huom! Tämä valinta tyhjentää olemassa olevat tiedot, jos tietoa ei tuoda aineistossa. Myyntitilauksia tuotaessa ohjelma poistaa myös manuaalisesti lisätyt tuoterivit, eli jäljelle jää vain siirtoaineiston tiedot. Käytä tuonnissa alennusrekisteriä Mahdolliset alennusprosentit haetaan Alennukset/hinnoittelu-rekisteristä. Perusta puuttuvat tuotteet ja päivitä toimittajan tiedot Perustaa tuoterekisteriin puuttuvan tuotteen koodin ja nimen. Ei lisää muita tietoja. Hae puuttuva seurantakohteen 1 arvo Fivaldin perustiedoista yleisten asetusten mukaisesti. Hae puuttuva seurantakohteen 2 arvo Fivaldin perustiedoista yleisten asetusten mukaisesti. Hae puuttuva seurantakohteen 3 arvo Fivaldin perustiedoista yleisten asetusten mukaisesti. Hae puuttuva seurantakohteen 4 arvo Fivaldin perustiedoista yleisten asetusten mukaisesti. HYVÄ TIETÄÄ: Seurantakohteiden tuomisen marssijärjestys on listattu Pääkäyttäjän käyttöönoton työjärjestys -helpissä, kohdassa Tilikartta > Seurantakohteet. Palkkatapahtumat-kohdan määritykset: Seurantakohteet luetaan aineistosta Palkkarivin seurantakohteen arvot luetaan siirtoaineistosta. Seurantakohteet luetaan henkilön oletustiedostosta Palkkarivin seurantakohteen arvot haetaan palkansaajan tiedoista. Ensisijaisesti aineiston kohteet, toiseksi henkilön oletuskohteet Palkkarivin seurantakohteen arvot luetaan siirtoaineistosta. Jos aineistossa ei ole arvoa seurantakohteelle, luetaan mahdollinen arvo palkansaajan tiedoista. Aineiston muodostuksen perustiedot Tiedoston oletusnimi Fivaldista ulosluettavan tiedon tallennustiedoston nimi. Ulosluettavalle tiedostolle voi antaa oletusnimen, mutta oletusnimen tallentaminen ei ole pakollista. Nimen puuttuessa järjestelmä käyttää oletusnimeä ulosluettu.xml. Seurantakohteen tapahtumat, seurantakohdetaso Ulosluettaessa seurantakohdetasoja, määritetään luettava seurantakohdetaso tähän. Tällä valinnalla vaikutetaan siihen, minkä seurantakohdetason tietoja haetaan IPrajapinnan yli Visma Fivaldi 9

10 2.2 Manuaalinen siirto XML-aineiston sisäänluku Tiedot voidaan siirtää manuaalisesti lähettämällä tiedosto selaimella. Sisäänlukunäkymään pääsee valitsemalla Fivaldi Webin puolella Muut > XML-aineiston sisäänluku. XML-aineiston tuonti tapahtuu seuraavasti: 1. Napsauta Aloita-painiketta. 2. Valitse Selaa ja hae siirrettävä XML-tiedosto. 3. Napsauta Lähetä ja lue tiedosto -painiketta. Onnistuneesti sisäänluettu aineisto on sovelluksen/rekisterin käytettävissä Visma Fivaldi 10

11 Palkanlaskennan sovelluksessa tieto pitää vielä tuoda palkanlaskentaan (Visma Fivaldin Java-puolella Palkat > Palkanlaskenta, sitten ylävalikosta Palkanlaskenta >Tietojen tuonti). Toiminto avaa uuden ikkunan. Tietojen tuonti tapahtuu seuraavasti: 1. Valitse tuotava tapahtumaerä Tapahtumaerä-alasvetovalikosta. 2. Älä valitse palkkakautta automaattisesti -valintaruutu: jos tämä on valittuna, ohjelma ei valitse palkkakautta automaattisesti. Tällöin jokaiselle päivämäärälle valitaan palkkakausi erikseen. 3. Mikäli päiväyksille löytyy useampi kuin yksi avoin palkkakausi, valitse oikea kausi jokaiselle vasemmassa kentässä olevalle siirtoaineiston päivälle. Tapahtumien lisätiedot / huomautukset palkanlaskijalle -kentässä näkyy aineistossa mahdollisesti annettu lisätieto. 4. Paina lopuksi Vie tiedot palkanlaskentaan. 2.3 Automatisoitu siirto Tiedot voidaan siirtää automaattisesti siten, että lähettävä järjestelmä tekee REST-pyynnön HTTPS-protokollalla ja välittää (POST-metodilla, Content-type: multipart/form-data) kenttinä käyttäjätunnuksen ja salasanan, sekä itse siirtotiedoston. Automatisoidussa siirrossa tulee lähettävän pään IP-osoitteen olla kiinteä ja se tulee toimittaa Vismalle yhteyden avaamista varten. Siirtoon täytyy loppuasiakkaan varata Fivaldi-käyttäjätunnus, jota ei käytetä muuhun tarkoitukseen. Käyttäjätunnus toimitetaan rajapinnan avauksen yhteydessä. Rajapinnan voi tilata Visma Fivaldin myynnistä Visma Fivaldi 11

12 2.3.1 Tiedoston lähetys REST-rajapinnalla Rajapinnan käyttö vaatii lähettävältä päältä julkisen, muuttumattoman IP-osoitteen. Osoite pitää ilmoittaa Vismalle ennen rajapinnan testauksen aloittamista. Tämän jälkeen voidaan tehdä REST-pyyntö, jossa on seuraavat parametrit: p_filename p_username p_password p_yt tiedosto käyttäjätunnus (huomioi isot ja pienet kirjaimet!) salasana Fivaldi-yritystunnus, jota vasten lähetyksen käyttöoikeus tarkistetaan (tarkistus erikseen myös aineiston sisällön perusteella) Sivupyynnön tulee olla multipart/form-data-muodossa, eli jokainen kenttä/tiedoston sisältö erotellaan boundary-määrityksen mukaisella rivillä. Kenttiä ei siis URL-enkoodata yhdeksi riviksi. Tekstimuotoisessa paluusanomassa on kolme kenttää, joista kaksi ensimmäistä ovat kokonaislukuja ja tulkitaan välilyönnein erotettuna: <virhekoodi> <tiedoston koko tavuina> <selväkielinen ilmoitus>, esimerkiksi " ok". Sanoman <selväkielinen ilmoitus> -osuus voi olla useampirivinen ja sisältää välilyöntejä. Tiedoston koko tavuina on Fivaldin vastaanottaman tiedoston koko. Virhekoodi on 0 jos luku onnistui, < 0 jos kyseessä on tietokannan ilmoittama virhe (esimerkiksi kyselyn kääntäminen ei onnistunut) tai > 0 jos kyseessä on jokin liittymän havaitsema ongelma esimerkiksi käyttöoikeuksissa. Nollasta poikkeavista virhekoodeista on hyvä tarkistaa/raportoida arvo 2, tämä tarkoittaa väärää käyttäjätunnusta ja salasanaa. Jokainen kirjautumisyritys väärällä salasanalla lasketaan, ja viiden virheellisen yhteydenoton jälkeen tunnus lukitaan. Joissain tilanteissa voi siis syntyä tilanne, että liittymä lakkaa toimimasta vaikka tunnus ja salasana ovat oikein. Tällöin pääkäyttäjä voi vapauttaa tunnuksen lukittu-tilasta Palvelunhallinnassa. Lähetykseen käytettävä osoite on jossa fv00x-osuuden x on kappaleen 2.1 mukainen asiakaskohtainen skeemanumero 1-6. Visma Fivaldilla ei ole tarjota ratkaisua siirron vastapään toteuttamiseen. Yksi valmis ratkaisu siirron toteuttamiseen skriptikielissä on käyttää melko vapaasti (~MIT) lisensoitua curl-nimistä ohjelmaa. Se tulee valmiina useimmissa Linux-jakeluissa ja sen saa myös muihin ympäristöihin. Esimerkki miten tällä tehtäisiin siirto, jos kone on luotettu (komentorivillä/prosessitaulussa muille näkyvä salasana ei ole ongelma): curl -Fp_username=fvdemo-xxx - Fp_password=salasana -Fp_yt= Fp_filename=@tiedosto.xml Jos tätä käytetään oikeasti, ei salasanaa pitäisi antaa komentoriville, vaan kirjoittaa argumentit tiedostoon ja lukea ne -Kvivulla Visma Fivaldi 12

13 2.3.2 Tiedoston nouto REST-rajapinnalla Rajapinnan käyttö vaatii noutavalta päältä julkisen, muuttumattoman IP-osoitteen. Osoite pitää ilmoittaa Vismalle ennen rajapinnan testauksen aloittamista. Tämän jälkeen voidaan tehdä REST-pyyntö, jossa ovat seuraavat parametrit: p_username käyttäjätunnus p_password salasana p_yt yritystunnus Yritysrekisteri: p_yrek p_yrekpvm haetaanko yritysrekisteri, arvoina 1 = noudetaan kaikki tai 2 = noudetaan annetun päivämäärän jälkeen muutetut, tyhjä tai puuttuu = ei haeta päiväys jonka jälkeiset haetaan, muoto YYYYMMDDHH24MISS tai DD.MM.YYYY Tuoterekisteri: p_tuoterek haetaanko tuoterekisteri, arvoina 1 = noudetaan kaikki tai 2 = noudetaan annetun päivämäärän jälkeen muutetut, tyhjä tai puuttuu = ei haeta p_tuoterekpvm päiväys jonka jälkeiset haetaan, muoto YYYYMMDDHH24MISS tai DD.MM.YYYY Myyntitilaukset: p_mtil p_mtilpvm haetaanko myyntitilaukset, arvoina 1 = noudetaan kaikki tai 2 = noudetaan annetun päivämäärän jälkeen muutetut, tyhjä tai puuttuu = ei haeta päiväys jonka jälkeiset haetaan, muoto YYYYMMDDHH24MISS tai DD.MM.YYYY Myyntihistoria: p_mhist p_mhistpvm haetaanko myyntihistoria, arvoina 1 = noudetaan kaikki tai 2 = noudetaan annetun päivämäärän jälkeen kirjatut, tyhjä tai puuttuu = ei haeta päiväys jonka jälkeiset haetaan, muoto YYYYMMDDHH24MISS tai DD.MM.YYYY Tietyn projektin/seurantakohteen tapahtumat kirjanpidossa: p_skarvo p_sknro p_skpvm haetaanko seurantakohteen kirjaukset, haetaan jos arvo annettu, muuten ei seurantakohdetaso (1-4) jolta edellinen rajaava arvo on päiväys jonka jälkeiset haetaan, muoto YYYYMMDDHH24MISS tai DD.MM.YYYY, tyhjä = kaikki Kirjanpidon kaikki viennit: p_skpvm tositteen päiväys jonka jälkeiset haetaan, muoto DD.MM.YYYY, pakollinen Kiinteistöhallinnon tiedot p_kh p_khpvm haetaanko kiinteistöhallinto, arvoina 1 = noudetaan kaikki tai 2 = noudetaan annetun päivämäärän jälkeen muutetut, tyhjä tai puuttuu = ei haeta päiväys jonka jälkeiset haetaan, muoto YYYYMMDDHH24MISS tai DD.MM.YYYY Visma Fivaldi 13

14 Osoite aineiston noutoon on jossa fv00x-kohdan X on asiakaskohtainen skeemanumero 1-6, jonka voit tarkistaa tämän ohjeen kohdan 2.1 mukaan. Paluusanoma on Fivaldin XML-skeeman mukainen. Paluusanoma on joko virheilmoitus muotoa <virhekoodi> 0 <selväkielinen ilmoitus>, esimerkiksi "3 0 Ei oikeutta aineiston vastaanottoon", tai onnistuneessa siirrossa XML-tiedosto joka alkaa < -merkillä Visma Fivaldi 14

15 2.4 Esimerkkejä Seuraavissa kappaleissa on esimerkit XML-tiedostoista yritysrekisteristä, tuoterekisteristä, myyntitilauksesta ja palkkatapahtumista. Tarkemmat kuvaukset löytyvät Fivaldin XML-skeemasta Yritysrekisteri Fivaldi XML asiakas <FVBusinessId>2251</FVBusinessId> Vastaanottavan yrityksen yritystunnus Fivaldissa <Company> <CompanyId>A1018</CompanyId> Asiakkaan yritystunnus (yksilöivä tieto) <CompanyName1>Yritys Oy</CompanyName1> Asiakkaan nimi 1 <CompanyName2>Lisänimi 2</CompanyName2> Asiakkaan nimi 2 <CompanyAddress Id="10" Type="MAIL" Main="1"> Postiosoitteen Id = 10 + Pääosoiteruksi kyllä (1) <FVAddrStreetAddress>Postiosoite 1</FVAddrStreetAddress> Lähiosoite 1 <FVAddrStreetAddress2>Postiosoite 2</FVAddrStreetAddress2> Lähiosoite 2 <FVAddrPostalCode>00530</FVAddrPostalCode> Postinumero <FVAddrPostalAddress>HELSINKI</FVAddrPostalAddress> Postitoimipaikka <FVAddrCountry>FI</FVAddrCountry> Maakoodi <FVAddrBeginDate> </FVAddrBeginDate> Osoitteen alkupäivä </CompanyAddress> <CompanyAddress Id="11" Type="DELIVERY" Main="0"> Toimitusosoitteen Id = 11 + Pääosoite valinta Ei (0) <FVAddrStreetAddress>Toimitusosoite 1</FVAddrStreetAddress> Lähiosoite 1 <FVAddrStreetAddress2>Toimitusosoite 2</FVAddrStreetAddress2> Lähiosoite 2 <FVAddrPostalCode>01400</FVAddrPostalCode> Postinumero <FVAddrPostalAddress>VANTAA</FVAddrPostalAddress> Postitoimipaikka <FVAddrCountry>FI</FVAddrCountry> Maakoodi <FVAddrPhone> </FVAddrPhone> Osoitteen puhelinnumero <FVAddrBeginDate> </FVAddrBeginDate> Osoitteen alkupäivä <FVAddrEndDate> </FVAddrEndDate> Osoitteen päättymispäivä <FVAddrName>Tintti Toimittaja</FVAddrName> Osoitteen nimi - kenttä </CompanyAddress> <CompanyAddress Id="12" Type="VISIT" Main="0"> Käyntiosoitteen Id = 12 + Pääosoiteruksi Ei (0) <FVAddrStreetAddress>Käyntiosoite 1</FVAddrStreetAddress> Lähiosoite 1 <FVAddrStreetAddress2>Käyntiosoite 2</FVAddrStreetAddress2> Lähiosoite 2 <FVAddrPostalCode>00100</FVAddrPostalCode> Postinumero <FVAddrPostalAddress>HELSINKI</FVAddrPostalAddress> Postitoimipaikka <FVAddrCountry>FI</FVAddrCountry> Maakoodi <FVAddrBeginDate> </FVAddrBeginDate> Osoitteen alkupäivä </CompanyAddress> <CompanyAddress Id="13" Type="INVOICING" Main="0"> Laskutusosoitteen Id = 13 + Pääosoite valinta Ei (0) <FVAddrStreetAddress>Laskutusosoite 1</FVAddrStreetAddress> Lähiosoite 1 <FVAddrStreetAddress2>Laskutusosoite 2</FVAddrStreetAddress2> Lähiosoite 2 <FVAddrPostalCode>01200</FVAddrPostalCode> Postinumero <FVAddrPostalAddress>VANTAA</FVAddrPostalAddress> Postitoimipaikka Visma Fivaldi 15

16 <FVAddrCountry>FI</FVAddrCountry> Maakoodi <FVAddrBeginDate> </FVAddrBeginDate> Osoitteen alkupäivä </CompanyAddress> <CompanyPhone> </CompanyPhone> Yrityksen puhelinnumero <CompanyCellular> </CompanyCellular> Yrityksen matkapuhelin <CompanyFax> </CompanyFax> Yrityksen telefax <CompanyWww> Yrityksen www-osoite Yrityksen sähköpostiosoite <CompanyGroup Id="01"> Yritysryhmän koodi <CompanyGroupName> <FVNameText>Yritysryhmän selite</fvnametext> Yritysryhmän selite <FVNameLanguage>FIN</FVNameLanguage> Yritysryhmän kielikoodi </CompanyGroupName> <CompanySegment Id="A"> Yrityssegmentin koodi <CompanySegmentName> <FVNameText>Segmentin selite</fvnametext> Yrityssegmentin selite <FVNameLanguage>FIN</FVNameLanguage> Yrityssegmentin kielikoodi </CompanySegmentName> </CompanySegment> </CompanyGroup> <CompanyContactMethod Id="001"> Yhteydenottotavan sisäinen ID <FVContactMethodName> <FVNameText>Sähköpostilla</FVNameText> Yhteydenottotavan selite <FVNameLanguage>FIN</FVNameLanguage> Yhteydenottotavan kielikoodi </FVContactMethodName> </CompanyContactMethod> Yhteydenottotavan info-kentän tieto <CompanyRemindSuppress Value="1"/> Karhuesto 1=K, 0=E <CompanyInterestSuppress Value="1"/> Koronesto 1=K, 0=E <CompanyCreditProhibit Value="0"/> Luottokielto 1=K, 0=E <CompanyCreditLimit> </CompanyCreditLimit> Luottoraja <CompanySalesTOP Id="30"> Myynnin maksuehdon koodi <FVTOPDueDays>30</FVTOPDueDays> Nettoeräpäivät <FVTOPCashPercent>0.00</FVTOPCashPercent> Kassa-ale % <FVTOPCashDays>0</FVTOPCashDays> Kassa-ale päivät <FVTOPName> <FVNameText>30 pv netto</fvnametext> Maksuehdon selite <FVNameLanguage>FIN</FVNameLanguage> Maksuehdon selitteen kielikoodi </FVTOPName> </CompanySalesTOP> <CompanyPurchasingTOP Id="60"> Oston maksuehdon koodi <FVTOPDueDays>60</FVTOPDueDays> Nettoeräpäivät <FVTOPCashPercent>0.00</FVTOPCashPercent> Kassa-ale % <FVTOPCashDays>0</FVTOPCashDays> Kassa-ale päivät <FVTOPName><FVNameText>60 pv netto</fvnametext> Maksuehdon selite Visma Fivaldi 16

17 <FVNameLanguage>FIN</FVNameLanguage> Maksuehdon selitteen kielikoodi </FVTOPName> </CompanyPurchasingTOP> <CompanySalesDeliveryMethod Id="1"> Toimitustavan koodi (Myyntitiedot) <FVIntrastatCode/> <FVDeliveryMethodName> <FVNameText>Finnair</FVNameText> Toimitustavan selite <FVNameLanguage>FIN</FVNameLanguage> Toimitustavan selitteen kielikoodi </FVDeliveryMethodName> </CompanySalesDeliveryMethod> <CompanyLanguage>FIN</CompanyLanguage> Asiakkaan kielikoodi <CompanyCurrency>EUR</CompanyCurrency> Asiakkaan valuutta <CompanySmallDeliveryExtra Value="0"/> (<- elementillä ei ole toimintoa toistaiseksi) <CompanyTemporary Value="1"/> Yritys on tilapäisasiakas, 1=K, 0=E <CompanyUnwelcome Value="0"/> Yritys on ei toivottu, 1=K, 0=E <CompanyAdditionalInfo1>ISO LISÄTIETO</CompanyAdditionalInfo1> Lisätiedot välilehden Lisätietoa <CompanyAdditionalInfo2>Lyhyempi lisätieto</companyadditionalinfo2> Yritystiedot välilehden Lisätieto <CompanyBankAccount Id="12"> Asiakkaan pankkitilin ID (lähettäjän antama yksilöivä tieto) <FVBankAccountBankName>Nordea</FVBankAccountBankName> Pankkitilin nimi <FVBankAccountAccountNumber> </FVBankAccountAccountNumber> Tilinumero (BBAN) <FVBankAccountIban>FI </FVBankAccountIban> IBAN-tilinumero <FVBankAccountSwift>NDEAFIHH</FVBankAccountSwift> BIC/Swift <FVBankAccountCountry>FI</FVBankAccountCountry> Pankkitilin maakoodi </CompanyBankAccount> <CompanyJoinOrders Value="1"/> Tilaukset yhdistetään samalle laskulle?, 1=K, 0=E <CompanyVatRegistered Value="1"/> Asiakas on ALV/VAT rekist. 1=K, 0=E <CompanyBusinessId> </CompanyBusinessId> Y-tunnus <CompanyResponsiblePerson>Ville Vastuuhenkilö</CompanyResponsiblePerson> Vastuuhenkilö - kentän tieto <CompanyLocation>Espoo</CompanyLocation> Yrityksen kotipaikka <CompanyCountry>FI</CompanyCountry> Yrityksen maakoodi <CompanyCreationTime> </CompanyCreationTime> Yrityksen luontiaika (yritysrekisteriin) <CompanyInvoicingLimit> </CompanyInvoicingLimit> Laskutusraja <CompanyBankTransferMessage Value="1"/> Pankkisiirto-viestityyppi: 1=Viite, 2=Viesti, 3=Veroviesti <CompanyCustomer Value="1"/> Yritys on Asiakas, 1=K, 0=E <CompanySupplier Value="1"/> Yritys on Toimittaja, 1=K, 0=E <CompanyDiscountGroup>VIP</CompanyDiscountGroup> Yrityksen alennusryhmän koodi <CompanyPostingGroupId> </CompanyPostingGroupId> Myyntiedot: Tiliöintiryhmän sisäinen ID <CompanyPostingCode>23</CompanyPostingCode> Ostotiedot: Oletustiliöinnin tiliöintikoodi <CompanyTOD Id="001"> Toimitusehdon numero (kts. yrityksen perustiedot) <FVTODName> <FVTODNameText>Vapaasti var.</fvtodnametext> Toimitusehdon selite <FVTODNameLanguage>FIN</FVTODNameLanguage> Toimitusehdon kielikoodi <FVTODCode>EXW</FVTODCode> Toimitusehdon koodi </FVTODName> </CompanyTOD> Visma Fivaldi 17

18 <CompanyInvoiceDeliveryMethodTypeId> </CompanyInvoiceDeliveryMethodTypeId> <CompanyFinvoiceAddressType>M</CompanyFinvoiceAddressType> <CompanyFinvoiceOtherId> </CompanyFinvoiceOtherId> <CompanyFinvoiceOperatorId>NDEAFIHH</CompanyFinvoiceOperatorId> </Company> </FivaldiXML> Välitystavan sis.id nro (laskujen välitys perustiedot) Vastaanottajan verkkolaskuosoitteen tyyppi (M=Muu tunnus) Vastaanot. verkkolaskuos. joka annetaan Muu tunnus -kentässä Vastaanottajan välittäjän tunnus Visma Fivaldi 18

19 Visma Fivaldi 19

20 Visma Fivaldi 20

21 Visma Fivaldi 21

22 Visma Fivaldi 22

23 2.4.2 Muuta huomioitavaa Asiakkaan valuutta Jos aineistossa on asiakkaita, joiden valuuttatunnus <CompanyCurrency> on muu kuin kotivaluutta, tulee kaikki tarvittavat asiakkaiden valuuttakoodit perustaa myös vastaanottavan yrityksen perustietoihin (Visma Fivaldin Java-puolella Yrityksen perustiedot > Valuutat-välilehti). Asiakkaan oletusvälitystapa Jos aineistossa tuodaan asiakkaan oletusvälitystapa (<CompanyInvoiceDeliveryMethodTypeId>), tulee tarvittavat välitystavat perustaa ensin Laskujen välityksen perustietoihin (Visma Fivaldin Java-puolella Myynti-, Kiinteistöhallinta- tai Maksuliikenne-välilehdeltä Laskujen välitys ja sitten ylävalikosta Laskujen välitys > Perustiedot). <CompanyInvoiceDeliveryMethodTypeId> -elementtiin annetaan välitystavan sisäinen ID-numero, joka muodostuu samassa järjestyksessä kuin rivien luontijärjestys eli ensimmäisen selitteen ID = , seuraavan ja kolmannen jne. Jos välitystapoja on jälkikäteen poistettu, myös kyseinen ID-numero on jäänyt välistä pois, joten tarvittaessa numeroinnin voi tarkistaa esimerkiksi viemällä asiakastietoja XML-siirtona ulospäin Visma Fivaldi 23

24 Visma Fivaldi 24

25 2.4.3 Tuoterekisteri Fivaldi XML tuote <FVBusinessId>92</FVBusinessId> <Product> <ProductId>TuoteA</ProductId> <ProductName> <FVNameText>Mallituote</FVNameText> <FVNameLanguage>FIN</FVNameLanguage> </ProductName> <ProductGroup> <ProductGroupId>dem</ProductGroupId> <ProductGroupCNCode/> <ProductGroupName> <FVNameText>demo</FVNameText> <FVNameLanguage>FIN</FVNameLanguage> </ProductGroupName> </ProductGroup> <ProductUnit Id="53"> <FVUnitName> <FVNameText>Kpl</FVNameText> <FVNameLanguage>FIN</FVNameLanguage> </FVUnitName> </ProductUnit> <ProductDescription> <FVNameText>Loistava punainen tuote</fvnametext> <FVNameLanguage>FIN</FVNameLanguage> </ProductDescription> <ProductTaxablePrice> </ProductTaxablePrice> <ProductPosting> <ProductPostingGroup Id=" " CashSales="0" Default="1"> <FVPostingGroupName> <FVNameText>Myynti kotimaahan</fvnametext> <FVNameLanguage>FIN</FVNameLanguage> </FVPostingGroupName> <FVPostingGroupReceivablesAcc> <FVPostingAccountId>1701</FVPostingAccountId> <FVPostingAccountName> <FVNameText>Myyntisaamiset, iso reskontra</fvnametext> <FVNameLanguage>FIN</FVNameLanguage> </FVPostingAccountName> </FVPostingGroupReceivablesAcc> <FVPostingGroupPriceInclTax> </FVPostingGroupPriceInclTax> </ProductPostingGroup> <ProductPostingPosting Id=" "> Vastaanottavan yrityksen yritystunnus Fivaldissa Tuotteen yksilöivä tunnus (pakollinen tieto) Tuotteen nimi Tuotteen nimi selite Kielikoodi ISO alpha-3 Tuoteryhmä Tuoteryhmän tunnus Tuoteryhmän CN koodi Tuoteryhmän nimi Tuoteryhmän selite Kielikoodi ISO alpha-3 Tuotteen perusyksikkö, sisäinen id Yksikön nimi Yksikön selite Kielikoodi ISO alpha-3 Tuotteen kuvaus Tuotteen selite Kielikoodi ISO alpha-3 Tuotteen veroton myyntihinta Tiliöintiryhmä Tiliöintiryhmän sisäinen id, käteismyynti 1= kyllä, 0 =ei, oletustiliöintiryhmä 1= kyllä, 0= ei Tiliöintiryhmän nimi Tiliöintiryhmän selite Kielikoodi ISO alpha-3 Myyntisaamistili Myyntisaamistilin numero Myyntisaamistilin nimi Myyntisaamistilin nimi selite Kielikoodi ISO alpha-3 Tiliöintiryhmän mukainen verollinen hinta Tiliöinnin sisäinen id Visma Fivaldi 25

26 <FVPostingName> <FVNameText>Myynti yleinen vk</fvnametext> <FVNameLanguage>FIN</FVNameLanguage> </FVPostingName> <FVPostingSalesAccount> <FVPostingAccountId>3010</FVPostingAccountId> </FVPostingSalesAccount> <FVPostingVatCode Id="H"> <FVVatCodePercent>14</FVVatCodePercent> <FVVatCodeAccount> <FVPostingAccountId>2939</FVPostingAccountId> </FVVatCodeAccount> <FVVatCodeName> <FVNameText>Myynti</FVNameText> <FVNameLanguage>FIN</FVNameLanguage> </FVVatCodeName> </FVPostingVatCode> </ProductPostingPosting> </ProductPosting> <ProductWarehouse Value="1"/> <ProductCollectible Value="1"/> <ProductSerialNumber Value="1"/> <ProductPriceCode Value="1"/> <ProductOrderLimit>50</ProductOrderLimit> <ProductDiscountGroup>ALE1</ProductDiscountGroup> <ProductWeight>10.000</ProductWeight> <ProductCostPrice> </ProductCostPrice> <ProductLogisticsPrice> </ProductLogisticsPrice> <ProductEANCode> </ProductEANCode> <ProductMinimumPrice> </ProductMinimumPrice> <ProductWww> <ProductGuarantee>12</ProductGuarantee> <ProductCNCode>CN123</ProductCNCode> <ProductCN2Unit/> <ProductStatisticsRow Value="0"/> <ProductDeleted Value="0"/> <ProductSuggestedPrice> </ProductSuggestedPrice> <ProductShowDescription/> </Product> </FivaldiXML> Tiliöinnin nimi Tiliöinnin nimen selite Kielikoodi ISO alpha-3 Tiliöinnin myyntitili Tiliöinnin myyntitilin numero Tiliöinnin verokannan sisäinen id Verokannan prosentti ALV-tilin numero Verokannan nimi Verokannan nimen selite Kielikoodi ISO alpha-3 Varastotuote 0= ei, 1= kyllä, 2= kyllä, eräseuranta Keräilytuote 1= kyllä, 0= ei Sarjanumeroseurannassa 1= kyllä, 0= ei Katelaskenta Tilausraja ostolle Alennusryhmäkoodi Perusyksikön paino kilogrammoissa Omakustannushinta Logistiikkakustannus EAN koodi Minimihinta Toimittajan WWW-osoite Takuuaika CN-nimike Yksikkö, toinen paljous Tilastoriviksi tilaukselle 1= kyllä, 0= ei Tuote poistettu 1= kyllä, 0= ei Suositushinta Visma Fivaldi 26

27 Visma Fivaldi 27

28 2.4.4 Tilaustenkäsittely - Fivaldi XML tilaus <FVBusinessId>2251</FVBusinessId> Vastaanottavan yrityksen (laskuttaja) yritystunnus Fivaldissa <SalesOrder> <SalesOrderNo>2222</SalesOrderNo> Lähettäjän antama, tilauksen yksilöivä tieto <SalesOrderSalesman Id="1"> Myyjän sisäinen ID numero (kts. lisäohje) <FVSalesmanName>Matti Myyjä</FVSalesmanName> Myyjän nimi (pakollinen jos edellinen annettu) <FVSalesmanTelephone/> Myyjän puhelinnumero <FVSalesman /> Myyjän sähköposti </SalesOrderSalesman> <SalesOrderExecutor Id="2"> Työnsuorittajan sis. ID-numero (kts. lisäohje->) <FVSalesmanName>Antti Asentaja</FVSalesmanName> Työnsuorittajan nimi <FVSalesmanTelephone/> Työnsuorittajan puhelinnumero <FVSalesman /> Työnsuorittajan sähköposti </SalesOrderExecutor> <SalesOrderCompanyId>1009</SalesOrderCompanyId> Asiakkaan (laskutettavan) yritysnumero Fivaldin yritysreksiterissä. <SalesOrderName1>Yritys Oy</SalesOrderName1> Asiakkaan nimi 1 (max 40 merkkiä) <SalesOrderName2>Lisänimi 2</SalesOrderName2> Asiakkaan nimi 2 (max 40 merkkiä) <SalesOrderStreetAddress>Yrityskatu 44</SalesOrderStreetAddress> Asiakkaan osoite 1 <SalesOrderStreetAddress2>Lähiosoite 2</SalesOrderStreetAddress2> Asiakkaan osoite 2 <SalesOrderPostalAddress>00530 HELSINKI</SalesOrderPostalAddress> Asiakkaan postinumero ja paikka <SalesOrderCountry>FI</SalesOrderCountry> Osoitteen maakoodi <SalesOrderReference>VIITTEEMME</SalesOrderReference> Tilauksen viitteemme kentän tieto <SalesOrderDate> </SalesOrderDate> Tilauksen päivämäärä <SalesOrderWarehouseCode>1</SalesOrderWarehouseCode> Myyntivaraston koodi <SalesOrderWarehouseName>Ensimmäinen varasto</salesorderwarehousename> Myyntivaraston nimi (pakollinen jos edellinen annettu) <SalesOrderAdditionalInfo>TILAUKSENNE</SalesOrderAdditionalInfo> Tilauksenne kentän tieto (max 100 merkkiä) <SalesOrderDeliveryDate> </SalesOrderDeliveryDate> Toimituspäivä <SalesOrderTaxableTotal> </SalesOrderTaxableTotal> Tilauksen veroton summa <SalesOrderTotalIncludingTax> </SalesOrderTotalIncludingTax> Tilauksen verollinen summa <SalesOrderDeliveryMethod Id="1"> Toimitustavan koodi <FVIntrastatCode>4</FVIntrastatCode> Toimitustavan Intrastat koodi <FVDeliveryMethodName> <FVNameText>Finnair</FVNameText> Toimitustavan nimi <FVNameLanguage>FIN</FVNameLanguage> Toimitustavan nimen kielikoodi </FVDeliveryMethodName> </SalesOrderDeliveryMethod> <SalesOrderDeliveryName1>Yritys Oy</SalesOrderDeliveryName1> Toimitusosoite - asiakkaan nimi1 <SalesOrderDeliveryName2>Lisänimi 2</SalesOrderDeliveryName2> Toimitusosoite - asiakkaan nimi2 <SalesOrderDeliveryStreetAddr>Toimituskatu 55</SalesOrderDeliveryStreetAddr> Toimitusosoite - asiakkaan osoite 1 <SalesOrderDeliveryStreetAddr2>Toimitusosoite 2</SalesOrderDeliveryStreetAddr2> Toimitusosoite - asiakkaan osoite 2 <SalesOrderDeliveryPostalAddr>01400 VANTAA</SalesOrderDeliveryPostalAddr> Toimitusosoite - asiakkaan postiosoite Visma Fivaldi 28

29 <SalesOrderDeliveryCountry>FI</SalesOrderDeliveryCountry> Toimitusosoite - asiakkaan osoitteen maakoodi <SalesOrderCurrency>EUR</SalesOrderCurrency> Tilauksen valuutta <SalesOrderExchangeRate> </SalesOrderExchangeRate> Tilauksen kurssi <SalesOrderTermsOfPayment Id="7"> Maksuehdon koodi Fivaldissa <FVTOPDueDays>7</FVTOPDueDays> Maksuehdon nettoeräpäivä <FVTOPCashPercent>0.00</FVTOPCashPercent> Maksuehdon kassa-ale % <FVTOPCashDays>0</FVTOPCashDays> Maksuehdon kassa-alepäivät <FVTOPName> <FVNameText>7 pv netto</fvnametext> Maksuehdon nimi <FVNameLanguage>FIN</FVNameLanguage> Maksuehdon nimen kielikoodi </FVTOPName> </SalesOrderTermsOfPayment> <SalesOrderInvoicingPermit Value="1"/> Tilauksen laskutuslupa, 1=K, 0=E, K=kielto <SalesOrderFollowUp1> <FVFollowUpId>KP1</FVFollowUpId> Kustannuspaikan koodi (Taso 1) <FVFollowUpName> <FVNameText>Kustannuspaikka 1</FVNameText> Kustannuspaikan nimi <FVNameLanguage>FIN</FVNameLanguage> Kustannuspaikan nimen kielikoodi </FVFollowUpName> </SalesOrderFollowUp1> <SalesOrderFollowUp2> <FVFollowUpId>KP 2</FVFollowUpId> Kustannuspaikan koodi (Taso 2) <FVFollowUpName> <FVNameText>kustannuspaikka 2</FVNameText> Kustannuspaikan nimi <FVNameLanguage>FIN</FVNameLanguage> Kustannuspaikan nimen kielikoodi </FVFollowUpName> </SalesOrderFollowUp2> <SalesOrderFollowUp3> <FVFollowUpId>KP 3</FVFollowUpId> Kustannuspaikan koodi (Taso 3) <FVFollowUpName> <FVNameText>Kustannuspaikka 3</FVNameText> Kustannuspaikan nimi <FVNameLanguage>FIN</FVNameLanguage> Kustannuspaikan nimen kielikoodi </FVFollowUpName> </SalesOrderFollowUp3> <SalesOrderFollowUp4> <FVFollowUpId>KP 4</FVFollowUpId> Kustannuspaikan koodi (Taso 4) <FVFollowUpName> <FVNameText>Kustannuspaikka 4</FVNameText> Kustannuspaikan nimi <FVNameLanguage>FIN</FVNameLanguage> Kustannuspaikan nimen kielikoodi </FVFollowUpName> </SalesOrderFollowUp4> <SalesOrderOrderer>Tiina Tilaaja</SalesOrderOrderer> Tilauksen tilaaja kentän tieto <SalesOrderPostingGroupId> </SalesOrderPostingGroupId> Tiliöintiryhmän sisäinen ID <SalesOrderInternalInfo>SISÄINEN LISÄTIETO</SalesOrderInternalInfo> Sisäinen lisätieto -kentän tieto (max 255 merkkiä) Visma Fivaldi 29

30 <SalesOrderInvoiceReference>123</SalesOrderInvoiceReference> Kentällä ohitetaan normaali Fivaldin viitenumeron muodostus. Kentän arvosta muodostetaan laskun viitenumero. <SalesOrderRow> <SalesOrderRowNo>1</SalesOrderRowNo> Tilausrivin numero <SalesOrderRowProductId>XML 1</SalesOrderRowProductId> Tuotekoodi <SalesOrderRowQuantity>2</SalesOrderRowQuantity> Määrä <SalesOrderRowProductName>XML tuote</salesorderrowproductname> Tuotenimi (max 80 merkkiä) <SalesOrderRowDiscountPercent1>10.00</SalesOrderRowDiscountPercent1> Ale % 1 <SalesOrderRowDiscountPercent2>5.00</SalesOrderRowDiscountPercent2> Ale % 2 <SalesOrderRowTaxableUnitPrice> </SalesOrderRowTaxableUnitPrice> Veroton a-hinta <SalesOrderRowUnitPriceInclTax> </SalesOrderRowUnitPriceInclTax> Verollinen a-hinta <SalesOrderRowUnit Id="2"> Yksikön sisäinen ID <FVUnitName> <FVNameText>kpl</FVNameText> Yksikkö <FVNameLanguage>FIN</FVNameLanguage> Yksikön kielikoodi </FVUnitName> </SalesOrderRowUnit> <SalesOrderRowDeliveryDate> </SalesOrderRowDeliveryDate> Tuoterivin toimitusaika <SalesOrderRowTaxableTotal> </SalesOrderRowTaxableTotal> Rivin veroton yhteissumma <SalesOrderRowTotalIncludingTax> </SalesOrderRowTotalIncludingTax> Rivin verollinen yhteissumma <SalesOrderRowInvoicingChoice Value="0"/> Rivikohtainen laskutuslupa, 1=K, 0=E <SalesOrderRowWarehouseCode>1</SalesOrderRowWarehouseCode> Rivin varaston koodi <SalesOrderRowWarehouseName>Ensimmäinen varasto</salesorderrowwarehousename> Rivin varaston nimi (pakollinen jos edellinen annettu) <SalesOrderRowStatisticsRow Value="0"/> Rivi tilastoriviksi, 1=K, 0=E <SalesOrderRowFollowUp1> <FVFollowUpId>KP1</FVFollowUpId> Rivin kustannuspaikan koodi (taso 1) <FVFollowUpName> <FVNameText>Kustannuspaikka 1</FVNameText> Rivin kustannuspaikan nimi <FVNameLanguage>FIN</FVNameLanguage> Rivin kustannuspaikan nimen kielikoodi </FVFollowUpName> </SalesOrderRowFollowUp1> <SalesOrderRowFollowUp2> <FVFollowUpId>KP 2</FVFollowUpId> Rivin kustannuspaikan koodi (taso 2) <FVFollowUpName> <FVNameText>kustannuspaikka 2</FVNameText> Rivin kustannuspaikan nimi <FVNameLanguage>FIN</FVNameLanguage> Rivin kustannuspaikan nimen kielikoodi </FVFollowUpName> </SalesOrderRowFollowUp2> <SalesOrderRowFollowUp3> <FVFollowUpId>KP 3</FVFollowUpId> Rivin kustannuspaikan koodi (taso3) <FVFollowUpName> <FVNameText>Kustannuspaikka 3</FVNameText> Kustannuspaikan nimi <FVNameLanguage>FIN</FVNameLanguage> Kustannuspaikan nimen kielikoodi </FVFollowUpName> </SalesOrderRowFollowUp3> Visma Fivaldi 30

31 <SalesOrderRowFollowUp4> <FVFollowUpId>KP 4</FVFollowUpId> Rivin kustannuspaikan koodi (taso 4) <FVFollowUpName> <FVNameText>Kustannuspaikka 4</FVNameText> Kustannuspaikan nimi <FVNameLanguage>FIN</FVNameLanguage> </FVFollowUpName> </SalesOrderRowFollowUp4> <SalesOrderRowExecutor Id="2"> <FVSalesmanName>Antti Asentaja</FVSalesmanName> <FVSalesmanTelephone/> <FVSalesman /> </SalesOrderRowExecutor> </SalesOrderRow> <SalesOrderRow> <SalesOrderRowNo>2</SalesOrderRowNo> <SalesOrderRowQuantity xsi:nil="true"/> </SalesOrderRow> </SalesOrder> </FivaldiXML> <SalesOrderRowProductName>TEKSTIRIVIÄ XXX</SalesOrderRowProductName> Kustannuspaikan nimen kielikoodi Rivin työnsuorittajan sis. ID (kts. lisäohje->) Rivin työnsuorittajan nimi Rivin työnsuorittajan puhelin Rivin työnsuorittajan sähköposti Tilausrivin numero (= Tekstirivin määrä po. tyhjä) Tekstirivin sisältö, max 80 merkkiä Visma Fivaldi 31

32 Visma Fivaldi 32

33 Visma Fivaldi 33

34 2.4.5 Lisäohjeita ja tarkennuksia Myyjän sekä Työnsuorittajan sisäinen ID-numero: Sisäinen ID muodostuu Visma Fivaldin Java-puolen Tilaustenkäsittely-sovelluksen ylävalikosta Tilaukset > Perustiedot -valinnalla avautuvan näkymän Myyjät-välilehdelle lisättyjen henkilöiden tallennusjärjestyksessä alkaen numerosta 1. Jos ruudulla on useita myyjiä ja/tai työnsuorittajia, käyttäjä ei voi varmuudella tietää ohjelman sisäistä ID:tä. Tarvittaessa ID-listan voi pyytää Visma Fivaldin sovellustuesta Tukipyynnössä tulee ilmoittaa se Fivaldin yritysnumero, joka vastaanottaa kyseisiä XML-aineistoja. XML-aineiston varastotuotteet / Fivaldi tuoterekisteri: Tuotteet on perustettava ennen siirtoa tuoterekisteriin. Varastotuotteella pitää olla perusyksikkö sekä varastokoodi Kyllä. Tilausrivin varastopäivitys ei muutoin onnistu. Aineistossa olevan yksikön ID:n tulee vastata Fivaldi tuoterekisterissä tuotteelle annettua perusyksikköä. Tilauksen laskutus- ja toimitusosoiteosioiden tiedot: Tiedot tuodaan aina ensisijaisesti aineistosta. Mikäli nimi- tai osoitetieto puuttuu aineistosta, haetaan tieto toissijaisesti kyseisen asiakkaan tiedoista yritysrekisteristä. Myös asiakkaan mahdollinen pääyritys tai väliyritys Yritysrekisterissä huomioidaan. Myynnin perustietojen parametrilla Toimitusosoitteeseen asiakkaan nimi ei ole vaikutusta XML-tilausaineistojen tuonnissa Visma Fivaldi 34

35 2.4.6 Palkanlaskenta Fivaldi XML palkkatapahtuma <FVBusinessId>110</FVBusinessId> Vastaanottavan yrityksen yritystunnus Fivaldissa <FVCreationTime> T15:04:48</FVCreationTime> <Payroll> <PayrollBatchId>Palkka </PayrollBatchId> Käyttäjän vapaasti generoima id <PayrollRow> <PayrollEmployeeId> </PayrollEmployeeId> Työntekijän id palkanlaskentaohjelmassa <PayrollDate> </PayrollDate> Tapahtumapäivä <PayrollSalaryType>1100</PayrollSalaryType> Palkkalaji <PayrollAmount>34.5</PayrollAmount> Määrä <PayrollFactor>1.5</PayrollFactor> Kerroin (oletus =1) <PayrollPrice>100</PayrollPrice> á-hinta (oletuksena luetaan palkansaajan tiedoista tai palkkalajilta) <PayrollDescription>Selite</PayrollDescription> Palkkatapahtuman selite <PayrollUpdateType>1</PayrollUpdateType> Seurantakohteiden lukutapa. 1=aineisto, 2=palkansaajan tiedoista, 3=ensisijaisesti aineisto, jos ei ole niin palkansaajan tiedoista <PayrollFollowUp1> Seurantakohde 1 / kustannuspaikka 1 <FVFollowUpId>100</FVFollowUpId> Seurantakohteen id </PayrollFollowUp1> <PayrollFollowUp2> Seurantakohde 2 / kustannuspaikka 2 <FVFollowUpId>200</FVFollowUpId> Seurantakohteen id </PayrollFollowUp2> </PayrollRow> <PayrollRow> <PayrollEmployeeId> </PayrollEmployeeId> <PayrollDate> </PayrollDate> <PayrollSalaryType>1000</PayrollSalaryType> <PayrollAmount>20</PayrollAmount> </PayrollRow> <PayrollEmployeeId> </PayrollEmployeeId> <PayrollDate> </PayrollDate> <PayrollSalaryType>1600</PayrollSalaryType> <PayrollAmount>5</PayrollAmount> <PayrollDescription>kesäloma</PayrollDescription> <PayrollVacationStart> </ PayrollVacationStart> Loman alkupäivä. Tietoa käytetään poissaolon ilmoittamisessa tulorekisteriin. Tieto luetaan palkkariville kenttään Ansainta-aika <PayrollVacationEnd> </ PayrollVacationEnd> <PayrollUpdateType>1</PayrollUpdateType> </Payroll> </FivaldiXML> alkupvm. Loman loppupäivä. Tietoa käytetään poissaolon ilmoittamisessa tulorekisteriin. Tieto luetaan palkkariville kenttään Ansainta-aika loppupvm Visma Fivaldi 35

36 Visma Fivaldi 36

37 2.4.7 Lisäohjeita ja tarkennuksia PayrollBatchId Id:n avulla estetään samojen palkkatapahtumien tuonti useampaan kertaan. Tapahtumapäivä (PayrollDate) Tapahtumapäivän perusteella tapahtuma kohdistetaan palkkakaudelle. Mikäli palkkakausi ei ole yksiselitteinen, tulee kausi valita päiväkohtaisesti palkanlaskennan puolella tietoa laskelmille tuotaessa. Työntekijän ID-numero (PayrollEmployeeId) Voidaan käyttää HETUa tai ulkoisen järjestelmän ID-numeroa. Ulkoisen järjestelmän ID tulee tallentaa Fivaldissa palkansaajan perustietoihin kohtaan Ulkoisen järj. tunnus. Tiedon perusteella Fivaldi osaa kohdistaa tuotavan aineiston tapahtumat oikealle henkilölle. Palkkalaji (PayrollSalaryType) Voidaan käyttää Fivaldin palkkalajeja tai käyttää ulkoisen järjestelmän palkkalajeja. Palkkalaji tulee tallentaa Fivaldissa Palkkalajit-rekisteriin vastaavalle palkkalajille kohtaan Ulkoisen järj. tunnus. Tiedon perusteella Fivaldi osaa kohdistaa tuotavan aineiston palkkalajin tapahtumat vastaavalle Fivaldin palkkalajille. Selite (PayrollDescription) Selitteen näkyminen palkkalaskelmalla Visma Fivaldi 37

38 3 CSV-siirto 3.1 Yleistä Visma Fivaldi -ohjelmiston tietokantaan voidaan päivittää CSV-muotoisilla tiedostoilla: tuotetietoja, yritysrekisterin ja varastovalvonnan tietoja, budjettitietoja, palkkatietoja ja palkansaajan perustiedot. Päivitys tapahtuu CSV-tiedoston lataus -apuohjelmalla, joka löytyy Visma Fivaldin Java-puolen Muut-välilehdeltä. Samasta ohjelmasta saadaan ulos myös mallitiedostot. 3.2 Käyttöoikeuksien määrittely Palvelunhallinnassa Pääkäyttäjän tulee aktivoida Palvelunhallinnassa apuohjelmista CSV-tiedoston lataus -ohjelmaan oikeudet kaikille tarvittaville käyttäjille tai käyttäjäryhmille tarvittaviin yrityksiin. Sovelluksella tietoja sisään lukeva käyttäjätunnus ei siirron takia tarvitse muita sovellusoikeuksia. Jos Fivaldista halutaan lukea ulos tuote- ja/tai yritysrekisteri CSV-muodossa, aktivoidaan tarvetta vastaavat raportit: Tuotetiedot csv-tiedostoksi ja/tai Yritysrekisteri csv-tiedostoksi. Mallitiedostoista lisää kappaleessa 3.3 ja aineistojen ulosluvusta kappaleessa Visma Fivaldi 38

39 3.3 Mallitiedostojen luonti CSV-mallitiedostot saadaan muodostettua CSV-tiedoston lataus -apuohjelmasta, joka löytyy sovellusikkunan Muutvälilehdeltä. Sovelluksen alaosan Yleiset tiedot -osassa valitaan vasemmasta reunasta haluttu mallitiedoston tyyppi. Napsautetaan Muodosta CSV-malli -painiketta. Mallitiedostoissa on ensimmäisellä rivillä sarakeotsikot, joiden nimiä ei saa muuttaa. Tarpeettomat, ei pakolliset sarakkeet voi jättää pois. Pakolliset sarakeotsikot voi tarkistaa tämän dokumentin tietuekuvauksista. Mallitiedosto on otsikkoriviä lukuunottamatta tyhjä. Sarakeotsikkorivin alle syötetään tiedostoon varsinaiset tiedot, jotka halutaan siirtää Visma Fivaldi -järjestelmään. Kun mallitiedostoon on syötetty toisen järjestelmän tiedot oikeisiin sarekkeisiin ja riveille, aineisto voidaan lukea sisälle Valitse tiedosto -painikkeen kautta Visma Fivaldi 39

40 Kun koneelta on selattu esiin oikea tiedosto, voidaan se lähettää Lähetä-painikkeella ja tämän jälkeen ladata ohjelmaan sovellusikkunan puolella Lataa tiedosto tietokantaan -painikkeella. 3.4 Siirtotiedostojen täyttämisessä huomioitavaa CSV-tiedoston avaaminen saattaa poistaa etunollia. Siirtotiedosto olisi hyvä tehdä Excel-tiedostona (.XLSX), jolloin solujen muotoilut säilyvät tiedostoa avattaessa. Etunollia sisältävät kentät voivat olla esimerkiksi tekstisoluja, jolloin etunollat säilyvät, ja oikeat tiedot ovat myöhemminkin käytettävissä. Kentät, joiden oikeellisuus kannattaa tarkistaa ennen siirtoa, ovat mm. puhelinnumero, OVT-tunnus ja EAN-koodi. Kun tiedosto on valmis siirrettäväksi, se tallennetaan CSV-muotoon. Siirto tehdään avaamatta CSV-tiedostoa. 3.5 Yritysrekisterin kentät Ohjelma tunnistaa CSV-kentän nimi -sarakkeessa olevat sarakenimet. Pituus-kentässä on kentän tyyppi (N = numeraali, C = teksti, PVM = päiväys) sekä kentän maksimipituus. Selite-kentässä on Yritysrekisterin kenttä, johon tieto siirretään. Selite-kentässä on myös kenttään liittyviä tarkennuksia. Esimerkiksi asiakastunnus/yritystunnus on pakollinen kenttä. CSV-kentän nimi Pituus Selite ASIAKASTUNNUS C10 Yritystunnus (Pakollinen) NIMI1 C40 Yrityksen nimi NIMI2 C40 Yrityksen lisänimi PUHELIN C25 Puhelinnumero MATKAPUHELIN C25 Matkapuhelin TELEFAX C25 Telefax YHTEYDENOTTOTAPA C3 Yhteydenottotapa. Yhteydenottotavat siirretään sisäisellä id-arvolla. Arvojoukko = { 001, 002, 003, 004, 005 }. Sisäinen id on Yhteydenottotavat rivin numero yritysrekisterin perustiedoissa. Jos sieltä on poistettu rivejä, numerointi ei enää ole yhtä looginen. Tällöin arvot tulee tarkistaa ulostuonnilla. KORONESTO C1 Koronesto, arvojoukko = {, X } KARHUESTO C1 Karhuesto, arvojoukko = {, X } Visma Fivaldi 40

41 MAKSUEHTO C4 Maksuehto (myynti). Numeerinen koodiarvo, joka on määritelty Yrityksen perustietojen Maksuehdot-välilehdellä. Aineiston maksuehdon koodit tulee olla perustettuna ennen sisäänlukua. ASIAKASRYHMA C10 Yritysryhmä ASIAKASSEGMENTTI C10 Yrityssegmentti LUOTTOKIELTO C1 Luottokielto, arvojoukko = {, X } KIELIKOODI C3 Kielikoodi, arvojoukko = { FIN, SWE, ENG } LUOTTORAJA N16,6 Luottoraja TOIMITUSTAPA C3 Toimitustapa. Toimitustavan selite, joka on määritelty Yrityksen perustietojen Toimitustavat-välilehdellä. Toimitustapa pitää olla perustettuna ennen sisäänlukua VALIASIAKAS C10 Väliyritys PAAASIAKAS C10 Pääyritys KONTAKTIPVM PVM Kontaktipäivä, päiväyksen muoto pp.kk.vvvv VALUUTTA C3 Valuutta YTUNNUS C30 Y-tunnus WWW C80 WWW-osoite SAHKOPOSTI C80 Sähköpostiosoite TILAPAISASIAKAS C1 Tilapäisasiakas (1 = on, NULL = ei) EITOIVOTTU C1 Ei toivottu (= X, muuten NULL) LISATIETO C80 Lisätieto PITKA_LISATIETO C4000 Lisätietoa ALENNUSRYHMA C4 Alennusryhmä TILAUKSETYHDISTETAAN C1 Tilaukset yhdistetään samalle laskulle? (1 = kyllä, 0 = ei) ALVREK C1 ALV/VAT rekist. 1 = Kyllä 0 = Ei Tyhjä = arvoa ei tuoda VASTUUHENKILO C40 Vastuuhenkilö KOTIPAIKKA C60 Kotipaikka YHTEYDENOTTOINFO C80 - info MAA C60 Aineiston maa tuodaan aina oman yrityksen kielellä. Esimerkiksi jos yrityksen kieli on suomi, aineistossa maatieto = Suomi. Jos oman yrityksen kieli on ruotsi, aineistossa maatieto = Finland. Huom. ohjelma ei tunnista maatiedossa isoja kirjaimia, eli esim. SUOMI po. Suomi. TILIOINTIRYHMA C40 Tiliöintiryhmän (myynti) selite. Tiliöintiryhmän selite pitää olla perustettuna ennen sisäänlukua Myynnin Perustiedoista Laskujen tiliöinti -ruudulla / Tiliöintiryhmät. LASKUTUSRAJA N16,6 Laskutusraja RAHOITUSYHTIO C1 Rahoitusyhtiö (= 1, muuten NULL) VIIVKORKO N10,6 Viivästyskorko ASIAKAS C1 Asiakas Visma Fivaldi 41

42 1 = Kyllä 0 tai tyhjä = asiakasvalintaa ei tuoda TOIMITTAJA C1 Toimittaja 1 = Kyllä 0 tai tyhjä = toimittajavalintaa ei tuoda PVIESTITYYPPI C1 Pankkisiirto-viestityyppi, sallitut arvot = {1, 2, 3, null} 1 = Viite 2 = Viesti 3 = Veroviesti OMA_ASIAKASTUNNUS C20 Oma asiakastunnus MAKSUPRIORITEETTI N1 Maksuprioriteetti, sallitut arvot = {1, 2, 3, 4, 5} 1 = Kiireellinen 2 = Tärkeä 3 = Normaali 4 = Ei niin tärkeä 5 = Voi odottaa TOIMITUSEHTO C80 Toimitusehto. Toimitusehdon selite, joka on määritelty Yrityksen perustietojen Toimitusehdot-välilehdellä. Toimitusehto tulisi olla perustettuna ennen sisäänlukua. SK1 C8 Seurantakohde 1 / Kustannuspaikka. Seurantakohteen koodi, joka on määritelty Tilikartat-rekisterin Seurantakohteet-välilehdellä. Seurantakohteet pitää olla perustettuna ennen sisäänlukua. SK2 C8 Seurantakohde 2 / Kustannuspaikka. Seurantakohteen koodi, joka on määritelty Tilikartat-rekisterin Seurantakohteet-välilehdellä. Seurantakohteet pitää olla perustettuna ennen sisäänlukua. SK3 C8 Seurantakohde 3 / Kustannuspaikka. Seurantakohteen koodi, joka on määritelty Tilikartat-rekisterin Seurantakohteet-välilehdellä. Seurantakohteet pitää olla perustettuna ennen sisäänlukua. SK4 C8 Seurantakohde 4 / Kustannuspaikka. Seurantakohteen koodi, joka on määritelty Tilikartat-rekisterin Seurantakohteet-välilehdellä. Seurantakohteet pitää olla perustettuna ennen sisäänlukua. VALITYS_TAPA_ID C40 Asiakkaan oletusvälitystapa. Välitystavan selite. Välitystapa pitää olla perustettuna ennen sisäänlukua Laskujen välitys -sovelluksessa. OVT_TUNNUS C17 OVT-tunnus FINVOICE_OSOITE_TYYPPI C1 Vastaanottajan verkkolaskuosoite, sallitut arvot = {'I', 'M', 'Y', 'O'} Y = Y-tunnus M = muu tunnus O = OVT-tunnus I = IBAN-tilinumero FINVOICE_OSOITE C30 Muu tunnus FINVOICE_VALITTAJA_TUNNUS C30 Vastaanottajan välittäjän tunnus Visma Fivaldi 42

43 ENNAKKOPERINTAREK_VOIMASSAPVM PVM Ennakkoperintärek. Voimassa Päiväyksen muoto dd.mm.vvvv OSTOTILIOINTIRYHMA C40 Tiliöintiryhmä. Toimittajan oletustiliöintiryhmä ostotilauksia tehdessä. Pitää olla perustettuna Ostotilausten Perustietoihin ennen sisäänlukua. OSTOTOIMITUSEHTO C80 Toimitusehto. Toimitusehdon selite, joka on määritelty Yrityksen perustietojen Toimitusehdot-välilehdellä. Toimitusehto tulisi olla perustettuna ennen sisäänlukua. OSTOTOIMITUSTAPA C80 Toimitustapa. Toimitustavan selite, joka on määritelty Yrityksen perustietojen Toimitustavat-välilehdellä. Toimitustapa pitää olla perustettuna ennen sisäänlukua OSTOMAKSUEHTO C4 Maksuehto (osto). Numeerinen koodiarvo, joka on määritelty Yrityksen perustietojen Maksuehdot-välilehdellä. Aineiston maksuehdon koodit tulee olla perustettuna ennen sisäänlukua. ULKOINEN_ID C30 TOIMLISATIETO C255 Toimituslisätieto OLETUSMYYJA C40 Oletus myyjänimi VIITENUMERON_MUOTO C2 Viitenumeron muoto sallitut arvot ={'VA', 'VL', 'LV' }. VA = Vakio VL = vakio + laskunumero LV = laskunumero + vakio " VIITENUMERON_VAKIOARVO C20 Vakioarvo SUORAV_SOPIMUS C30 Suoraveloitussopimus. Tämä ei ole tarpeellinen enää, sillä suoraveloitus on nykyään suoramaksu. FINVOICE_TILIOINTIEHDOTUS_TAPA C1 Tiliöintiehdotuksen tulkinta aineistosta. sallitut arvot = { 0, 2 } 0 = Ei tulkita NULL = Käytetään aineiston tiliöintiehdotusta 2 = Käytetään aineiston tiliöintiehdotusta, vain lyhyt tili FINVOICE_DIMENSIONTEXT_MASKI C40 Seurantakohde-ehdotuksen tulkintasääntö JAKELU_SAHKOPOSTI C80 Laskujen sposti FINVOICE_TILAUSPVM_RIVILLE C1 Aineistoon rivikohtainen tilauksen päivä. (1 = kyllä, 0 = ei) FINVOICE_BUYERPARTYIDENTIFIER C1 Ostajan asiakastunnukseksi (BuyerPartyIdentifier) sallitut arvot = {'A', M, 'O'} NULL = Y-tunnus O = OVT tunnus A = Yritystunnus M = Verkkolaskuosoitteessa annettu muu tunnus OSTOLASKUNUMERON_MUOTO C255 ELASKU_SUORAMAKSU C1 Suoramaksu (1 = kyllä, muuten NULL) TULOSTUSTAPA C40 Tulostustapa, pitää olla perustettuna Laskujen välityksen Perustiedoissa Posti-alkuiset kentät luovat osoite-rivejä joissa tyyppi = 'Postiosoite' Visma Fivaldi 43

44 POSTI_LAHIOSOITE C80 Lähiosoite POSTI_LAHIOSOITE2 C80 Lähiosoite 2 POSTI_POSTINUMERO C10 Postinumero POSTI_POSTIOSOITE C80 Postitoimipaikka POSTI_MAA C60 Aineiston maa tuodaan aina oman yrityksen kielellä. Esimerkiksi jos yrityksen kieli on suomi, aineistossa maatieto = Suomi. Jos oman yrityksen kieli on ruotsi, aineistossa maatieto = Finland. Huom. ohjelma ei tunnista maatiedossa isoja kirjaimia, eli ei SUOMI vaan Suomi. POSTI_PUH C25 Puhelin POSTI_NIMI C60 Nimi POSTI_HAKU C1 Pääos. = 1, muuten ei ole pääosoite POSTI_TOIMLISATIETO C255 Toimituslisätieto Kaynti-alkuiset kentät luovat osoite-rivejä joissa tyyppi == 'Käyntiosoite' KAYNTI_LAHIOSOITE C80 Lähiosoite KAYNTI_LAHIOSOITE2 C80 Lähiosoite 2 KAYNTI_POSTINUMERO C10 Postinumero KAYNTI_POSTIOSOITE C80 Postitoimipaikka KAYNTI_MAA C60 Aineiston maa tuodaan aina oman yrityksen kielellä. Esimerkiksi jos yrityksen kieli on suomi, aineistossa maatieto = Suomi. Jos oman yrityksen kieli on ruotsi, aineistossa maatieto = Finland. Huom. ohjelma ei tunnista maatiedossa isoja kirjaimia, eli ei SUOMI vaan Suomi. KAYNTI_PUH C25 Puhelin KAYNTI_NIMI C60 Nimi KAYNTI_HAKU C1 Pääos. = 1, muuten ei pääosoite KAYNTI_TOIMLISATIETO C255 Toimituslisätieto Laskutus-alkuiset kentät luovat osoite-rivejä joissa tyyppi == 'laskutusosoite' LASKUTUS_LAHIOSOITE C80 Lähiosoite LASKUTUS_LAHIOSOITE2 C80 Lähiosoite 2 LASKUTUS_POSTINUMERO C10 Postinumero LASKUTUS_POSTIOSOITE C80 Postitoimipaikka LASKUTUS_MAA C60 Aineiston maa tuodaan aina oman yrityksen kielellä. Esimerkiksi jos yrityksen kieli on suomi, aineistossa maatieto = Suomi. Jos oman yrityksen kieli on ruotsi, aineistossa maatieto = Finland. Huom. ohjelma ei tunnista maatiedossa isoja kirjaimia, eli ei SUOMI vaan Suomi. LASKUTUS_PUH C25 Puhelin LASKUTUS_NIMI C60 Nimi LASKUTUS_HAKU C1 Pääos. = 1, muuten ei pääosoite LASKUTUS_TOIMLISATIETO C255 Toimituslisätieto Toimitus-alkuiset kentät luovat osoite-rivejä joissa tyyppi == 'Toimitusosoite' TOIMITUS_LAHIOSOITE C80 Lähiosoite TOIMITUS_LAHIOSOITE2 C80 Lähiosoite Visma Fivaldi 44

45 TOIMITUS_POSTINUMERO C10 Postinumero TOIMITUS_POSTIOSOITE C80 Postitoimipaikka TOIMITUS_MAA C60 Aineiston maa tuodaan aina oman yrityksen kielellä. Esimerkiksi jos yrityksen kieli on suomi, aineistossa maatieto = Suomi. Jos oman yrityksen kieli on ruotsi, aineistossa maatieto = Finland. Huom. ohjelma ei tunnista maatiedossa isoja kirjaimia, eli ei SUOMI vaan Suomi. TOIMITUS_PUH C25 Puhelin TOIMITUS_NIMI C60 Nimi TOIMITUS_HAKU C1 Pääos. = 1, muuten ei pääosoite TOIMITUS_TOIMLISATIETO C255 Toimituslisätieto PTILI1_NIMI C70 Pankkitilin nimi (Pakollinen, jos luetaan pankkitili) PTILI1_BBAN C40 Tilinumero PTILI1_IBAN C50 IBAN-tilinumero (Pakollinen, jos luetaan pankkitili) PTILI1_BIC C11 BIC/SWIFT (Pakollinen, jos luetaan pankkitili) PTILI1_MAA C60 Aineiston maa tuodaan aina oman yrityksen kielellä. Esimerkiksi jos yrityksen kieli on suomi, aineistossa maatieto = Suomi. Jos oman yrityksen kieli on ruotsi, aineistossa maatieto = Finland. Huom. ohjelma ei tunnista maatiedossa isoja kirjaimia, eli ei SUOMI vaan Suomi. (Pakollinen, jos luetaan pankkitili) PTILI1_PANKKI_OSOITE C70 Pankin osoite PTILI1_CLEARING_KOODI C20 Clearing koodi PTILI1_ULK_MAKSUTAPA C1 Valuuttamaksun maksutapa sallitut arvot = {'M', P, 'Q', 'S', T, 'K', B } M = maksumääräys P = pikamääräys Q = swift-shekki S = shekki T = pankin sisäinen tilisiirto K = konsernimaksu B = EU-maksu (op) PTILI1_ULK_PALVELUMAKSU C1 Valuuttamaksun palvelumaksut sallitut arvot = {'J', T, 'V'} J = jaettu T = maksaja maksaa V = saaja maksaa PTILI1_FINVOICE_TUNNUS C1 Finvoice-tunnus 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda PTILI1_SUORAVELOITUS_OLETUS C1 Suoravelotuksen tili 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda Visma Fivaldi 45

46 PTILI1_ELASKU_LAHETTAJAILM C1 PTILI2_NIMI C70 Pankkitilin nimi (Pakollinen, jos luetaan pankkitili) PTILI2_BBAN C40 Tilinumero PTILI2_IBAN C50 IBAN-tilinumero (Pakollinen, jos luetaan pankkitili) PTILI2_BIC C11 BIC/SWIFT (Pakollinen, jos luetaan pankkitili) PTILI2_MAA C60 Aineiston maa tuodaan aina oman yrityksen kielellä. Esimerkiksi jos yrityksen kieli on suomi, aineistossa maatieto = Suomi. Jos oman yrityksen kieli on ruotsi, aineistossa maatieto = Finland. Huom. ohjelma ei tunnista maatiedossa isoja kirjaimia, eli ei SUOMI vaan Suomi. (Pakollinen, jos luetaan pankkitili) PTILI2_PANKKI_OSOITE C70 Pankin osoite PTILI2_CLEARING_KOODI C20 Clearing koodi PTILI2_ULK_MAKSUTAPA C1 Valuuttamaksun maksutapa sallitut arvot = {'M', P, 'Q', 'S', T, 'K', B } M = maksumääräys P = pikamääräys Q = swift-shekki S = shekki T = pankin sisäinen tilisiirto K = konsernimaksu B = EU-maksu (op) PTILI2_ULK_PALVELUMAKSU C1 Valuuttamaksun palvelumaksut sallitut arvot = {'J', T, 'V'} J = jaettu T = maksaja maksaa V = saaja maksaa PTILI2_FINVOICE_TUNNUS C1 Finvoice-tunnus 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda PTILI2_SUORAVELOITUS_OLETUS C1 Suoravelotuksen tili 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda PTILI2_ELASKU_LAHETTAJAILM C1 PTILI3_NIMI C70 Pankkitilin nimi (Pakollinen, jos luetaan pankkitili) PTILI3_BBAN C40 Tilinumero PTILI3_IBAN C50 IBAN-tilinumero (Pakollinen, jos luetaan pankkitili) PTILI3_BIC C11 BIC/SWIFT (Pakollinen, jos luetaan pankkitili) PTILI3_MAA C60 Aineiston maa tuodaan aina oman yrityksen kielellä. Esimerkiksi jos yrityksen kieli on suomi, aineistossa maatieto = Suomi. Jos oman yrityksen kieli on ruotsi, aineistossa maatieto = Finland. Huom. ohjelma ei tunnista maatiedossa isoja kirjaimia, eli ei SUOMI vaan Suomi. (Pakollinen, jos luetaan pankkitili) Visma Fivaldi 46

47 PTILI3_PANKKI_OSOITE C70 Pankin osoite PTILI3_CLEARING_KOODI C20 Clearing koodi PTILI3_ULK_MAKSUTAPA C1 Valuuttamaksun maksutapa sallitut arvot = {'M', P, 'Q', 'S', T, 'K', B } M = maksumääräys P = pikamääräys Q = swift-shekki S = shekki T = pankin sisäinen tilisiirto K = konsernimaksu B = EU-maksu (op) PTILI3_ULK_PALVELUMAKSU C1 Valuuttamaksun palvelumaksut sallitut arvot = {'J', T, 'V'} J = jaettu T = maksaja maksaa V = saaja maksaa PTILI3_FINVOICE_TUNNUS C1 Finvoice-tunnus 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda PTILI3_SUORAVELOITUS_OLETUS C1 Suoravelotuksen tili 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda PTILI3_ELASKU_LAHETTAJAILM C1 PTILI4_NIMI C70 Pankkitilin nimi (Pakollinen, jos luetaan pankkitili) PTILI4_BBAN C40 Tilinumero PTILI4_IBAN C50 IBAN-tilinumero (Pakollinen, jos luetaan pankkitili) PTILI4_BIC C11 BIC/SWIFT (Pakollinen, jos luetaan pankkitili) PTILI4_MAA C60 Aineiston maa tuodaan aina oman yrityksen kielellä. Esimerkiksi jos yrityksen kieli on suomi, aineistossa maatieto = Suomi. Jos oman yrityksen kieli on ruotsi, aineistossa maatieto = Finland. Huom. ohjelma ei tunnista maatiedossa isoja kirjaimia, eli ei SUOMI vaan Suomi. (Pakollinen, jos luetaan pankkitili) PTILI4_PANKKI_OSOITE C70 Pankin osoite PTILI4_CLEARING_KOODI C20 Clearing koodi PTILI4_ULK_MAKSUTAPA C1 Valuuttamaksun maksutapa sallitut arvot = {'M', P, 'Q', 'S', T, 'K', B } M = maksumääräys P = pikamääräys Q = swift-shekki S = shekki T = pankin sisäinen tilisiirto K = konsernimaksu Visma Fivaldi 47

48 B = EU-maksu (op) PTILI4_ULK_PALVELUMAKSU C1 Valuuttamaksun palvelumaksut sallitut arvot = {'J', T, 'V'} J = jaettu T = maksaja maksaa V = saaja maksaa PTILI4_FINVOICE_TUNNUS C1 Finvoice-tunnus 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda PTILI4_SUORAVELOITUS_OLETUS C1 Suoravelotuksen tili 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda PTILI4_ELASKU_LAHETTAJAILM C1 HENKILO1_NIMI C40 Nimi (Etu- ja Sukunimi tai Suku- ja Etunimi - muoto on oma valinta) HENKILO1_PUHELIN C25 Puhelin HENKILO1_PUHELIN2 C25 Puhelin 2 (esim. matkapuhelin) HENKILO1_FAX C25 Fax HENKILO1_KONTAKTIPVM PVM Kontaktiaika päiväyksen muoto pp.kk.vvvv HENKILO1_SAHKOPOSTI C80 Sähköpostiosoite HENKILO1_ASIA C1024 Asia (vapaa teksti) HENKILO1_TITTELI C18 Titteli HENKILO1_POSTITUSRYHMA C6 Postitusryhmä HENKILO1_ULKOINEN_ID C30 HENKILO2_NIMI C40 Nimi (Etu-ja Sukunimi tai Suku- ja Etunimi - muoto on oma valinta) HENKILO2_PUHELIN C25 Puhelin HENKILO2_PUHELIN2 C25 Puhelin 2 (esim. matkapuhelin) HENKILO2_FAX C25 Fax HENKILO2_KONTAKTIPVM PVM Kontaktiaika päiväyksen muoto pp.kk.vvvv HENKILO2_SAHKOPOSTI C80 Sähköpostiosoite HENKILO2_ASIA C1024 Asia (vapaa teksti) HENKILO2_TITTELI C18 Titteli HENKILO2_POSTITUSRYHMA C6 Postitusryhmä HENKILO2_ULKOINEN_ID C30 HENKILO3_NIMI C40 Nimi (Etu-ja Sukunimi tai Suku- ja Etunimi - muoto on oma valinta) HENKILO3_PUHELIN C25 Puhelin HENKILO3_PUHELIN2 C25 Puhelin 2 (esim. matkapuhelin) HENKILO3_FAX C25 Fax HENKILO3_KONTAKTIPVM PVM Kontaktiaika päiväyksen muoto pp.kk.vvvv HENKILO3_SAHKOPOSTI C80 Sähköpostiosoite HENKILO3_ASIA C1024 Asia (vapaa teksti) Visma Fivaldi 48

49 HENKILO3_TITTELI C18 Titteli HENKILO3_POSTITUSRYHMA C6 Postitusryhmä HENKILO3_ULKOINEN_ID C30 HENKILO4_NIMI C40 Nimi (Etu-ja Sukunimi tai Suku- ja Etunimi - muoto on oma valinta) HENKILO4_PUHELIN C25 Puhelin HENKILO4_PUHELIN2 C25 Puhelin 2 (esim. matkapuhelin) HENKILO4_FAX C25 Fax HENKILO4_KONTAKTIPVM PVM Kontaktiaika päiväyksen muoto pp.kk.vvvv HENKILO4_SAHKOPOSTI C80 Sähköpostiosoite HENKILO4_ASIA C1024 Asia (vapaa teksti) HENKILO4_TITTELI C18 Titteli HENKILO4_POSTITUSRYHMA C6 Postitusryhmä HENKILO4_ULKOINEN_ID C Yritysrekisterin kentät Fivaldissa Visma Fivaldi 49

50 Visma Fivaldi 50

51 Visma Fivaldi 51

52 3.6 Tuoterekisterin kentät Ohjelma tunnistaa CSV-kentän nimi -sarakkeessa olevat sarakenimet. Pituus-kentässä on kentän tyyppi (N = numeraali, C = teksti, PVM = päiväys) sekä kentän maksimipituus. Selite-kentässä on Tuoterekisterin kenttä johon tieto siirretään. Selite-kentässä on myös kenttään liittyviä tarkennuksia. Esimerkiksi tuotekoodi on pakollinen kenttä. CSV-kentän nimi Pituus Selite TUOTEKOODI C20 Tuotekoodi (Pakollinen tieto) TUOTERYHMANIMI C40 Tuoteryhmä ohjelma perustaa aineiston tuoteryhmän jos puuttuu tuoterekisteristä. TUOTTEENNIMI C80 Tuotenimi Tuotteen nimi ja Nimen_jatke kenttien max. yhteispituus on 80 merkkiä. Ulosluettaessa Tuotteen nimi kentään tulee merkit Sisään luettaessa kentät yhdistetään. NIMEN_JATKE Tuotenimi Tuotteen nimi ja Nimen_jatke kenttien max. yhteispituus on 80 merkkiä. Ulosluettaessa Nimen_jatke kenttään tulee merkit Sisään luettaessa kentät yhdistetään. KUVAUS C1024 Kuvaus OKHINTA N13 Omakustannushinta HINTA N8,6 Myyntihinta ALENNUSRYHMA C6 Alennusryhmä HINTAKOODI C1 Katelaskenta sallitut arvot = {1,2,3,4,5} 1 = Tuotetta ei huomioida katelaskennassa 2 = Tuotteelle annettu veroton omakustannushinta 3 = Omakustannushinta on viimeisin ostohinta 4 = Omakustannus on määritelty bruttoprosentilla 5 = Omakustannushinta on varaston hankintahinta RIVILISATIETO C1 Kuvaus rivilisätiedoksi? (1 = kyllä, 0/NULL = ei) VARASTO C1 Varasto, sallitut arvot {0,1,2} 0 = Ei 1 = Kyllä 2 = Kyllä, eräseuranta WEB_MYYNTI C1 Myynnissä web-kaupassa? (1 = kyllä, 0/NULL = ei) ALKUMAA C2 Alkumaa, tuotteen 2 merkkinen alkuperämaan koodi TILAUSRAJA N5 Tilausraja MENEKKI1 N7 Menekki1 MENEKKI2 N7 Menekki2 TAKUUAIKA N6 Takuuaika kuukausissa (vain numeroita, kenttä on vuosi/kk) YKSIKON_PAINO N7 Paino, yksikön paino Paino voi olla max 7 merkkiä pitkä ja desimaaleja max 3. (Pilkku on yksi merkki, esim. 123,123 ). Huom! Sarakkeessa ei saa olla mitään muita merkkejä kuin edellä mainittu muoto EAN_KOODI C20 EAN/UPC-koodi CNKOODI C10 CN-nimike Visma Fivaldi 52

53 CNPAINO N14 paino (kg) Paino voi olla max 14 merkkiä pitkä ja desimaaleja max 6. (Pilkku on yksi merkki, esim , ). Huom! Sarakkeessa ei saa olla mitään muita merkkejä kuin edellä mainittu muoto CN2YKSIKKO C4 Toinen paljous yksikkö CN2KERROIN N14 Toinen paljous kerroin Kerroinluku voi olla max 14 merkkiä pitkä ja desimaaleja max 6. (Pilkku on yksi merkki, esim , ). Huom! Sarakkeessa ei saa olla muita merkkejä kuin edellä mainittu muoto. YKSIKKO C3 Perusyksikkö Oletusmyyntiyksikkö Yksikkö (Toimittajan) OLETUSMYYNTIYK- C3 Oletusmyyntiyksikkö SIKKO OLETUSMYYNTI- Oletusmyyntimäärä MAARA TUOTENUMERO C9 Toimittajan tuotekoodi RESURSSI Resurssi Kenttään voidaan määritellä tuotteelle jokin työaikamäärite. Erikoisraportoinnissa voidaan tällöin käyttää hyväksi tilauksilla olevaan tuotteeseen sidottua aikaa (esim. 10 min) ja saada tietoa todellisesta työajasta yhteensä ko. asiakkaan/tuotteen osalta. www C1024 Esittelylinkki TOIMTUOTEKOODI C9 Toimittajan tuotekoodi Jos toimittajatunnus annettu ruudulla ja ostoyksikko annettu Toimittajatiedot välilehti: OSTOYKSIKKO C20 Yksikkö OSTOYKSIKKOKER- N10,4 Yksikön kerroin ROIN OSTOHINTA N10,4 Ostohinta (Tuotteen perustiedot -ruudulla) sekä toimittajan ostohinta. Jos halutaan päivittää olemassa olevan tuoterekisterin toimittajakohtainen ostohinta, aineiston sisäänlatauksessa valitun toimittajan pitää löytyä myös tuoterekisteristä aineiston tuotteiden Toimittajatiedot-välilehdeltä. OSTOMINIMITILAUS N18 Minimi tilausmäärä OSTOALENNUSPR N4,2 Ale % OSTOTILAVUUS N10,4 Tilavuus OSTOPAINO N10,4 Paino OSTOCNPAINO N10,4 CN-Paino OSTOCN2YKSIKKO C20 Toinen paljous yksikkö OSTOCN2KERROIN N10,4 kerroin Jos varastonumero annettu ruudulla Varastovalvonta Ylläpito näyttö VARASTOSALDO N12 Tuotteen varastosaldo Visma Fivaldi 53

54 VARASTOHALYTYS- N12 Tuotteen hälytysraja RAJA VARASTOHYLLY C20 Hyllykoodi Visma Fivaldi 54

55 3.6.1 Tuoterekisterin kentät Fivaldissa Visma Fivaldi 55

56 3.7 Budjettien tuonnin kentät Ohjelma tunnistaa CSV-kentän nimi -sarakkeessa olevat sarakenimet. Pituus-kentässä on kentän tyyppi (N = numeraali, C = teksti, PVM = päiväys) sekä kentän maksimipituus. Selite-kentässä on Talousarvion kenttä johon tieto siirretään. Selite-kentässä on myös kenttään liittyviä tarkennuksia. Ohjelma tunnistaa seuraavat sarakenimet. Kentän nimi ja selite viittaavat Kirjanpito > Talousarviot -näytöllä oleviin kenttien nimiin. CSV-kentän nimi Pituus Kentän nimi Selite BUDJETTI C20 Talousarvio Talousarvion tunnus NIMI C255 Selite Talousarvion nimi TILIKAUSI C4 Vuosi Vuosi, jolle budjettiluku kirjataan KAUSI C6 Kausi Kausi, jolle budjettiluku kirjataan TILI C8 Tili Tili, jolle budjettiluku kirjataan SK1 - SK4 C8 KP1-KP4 Taso 1-4. Seurantakohdeyhdistelmä jolle budjettiluku kirjataan. KP = kustannuspaikka. Ei pakollinen tieto. SUMMA N18,6 Summa Summa Aineistossa on aina oltava kentät: TILI, SUMMA Aineistossa on oltava jompikumpi kenttä: TILIKAUSI, KAUSI Visma Fivaldi 56

57 Yllä olevan esimerkkiaineiston tiedot näkyvät talousarviolla alla olevan kuvan mukaisesti. Talousarvio löytyy Visma Fivaldin Java-puolelta (Taloushallinto > Kirjanpito, sitten ylävalikosta Kirjanpito > Talousarviot). 3.8 Palkansaajien tuonnin kentät Ohjelma tunnistaa CSV-kentän nimi -sarakkeessa olevat sarakenimet. Pituus-kentässä on kentän tyyppi (N = numeraali, C = teksti, PVM = päiväys) sekä kentän maksimipituus. Selite-kentässä on palkansaajan kenttä johon tieto siirretään. Selite-kentässä on myös kenttään liittyviä tarkennuksia. CSV-kentän nimi Pituus Selite ETUNIMI C60 Etunimi SUKUNIMI C60 Sukunimi MUUT_NIMET C60 Muut nimet HETU C11 Syntymäaika ja Hetun loppuosa, muoto on suomalainen hetu YTUNNUS C14 Y-tunnus KANSALAISUUS C2 Kansalaisuus, arvojoukko = { FI, SE, EN } KIELIKOODI C3 Kielikoodi, arvojoukko = { FIN, SWE, ENG } SAHKOPOSTI C128 Sähköposti MAKSU_KASSASTA C1 Maksu kassasta 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda PAIVARAHAMAKSUPROSENTTI N3,2 Poikkeava päivärahamaksuprosentti ULKOINEN_TUNNUS C20 Ulkoisen järj. tunnus. Palkansaajan tunnus ulkoisessa järjestelmässä. Tällä tiedolla palkkalaskelma osataan kohdistaa oikeaan palkansaajaan. LAHETYSTAPA C1 Palkkalaskelman lähetystapa Visma Fivaldi 57

58 O / tyhjä = Oletus V = Visma verkkopalkka T = Tulostus S = Sähköposti P = Tulostuspalvelu VERONUMERO C12 Veronumero ULKOMAALAINEN_HETU C20 Ulkomaalainen hetu LAHIOSOITE C80 Lähiosoite LAHIOSOITE2 C80 Lähiosoite 2 POSTINUMERO C10 Postinumero POSTIOSOITE C80 Postitoimipaikka MAA C2 Maa, kahdella merkillä ISO alpha-2 mukaisesti (FI, SE ) PANKKITILI_SELITE C40 Pankkitilit Selite PANKKITILI_MAA C2 Pankkitilit Maa, kahdella merkillä ISO alpha-2 mukaisesti (FI, SE ) PANKKITILI_TILINUMERO C40 Pankkitilit Tilinumero PANKKITILI_IBAN C50 Pankkitilit IBAN PANKKITILI_BIC C11 Pankkitilit BIC PUHELINNUMERO C25 Puhelinnumerot Numero PUHELIN_SELITE C30 Puhelinnumerot Selite SMS C1 SMS 1 = Kyllä 0 tai tyhjä = valintaa ei tuoda TYOSUHDE_ALKUPVM PVM Työsuhteen alkupäivä. Päiväyksen muoto pp.kk.vvvv TYOSUHDE_LOPPUPVM PVM Työsuhteen päättymispäivä. Päiväyksen muoto pp.kk.vvvv 3.9 Palkkatietojen tuonnin kentät Ohjelma tunnistaa CSV-kentän nimi -sarakkeessa olevat sarakenimet. Pituus-kentässä on kentän tyyppi (N = numeraali, C = teksti, PVM = päiväys) sekä kentän maksimipituus. Selite-kentässä on palkanlaskennan kenttä johon tieto siirretään. Selite-kentässä on myös kenttään liittyviä tarkennuksia. Palkkatietojen CSV-mallin sarakkeista ainakin PVM, HENKILÖ, PALKKALAJI ja MÄÄRÄ tulee sisältyä sisäänluettavaan tiedostoon. Tiedot luetaan palkanlaskennan vastaaviin kenttiin. Jos ilmoitetaan poissaoloja ja tieto halutaan ilmoittaa tulorekisteriin, pitää poissaolorivillä olla myös LOMA_ALKUPVM ja LOMA_LOPPUPVM. Muilla kuin poissaoloriveillä tietoa ei tarvita. CSV-kentän nimi Pituus Selite ERA Vapaavalintainen erän tunniste, joka estää aineiston luennan uudelleen. PVM PVM Päivämäärä. Palkkatapahtuman päivä, päiväyksen muoto pp.kk.vvvv. Tätä käytetään tapahtuman kohdistamiseen palkkakaudelle. HENKILÖ C10 Palkansaaja. Fivaldin henkilötunnus tai ulkoisen järjestelmän tunnus. Ulkoisen järjestelmän tunnus tulee määrittää Fivaldiin henkilön perustietoihin Visma Fivaldi 58

59 PALKKALAJI C8 Palkkalaji. Fivaldin palkkalaji tai ulkoisen järjestelmän palkkalaji. Ulkoisen järjestelmän palkkalaji tulee määrittää Fivaldin vastaavaan palkkalajiin Palkkalajeissa. MAARA N13,3 Määrä SK1 C8 Seurantakohde 1. Seurantakohde 1 / Kustannuspaikka. Seurantakohteen koodi joka on määritelty Tilikartat-rekisterin Seurantakohteet-välilehdellä. Seurantakohteet pitää olla perustettuna ennen sisäänlukua. SK2 C8 Seurantakohde 2. Seurantakohde 2 / Kustannuspaikka. Seurantakohteen koodi joka on määritelty Tilikartat-rekisterin Seurantakohteet-välilehdellä. Seurantakohteet pitää olla perustettuna ennen sisäänlukua. SK3 C8 Seurantakohde 3. Seurantakohde 3 / Kustannuspaikka. Seurantakohteen koodi joka on määritelty Tilikartat-rekisterin Seurantakohteet-välilehdellä. Seurantakohteet pitää olla perustettuna ennen sisäänlukua. SK4 C8 Seurantakohde 4. Seurantakohde 4 / Kustannuspaikka. Seurantakohteen koodi joka on määritelty Tilikartat-rekisterin Seurantakohteet-välilehdellä. Seurantakohteet pitää olla perustettuna ennen sisäänlukua. KERROIN N14,4 Kerroin HINTA N13,3 á-hinta. Mikäli tietoa ei tule aineistossa, käytetään palkkalajin / henkilön palkkalajilta löytyvää arvoa. KULUTILI C8 Korvaava kirjanpidon tili palkkalajille. SELITE Lisätieto PÄIVITYSTAPA C1 Seurantakohteiden luenta: 1 - Seurantakohteet luetaan aineistosta 2 - Seurantakohteet luetaan henkilön oletustiedoista 3 - Ensisijaisesti aineiston kohteet, toiseksi henkilön oletuskohteet Oletusarvona 1 LOMA_ALKUPVM PVM Päivämäärä. Loman alkupäivä, päiväyksen muoto pp.kk.vvvv. Tietoa käytetään poissaolon ilmoittamisessa tulorekisteriin. Tieto luetaan palkkariville kenttään Ansainta-aika alkupvm. LOMA_LOPPUPVM PVM Päivämäärä. Loman loppupäivä, päiväyksen muoto pp.kk.vvvv. Tietoa käytetään poissaolon ilmoittamisessa tulorekisteriin. Tieto luetaan palkkariville kenttään Ansainta-aika loppupvm. Esimerkkitiedosto: PVM, HENKILO, PALKKALAJI ja MAARA tulee sisältyä sisäänluettavaan tiedostoon. Tiedot luetaan palkanlaskennan vastaaviin kenttiin Visma Fivaldi 59

60 3.10 Visma Expense -matkalaskujärjestelmän aineiston tuonti Visma Expense -matkalaskujärjestelmän tuottama aineisto voidaan lukea sisään Visma Fivaldin palkkatapahtumiksi Fivaldin Java-puolen Muut-välilehdeltä löytyvällä CSV- tiedoston lataus -apuohjelmalla. Expense-aineiston sisältämät mahdolliset seurantakohteet tulee perustaa Fivaldiin ennen aineiston sisäänlukua. Aineiston seurantakohdetasojen nimien ja laskentakohteiden koodien tulee vastata Fivaldin Tilikartta-rekisterin Seurantakohteet-ruudun tietoja. Kyseisille palkkalajeille ei tule olla määriteltynä kertoimia. Visma Expense -muoto: CSV-kentän nimi Pituus Kenttä palkanlaskennassa Selite Employee C10 Palkansaaja Fivaldin henkilötunnus tai ulkoisen järjestelmän tunnus. Ulkoisen järjestelmän tunnus tulee määrittää Fivaldiin henkilön perustietoihin PayCode C8 Palkkalaji Fivaldin palkkalaji tai ulkoisen järjestelmän palkkalaji. Ulkoisen järjestelmän palkkalaji tulee määrittää Fivaldin vastaavaan palkkalajiin Palkkalajeissa. TransferDate PVM Päivämäärä Palkkatapahtuman päivä, päiväyksen muoto pp.kk.vvvv. Tätä käytetään tapahtuman kohdistamiseen palkkakaudelle. Quantity N13,3 Määrä UnitPrice N13,3 á-hinta Mikäli tietoa ei tule aineistossa, käytetään palkkalajin / henkilön palkkalajilta löytyvää arvoa. TotalValue ei käytössä, saa olla mitä vaan Visma Fivaldi 60

61 Description C200 Lisätieto Ei saa sisältää rivinvaihtoja Seurantakohde a C8 Seurantakohde 1 Seurantakohdetason nimi otsikkorivissä ja koodi datassa Seurantakohde b C8 Seurantakohde 2 Seurantakohdetason nimi otsikkorivissä ja seurantakohteen koodi datassa Seurantakohde c C8 Seurantakohde 3 Seurantakohdetason nimi otsikkorivissä ja seurantakohteen koodi datassa Seurantakohde d C8 Seurantakohde 4 Seurantakohdetason nimi otsikkorivissä ja seurantakohteen koodi datassa Seurantakohteita voi olla 1-4. Seurantakohde voi myös puuttua välistä, eli otsikoissa voi olla vain esimerkiksi seurantakohde 1 ja seurantakohde 4. Esimerkkitiedosto: Visma Fivaldi 61

62 3.11 CSV-tiedoston lataus CSV-tiedoston lataus löytyy sovellusikkunan Visma Fivaldin Java-puolen Muut-välilehdeltä: Yleiset tiedot -osiosta valitaan CSV-ladattavan tiedoston tyyppi (yllä valittu Yritystiedosto, jolloin valinnan oikealla puolella näkyvät sen lisävalinnat): Budjettitiedosto Palkkatapahtumatiedosto Palkansaajatiedosto Tuotetiedosto Yritystiedosto Visma Fivaldi 62

63 Kun haluttu tiedoston tyyppi ja siihen liittyvät mahdolliset lisävalinnat on tehty, napsautetaan Valitse tiedosto -painiketta. Valitse tiedosto -ruutu avautuu Web-selaimeen: Sisäänladattava tiedosto etsitään Selaa-painiketta napsauttamalla: Kun tiedosto on valittu, napsautetaan Lähetä-painiketta. Lähetyksen jälkeen tiedoston sisältö viedään tietokantaan sovellusikkunan Lataa tiedosto tietokantaan -painiketta napsauttamalla: Onnistuneen tietokantaan latauksen jälkeen napsautetaan OK, minkä jälkeen sovelluksesta voidaan tarkastella tuotuja tietoja. Mikäli tuonti kaatuu virheilmoitukseen, voi rivikohtaiset virheet katsoa Virheelliset rivit -välilehdeltä. Tietosisällöstä johtuvat virheet tulee korjata tiedostoon. Tämän jälkeen tiedoston lataus voidaan tehdä uudestaan Visma Fivaldi 63

64 Yritystiedosto Yritystiedoston kohdalla tulee tehdä valinta siitä, halutaanko osoitteet uusina (oletus), eli lisäyksenä jo yritysrekisterissä oleviin, vai poistetaanko vanhat ensin. Poisto tarkoittaa, että vanhoille osoitteille asetetaan loppupvm. Vanhat osoitteet näkyvät osoitetaulussa viimeisenä, eivätkä ole enää aktiivisessä käytössä. Huom! CSV-vienti ja -tuonti tukevat korkeintaan yhtä osoitetta per tyyppi, eli jos asiakkaalla on esimerkiksi kymmenen toimitusosoitetta ja niiden halutaan pysyvän aktiivisina, kannattaa osoitteet tuoda uusina. Yrityksen kieli (yrityksen perustiedoissa) on se kielivalinta, joka määrittää millä kielellä CSV-vienti ja -tuonti kirjoittaa ja lukee maksuehtoa sekä maanimiä. Eli jos yrityksen kieli on ENG, pitää maat olla englanniksi, esim Finland. Jos aineistossa on virheellisiä rivejä, mitään ei lueta sisälle. Yritysrekisteriruudulla menneellä loppupvm:llä merkatut osoitteet siirtyvät automaattisesti osoitelistan alimmaisiksi. Seuraavat tiedot luodaan automaattisesti Fivaldin perustietoihin ja tuodaan yritysrekisteriin jos aineisto sisältää ko. tiedon. Näitä ei siis tarvitse perustaa Fivaldiin ennen sisäänlukua: myyjä toimitusehto (myynnin ja ostojen) toimitustapa (myynnin ja ostojen) Seuraavat tiedot tulee olla perustettuna Fivaldiin ennen aineiston sisäänlukua. Jos aineisto sisältää näiden osalta tiedon, jota ei vielä löydy, ohjelma ilmoittaa sisäänluvussa aineistoa koskevan rivinumeron ja virheen josta kyse. Sisäänluku on estetty ennen kuin aineiston sisältämät tiedot on perustettu Fivaldiin: välitystapa tiliointiryhmä (myynnin ja ostojen) maksuehto (myynnin ja ostojen) Kaikki yritysrekisterin valintalistat joissa on Maa-tieto: yrityksen maa osoitteiden maa pankkitilien maa Visma Fivaldi 64

65 Tuotetiedosto Tuotetiedoston valinnan tiimoilta on Tuotetiedot-osassa tuotetietojen lataukseen liittyvää lisätietoa. Käyttäjä voi määrittää Tiliöintiryhmä-Tiliöintikoodi-relaatiot ennen aineiston sisäänlukua. Alemmassa laatikossa näkyy tuotetiedoston lisäys- ja päivitys-lisävalinnat. Näistä ruksataan jompikumpi tai molemmat. Virheelliset rivit näkyvät Virheelliset rivit -välilehdellä, vain virheettömät aineistot luetaan sisälle Visma Fivaldi 65

66 Palkkatapahtumatiedosto CSV-tiedoston lataus -apuohjelmassa sisäänluvussa valitaan tyypiksi Palkkatapahtumatiedosto, valitaan tiedosto koneelta ja ladataan se tietokantaan. Palkanlaskentaan tietoja luettaessa siirrytään onnistuneen sisäänluvun jälkeen Palkanlaskentaan (Palkat > Palkanlaskenta) ja valitaan sitten ylävalikosta Palkanlaskenta > Tietojen tuonti. Valitaan tuotava tapahtumaerä ja napsautetaan Vie tiedot palkanlaskentaan -painiketta. Lopuksi napsautetaan OK. Ilmoitus kertoo, että tiedot on tuotu palkanlaskentaan normaalia tarkastusta ja käsittelyä varten Visma Fivaldi 66

67 3.12 Yritys-/tuorerekisterin ulosvienti Tuote- ja yritysrekisterit voidaan siirtää / kopioida toisesta Fivaldi-yrityspaikasta toiseen Fivaldi-yrityspaikkaan CSVtiedoston lataus -apuohjelman avulla. Tiedostot ladataan ulos Visma Fivaldin Web-puolen Muut-valikon Rajapinnatraporteista. Muut-valikon raporteista valitaan Rajapinnat: Valitaan joko Tuotetiedot csv-tiedostoksi tai Yritysrekisteri csv-tiedostoksi -raportti ja määritellään raportin muodoksi CSV. Lopuksi napsautetaan Tulosta/tallenna-painiketta: Budjettitietojen esimerkkiaineisto saadaan ulos Visma Fivaldin Java-puolelta (Taloushallinta > Kirjanpito ja sen jälkeen ylävalikosta Kirjanpito > Tiedon vienti, avautuvasta listasta valitaan Talousarvion vienti CSV-tiedostoksi, sitten napsautetaan Vie tiedot -painiketta). Tallenna tiedosto koneellesi ja sisäänlue aineisto tämän jälkeen CSV-tiedoston lataus -apuohjelman kautta Visma Fivaldi 67

68 4 Reskontrasiirrot Myynti- sekä ostoreskontraan voidaan tuoda ulkopuolisen järjestelmän tuottamaa aineistoa.txt -muodossa. Tietojen tuonti -apuohjelmat ovat erikseen tilattavia tuotteita ja ne voi tilata Visma Fivaldin myynnistä. Tilauksen yhteydessä toimitetaan aineiston kuvaus välitettäväksi ulkopuolisen järjestelmän toimittajalle. Reskontrasiirrot: perustavat asiakkaat yritysrekisteriin, säilyttävät alkuperäisen laskun viitenumeron, eivät muodosta laskun kuvaa ja tukevat rivitasoista tili- ja kustannuspaikkakäsittelyä. Kappaleissa 4.1 ja 0 on kuvattu tietuekuvaukset myynti- ja ostoreskontrasiirtoon ulkoisesta järjestelmästä Fivaldiin. Siirtotiedosto on tavallinen tekstitiedosto DOS- tai unix-rivinvaihdoin (CR LF, tai LF). Huomioitavia asioita: Kenttiä ei erotella erotinmerkeillä. Numeeriset kentät täytetään etunollilla. Esimerkiksi rivin summa Tekstikenttien loppuosa täytetään blankoilla. Esim. asiakastunnus Kaikki rahakentät ilmoitetaan kahdella desimaalilla. Desimaalierotinta ei käytetä. Esimerkiksi senttiä merkitään Jokaisen rahakentän perässä on etumerkkiä kuvaava tunnus ("tyhjä" on normaali, "-" on hyvitys). (O)RESTAP-rivien summien (summa + vero, valuuttasumma + valuuttavero) yhteissumma tulee täsmätä (O)RESLAS-rivin vastaaviin summiin (summa, valuuttasumma). 4.1 Myyntireskontra Myyntireskontran linkki sisältää kahta eri tietuetyyppiä, laskun yleistietue (RESLAS) ja laskurivit eli myyntirivit (RESTAP). Ensiksi tulee RESLAS-tietue ja sen jälkeen kaikki RESTAP-tietueet, kuitenkin vähintään yksi. Laskun (RESLAS-tietue) summan täytyy täsmätä kaikkien kyseisen laskun RESTAP-tietueiden yhteenlaskettuun summaan. Alla esimerkki RESLAS-tietueesta ja RESTAP-tietueesta. RESLAS-tietue Kenttä Tyyppi Pituus Alkupos Pakollinen Selitys yritysnumero N 6 1 K Fivaldissa oleva yritysnumero laji C 6 7 K RESLAS asiakastunnus C K Asiakkaan numero laskun numero N 8 23 K Laskun numero hyvlaskun numero N 8 31 E Hyvitettävän laskun numero, vain hyvityslaskulla (ei pakollinen) kausi N 6 39 K vvvvkk laskun päivä N 6 45 K vvkkpp Visma Fivaldi 68

69 maksuehto C 4 51 K Maksuehdon numero kassa-alennuspvm N 6 55 E Kassa-alennuksen pvm vvkkpp kassa-prosentti N 2 61 E Kassa-alennuksen prosentti, ei desimaaleja nettoeräpäivä N 6 63 K Laskun nettoeräpäivä, vvkkpp laskun summa N K Laskun summa yrityksen valuutassa, brutto etumerkki C 1 87 K "-" hyvitys, ' ' ns. normaali valuuttatunnus C 3 88 E Valuuttatunnus esim. USD valuuttasumma N E Valuuttasumma etumerkki C E Ks. edellä kurssi N E valuuttakurssi, kuusi desimaalia tilisaamistili C K Kirjanpidon tilisaamistili viite N K Pankkiviite sisältäen tarkisteen viesti C E Vapaamuotoinen viesti asiakkaan nimi1 C E Asiakkaan nimi1 perintään / rekisteriin asiakkaan nimi2 C E Asiakkaan nimen jatko-osa lähiosoite 1 C E Laskutusosoitteen ensimmäinen rivi lähiosoite 2 C E Osoitteen mahdollinen toinen rivi postiosoite C E Postinumero ja postitoimipaikka maakoodi C E Asiakkaan maa, ISO 3166 mukaisella koodilla RESTAP-tietue Kenttä Tyyppi Pituus Alkupos Pakollinen Selitys yritysnumero N 6 1 K Fivaldissa oleva yritysnumero laji C 6 7 K RESTAP asiakastunnus C K Asiakkaan numero laskun numero N 8 23 K Laskun numero myyntitili C 8 31 K Kirjanpidon myyntitili seurantakohde 1 C 8 39 E Projektinumero seurantakohde 2 C 8 47 E Kirjanpidon kustannuspaikka seurantakohde 3 C 8 55 E Kirjanpidon alakustannuspaikka rivin summa N K Rivin summa, netto etumerkki C 1 81 K "-" hyvitys, ' ' ns. normaali valuuttasumma N E Valuuttasumma etumerkki C E Ks. edellä alvkoodi C E Myyntirivin alv-koodi seurantakohde 4 C E Kirjanpidon neljäs seurantakohde vero N K Rivin vero veroetumerkki C K Veron etumerkki valvero N K Vero valuutassa valveroetumerkki C K Edellisen etumerkki verotili C K Veron tili kirjanpidossa Visma Fivaldi 69

70 4.2 Ostoreskontra Ostoreskontran linkki sisältää kahta eri tietuetyyppiä, Laskun yleistietue (OSRLAS) ja laskurivit eli ostorivit (OSRTAP). OSRLAS-tietue Kenttä Tyyppi Pituus Alkupos Pakollinen Selitys yritysnumero N 6 1 K Fivaldissa oleva yritysnumero laji C 6 7 K OSRLAS asiakastunnus C K Toimittajan tunnus laskun numero C 8 23 K Laskun numero hyvlaskun numero N 8 31 E Hyvitettävän laskun numero, vain hyvityslaskulla (ei pakollinen) kausi N 6 39 K vvvvkk laskun päivä N 6 45 K vvkkpp maksuehto C 4 51 K Maksuehdon numero kassa-alennuspvm N 6 55 E Kassa-alennuksen pvm vvkkpp kassa-prosentti N 2 61 E Kassa-alennuksen prosentti, ei desimaaleja nettoeräpäivä N 6 63 K Laskun nettoeräpäivä vvkkpp laskun summa N K Laskun summa yrityksen valuutassa, brutto etumerkki C 1 87 K "-" hyvitys, ' ' ns. normaali valuuttatunnus C 3 88 K Valuuttatunnus Esim USD valuuttasumma N K Valuuttasumma etumerkki C K Ks. edellä kurssi N E Valuuttakurssi, kuusi desimaalia tilisaamistili C K Kirjanpidon ostovelkatili viite N K Ostolaskun viite, 0 = ei viitettä, viestityypiksi viesti viesti C E / K Viesti toimittajalle jollei viitettä viesti 2 C E Vapaamuotoinen viesti toimittajan nimi1 C E Asiakkaan nimi1 perintään / rekisteriin toimittajan nimi2 C E Asiakkaan nimen jatko-osa lähiosoite 1 C E Lähiosoitteen ensimmäinen rivi lähiosoite 2 C E Osoitteen mahdollinen toinen rivi postiosoite C E Postinumero ja postitoimipaikka maakoodi C E Toimittajan maa, ISO 3166 mukaisella koodilla Visma Fivaldi 70

71 OSRTAP-tietue Kenttä Tyyppi Pituus Alkupos Pakollinen Selitys yritysnumero N 6 1 K Fivaldissa oleva yritysnumero laji C 6 7 K OSRTAP asiakastunnus C K Toimittajan numero laskun numero C 8 23 K Laskun numero ostotili C 8 31 K Kirjanpidon ostotili seurantakohde 1 C 8 39 E Projektinumero seurantakohde 2 C 8 47 E Kirjanpidon kustannuspaikka seurantakohde 3 C 8 55 E Kirjanpidon alakustannuspaikka rivin summa N K Rivin summa, netto etumerkki C 1 81 K "-" hyvitys, ' ' ns. normaali valuuttasumma N K Valuuttasumma, netto etumerkki C E Ks. edellä alvkoodi C E Ostorivin alv-koodi vientiselite C E Ostorivin vientiselite seurantakohde 4 C E Kirjanpidon neljäs seurantakohde vero N K Rivin vero veroetumerkki C K Veron etumerkki valvero N K Vero valuutassa valveroetumerkki C K Edellisen etumerkki verotili C K Veron tili kirjanpidossa Visma Fivaldi 71

72 4.3 Esimerkkitiedostot Myyntireskontran tuontitiedoston malli RESLAS EUR Testi yritys Oy Testikatu 12 FI VAASA FI RESTAP RESTAP RESTAP RESTAP RESTAP RESLAS EUR Testi yritys Oy Testikatu 12 FI VAASA FI RESTAP RESTAP RESTAP RESTAP RESTAP RESTAP RESLAS EUR Testi yritys Oy Testikatu 12 FI VAASA FI RESTAP RESTAP Ostoreskontran tuontitiedoston malli OSRLAS EUR No show laskutukset Marsutie Vantaa FI OSRTAP OSRTAP Reskontratietojen tuonti Tarkista ennen siirtoa: Tuontiaineistossa oleva asiakasnumero pitää vastata Fivaldissa olevaa asiakasnumeroa, eli sama asiakas kyseessä molemmissa järjestelmissä. Jos aineiston asiakasnumeroa ei löydy Fivaldista, tuontiaineisto tuo asiakkaan tiedot Yritysrekisteriin. Tuontiaineiston kirjanpidon tilit pitää löytyä myös Fivaldin Tilikartasta. Aineiston maksuehdon koodi + selite pitää olla 1:1 myös Fivaldin Yrityksen perustiedoissa. Tuontiaineiston mahdolliset kustannuspaikat pitää löytyä myös Fivaldin Tilikartasta perustettuina. Aineiston mahdolliset eri valuutat pitää olla perustettuina myös Fivaldissa Yrityksen perustietoihin Visma Fivaldi 72

73 4.5 Tuontiaineiston perustiedot ja sisäänluku Myyntireskontra tietojen tuonti ja Ostoreskontra tietojen tuonti -sovellukset avataan Visma Fivaldin Java-puolen Muut-välilehdeltä. Molemmat toimivat samalla tavalla. Ensimmäisellä kerralla napsautetaan Uusi-painiketta. Siirtotietueelle annetaan nimi ja napsautetaan Tee-painiketta. Lopuksi muutokset tulee tallentaa Visma Fivaldi 73

74 Jatkossa tämän saman siirtotiedoston voi valita siirtojen yhteydessä. Tuontitietueelle perustetaan kaikki tarvittavat verokannat, esim. Siirtokoodi 2 = Myynti 24 %. Muutokset tallennetaan Tallenna-painikkeella ennen aineiston sisäänlukua. Mikäli verokantaa ja siirtokoodia ei ole tallennettu ennen aineiston sisäänlukua, ohjelma ilmoittaa: Siirtotiedostossa oli verokanta%koodi ** jota ei määritelty! Siirtokoodin numero per tarvittava verokanta selviää aineiston toimittajalta. Sisäänluettaessa ohjelma ilmoittaa, jos siirtokoodi puuttuu. Kun otsikolla on valittuna oikea tuontitietueen nimi, napsautetaan Lähetä aineisto Visma Fivaldi 74

75 Selaa-painikkeen kautta etsitään tuontiaineisto sijainnista, johon se on tallennettu. Tiedosto lähetetään ohjelmaan Lähetä-painikkeella. Ohjelma ilmoittaa lopuksi Tiedosto siirretty. Tiedot luetaan ohjelmaan Lue aineisto -painikkeella. Tuontitiedoston laskut näkyvät Siirto-ruudulla. Mikäli punaisella merkittyjä virheellisiä tietoja ei ole, napsautetaan Tee siirto -painiketta. Mikäli ruudulla on punaisella merkittyjä kohtia, napsautetaan Peruuta-painiketta. Kyseiset puutteelliset tiedot tulee korjata joko siirtotiedostoon tai Fivaldin perustietoihin, ja vasta sen jälkeen aineiston voi tuoda ohjelmaan uudelleen Visma Fivaldi 75

76 Mikäli aineisto on tuotu ohjelmaan jo aikaisemmin, ohjelma ilmoittaa tästä. Kun ohjelma ilmoittaa Siirto tehty, kuitataan se OK-painikkeella. Jos tuontiaineiston asiakasnumero puuttuu Yritysrekisteristä, asiakas luodaan rekisteriin siirron yhteydessä. Tuontiaineiston laskut näkyvät nyt Myyntireskontrassa / Kirjanpidossa avoimina ja ne jatkokäsitellään kuten muutkin avoimet laskut. Mikäli kyseessä oli jo aikaisemmin siirretyn aineiston uudelleensiirto, korvataan vanha avoin aineisto uudella. Myyntireskontrassa jo kuitattuja ei muuteta Visma Fivaldi 76

77 5 Tositteiden tuonti kirjanpitoon Tositteiden tuonti kirjanpitoon -ominaisuus sisältyy Fivaldin Kirjanpito-sovellukseen. Siirrossa on mahdollista käyttää muunnostaulukkoa, mikäli aineiston tilit eivät ole yhteneväisiä olemassa olevan tilikartan kanssa. Fivaldin kirjanpitoon voidaan siirtää tositteita määrämuotoisesta tiedostosta tai tiedostosta, jossa on kiinteän mittaisia kenttiä, joilla on tietty järjestys. Tiedosto on tekstitiedosto joko unix (LF) tai DOS (CR LF) -tyylisin rivinvaihdoin käyttäen ISO merkistöä. Tiedoston muoto (vakiolevyinen / pilkkueroteltu) tunnistetaan aineiston ensimmäiseltä riviltä. Määrämuotoisen CSV-tiedoston (CSV(luetteloerotin) / CSV(comma delimited)) ensimmäisellä rivillä on kenttätunnisteet, joiden mukaan sarakkeiden järjestys määräytyy. Jos halutaan välittää pilkku sellaisenaan tai välilyöntejä arvon alussa tai lopussa, voidaan kenttä ympäröidä lainausmerkeillä ("). Lainausmerkki välitetään kahtena lainausmerkkinä (""). Esimerkiksi Microsoft Excelissä voidaan tallentaa taulukko luetteloerotinmuodossa (CSV), jolloin se noudattaa tätä tapaa. Määrämuotoisessa tiedostossa pilkun asemasta tunnistetaan myös puolipiste kenttäerottimeksi. Välilyönnit kenttäerottimen ympärillä poistetaan. Desimaalierottimena toimii joko piste tai pilkku, ja samaa käytäntöä on käytettävä koko tiedostossa. Vaihtoehtoinen siirtotapa on käyttää kiinteän mittaisia kenttiä, joilla on tietty järjestys. Arvonlisävero eritellään automaattisesti, jos tilillä on nettokirjaava alv-luokka eikä rivillä ole verokantakoodia. Vero lasketaan tilin alv-luokan ohjaamana kuten kirjanpidon tositesyötössä. Summa tulkitaan bruttosummaksi, paitsi EUostojen kaksipuoleisessa verossa nettosummana. Jos halutaan tuoda aineistoa verollisille tileille ilman liittymän tekemää netotusta, vaihdetaan Kirjanpidon Tositelajien käyttöönotto -ruudulla tositelajin tyypiksi "Avaava saldo / veroton". Aineistossa voidaan määritellä yritysnumero ja tositelaji, jolle tieto viedään. Jos yritysnumero on määritelty aineistossa, luettaessa tarkistetaan tositteiden lisäysoikeus näihin yrityksiin. Oikeuksien puuttuessa mitään tietoa ei tuoda. Samoin jos aineistossa on määritelty tositelaji, ko. lajin olemassaolo tarkistetaan ja yksikin virhe hylkää koko aineiston. Jos aineistossa ei määritellä tositelajia, käyttäjän tulee valita se tiedoston sisäänlukuruudulla. Sisäänluettaessa suositellaan käytettäväksi itse lisättyjä tositelajeja, ei Fivaldin kiinteitä tositelajeja. Esimerkki tekstitiedostosta, jossa on kaksi vientiä sisältävä tosite: TILI, SUMMA, TOSITE, PVM 4000, 20003, 1, , , 1, Esimerkki kahdesta tositteesta: PVM,TILI,SUMMA ,3000, ,1910, ,4000, ,1920, Visma Fivaldi 77

78 Kenttätunnisteet ovat: PVM Pakollinen N8 Kirjauspäivä tositteelle, muoto VVVVKKPP TILI Pakollinen AN8 Kirjanpidon tili TOSITE AN16 Tositenumero jolla tositteet erotetaan. Jos tositenumeroa ei ole, päiväyksen muuttuminen vaihtaa seuraavaan tositteeseen SK1 AN8 Seurantakohde 1 SK2 AN8 Seurantakohde 2 SK3 AN8 Seurantakohde 3 SK4 AN8 Seurantakohde 4 SUMMA Pakollinen N15,2 Summa yrityksen valuutassa etumerkkeineen SENTIT N15 Summa sentteinä etumerkkeineen SELITE AN179 Vientiselite VEROKANTA AN10 Verokantakoodi VEROTILI AN8 Verotili VEROTILI2 AN8 Verotili 2 (vastakirjaus) VEROSUMMA N15,2 Veron määrä yrityksen valuutassa etumerkkeineen VEROSENTIT N15 Veron määrä sentteinä etumerkkeineen STATUS AN1 Viennin erikoiskäsittely NETTOPVM N8 Laskun eräpäivä VVVVKKPP ASIAKASTUNNUS AN10 Asiakkaan/toimittajan tunnus VIENTILAJI AN2 Vientilajin tunnus LASKUNO AN16 Laskun numero YT N6 Fivaldi-yritysnumero jolle aineisto tuodaan LAJI N3 Tositelajin numero jolle aineisto tuodaan Visma Fivaldi 78

79 Vakiolevyinen muoto: Kaikki kentät summan jälkeen ovat vapaaehtoisia, ts. rivi saa katketa kesken. Kaikki välilyönnit poistetaan kentistä vasemmalta, eli tyhjä arvo merkitään täyttämällä kenttä välilyönneillä. Paikka Pituus Tyyppi Selite 1 16 AN Tositenumero/tunnus 17 8 N Tositteen päiväys VVVVKKPP 25 8 AN Kirjanpidon tili N Summa sentteinä etumerkkeineen 48 8 AN Seurantakohde AN Seurantakohde AN Seurantakohde AN Seurantakohde N Laskun eräpäivä VVVVKKPP AN Asiakkaan/toimittajan tunnus AN Laskun numero AN Statustieto AN Vientiselite ei arvoa - Tavallinen vienti A - ALV-automaattikirjauksen tekemä ALV-vähennys verolliselta tililtä. Tällä on merkitystä vain jos halutaan siirtää tositteita bruttomenetelmää käyttävälle yritykselle niin, että Fivaldin ALV-laskelma osaa näyttää summat oikein L - Myyntilasku, tieto tulee vain myyntisaamisvientiin S - Suoritus myyntilaskuun, vain myyntisaamisviennissä O - Ostolasku, vain ostovelkaviennissä M - Ostolaskun maksu, vain ostovelkaviennissä T - Tapahtuma, laskunumero = tapahtumanumero K - Kuittaus tapahtumaan AN Verokantakoodi AN Verotili N Veron määrä sentteinä etumerkkeineen AN Verotili 2 (vastakirjaus) AN Vientilaji N Fivaldi-yritysnumero N Tositelaji jolle aineisto tuodaan Nettomenetelmää käytettäessä eritelty vero ilmoitetaan antaen veron määrä, vapaamuotoinen koodi sekä haluttaessa verotili. Koodi saa olla sama ostoissa ja myynneissä (esim. prosenttiluku), ja yhteys Fivaldin lopulliseen ALV-luokkaan muodostetaan ALV-luokan tiedon sisäänluvun verokoodin avulla. Tässä käytetään tarvittaessa sisäänluettavan tilin oletus- ALV-luokan tietoa siitä, onko kyse ostosta vai myynnistä. Jos yksiselitteistä ALV-luokkaa ei näillä tiedoilla voida määrittää, siirtoa ei tehdä. Jos sisäänlukuaineistossa on määritelty verotili, käytetään aina sitä. Jos verotili on tyhjä, käytetään Fivaldin verokoodia vastaavan ALV-luokan verotiliä Visma Fivaldi 79

80 5.1 Tositteiden luku Fivaldi kirjanpitoon. Visma Fivaldin Java-puolella avataan Kirjanpito-sovellus (Taloushallinto > Kirjanpito), sitten valitaan ylävalikosta Kirjanpito > Tositteiden tuonti kirjanpitoon ja napsautetaan avatuvassa ikkunassa Lähetä uusi aineisto -painiketta. Ohjelma avaa web-selaimeen uuden välilehden siirtoa varten. Selaa-painikkeella etsitään siirrettävä aineisto, jonka jälkeen tiedosto lähetetään napsauttamalla Lähetä ja lue tiedosto -painiketta Visma Fivaldi 80

81 Kun aineisto on lähetetty, ohjelma palaa Java-puolen ruudulle, jolloin napsautetaan OK-painiketta. Ruudulla näkyy aineiston tositenumeroväli, tositteiden ja rivien lukumäärät sekä päivämääräväli, jolle tositteet on kirjattu. Tämän jälkeen Java-puolella Tositteiden tuonti kirjanpitoon -ikkunassa valitaan Ladataan tositelajille -kohtaan tositelaji, jolle viennit siirretään. Lopuksi napsautetaan Lue tositteet -painiketta. Mikäli aineistossa on tilejä, joita ei Fivaldin tilikartasta löydy, ohjelma ilmoittaa siitä. Tilien muunnoksessa voidaan käyttää aiemmin tehtyä muunnostaulukkoa tai luoda uusi. Tilien muunnostaulukolla siirrettävän tilin XXXX tapahtumat ohjataan Fivaldin tilille YYYY. Mikäli halutaan käyttää aiemmin tallennettua muunnostaulukkoa, valitaan se Käytä muunnostaulukkoa -alasvetovalikosta. Uusi muunnostaulukko luodaan napsauttamalla alasvetovalikon vieressä olevaa -painiketta. Tämä avaa Tilien muunnos -ikkunan Visma Fivaldi 81

82 5.2 Tiedon vienti Exceliin Kirjanpidosta on mahdollista siirtää raportteja sekä valitun kauden tositteita Exceliin. Visma Fivaldin Java-puolella avataan Kirjanpito-sovellus (Taloushallinto > Kirjanpito), sitten valitaan ylävalikosta Kirjanpito > Tiedon vienti. Avautuvasta ikkunasta voidaan valita, mitä tietoja viedään Visma Fivaldi 82