TYÖMAA-AVAIMEN VÄLITTÄMINEN FINVOICE-VERKKOLASKULLA 12.12.2013
1 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla Sisällysluettelo 1 Yleistä... 2 2 Soveltamisohjeen käyttötarkoitus... 2 3 Toimialakohtaisen soveltamisohjeen sisällön ylläpito... 2 4 Toimialakohtaiset määritykset... 2 5 Yleiskuva toiminnasta... 3 6 Tietoelementtien käyttö... 3 6.1 Myyjän tiedot... 3 6.2 Ostajan tiedot... 3 6.3 Työmaa-avaimen tiedot... 4 6.4 Finvoice-verkkolaskulla annettavat muut tiedot... 4 6.5 Laskun loppusumma ja ALV-erittely... 4 7 Sanoman soveltaminen sähköisessä laskutuksessa... 5 8 Työmaa-avaimen rakenne... 5 8.1 Työmaa-avaimen tarkistusnumeron laskeminen... 6 9 Suorasiirtotiedostot... 6 10 Suorasiirtotiedoston rakenne... 7 10.1 Suorasiirtotiedoston lähettäminen... 8 10.2 Onnistuneen suorasiirron vastaus... 9 10.3 Epäonnistuneen suorasiirron vastaus... 9 10.4 Suorasiirtojen http-statukset... 9 11 Mallilasku... 10 12 Paperilaskut... 10 12.1 Paperilaskujen raportoiminen... 10 12.2 Ulkomaalaisten laskujen raportoiminen... 10 12.3 Ilman Työmaa-avainta lähetettyjen sähköisten laskujen raportoiminen... 10 12.4 Urakkasummien ilmoittaminen... 10 12.5 Työmaa-avaimella varustetut laskut ja siirtotiedosto... 10 13 Laskuun liittyvät liitteet... 10 14 Yhteenveto käytettävistä koodeista... 10 15 Aikataulu... 10
2 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla 1 Yleistä Tässä dokumentissa kuvataan, miten verolain vaatimat tiedot annetaan Finvoiceverkkolaskuformaatissa rakennusalalla. Tätä toimialakohtaista soveltamisohjetta voidaan käyttää välitettäessä urakkaan sisältyviä verkkolaskuja ostajalle sekä kopiona Veronumero.fi:n Työmaarekisteri -palveluun edelleen raportoitavaksi verottajalle. Dokumentissa viitataan Verohallinnon urakkatietueeseen termillä VSURAKKA. Määritelmä on laadittu 23.9.2013 päivätyn version 1.0E kenttien mukaan. Verohallinnon tietuekuvaukset löytyvät osoitteesta: https://www.vero.fi/fi-fi/yritys_ja_yhteisoasiakkaat/osakeyhtio_ja_osuuskunta/urakka_ja_tyontekijatiedot 2 Soveltamisohjeen käyttötarkoitus Rakennusalan täydentävä soveltamisohje on toteutettu Finanssialan keskusliiton (FK) Finvoice-standardiin 1.3 versiosta alkaen tarvittavia toimialakohtaisia erityismäärityksiä hyödyntämällä. Soveltamisohje on tehty helpottamaan rakennusalan toimijoiden välistä tiedonvälitystä, tiedonvälityksen standardointia ja raportointia viranomaisille. Soveltamisohjeen suosituksia voidaan toteuttaa Finvoice version 1.3:n tai uudemmalla versiolla. Finanssialan Keskusliiton ylläpitämä yleinen Finvoice-standardin kuvaus löytyy www.finvoice.info sivuilta, ja se on vapaasti käytettävissä. 3 Toimialakohtaisen soveltamisohjeen sisällön ylläpito Tämän soveltamisohjeen jatkokehitystoiveet voi toimittaa Suomen Tilaajavastuu Oy:lle osoitteeseen: partnerit@veronumero.fi 4 Toimialakohtaiset määritykset Toimialakohtaisessa soveltamisohjeessa määritellään käytettävät koodit, pakolliset kentät ja muut laskun tarkastusta varten välitettävät tiedot. Muutoshallinnointia koordinoi Suomen Tilaajavastuu Oy. Tiedot, joita ei ole tässä toimialakohtaisessa soveltamisohjeessa erikseen nimetty ja määritetty, käyttävät yleistä Finvoice 1.3 tai uudemman version soveltamisohjetta. Valuutat, päivämäärät ja desimaalit merkitään aina Finanssialan Keskusliiton ylläpitämän Finvoice 1.3 tai uudemman soveltamisohjeen mukaisesti. Kaikissa alv:n ja muiden lakisääteisten tietojen osalta noudatetaan Finanssialan Keskusliiton ylläpitämää Finvoice 1.3 tai uudemman version soveltamisohjetta.
3 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla 5 Yleiskuva toiminnasta OSTAJA/ tilaaja MYYJÄ 3. verkkolasku ostajalle 1. Verkkolasku ostajalle 2. Verkkolaskukopio Tilaajavastuulle Verkkolaskuvälittäjä 4. verkkolaskukopio Tilaajavastuu 1. Myyjä laatii Finvoice-verkkolaskun ostajalle (välityskehyksessä ostajan verkkolaskuosoite) 2. Myyjä tai myyjän palveluntarjoaja muodostaa laskusta laskukopio, jonka välityskehyksessä on tilaajavastuun verkkolaskuosoite 3. Myyjän verkkolaskuvälittäjä välittää verkkolaskun ostajalle sekä 4. Tilaajavastuulle, joka muodostaa laskun tietojen perustella raportin verottajalle 6 Tietoelementtien käyttö 6.1 Myyjän tiedot Tieto Selite Arvo esimerkkilaskussa SellerOrganisationName Yrityksen nimi Pullin Urakka ky SellerPostalAddressDetails tai Yrityksen osoite Puukatu 2 F SellerOfficialPostalAddressDetailsrakenteessa SellerPartyIdentifier Y-tunnus 0199920-7 SellerOrganisationTaxCode ALV-tunnus FI01999207 SellerAccountDetails myyjän tilitiedot FI2721221222 212227 6.2 Ostajan tiedot Tieto Selite Arvo esimerkkilaskussa BuyerOrganisationName Yrityksen nimi Sensorit Oy
4 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla BuyerPostalAddressDetails - Yrityksen osoite Sempalokatu 2 rakenteessa BuyerPartyIdentifier Y-tunnus 0123456-7 BuyerOrganisationTaxCode ALV-tunnus FI01234567 6.3 Työmaa-avaimen tiedot Työmaa-avain lisätään oletusarvoisesti DeliverySiteCode kenttään. Mikäli kenttää ei tueta, niin Työmaa-avain voidaan lisätä vaihtoehtoisesti myös BuyerReferenceIdentifier kenttään. Vain paperila toimitettavissa laskuissa oletuksena käytetään BuyerReferenceIdentifier kenttää. Työmaa-avaimen tekninen rakenne on tarkastettava ja tunnistettava aina ohjelmallisesti, koska kenttiä voidaan käyttää joissain tilanteissa myös muiden tietojen välittämiseen. Tieto Selite Arvo esimerkkilaskussa DeliverySiteCode Työmaa-avain TA-FI- STVOY0001- B BuyerReferenceIdentifier Työmaa-avain voidaan antaa tässä elementissä, jos DeliverySiteCodeelementtiä ei ole käytössä TA-FI- STVOY0001- B 6.4 Finvoice-verkkolaskulla annettavat muut tiedot Tieto Selite Arvo esimerkkilaskussa InvoiceTypeCode lasku INV01-koodilla ja INV01 hyvityslasku INV02- koodilla OriginCode Ostajalle menevässä laskussa Original ja kopiolaskussa Copy Original 6.5 Laskun loppusumma ja ALV-erittely Suositeltavaa on tehdä lasku, joka on kokonaisuudessaan käännetyn alv:n mukainen. Jos ostaja on verovelvollinen käänteisen arvonlisäveron perusteella, annetaan ostajan verotunnus BuyerOrganisationTaxCode -elementissä. VatSpecificationDetails annetaan tarvittaessa niin monta kertaa kuin on verokantoja. Käänteiseen veroon käytetään VatCode -kentässä verokoodia AE verotekstinä VatFreeText-kentässä AVL 8c.
5 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla Invoice Details tiedoissa annetaan seuraavia tietoja, jos laskussa on vain käänteisen ALV mukaista laskutettavaa: InvoiceTotalVatExcludedAmount -kentässä ALV veroton laskun loppusumma InvoiceTotalVatAmount on 0,00 VatRatePercent on 0 InvoiceTotalVatIncludedAmount on sama kuin ALV veroton laskun loppusumma VALUUTAT: laskun loppusumma laskun valuutassa 7 Sanoman soveltaminen sähköisessä laskutuksessa Laskuttajan vastuulla on lähettää jokainen laskusanoma kahdesti: kerran käyttäen OriginCode:n arvoa Original ja kerran Copy (ks. 6.4) Lasku, jossa laskun OriginCode= Original ja laskun SOAPissa (ToIdentifier) laskun vastaanottaja on laskuttajan asiakas ja lasku, jossa laskun OriginCode= Copy ja laskun SOAPissa (ToIdentifier) laskun vastaanottaja on Tilaajavastuu. Laskuttaja lähettää laskut valitsemallaan tavalla: muodostamalla manuaalisesti Finvoice-sanoma muodostamalla laskusanoma palveluntarjoajan web-käyttöliittymällä muodostamalla laskusanoma laskutusjärjestelmää tai muuta tietoteknistä sovellusta käyttäen muodostamalla laskusanoma yhteistyössä palveluntarjoajan kanssa Laskuttajan käyttämä palveluntarjoaja voi tarjota palvelua, jossa molemmat laskut lähetään samalla kertaa. Laskuttajan vastuulla on varmistaa, että molemmat versiot laskusta tulevat lähetetyksi. 8 Työmaa-avaimen rakenne Työmaa-avain koostuu neljästä lohkosta, joista viimeinen sisältää tarkastusmerkin. Lohkot eritellään toisistaa - -merkillä. Työmaa-avaimen lohkoissa käytetään vain seuraavia merkkejä : '0' -'9', 'A' - 'Z'. Työmaa-avaimessa on korkeintaan 35 merkkiä. Merkkijonon pituuteen lasketaan mukaan myös erottimena käytetyt - -merkit.
6 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla 8.1 Työmaa-avaimen tarkistusnumeron laskeminen Työmaa-avaimen tarkastusnumero lasketaan ilman erotinmerkkejä käyttän ISO 7064 Mod 37,36 tarkistusta. tarkistusmerkkinä on '0' -'9', 'A' - 'Z'. Tarkistusmerkkiä laskettaessa lohkojen erotinmerkit ja varsinainen tarkistusmerkki poistetaan merkkijonosta. Esimerkki: TA-FI-STVOY0001-B Tarkistusnumeroa varten merkkijono muutetaan muotoon: TAFISTVOY0001 Tarkastusmerkki ISO 7064 Mod 37,36 kaavan tuloksena: B 9 Suorasiirtotiedostot Suorasiirtotiedosto on tarkoitettu ensisijaisesti paperilaskujen ja ulkomaalaisten laskujen raportointiin. Suorasiirtotiedostolla siirretään siten kaikki automaattisen raportoinnin ulkopuolelle jäävät laskut. Poiketen automaattisesta verkkolaskuvälityksestä, suorasiirtotiedosto lähetetään suoraan ostajan järjestelmästä käsin Työmaapankkiin. Suorasiirtotiedoston käyttötarkoitukset: Puutteellisteen e-laskujen siirto Paperilaskujen siirto Puutteellisten ulkomaalaisten laskujen sirto Veronumerolain velvoittama urakkahintailmoitus
7 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla 10 Suorasiirtotiedoston rakenne Suorasiirtotiedosto on tekstitiedosto, jossa kentät erotellaan ; merkillä. Lisäksi tiedoston ensimmäinen rivis sisältää sarakkeiden nimet. Tiedoston merkistö on aina ISO 8859-1 (Latin 1) enokoodauksella. Rivit erotellaan ISO 8859-1 merkistön mukaisella newline -merkillä.
8 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla Suorasiirtotiedoston sarakkeet Kenttä Selite Verohallinnon raporttiin siirtyvä tieto ja kenttätunnus TY 0 e-lasku 1 paperilasku tai vastaava 2 ulkomaalainen lasku 3 urakkahintailmoitus 4 urakan maksusuoritus (ei laskua) 5 ennakkomaksu (ei laskua) TA Työmaa-avain kokonaisuudessaan erotinmerkeillä - VSURAKKA, kenttä 250 ja tarkistusmerkillä varustettuna OMT Ostajan maatunnus, ISO 3166-1 ALFA2. VSURAKKA, kenttä 152 OT Ostajan y-tunnus tai ulkomaalaisen yrityksen vastaava VSURAKKA, kenttä 010 tunniste. MMT Myyjän maatunnus, ISO 3166-1 ALFA2. VSURAKKA, kenttä 304 MT Myyjän y-tunnus tai ulkomaalaisen yrityksen vastaava tunniste. VSURAKKA, kenttä 301 tai 302 SUM Laskun tai sopimuksen loppusumma VSURAKKA, kenttä 403 tai 406 ALV Laskun tai sopimuksen ALV SALV Laskun tai sopimuksen summa lisättynä ALV. PVM Laskun päivämäärä tai ilmoitettaessa sopimusta sopimuksen päivämäärä. Päivämäärä ilmoitetaan ISO 8601 standardin mukaan muodossa VVVV-KK-PP NO Myyjän laskun numero tai sopimuksen numero, mikäli tiedossa VNO Laskun viitenumero tai sopimuksen toissijainen tunniste. TAL Toimeksiannon laji (voidaan ilmoittaa sekä urakkahinnan tai ostolaskun yhteydessä) 1 = Urakointi 2 = Työvoiman vuokraus 3 = Jatkuvaluonteinen kunnossapitotyö VSURAKKA, kenttä 400 Esimerkki otsikkorivistä: TY;TA;OMT;OT;MMT;MT;SUM;ALV;SALV;PVM;NO;VNO;TAL Esimerkki suorasiirtotiedoston tietorivistä: 1;TA-FI-STVOY0001-B;FI;2327327-1;FI;2068335-5;100;24;124;2012-02- 22;12;10221;1 10.1 Suorasiirtotiedoston lähettäminen Suorasiirtotiedosto lähetetään ja siirron vastaus saadaan HTTPS -protokollalla Erämies rajapinnan kautta. Siirrettävä aineisto lähetetään otsaketiedoissa POST-kentässä text/csv tyyppisenä ja käyttäjän tunnistus tapahtuu basic authentication menetelmällä.
9 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla Vastaanottavan palvelimen tarkemmat yhteysosoitteet ja yhteyteen tarvittavat tunnukset saa Suomen Tilaajavastuu Oy:tä (Partneriohjelma, partnerit.veronumero.fi). Esimerkki HTTPS otsaketiedostosta Http protocol: HTTPS Http request method: POST Authentication: Basic auth Content-Type: text/csv curl esimerkki suorasiirtotiedoston lähettämisestä curl -Lv https://yhteysosoite.domain.fi/csv --user susi:susi -H "Content-Type: text/csv" -X POST --data-binary @SS.csv 10.2 Onnistuneen suorasiirron vastaus Suorasiirron vastauksena tulee ; merkillä eroteltuna kolme kenttää. Esimerkki onnistuneen suorasiirron vastauksesta: OK;3;8; Kenttien selitykset: 1. kenttä: "OK" 2. kenttä: Käsiteltyjen rivien lukumäärä (poislukien otsikkorivi) 3. kenttä: Batchin tunniste 10.3 Epäonnistuneen suorasiirron vastaus Mikäli siirto epäonnistui (mistä tahansa syystä) niin mitään viestin riveistä ei käsitellä. Paluuviestissä on (ensimmäisen) virheellisen rivin numero. Virheen sattuessa kyseisen rivin voi korjata ja lähettää suorasiirtoaineiston uudestaan. Esimerkki virheellisen suorasiirron vastauksesta: ERROR;0;3;invalid invoicereference (VNO) Kenttien selitykset: 1. kenttä: "ERROR" 2. kenttä: Käsiteltyjen rivien lukumäärä, aina 0 jos kyseessä oli virhe 3. kenttä: Ensimmäisen virheellisen rivin numero 4. kenttä: Vapaamuotoinen selite virheen syystä 10.4 Suorasiirtojen http-statukset Virhetietojen lisäksi suorasiirron pyynnön vastauksena palautetaan seuraava HTTP_- status. 200 OK 400 Bad request (kuten viallinen rivi) 503 Palvelimen sisäinen virhe
10 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla 11 Mallilasku 12 Paperilaskut Veronumero.fi sivuilta löytyy mallilasku. Paperilaskujen raportointia varten Työmaa-avain lisätään BuyerReferenceIdentifier kenttään, joka tulostuu vakiomuotoisissa laskuissa ostajan viite kenttään. Kyseinen kenttä tunnistetaan pääsääntöisesti kaikissa skannauspalveluissa ja voidaan siten lukea suoraan sähköisiin järkestelmiin. 12.1 Paperilaskujen raportoiminen Paperilaskut raportoidaan suoraan Työmaapankkiin käyttäen siirtotiedostoa. Siirtotiedoston tarkempi kuvaus löytyy kappaleessa Siirtotiedoston rakenne. 12.2 Ulkomaalaisten laskujen raportoiminen Ulkomaalaiset laskut, joissa ei ole Työmaa-avainta raportoidaan suoraan Työmaapankkiin käyttäen paperilaskujen mukaista siirtotiedostoa. Siirtotiedoston tarkempi kuvaus löytyy kappaleessa Siirtotiedoston rakenne. 12.3 Ilman Työmaa-avainta lähetettyjen sähköisten laskujen raportoiminen Kaikki sähköiset laskut, joissa ei ole Työmaa-avainta raportoidaan ostajan toimesta suoraan Työmaapankkiin käyttäen paperilaskujen mukaista siirtotiedostoa. Siirtotiedoston tarkempi kuvaus löytyy kappaleessa Siirtotiedoston rakenne. 12.4 Urakkasummien ilmoittaminen Työmaakohtaisten sopimusten urakkasummien ilmoittaminen tapahtuu suoraan Työmaapankkiin. Siirto tapahtuu käyttämällä paperilaskujen mukaista siirtotiedostoa. Siirtotiedoston tarkempi kuvaus löytyy kappaleessa Siirtotiedoston rakenne. 12.5 Työmaa-avaimella varustetut laskut ja siirtotiedosto Työmaapankkiin siirrettävällä siirtotiedostolla voidaan lähettää myös mukana myös laskuja, joista löytyy Työmaa-avain ja jotka ovat automaattisen raportoinnin piirissä. Näiden laskujen tietoja ei kuitenkaan käsitellä, mikäli vastaava lasku on jo Työmaapankissa. 13 Laskuun liittyvät liitteet Laskuun liittyvät muut liitteet tulee toimittaa osapuolten sopimalla tavalla. 14 Yhteenveto käytettävistä koodeista 15 Aikataulu
11 Työmaa-avaimen välittäminen Finvoice-verkkolaskulla