Päivitetty 04.05.2004

FINVOICE 1 Päivitetty 04.05.2004 FINVOICE Versio 1.1/ 19.12.2003

FINVOICE 2 Päivitykset: Finvoice-soveltamisohjetta on päivitetty julkaisun (12/2002) jälkeen saatujen kommenttien perusteella. Kaikki kuvaukseen lisätyt uudet elementit ovat valinnaisia, joten versio 1.1 on alaspäin yhteensopiva version 1.0 kanssa. Tehtyjä muutoksia Yleisperiaatteet:: maininta käytettävästä merkistöstä Seller-, InvoiceRecipient-, Buyer-, ja DeliveryPartyIdentifier-elementin sisältökuvausta on tarkennettu. Elementissä voidaan antaa mikä tahansa osapuolen yksilöivä tunnus Lisätty useita elementtejä, jotka on merkitty punaisella Tavara- ja kululaskutukseen liittyvien tiliöintien käsittely Alv-verottomien laskujen perusteet Täsmennetty BuyerOrganisationTaxCoden käyttöä OriginCoden arvo Origin muutettu Original:ksi Täsmennetty viittauksia alkuperäisiin laskuihin CashDiscountAmount on käteisalennuksen verollinen arvo PaymentStatus elemetin käyttöä on tarkennettu. Pankkiyhteysohjelmassa on käytettävä ISO-8859-15 merkistöä Kuvaa korjattu (Intermediatorin paikka) Kehyksessä olevien To- ja From-elementtien järjestys MessageId:n pituudeksi määritelty max. 48 merkkiä Vahvistussanoman käytöstä selitystä, lisätään muu virhekoodi+ teksti on vapaa. Actor muutettu Intermediatoriksi Vahvistussanoman lopputägi lisätty esimerkkiin (</Finvoiceack Virhepalautteeseen on lisätty alkuperäisen sanoman lähettäjän ja vastaanottajan osoitetiedot Lisätty tietoa kehysten From- ja To-elementtien käytöstä pankkien välisessä liikenteessä samalla ulkoasumallia on korjattu Virhepalautteesta on poistettu Spy:-namespace elementtien edestä SellerInformationDetailsin SellerHomeTown ja VatRegistrationText korjattu ei pakolliseksi Seller-, Buyer,- InvoiceRecipient,- ja DeliveryOrganisationName kenttä voi esiintyä myös 2 kertaa VatFreeText lisätty VatSpecificationDetailssiin InvoiceUrlText ja InvoiceUrlNameText voi esiintyö useamman kerran Korjattu RowIdentifierin tekstiä hyvityslaskun osalta eli hyvityslaskussa annetaan hyvityslaskun numero RowIdentifier-kentässä. PaymentTermsDetails-agregaatti voi esiintyä 0..3 kertaa. Laskun tyyppina voi olla mysö Testilasku

FINVOICE 3 SISÄLLYSLUETTELO 1 Pankkiyhdistyksen suosituksen mukaisen verkkolaskun yleisperiaatteet... 5 1.1 Taustaa... 5 1.2 Mikä on Finvoice... 6 1.3 Yleiskuva verkkolaskupalvelusta... 7 1.4 Tekniset ohjeet... 8 1.4.1 Asiakirjan sisältö... 8 1.4.2 Tekniset määritykset... 8 1.4.3 Graafisten kuvasten merkit... 9 1.5 essa käytetyt attribuutit... 10 2 Finvoice-verkkolaskun rakenne... 10 2.1 Finvoice-verkkolaskun käyttösuositukset... 12 2.1.1 Laskutason ja rivitason käyttö... 12 2.1.2 Tiliöintiehdotusten käyttö ja tiliöintien automatisointi... 12 2.1.3 Alv-verottomien laskujen perusteet... 13 2.2 Seller Party Details... 13 2.2.1 Seller Organisation Unit Number... 15 2.2.2 Seller Contact Person Name... 15 2.2.3 Seller Communication Details... 15 2.2.4 Seller Information (only for invoice printouts)... 16 2.3 InvoiceRecipient Party Details... 17 2.3.1 InvoiceRecipient Organisation Unit Number... 19 2.3.2 Invoice Recipient Contact Person Name... 19 2.3.3 Invoice Recipient Communication Details... 19 2.4 Buyer Party Details... 20 2.4.1 Buyer Organisation Unit Number... 21 2.4.2 Buyer Contact Person Name... 21 2.4.3 Buyer Communication Details... 22 2.5 Delivery Party Details... 22 2.5.1 Delivery Organisation Unit Number... 24 2.5.2 Delivery Contact Person Name... 24 2.5.3 Delivery Communication Details... 24 2.5.4 Delivery Details... 25 2.6 Invoice Details... 27 2.6.1 Payment Status... 32 2.6.2 Partial Payment Details... 33 2.6.3 Virtual Bank Barcode... 35 2.6.4 Invoice Row... 36 2.6.5 Row Delivery Details... 40 2.6.6 Sub Invoice Row... 41 2.6.7 Sub Row Delivery Details... 46 2.7 Invoice Url... 46 2.8 SpecificationDetails... 47 2.9 epidetails... 48 2.10 Laskun laskentasäännöt... 50 3 Kehyksen kuvaus... 51 3.1 Yleistä... 51 3.1.1 Pankkiyhteysohjelman käyttö... 51 3.1.2 Allekirjoitus... 51 3.1.3 Testaus... 51 3.2 Sanoman rakenne... 51 Kehykseen voidaan myöhemmin lisätä myös laskun allekirjoitukseen liittyvät elementit... 52

FINVOICE 4 3.3 Esimerkki kehyksestä ja laskusta (alku)... 53 3.3.1 Esimerkin osat ja selitykset... 54 3.4 From- ja To-elementtien käyttö pankkien välisessä liikenteessä... 58 3.4.1 Asiakkaat yhteydessä pankkiin... 58 3.4.2 Asiakkaan valtuuttama aineiston hoitaja yhteydessä pankkiin... 59 3.5 Kuittaussanoma... 60 3.5.1 Vahvistussanoman osat... 61 3.5.2 Vahvistussanoman DTD-tiedosto... 63 3.5.3 Vahvistussanoman ulkoasu selaimella (XSL)... 63 4 MalliT... 64 4.1 Malli-laskusta, versio 1.1 (kaikki tiedot käytössä, paitsi osamaksun tietoja)... 64 4.2 Malli-laskusta versio 1.0 (minimi tiedot ja 2 laskuriviä)... 68 4.3 Malli-laskusta, jossa on kehys mukana... 71 5 DTD-kuvaus... 74 6 Tietojen esitys selaimella (xsl-tiedosto)... 80 6.1 Tietoelementtien sijoittelu laskulomakkeella... 80 6.2 Malli selaimella avatusta laskusta... 83 6.3 Malli selaimella avatusta laskusta... 84 7 Linkkejä... 86

FINVOICE 5 1 PANKKIYHDISTYKSEN SUOSITUKSEN MUKAISEN VERKKOLASKUN YLEISPERIAATTEET 1.1 Taustaa Suomalaisilla pankeilla on ollut merkittävä rooli yritysten taloushallinnon prosessien automatisoinnissa. Suomen Pankkiyhdistyksen standardoima Tiliote tositteena palvelu poisti käytännössä paperitositteet ja suurelta osin myös paperitiliotteet. Laskujen maksupalvelu, Suoraveloitus ja siihen kiinteästi liittyvä Saapuvat viitemaksut palvelu ovat oleellinen osa automaattisesti hoidettua yritysten taloushallintoa. Asiakkaille ja pankeille syntyneet kustannussäästöt eivät ole vähäiset. Suomen Pankkiyhdistys julkaisi asiakkaiden toivomuksesta aikoinaan tilisiirtooppaan yhteydessä paperisen laskusuosituksen, johon oli liitetty yksiosainen tilisiirtolomake. Kuitattu lasku toimi samalla maksajan tositteena. Laskusuositus on edelleen laajassa käytössä ja se on saanut jonkinlaisen suomalaisen peruslaskun aseman. Finvoice, pankkien suosittelema verkkolaskun standardi on luonteva jatko kehitykselle, joka johtaa kohti automatisoitua laskujen käsittelyä, ostajan ja myyjän reskontrien hoitoa ja kirjanpitoa. Ketjun oleellinen osa on automatisoitu maksaminen. Finvoice-verkkolaskuun liittyy kansainväliseen maksujenvälitykseen soveltuva Euroopan pankkijärjestöjen yhteistyössä kehittämä maksuosa, epi (electronic Payment Initiator). Laskun automaattinen tiliöinti on mahdollista perustililuettelon mukaisen tililöintiehdotuksen avulla tai osapuolten keskenään sopimalla tiliöintitiedolla. Perustililuettelo ja siihen liittyvät ohjeet ovat osoitteessa: http://www.tilitoimistot.fi/linkit/perustililuettelo/ Finvoice-verkkolaskun tietosisällön ja teknisen rakenteen määrittelyyn on saatu apua seuraavilta kirjanpidon asiantuntijoilta ja kansainväliseen ebxml-työhön osallistuneilta henkilöiltä. Tapio Sipponen Pauli Vahtera Olli-Pekka Pauna Matti Vasara Pretax Yhtiöt (kirjanpidon asiantuntijana) Procountor (kirjanpidon asiantuntijana) EdiMaster (TIEKEn edustaja ebxml:n Core Componentstyöryhmässä) Fingrid Oyj (TIEKEn edustaja ebxml:n Transport Routing and Packaging-työryhmässä) Versio 1.0 julkaistiin joulukuussa 2002. Versioon 1.0 tulleet kehitystarpeet on huomioitu versiossa 1.1, joka julkaistiin 18.12.2003.

FINVOICE 6 1.2 Mikä on Finvoice Finvoice on pankkien suosittelema standardi verkkolaskulle. Se soveltuu sekä suurten että keskikokoisten ja pienten yritysten väliseen laskutukseen. Finvoice on määritelty käyttäen xml-syntaksia. Xml- mahdollistaa laskun esittämisen sekä sovelluksen ymmärtämässä muodossa että selaimella paperilaskua vastaavassa muodossa. Selaimella esitetty lasku voidaan tulostaa paperilaskuksi ja käsitellä perinteisellä tavalla. eseen sisältyy kuvaus verkkolaskun rakenteesta ja tietosisällöstä, joka kattaa yleisimmät laskutustarpeet dtd-kuvaus eli laskun konekielinen kuvaus xsl-kuvaus, joka mahdollistaa laskun esittämisen selaimella ja tulostamisen paperille xsd-kuvaus (Schema), jota voidaan käyttää Finvoicen testausvaiheessa mallilaskut laajasta ja suppeasta verkkolaskusta ebxml-kehysrakenne, joka mahdollistaa laskun välittämisen suoraan myyjältä ostajalle tai laskun välittämisen kolmannen osapuolen kautta. Siirtokehys mahdollistaa laskun lähettämisen joko suoraan laskuttajalta maksajalle tai laskun välittämisen kolmannen osapuolen kautta maksajalle. Siirtokehys on kuvattu tarkemmin soveltamisohjeen kohdassa 3. Kehyksen kuvaus. XML-SIIRTOKEHYS From, To Finvoice

FINVOICE 7 1.3 Yleiskuva verkkolaskupalvelusta Finvoice-verkkolaskun soveltamisohje sekä laskun muodollisessa tarkastuksessa tarvittavat dtd-, xsd- ja xsl-tiedostot ovat vapaasti noudettavissa Suomen Pankkiyhdistyksen verkkosivuilta osoitteesta www.pankkiyhdistys.fi/verkkolasku Myyjä luo kuvauksen mukaisen laskun siirtokehyksineen ja lähettää sen ostajalle suoraan tai käyttäen välittäjänä pankkia tai laskuoperaattoria. Ostaja siirtää laskun tiedot omiin järjestelmiinsä tai katsoo laskua selaimella. Laskun voi tulostaa selaimelta paperille ja käsitellä sitä perinteisellä tavalla. Verkkolaskuja vastaanottavat ja lähettävät asiakkaat voivat hakea toistensa osoitetietoja Tieken ylläpitämästä verkkolaskuosoitepalvelusta www.tieke.fi/verkkolaskuosoitteisto. Sivuilla on mainittu yrityksen nimi, tunnustiedot, laskuoperaattorin tunnukset jne. - Ketkä vastaanottavat verkkolaskuja ja missä muodossa? - Osoitteet ja tunnukset VERKKOLASKUTTAJAT (YLEINEN HAKEMISTO) - - Tekninen kuvaus (dtd) - Laskun ulkoasu (xsl) MYYJÄ LAYOUT ja KUVAUS (XSL,DTD) (PANKKIYHDISTYS) OSTAJA MYYNTI- RESKONTRA- JA LASKUTUS- OHJELMISTO ASI PY- OHJ. Laskun tiedot Lasku- tai laskurivikohtainen tiliöintiehdotus (perustililuettelo) Maksun tiedot (epi) ASI=Application Service Interface PY-OHJ.=Pankkiyhteysohjelma Finvoice suoraan maksajalle (HTTP(S), SMTP jne.) MYYJÄN PANKKI tai Finvoice Pankin/laskuoperaattorin kautta ostajalle OSTAJAN PANKKI ASI PY- OHJ. OSTO- RESKONTRA- JA MAKSATUS- OHJELMISTO Tilausviite =automaattinen tilauksen tarkistus Perustililuettelo =automaattinen tiliöinti Maksun tiedot = automaattinen maksaminen

FINVOICE 8 1.4 Tekniset ohjeet 1.4.1 Asiakirjan sisältö Kohdassa 2 kuvataan XML-laskun (FINVOICE-verkkolaskun ) rakenne ja XMLsanoman yksityiskohtaiset käyttöönotto-ohjeet. Kohdassa 3 on kuvaus ebxml SOAP-Envelopesta ja ebxml-headerista. Kohdassa 4 on kaksi mallilaskua xml-muodossa. Kohdassa 5 on sanoman dtd-kuvaus. Kohdassa 6 on laskusanoima xsl-muodossa selaimella katsottuna. 1.4.2 Tekniset määritykset Desimaalien määrä erilaisten numeeristen tietojen yhteydessä: Määrät ja painot Hinnat ja raha-arvot Verot Prosentit Valuuttakurssit maks. 4 desimaalia maks. 4 desimaalia maks. 4 desimaalia maks. 4 desimaalia maks. 6 desimaalia Huom! Nämä ovat täsmälliset desimaalien määrät erilaisille numeerisille tiedoille. Desimaalit erotetaan aina pilkulla kokonaisluvusta. On myös huomattava, ettei numerotietojen edellä ole etunollia. Summan kokonaislukuosaan on sisällyttävä ainakin yksi numero. Desimaalipilkku on pakollinen, ja se sisällytetään maksimipituuteen. Desimaalipilkun jälkeen tulevien desimaalien lukumäärä ei saa ylittää ao. rahalajille sallittua maksimipituutta. Tässä asiakirjassa ei määritellä minkään elementin pituutta, mutta sanoman vastaanottajan olisi hyvä sopia seuraavista pituuksista alla olevien elementtien osalta: Merkki Numero Koodi Tunnistin Aika Elementin määreet 512 characters 24 characters 24 characters 48 characters 24 characters 48 characters

FINVOICE 9 Valinnaiset ja pakolliset kentät määritellään seuraavasti: Esiintyy Määritelmä blankko 1 Pakollinen, esiintyy kerran.? 0..1 Ei pakollinen, mutta voi esiintyä vain kerran. + 1..n Pakollinen ainakin kerran. Voi esiintyä useasti. * 0..n Ei pakollinen, mutta voi esiintyä useasti. Yllä mainityt tyypit ilmaisevat vain elementtien sisällön piirteitä. Todellinen XMLvälitys sisältää vain merkkitietoa. Tässä dokumentissa käytetään kuitenkin näitä kuvaamaan elementtien sisältöä. XML-sanomat sisältävät seuraavanlaisia olioita: elementit, aggregaatit ja rakenteet. Elementti on yksinkertainen olio, jossa on vain yksi merkkijono. Aggregaatti on rakenteellinen olio, joka koostuu elementeistä (esim. yksinkertaisista olioista). Rakenne on monimutkaisempi olio, joka sisältää joko aggregaatteja tai sekä aggregaatteja että elementtejä. Se voi sisältää myös toisia rakenteita. 1.4.3 Graafisten kuvasten merkit Tämä asiakirja sisältää monia sanomarakenteiden graafisia kuvauksia, jotka on tehty TIBCOn Turbo XML -työkalulla. Työkalu käyttää muutamia merkkejä XMLkuvauksissa. Alla on joitakin merkkien selityksisä. RootTag ilmoittaa, että RootTag on rakenne, joka koostuu neljästä elementistä: täsmälleen yksi Tag1 (ei merkkiä), nolla tai yksi Tag2 (? ), 1..n kertaa Tag3 ( + ) ja 0..n kerta Tag4 (*), jossa n is hyvin suuren kokonaisluvun arvo. Tag1 on määre, jonka nimi on Attribute. Tag2 on yksi ainoa elementti ilman attribuuttia. Tag3 on agregaatti, joka koostuu täsmälleen yhdestä Tag5:stä ja 0..n kertaa Tag6:sta. Tag4 on myös yksittäinen elementti ilman yhtään attribuuttia.

FINVOICE 10 1.5 essa käytetyt attribuutit Kaikkiin rahamäärä-elementteihin (Amount) liittyy attribuutti AmountCurrencyIdentifier, vaikka laskuun liittyvien rahamäärien on oltava samaa valuuttaa. Poikkeuksena on veron määrä, joka pitää olla myyntimaan valuutassa. Rahamäärässä on desimaali, joka on erotettu pilkulla (,). Rahamäärä voi olla myös miinusmerkkinen, jolloin määrän edessä on miinusmerkki (-). Määrä-elementtien (Quantity) attribuuttina on UnitCode, joka kertoo mitä yksikköä kyseinen määrä on. Päivämäärä-elementtien (esimerkiksi InvoiceDate) attribuuttina on aina Format, jonka muoto on CCYYMMDD. EpiCharge-elementin attribuuttina on ChargeOption. Kotimaan maksuissa oletusarvo on SHA. 2 FINVOICE-VERKKOLASKUN RAKENNE Lasku sisältää minimissään pakolliset tiedot: Myyjän tiedot Ostajan tiedot Laskun tiedot Laskurivi Myyjän antamat tiedot maksutoimeksiantoa varten (epi) Laskua voidaan laajentaa tarpeen mukaan ottamalla käyttöön valinnaisia tietoja. Toimialakohtaiset erittelytiedot voidaan antaa SpecificationDetails-elementissä. Toimiala ylläpitää itse ko. kuvausta ja sen mahdollista ulkoasua. Finvoice 1.1 on alaspäin yhteensopiva. Kaikki punaisella merkityt uudet elementit on ei-pakollisia. Käytetty versio ilmoitetaan Version-elementissä. Esimerkki: <Finvoice version="1.0" Tai <Finvoice version="1.1"

FINVOICE 11 Huom! Kuvassa InvoiceUrlNameText ja InvoiceUrlText voi esiintyä 0..n kertaa.

FINVOICE 12 2.1 Finvoice-verkkolaskun käyttösuositukset Finvoice-verkkolaskun tietosisältö määriteltiin siten, että laskua voidaan käyttää mahdollisimman monissa tilanteissa. Tästä johtuen monet tiedot ovat sekä lasku- että rivitasolla. Vaikka tavoitteena on laskun automaattinen käsittely ostajan järjestelmissä, tietosisältö on määritelty siten, että myös manuaalikäsittelyssä tarvittavat tiedot, kuten osoite-, yhteyshenkilö-, footer-tiedot ovat käytettävissä. 2.1.1 Laskutason ja rivitason käyttö Laskussa on esim. DeliveryDetails-kenttä laskutasoinen ja samat tiedot myös rivikohtaisesti. Esimerkiksi laskutusjakso voidaan esittää laskukohtaisesti DeliveryDetailsin StartDate- ja EndDate-kentissä ja laskuriveillä voi olla esim. freetext-kentässä laskuun liittyvää tietoa. Tai laskutusjakso voidaan esittää laskurivikohtaisesti. Suositus on käyttää laskurivikohtaista käsittelyä. 2.1.2 Tiliöintiehdotusten käyttö ja tiliöintien automatisointi Verkkolaskun tiliöinnillä tarkoitetaan ostajan kirjanpitoa varten valmiiksi verkkolaskulle tehtyä tiliöintiehdotusta. Tiliöintiehdotuksen avulla ostaja laatii omaa kirjanpitoaan varten kirjanpitomerkinnät (perus- ja pääkirjanpitoa varten). Tiliöintiehdotuksen tekeminen verkkolaskulle ei ole pakollista, mutta ehdotuksen tekeminen on suositeltavaa, koska se mahdollistaa ostajan kirjanpidon automatisoinnin myös ostotapahtumien osalta. Verkkolaskun tiliöintiehdotuksen tavoitteena on mahdollistaa yksinkertainen ja toimiva malli ostolaskujen ja maksutapahtumien automaattiseksi tiliöinniksi. Kirjanpitovelvollisen kirjanpidossa saattaa olla tarpeellista käyttää erilaisia tai monipuolisempia kirjausmenettelyjä, mikä on mahdollista rakentamalla verkkolaskusta saatavien tietojen avulla kirjanpitovelvolliskohtaisesti räätälöidyt kirjausmenettelyt. Nämä muunnelmat tehdään ostajan kirjanpidossa, koska ne muutoin tekisivät verkkolaskun tiliöintien hallinnasta monimutkaisen. Finvoicessa on mahdollisuus käyttää sekä lasku- että rivikohtaista tililöintiehdotusta. Rivikohtainen tiliöintiehdotus mahdollistaa sen, että samalla laskulla voi olla sekä kuluettä tavarakauppaan liittyvää laskutusta. Jotta tiliöinti voidaan toteuttaa, on myyjän tiedettävä laskua luotaessa ostetaanko tavara jälleenmyyntiin vai itselle. Tieto kannattaa lisätä ostajan perustietoihin. 1. Kululaskujen tiliöinti Kululaskuissa käytetään perustililuettelon mukaista tiliöintiehdotusta. 2. Tavarakauppaa koskevien laskujen tiliöinti (Ostolaskut) Tiliöinti ehdotus 4000 (Normal) ja 400 (Short). Kunnille tiliöintiehdotus sijoitetaan Dimension-elementtiin.

FINVOICE 13 3. Tavarakaupan tarkempi tiliöinti Jos kohdassa 2 mainittu tiliöinnin tarkkuus ei riitä, voidaan käyttää apuna: Myyjän tunnistetiedot esim. Y-tunnus (SellerPartyIdentifier, OrganisationUnit- Number jne) Tuotekoodi esim. ArticleIdentifier tai BuyerArticleIdentifier. Finvoice ratkaisussa suositellaan EAN-koodien käyttämistä sekä ostajan että myyjän järjestelmissä. Tieto annetaan ArticleIdentifier-elementissä. Tilausviitettä, jolloin ostaja antaa tilauksen yhteydessä myyjälle lasku- tai rivikohtaisen tilausviitteen. Samassa yhteydessä ostaja voi "ennakkotiliöidä" tilauksen. Myyjä ilmoittaa tilausviitteen laskussa, jonka perusteella ostaja täsmäyttää laskun tilaukseen ja hyödyntää "ennakkotiliöintejä". Tulevaisuudessa rivikohtainen tiliöinti tai tilausviite voidaan lähettää jo tilauksen yhteydessä myyjälle, joka välittää sen suoraan laskulle. Lisätietoa: http://www.tilitoimistot.fi/linkit/perustililuettelo/ RowAccountDimensionText on tarkoitettu keskenään sovittujen tiliöintitieojen välittämiseen. Kenttää voidaan myös käyttää rakenteellisesti, jolloin ostaja voi lukea seurantakohteet eli kustannuspaikkojen arvot ko.kentästä. Tiliöinnin rakenteen eri seurantakohteiden arvot voivat olla tälööin esim. puolipisteellä eroteltuina, esimerkiksi "456;;Uusikaupunki 2;43". Tiliöinnin seurantakohteet täytetään rakenteen mukaisessa järjestyksessä. 2.1.3 Alv-verottomien laskujen perusteet Verohallinnon ohjeessa 1731/40/2003 kappaleessa 5 kohdassa 11 mainitut perusteet ilmoitetaan joko InvoiceFreeText tai RowFreeText-elementeissä. Lisätietoa: http://www.vero.fi/nc/viewarticle.asp?article=2423&language=fin 2.2 Seller Party Details Sisältää minimissään pakolliset tiedot myyjästä; myyjän ly-tunnus, organisaation nimi ja y-tunnus.

FINVOICE 14 Huom! SellerOrganisationName voi esiintyä 1..2 kertaa. Elements Type Occurs Description SellerPartyDetails Aggr. 1 Seller information SellerPartyIdentifier Identifier 0..1 Identification of seller (Y-tunnus Finland) SellerPartyIdenfifierUrlText Character 0..1 Linkki patentti ja rekisterihallituksen rekisteriin, jotta y-tunnus voidaan tarkistaa. ks. www.ytj.fi see also example SellerOrganisationName Character 1..2 Seller name SellerOrganisationTaxCode Identifier 0..1 Vat-number, (Y-tunnus with FI as a prefix) SellerOrganisationTaxCodeUrlText Character 0..1 Link to the common website SellerPostalAddressDetails Aggr. 0..1 Seller address information Elements Type Occurs Description SellerPostalAddressDetails Aggr. 0..1 Seller address information SellerStreetName Character 1 SellerTownName Character 1 SellerPostCodeIdentifier Identifier 1 CountryCode Code 0..1 ISO eg. FI, SE CountryName Character 0..1 SellerPostOfficeBoxIdentifier Identifier 0..1 Example: <SellerPartyDetails <SellerPartyIdentifier0123456-7</SellerPartyIdentifier

FINVOICE 15 <SellerPartyIdentifierUrlTextwww.ytj.fi/avain=0123456-7 tai http://www.ytj.fi/yrity2.asp?yavain=100834</sellerpartyidentifierurltext <SellerOrganisationNameLohi ja Hauki Oy</SellerOrganisationName <SellerOrganisationTaxCode0123456-7</SellerOrganisationTaxCode <SellerOrganisationTaxCodeUrlText http://europa.eu.int/comm/taxation_customs/vies/fi/vieshome.htm </SellerOrganisa tiontaxcodeurltext <SellerPostalAddressDetails <SellerStreetNameAhvenkuja 2</SellerStreetName <SellerTownNameHelsinki</SellerTownName <SellerPostCodeIdentifier00122</SellerPostCodeIdentifier <CountryCodeFI</CountryCode <CountryNameFINLAND</CountryName </SellerPostOfficeBoxIdentifier </SellerPostalAddressDetails </SellerPartyDetails 2.2.1 Seller Organisation Unit Number Myyjän organisaatioyksikkö, joka tarkentaa tarvittaessa virallista y-tunnusta. Elements Type Occurs Description SellerOrganisationUnitNumber Numeric 0..1 eg. OVT-tunnus, format nnnnn (SFS) Example: <SellerOrganisationUnitNumber00000</SellerOrganisationUnitNumber 2.2.2 Seller Contact Person Name Myyjän yhteyshenkilö koskien tätä nimenomaista laskua. Elements Type Occurs Description SellerContacPersonName Character 0..1 Contact person of seller Example: <SellerContactPersonNameUnto Kuikka</SellerContactPersonName 2.2.3 Seller Communication Details Tässä tietoryhmässä annetaan ne yhteystiedot, joihin kyselyt myyjälle pitää osoittaa.

FINVOICE 16 Elements Type Occurs Description SellerCommunicationDetails Aggr. 0..1 Related to the contact person of seller SellerPhoneNumberIdentifier Identifier 0..1 SellerEmailAddressIdentifier Identifier 0..1 Example: <SellerCommunicationDetails <SellerPhoneNumberIdentifier09-221222</SellerPhoneNumberIdentifier <SellerEmailaddressIdentifierunto.kuikka@lohijahauki.fi</SellerEmailaddressIdentifier </SellerCommunicationDetails 2.2.4 Seller Information (only for invoice printouts) Yleiset myyjän yhteystiedot, jotka voidaan päivittää myyjärekisteriin. Suositellaan käytettäväksi laskukohtaisesti vain kun laskut tulostetaan ainoastaan paperille. Elements Type Occurs Description SellerInformationDetails Aggr. 0..1 Information related to the printing version of the invoice. This information is printed into the bottom of the invoice SellerHomeTownName Character 0..1 Domicile SellerVatRegistrationText Character 0..1 Can be used for information that the registration is in process. "Re-

FINVOICE 17 kisteröinti vireillä" SellerVatRegistrationDate Time 0..1 SellerPhoneNumber Numeric 0..1 SellerFaxNumber Numeric 0..1 SellerCommonEmailAddressIdentifier Identifier 0..1 Common Email address SellerWebAddressIdentifier Identifier 0..1 SellerFreeText Character 0..1 Seller information, for example alternative bank account numbers SellerAccountDetails Aggr. 0..n Seller bank account details Element: SellerVatRegistrationDate Attribute: Format Value Description "CCYYMMDD" Example: <SellerInformationDetails <SellerHomeTownNameHelsinki</SellerHomeTownName <SellerVatRegistrationTextRekisteröinti vireillä</sellervatregistrationtext <SellerVatRegistrationDate19991215</SellerVatRegistrationDate <SellerPhoneNumber+358 9 221221</SellerPhoneNumber <SellerFaxNumber+358 9 221223</SellerFaxNumber <SellerCommonEmailaddressIdentifierwebmaster@lohijahauki.fi</SellerCommonEmailaddressIdentifier <SellerWebaddressIdentifierwww.lohijahauki.fi</SellerWebaddressIdentifier <SellerFreeTextKäyhän pistäytymässä</sellerfreetext <\SellerAccountDetails </SellerInformationDetails SellerAccountID Character 1 Seller s account number SellerBic Identifier 1 SWIFT-code of the seller`s bank <SellerAccountDetails <SellerAccountID IdentificationSchemeName="IBAN"FI12198982918988219</SellerAccountID <SellerBic IdentificationSchemeName="BIC"OKOYFIHH</SellerBic </SellerAccountDetails 2.3 InvoiceRecipient Party Details Laskun vastaanottaja tietoryhmää käytetään, kun laskun vastaanottaja on muu kuin ostaja, esimerkiksi tilitoimisto tai muu ostajan puolesta toimiva asioimisto.

FINVOICE 18 Huom! InvoiceRecipientOrganisationName voi esiintyä 1..2 kertaa. Elements Type Occurs Description InvoiceRecipientPartyDetails Aggr. 0..1 This is used if the invoice is send to other than buyer eg. accounting company etc. or to the other department than buyer InvoiceRecipientPartyIdentifier Identifier 0..1 eg.y-tunnus, OVT-tunnus, Customer Number InvoiceRecipientOrganisationName Character 1..2 Name of recipient InvoiceRecipientOrganisationTax- Identifier 0..1 eg.vat Code Code InvoiceRecipientPostalAddressDetails Aggr. 0..1 Address information of recipient Elements Type Occurs Description InvoiceRecipientPostalAddressDetails Aggr. 0..1 Address information of recipient InvoiceRecipientStreetName Character 1 InvoiceRecipientTownName Character 1 InvoiceRecipientPostCodeIdentifier Identifier 1 CountryCode Code 0..1 CountryName Character 0..1 InvoiceRecipientPostOfficeBoxIdentifier Identifier 0..1 Example: <InvoiceRecipientPartyDetails <InvoiceRecipientPartyIdentifier2332</InvoiceRecipientPartyIdentifier <InvoiceRecipientOrganisationNameTilitoimisto Ryynänen ja Ryynänen</InvoiceRecipientOrganisationName <InvoiceRecipientOrganisationTaxCode212222-4</InvoiceRecipientOrganisationTaxCode <InvoiceRecipientPostalAddressDetails <InvoiceRecipientStreetName/ <InvoiceRecipientTownNameHelsinki</InvoiceRecipientTownName <InvoiceRecipientPostCodeIdentifier00212</InvoiceRecipientPostCodeIdentifier <CountryCodeFI</CountryCode

FINVOICE 19 <CountryNameFINLAND</CountryName <InvoiceRecipientPostOfficeBoxIdentifierPL 212</InvoiceRecipientPostOfficeBoxIdentifier </InvoiceRecipientPostalAddressDetails </InvoiceRecipientPartyDetails 2.3.1 InvoiceRecipient Organisation Unit Number Laskun vastaanottajan organisaatioyksikkö, joka tarkentaa tarvittaessa virallista y- tunnusta. Elements Type Occurs Description InvoiceRecipientOrganisationUnit- Numeric 0..1 eg. OVT-tunnus, format nnnnn (SFS) Number Example: 2.3.2 Invoice Recipient Contact Person Name Laskun vastaanottajan yhteyshenkilö koskien tätä nimenomaista laskua tai tilausta. <InvoiceRecipientOrganisationUnitNumber00000</InvoiceRecipientOrganisationUnitNumber Elements Type Occurs Description InvoiceRecipientContactPerson- Character 0..1 eg. person who made the order. Can Name be used for approval of he invoice. Example: <InvoiceRecipientContactPersonNameHeikki Pulli</InvoiceRecipientContactPersonName 2.3.3 Invoice Recipient Communication Details Laskun vastaanottajan yhteyshenkilön yhteystiedot. Elements Type Occurs Description InvoiceRecipientCommunicationDe- Aggr. 0..1 Related to the invoice recipient`s con-

FINVOICE 20 tails InvoiceRecipientPhoneNumberIdentifier InvoiceRecipientEmailAddressIdentifier Example: Identifier 0..1 Identifier 0..1 tact person <InvoiceRecipientCommunicationDetails <InvoiceRecipientPhoneNumberIdentifier(09) 34234</InvoiceRecipientPhoneNumberIdentifier <InvoiceRecipientEmailaddressIdentifierheikki.pulli@pullinkala.fi</InvoiceRecipientEmailaddressIdentifier </InvoiceRecipientCommunicationDetails 2.4 Buyer Party Details Ostajan arvolisäverotunniste (Vat Number) on merkittävä BuyerOrganisationTaxCode-elementtiin, jos ostaja on verovelvollinen käännetyn verovelvollisuuden perusteella tai kysymys on yhteisömyynnistä. Lisäksi InvoiceFreeTextiin lisätään maininta mahdollisesta verottomuuden perusteesta. Rivitasolla käytetään RowFreeTextiä. Huom! BuyerOrganisationName voi esiintyä 1..2 kertaa. Elements Type Occurs Description BuyerPartyDetails Aggr. 1 Buyer information BuyerPartyIdentifier Identifier 0..1 eg Y-tunnus, OVT-tunnus, Customer Number BuyerOrganisationName Character 1..2 Name of Buyer BuyerOrganisationTaxCode Identifier 0..1 VAT-number BuyerPostalAddressDetails Aggr. 0..1 Buyers address information

FINVOICE 21 Elements Type Occurs Description BuyerPostalAddressDetails Aggr. 0..1 Buyers address information BuyerStreetName Character 1 BuyerTownName Character 1 BuyerPostCodeIdentifier Identifier 1 CoutryCode Code 0..1 CountryName Character 0..1 BuyerPostOfficeBoxIdentifier Identifier 0..1 Example: <BuyerPartyDetails <BuyerPartyIdentifier1222</BuyerPartyIdentifier <BuyerOrganisationNamePullin Kala Oy</BuyerOrganisationName <BuyerOrganisationTaxCode012122-5</BuyerOrganisationTaxCode <BuyerPostalAddressDetails <BuyerStreetNameVaaputie 1</BuyerStreetName <BuyerTownNameHelsinki</BuyerTownName <BuyerPostCodeIdentifier00122</BuyerPostCodeIdentifier <CountryCodeFI</CountryCode <CountryNameFINLAND</CountryName <BuyerPostOfficeBoxIdentifier/ </BuyerPostalAddressDetails </BuyerPartyDetails 2.4.1 Buyer Organisation Unit Number Ostajan organisaatioyksikkö, joka tarkentaa tarvittaessa virallista y-tunnusta. Elements Type Occurs Description BuyerOrganisationUnitNumber Numeric 0..1 eg. OVT-tunnus, format SFS Example: <BuyerOrganisationUnitNumber00000</BuyerOrganisationUnitNumber 2.4.2 Buyer Contact Person Name Ostajan yhteyshenkilö koskien tätä nimenomaista laskua tai tilausta. Elements Type Occurs Description BuyerContactPersonName Character 0..1 eg. person who made the order. Can

FINVOICE 22 be used for approval of he invoice. Example: <BuyerContactPersonNameHeikki Pulli</BuyerContactPersonName 2.4.3 Buyer Communication Details Ostajan yhteyshenkilön yhteystiedot. Elements Type Occurs Description BuyerCommunicationDetails Aggr. 0..1 Related to the buyer`s contact person BuyerPhoneNumberIdentifier Identifier 0..1 BuyerEmailAddressIdentifier Identifier 0..1 Example: <BuyerCommunicationDetails <BuyerPhoneNumberIdentifier(09) 34234</BuyerPhoneNumberIdentifier <BuyerEmailaddressIdentifierheikki.pulli@pullinkala.fi</BuyerEmailaddressIdentifier </BuyerCommunicationDetails 2.5 Delivery Party Details Toimitusosapuolen tietoja käytetään silloin, kun laskutettava toimitus on osoitettu muulle kuin ostajalle.

FINVOICE 23 Huom! DeliveryOrganisationName voi esiintyä 1..2 kertaa. Elements Type Occurs Description DeliveryPartyDetails Aggr. 0..1 If the product or service is deliverred to other party than buyer, this part can be used DeliveryPartyIdentifier Identifier 0..1 eg.y-tunnus, OVT-tunnus, Customer Number DeliveryOrganisationName Character 1..2 Party to whom the product or service was delivered DeliveryOrganisationTaxCode Identifier 0..1 eg. y-tunnus DeliveryPostalAddressDetails Aggr. 1 Address details Elements Type Occurs Description DeliveryPostalAddressDetails Aggr. 0..1 Address details DeliveryStreetName Character 1 DeliveryTownName Character 1 DeliveryPostCodeIdentifier Identifier 1 CountryCode Code 0..1 CountryName Character 0..1 DeliveryPostofficeBoxIdentifier Identifier 0..1 Example: <DeliveryPartyDetails <DeliveryPartyIdentifier132</DeliveryPartyIdentifier <DeliveryOrganisationNameRummukaisen Kala</DeliveryOrganisationName <DeliveryOrganisationTaxCode131233-6</DeliveryOrganisationTaxCode <DeliveryPostalAddressDetails <DeliveryStreetNameKauppakatu 2</DeliveryStreetName <DeliveryTownNameEspoo</DeliveryTownName <DeliveryPostCodeIdentifier12122</DeliveryPostCodeIdentifier <CountryCodeFI</CountryCode <CountryNameFINLAND</CountryName <DeliveryPostofficeBoxIdentifier/ </DeliveryPostalAddressDetails