EL-i käibemaksumootor

Piiriülene käibemaksuarvestus EL-i/EMP müükide korral: käibealuse määramine, pöördmaksustamine, e-turupinna (marketplace) käsitsemine varjatud müüjana (deemed supplier), riigipõhiste määrade viide ning OSS/IOSS-i deklaratsioonid. Kõik alltoodud funktsioonid on API-põhised; õigused (scopes) on toodud iga otspunkti juures.

Maksumäärade viide

POST /v1/reference/eu-vat-rates/list (reference:read) - EL-i 27 liikmesriigi seadusjärgsed käibemaksumäärad, filtreeritavad parameetritega countryCode ja date. Määrade kehtivusperioode jälgitakse alates 2024-01-01 (EE 24 % alates 2025-07, RO 21 % / 11 % alates 2025-08, SK 23 % / 19 % alates 2025-01, FI 13,5 % ja LT 12 % alates 2026-01, CZ 12 % alates 2024-01).

Allikas: Euroopa Komisjoni andmebaas "Taxes in Europe" (TEDB, https://ec.europa.eu/taxation_customs/tedb/), päritud 2026-07-16; Leedu 2026. aasta muudatused on kinnitatud VMI (https://www.vmi.lt/evmi/pvm-tarifai) andmetel, Soome 2026. aasta muudatus vero.fi andmetel. Ulatus: ainult mandriosa / standardterritooriumi määrad - piirkondlikke erijuhte (Austria Jungholz, Kreeka saared, Assoorid/Madeira, Prantsusmaa meretagused alad ja Korsika) ei modelleerita.

POST /v1/reference/vat-classifiers/list tagastab nüüdsest klassifikaatori kohta välja countryCode (olemasolevad i.SAF-i PVM* koodid on LT); POST /v1/reference/vat-classifiers/upsert (reference:write) laeb sisse klassifikaatorite komplektid lisariikide jaoks, mis on tulevaste riigipakettide andmetee.

Tehingu maksustamise määramine

POST /v1/reference/vat/resolve (reference:read) vastab küsimusele "millist käibemaksu ma pean rakendama?". Sisend: partnerId või customerCountryCode (+ valikuline customerIsBusiness ülekirjutus - vastasel juhul tuletatakse partneri käibemaksukohustuslase koodist), supplyType (goods | services | digital), date ja olukorra lipud: belowDistanceSalesThreshold, facilitatedByMarketplace (müük toimub varjatud müüja platvormi kaudu), actingAsMarketplace (ettevõte on ise platvorm), sellerEstablishedInEu, importedConsignmentValueEur.

Nõukogu direktiiviga (EL) 2025/516 (digiajastu käibemaks ehk ViDA) lisatud reeglite sisendid:

• serviceKind (short_term_accommodation | passenger_road_transport) koos parameetriga serviceCountryCode, mis tähistab riiki, kus kinnisvara asub või kus transport toimub. Mõlemad eeldavad väärtust supplyType: "services".
• underlyingSupplierGaveVatNumber ja underlyingSupplierChargesVat: kas majutuse pakkuja või juht esitas platvormile tarbimiskohariigi käibemaksukohustuslase numbri ja deklareeris, et arvestab käibemaksu ise. Ainult mõlema tingimuse samaaegne täidetus hoiab ära platvormi käsitsemise varjatud müüjana (art 28a lg 1).
• goodsKind (installed | energy_network) kaupade korral, mis paigaldatakse või monteeritakse kliendi juures (art 36), ning gaasi, elektri, soojuse või jahutuse võrgu kaudu tarnimisel (art 38, 39).
• goodsLocationCountryCode - riik, kus kaup müügi hetkel asub või kus selle transport algab, juhul kui see ei ole ettevõtte asukohariik.

Väljund: scheme, vatCountryCode, reverseCharge, deemedSupplier, zeroRated, sihtriigi määrade loend, õiguslik alus (direktiivi 2006/112/EÜ artikkel) ja soovitused (nt meeldetuletus, et art 138 alusel vabastuse kohaldamiseks on vaja VIES-is kehtivat kliendi käibemaksukohustuslase numbrit).

Rakendatud reeglid:

Olukord	Tulemus
Riigisisene tarne	domestic, siseriiklikud määrad
EL-sisene B2B kaubatarne	intra_eu_b2b - 0% maksumääraga tarne (art 138), ostja deklareerib ise
EL-sisene B2B teenus	reverse_charge - art 44/196
EL-sisene B2C kaup / digiteenus üle 10 000 €	oss_union - sihtriigi määrad, art 33 lit a / art 58
EL-sisene B2C alla 10 000 € (belowDistanceSalesThreshold)	domestic lähtekohas, art 59c
EL-sisene B2C üldine teenus	domestic, art 45
Kaup EL-i välisele kliendile	export - 0% maksumääraga eksport (art 146 lg 1)
Teenused / digiteenused EL-i välisele kliendile	out_of_scope (art 44/59)
Müük varjatud müüja platvormi kaudu (facilitatedByMarketplace)	marketplace_deemed - 0% maksumääraga tarne platvormile (art 136a)
Imporditud saadetis ≤ 150 € B2C	ioss - sihtriigi käibemaks müügil, art 369l–369x; varjatud müüja režiim, kui actingAsMarketplace (art 14a lg 1)
Maksuvaba väikeettevõte (ettevõte ei ole käibemaksukohustuslane), riigisisene tarne	sme_exempt - käibemaks puudub, art 284 lg 1
Maksuvaba väikeettevõte, piiriülene EL-i B2C tarne, omab piiriülest EX-numbrit	sme_exempt - art 284 lg 2; kehtib seni, kuni sihtriigi piirmäär ja 100 000 € liiduülene käive ei ole ületatud
Maksuvaba väikeettevõte, piiriülene EL-i B2C tarne, EX-number puudub	säilitab režiimi oss_union / lähtekoht märkusega, et piiriülene EX-number teeks tehingu maksuvabaks
Platvorm (actingAsMarketplace), mis vahendab kuni 30-päevast majutust või sõitjate maanteetransporti alates 1. juulist 2028	deemedSupplier: true, maksustatakse riigis, kus kinnisvara asub või transport toimub (art 28a, 47, 48): domestic, oss_union tarbijale teises riigis (art 369b lit c) või reverse_charge ettevõttele
Majutuse pakkuja või juht, kes müüb sellise platvormi kaudu (facilitatedByMarketplace) alates 1. juulist 2028	marketplace_deemed - maksuvaba tarne platvormile, art 136b
Kumbki ülaltoodud juhtumitest enne 1. juulit 2028 või juhul, kui majutuse pakkuja või juht esitas oma käibemaksukohustuslase numbri ja arvestab käibemaksu ise	käibealuse määramine art 47 või 48 alusel, varjatud müüjat ei kohaldata
Teises liikmesriigis asuvad kaubad, mida müüakse sealsele tarbijale alates 1. juulist 2028	oss_union, art 369b lit e; enne seda domestic kõnealuses riigis märkusega registreerida end seal maksukohustuslaseks
Sama tehing sealsele ettevõttele	reverse_charge, art 194
Teisest liikmesriigist lähetatud kaubad	oss_union tarbijale (art 33 lit a) või intra_eu_b2b ettevõttele märkusega, et tarne kuulub selle riigi käibemaksuga maksustamisele
Paigaldatavad kaubad tarbijale teises liikmesriigis	oss_union alates 1. juulist 2028 (art 36, 369b lit d), enne seda domestic sihtkohas
Gaas, elekter, soojus või jahutus tarbijale teises liikmesriigis	oss_union alates 1. jaanuarist 2027 (art 39, 369aa, seejärel 369b lit d); reverse_charge ettevõttele (art 195)

10 000 € piirmäära (art 59c) saab edastada otse parameetriga belowDistanceSalesThreshold; kui see on puudu, jälgib mootor seda automaatselt pearaamatu andmete põhjal (vt allpool piirmäära otspunkti) ja lisab vastusele jooksvate summade märkused.

VKE maksuvabastus (direktiiv 2020/285, alates 2025. aastast). Kui ettevõte ei ole registreeritud käibemaksukohustuslane, käsitleb mootor seda väikese ettevõttena, kes kohaldab erikorda: riigisisesed tarned lahendatakse kui sme_exempt (käibemaks puudub) ja piiriülesed EL-i B2C tarned lahendatakse samuti kui sme_exempt, kui ettevõttel on piiriülene EX-number (smeExemptionNumber ettevõtte profiilil). Vastasel juhul säilib tavapärane OSS-i / lähtekoha režiim märkusega, mis soovitab piiriülest erikorda. Abikõlblikkuse (sihtriigi piirmäära ja 100 000 € liiduülese käibe ülempiiri alusel) jälgimine on maksukohustuslase kohustus; mootor toob selle märkustes esile. EX-numbri saab määrata otspunkti account/companies/update kaudu (smeExemptionNumber).

Arved

Otspunktid sales/invoices/create|update aktsepteerivad parameetreid vatScheme (üks ülaltoodud režiimidest), vatCountryCode (tarbimise liikmesriik - kohustuslik ja valideeritakse EL-i riigina režiimide oss_union / ioss korral) ja deemedSupplier. E-kaubanduse tellimused aktsepteerivad välju shipToCountryCode ja marketplace; orders/fulfill määrab tarnepõhise käibealuse automaatselt tarneaadressi riigi alusel ja märgib selle arve eelnõule (eeldab kaupa ja ületatud kaugmüügi piirmäära - vajadusel kohandage eelnõu enne kinnitamist).

Käibemaksurežiimi väli uue arve lehel

Uue arve lehe väli "Käibemaksurežiim" pakub allpool loetletud valikuid. Igale reale sisestatud käibemaksu % on määr, millega arve maksustatakse. Märgiga "käibemaks puudub" valiku tegemine seab iga rea maksumääraks 0 % (ja tagasi lülitamine taastab vaikimisi määrad). PDF-arvele trükitakse valitud režiimile seadusega ettenähtud märge. Valik "Automaatne" kutsub salvestamisel esile ülaltoodud lahenduri, kasutades partneri riiki ja käibemaksukohustuslase numbrit ning määratud "Tarne tüüpi" (kaup, teenus või digiteenus); kui partneril puudub riik või käibemaksukohustuslase नंबर (VAT number), nurjub salvestamine veateatega ja režiim tuleb ise valida.

Vormi valik	Režiim	Kasutage juhul, kui	Käibemaks arvel
Automaatne (partneri ja tarne tüübi järgi)	määratakse salvestamisel	Soovite režiimi automaatset tuletamist partneri ja tarne tüübi põhjal	Määratakse lahendatud režiimi järgi; maksuvabade režiimide korral on read nullitud
Riigisisene	domestic	Ostja asub teie riigis	Teie riigi määrad
EL-sisene B2B kaubatarne (0%, art 138)	intra_eu_b2b	Kaup saadetakse käibemaksukohustuslasena registreeritud ettevõttele teises EL-i riigis; ostja käibemaksukohustuslase number peab olema VIES-is kehtiv	Käibemaks puudub; PDF-il on viide art 138 vabastusele
EL-sisene B2B teenus (pöördmaksustamine)	reverse_charge	Teenused käibemaksukohustuslasena registreeritud ettevõttele teises EL-i riigis	Käibemaks puudub; PDF-il on kirjas "Pöördmaksustamine" (art 196)
Liidu OSS (EL-i tarbijad, sihtriigi käibemaks)	oss_union	Kaup või digiteenused teises EL-i riigis asuvatele tarbijatele üle 10 000 € EL-i ülese piirmäära; nõuab tarbimise riiki	Sihtriigi määr, sisestatakse igale reale; deklareeritakse kvartalipõhises OSS-i deklaratsioonis
IOSS (impotisaadetised kuni 150 €)	ioss	Kaup imporditakse väljastpoolt EL-i EL-i tarbijale, saadetise väärtus ≤ 150 €; nõuab tarbimise riiki	Sihtriigi määr, sisestatakse igale reale; deklareeritakse kuupõhises IOSS-i deklaratsioonis
E-turupind (varjatud müüja)	marketplace_deemed	Müük toimub platvormi kaudu, mis on varjatud müüja	Käibemaks puudub teie tarnel platvormile (art 136a)
Eksport (0% maksumäär)	export	Kaup saadetakse väljapoole EL-i	Käibemaks puudub; PDF-il on viide art 146 vabastusele
Maksualalt väljas (teenused väljaspool EL-i)	out_of_scope	Teenused kliendile väljaspool EL-i	Käibemaks puudub; PDF-il on märgitud, et tehing jääb EL-i käibemaksu kohaldamisalast välja (art 44/59)
VKE maksuvaba (ei ole käibemaksukohustuslane)	sme_exempt	Teie ettevõte ei ole käibemaksukohustuslane ja kohaldab väikese ettevõtte maksuvabastust	Käibemaks puudub; PDF-il on viide art 284 vabastusele

Mõlemad EL-i sisesed B2B valikud erinevad ainult tarnitava objekti poolest. Kaupadele kohaldub art 138 vabastus: ostja deklareerib EL-sisese soetuse. Teenustele kohaldub art 44/196 pöördmaksustamine: ostja arvestab käibemaksu ise. Mõlemat tüüpi arved koostatakse käibemaksuta, kuid PDF-ile trükitav märge ja ostja deklaratsiooni lahter, kuhu summa liigub, on erinevad, mistõttu on valik oluline.

OSS / IOSS deklaratsioonid

POST /v1/declarations/eu/oss/compute (declarations:read) { year, quarter } - liidu erikorra kvartalideklaratsioon komisjoni rakendusmääruse (EL) 2020/194 III lisa kohaselt: read tarbimise liikmesriigi × maksumäära tüübi (STANDARD / REDUCED) × maksumäära kaupa koos maksustatava summa ja käibemaksuga, kreeditarved on tasaarveldatud, lisaks kogusummad. Kaasatakse ainult väljastatud dokumendid parameetriga vatScheme: "oss_union". Hoiatused toovad esile sihtriigi ja perioodi jaoks mitteseadusjärgsed määrad, vahele jäetud 0%-lised read, dokumendid, millel puudub vatCountryCode, ning identifitseerimise liikmesriigis maksustatud tarned.

POST /v1/declarations/eu/ioss/compute { year, month } - sama struktuuriga kuudeklaratsioon režiimile vatScheme: "ioss" (imporditud saadetised ≤ 150 €).

Mõlemad vastused sisaldavad massiivi corrections (lisaks correctionsTotal): jooksval perioodil väljastatud kreeditarve, mis on seotud (välja creditedInvoiceId kaudu) varasema OSS/IOSS-i perioodi algse arvega, tõstetakse perioodiridadest välja ja deklareeritakse varasema perioodi korrektsioonina - riik, algne aasta, algne kvartal (OSS) või kuu (IOSS) ning käibemaksu negatiivne delta -, nagu nõuab määruse 2020/194 III lisa. Kreeditarved, millel puudub creditedInvoiceId, tasaarveldatakse jooksvas perioodis ja neile lisatakse hoiatus sidumise vajaduse kohta; üle kolme aasta vanused korrektsioonid märgistatakse (määruse 282/2011 art 61).

Kättesaadav igale EL-is asutatud ettevõttele (ei ole piiratud ainult Leeduga).

Omatoodete ümberpaigutamise deklaratsioon

POST /v1/declarations/eu/own-goods-transfers/compute (declarations:read) { year, month } - omatoodete ümberpaigutamise erikorra kuudeklaratsioon (direktiivi 2006/112/EÜ art 369xa–369xk, alates 1. juulist 2028), mis esitatakse selle liikmesriigi maksuhaldurile, kus ettevõte on asutatud, järgmise kuu lõpuks (dueDate). Read sisaldavad iga sihtliikmesriigi ja lähteliikmesriigi kohta ümberpaigutatud kaupade omahinnamaksumust (art 76) eurodes, mis on konverteeritud kuu viimase päeva kursi alusel (art 369xh). Ümberpaigutamine on laovarude siire (POST /v1/inventory/stock/transfer) kahe eri liikmesriigi lao vahel; lao riigi määramiseks kasutage välja countryCode otspunktis /v1/inventory/warehouses/create või /v1/inventory/warehouses/update (ladu, millel see väli puudub, asub ettevõtte koduriigis).

EL-i digitaalne aruandlus

POST /v1/declarations/eu/digital-reporting/list (declarations:read) { fromDate, toDate } loetleb iga tehingu, mida direktiivi 2006/112/EÜ art 262 nõuab alates 1. juulist 2030 deklareerida tehingupõhiselt kõigis 27 liikmesriigis:

• väljastatud müügiarved ja kreeditarved käibemaksurežiimiga intra_eu_b2b (art 262 lg 1 lit a) või reverse_charge (art 262 lg 1 lit c), mille esitamise tähtaeg on arve väljastamise kuupäev;
• registreeritud sisseostuarved teises liikmesriigis asuvalt tarnijalt, mille read sisaldavad käibemaksu, mida ettevõte ise arvestab (art 262 lg 1 lit b kaupade ja lit d teenuste osas), mille esitamise tähtaeg on 5 päeva jooksul arve saamisest.

Iga tehing sisaldab artikli 264 kohaseid andmeid: arve kuupäev ja number, tarnija ja ostja käibemaksukohustuslase numbrid, read, maksustatav summa, viide maksuvabastusele, kreeditarve korral algse arve number (art 226 p 16), tarnija pangakontod (art 226 p 17), soetuste käibemaksumäär ja -summa, deklareerimise liikmesriik (riik, mis väljastas kasutatud käibemaksukohustuslase numbri, art 262 lg 2), tähtaeg ning missing, mis loetleb puuduvad andmeelemendid. Liikmesriigid peavad andmeid aktsepteerima EN 16931 e-arvena (art 263 lg 3); POST /v1/sales/invoices/peppol-xml koostab selle faili iga tarne kohta. Artikli 263 lõikes 4 sätestatud EL-i ühtset sõnumivormingut ega andmete esitamise riiklikke kanaleid ei ole avaldatud, mistõttu Nordlet neid automaatselt ei edasta.

Kaugmüügi piirmäär

POST /v1/declarations/eu/distance-sales-threshold/get (declarations:read) { date? } - jälgib pearaamatu andmete põhjal art 59c kohast 10 000 € liiduülest piirmäära: jooksva ja eelneva kalendriaasta piiriüleste B2C kaugmüügi kogusummasid (OSS-režiimi arved pluss piiriülesed tarbijaarved ilma režiimita), seda, kas ettevõte on endiselt piirmäära aluses, ning ülejäänud vaba limiiti. Mitte-eurorahapõhiseid dokumente summeeritakse dokumendi väärtuses koos hoiatusega. Käibemaksu lahendur pärib seda automaatselt, kui parameeter belowDistanceSalesThreshold ei ole esitatud.

VKE maksuvabastuse piirmäärad

POST /v1/declarations/eu/sme-thresholds/list tagastab direktiivi (EL) 2020/285 kohased riigisisese käibemaksuvabastuse piirmäärad liikmesriikide kaupa (kaasatud on 85 000 € riiklik ülempiir ja 100 000 € liiduülese käibe ülempiir). Arvud on pärit Komisjoni VKE portaali riigilehekülgedelt; kui riiklik lehekülg viitab TEDB-le ilma konkreetse numbrita, tagastatakse oletamise asemel null. Mõned piirmäärad on kehtestatud rahvuslikus valuutas (DKK, HUF, RON) ja mõned riigid avaldavad tegevusalapõhised piirmäärad (nt Iirimaa: teenused 42 500 €, kaubad 85 000 €).

POST /v1/declarations/eu/sme-threshold/get { date? } esitab mittekäibemaksukohustuslasest ettevõtte positsiooni oma riigi piirmäära suhtes: jooksva kalendriaasta käive pluss eelneva aasta käive (precedingTurnover), status (below / approaching 80% täituvusel / exceeded, samuti not_applicable registreeritud käibemaksukohustuslase korral, unknown juhul, kui piirmäär puudub andmebaasist või valuuta erineb), ülejäänud vaba limiit ja hoiatused. Kaasas on karantiinihoiatused: piirmäära ületamisel märgitakse maksuvabastus ülejäänud jooksvaks ja järgmiseks kalendriaastaks kättesaamatuks; ettevõttele, kes on tänavu piirmäära all, kuid ületas seda mullu, kuvatakse hoiatus, et vabastust ei saa enne ülejärgmist aastat taasalustada (mõlemad aastad peavad jääma alla piirmäära - art 284 lg 2 mehhanism; liiduülese käibe otspunkt sisaldab samasugust hoiatust 100 000 € ülempiiri kohta). Riikide puhul, millel on riigisisene EL-sisene päästik - Leedu 14 000 € teistesse liikmesriikidesse osutatud teenuste ning teistest liikmesriikidest soetatud kaupade/teenuste osas -, sisaldab vastus jaotist intraEu (soetamised EL-i tarnijatelt + osutatud pöördmaksustamisega teenused) koos eraldi oleku ja hoiatusega.

Piiriülene VKE erikord: liiduülene käive ja kvartaliaruanne

POST /v1/declarations/eu/union-turnover/get { date? } jälgib pearaamatuandmete põhjal piiriülese VKE erikorra (art 284 lg 2) 100 000 € suurust "liiduülese käibe" ülempiiri - EL-i siseselt tehtud tarnete koguväärtust (ekspordid ja maksualalt väljas olevad tarned on välja jäetud) jooksval ja eelneval kalendriaastal -, tagastades mõlema aasta kogusummad, oleku status, vaba limiidi ja hoiatused (not_applicable käibemaksukohustuslase korral).

POST /v1/declarations/eu/sme-cross-border-report/compute { year, quarter } koostab kvartaliaruande, mille erikorra alusel tegutsev VKE peab oma koduriigi maksuhaldurile esitama (art 284b): tarnete koguväärtus igas liikmesriigis vastavas kvartalis, üks rida riigi kohta (tarne liikmesriik = arve tarbimise riik, vastasel juhul partneri riik, vastasel juhul koduriik) pluss kogusumma. EL-i välised tarned on välja jäetud.

Riiklikud käibemaksudeklaratsioonide paketid

POST /v1/declarations/eu/vat-return/packs/list loetleb saadaolevad riigipaketid; POST /v1/declarations/eu/vat-return/compute { countryCode, year, month, months? } edastab päringu selle riigi jaoks registreeritud paketile ja tagastab deklaratsiooni nummerdatud lahtritena ({ code, label, amount }) koos hoiatuste, märkuste ja ametliku allikaga (source). Eeldab ettevõtte registreeringut kõnealuses riigis (vastasel juhul tagastatakse 422). Leedu (FR0600) on esimene pakett, mis pakendab olemasoleva FR0600 koosturi; täiendavad riigid lisatakse andmepõhiste adapteritena kohe, kui nende ametlik vormi paigutus on kinnitatud.

Varasem koondvaade POST /v1/reports/oss säilib heuristilise analüütilise vaatena (põhineb partnerriigil, režiim ei ole kohustuslik); deklaratsioonide otspunktid on ametlik deklareerimise tee. Mõlemad tuletavad koduriigi ettevõtte andmetest, mitte ei eelda Leedut.