XML-vormingus failid
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
AES X-tee liides v.1.0 zip | 1,7 MB 21.12.2023 |
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 |
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 |
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 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
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 |
|
Andmekoosseis |
|
Profiilide lõikes andmekoosseis | |
Sõnumite XSD | |
X-tee sõnumite ülevaade | |
X-tee sõnumite näidised | |
X-tee veateated | |
Impulss.wsdl | |
Impulss reeglid seisuga 31.08.2022 |
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õtame kasutusel Unireg süsteemi (Universaalne register), mis saab olema 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 KHS-is.
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 KHS-i)
- CL016 - EU.CUSCODE
- CL141 - EU.CUSTOMS_OFFICES
- CL244 - EU.UN_LOCODE_EXTENDED
Dokumendid
Üldised dokumendid
Süsteemi Käibedeklaratsioon (KMD) andmekoosseis | pdf (alates 01.01.2024) |
Süsteemi Käibedeklaratsioon (KMD) andmekoosseis | pdf |
Süsteemi Käibedeklaratsioon (KMD) klassifikaatorid | pdf (alates 01.01.2024) |
Süsteemi Käibedeklaratsioon (KMD) klassifikaatorid | pdf |
Süsteemi Käibedeklaratsioon (KMD) reeglid | pdf (alates 01.01.2024) |
Süsteemi Käibedeklaratsioon (KMD) reeglid | pdf |
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.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.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.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.01.2024) |
Süsteemi Käibedeklaratsioon (KMD) CSV-formaadi kirjeldus | pdf (alates 01.08.2022 kuni 31.12.2023) |
KMD CSV näidisfail vatdeclaration_example4.csv (alates 01.01.2024) |
KMD CSV näidisfail vatdeclaration_example3.csv (alates 01.08.2022 kuni 31.12.2023) |
CSV näidisfail (käibemaksugrupp) vatdeclaration_group_example4.csv (alates 01.01.2024) |
CSV näidisfail (käibemaksugrupp) vatdeclaration_group_example3.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 esitamise juhend |
|
Sisse- ja väljamineku erijuhtude rakendamine |
|
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 | |
Eelnevate, alus- ja täiendavate dokumentide selgitused |
eelnevad_jargnevad_ja_alusdokumendid_09.10.2023.xlsx |
Laoarvestuse andmestik (muu kaup) | |
Koondaruande struktuur (muu kaup) | |
Koondaruande XML-skeem (saldo, muu kaup) |
|
Koondaruande XML-skeem (tehing, muu kaup) |
|
Koondaruande kannete XML-näidis (muu kaup) |
|
Koondaruande saldo XML-näidis (muu kaup) |
|
LAAK veateated ja veakoodid | |
Sisse- ja väljamineku erijuhtude rakendamine (muu kaup) |
|
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
- Ajatatud
- Ajatatud summa
- Ajatamise tagatis
- Ajakava lõppkuupäev
- Vaidlustatud
- Tasumisgraafikus
- Vanim võlg
- 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
nap_liides.xsd |
|
napTeenus.wsdl |
XML faili formaadi kirjeldusega seotud dokumendid
Masin-masin liidese kirjeldusega seotud dokumendid
Kaupade andmeid saab edastada masin-masin liidese (X-tee) kaudu.
NES X-tee spetsifikatsioon vers 6, 30.06.2023 | pdf |
NES X-tee WSDLid 05.11.2021 seisuga (lisandusid ELi saadetiste WSDLid) |
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 |
updatePresentationNotificationRequest.v1 | PN muutmine |
revokeReceptaclePresentationNotification | Postikoti PN tühistamin |
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 |
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 |
sadhes_x-tee_spetsifikatsioon_ver1.5.5.zip |
SADHES klassifikaatorid X-tee ver. 1.5.4 | sadhes_klassifikaatorid.csv |
Saatelehe töötlemise talitlusreeglid | saatelehe_tootlemise_talitlusreeglid_20180614.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 |
NCTS5
NCTS5 X-tee liides v.1.1 | 1,6 MB | zip 05.02.2024 |
EL NCTS P5 tehnilised spetsifikatsioonid |
TSD üldised dokumendid
(alates 01.01.2023) |
(alates 01.01.2022) |
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.2023) |
TSD lisa 2 väljamakseliikide tabel | xlsx (alates 01.01.2022) |
TSD XML- ja CSV-formaadi kirjeldusega seotud dokumendid
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.2023) |
TSD XML-formaadi struktuur | xsd (alates 01.01.2022) |
(alates 01.01.2023) |
(alates 01.01.2022) |
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) |
XF 11 XML näide |
(alates 01.01.2023) |
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 |
Töötamise registreerimine e-MTAs CSV-formaadis
Töötamise registreerimine, peatamine ja muutmine masin-masin liidesega TOOTREG
Töötamise registri kannete allalaadimise teenuse TORRGNO
Töötamise klassifikaatorid
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. otsitava seisu kuupäev
Märkus 1: Kuupäev, mille suhtes maksuvõla puudumise asjaolu kontrollida soovitakse.
Märkus 2: Maksuvõla puudumise või olemasolu kontrollimise kuupäev saab olla kuni kolm aastat varasem kui päringu tegemise kuupäev, st päringut saab teha kuni kolme aasta vanuse seisu kohta.
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 19.03.2024