Faili struktuur laoseisu ja -liikumise aruande importimiseks CSV-failina
Alkoholi laoseisu aruande fail | alc_ee0a3424242_05.2018.csv |
Tubaka laoseisu aruande fail | tub_ee0t3424242_05.2018.csv |
Energiatoote laoseisu aruande fail | oil_ee0k3424242_05.2018.csv |
Faili struktuur deklaratsiooni andmete importimiseks XML-failina
Aktsiisideklaratsiooni XSD | aktsiisideklaratsiooni_xsd.xml |
Deklaratsiooni vormide XSD | deklaratsiooni_vormide_xsd.xml |
Laoseisu aruande XSD | laoseisuaruande_xsd.xml |
Tervikdeklaratsiooni XSD | tervikdeklaratsiooni_xsd.xml |
| Tubaka aktsiisideklaratsiooni XML näidis | xml_naidis_-_tubaka_aktsiisideklaratsioon.xml |
| Energiatoote aktsiisideklaratsiooni XML näidis | xml_naidis_-_energia_aktsiisideklaratsioon.xml |
| Perioodilise alkoholi aktsiisideklaratsiooni XML näidis | alkoholi_perioodilise_aktsiisideklaratsiooni_xml_naidis.xml |
| Perioodilise tubaka aktsiisideklaratsiooni XML näidis | tubaka_perioodilise_aktsiisideklaratsioon_-_xml_naidis.xml |
| Perioodilise energiatoote aktsiisideklaratsiooni XML näidis | energiatoote_perioodilise_aktsiisideklaratsiooni_xml_naidis.xml |
| Laoseisu aruande XML näidis | xml_naidis_-_laoseisuaruanne.xml |
Info edastamine EMCS infosüsteemi XML-faili abil
Faili edastamine toimub järgmiselt.
- Kasutaja koostab ettevõtte infosüsteemist lähetamiste faili, mis vastab lisatud failistruktuurile.
EMCS andmemudel | xsd
EMCS fieldlist | csv
EMCS andmemudeli tüübid | xsd
Property | xsd
EMCS vastuvõtu teate andmemudel | xml
EMCS vastuvõtu teate andmemudel | xsd - Ettevõtte volitatud kasutaja logib e-teenuste keskkonna e-MTA kaudu infosüsteemi: Maksud – Aktsiisid – ELi aktsiisikaupade saatelehed (EMCS).
- Kasutaja valib menüüst „Lisa eSL XMLina".
- Kasutaja valib menüüst „Impordi vastuvõtuteade XML-ist".
- Kasutaja näitab XML-faili asukohta ning käivitab selle importimise.
- Süsteem täidab XML-faili alusel eSL lahtrid ning saateleht esitatakse kontrolliks, juhul kui see läbib edukalt kontrolli, see esitatakse.
- eSL loetakse esitatuks, kui sellele on omistatud ARC.
Kasutusjuhendid ja juhised
Kiirelt kätte
Teenuse kasutuselevõtuks toodangukeskkonnas on vajalik teenuse testimine koos kliendiga keskkonnas ee-test. Teenuse kasutamiseks on vajalik X-teega liitumine.
- Ettemaksukonto toimingute andmete päring – prepaymentAccountTransactions
Päring kuvab ettemaksukonto toiminguid (ettemaksukontole sissetulekud ja väljaminekud) valitud perioodil. - Nõuete saldode andmete päring – balanceOfClaims
Päring on abiks tekkepõhiste (maksu)arvestuse saldode võrdlemisel valitud kuupäeva seisuga. Päringus kajastatakse nõuded koos kõikide valitud kuupäevast varasemasse perioodi tehtud nõuete muudatustega ning ettemaksukonto saldo ja arvestuslik intress. - Nõuete toimingute andmete päring – claimTransactions
Päring kuvab nõuetega seotud toiminguid (lisamised, suurendamised, vähendamised, tasumised ja muud) valitud perioodil.
Dokumendid ja lisateave
| AES X-tee liides v.1.5 zip | 1,9 MB 27.03.2026 |
| AES X-tee liides v.1.4 zip | 2,6 MB 14.01.2026 |
| AES X-tee liides v.1.3 zip | 2,6 MB 07.07.2025 |
| AES X-tee liides v.1.2 zip | 1,8 MB 16.04.2025 |
|
EL AES disainidokument doc | 6,2 MB |
|
EQC217 - AES Business Guidance_SfA_v1.02 pdf | 3,4 MB |
| EQC217 - Supporting Slides for the AES Business Guide-SfA-v1.02 pdf | 14,9 MB Infoks |
|
ETT X-tee teenus |
|
|
ETT X-tee teenuse WSDL |
|
| ETT dutyExpression ja measureAction | |
| ETT X-tee päringute näited | |
|
ETT X-tee päringute näited |
|
| ETT X-tee teenuste näited |
|
MTA X-tee liidese spetsifikatsioon (versioon 6) |
emta-x-tee-liides-v6.pdf |
|
X-tee TolliOperatsioon v.6 |
xteetollioperatsioon.wsdl |
|
ECS-i uuendatud koodiloend (Renewed codelist for ECS) |
|
|
ECS-i tehnilised spetsifikatsioonid (Technical specifications for ECS in English) |
|
|
ECS-i tehnilised spetsifikatsioonid (ekspordi teenused) |
|
|
OMF-i tehniline spetsifikatsioon (väljumismanifesti teenused) |
|
|
Seostabel CC615A ning ECS2 XML-i tagide vahel |
|
|
Tegevusjuhis ettevõttele tolli infosüsteemide masin-masin liidese testide teostamiseks |
|
|
Code of practice for the company for the performance of tests for the machine-machine interface of the customs information systems |
|
|
Technical specifications for ECS in English (Export and Exit Services) |
|
| MTA X-tee liidese spetsifikatsioon | |
| Specification of X-Road Interface of ETCB | |
| ECS-i funktsionaalne spetsifikatsioon | |
| ECS II ja OMF kasutusjuhend | |
| Scenarios for testing of the X-Road interface | |
| X-tee teststsenaariumid | |
| Kauba kirjeldus ülddeklaratsioonil | |
| ECS-i VÜD ja loendi XML skeem | |
| OMF-i XML skeem |
|
CESOP liidestumine üle X-tee | pdf | 303 KB |
| Näidis XML |
| Teadaolevad CESOPiga seotud probleemid (CESOP KEL v1.18) (inglise keeles) | xlsx |
| Makseandmete XSD kasutusjuhend ja XSD pakett v6.00 (inglise keeles) | zip | 1,4 MB |
| Valideerimismoodul v1.7.1 ja kasutusjuhend v6.00 (inglise keeles) | zip | 15,1 MB |
| EL-i käibemaksutaotluse arvete ja impordidokumentide importformaadi kirjeldus | |
|
Dokumentide importimisel teostatavad kontrollid |
|
|
XML-andmetabeli kirjeldus 1 |
|
|
XML-andmetabeli kirjeldus 2 |
|
| XML-andmetabeli näidis |
UUM&DS ehk Uniform User Management & Digital Signature on Euroopa Komisjoni autentimis-, autoriseerimis- ja digiallkirjastamise teenus, mis pakub ühtset ja turvalist ligipääsu ELi rakendustele.
|
Lisa 5 Deklaratsiooni vorm CRS XSD Sõnumi üldandmed |
|
|
Lisa 6 Deklaratsiooni vormi CRS XSD lisa 1 FATCA ja CRS ühiste tüüpide klassifitseerimine |
|
|
Lisa 7 Deklaratsiooni vormi CRS XSD lisa 2 OECD ühiste tüüpide klassifitseerimine |
|
|
Lisa 8 Deklaratsiooni vormi CRS XSD lisa 3 Riikide ja valuutade koodid |
|
|
Lisa 9 Deklaratsiooni vormi CRS XSD lisa 4 FATCA andmeliikide klassifitseerimine |
|
|
Lisa 10 Deklaratsiooni vorm DAC2 XSD Sõnumi üldandmed |
|
|
Lisa 11 Deklaratsiooni vormi DAC2 XSD lisa 1 FATCA ja CRS ühiste tüüpide klassifitseerimine |
|
|
Lisa 12 Deklaratsiooni vormi DAC2 XSD lisa 2 OECD ühiste tüüpide klassifitseerimine |
|
|
Lisa 13 Deklaratsiooni vormi DAC2 XSD lisa 3 Riikide ja valuutade koodid |
|
|
Lisa 14 Deklaratsiooni vormi DAC2 XSD lisa 4 FATCA andmeliikide klassifitseerimine |
|
| Näidis täidetud deklaratsioonist |
Maksukohustuslaste koodi (TIN – tax identification number) formaati ja struktuuri on võimalik kontrollida Euroopa Komisjoni veebilehel.
|
Juhis ISO maatähiste erisuste kohta |
Füüsilise isiku maksuandmete X-tee teenus on mõeldud Maksu- ja Tolliameti (MTA) maksukohustuslaste registri andmete alusel maksuandmete tõendi koostamiseks ja edastamiseks X-tee kaudu kolmandatele osapooltele.
Teenus koosneb kahest osast: füüsilise isiku nõusoleku andmisest Riigi Infosüsteemi Ameti (RIA) nõusolekuteenuses ja nõusoleku alusel isiku maksuandmete edastamisest kolmandatele osapooltele.
Teenusega liitumise sammud
1. Tutvuge teenuste kirjeldusega
Füüsilise isiku maksuandmete X-tee teenuse kirjelduse koos tehnilise infoga leiate teenuse dokumendist. Info RIA nõusolekuteenuse kohta leiate RIA kodulehelt.
2. Liituge X-teega
Teenuse testimiseks X-tee arenduskeskkonnas ee-dev ja avamiseks toodangukeskkonnas EE peab kasutama vastavaid alamsüsteeme. Alamsüsteemi nimi arenduskeskkonnas peab olema kujul
ee-dev/liikme klass/registrikood/alamsüsteem ning toodangukeskkonnas
EE/liikme klass/registrikood/alamsüsteem.
Liituge X-teega läbi X-tee iseteeninduskeskkonna.
3. Esitage taotlus füüsilise isiku maksuandmete X-tee ja nõusolekuteenusega liitumiseks.
4. Liituge füüsilise isiku maksuandmete X-tee teenuse ja RIA nõusolekuteenusega
Füüsilise isiku maksuandmete X-tee teenuse tehniline info on kirjeldatud teenuse dokumendis. Teenuse WSDL ja XML näidis.
Info RIA nõusolekuteenuse kohta leiate RIA kodulehelt. Nõusolekuteenuse kohta käivate küsimuste korral kirjutage palun [email protected].
5. Testimine
Maksu- ja Tolliamet loob taotluses esitatud testijatele testisikud. Testimisel kasutatakse testijate reaalseid isikunimesid ja isikukoode, kuid maksuandmete tõendil kuvatavad testisikute maksuandmed on välja mõeldud ja kõigil testijatel ühesugused. Testijad peavad andma Maksu- ja Tolliametile nõusoleku enda andmete kasutamiseks, saates e-kirja aadressile [email protected].
6. Allkirjastage leping
Testide eduka läbimise järel sõlmib Maksu- ja Tolliamet teenuse liitujaga teenuse kasutustingimustega nõustumise lepingu koos teenuse kasutustingimustega ja avab teenuse toodangukeskkonnas.
Dokumendid ja lisateave
Teenuse kaudu saavad pankade/investeerimisplatvormide kliendid saata oma maksuaruande andmeid Maksu- ja Tolliameti (MTA) füüsilise isiku tuludeklaratsioonile.
Teenuse tehniline nimetus: /GOV/70000349/investment_income_report/investment-income-report
Teenusega liitumise sammud
1. Tutvuge teenuste kirjeldusega
Teenuse kirjelduse koos tehnilise infoga leiate dokumentide loetelust.
2. Liituge X-teega
Teenuse testimiseks X-tee arenduskeskkonnas ee-dev ja avamiseks toodangukeskkonnas EE peab kasutama vastavaid alamsüsteeme. Alamsüsteemi nimi arenduskeskkonnas peab olema kujul
ee-dev/liikme klass/registrikood/alamsüsteem ning toodangukeskkonnas
EE/liikme klass/registrikood/alamsüsteem.
Liituge X-teega läbi iseteeninduskeskkonna.
3. Esitage taotlus teenusega liitumiseks.
4. Liituge teenusega
Teenuse tehnilise info, openAPI spetsifikatsiooni ning JSON näidisfaili leiate dokumentide loetelust.
5. Testimine
Teenuse testimine toimub koos kliendiga. Klient edastab meile andmed kasutades maksuandmete edastamise X-tee teenust. Testimiseks tuleb kasutada MTA INT või test keskkonda. Klient edastab MTA-le maksuandmete edastamise X-tee teenuse kaudu andmed ja kui andmete edastamine õnnestub siis klient saab positiivse vastuse. Seejärel MTA poolne testija saab avada vastava isiku deklaratsiooni ning kontrollida kas andmed on antud isikule eeltäidetud ja korrektsed.
6. Allkirjastage leping
Testide eduka läbimise järel sõlmib MTA teenusega liitujaga teenuse kasutustingimustega nõustumise lepingu ja avab teenuse toodangukeskkonnas.
Elektrooniline hasartmängu aruandlus
|
EHMA teenuste spetsifikatsioon (seisuga 26.07.2021) |
|
|
EHMA services specification (as of 26.07.2021) |
|
|
Spetsifikatsiooni versioon esiletoodud muudatustega (seisuga 12.10.2015, kajastab v1.2 ja v2.1 erinevusi) |
|
|
EHMA-v2.wsdl (seisuga 28.07.2015, rakendus 01.01.2016) |
|
|
Ehma-v4.wsdl Üleminekuks X-tee versioonile 6 |
Hasartmängu mängimise piirangutega isikute (HAMPI) nimekirjale juurdepääs
| HAMPI teenuste korraldaja spetsifikatsioon | |
|
HAMPI specification |
|
|
hampi-xrd-v6.wsd Üleminekuks X-tee versioonile 6 |
|
MTA X-tee liidese spetsifikatsioon (versioon 6) |
emta-x-tee-liides-v6.pdf |
|
X-tee TolliOperatsioon v.6 |
xteetollioperatsioon.wsdl |
|
ICS liidestamise tehniline spetsifikatsioon 01122015 |
|
|
ICS technical specifications 01122015 (ENG) |
|
|
Tegevusjuhis ettevõttele tolli infosüsteemide masin-masin liidese testide teostamiseks |
|
|
Code of practice for the company for the performance of tests for the machine-machine interface of the customs information systems |
|
| Asendustoimingutest | |
| ICSi ja IMFi juhend | |
|
Scenarios for testing of the X-Road interface |
|
| Kauba kirjeldus ülddeklaratsioonil | |
| Lennutranspordi vormistamisest | |
| X-tee teststsenaariumid | |
| Näidispäringud | |
| Veebikliendi ENSi andmemudel |
|
Impulss X-tee liides (tootes al 09.06.2025) |
Impulss_x_tee_liides.pdf |
|
X-tee dokumentatsioon lisadega (tootes al 09.06.2025) |
Impulss_x_tee_dokumentatsioon_lisadega.zip |
|
X-tee sõnumite näidised (XML) (29.05.2024) |
Lisa 1 - X-tee_sonumite_XML_naidised.zip |
|
X-tee sõnumite XSD skeemid (29.05.2024) |
Lisa 2 - X-tee_sonumite_XSD_skeemid.zip |
|
X-tee sõnumite veateated (29.05.2024) |
Lisa 3 - Impulss_X-tee_veateated.pdf |
| X-tee aruanded (29.05.2024) | Lisa 4 - X-tee_aruanded.zip |
|
Andmekoosseis |
|
| Profiilide lõikes andmekoosseis (07.02.2025) | |
| X-tee sõnumite ülevaade (29.05.2024) | |
| Impulss.wsdl | |
| Impulss talitlusreeglid (seisuga 16.05.2024) |
Kiirelt kätte
Vorm INF 2
Vorm INF 3
| XML-andmetabeli kirjeldus | INF 3 CSV-failina esitamise juhend | pdf |
| XML-andmetabeli näidis | INF 3 CSV-näidisfail |
Vorm INF 4
Vorm INF 5
Vorm INF 6
Vorm INF 9
Vorm INF 14
| Vormi INF 14 täitmise juhend | pdf | XML-formaadi kirjeldus |
| XML-formaadi struktuur | doc | XML-andmetabeli näidis |
Vorm INF 16
Vorm INF 17
Koodiloendite haldamiseks pakutakse kahe süsteemi teenuseid.
KHS – Klassifikaatorite haldamise süsteem
Klassifikaatorite haldamise süsteemi (KHS) eesmärgiks on pakkuda Maksu- ja Tolliameti (MTA) infosüsteemidele ja avalikkusele MTA tegevusvaldkonnas tarvilikke klassifikaatoreid.
Nii on tagatud klassifikaatorite ajakohasus ning süsteemide koostalitusvõime. KHS ISKE turvaklass on K2T1S0. Infosüsteemis isikuandmeid ei töödelda. Klassifikaatorite andmed on reeglina avalikud, välja arvatud üksikud konfidentsiaalsed klassifikaatorid, mis on ainult MTA sisemiste süsteemide jaoks – neid ei väljastata.
Iga klassifikaatori kohta on metadata ja elementide versiooni XML-failid. Elementide ajaline kehtivus on tuletatav versiooni(de) kehtivusest. Kui teie rakendus vajab elemente ka tagasiulatuvalt, siis peate omale laadima kõik vastava perioodi versioonid. Klassifikaatorite pärimiseks on loodud KHS universaalne liides. Eeldatakse, et liidest kasutatakse välise infosüsteemi kaudu, mis korraldab andmete puhverdamise ning vastava kasutusjuhtumi jaoks ettevalmistamise. Konkreetse deklaratsioonitüübi jaoks vajalikud klassifikaatorid on kirjeldatud selle rakenduse vastavas dokumentatsioonis.
Dokumendid
UNIREG – Universaalne register
Oktoobris 2023 võtsime kasutusele Unireg süsteemi (Universaalne register), mis on Klassifikaatorite haldamise süsteemi (KHS) alternatiiv. Unireg on mõeldud majutamaks ja pärimaks klassifikaatoreid (registreid), mille suur elementide arv ning tihe uuendamissagedus ei võimalda neid efektiivselt hoida KHSis.
Unigeril on kolm teenust andmete pärimiseks JSON-formaadis:
- elemendi küsimine kehtivuse kuupäeva ja koodi järgi;
- elementide valiku küsimine kuupäeva ja alamsõne järgi;
- kõikide elementide küsimine kehtivuse kuupäeva järgi.
Uniregis on kasutada järgmised registrid (nende pärimiseks ei saa kasutada KHSi):
- CL016 – EU.CUSCODE
- CL141 – EU.CUSTOMS_OFFICES
- CL244 – EU.UN_LOCODE_EXTENDED
Dokumendid
Üldised dokumendid
| Süsteemi Käibedeklaratsioon (KMD) andmekoosseis | pdf (alates 01.07.2025) |
Süsteemi Käibedeklaratsioon (KMD) andmekoosseis | pdf (alates 01.01.2025) |
Süsteemi Käibedeklaratsioon (KMD) andmekoosseis | pdf (alates 01.01.2024) |
Süsteemi Käibedeklaratsioon (KMD) andmekoosseis | pdf (alates 01.08.2022 kuni 31.12.2023) |
| Süsteemi Käibedeklaratsioon (KMD) klassifikaatorid | pdf (alates 01.07.2025) |
Süsteemi Käibedeklaratsioon (KMD) klassifikaatorid | pdf (alates 01.01.2025) |
Süsteemi Käibedeklaratsioon (KMD) klassifikaatorid | pdf (alates 01.01.2024) |
Süsteemi Käibedeklaratsioon (KMD) klassifikaatorid | pdf (alates 01.08.2022 kuni 31.12.2023) |
| Süsteemi Käibedeklaratsioon (KMD) reeglid | pdf (alates 01.07.2025) |
Süsteemi Käibedeklaratsioon (KMD) reeglid | pdf (alates 01.01.2025) |
Süsteemi Käibedeklaratsioon (KMD) reeglid | pdf (alates 01.01.2024) |
Süsteemi Käibedeklaratsioon (KMD) reeglid | pdf (alates 01.08.2022 kuni 31.12.2023) |
Masin-masin liidese kirjeldusega seotud dokumendid
X-tee v6 teenuste WSDL-failid
Käibedeklaratsiooni on kõige mugavam saata Maksu- ja Tolliametile X-tee kaudu otse ettevõtte raamatupidamistarkvarast.
|
KMD masin-masin liidese teenuse kirjeldus (uuendatud novembris 2019) |
|
|
downloadmime.wsdl |
|
|
uploadmime.wsdl |
|
|
MTA X-tee teenuse downloadMime.v1 |
|
|
MTA X-tee teenuse uploadMime.v1 |
|
| Deklaratsiooni andmete vastuvõtmise kinnitussõnum | |
| Deklaratsiooni andmete tagasilükkamissõnum |
XML-faili formaadi kirjeldusega seotud dokumendid
| Süsteemi Käibedeklaratsioon (KMD) XML-formaadi kirjeldus | |||
| KMD XML Schema (XSD) vatdeclaration.xsd (alates 01.07.2025) |
KMD XML Schema (XSD) vatdeclaration.xsd (alates 01.01.2025) |
KMD XML Schema (XSD) vatdeclaration.xsd (alates 01.01.2024) |
KMD XML Schema (XSD) vatdeclaration.xsd (alates 01.08.2022 kuni 31.12.2023) |
| KMD XML näidisfail vatdeclaration example.xml (alates 01.07.2025) |
KMD XML näidisfail vatdeclaration example.xml (alates 01.01.2025) |
KMD XML näidisfail vatdeclaration example.xml (alates 01.01.2024) |
KMD XML näidisfail vatdeclaration example.xml (alates 01.08.2022 kuni 31.12.2023) |
| KMD XML näidisfail (käibemaksugrupp) vatdeclaration group example.xml (alates 01.07.2025) |
KMD XML näidisfail (käibemaksugrupp) vatdeclaration group example.xml (alates 01.01.2025) |
KMD XML näidisfail (käibemaksugrupp) vatdeclaration group example.xml (alates 01.01.2024) |
KMD XML näidisfail (käibemaksugrupp) vatdeclaration group example.xml (alates 01.08.2022 kuni 31.12.2023) |
CSV-faili formaadi kirjeldusega seotud dokumendid
| Süsteemi Käibedeklaratsioon (KMD) CSV-formaadi kirjeldus | pdf (alates 01.07.2025) |
Süsteemi Käibedeklaratsioon (KMD) CSV-formaadi kirjeldus | pdf (alates 01.01.2025) |
Süsteemi Käibedeklaratsioon (KMD) CSV-formaadi kirjeldus | pdf (alates 01.01.2024) |
Süsteemi Käibedeklaratsioon (KMD) CSV-formaadi kirjeldus | pdf (alates 01.08.2022 kuni 31.12.2023) |
| KMD CSV näidisfail vatdeclaration_example6.csv (alates 01.07.2025) |
KMD CSV näidisfail vatdeclaration_example5.csv (alates 01.01.2025) |
KMD CSV näidisfail vatdeclaration_example5.csv (alates 01.01.2024) |
KMD CSV näidisfail vatdeclaration_example5.csv (alates 01.08.2022 kuni 31.12.2023) |
| CSV näidisfail (käibemaksugrupp) vatdeclaration_group_example6.csv (alates 01.07.2025) |
CSV näidisfail (käibemaksugrupp) vatdeclaration_group_example5.csv (alates 01.01.2025) |
CSV näidisfail (käibemaksugrupp) vatdeclaration_group_example5.csv (alates 01.01.2024) |
CSV näidisfail (käibemaksugrupp) vatdeclaration_group_example5.csv (alates 01.08.2022 kuni 31.12.2023) |
Videojuhis „KMD INF csv-faili ettevalmistamine e-MTAsse üleslaadimiseks"
|
Teenuse tehniline nimetus: EE/GOV/70000349/kmd/kmkr/v1 |
Teenuse sisend:
- Põhipäring
Äriregistri kood, isikukood või KMKR number
Lk number – päringu vastuse ridu piirav parameeter (1 – 1 kuni tuhat rida, 2 – 2 kuni 2000 rida)
- Muudatuste päring
Perioodi algus /pp.kk.aaaa/
Perioodi lõpp /pp.kk.aaaa/
Lk number – päringu vastuse ridu piirav parameeter
Teenuse väljund:
|
|
Masin-masin liidese kirjeldusega seotud dokumendid
Kütuse käitlemise andmekogu vastavusdokumentide süsteem (VDS)
Biokütuse tarneandmete aruandluse esitamine
|
LAAKi kasutusjuhend |
|
|
LAAKi koondaruannete |
|
|
Sisse- ja väljamineku |
|
| LAAKi X-tee teenuse juhised | |
| Compulsory-fields.xlsx
XML-i kohustuslikud väljad (kütus) |
|
| Tolliladu-samm1-SIS10.xml | |
| Tolliladu-samm2-STK14-13.xml | |
| Tolliladu-samm3-ASU24-44.xml | |
|
Täiendavad klassifikaatorid alates 16.08.2019 |
|
| LAAKi X-tee teenuse XML-näited |
|
| eelnevad_jargnevad_ja_alusdokumendid_23.09.2025.xlsx | |
| Laoarvestuse andmestik (muu kaup) |
|
| Koondaruande struktuur (muu kaup) |
|
|
Koondaruande XML-skeem (saldo, muu kaup) |
|
|
Koondaruande XML-skeem |
|
|
Koondaruande kannete |
|
|
Koondaruande saldo XML-näidis |
|
| LAAK veateated ja veakoodid | |
| KKS ja LAAK tegevuskohtade koodid |
|
Lisa 1 Deklaratsiooni vorm FATCA XSD |
|
|
Lisa 2 Deklaratsiooni vormi FATCA XSD lisa 1 Riikide ja valuutade koodid |
|
|
Lisa 3 Deklaratsiooni vormi FATCA XSD lisa 2 Nimede ja aadresside klassifitseerimine |
|
|
Lisa 4 Deklaratsiooni vormi FATCA XSD lisa 3 Andmeliikide klassifitseerimine |
|
Maksuandmete tõendi XML-formaadi kirjeldus |
|
Teenuse tehniline nimetus: EE/GOV/70000349/mkrliides/maksuvolglased/v1 |
https://x-tee.ee/catalogue-data/EE/EE/GOV/70000349/mkrliides/15.wsdl |
Päringu kirjeldus
Andmed edastatakse kasutajale kokkupakituna .xml formaadis. Kui edastatava faili maht läheb liiga suureks, siis andmed jagatakse mitmesse faili, kasutajale kuvatakse sellekohane teavitus ning faililaadimist tuleb korrata järgmise järjekorranumbriga.
Andmevahetuse käivitamine
Andmeid uuendatakse igaöiselt, päringu teostamise aeg on hommikuti alates kl 06.00.
Teenuse sisend
Valida faili tunnus, mida soovitakse laadida:
1. maksuvolad
2. deklaratsioonid
Teenuse väljund
Maksuvõlgade (maksuvolad) failis sisalduvad andmed
- Kood (st, äriühingu registrikood või MRR kood)
- Nõude liik
- Maksuvõlg
- Tasumisgraafikus
- Tasumisgraafiku tagatis
- Tasumisgraafiku lõppkuupäev
- Vaidlustatud
- Vanima tasumata nõude tasumise tähtpäev
- Andmed seisuga
Esitamata deklaratsioonide failis sisalduvad andmed
- Kood (st, äriühingu registrikood või MRR kood)
- Esitamata deklaratsiooni nimi
- Deklaratsiooni tähtaeg
- Andmed seisuga
XML-formaadis failid
|
Tootele kinnitamise teade alkohol |
|
|
Tootele kinnitamise teade registreeritud alkohol |
|
|
Tootele kinnitamise teade tubakas |
|
|
Aktsiisilattu lähetamise teade alkohol |
|
|
Aktsiisilattu lähetamise teade tubakas |
|
|
Tarbimisse lähetamise teade alkohol |
|
|
Tarbimisse lähetamise teade tubakas |
CSV-formaadis failid
|
Aktsiisilattu lähetamise teade alkohol |
|
|
Aktsiisilattu lähetamise teade tubakas |
|
|
Tarbimisse lähetamise teade alkohol |
|
|
Tarbimisse lähetamise teade tubakas |
Teenuse tehniline nimetus: EE/GOV/70000349/persons/PublicNonResidencyInquiry/v1
Teenuse kaudu saab pärida residentsusandmeid.
Teenuse sisend
- Maksu- ja tolliameti poolt väljastatud mitteresidendi kood
- Füüsilise isiku isikukood või juriidilise isiku registrikood
- Füüsilise isiku isikukoodi või juriidilise isiku registrikoodi riik
- Käibemaksukohustuslase number
- Käibemaksukohustuslase numbri riik
- Kuupäev, mille seisuga mitteresidentsuse kirjeid soovitakse
Teenuse väljund
- Isiku liik
- Füüsilise isiku isikukood (ja riik) või juriidilise isiku registrikood (ja riik)
- Füüsilise isiku ees- ja perenimi
- Maksu- ja tolliameti poolt väljastatud mitteresidendist isiku registrikood (olemasolul)
- Juriidilise isiku ärinimi
- Isiku mitteresidentsuskirjed
- Mitteresidentsuskirje tüüp
- EMPLOYER – Eestis registreeritud mitteresidendist tööandja
- MAIN – Mitteresidentsuse põhikirje
- PERMANENT_ESTABLISHMENT - Eestis registreeritud mitteresidendi püsiv tegevuskoht
- PROOF_OF_RESIDENCE – Välisriigist väljastatud residentsustõend
- Mitteresidentsusriik
- Mitteresidentsuse alguse ja lõpu kuupäev
Maksu- ja Tolliameti (MTA) mootorsõidukimaksu aastamaksu arvutamise avaliku API (application programming interface) eesmärk on maksu summa arvutamine ühe sõiduki kaupa.
API päringu vastus kuvab andmeid reaalajas. Päringu vastusega ei edastata isikuandmeid ega maksusaladust.
Masspäringute tegemiseks tuleb välistel osapooltel sõlmida MTAga kasutustingimustega nõustumise leping.
Üksikpäringute tegemiseks võimaldab MTA välistel osapooltel kasutada API-t piiranguteta.
|
nap_liides.xsd |
|
|
napTeenus.wsdl |
XML faili formaadi kirjeldusega seotud dokumendid
Masin-masin liidese kirjeldusega seotud dokumendid
NES X-tee teenused
NES X-tee teenused on loetletud failis „NES X-tee spetsifikatsioon”. Nende selgitused leiate järgmisest tabelist.
| X-tee teenus | Selgitus |
|---|---|
| createPresentationNotification.v1 | PN esitamine |
| updatePresentationNotification.v1 | PN muutmine |
| revokeReceptaclePresentationNotification | Postikoti PN tühistamine |
| riskAnalysisStatus.v1 | Riskide seisu päring |
| insertTemporaryStorageDeclaration.v1 | ALD esitamine |
| updateTemporaryStorageDeclaration.v1 | ALD muutmine |
| insertTemporaryStorageDeclarationWithDataReuse.v1 | ALD esitamine andmete taaskasutamisega |
| updateTemporaryStorageDeclarationWithDataReuse.v1 | ALD muutmine andmete taaskasutamisega |
| revokeTemporaryStorageDeclaration.v1 | ALD tühistamine |
| insertTemporaryStorageDeclarationMan.v1 | MAN ALD esitamine |
| updateTemporaryStorageDeclarationMan.v1 | MAN ALD muutmine |
| InsertTemporaryStorageDeclarationT1.v1 | T1 ALD esitamine |
| UpdateTemporaryStorageDeclarationT1.v1 | T1 ALD muutmine |
| RequestTemporaryStorageDeclarationPDF.v1 | ALD PDFi pärimine |
| partialUpdateTemporaryStorageDeclaration.v1 | Osaline ALD muutmine |
| partialUpdateTemporaryStorageDeclarationWithDataReuse.v1 | Osaline ALD andmete taaskasutamisega muutmine |
| partialUpdateTemporaryStorageDeclarationMan.v1 | Osaline MAN ALD muutmine |
| partialUpdateTemporaryStorageDeclarationT1.v1 | Osaline T1 ALD muutmine |
| insertFollowingOperation.v1 | Järgmise toimingu lisamine |
Ilmnenud vigade ja probleemide korral saatke palun järgmine info e-posti aadressile [email protected]:
- süsteemi nimetus ja võimalusel selle konkreetne teenus/funktsionaalsus, kus esineb probleem/viga;
- vea saamise aeg (kuupäev/kellaaeg);
- konkreetne viga/kood;
- kui viga saadakse kliendi veebirakenduses, siis ekraanitõmmis, kus on näha ka aadressiriba ja aeg ning viga;
- kui viga saadakse X-tee teenust kasutades, siis saadetav request-sõnum ja vastu saadav response (kui saadakse) XML-vormingus;
- info kriitilisuse kohta (kas takistab nt tööd või ainult häirib, vmt);
- pöörduja kontakt (e-posti aadress, telefoninumber).
Tehniline teave
|
SADHES saatelehe XML-faili näidised (versioon 6) |
sadhes-v6-examples.zip |
X-tee kasutajale
|
MTA X-tee liidese spetsifikatsioon (versioon 6) |
emta-x-tee-liides-v6.pdf |
|
X-tee Tollioperatsioon v.6 |
xteetollioperatsioon.wsdl |
|
X-tee spetsifikatsioonid v.1.5.5.1 |
sadhes_x-tee_spetsifikatsioon_ver1.5.5.1.zip |
| SADHES klassifikaatorid X-tee ver. 1.5.4 | sadhes_klassifikaatorid.csv |
| Saatelehe töötlemise talitlusreeglid | saatelehe_tootlemise_talitlusreeglid.pdf |
Kasutusjuhendid ja juhised
Kiirelt kätte
|
Reklaamimaksu deklaratsioon Kehtib alates 01.01.2020 |
|
|
Reklaamimaksu deklaratsiooni elektroonilise faili struktuur Kehtib alates 01.01.2020 |
|
MTA X-tee liidese spetsifikatsioon (versioon 6) |
emta-x-tee-liides-v6.pdf |
|
X-tee TolliOperatsioon v. |
xteetollioperatsioon.wsdl |
|
Complex X-tee liides |
|
| Complex sõnumid | |
| Complex andmekoosseis | |
|
Complex koodiloend, seisuga 01.05.2021 (uuendatud on „TarneTingimused" koode) |
|
| Complex koodiloend, seisuga 01.01.2020 | |
| Complex koodiloend, seisuga 01.02.2019 | |
| Sõnumite XML-skeemide definitsioonid | |
|
Tegevusjuhis ettevõttele tolli infosüsteemide masin-masin liidese testide teostamiseks |
NCTS6
| NCTS6 X-tee liides v.1.2 | 2 MB | zip 12.03.2026 |
| EL NCTS P6 tehnilised spetsifikatsioonid |
TSD üldised dokumendid
|
(alates 01.01.2025) |
(alates 01.01.2023) |
(alates 01.01.2022) |
|
TSD lisa 1 väljamakseliikide tabel | xlsx (alates 01.01.2025) |
TSD lisa 1 väljamakseliikide tabel | xlsx (alates 01.01.2023) |
TSD lisa 1 väljamakseliikide tabel | xlsx (alates 01.01.2021) |
|
TSD lisa 2 väljamakseliikide tabel | xlsx (alates 01.01.2025) |
TSD lisa 2 väljamakseliikide tabel | xlsx (alates 01.01.2023) |
TSD lisa 2 väljamakseliikide tabel | xlsx (alates 01.01.2022) |
TSD XML- ja CSV-formaadi kirjeldusega seotud dokumendid
|
TSD XML-formaadi struktuur | pdf (alates 01.01.2025) |
TSD XML-formaadi struktuur | docx (alates 01.01.2023) |
TSD XML-formaadi struktuur | doc (alates 01.01.2022) |
|
TSD XML-formaadi struktuur | xsd (alates 01.01.2025) |
TSD XML-formaadi struktuur | xsd (alates 01.01.2023) |
TSD XML-formaadi struktuur | xsd (alates 01.01.2022) |
|
(alates 01.01.2025) |
(alates 01.01.2023) |
(alates 01.01.2022) |
|
TSD CSV-formaadi struktuur | pdf (alates 01.01.2025) |
TSD CSV-formaadi struktuur | docx (alates 01.01.2023) |
TSD CSV-formaadi struktuur | docx (alates 01.01.2022) |
|
(alates 01.01.2023) |
||
|
(alates 01.01.2023) |
||
Pankadele TuMS §17 alusel intresside deklareerimiseks
|
XF 11 XML-formaadi struktuur | xml (alates 01.01.2023) |
XF 11 XML-formaadi struktuur | xml (alates 01.01.2022) |
|
XF 11 XML-formaadi struktuur | docx (alates 01.01.2023) |
XF 11 XML-formaadi struktuur | doc (alates 01.01.2022) |
|
(alates 01.01.2023, uuendatud 16.10.2024) |
XF 11 XML näide |
|
(alates 01.01.2023, uuendatud 16.10.2024) |
XF 11 CSV näide |
TSD esitamise X-tee v6 teenused
- uploadMime – faili edastamise teenus
- confirmTsd – TSD kinnitamise teenus
- getTsdStatus – faili või kinnituse staatuse küsimise teenus
- getTsdFeedback – TSD tagasiside küsimise teenus
| Teenus on MIME multipart/related tüüpi ehk SOAP with Attachments. Sõnum tuleb panna manusena SOAP ümbriku taha. Esimene osa MIME konteineris on SOAP ümbrik ning teine gzipitud manus. SOAP ümbikus olev 'file' element viitab manuse Content-ID väärtusele. MIME sõnumeid tuleb teele saata spetsiaalse HTTP Content-Type päisega. Content-Type: multipart/related; boundary="----=_Part_0_18725445.1367829312171"; type="text/xml"; start="<soapPart>" |
uploadMime tehniline kirjeldus | pdf |
| uploadmime.wsdl | |
| uploadMime näidisfail | xml | |
| confirmTsd teenuse struktuuri kirjeldus | pdf | confirmTsd.wsdl |
| getTsdStatus teenuse struktuuri kirjeldus | pdf | getTsdStatus.wsdl |
| getTsdFeedback teenuse struktuuri kirjeldus | pdf | getTsdFeedback.wsdl |
| confirmTsd, getTsdStatus ja getTsdFeedback teenuste sisendid ja väljundväärtuste näidised | pdf |
TSD pangaliides
|
TSD pangaliidese API kirjeldus |
|
|
TSD pangaliides andmekoosseis |
|
|
banklink.wsdl |
ESD XML
|
ESD xml formaadi struktuur (alates 01.01.2015) |
|
|
ESD xml formaadi struktuur (alates 01.01.2015) |
|
|
ESD xml näide (alates 01.01.2015, uuendatud 16.10.2024) |
Töötamise registreerimine e-MTAs CSV-formaadis
CSV-failiformaadi kirjeldus | pdf (uuendatud 04.03.2025) | (uuendatud 04.03.2025) |
Töötamise registreerimine, peatamine ja muutmine masin-masin liidesega TOOTREG
Töötamise registreerimise ja muutmise reeglid masin-masin liidese kaudu (TOOTREG) | pdf (uuendatud 24.04.2025) | |
TOOTREG sisendsõnumi kirjeldus | pdf (uuendatud 24.04.2025) | TOOTREG tagastatavad teated sõnumis sisalduvate andmete kohta | docx (uuendatud 03.07.2025) |
Töötamise registri masin-masin liideste tehniline kirjeldus | xml (uuendatud 05.03.2025) |
Töötamise registri kannete allalaadimise teenuse TORRGNO
TORRGNO spetsifikatsioon | pdf (uuendatud 30.07.2025) |
Töötamise klassifikaatorid
Töövõtuahela ja töötamise kestuse infosüsteemi juhendid
VD aruanne
|
Vorm VD xml kirjeldus |
|
|
Vorm VD xml näidis (ühendusesisese käibe deklareerimiseks) |
|
|
Vorm VD xml näidis (nõudmiseni varu deklareerimiseks) |
|
| Vormi VD xsd | |
|
Vormi VD xsd (nõudmiseni varu) |
|
|
VD ja VDP veateadete selgitused |
|
Teenuse tehniline nimetus: EE/GOV/70000349/mkrliides/vpt/v1 |
https://x-tee.ee/catalogue-data/EE/EE/GOV/70000349/mkrliides/30.wsdl |
Andmevahetuse käivitamine
Ajakohased andmed on alati kättesaadavad ning juurdepääsu kasutaja ise otsustab, millal andmevahetus käivitada. Üksikpäringut on keelatud kasutada andmete massilise pärimise eesmärkidel.
Teenuse sisend:
1. isikukood (füüsiline isik) või äriregistrikood (juriidiline isik) või MTA antud MRR kood (mitteresident);
2. kuupäev
Märkus: Maksuvõla puudumise või olemasolu kontrollimise kuupäev saab olla päringu tegemise kuupäev.
Teenuse väljund:
| Kodeeritud vastus: | Tähendus: |
|---|---|
| 0 - pole nimekirjas | Maksuvõlg puudub |
| 1 - on nimekirjas | On maksuvõlg ja/või esitamata deklaratsioonid |
| 2 - viga | Viga |
- Märkus 1: Päringu vastuseks on “Maksuvõlg puudub” ka juhul, kui maksukohustuslasel olev kõikide sama maksuhalduri hallatavate maksude võlg, arvestamata haldusaktiga kindlaksmääramata intressi, on väiksem kui 100 eurot või kui maksuvõla tasumine on ajatatud. (MKS § 14 lg 5).
- Märkus 2: Päringu vastuseks on “On maksuvõlg” ka siis, kui maksukohustuslasel on otsitava seisu kuupäeval täitmata maksudeklaratsiooni esitamise kohustus ning maksusummat ei ole määranud ka maksuhaldur. (MKS § 14 lg 5).
- Märkus 3: Päringu tulemusel on informatiivne iseloom ning see ei ole käsitletav tõendina MKS § 14 lg 5 tähenduses.
Viimati uuendatud 03.06.2026
