Info edastamine EMCS infosüsteemi XML-faili abil

Faili edastamine toimub järgmiselt.

  1. 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
  2. Ettevõtte volitatud kasutaja logib e-teenuste keskkonna e-MTA kaudu infosüsteemi: Maksud – Aktsiisid – ELi aktsiisikaupade saatelehed (EMCS).
  3. Kasutaja valib menüüst „Lisa eSL XMLina".
  4. Kasutaja valib menüüst „Impordi vastuvõtuteade XML-ist".
  5. Kasutaja näitab XML-faili asukohta ning käivitab selle importimise.
  6. Süsteem täidab XML-faili alusel eSL lahtrid ning saateleht esitatakse kontrolliks, juhul kui see läbib edukalt kontrolli, see esitatakse.
  7. eSL loetakse esitatuks, kui sellele on omistatud ARC.

Kasutusjuhendid ja juhised

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

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.

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.

Taotlust esitama

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 (tegemisel).
Info RIA nõusolekuteenuse kohta leiate RIA kodulehelt. Nõusolekuteenuse kohta käivate küsimuste korral kirjutage palun help@ria.ee.

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 teenindusabi@emta.ee.

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.

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

Klassifikaatorite haldamise süsteemi (KHS) eesmärgiks on pakkuda Maksu- ja Tolliameti (MTA) uutele infosüsteemidele ja avalikkusele MTA tegevusvaldkonnas tarvilikke klassifikaatoreid ühtsest kontaktpunktist.

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 dokumentatsioonis.

Masin-masin liidese kirjeldusega seotud dokumendid

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

tehniline kirjeldus

MTA X-tee teenuse uploadMime.v1

tehniline kirjeldus

operationAccepted.xsd
operationRejected.xsd

XML faili formaadi kirjeldusega seotud dokumendid

Süsteemi Käibedeklaratsioon (KMD) XML-formaadi kirjeldus

XML Schema

(alates 01.08.2022)

XML Schema

(uuendatud veebruaris 2017)

XML näidisfail

(alates 01.08.2022)

XML näidisfail

(uuendatud veebruaris 2017)

XML näidisfail (käibemaksugrupp)

(alates 01.08.2022)

XML näidisfail (käibemaksugrupp)

(uuendatud veebruaris 2017)

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)

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:

  • Registrikood või isikukood
  • Käibemaksukohustuslase nimi
  • Esindusisiku kood
  • Esindusisiku nimi
  • KMKR number
  • Kohustuse perioodi number
  • Kohustuse alguskuupäev
  • Kohustuse lõppkuupäev
  • Registreerimise otsuse kuupäev
  • Registrist kustutamise otsuse kuupäev


 

Masin-masin liidese kirjeldusega seotud dokumendid

KKS klassifikaatorid v1.2

Täiendavad klassifikaatorid: Parafiinne DK/EDK

ja Diislikütus B30/EDK B30

(alates 16.08.2019)

KKS ärivead v1.4

KKS X-tee teenuste kirjeldus v1.4
KKS kande CSV failiformaadid v1.2
KKS X-tee liides v1.5
KKS tankla müük CSV failiformaadid v1.1
Kütuse kannete teenused v1.2
Kütuse vastuvõtuteate teenused v1.1
Näidissõnumid v1.7
KKS kande XML-näidisfailid
Planeeritud vedude teenused v1.4
Tanklast müügi koondkannete teenused v1.0
Teenustes kasutatavad andmestruktuurid v1.3
KKS WSDL-fail

KKSi näidisfail

Kütuse käitlemise andmekogu vastavusdokumentide süsteem (VDS)

Biokütuse tarneandmete aruandluse esitamine

Biokütuse tarneandmete aruandluskohustuse

täitmise kasutusjuhend

LAAKi kasutusjuhend

LAAKi koondaruannete esitamise juhend

Sisse- ja väljamineku erijuhtude

