EU-arvonlisäveromoottori

EU- ja ETA-alueen välinen arvonlisäverotus: verotusmaan määritys, käännetty verovelvollisuus, markkinapaikkojen oletettu myyjä -käsittely (deemed-supplier), maakohtainen verokantaviite sekä OSS- ja IOSS-ilmoitukset. Kaikki alla oleva toimii rajapintalähtöisesti (API-first), ja kunkin päätepisteen vaatimat käyttöoikeudet (scopes) on esitetty erikseen.

Verokantaviite

POST /v1/reference/eu-vat-rates/list (reference:read) - lakisääteiset arvonlisäverokannat kaikille EU27-maille, suodatettavissa kentillä countryCode ja date. Verokantojen voimassaoloaikoja seurataan 1.1.2024 alkaen (EE 24 % alkaen 2025-07, RO 21 % / 11 % alkaen 2025-08, SK 23 % / 19 % alkaen 2025-01, FI 13,5 % ja LT 12 % alkaen 2026-01, CZ 12 % alkaen 2024-01).

Lähde: Euroopan komission Taxes in Europe -tietokanta (TEDB, https://ec.europa.eu/taxation_customs/tedb/), haettu 16.7.2026; Liettuan vuoden 2026 muutokset varmistettu VMI:ltä (https://www.vmi.lt/evmi/pvm-tarifai) ja Suomen vuoden 2026 muutos vero.fi:stä. Laajuus: vain manner- ja perustason alueen verokannat - alueellisia poikkeuksia (Itävallan Jungholz, Kreikan saaret, Azorit/Madeira, Ranskan merentakaiset alueet ja Korsika) ei mallinneta.

POST /v1/reference/vat-classifiers/list palauttaa nyt luokittain kentän countryCode (nykyiset i.SAF-koodit PVM* ovat maalle LT); POST /v1/reference/vat-classifiers/upsert (reference:write) lataa luokitusjoukot muille maille, mikä toimii tulevien maapakettien tietopolkuna.

Verokohtelun määritys

POST /v1/reference/vat/resolve (reference:read) vastaa kysymykseen "mitä arvonlisäveroa myynnistä veloitetaan?". Syötteet: partnerId tai customerCountryCode (+ valinnainen customerIsBusiness-ohitus, joka muuten päätellään kumppanin alv-tunnuksesta), supplyType (goods | services | digital), date sekä tilanneliput: belowDistanceSalesThreshold, facilitatedByMarketplace (myyt oletetun myyjän alustan kautta), actingAsMarketplace (toimit itse alustana), sellerEstablishedInEu, importedConsignmentValueEur.

Neuvoston direktiivissä (EU) 2025/516 (alv digitaaliaikana, ViDA) säädetyt sääntöjen syötteet:

• serviceKind (short_term_accommodation | passenger_road_transport) yhdessä kentän serviceCountryCode kanssa (maa, jossa kiinteistö sijaitsee tai jossa kuljetus tapahtuu). Molemmat edellyttävät arvoa supplyType: "services".
• underlyingSupplierGaveVatNumber ja underlyingSupplierChargesVat: ilmoittiko majoituksen tarjoaja tai kuljettaja alustalle kyseisen myyntimaan arvonlisäveronumeron ja vahvistiko veloittavansa alv:n. Vain näiden yhteisvaikutus estää alustaa olemasta oletettu myyjä (art. 28a(1)).
• goodsKind (installed | energy_network) tavaroille, jotka asennetaan tai kootaan asiakkaan luona (art. 36), sekä kaasulle, sähkölle, lämmölle tai jäähdytykselle verkkon kautta (art. 38, 39).
• goodsLocationCountryCode, eli maa, jossa tavarat sijaitsevat myyntihetkellä tai jossa niiden kuljetus alkaa, mikäli tämä ei ole yrityksen kotimaa.

Tulosteet: scheme, vatCountryCode, reverseCharge, deemedSupplier, zeroRated, kohdemaan verokantavalikko, oikeusperusta (direktiivin 2006/112/EY artikla) sekä huomautukset (esimerkiksi muistutus siitä, että artiklan 138 mukainen vapautus edellyttää VIES-tarkistettua asiakkaan alv-tunnusta).

Toteutetut säännöt:

Tilanne	Tulos
Myynti samaan maahan	domestic, kotimaan verokannat
EU-sisäinen B2B-tavarakauppa	intra_eu_b2b - veroton myynti art. 138, asiakas tilittää alv:n itse
EU-sisäinen B2B-palvelumyynti	reverse_charge - art. 44/196
EU-sisäinen B2C-tavara/digipalvelu yli 10 000 €	oss_union - kohdemaan verokannat, art. 33(a)/58
EU-sisäinen B2C alle 10 000 € (belowDistanceSalesThreshold)	domestic lähtömaassa, art. 59c
EU-sisäinen B2C, yleiset palvelut	domestic, art. 45
Tavarat EU:n ulkopuolelle	export - veroton myynti art. 146(1)
Palvelut/digipalvelut EU:n ulkopuolelle	out_of_scope (art. 44/59)
Myynti oletetun myyjän markkinapaikan kautta (facilitatedByMarketplace)	marketplace_deemed - veroton myynti alustalle art. 136a
Maahantuotu lähetyksen arvo ≤ 150 € B2C	ioss - kohdemaan alv myyntihetkellä, art. 369l–369x; oletettu myyjä kun actingAsMarketplace (art. 14a(1))
Vapautettu pienyritys (yritys ei ole alv-velvollinen), kotimaan myynti	sme_exempt - ei alv:tä, art. 284(1)
Vapautettu pienyritys, rajatylittävä EU B2C, hallussaan rajatylittävä EX-tunnus	sme_exempt - art. 284(2); voimassa niin kauan kuin pysytään kohdemaan rajan ja 100 000 euron unionin laajuisen liikevaihdon alapuolella
Vapautettu pienyritys, rajatylittävä EU B2C, ei EX-tunnusta	säilyttää oss_union / lähtömaa -kohtelun huomautuksella, että rajatylittävä EX-tunnus tekisi myynnistä vapautetun
Alusta (actingAsMarketplace), joka välittää enintään 30 yön majoitusta tai tieliikenteen henkilökuljetusta alkaen 1. heinäkuuta 2028	deemedSupplier: true, verotetaan siellä, missä kiinteistö sijaitsee tai kuljetus tapahtuu (art. 28a, 47, 48): domestic, oss_union kuluttajalle toisessa maassa (art. 369b(c)) tai reverse_charge yritykselle
Majoituksen tarjoaja tai kuljettaja, joka myy tällaisen alustan kautta (facilitatedByMarketplace) alkaen 1. heinäkuuta 2028	marketplace_deemed - veroton myynti alustalle, art. 136b
Jompikumpi edellisistä ennen 1. heinäkuuta 2028 tai silloin, kun majoituksen tarjoaja tai kuljettaja on antanut alv-tunnuksensa ja veloittaa alv:n	verotusmaa art. 47 tai 48 mukaisesti, ei oletettua myyjää
Toisessa jäsenvaltiossa varastoidut tavarat myydään siellä olevalle kuluttajalle alkaen 1. heinäkuuta 2028	oss_union, art. 369b(e); ennen sitä kyseisen maan domestic huomautuksella siellä rekisteröitymisestä
Sama myynti yritykselle kyseisessä maassa	reverse_charge, art. 194
Toisesta jäsenvaltiosta lähetetyt tavarat	oss_union kuluttajalle (art. 33(a)) tai intra_eu_b2b yritykselle, huomautuksella että myynti kuuluu kyseisen maan arvonlisäverorekisteröinnin piiriin
Asennetut tavarat kuluttajalle toisessa jäsenvaltiossa	oss_union alkaen 1. heinäkuuta 2028 (art. 36, 369b(d)), sitä ennen kyseisen maan domestic
Kaasu, sähkö, lämpö tai jäähdytys kuluttajalle toisessa jäsenvaltiossa	oss_union alkaen 1. tammikuuta 2027 (art. 39, 369aa, sitten 369b(d)); reverse_charge yritykselle (art. 195)

10 000 euron raja-arvo (art. 59c) voidaan antaa eksplisiittisesti kentällä belowDistanceSalesThreshold. Jos kenttä jätetään pois, moottori seuraa raja-arvoa automaattisesti kirjanpitotiedoista (katso alla oleva raja-arvon päätepiste) ja lisää laskelmaan juoksevat summat.

Pienyritysten alv-vapautus (direktiivi 2020/285, alkaen 2025). Kun yritys ei ole rekisteröitynyt alv-velvollinen, ratkaisin kohtelee sitä pienyrityksenä, joka käyttää vapautusta: kotimaan myynti ratkeaa tilaan sme_exempt (ei alv:tä), ja rajatylittävät EU:n B2C-myynnit ratkeavat niin ikään tilaan sme_exempt, jos yrityksellä on rajatylittävä EX-tunnus (smeExemptionNumber yritysprofiilissa) - muussa tapauksessa se säilyttää normaalin OSS- tai lähtömaakohtelun huomautuksella, joka suosittelee rajatylittävää järjestelmää. Kelpoisuus (kohdemaan raja-arvon ja 100 000 euron unionin laajuisen liikevaihtokaton alittaminen) on ilmoittajan vastuulla; ratkaisin merkitsee asian huomautuksiin. Aseta EX-tunnus osoitteessa account/companies/update (smeExemptionNumber).

Laskut

sales/invoices/create|update hyväksyvät kentät vatScheme (jokin yllä mainituista järjestelmistä), vatCountryCode (kulutusjäsenvaltio; pakollinen ja validoidaan EU-maaksi arvoilla oss_union / ioss) sekä deemedSupplier. Verkkokauppatilaukset hyväksyvät kentät shipToCountryCode ja marketplace; orders/fulfill määrittää verokohtelun toimitusmaan perusteella automaattisesti ja leimaa luonnoslaskun (olettaa tavaroita ja ylitettyä etämyynnin raja-arvoa - muokkaa luonnosta ennen lähettämistä, jos näin ei ole).

Alv-järjestelmäkenttä uuden laskun sivulla

Uuden laskun sivun alv-järjestelmäkenttä tarjoaa alla luetellut vaihtoehdot. Kullekin riville syötetty alv-% on se vero, jonka lasku veloittaa. Valitsemalla vaihtoehdon, jonka kohdalla lukee "ei alv:tä", jokaisen rivin verokannaksi asetetaan 0 % (ja takaisin vaihto palauttaa oletusverokannan). PDF tulostaa valitulle järjestelmälle laissa vaaditun maininnan. "Automaattinen" kutsuu tallennettaessa yllä olevaa ratkaisinta käyttäen kumppanin maata ja alv-tunnusta sekä valitsemaasi myyntityyppiä (tavarat, palvelut tai digitaaliset palvelut); jos kumppanilla ei ole maata tai alv-tunnusta, tallennus epäonnistuu virheilmoituksella ja järjestelmä vaatii järjestelmän manuaalista valintaa.

Lomakkeen vaihtoehto	Järjestelmä	Käytä kun	Laskun alv
Automaattinen (kumppanin ja myyntityypin mukaan)	ratkaistaan tallennettaessa	Haluat järjestelmän valittavan kumppanin ja myyntityypin perusteella	Määräytyy ratkaistun järjestelmän mukaan; ilman alv:tä olevien järjestelmien rivit nollataan
Kotimaa	domestic	Ostaja on omassa maassasi	Kotimaasi verokannat
EU-sisäinen B2B-tavarakauppa (0 %, art. 138)	intra_eu_b2b	Tavarat toimitetaan alv-rekisteröidylle yritykselle toisessa EU-maassa; ostajan alv-tunnuksen on oltava VIES-validi	Ei alv:tä; PDF mainitsee artiklan 138 mukaisen vapautuksen
EU-sisäinen B2B-palvelumyynti (käännetty alv)	reverse_charge	Palvelut alv-rekisteröidylle yritykselle toisessa EU-maassa	Ei alv:tä; PDF tulostaa "Käännetty verovelvollisuus" (art. 196)
Unionin OSS (EU-kuluttajat, kohdemaan alv)	oss_union	Tavarapyrintö tai digitaaliset palvelut toisen EU-maan kuluttajille yli 10 000 euron EU:n laajuisen rajan; edellyttää kulutusmaata	Kohdemaan verokanta syötettynä kullekin riville; ilmoitetaan neljännesvuosittaisessa OSS-ilmoituksessa
IOSS (enintään 150 € tuonnit)	ioss	EU:n ulkopuolelta tuodut tavarat EU-kuluttajalle, lähetyksen arvo ≤ 150 €; edellyttää kulutusmaata	Kohdemaan verokanta syötettynä kullekin riville; ilmoitetaan kuukausittaisessa IOSS-ilmoituksessa
Markkinapaikka (oletettu myyjä)	marketplace_deemed	Myyt alustan kautta, joka toimii oletettuna myyjänä	Ei alv:tä myynnissäsi alustalle (art. 136a)
Vienti (veroton)	export	Tavarat toimitetaan EU:n ulkopuolelle	Ei alv:tä; PDF mainitsee artiklan 146 mukaisen vapautuksen
Ei kuulu soveltamisalaan (palvelut EU:n ulkopuolelle)	out_of_scope	Palvelut EU:n ulkopuoliselle asiakkaalle	Ei alv:tä; PDF mainitsee myynnin jäävän EU:n alv-soveltamisalan ulkopuolelle (art. 44/59)
Pienyritysvapautus (ei alv-velvollinen)	sme_exempt	Yrityksesi ei ole alv-velvollinen ja käyttää pienyritysten vapautusta	Ei alv:tä; PDF mainitsee artiklan 284 mukaisen vapautuksen

Nämä kaksi EU-sisäistä B2B-vaihtoehtoa eroavat toisistaan vain sen suhteen, mitä myydään. Tavarat kuuluvat artiklan 138 mukaisen vapautuksen piiriin: ostaja ilmoittaa yhteisööhankinnan. Palvelut kuuluvat artiklojen 44/196 mukaisen käännetyn verovelvollisuuden piiriin: ostaja tilittää arvonlisäveron itse. Molemmat tuottavat laskun ilman alv:tä, mutta PDF:lle tulostettava maininta ja ruutu, johon summa päätyy ostajan arvonlisäveroilmoituksella, ovat erilaiset, joten valinnalla on merkitystä.

OSS- ja IOSS-ilmoitukset

POST /v1/declarations/eu/oss/compute (declarations:read) { year, quarter } - unionin järjestelmän neljännesvuosittainen ilmoitus komission täytäntöönpanoasetuksen (EU) 2020/194 liitteen III mukaisesti: rivit kulutusjäsenvaltioittain × verokantatyyppi (STANDARD / REDUCED) × verokanta verotettavalla määrällä ja alv:llä, hyvityslaskut netotettuna, sekä loppusummat. Vain lasketut asiakirjat, joiden arvona on vatScheme: "oss_union", sisällytetään. Varoitukset ilmoittavat määrämuodon vastaisista kohdemaan ja ajanjakson verokannoista, ohitetuista verottomista riveistä, asiakirjoista ilman kenttää vatCountryCode sekä tunnistamisjäsenvaltiossa verotetuista myynneistä.

POST /v1/declarations/eu/ioss/compute { year, month } - vastaava rakenteeltaan kuukausittain arvolle vatScheme: "ioss" (maahantuodut lähetykset ≤ 150 €).

Molemmat vastaukset sisältävät taulukon corrections (sekä kentän correctionsTotal): nykyisellä jaksolla annettu hyvityslasku, joka on kohdistettu (kentän creditedInvoiceId kautta) alkuperäiseen laskuun aiemmalta OSS- tai IOSS-kaudelta, siirretään pois jakson riveiltä ja raportoidaan edellisen kauden oikaisuna (maa, alkuperäinen vuosi, alkuperäinen neljännesvuosi (OSS) tai kuukausi (IOSS) sekä negatiivinen alv-muutos) asetuksen 2020/194 liitteen III edellyttämällä tavalla. Hyvityslaskut, joilla ei ole kenttää creditedInvoiceId, netotetaan nykyiselle kaudelle ja merkitään varoituksella, jotta ne voidaan kohdistaa; yli kolme vuotta vanhat oikaisut merkitään huomautuksella (asetuksen 282/2011 art. 61).

Saatavilla kaikille EU:hun sijoittautuneille yrityksille (ei rajoitettu vain Liettuaan).

Omien tavaroiden siirtojen ilmoitus

POST /v1/declarations/eu/own-goods-transfers/compute (declarations:read) { year, month } - omien tavaroiden siirtojen erityisjärjestelmän kuukausi-ilmoitus (direktiivi 2006/112/EY, art. 369xa-369xk, alkaen 1. heinäkuuta 2028), joka annetaan yrityksen sijoittautumisjäsenvaltiossa seuraavan kuukauden loppuun mennessä (dueDate). Rivit ilmoittavat kulutusjäsenvaltioittain ja lähtöjäsenvaltioittain siirtojen arvon hankintahintaan (art. 76) euroina, muunnettuna kuukauden viimeisen päivän kurssilla (art. 369xh). Siirto on varastonsiirto (POST /v1/inventory/stock/transfer) kahden eri jäsenvaltion varastojen välillä; aseta varastomaa kentällä countryCode pyynnössä /v1/inventory/warehouses/create tai /v1/inventory/warehouses/update (varasto ilman määritystä sijaitsee yrityksen kotimaassa).

EU:n digitaalinen raportointi

POST /v1/declarations/eu/digital-reporting/list (declarations:read) { fromDate, toDate } listaa jokaisen tapahtuman, joka direktiivin 2006/112/EY art. 262 mukaan on raportoitava erikseen 1. heinäkuuta 2030 alkaen kaikissa 27 jäsenvaltiossa:

• annetut myyntilaskut ja hyvityslaskut, joiden vatScheme on intra_eu_b2b (art. 262(1)(a)) tai reverse_charge (art. 262(1)(c)), erääntyvät laskun antamispäivänä;
• kirjatut ostolaskut toimittajalta toisessa jäsenvaltiossa riveillä, joiden alv:n yritys tilittää itse (art. 262(1)(b) tavaroille, (d) palveluille), erääntyvät 5 päivän kuluttua laskun vastaanottamisesta.

Jokainen tapahtuma sisältää artiklan 264 mukaiset tiedot: laskun päivämäärä ja numero, toimittajan ja asiakkaan alv-tunnukset, rivit, verotettava määrä, vapautusviite, hyvityslaskun korjaaman laskun numero (art. 226(16)), toimittajan pankkitilit (art. 226(17)), hankintojen alv-kanta ja -määrä, raportointijäsenvaltio (se, joka on myöntänyt käytetyn alv-tunnuksen, art. 262(2)), määräaika sekä missing, joka nimeää kaikki puuttuvat tietoelementit. Jäsenvaltioiden on hyväksyttävä tiedot EN 16931 -verkkolaskuna (art. 263(3)); POST /v1/sales/invoices/peppol-xml muodostaa kyseisen tiedoston kullekin myynnille. Artiklojen 263(4) mukaista yhteistä EU-sanomaa ja kansallisia tietojen lähetyskanavia ei ole julkaistu, joten Nordlet ei lähetä tietoja eteenpäin.

Etämyynnin raja-arvo

POST /v1/declarations/eu/distance-sales-threshold/get (declarations:read) { date? } - seuraa kirjanpitotiedoista artiklan 59c mukaista 10 000 euron unionin raja-arvoa: kuluvan ja edeltävän kalenterivuoden yhteenlasketut rajatylittävät B2C-etämyynnit (OSS-järjestelmän laskut sekä rajatylittävät kuluttajalaskut ilman järjestelmää), tiedon siitä, onko yritys edelleen raja-arvon alapuolella, sekä jäljellä olevan liikkumavaran. Muut kuin EUR-määräiset asiakirjat lasketaan yhteen asiakirjan arvolla varoituksen kera. Alv-ratkaisin käyttää tätä automaattisesti, kun arvoa belowDistanceSalesThreshold ei ole annettu.

Pienyritysten alv-vapautuksen raja-arvot

POST /v1/declarations/eu/sme-thresholds/list palauttaa jäsenvaltiokohtaiset kansalliset arvonlisäverovapautuksen raja-arvot direktiivin (EU) 2020/285 mukaisesti (mukaan lukien 85 000 euron kansallinen katto ja 100 000 euron unionin laajuinen liikevaihtokatto). Luvut on haettu komission pk-yritysten portaalin maasivuilta; tapauksissa, joissa kansallinen sivu viittaa TEDB-tietokantaan ilman ilmoitettua lukua, tulos on arvaamisen sijaan null. Osa raja-arvoista on määritetty kansallisessa valuutassa (DKK/HUF/RON) ja jotkut maat julkaisevat toimialakohtaisia raja-arvoja (esim. Irlanti: palvelut 42 500 €, tavarat 85 000 €).

POST /v1/declarations/eu/sme-threshold/get { date? } raportoi alv-velvollisen ulkopuolisen yrityksen aseman suhteessa sen oman maan raja-arvoon: kuluvan kalenterivuoden liikevaihto plus edellisen vuoden liikevaihto (precedingTurnover), tila (below / approaching 80 %:ssa / exceeded, tai not_applicable rekisteröidylle alv-velvolliselle, unknown kun raja-arvoa ei löydy tiedostoista tai valuutta eroaa), jäljellä oleva liikkumavara sekä varoitukset. Mukana on myös karanteeniohjeistuksia: raja-arvon ylittäminen merkitsee vapautuksen käyttökelvottomaksi loppuvuodeksi sekä seuraavaksi kalenterivuodeksi, ja yritystä, joka on tänä vuonna raja-arvon alapuolella mutta ylitti sen viime vuonna, varoitetaan siitä, että vapautusta ei voi ottaa uudelleen käyttöön ennen seuraavaa vuotta (molempien vuosien on pysyttävä alapuolella - art. 284(2) mekaniikka; unionin liikevaihdon päätepiste sisältää saman varoituksen 100 000 euron katolle). Maille, joissa on kansallinen EU-sisäinen laukaisin - kuten Liettuan 14 000 euroa muista jäsenvaltioista hankituille palveluille ja muista jäsenvaltioista saaduille tavaroille/palveluille - vastaus sisältää intraEu-erittelyn (hankinnat EU-toimittajilta + suoritetut käännetyn alv:n palvelut) omalla tilallaan ja varoituksellaan.

Rajatylittävä pk-yritysten järjestelmä: unionin liikevaihto ja neljännesvuosiraportti

POST /v1/declarations/eu/union-turnover/get { date? } seuraa kirjanpitotiedoista rajatylittävän pk-yritysjärjestelmän 100 000 euron "unionissa syntyvän liikevaihdon" kattoa (art. 284(2)) - kaikkien EU:n sisällä tehtyjen myyntien (vienti ja soveltamisalan ulkopuoliset myynnit poissuljettuina) kokonaisarvoa kuluvana ja edellisenä kalenterivuotena - ja palauttaa molempien vuosien summat, tilan (status), liikkumavaran sekä varoitukset (not_applicable alv-velvolliselle).

POST /v1/declarations/eu/sme-cross-border-report/compute { year, quarter } tuottaa neljännesvuosiraportin, jonka järjestelmää käyttävä pk-yritys on velvollinen antamaan kotijäsenvaltiolleen (art. 284b): kyseisellä neljänneksellä kussakin jäsenvaltiossa tehtyjen myyntien kokonaisarvo, yksi rivi maata kohti (myyntijäsenvaltio = laskun kulutusmaa, muussa tapauksessa kumppanin maa, tai toissijaisesti kotimaa) sekä kokonaissumma. EU:n ulkopuoliset myynnit on suljettu pois.

Kansalliset alv-ilmoituspaketit

POST /v1/declarations/eu/vat-return/packs/list luettelee saatavilla olevat maapaketit; POST /v1/declarations/eu/vat-return/compute { countryCode, year, month, months? } ohjaa pyynnön kyseiselle maalle rekisteröidylle paketille ja palauttaa ilmoituksen numeroiduina ruutuina ({ code, label, amount }) sekä varoituksina, huomautuksina ja virallisena lähteenä (source). Edellyttää, että yritys on rekisteröity kyseiseen maahan (muussa tapauksessa palautetaan 422). Liettua (FR0600) toimitetaan ensimmäisenä pakettina, joka kääri sisäänsä olemassa olevan FR0600-rakentajan; uusia maidensaa lisätään tietopohjaisina sovittimina heti, kun niiden virallinen lomakerakenne on varmistettu.

Vanhempi POST /v1/reports/oss-yhteenveto säilytetään heuristisena analytiikkanäkymänä (kumppanimaahan perustuva, ei vaadi järjestelmää); ilmoitusten päätepisteet muodostavat virallisen viranomaiskelpoisen reitin. Kumpikin johtaa kotimaan yrityksestä sen sijaan, että olettaisi maaksi Liettuaa.