FINVOICE Soveltamisohje Versio 1.2/ 7.3.2008 25.7.2009 kansainvälisen viitteen päivitys
Kuvaus 1 (72) SISÄLLYSLUETTELO 1 Finanssialan Keskusliiton suosituksen mukaisen verkkolaskun yleisperiaatteet... 3 1.1 Taustaa... 3 1.2 Mikä on Finvoice... 4 1.3 Kuluttajan e-lasku... 4 1.4 Yleiskuvaus verkkolaskupalvelusta... 5 2 Finvoice-verkkolaskun perusrakenne ja käyttösuositukset... 7 2.1 Finvoice-verkkolaskun käyttösuositukset... 7 2.1.1 Laskutason ja rivitason käyttö... 7 2.1.2 Välisumman käyttö riveillä... 7 2.1.3 Tiliöintiehdotusten käyttö ja tiliöintien automatisointi... 7 2.1.4 Arvonlisäverottomien laskujen perusteet... 9 3 Tietoelementtien käyttö... 9 3.1.1 SellerOrganisationUnitNumber... 9 3.2 SellerInformationDetails... 9 3.3 InvoiceRecipientPartyDetails... 9 3.3.1 InvoiceRecipientOrganisationUnitNumber... 9 3.4 BuyerPartyDetails... 10 3.4.1 BuyerOrganisationUnitNumber... 10 3.5 DeliveryPartyDetails... 10 3.5.1 DeliveryOrganisationUnitNumber... 10 3.6 DeliveryDetails... 11 3.7 InvoiceDetails... 11 3.7.1 PaymentTermsDetails... 12 3.7.2 PaymentStatus... 12 3.7.3 VirtualBankBarcode... 12 3.8 InvoiceRow... 12 3.8.1 SubInvoiceRow... 12 3.9 SpecificationDetails... 13 3.10 epidetails... 13 3.11 Laskun laskentasäännöt... 14 3.12 Linkkien käyttö Finvoice-verkkolaskussa... 15 3.12.1 Lähettäjän muodostama linkki... 15 3.12.2 Pankin muodostama linkki... 15 4 Kehyksen kuvaus... 16 4.1.1 Yleistä... 16 4.1.2 Pankkiyhteysohjelman käyttö... 16 4.1.3 Pankkiin lähetettävän tiedoston rakenne... 17 4.1.4 Allekirjoitus... 17 4.1.5 Testaus... 17 5 Sanoman rakenne... 17 5.1 Esimerkki kehyksestä ja laskusta (alku)... 18 5.1.1 Esimerkin osat ja selitykset... 19 5.2 From- ja To-elementtien käyttö pankkien välisessä liikenteessä... 23 5.2.1 Asiakkaat yhteydessä pankkiin... 24 5.2.2 Asiakkaan valtuuttama aineiston hoitaja yhteydessä pankkiin... 25
Kuvaus 2 (72) 5.3 Vahvistussanoma... 25 5.3.1 Vahvistussanoman osat... 27 5.3.2 Vahvistussanoman DTD-tiedosto... 28 5.3.3 Vahvistussanoman ulkoasu selaimella (XSL)... 28 6 Mallit... 29 6.1 Malli kehystetystä laskusta (Perustiedot)... 29 6.2 Malli-laskusta (Laajat tiedot)... 33 7 Tietojen esitys selaimella (xsl-tiedosto)... 38 7.1 Tietoelementtien sijoittelu laskulomakkeella... 38 7.2 Malli selaimella esitetystä laskusta... 42 7.3 Malli selaimella avatusta laskusta (laaja)... 43 8 Finvoicen tekninen kuvaus... 45 8.1 Tekniset määritykset... 45 8.2 Soveltamisohjeessa käytetyt attribuutit... 45 8.3 Tietoluettelo... 46 8.4 Finvoicen rakenne... 47 8.4.1 InvoiceDetailsin rakenne... 48 8.4.2 InvoiceRow:n rakenne... 49 8.4.3 EpiDetails rakenne... 53 8.5 Finvoicen elementtien schemakuvaus... 54
Kuvaus 3 (72) Muutokset merkitty soveltamisohjeen tekstiin punaiselle. 1 Finanssialan Keskusliiton 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 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 tilisiirto-oppaan 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. Finvoice-lasku mahdollistaa täysin automaattisen käsittelyn, koska laskun tiedot ovat rakenteellisessa muodossa. Laskun mukana ei välitetä erillistä laskun kuvaa eikä erillisiä liitteitä. Finvoice-sanomasta voidaan muodostaa tarvittaessa kuva tyylitiedoston avulla. Finvoice-mallissa ei tarvita perinteistä koontilaskukäsittelyä, koska laskun tiedot voidaan ryhmitellä laskun riveille. Automaattisessa laskujen käsittelyssä ei käytetä koontilaskumallia.
Kuvaus 4 (72) 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. Soveltamisohjeeseen sisältyy kuvaus verkkolaskun rakenteesta ja tietosisällöstä, joka kattaa kaikki 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-siirtokehysrakenne (SOAP), joka mahdollistaa laskun välittämisen suoraan myyjältä ostajalle tai laskun välittämisen kolmannen osapuolen kautta. Siirtokehys mahdollistaa laskun reitittämisen yksiselitteisesti laskun lähettäjältä laskun vastaanottajalle tai laskun välittämisen kolmannen osapuolen kautta laskun vastaanottajalle. From-ja To-elementtien roolit kertovat osapuolen luonteen laskun välittämisketjussa. Sender on laskun alkuperäinen lähettäjä ja Receiver on laskun lopullinen vastaanottaja. Intermediator on edellä mainittujen osapuolten laskujen välittäjätaho. Siirtokehys on kuvattu tarkemmin soveltamisohjeen kohdassa Kehyksen kuvaus. XML-SIIRTOKEHYS From Sender From Intermediator (Sender) To Receiver To Intermediator (Receiver) FINVOICE 1.3 Kuluttajan e-lasku Kuluttajan e-lasku on Finvoice verkkolasku, jonka kuluttaja saa verkkopankkiinsa. Lähettäjä ilmoittaa FinvoiceSenderInfo- sanomalla pankin verkkopankkia käyttäville asiakkaille omat laskuttajatietonsa. Sanoman pohjalta pankki asettaa tiedot verkkopankin asiak-
Kuvaus 5 (72) kaan käytettäväksi. Verkkopankin asiakkaan osoitetiedot välitetään FinvoiceReceiverInfosanomalla lähettäjälle. Kuluttajan e-laskuun liittyvä Ilmoittamispalvelun sanomakuvaus, tekniset tiedostot ja kuluttajaille suunnattu viestintäaineisto vapaasti noudettavissa Finanssialan Keskusliiton verkkosivuilta osoitteesta www.e-lasku.info. 1.4 Yleiskuvaus verkkolaskupalvelusta Finvoice-verkkolaskun soveltamisohje sekä laskun muodollisessa tarkastuksessa tarvittavat dtd-, xsd- ja xsl-tiedostot ovat vapaasti noudettavissa Finanssialan Keskusliiton verkkosivuilta osoitteesta www.finvoice.info. Finvoice laskussa on oltava viittaus käytettävään tyylitiedostoon. Tällä varmistetaan, että laskun saaja näkee laskun tiedot ja voi tarvittaessa tallentaa laskun omalle tietovälineelleen. Myyjä luo kuvauksen mukaisen laskun siirtokehyksineen ja lähettää sen ostajalle 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.
Kuvaus 6 (72)
Kuvaus 7 (72) 2 Finvoice-verkkolaskun perusrakenne ja käyttösuositukset Lasku sisältää minimissään pakolliset tiedot: Myyjän tiedot Ostajan tiedot Laskun tiedot Laskurivin Myyjän antamat tiedot maksutoimeksiantoa varten (epi) Laskua voidaan laajentaa tarpeen mukaan ottamalla käyttöön valinnaisia tietoja. Toimialakohtaiset erittelytiedot voidaan antaa SpecificationDetails-aggregaatissa. Erittelytiedot voidaan antaa määrämuotoisina tai vapaamuotoisina, muotoituna riveinä SpecificationFree- Text-elementissä. Tiedot tulisi antaa sekä vapaamuotoisina että määrämuotoisina, jotta vastaanottaja voi katsoa niitä laskulla tai käsitellä tietoja automaattisesti. Toimiala ylläpitää itse määrämuotoista kuvausta. Finvoicen 1.x-versiot ovat alaspäin yhteensopivia. 2.1 Finvoice-verkkolaskun käyttösuositukset Finvoice-verkkolaskun tietosisältö on määritelty 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 Välisumman käyttö riveillä SubRow:lle voidaan laskea rivien yhteenvetotietoja esim. välisummia. Välisumman avulla laskurivit voidaan ryhmitellä esim. osastoittain, tuoteryhmittäin, tilauksittain. 2.1.3 Tiliöintiehdotusten käyttö ja tiliöintien automatisointi Verkkolaskun tiliöinnillä tarkoitetaan ostajan kirjanpitoa varten valmiiksi verkkolaskulle tehtyä tiliöintiehdotusta. Tiliöintiehdotuksen avulla ostaja voi laatia omat kirjanpitomerkintänsä.
Kuvaus 8 (72) 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ä kulu- että 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. 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, OrganisationUnitNumber 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ä". Rivikohtainen tiliöinti tai tilausviite voidaan lähettää jo tilauksen yhteydessä myyjälle, joka välittää sen suoraan laskulle. RowAccountDimensionText on tarkoitettu keskenään sovittujen tiliöintitietojen 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
Kuvaus 9 (72) voivat olla tällöin esim. puolipisteellä eroteltuina, esimerkiksi "456;;Uusikaupunki 2;43". Tiliöinnin seurantakohteet täytetään rakenteen mukaisessa järjestyksessä. 2.1.4 Arvonlisäverottomien laskujen perusteet Verohallinnon ohjeessa 1731/40/2003 kappaleessa 5 kohdassa 11 mainitut verottomuuden perusteet ilmoitetaan VatFreeText tai tai RowFreeText-elementeissä. 3 Tietoelementtien käyttö Tässä kohdassa on lueteltu vain tiettyjen elementtien käyttöön liittyvät tarkennukset. Kaikki tietoelementit ja niiden pituus, esiintyminen, pakollisuus ja käyttö on kuvattu soveltamisohjeen tietoluettelossa. 3.1.1 SellerOrganisationUnitNumber Osapuolen organisaatioyksikkö, joka on SFS-standardin mukainen ovt-tunnus. Tietoa voidaan käyttää esim. ostajan järjestelmissä myyjän tunnistamiseen. SFS-standardin mukainen ovt-tunnus on muodoltaa seuraavan esimerkin kaltainen: 00371234567800001 0037 Suomen maakoodi 12345678 Y-tunnus ilman väliviivaa 00001 Valinnainen tarkenne organisaatioyksikköä varten 3.2 SellerInformationDetails Yleiset myyjän yhteystiedot, jotka voidaan päivittää myyjärekisteriin. Suositellaan käytettäväksi laskukohtaisesti vain kun laskut pelkästään tulostetaan paperille. 3.3 InvoiceRecipientPartyDetails Laskun vastaanottaja tietoryhmää käytetään, kun laskun vastaanottaja on muu kuin ostaja, esimerkiksi tilitoimisto tai muu ostajan puolesta toimiva asioimisto. Tietoryhmässä voidaan myös toistaa ostajan tiedot. InvoiceRecipientSellerOrganisationName-elementti voi toistua usean kerran. Elementeissä annetaan samaan organisaatioon liittyvät nimet ja yksiköt. 3.3.1 InvoiceRecipientOrganisationUnitNumber Osapuolen organisaatioyksikkö, joka voi olla viisinumeroinen organisaattiotarkenne (ovt:n loppuosa) tai koko SFS-standardin mukainen ovt-tunnus. SFS-standardin mukainen ovt-tunnus on muodoltaa seuraavan esimerkin kaltainen:
Kuvaus 10 (72) 00371234567800001 0037 Suomen maakoodi 12345678 Y-tunnus ilman väliviivaa 00001 Valinnainen tarkenne organisaatioyksikköä varten 3.4 BuyerPartyDetails Ostajan arvolisäverotunniste (VatNumber) on merkittävä BuyerOrganisationTaxCodeelementtiin, jos ostaja on verovelvollinen käännetyn verovelvollisuuden perusteella tai kysymys on yhteisömyynnistä. Lisäksi VatFreeTextiin lisätään maininta mahdollisesta verottomuuden perusteesta. Rivitasolla käytetään RowFreeTextiä. BuyerSellerOrganisationName-elementti voi toistua usean kerran. Elementeissä annetaan samaan organisaation liittyvät nimet ja yksiköt. 3.4.1 BuyerOrganisationUnitNumber Osapuolen organisaatioyksikkö, joka voi olla viisinumeroinen organisaatiotarkenne (ovt:n loppuosa) tai koko SFS-standardin mukainen ovt-tunnus. Suositellaan käytettäväksi 17 merkkistä tunnusta. SFS-standardin mukainen ovt-tunnus on muodoltaa seuraavan esimerkin kaltainen: 00371234567800001 0037 Suomen maakoodi 12345678 Y-tunnus ilman väliviivaa 00001 Valinnainen tarkenne organisaatioyksikköä varten 3.5 DeliveryPartyDetails Toimitusosapuolen tietoja käytetään silloin, kun laskutettava toimitus on osoitettu muulle kuin ostajalle. DeliveryOrganisationName-elementti voi toistua usean kerran. Elementeissä annetaan samaan organisaatioon liittyvät nimet ja yksiköt. 3.5.1 DeliveryOrganisationUnitNumber Osapuolen organisaatioyksikkö, joka voi olla viisinumeroinen organisaatiotarkenne (ovt:n loppuosa) tai koko SFS-standardin mukainen ovt-tunnus. Suositellaan käytettäväksi 17 merkkistä tunnusta. SFS-standardin mukainen ovt-tunnus on muodoltaa seuraavan esimerkin kaltainen:
Kuvaus 11 (72) 3.6 DeliveryDetails 3.7 InvoiceDetails 00371234567800001 0037 Suomen maakoodi 12345678 Y-tunnus ilman väliviivaa 00001 Valinnainen tarkenne organisaatioyksikköä varten Toimitusta koskevat tiedot. Jos toimitus koskee tiettyä ajanjaksoa, esimerkiksi energiaa tietylle kaudelle, ilmoitetaan toimitus periodina alku- ja loppupäivineen. Laskun tiedoista on aina ilmoitettava pakolliset tiedot. Maksuehtoa käytetään silloin, kun myyjä on laskenut laskulle alennuksen tai viivästyksen. Tiliöintitiedoissa suositellaan annettavaksi vähintäänkin perustililuettelon mukainen tiliöinti. Lähetettäessä yritysten välisiä laskuja ja e-laskuja kuluttajille käytetään koodia INV01. Invoice type codes and texts: InvoiceTypeCode InvoiceTypeText Description REQ01 TARJOUSPYYNTÖ Request of Quotation QUO01 TARJOUS Quotation ORD01 TILAUS Order ORD02 TILAUSVAHVISTUS Order Confirmation DEV01 TOIMITUSILMOITUS Delivery Note eg kuormakirja INV01 LASKU Commercial Invoice, e-lasku for consumer INV02 HYVITYSLASKU Credit Note, See also Notes below INV03 KORKOLASKU INV04 SISÄINEN LASKU INV05 PERINTÄLASKU INV06 PROFORMALASKU TES01 TESTILASKU Test Invoice PRI01 HINNASTO Price List INF01 TIEDOTE Tiedot voidaan antaa laskun minimitiedoilla. Viesti on kirjoitettu riveillä RowFreeText-elementissä InvoiceTypeCode ja InvoiceTypeText voivat olla toimialakohtaisia, jolloin ko. toimiala julkaisee ja ylläpitää käytettävät arvot. Huom! InvoiceTypeCode ja InvoiceTypeText ohjaavat vain laskun esittämistä selaimella. Laskun loppusumma muodostuu laskuriveistä, jotka voivat olla positiivisia tai negatiivisia. Laskun loppusumma on rivien summa ja voi siksi olla positiivinen tai negatiivinen. Jos laskun määrä on negatiivinen, voidaan laskusta käyttää nimitystä hyvityslasku. Jos käytetään hyvityslaskun koodia INV02, on laskun loppusumman oltava negatiivinen; muutoin lasku
Kuvaus 12 (72) on hylättävä, koska sen merkitys on epäselvä. Koodilla INV01-esitetyn laskun loppusumma voi olla positiivinen tai negatiivinen. OriginalInvoiceNumber-elementin käyttö hyvitys- ja korkolaskuissa: Elementissä annetaan alkuperäisen laskun tunniste. Mikäli hyvitys- tai korkolaskuihin liittyy useita eri laskuja, annetaan alkuperäisten laskujen tunnistetiedot rivitasolla elementissä OrginalInvoiceNumber. 3.7.1 PaymentTermsDetails 3.7.2 PaymentStatus Jos laskulla on ehdollinen alennus, esimerkiksi kassa-alennus tai käteisalennus, pitää verottajan ohjeen mukaan laskea valmiiksi eri eräpäivien maksettavat summat tai vähintäänkin tällaisen ehdollisen alennuksen verollinen arvo. Alennuksen verollinen määrä annetaan elementissä CashDiscountAmount. Maksun tila ilmoittaa, onko lasku jo maksettu. Maksetusta laskusta on ilmoitettava maksutapa. Laskun osamaksu ja osamaksuerät ilmoitetaan PartialPayment-osassa. Suoraveloitettavan, kortilla tai käteisellä maksetun laskun PaymentStatusCode on PAID ja rahamäärä Epin EpiIntsructedAmount-elementissä pitää olla 0,00. 3.7.3 VirtualBankBarcode 3.8 InvoiceRow 3.8.1 SubInvoiceRow Viivakoodin käyttö on suositeltavaa varsinkin verkkolaskun alkuvaiheessa. Kun vastaanottaja avaa laskun selaimella, voidaan virtuaaliviivakoodi siirtää Internet pankkipalveluun tai pankkiyhteysohjelmaan Copy/Pastella. Koodia ei käytetä automaattisessa käsittelyssä. Yksikköhinta on tuotteen tai palvelun veroton hinta, joka kerrotaan laskutusjärjestelmästä tai myyjän ja ostajan välisestä sopimuksesta riippuen joko DeliveredQuantity tai ConfirmedQuantity-elementin arvolla. ConfirmedQuantityä käytetään, jos koko vahvistettu tilaus laskutetaan yhdessä erässä vaikka tavara toimitetaan erissä. OrderedQuantity-elementissä voi ilmoittaa tilatun määrän. SubInvoiceRow-aggregaatti on tarkoitettu laskuriveistä muodostettujen yhteenvetorivien esittämiseen. Verkkolaskuina välitettävistä laskuista ei muodosteta koontilaskuja. SubInvoiceRow:n avulla voidaan helpottaa laskun tarkastamiskäsittelyä laskun visualisoinnin yhteydessä. SubRowAmount-elementtiin tulee edeltävien RowAmount-elementtien yhteenlaskettu summa. Laskun lay-outissa (XSL) rivit tulostuvat tummennettuna tekstinä. Laskun loppusummien ja alv-yhteenvetojen laskemiseen käytetään InvoiceRow-aggregaatin tietoja. SubRow-elementtien tietoja ei käytetä laskun loppusumman laskentaan, koska siitä saattaa aiheutua pyöristyseroja eikä se tue automaattista käsittelyä.
Kuvaus 13 (72) SubInvoiceRow on InvoiceRow:n ala-aggregaatti. InvoiceRow sisältää tällöin vain SubInvoiceRow:n. SubInvoiceRow:ta voidaan käyttää yksikertaisimmillaan niin, että SubArticleNameelementtiin kirjoitetaan yhteenvetoa kuvaava teksti ja SubRowAmountiin edelläolevien rivien yhteismäärä. SubRow:lla voidaan antaa viite, jolloin annetulla viitteellä SubInvoiceRow voidaan kohdistaa tiettyihin InvoiceRow-aggregaatteihin. 3.8.1.1 SubRowDeliveryDetails 3.9 SpecificationDetails Elementeissä esitetään rivikohtaisesti toimitukseen liittyvät tiedot. RowQuotationIdentifier-elementissä voidaan antaa tarjouksen viite. Toimialakohtaiset erittelytiedot voidaan antaa tämän aggregaatin sisällä esim. sähkölaskun erittelytiedot jne. Toimiala ylläpitää itse tietosisältöä ja kuvausta. Elementti voi sisältää esim. linkin erittelytietoihin tai kaikki erittelytiedot elementeineen. Lisäksi ulkoasun esittämistä varten tarvitaan toimialakohtainen xsl-tiedosto. Varsinaisen laskun käsittelyyn erittelytiedot eivät vaikuta. Erittelyt voidaan esittää myös muotoiltuna SpecificationFreeText-elementissä, jolloin Pankkiyhdistyksen vakio xsl:llä tiedot voidaan esittää maksajalle. Jos toimialle on määritelty SpecificationDetailsiin rakenteellinen kuvaus, kannattaa tiedot antaa sekä muotoiltuna vapaana tekstinä, että rakenteellisena. Rakenteellista osuutta voi tästtöin käyttää hyödyksi taloushallinnon järjestelmissä. Esimerkki: <SpecificationDetails> <SpecificationFreeText>LASKUN VAPAAMUOTOISET ERITTELYTIEDOT: </SpecificationFreeText> <SpecificationFreeText>Sarake-1 Sarake-2 Sarake-3</SpecificationFreeText> <SpecificationFreeText>------------------------------------------------</SpecificationFreeText> <SpecificationFreeText>1.sarakkeen tieto 2.sarakkeen tieto 10,00</SpecificationFreeText> <SpecificationFreeText>Toinen rivi Toinen rivi 1 000,00</SpecificationFreeText> <SpecificationFreeText>Kolmas rivi 3/2 1,00</SpecificationFreeText> < </SpecificationDetails> 3.10 epidetails Epi sisältää pankille toimitettavan maksutoimeksiannon tekemiseen tarvittavat tiedot, jotka maksaja on antanut. Epi on tarkoitettu sekä kotimaisen että kansainvälisen maksutoimeksiannon välittämiseen. Epi mahdollistaa automaattisen käsittelyn maksajalta saajalle pankkien kautta. EpiInstructedAmount-elementtiin tulee Lähettäjän maksettavaksi määrittelemä määrä.
Kuvaus 14 (72) EpiRemittanceInfoIdentifier elementtiin tulee Suomessa pankkistandardin mukainen viitenumero ilman välilyöntejä etunollatäytöllä. Attribuutti SPY-kuvaa Finanssialan Keskusliiton viitenumerostandardia. Kansainvälistä viitettä käytettäessä annetaan attribuutitiedoksi ISO. EpiAccountID-elementtiin tulee maksun saajan tilinumero joko IBAN- tai BBANmuodossa. Tilinumero annetaan konekielisessä muodossa kunkin maan antamien ohjeiden mukaan esim. Suomessa BBAN on 14 numeroa ja IBAN 18 merkkiä. Epi on kuvattu ECBS:n standardi numero EBS 602. Koska ECBS:n Epi-standardiin ei vielä sisälly xml-mallia, esitetään seuraavassa sen suomalainen soveltamisohje. Osa pakollisiksi merkityistä elementeistä ei ole käytössä sovellettaessa Suomessa. Käyttettävät koodit ja koodiluettelojen ylläpitäjät julkaistaan myöhemmin. EpiPaymentInstructionId elementissä on oltava sama tieto kuin SenderInfosanoman PaymentInstructionIdentifier -elementissä. Tällä mahdollistetaan mm. automaattinen maksatus kuluttajalle. 3.11 Laskun laskentasäännöt Laskun loppusumma lasketaan Lähettäjän laskutustavasta riippuen joko toimitetun, tilatun tai vahvistetun määrän mukaisesti. InvoiceTotalVatIncludedAmount Saadaan laskemalla yhteen InvoiceRow:lta RowAmount-elementit. InvoiceTotalVatExcludedAmount Saadaan laskemalla yhteen InvoiceRow:lta RowVatExcludedAmount-elementit. InvoiceTotalVatAmount Saadaan laskemalla yhteen InvoiceRow:lta RowVatAmount-elementit. InvoiceVatSpecificationDetails-aggregaatin tiedot VatBaseAmount Alv-luokittain RowVatExcludedAmount-elementtien yhteismäärä. VatRateAmount Alv-luokittain RowVatAmount-elementtien yhteismäärä. Yhteismäärä on laskettava rivitasolta alkaen, koska muuten Vat-määrä ei täsmää rivi-tason tietoihin. EpiInstructedAmount Lähettäjän maksettavaksi määrittelemä määrä.
Kuvaus 15 (72) 3.12 Linkkien käyttö Finvoice-verkkolaskussa Sanomassa voidaan antaa linkki esim. laskuoperaattorin tarjoamiin visualisointipalveluihin, myyjän tarjouksiin, laskun liitteisiin. Urlia vastaava teksti kirjoitetaan InvoiceUrlTextelement-tiin. Kun lasku on saapunut verkkopankkiin ja maksaja klikkaa laskussa olevaa linkkiä, maksaja ohjautuu ns. välisivulle jossa kerrotaan maksajan siirtymisestä pankin ulkopuoliseen palveluun ja pyydetään vahvistamaan siirtyminen. Linkin takana oleva sivu avautuu erilliseen ikkunaan ja tästä ikkunasta ei ole pääsyä takaisin pankin verkkopalveluun Linkissä ei saa välittää luottamuksellisia asiakastietoja. Lähettäjä vastaa linkeistä, niiden toiminnasta, palvelunsa sisällöstä sekä siitä, että pankin, sen asiakkaan tai kolmannen tietoturva ei vaarannu linkkien käyttämisen johdosta. Linkeissä on käytettävä pankin hyväksymää salausta ja niiden kautta näytettävien asiakaskohtaisten tietojen on oltava asianmukaisesti suojattuja. Pankilla on oikeus estää linkkien käyttäminen, jos ne vaarantavat asiointiturvallisuutta. 3.12.1 Lähettäjän muodostama linkki Finvoice-sanomalla on valmiina useita tietokenttiä, joihin lähettäjä voi syöttää linkin. Linkki voi johtaa esimerkiksi lähettäjän julkisille internet-sivuille. Linkki sijoitetaan esimerkiksi InvoiceUrlText-elementtiin sellaisenaan. Lähettäjä vastaa linkin oikeellisuudesta ja sisällöstä. Kun lasku visualisoidaan Finvoice-standardin mukaisella tyylitiedostolla, linkki näkyy aktiivisena. Linkkitiedossa ei saa välittää luottamuksellisia tietoja kuten selväkielistä henkilötunnusta, korttinumeroa, maksaja-asiakkaan tilinumeroa tai muuta vastaavaa arkaluonteista tietoa. 3.12.2 Pankin muodostama linkki Linkin takana esitettävien tietojen tietosuojan parantamiseksi tai personoidun tiedon näyttämiseksi pankki voi muodostaa linkin kuluttajalle verkkopankista lähettäjän tai lähettäjän käyttämän esilläpitoarkiston palvelimelle. Linkin muodostamisessa käytetään verkkopankkilinkkitekniikkaa, jonka tekninen kuvaus on saatavissa Finanssialan Keskusliiton internetsivuilta. Lähettäjän ja/tai esilläpitoarkistoa ylläpitävän yrityksen on sovittava palvelun käytöstä pankin kanssa ennen palvelun käytön aloitusta. Lähettäjä kirjoittaa InvoiceUrlText-elementtiin ensin pankin kanssa sovitun esilläpitoarkiston tunnuksen (y-tunnus ilman väliviivaa 8 merkkisenä) ja sen jälkeen laskun liitteet esilläpitoarkistossa yksilöivän tunnisteen (max 60 merkkiä). Tiedot kirjoitetaan samaan kenttään
Kuvaus 16 (72) 4 Kehyksen kuvaus 4.1.1 Yleistä ja ne erotetaan toisistaan +-merkillä. Elementin maksimipituus on 69 merkkiä. Käytettävät tunnisteet on oltava samat kaikissa pankeissa. Esimerkiksi <InvoiceUrlText>12345678+102030FK405060708091011121314156</InvoiceUrlText> Lähettäjä tai lähettäjän esilläpitoarkiston ylläpitäjä vastaa verkkopankkilinkkien tulkintaan tarvittavien toiminnallisuuksien rakentamisesta omaan palveluunsa. Lähettäjä ja/tai esilläpitopalvelua ylläpitävä yritys päättelee linkistä saamiensa tietojen perusteella, kenelle näytetään linkin takana oleva dokumentti. Pankki tuottaa päättelyyn tarvittavan tiedon linkin yhteyteen. Lähettäjä ja/tai esilläpitopalvelun tarjoaja ei saa käyttää linkin tietoja siirtääkseen kuluttajan erilliseen asiointipalveluun tai kolmannen osapuolen palveluun ilman erillistä pankkikohtaista sopimusta. Pankki tarkistaa linkin muodostamisen yhteydessä lähettäjän ja/tai esilläpitoarkistoa ylläpitävän yrityksen linkkisopimuksen olemassa olon. Kukin pankki ottaa tässä kuvatut linkit käyttöön oman aikataulunsa mukaisesti. Kehys pohjautuu ebxml-hankkeen suositukseen, jossa sanoma välitetään SOAP-enveloperakennetta hyväksi käyttäen. Kehysten käyttö Finvoicen välityksessä poikkeaa ebxml 2.0 suosituksesta To- ja From-elementtien käytön osalta, koska ratkaisu on tehty ennen ebxml-suosituksen virallista hyväksymistä. Tässä ohjeessa kuvattu malli mahdollistaa laskusanoman välittämisen suoraan kauppakumppaneiden välillä tai käyttäen hyväksi välittäjänä toimivaa kolmatta osapuolta (Intermediator) esimerkiksi pankkia tai laskuoperaattoria. Kehys on suunniteltu erityisesti koneiden väliseen liikennöintiin. Sanoman lähettämiseen ja vastaanottamiseen voidaan käyttää samaa turvatekniikkaa ja välityskanavaa kuin muussakin sanomavälityksessä kyseisen osapuolen kanssa. Yhteen kehykseen liittyy aina yksi ja vain yksi lasku. 4.1.2 Pankkiyhteysohjelman käyttö Finvoice-verkkolaskut voidaan noutaa ja lähettää pankkiyhteysohjelmalla. Finvoice-verkkolaskuja välitetään myös pankkien välillä. Tiedoston lähetys pankkiyhteysohjelmalla pankkiin tapahtuu samoilla periaatteilla kuin muidenkin aineistojen esim. LMP-aineiston lähetys. Pankki reitittää Finvoicen vastaanottajalle kehyksessä olevan vastaanottajan tunnuksen ja intermediator-tunnuksen perusteella. Suomalaisten pankkien sanomaliikenteessä käytetään Patu-suojausta ja VPN-salausta osapuolten keskenään sopimalla tavalla. Patu-sanomat ja suojaustietueet tulevat laskusanoman kehysten ulkopuolella. Pankkiyhteysohjelmassa käytetään ISO-8859-15 merkistöä.
Kuvaus 17 (72) Finvoice-verkkolaskussa XML-standardin mukaisesti korvattaan tietyt erikoismerkit. Entiteetteinä pitää ilmoittaa mm. seuraavat erikoismerkit: Merkki & Entiteetti & < < > > " " ' ' Esimerkiksi yrityksen nimi TILI & Tiliöinti Oy ilmoitetaan TILI & Tiliöinti Oy 4.1.3 Pankkiin lähetettävän tiedoston rakenne Pankkiin lähetettävä tiedosto voi sisältää useita laskuja. Jokaisessa laskussa on oltava siirtokehys (SOAP), jossa kerrotaan lähettäjän ja vastaanottajan tiedot sekä välittäjien tiedot. Pankki reitittää laskun vastaanottajalle kehyksen tietojen perusteella. Lasku-tiedoston rivi alkaa aina alkutagillä ja päättyy lopputagiin. Sama koskee siirtokehystä. Yhdellä rivillä voi olla vain yksi elementti alku- ja lopputageineen. Esimerkki: <SellerOrganisationName>Pullin Musiikki Oy</SellerOrganisationName> Jos laskuaineisto lähetetään sisennyksiä käyttäen, sisennysmerkkinä sallitaan vain tyhjämerkki eli välilyönti, ei tabulaattoria. 4.1.4 Allekirjoitus Kehysrakenne mahdollistaa sähköisen allekirjoituksen käyttämisen tarvittaessa, kun se tulevaisuudessa otetaan käyttöön. 4.1.5 Testaus Lasku-sanoman muodostuksen testaus tehdään aina schema-tiedoston avulla. Mallitiedostoissa viittaus schema-tarkistukseen on kommenteissa. Viittauksia tarvitaan vain testausvaiheessa. Pankit tarjoavat omissa palveluissaan mahdollisuuden testata lähettämistä ja vastaanottamista. 5 Sanoman rakenne Sanoman rakenne sisältää Mime-multipart-rakenteen, jossa SOAPille, ebxml-headerille ja Finvoicelle on oma osansa. Pankkien kautta laskuja välitettäessä ei Mime-multipart-rakennetta käytetä. Varsinainen lasku tulee kehyksen ulkopuolella. Rakenne antaa mahdollisuuden kaikkien osien omaan toisistaan riippumattomaan versiointiin.
Kuvaus 18 (72) Kuvassa on esitetty sanoman rakenne. Header osassa kerrotaan lähettäjän/lähettäjien ja vastaanottajan tunnistetiedot. Varsinainen xml-sanoman viittaus on SOAP-ENV:bodyssa. Kehys on yhteensopiva SOAP 1.1.:n kanssa. SOAP 1.2:ssa on nimiavaruuden oltava: http://www.w3.org/2001/12/soap-envelope ja mustunderstand="true" mutta muuta muutoksia ei ole tarpeen tehdä. Communication Protocol Envelope (HTTP,SMTP etc) SOAP with attachments MIME Envelope MIME Part SOAP-ENV:Envelope SOAP-ENV:Header Message Package Header Container eb:messageheader eb:to role: eb:from role: SOAP-ENV:Body Eb:Manifest MIME Part Finvoice Payload Container(s) Kehykseen voidaan myöhemmin lisätä myös laskun allekirjoitukseen liittyvät elementit. 5.1 Esimerkki kehyksestä ja laskusta (alku) Tiedosto alkaa <SOAP-ENV:..-elementistä. <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:eb="http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd"> <SOAP-ENV:Header> <eb:messageheader xmlns:eb="http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header-2_0.xsd" SOAP-ENV:mustUnderstand="1" eb:id="20021209133003285"> <eb:from> <eb:partyid>12345678-9</eb:partyid> <eb:role>sender</eb:role> </eb:from> <eb:from> <eb:partyid>ndeafihh</eb:partyid> <eb:role>intermediator</eb:role> </eb:from> <eb:to> <eb:partyid>fi12500015212345545</eb:partyid> <eb:role>receiver</eb:role> </eb:to>
Kuvaus 19 (72) <eb:to> <eb:partyid>okoyfihh</eb:partyid> <eb:role>intermediator</eb:role> </eb:to> <eb:cpaid>yoursandmycpa</eb:cpaid> <eb:conversationid>nnnnn </eb:conversationid> <eb:service>routing</eb:service> <eb:action>processinvoice</eb:action> <eb:messagedata> <eb:messageid>20020209-133003</eb:messageid> <eb:timestamp>2002-02-15t11:12:12+02</eb:timestamp><eb:reftomessageid/> </eb:messagedata> </eb:messageheader> </SOAP-ENV:Header> <SOAP-ENV:Body> <eb:manifest eb:id="manifest" eb:version="2.0"> <eb:reference eb:id="finvoice" xlink:href="20020209-133003"> <eb:schema eb:location="http://www.pankkiyhdistys.fi/verkkolasku/finvoice/finvoice.xsd" eb:version="2.0"/> </eb:reference> </eb:manifest> </SOAP-ENV:Body> </SOAP-ENV:Envelope> <?xml version="1.0" encoding="iso-8859-15"?> <!DOCTYPE Finvoice SYSTEM "Finvoice.dtd"> <?xml-stylesheet type="text/xsl" href="finvoice.xsl"?> <Finvoice version="1.0"> <SellerPartyDetails> <SellerPartyIdentifier>0123456-7</SellerPartyIdentifier> <SellerOrganisationName>Pullin Kala Oy</SellerOrganisationName> <SellerOrganisationTaxCode>0123456-7</SellerOrganisationTaxCode> <SellerPostalAddressDetails> <SellerStreetName>Haapatie 7</SellerStreetName> <SellerTownName>Helsinki</SellerTownName> <SellerPostCodeIdentifier>00100</SellerPostCodeIdentifier> <CountryCode>FI</CountryCode> <CountryName>FINLAND</CountryName> <SellerPostOfficeBoxIdentifier>PL 302</SellerPostOfficeBoxIdentifier> </SellerPostalAddressDetails> </SellerPartyDetails> jne 5.1.1 Esimerkin osat ja selitykset <SOAP-ENV:Envelope xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:eb="http://www.oasisopen.org/committees/ebxml-msg/schema/msg-header-2_0.xsd"> <SOAP-ENV:Header> <eb:messageheader xmlns:eb="http://www.oasis-open.org/committees/ebxml-msg/schema/msg-header- 2_0.xsd" SOAP-ENV:mustUnderstand="1" eb:version="2.0" eb:id="20021209133003285"> Kehyksessä käytetään SOAP-standardin envelopea ja ebxml:n headeria:n kuljetusmäärityksissä osoitetulla tavalla (Transport, Routing and Packaging Specification 2.0 osoitteessa www.oasis-open.org). eb:id="nnnn-kenttä ei ole pakollinen. Kenttää käytetään allekirjoitetun laskun yhteydessä.