Finvoice soveltamisohje versio 1.3 päiv. 23.5.2011
1 (2) 4.3.2011 Sisällysluettelo 1 Mikä on Finvoice... 1 2 Yleiskuvaus Finvoice-välityspalvelusta... 1 3 Kuluttajan e-lasku... 2 4 Aineistonhoitajan käyttö Finvoice-välityspalvelussa... 2 5 Finvoice-välityspalveluun liittyvät kuvaukset... 2 6 Testaus... 3 7 Finvoice-Sanoman perusrakenne ja käyttösuositukset... 3 7.1 Sanoman siirtokehys... 3 7.2 Sanoman rakenne... 3 7.3 Merkistö Finvoice-sanomalla... 4 7.4 Lukuarvojen ilmoittaminen Finvoice-sanomalla... 4 8 Finvoice-sanoman käyttösuositukset... 4 8.1 Yleistaso (Laskutaso) ja rivitason käyttö... 5 8.2 Välisumman käyttö riveillä... 5 8.3 Tiliöintiehdotusten käyttö ja tiliöintien automatisointi... 5 8.4 Arvonlisäverottomien laskujen perusteet... 5 9 Tietoelementtien käyttö... 6 9.1 MessageTransmissionDetails... 6 9.2 SellerPartyDetails... 6 9.2.1 SellerOrganisationUnitNumber... 7 9.2.2 SellerInformationDetails... 7 9.3 InvoiceRecipientPartyDetails... 7 9.3.1 InvoiceRecipientOrganisationUnitNumber... 7 9.4 BuyerPartyDetails... 7 9.4.1 BuyerOrganisationUnitNumber... 7 9.5 InvoiceRecipientLanguageCode... 8 9.6 DeliveryPartyDetails... 8 9.6.1 DeliveryOrganisationUnitNumber... 8 9.6.2 DeliveryDetails... 8 9.7 ShipmentPartyDetails... 8 9.8 AnyPartyDetails... 8 9.9 Factoring... 9 9.10 RowOverDuePaymentDetails... 9 9.11 InvoiceDetails... 9 9.12 BuyerSellerIdentifier ja SellerBuyerIdentifier... 10 9.13 PaymentTermsDetails... 10 9.14 PaymentStatus... 10 9.15 VirtualBankBarcode... 10 9.16 InvoiceRow... 10 9.17 DefinitionDetails... 11 9.18 Alennukset laskuriveillä... 11 9.19 SubInvoiceRow... 11 9.20 SubRowDeliveryDetails... 11 9.21 SpecificationDetails... 11 9.22 epidetails... 12 9.23 LayOutIdentifier... 12 9.24 InvoiceSegmentIdentifier... 12 9.25 Laskun laskentasäännöt... 13 10 Linkkien käyttö Finvoice-verkkolaskussa... 13 10.1 Lähettäjän muodostama linkki... 13 10.2 Palveluntarjoajan muodostama linkki... 14 11 SOAP-kehyksen kuvaus... 14
2 (2) 4.3.2011 11.1 SOAP-kehyksen rakenne... 14 11.2 Esimerkki kehyksestä... 15 11.2.1 Esimerkin osat ja selitykset... 16 12 Vahvistussanoma... 19 12.1.1 Vahvistussanoman osat... 21 12.1.2 Vahvistussanoman ulkoasu selaimella (XSL)... 22 13 Finvoice tekninen kuvaus... 22 13.1 Soveltamisohjeessa käytetyt attribuutit... 23 13.2 Finvoice rakenne... 23 13.3 InvoiceDetailsin rakenne... 25 13.4 InvoiceRow:n rakenne... 26 13.5 SubInvoiceRow rakenne... 27 13.6 Tietoluettelon tietojen selitykset... 27
1 (27) 1 Mikä on Finvoice Finvoice-sanomaa voidaan käyttää laskutukseen ja jopa muihin liiketoimintasanomiin kuten tarjoukset, tilaukset, tilausvahvistukset, hinnastot jne. Se soveltuu kaikenkokoisten yritysten väliseen laskutukseen sekä kuluttajalaskutukseen, koska sen käyttöönotto on helppoa. Finvoice on määritelty käyttäen xml-syntaksia. Xml mahdollistaa esim. 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. Ensimmäinen versio Finvoice-sanomasta julkaisiin vuonna 2003, versio 1.1 vuonna 2004 ja versio 1.2.vuoden 2005 alussa. Finvoicen 1.x-versiot ovat alaspäin yhteensopivia. Finvoice 1.1:ssä ei vielä määritelty kenttien maksimipituuksia, se on tehty versiosta 1.2 alkaen. 2 Yleiskuvaus Finvoice-välityspalvelusta Finvoice-verkkolaskun soveltamisohje sekä laskun muodollisessa tarkastuksessa tarvittavat dtd-, xsd- ja xsl-tiedostot ovat vapaasti noudettavissa Finanssialan Keskusliiton verkkosivuilta osoitteesta www.finvoice.info. Kaikki versiot tulee olla skeeman mukaisia. Ohjelmistotoimittaja vastaa siitä, että ohjelmisto tekee skeeman mukaisia verkkolaskuja. Finvoice 1.2 versio tarkistetaan pankkikanavassa DTD:tä vasten. 1.3 versio tarkistetaan pankissa skeemaavasten, jolloin viittaus pitää olla xsd. 1.2 versiossa: <!DOCTYPE Finvoice SYSTEM "Finvoice.dtd"> 1.3 versiossa: <Finvoice Version="1.3" xmlns:xsi="http://www.w3.org/2001/xmlschemainstance" xsi:nonamespaceschemalocation="finvoice.xsd"> Skeeman vastainen aineisto hylätään virhekoodilla 6. Finvoice ja e-lasku ovat Finanssialan Keskusliiton (aik. Suomen Pankkiyhdistys ry) rekisteröimiä tavaramerkkejä, joita voidaan käyttää vain silloin, kun välityspalvelu on kaikilta osin voimassa olevien Finvoice-välityspalvelun kuvausten ja ehtojen mukainen. Finanssialan Keskusliitto omistaa Finvoice-välityspalvelun kuvausten ja ehtojen tekijänoikeudet. Finvoice-välityspalvelun käyttö edellyttää, että sekä lähettäjällä että vastaanottajalla on sopimus Finvoice-välityspalvelusta palveluntarjoajansa kanssa. Kuluttajat sopivat palveluntarjoajansa kanssa e-laskujen vastaanottamisesta verkkopankkiin tai maksamisen verkkopalveluun. Myyjä luo kuvauksen mukaisen laskun siirtokehyksineen ja lähettää sen ostajalle palveluntarjoajansa kautta. 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. Sivuilla on mainittu yrityksen nimi, lähetys- ja vastaanottotunnukset sekä palveluntarjoajan tunnukset.
2 (27) Toisen Finvoice-välityspalvelua käyttävän asiakkaan tunnistaa osoitteeseen liittyvästä palveluntarjoajan tunnuksesta, joka on tällöin palveluntarjoajan oma BIC-tunnus. Tällöin kumpikin osapuoli on tehnyt sopimuksen Finvoice-välityspalvelusta palveluntarjoajansa kanssa ja sopinut samoista palveluehdoista. 3 Kuluttajan e-lasku Kuluttajan e-lasku on Finvoice-verkkolasku, jonka kuluttaja saa verkkopankkiinsa tai maksamisen verkkopalveluun. Lähettäjä ilmoittaa FinvoiceSenderInfo- sanomalla verkkopankkia tai maksamisen verkkopalvelua käyttäville asiakkaille omat laskuttajatietonsa. Sanoman pohjalta palveluntarjoaja asettaa tiedot verkkopankissa tai maksamisen verkkopalvelussa asiakkaan käytettäväksi. Asiakkaan osoitetiedot välitetään FinvoiceReceiverInfo-sanomalla lähettäjälle. Kuluttajan e-laskuun liittyvä Ilmoittamispalvelun sanomakuvaus, tekniset tiedostot ja kuluttajille suunnattu viestintäaineisto, on vapaasti noudettavissa Finanssialan Keskusliiton verkkosivuilta osoitteesta www.e-lasku.info. 4 Aineistonhoitajan käyttö Finvoice-välityspalvelussa Aineistonhoitaja voi olla esim. palvelutalo, tilitoimisto, verkkolaskuoperaattori jne. Finvoicevälityspalvelussa palveluntarjoaja tunnistaa aina alkuperäisen lähettäjän ja vastaanottajan. ASIAKAS ASIAKAS 1 1 ASIAKAS ASIAKAS 3 3 From As1 From IntermA To As2 To IntermA ASIAKKAAN ASIAKKAAN 1 1 AINEISTON AINEISTON - - HOITAJA HOITAJA X X Palveluntarjoaja A = IntermA From As1 From IntermA To As2 To IntermA From As1 From IntermA To As3 To IntermB ASIAKAS ASIAKAS 2 2 From As1 From IntermA To As3 To IntermB Tai From As1 From IntermA To As4 To IntermB =sopimussuhde ASIAKKAAN ASIAKKAAN 3 3 AINEISTON AINEISTON - - HOITAJA HOITAJA Y Y From As1 From IntermA To As3 To IntermB Palveluntarjoaja PANKKI B B = IntermB From As1 From interma To As4 To IntermB ASIAKAS ASIAKAS 4 4 5 Finvoice-välityspalveluun liittyvät kuvaukset Soveltamisohjeeseen sisältyy
3 (27) o o o o o o o o o 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 käytetään 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. Lisäksi www.finvoice.info sivuilta on saatavilla ilmainen arkistointiohjelma, jossa laskun kehys voidaan purkaa ja laskuja voidaan käsitellä omassa hakemistossaan. Finvoice-välityspalvelun kuvaus ja ehdot, jossa on kuvattu palvelun toiminta, sopimuskäytännöt, palvelun ehdot sekä lähettäjälle että vastaanottajalle. Kuluttajalaskutukseen liittyvät Ilmoittamispalvelun soveltamisohje ja laskuttajailmoituksen teko-ohjelma ovat www.finvoice.info sivuilla. Eri toimialat voivat laatia toimialakohtaisia soveltamisohjeita. Toimialakohtaiset soveltamisohjeet eivät saa olla ristiriidassa Finvoice 1.3 soveltamisohjeen kanssa. Toimialakohtaiset ohjeet voidaan julkaista www.finvoice.info sivulla. 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. 6 Testaus Lasku-sanoman muodostuksen testaus tehdään aina schema-tiedoston avulla. Mallitiedostoissa viittaus schema-tarkistukseen on kommenteissa. Finvoice-välityspalvelussa mukana olevat palveluntarjoajat voivat tarjota omissa palveluissaan mahdollisuuden testata lähettämistä ja vastaanottamista. 7 Finvoice-Sanoman perusrakenne ja käyttösuositukset 7.1 Sanoman siirtokehys 7.2 Sanoman rakenne Siirtokehys mahdollistaa laskun reitittämisen laskun lähettäjältä laskun vastaanottajalle. Siirtokehys on kuvattu tarkemmin soveltamisohjeen kohdassa Kehyksen kuvaus. Sanoma sisältää minimissään pakolliset tiedot: - Myyjän tiedot - Ostajan tiedot - Laskun tiedot - Laskurivin tiedot - Myyjän antamat tiedot maksutoimeksiantoa varten (epi) Elementtien minimi- ja maksimipituudet on määritelty erillisessä tietoluettelossa. Valinnaiset kentät, joissa ei ole tietoa, tulee jättää kokonaan pois. Lasku-tiedoston rivi alkaa aina alkutagillä ja päättyy lopputagiin. Sama koskee siirtokehystä. Yhdellä rivillä voi olla vain yksi elementti alku- ja lopputageineen. Alku- ja lopputagin välissä olevan arvon edessä ja lopussa ei saa käyttää välilyöntejä (space) esim. niin, että kentän pituus on aina 35 merkkiä.
4 (27) 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. Finvoice välityspalvelussa ei välitetä liitteitä. Finvoice-välityspalvelussa verkkolaskujen välitys perustuu datan välittämiseen, ei kuvien tai liitteiden välittämiseen. Dataa vastaanottava asiakas voi hyödyntää suoraan omissa järjestelmissä. Tarvittaessa voidaan käyttää SpecificationDetailsin SpecificationFreeText -kenttä, johon Lähettäjä voi lisätä muotoiltua erittelytietoa esim. toimialakohtaiset tiedot. SpecificationFreeTextin etuna on se, ettei erillisiä toimialakohtaisia tyylitiedosta tarvita. Lisäksi Finvoicessa voi käyttää linkkiä, jonka avulla laskun vastaanottaja voi katsoa liitettä Lähettäjän tai aineiston hoitajan palvelussa. 7.3 Merkistö Finvoice-sanomalla Finvoice-sanomilla käytetään ISO-8859-15-merkistöä. Finvoice-verkkolaskussa XML-standardin mukaisesti korvataan tietyt erikoismerkit. Entiteetteinä pitää ilmoittaa mm. seuraavat erikoismerkit: Merkki & Entiteetti & < < > > " " ' ' Esimerkiksi yrityksen nimi TILI & Tiliöinti Oy ilmoitetaan TILI & Tiliöinti Oy 7.4 Lukuarvojen ilmoittaminen Finvoice-sanomalla Desimaalien määrä erilaisten numeeristen tietojen yhteydessä: - EPI tiedoissa raha-arvot tulee antaa aina 2 desimaalilla, jotta verkkopankissa e-laskusta voidaan muodostaa maksuehdotus. - Määrät: jos desimaalit annetaan, desimaaleja on oltava vähintään 2 ja enintään 5 - Prosentit esitetään 1-3 desimaalilla. - Valuuttakurssit esitetään 6 desimaalilla 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. 8 Finvoice-sanoman käyttösuositukset Finvoice-sanoman tietosisältö on määritelty siten, että sanomaa voidaan käyttää mahdollisimman monissa tilanteissa. Tästä johtuen monet tiedot ovat sekä yleis- että rivitasolla. Vaikka tavoitteena on sanoman automaattinen käsittely vastaanottajan järjestelmissä, tietosisältö on määritelty siten, että myös manuaalikäsittelyssä tarvittavat tiedot, kuten osoite-, yhteyshenkilö- ja footer-tiedot ovat käytettävissä.
5 (27) 8.1 Yleistaso (Laskutaso) ja rivitason käyttö Sanomassa on esim. DeliveryDetails-kenttä laskutasoinen ja samat tiedot myös rivikohtaisesti. Esimerkiksi laskutusjakso voidaan esittää laskukohtaisesti DeliveryDetailsin StartDate- ja EndDatekentissä ja laskuriveillä voi olla esim. Freetext-kentässä laskuun liittyvää tietoa tai laskutusjakso voidaan esittää laskurivikohtaisesti. Suositus on käyttää rivikohtaista käsittelyä. 8.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. 8.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ä. Tiliöintiehdotuksen tekeminen Finvoice-sanomassa ei ole pakollista, mutta myyjä ja ostaja voivat sopia tiliöintitietojen käytöstä. Tiliöintitietojen käyttö 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. Finvoice-sanomassa on mahdollisuus käyttää sekä lasku- että rivikohtaista tiliö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. Tiliöintiehdotus voi olla perustililuettelon mukainen, jolloin tiedot välitetään laskutasolla kentissä ShortProposedAccountIdentifier ja NormalProposedAccountIdentifier. Muu kuin perustililuettelon mukainen tiliöintiehdotus sijoitetaan Dimension-elementtiin tai ProposedAccountText-elementiin. Tiliöintiehdotus voidaan antaa myös laskurivitasolla, jolloin käytetään kenttiä RowShortProposedAccountIdentifier ja RowNormalProposedAccountIdentifier. RowAccountDimensionText ja RowProposedAccountText on tarkoitettu keskenään sovittujen tiliöintitietojen ja kustannuspaikkojen välittämiseen. Myyjä voi lisätä laskuun omat tiliöintitietonsa SellerAccountText-elementtiin. Tieto on tarkoitettu myyjän omaa kirjanpitoa varten. Jos myyjä toimittaa laskun kopion esim. tilitoimistolle, voidaan se tiliöidä valmiiksi jo myyjän järjestelmässä tai laskun luontivaiheessa. 8.4 Arvonlisäverottomien laskujen perusteet Verohallinnon ohjeistuksen mukaiset verottomuuden perusteet ilmoitetaan VatFreeText tai Row- FreeText-elementeissä ja VatCode-arvolla, jolloin laskun visualisoinnissa näkyy koodia vastaava seliteteksti.
6 (27) Jos Laskun lähettäjä tai laskutettaa aihe aiheuttaa poikkeavaa verokäsittelyä, voidaan se koodittaa lasku tai laskurivitasolla. Käytettävät koodit on sovittu yhdessä verottajan kanssa. Koodin mukainen teksti näytetään selaimella laskua tarkasteltaessa. Verokohtelukoodit Suomi Englanti Ruotsi AB Marginaalivero Exempt for resale Marginalskatt AE Käännetty ALV VAT Reverse Charge Omvänd Moms E Yhteisömyynti Exempt from tax gemenskapsförsäljning G Veroton myynti ulkomaille (kolmannet maat) Free export item, tax not charged Skattefri försäljning till utlandet (tredje land) O Veroton palvelu Services outside scope of Skattefri tjänst tax S Normaali veroprosentti Standard rate Normal skatteprocent Z Veroton tuote Zero rated goods Skattefri produkt ZEG Vero tavaraostoista muista EU-maista Tax charged from goods bought from other EU countries Skatt på köp av varor från andra EU-länder ZES Vero palveluostoista muista EU-maista Tax charged from services bought from other EU countries Skatt på köp av tjänster från andra EU-länder 9 Tietoelementtien käyttö Tässä kohdassa on lueteltu vain tiettyjen elementtien käyttöön liittyvät tarkennukset. Kaikki tietoelementit ja niiden pituus, esiintyminen ja käyttö on kuvattu soveltamisohjeen tietoluettelossa. 9.1 MessageTransmissionDetails 9.2 SellerPartyDetails MessageTransmissionDetails sisältää samat tiedot kuin Soap-kehyksessä, joka on edelleen pakollinen Finvoice-välityspalvelussa. MessageTransmissionDetails aggregaattia ei toistaiseksi käytetä Finvoice-välityspalvelussa. Sisältää myyjän tiedot, joista osa on pakollisia. Myyjän osoitekenttään (SellerStreetName) laitetaan joko katu- tai käyntiosoite. Jos myyjällä ei ole kuin postilokero-osoite, laitetaan tieto SellerStreet- Name-kenttään ja jätetään SellerPostOfficeBoxIdentifier-kenttä tyhjäksi. SellerOfficialPostalAddressDetails-aggregaatissa annetaan mm. emoyhtiön virallinen osoite, jos se eroaaa SellerPostalAddressDetailsin tiedoista. SellerPartyIdentifierUrlText voi laittaa linkin Patentti- ja rekisterihallituksen rekisteriin, josta y- tunnus voidaan tarkistaa. (www.ytj.fi)
7 (27) 9.2.1 SellerOrganisationUnitNumber Osapuolen organisaatioyksikkö, joka on SFS-standardin mukainen ovt-tunnus. Tietoa voidaan käyttää esim. ostajan järjestelmissä myyjän tunnistamiseen. Suositellaan käytettäväksi 17 merkkistä tunnusta. SFS-standardin mukainen ovt-tunnus on muodoltaan seuraavan esimerkin kaltainen: 00371234567800001-0037 Suomen maakoodi - 12345678 Y-tunnus ilman väliviivaa 8 merkkisenä - 00001 Valinnainen tarkenne organisaatioyksikköä varten 9.2.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. 9.3 InvoiceRecipientPartyDetails Vastaanottaja -tietoryhmää käytetään, kun sanoman vastaanottaja on muu kuin ostaja, esimerkiksi tilitoimisto tai muu ostajan puolesta toimiva osapuoli. InvoiceRecipientSellerOrganisationName-elementti voi toistua usean kerran. Elementeissä annetaan samaan organisaatioon liittyvät nimet ja yksiköt. 9.3.1 InvoiceRecipientOrganisationUnitNumber 9.4 BuyerPartyDetails Osapuolen organisaatioyksikkö, joka on SFS-standardin mukainen ovt-tunnus. Suositellaan käytettäväksi 17 merkkistä tunnusta. SFS-standardin mukainen ovt-tunnus on muodoltaan seuraavan esimerkin kaltainen: 00371234567800001-0037 Suomen maakoodi - 12345678 Y-tunnus ilman väliviivaa - 00001 Valinnainen tarkenne organisaatioyksikköä varten Ostajan arvolisäverotunniste (VatNumber) on merkittävä BuyerOrganisationTaxCode-elementtiin, 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. 9.4.1 BuyerOrganisationUnitNumber Osapuolen organisaatioyksikkö, joka on SFS-standardin mukainen ovt-tunnus. Suositellaan käytettäväksi 17 merkkistä tunnusta. SFS-standardin mukainen ovt-tunnus on muodoltaan seuraavan esimerkin kaltainen:
8 (27) 00371234567800001-0037 Suomen maakoodi - 12345678 Y-tunnus ilman väliviivaa - 00001 Valinnainen tarkenne organisaatioyksikköä varten 9.5 InvoiceRecipientLanguageCode InvoiceRecipientLanguageCode-kentässä annetaan vastaanottajan kielikoodi, jonka perusteella laskun otsikkotiedot voidaan mm. esittää tai tulostaa vastaanottajan kielikoodin mukaisesti. Kuluttajan e-laskussa kieli määräytyy vastaanottajan verkkopankissa tai maksamisen verkkopalvelussa määritellyn kielikoodin perusteella. 9.6 DeliveryPartyDetails Toimitusosapuolen tietoja käytetään silloin, kun tavara on toimitettu muulle kuin ostajalle. DeliveryOrganisationName-elementti voi toistua usean kerran. Elementeissä annetaan samaan organisaatioon liittyvät nimet ja yksiköt. 9.6.1 DeliveryOrganisationUnitNumber 9.6.2 DeliveryDetails Osapuolen organisaatioyksikkö, joka on SFS-standardin mukainen ovt-tunnus. Suositellaan käytettäväksi 17 merkkistä tunnusta. SFS-standardin mukainen ovt-tunnus on muodoltaan seuraavan esimerkin kaltainen: 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. DeliveryDetailsissä voidaan välittää toimitukseen liittyvät yksilöintitiedot kuten toimitustapa, rahtikirjan tiedot, tullausviite, toimittajan nimi, valmistaja, purkupaikka, kuljetukseen liittyvät yksilöintitiedot sekä toimituksen kokoon liittyvät tiedot. Tiedot voidaan esittää lasku- ja rivitasoilla. 9.7 ShipmentPartyDetails 9.8 AnyPartyDetails ShipmentPartyDetails-aggregaatissa annetaan huolitsijan yhteystiedot. PackageDetails-aggregaatissa annetaan pakkaukseen liittyvät tiedot. Elementissä voidaan ilmoittaa sellainen osapuoli, jolle Finvoicesta ei löydy omaa elementtiä. Any- PartyText-elementissä annetaan otsikko ja otsikkoa vastaava koodi osapuolelle. Koodi tulostetaan laskun ulkoasussa. AnyParty-osapuoli voidaan ilmoittaa lasku- ja rivitasoilla. AnyParty-aggregaatti voi olla toistuva. Kukin toimiala määrittelee itse, miten elementtiä käytetään.
9 (27) 9.9 Factoring Rahoitusyhtiön tarvitsemat tiedot välitetään FactoringAgreementDetails-elementeissä. Lähettäjä lähettää kopion alkuperäisestä laskusta rahoitusyhtiölle. FactoringFreeText- elementissä annetaan rahoitusyhtiön määrittelemä siirtolauseke. Tarkemmat ohjeet ovat Rahoitusyhtiön toimialaohjeessa, joka löytyy www.finvoice.info sivuilta. 9.10 RowOverDuePaymentDetails 9.11 InvoiceDetails RowCollectionDate elementissä annetaan perintäkerrat. 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: Invoi- InvoiceTypeText Description cety- pecode REQ01 TARJOUSPYYNTÖ Request of Quotation QUO01 TARJOUS Quotation ORD01 TILAUS Order ORC TILAUSVAHVISTUS OrderConfirmation DEV01 TOIMITUSILMOITUS Delivery Note eg kuormakirja INV01 LASKU Commercial Invoice, e-lasku INV02 HYVITYSLASKU Credit Note, See also Notes below INV03 KORKOLASKU Korkolaskulla tarkoitetaan laskua, jossa veloitetaan ainoastaan korot. ks. RowOverdueDetails INV04 SISÄINEN LASKU INV05 PERINTÄLASKU INV06 PROFORMALASKU INV07 OSTOHYVITYS- Credit Note Made by Purchaser LASKU INV08 HUOMAUTUSLASKU TES01 TESTILASKU Test Invoice PRI01 HINNASTO Price List INF01 TIEDOTE Tiedot voidaan antaa laskun minimitiedoilla. Viesti kirjoitetaan RowFreeText-elementin riveille DEN01 TOIMITUSVIRHE- Delivery error notification ILMOITUS SEI TURVALASKU Secure Invoice (Lasku, jonka käsittely vaatii erityskäsittelyn esim. lasku sisältää potilastietoja). Turvalaskun käytöstä sovitaan erikseen palveluntarjoajan kanssa.
10 (27) InvoiceTypeCode ja InvoiceTypeText voivat olla toimialakohtaisia, jolloin ko. toimiala julkaisee ja ylläpitää käytettävät arvot. Huom! InvoiceTypeCode ja InvoiceTypeText ohjaavat vain sanoman esittämistä selaimella. Sanoman loppusumma muodostuu laskuriveistä, jotka voivat olla positiivisia tai negatiivisia. Sanoman loppusumma on rivien summa ja voi siksi olla positiivinen tai negatiivinen. Jos sanoman määrä on negatiivinen, voidaan sanomasta käyttää nimitystä hyvityslasku. Jos käytetään hyvityslaskun koodia INV02, on sanoman loppusumman oltava negatiivinen; muutoin sanoma on hylättävä, koska sen merkitys on epäselvä. Koodilla INV01-esitetyn sanoman loppusumma voi olla positiivinen tai negatiivinen. OriginalInvoiceNumber-elementin käyttö hyvitys-, huomautus- 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. 9.12 BuyerSellerIdentifier ja SellerBuyerIdentifier Tarvittavat asiakasnumerot laitetaan BuyerSellerIdentifierin ja SellerBuyerIdentifierin elementteihin. 9.13 PaymentTermsDetails 9.14 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 eräpäivä (normaalien maksuehtojen mukainen) annetaan myös Epin EpiDateOptionDateelementissä. Kuluttajaviraston antamien ohjeiden mukaan olisi suositeltavaa, että yritys lähettää e-laskun kuluttajalle niin, että laskun lähettämisen ja eräpäivän välille jää vähintään kaksi viikkoa aikaa. Alennukseen liittyvät Alvit, Alvittomat määrät ja Alv:n määrä ilmoitetaan niitä vastaavissa elementeissä. Maksun tila ilmoittaa, onko lasku jo maksettu. Maksetusta laskusta on ilmoitettava maksutapa. Laskun osamaksu ja osamaksuerät ilmoitetaan PartialPayment-osassa. Kortilla tai käteisellä maksetun laskun PaymentStatusCode on PAID ja rahamäärä Epin EpiIntsructedAmount-elementissä pitää olla 0,00. 9.15 VirtualBankBarcode 9.16 InvoiceRow Tulostettaviin laskuihin voidaan liittää virtuaalinen viivakoodi. Virtuaaliviivakoodiin ei tulosteta viivakoodin rakenteeseen kuuluvaa alkumerkkiä (Start Code C), tarkistetta 2 (Check character/modulo 103 checksum), eikä loppumerkkiä (Stop character). Virtuaaliviivakoodiin tulostetaan 54 merkkiä. 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 Confirmed-Quantity-elementin
11 (27) 9.17 DefinitionDetails 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. Yksikköhinta voidaan antaa verottomana tai verollisena laskutuskäytännön ja verottajan ALVohjeistuksen mukaan. Laskurivillä voidaan ilmoittaa tuotetta tai palvelua kuvaava lisäkuvaus. Otsikko ja otsikkoa vastaava koodi ko. tiedolle annetaan RowDefinitionHeaderTextissä. Koodit tulisi määritellä toimialakohtaisesti. Otsikkoa vastaava tieto ja sen koodi annetaan RowDefinitionText-elementissä. Lisäksi ko. tiedolle voidaan antaa arvo RowDefinitionValue-elementissä. 9.18 Alennukset laskuriveillä 9.19 SubInvoiceRow Alennuksia voidaan antaa rivitasolla tai ketjutettuna alennuksena. SubInvoiceRow-aggregaatti on tarkoitettu laskuriveistä muodostettujen yhteenvetorivien esittämiseen. Finvoice-sanomina välitettävistä laskuista ei muodosteta koontilaskuja. SubInvoice-Row:n avulla voidaan helpottaa laskun tarkastamiskäsittelyä laskun visualisoinnin yhteydessä. SubRowAmount-elementtiin tulee edeltävien RowAmount-elementtien yhteenlaskettu summa. Sanoman layoutissa (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ä. SubInvoiceRow on InvoiceRow:n ala-aggregaatti. InvoiceRow sisältää tällöin vain SubInvoice- Row:n. SubInvoiceRow:ta voidaan käyttää yksinkertaisimmillaan niin, että SubArticleName-elementtiin 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. Välisummarivejä voi olla useampi laskuriviä kohti. Laskussa ei voi olla pelkkiä SubInvoicerow:ta, koska esim. laskun loppusumma lasketaan Invoice- Row:n perusteella. 9.20 SubRowDeliveryDetails Elementeissä esitetään rivikohtaisesti toimitukseen liittyvät tiedot. RowQuotationIdentifier-elementissä voidaan antaa tarjouksen viite. 9.21 SpecificationDetails Toimialakohtaiset erittelytiedot voidaan antaa tämän aggregaatin sisällä esim. sähkölaskun tai puhelinlaskun erittelytiedot jne.
12 (27) Erittelytiedoissa tulee käyttää Courier tai muuta kiinteäleveyksistä fonttia. kullakin rivillä tulisi olla vain 80 merkkiä. Automaattirivityksessä ei saa käyttää enteriä. Erittelyt voidaan esittää muotoiltuna SpecificationFreeText-elementissä, jolloin Finanssialan Keskusliiton vakio xsl:llä tiedot voidaan esittää maksajalle. 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> 9.22 epidetails 9.23 LayOutIdentifier 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 palveluntarjoajien kautta. EpiInstructedAmount-elementtiin tulee Lähettäjän maksettavaksi määrittelemä määrä. EpiRemittanceInfoIdentifier elementtiin tulee Suomessa aina pankkistandardin mukainen viitenumero ilman välilyöntejä etunollatäytöllä. Attribuutti SPY kuvaa Finanssialan Keskusliiton viitenumerostandardia. EpiAccountID-elementtiin tulee maksun saajan tilinumero IBAN-muodossa. Tilinumero annetaan konekielisessä muodossa kunkin maan antamien ohjeiden mukaan, esim. Suomessa IBAN on 18 merkkiä. IBAN-tilinumeron lisäksi tulee antaa pankin BIC-koodi EpiBfiIdentifier-kentässä. Epi on kuvattu ECBS:n standardissa numero EBS 602. Osa standardissa pakollisiksi merkityistä elementeistä ei ole käytössä sovellettaessa Suomessa. EpiPaymentInstructionId elementissä on oltava sama tieto kuin SenderInfosanoman PaymentInstructionIdentifier -elementissä. Tieto on pakollinen kuluttajan e-laskussa, koska sillä mahdollistetaan automaattinen maksatus verkkopankissa. EpiNameAddressDetails kenttä on pakollinen, koska saajan nimi on maksun muodostamisen kannalta välttämätön. Elementissä voidaan ilmoittaa erillinen lähettäjän ja vastaanottavan Palveluntarjoajan välillä sovittu xsl-tyylitidoston nimi, jonka avulla Palveluntarjoaja voi luoda Lähettäjän haluaman näköisen laskun kuvan verkkopankissa. Jos kenttä ei ole käytössä käytetään Finanssialan Keskusliiton määrittelemää laskun kuvaa (Finvoice.xsl). 9.24 InvoiceSegmentIdentifier Elementissä voidaan antaa vastaanottaja markkinointisegmenttitieto, jonka avulla laskun linkkeihin voidaan liittää haluttu juuri tälle vastaanottajalle tarkoitettu mainoslinkki.
13 (27) 9.25 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ää rivitason tietoihin. VatSpecificationDetails voi toistua verokannoittain ja valuutoittain. Verottajan ohjeen mukaisesti, on Suomessa kotimaanlaskuissa verot esitettävä ainakin euroissa. EpiInstructedAmount Lähettäjän maksettavaksi määrittelemä määrä. 10 Linkkien käyttö Finvoice-verkkolaskussa Sanomassa voidaan antaa linkki esim. laskuoperaattorin tarjoamiin visualisointipalveluihin, myyjän tarjouksiin, laskun liitteisiin. Urlia vastaava teksti kirjoitetaan InvoiceUrlText-elementtiin. Kun lasku on saapunut verkkopankkiin tai maksamisen verkkopalveluun ja maksaja klikkaa laskussa olevaa linkkiä, maksaja ohjautuu ns. välisivulle jossa kerrotaan maksajan siirtymisestä Palveluntarjoajan ulkopuoliseen palveluun ja pyydetään vahvistamaan siirtyminen. Linkin takana oleva sivu avautuu erilliseen ikkunaan ja tästä ikkunasta ei ole pääsyä takaisin Palveluntarjoaja palveluun. 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ä Palveluntarjoajan hyväksymää salausta ja niiden kautta näytettävien asiakaskohtaisten tietojen on oltava asianmukaisesti suojattuja. Palveluntarjoajalla on oikeus estää linkkien käyttäminen, jos ne vaarantavat asiointiturvallisuutta. 10.1 Lähettäjän muodostama linkki Finvoice-verkkolaskulla 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.
14 (27) 10.2 Palveluntarjoajan muodostama linkki Linkin takana esitettävien tietojen tietosuojan parantamiseksi tai personoidun tiedon näyttämiseksi palveluntarjoaja voi muodostaa linkin kuluttajalle verkkopankista tai maksamisen verkkopalvelusta 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 internet-sivuilta. Lähettäjän ja/tai esilläpitoarkistoa ylläpitävän yrityksen on sovittava palvelun käytöstä palveluntarjoajan kanssa ennen palvelun käytön aloitusta. Lähettäjä kirjoittaa InvoiceUrlText-elementtiin ensin palveluntarjoajan 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 ja ne erotetaan toisistaan +-merkillä. Elementin maksimipituus on 69 merkkiä. Käytettävät tunnisteet on oltava samat kaikilla palveluntarjoajilla. 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. Palveluntarjoaja 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ä palveluntarjoajakohtaista sopimusta. Palveluntarjoaja tarkistaa linkin muodostamisen yhteydessä lähettäjän ja/tai esilläpitoarkistoa ylläpitävän yrityksen linkkisopimuksen olemassa olon. 11 SOAP-kehyksen kuvaus Kehys pohjautuu ebxml-hankkeen suositukseen, jossa sanoma välitetään SOAP-envelope-rakennetta 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ä. Sanoman lähettämiseen ja vastaanottamiseen voidaan käyttää samaa turvatekniikkaa ja välityskanavaa kuin muussakin sanomavälityksessä kyseisen osapuolen kanssa. Huom! Yhteen kehykseen liittyy aina vain yksi sanoma esim. lasku. Palveluntarjoajalle lähetettävä tiedosto voi sisältää useita Finvoice-sanomia. Jokaisessa sanomassa on oltava siirtokehys (SOAP), jossa kerrotaan lähettäjän ja vastaanottajan tiedot sekä palveluntarjoajien tiedot. Palveluntarjoaja reitittää sanoman vastaanottajalle kehyksen tietojen perusteella. Kehysrakenne mahdollistaa sähköisen allekirjoituksen käyttämisen tarvittaessa, jos se tulevaisuudessa otetaan käyttöön. 11.1 SOAP-kehyksen rakenne Sanoman rakenne sisältää Mime-multipart-rakenteen, jossa SOAPille, ebxml-headerille ja Finvoicelle on oma osansa. Palveluntarjoajien kautta laskuja välitettäessä ei Mime-multipartrakennetta käytetä. Varsinainen lasku tulee kehyksen ulkopuolella. 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 yhteenso-
15 (27) piva SOAP 1.1.:n kanssa. SOAP 1.2:ssa on nimiavaruuden oltava: http://www.w3.org/2001/12/soapenvelope 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. 11.2 Esimerkki kehyksestä 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="1009"> <eb:from> <eb:partyid>fi5631990010001159</eb:partyid> <eb:role>sender</eb:role> </eb:from> <eb:from> <eb:partyid>handfihh</eb:partyid> <eb:role>intermediator</eb:role> </eb:from> <eb:to> <eb:partyid>00371234567800001</eb:partyid> <eb:role>receiver</eb:role> </eb:to> <eb:to> <eb:partyid>dabafihh</eb:partyid> <eb:role>intermediator</eb:role> </eb:to> <eb:cpaid>yoursandmycpa</eb:cpaid>
16 (27) <eb:messagedata> <eb:messageid>1009</eb:messageid> <eb:timestamp>2008-11-19t14:03:24</eb:timestamp> </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="1009"> <eb:schema eb:location="http://www.finvoice.info/yrityksen_verkkolasku/ladattavat/tekniset tiedostot/schemat/finvoice.xsd" </eb:reference> </eb:manifest> </SOAP-ENV:Body> </SOAP-ENV:Envelope> 11.2.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.oasis-open.org/committees/ebxmlmsg/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="1009"> Kehyksessä käytetään SOAP-standardin envelopea ja ebxml:n headeria kuljetusmäärityksissä osoitetulla tavalla (Transport, Routing and Packaging Specification 2.0 osoitteessa www.oasisopen.org). eb:id="nnnn"-kenttä ei ole pakollinen. Kenttää käytetään allekirjoitetun laskun yhteydessä. <eb:from> <eb:partyid>fi5631990010001159</eb:partyid> <eb:role>sender</eb:role> </eb:from> <eb:from> <eb:partyid>handfihh</eb:partyid> <eb:role>intermediator</eb:role> </eb:from> <eb:to> <eb:partyid>00371234567800001</eb:partyid> <eb:role>receiver</eb:role> </eb:to> <eb:to> <eb:partyid>dabafihh</eb:partyid> <eb:role>intermediator</eb:role> </eb:to> From- ja To-tagien yhteyteen liittyy aina eb:role-tagi, jolla ilmaistaan lähettäjän/vastaanottajan rooli. Käytännössä laskun vastaanottaja ilmoittaa Lähettäjälle oman tunnuksensa roolissa receiver ja mahdollisen Intermediaattorin eli palveluntarjoajan tunnuksen roolissa intermediator. Jos lasku lähe-
17 (27) tetään suoraan vastaanottajalle, ei vastaanottajan palveluntarjoajaa välttämättä tarvita tai se voidaan jättää huomiotta. Intermediaattorit käyttävät alla mainitussa taulukossa kerrottuja tunnisteita. eb:role:na on Intermediator. From- ja To-osapuolet voivat käyttää joko Intermediaattorin kanssa sovittuja tunnisteita tai keskenään sovittuja tunnisteita. Tunniste voi olla esim. OVT, IBAN tai Laskuoperaattorin eli Intermediatorin antama oma tunnus. Mikäli asiakas käyttää laskuoperaattoria, asiakas sopii oman operaattorin kanssa käytettävästä osoitteesta. Osapuolten tiedot pitää antaa seuraavassa järjestyksessä: - Sender - Intermediator (sender) - Receiver - Intermediator (receiver) Eri toimijoiden tunnukset vaikuttavat SOAP reititykseen. SOAP kulkee aina askeleen kerrallaan määränpäähän. eb:from ja eb:to ilmoittavat alkuperäisen lähettäjän ja vastaanottajan, mutta kummallakin voi olla myös intermediatorin roolissa toimiva avustaja, jolle sanoma ensin lähetetään ja joka toimittaa sen edelleen lopulliselle vastaanottajalle, vrt seuraavaa kuvaa. Finvoice-välityspalvelussa mukana olevien palveluntarjoajien käyttämät intermediatortunnukset Finvoice-välityspalvelussa: Intermediatorit OKOYFIHH NDEAFIHH DABAFIHH HELSFIHH HANDFIHH TAPIFI22 AABAFI22 Nimi Osuuspankit ja Pohjola Pankki Nordea Pankki Sampo Pankki Aktia, säästöpankit,paikallisosuuspankit ja Itella IPS Handelsbanken Tapiola Pankki Ålandsbanken Lähettäjän ja vastaanottajan tiedot: From ovt ly IBAN nn. To ovt ly IBAN nn. Selitys Suomalainen OVT-tunnus maatunnus+y-tunnus+ tarkenne 0037+01234567+00000 esim. 00370123456700000 Yritystunnus (Y-tunnus) Tilinumero kansainvälisessä muodossa (IBAN) Palveluntarjoajan (Intermediator) ja asiakkaan välillä sovittu tunnus Selitys Suomalainen OVT-tunnus maatunnus+y-tunnus+ tarkenne 0037+01234567+00000 esim. 00370123456700000 Yritystunnus (Y-tunnus) Tilinumero kansainvälisessä muodossa (IBAN) Palveluntarjoajan (Intermediator) ja asiakkaan välillä sovittu tunnus