rakendamine

LAAKi X-tee teenuse juhised

Täiendavad klassifikaatorid

alates 16.08.2019

LAAKi X-tee teenuse XML-näited

Eelnevate, alus- ja täiendavate

dokumentide selgitus

eelnevad_jargnevad_ja_alusdokumendid_05.10.21.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

XML-formaadis failid

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 

Kaupade andmeid saab edastada masin-masin liidese (X-tee) kaudu.

NES X-tee spetsifikatsioon

vers 4, 07.07.2021

NES X-tee spetsifikatsioonide lisad

05.10.2020

NES X-tee WSDLid

05.05.2021 (ALD teenuse muudatus)
 

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
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 ics2.hd@emta.ee.

  1. Süsteemi nimetus ja võimalusel selle konkreetne teenus/funktsionaalsus, kus esineb probleem/viga.
  2. Vea saamise aeg (kuupäev/kellaaeg)
  3. Konkreetne viga/kood
  4. Kui viga saadakse kliendi veebirakenduses, siis ekraanitõmmis, kus on näha ka aadressiriba ja aeg ning viga.
  5. Kui viga saadakse X-tee teenust kasutades, siis saadetav request sõnum ja vastu saadav response (kui saadakse), XML-vormingus.
  6. Info kriitilisuse kohta (kas takistab nt tööd või ainult häirib, vmt)
  7. Pöörduja kontakt (e-posti aadress, telefoninumber)

Reklaamimaksu deklaratsioon

Kehtib alates 01.01.2020

Reklaamimaksu deklaratsiooni

elektroonilise faili struktuur

Kehtib alates 01.01.2020

Deklaratsiooni esitamise videojuhend

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

NCTS4

MTA X-tee liidese spetsifikatsioon

(versioon 6)

emta-x-tee-liides-v6.pdf

X-tee TolliOperatsioon v.6

xteetollioperatsioon.wsdl

NCTSi funktsionaalsete spetsifikatsioonide

üldtutvustus (Functional transit

system specification)

NCTSi funktsionaalsete spetsifikatsioonide

põhiprotsesside kirjeldus

(Functional transit system specification)

NCTSi funktsionaalsete spetsifikatsioonide

andmemudel ja sõnumite struktuur

(Functional transit system specification)

NCTSi koodiloendid (Codelists)

NCTSi tehnilised spetsifikatsioonid

(Technical specifications for NCTS)

Specification of X-Road Interface of ETCB
NCTSi uuendatud koodiloend
NCTSi S-koodiga vead

NCTS seostabel sisestusväljad

<-> XML-i tagid

Kliendi töölaualt formeeritava XMLi struktuur

IE15 tagide ja NCTS süsteemi siseste

tagide seosetabel

Tegevusjuhis ettevõttele tolli infosüsteemide

masin-masin liidese testide teostamiseks

NCTS X-tee testsenaariumid
NCTS X-road test scenarios

TSD üldised dokumendid

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)

TSD xml näide

(alates 01.01.2023)

TSD xml näide

(alates 01.01.2022)

TSD CSV-formaadi struktuur | docx

(alates 01.01.2023)

TSD CSV-formaadi struktuu | docx

(alates 01.01.2022)

TSD CSV näide 1 

(alates 01.01.2023)

TSD CSV näide 2

(alates 01.01.2023)

Pankadele hoiuseintresside deklareerimiseks alates 01.01.2018

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

MTA X-tee teenuse uploadMime.v1 tehniline kirjeldus

uploadmime.wsdl

confirmTsd teenuse struktuuri kirjeldus
confirmTsd.wsdl
getTsdStatus teenuse struktuuri kirjeldus

getTsdStatus.wsdl

getTsdFeedback teenuse struktuuri kirjeldus
getTsdFeedback.wsdl

TSD pangaliides

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

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)

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 03.10.2022

Kas sellest lehest oli abi?