EMCS-järjestelmän rajapinnat ovat Vero API -rajapintapalvelussa

EMCS-järjestelmä (Excise Movement and Control System) on EU-maiden välillä toimiva sähköinen tiedonvaihtojärjestelmä. Järjestelmällä ilmoitetaan ja valvotaan EU:ssa yhdenmukaistetun valmisteveron alaisten tuotteiden eli alkoholin, alkoholijuomien, tupakan ja nestemäisten energiatuotteiden siirtoja. Yritys ilmoittaa ko. tuotteiden siirrot OmaVerossa tai API-rajapinnan kautta. Suomen sisäisissä siirroissa EMCS:n käyttö ei ole pakollista.

Suorasanoma-asiointi on Json-muodossa

EMCS-järjestelmän asiakasrajapinta on Verohallinnon API -rajapintapalvelussa.
API-rajapinnat ovat reaaliaikaisia Rest API -rajapintoja, joissa sanomamuotona on Json.

EMCS-sanomaliikenne ja tietosisältövaatimukset perustuvat EU-komission tekemiin EMCS-järjestelmän määrityksiin. Vero API -rajapinnat ovat Json-muotoisia.

Lisätietoa EMCS-järjestelmästä ja määrityksistä EU-komission sivuilla.

Käyttöönotossa huomioitavaa

Ennen käyttöönottoa rajapintojen käyttäjän on hankittava tuotantovarmenne. EMCS-rajapintoja käyttävä ohjelmisto pitää rekisteröidä API-portaalissa ja rakentaa ohjelmistoon API-avaimen käsittely. Jos ohjelmistoon otetaan käyttöön uusia EMCS-rajapintoja, ne pitää valita API-portaalissa ja testata siellä ennen käyttöönottoa.

Katso lisätietoja Vero API -rajapintojen käyttöönotosta tuotantoympäristössä.

Rajapintojen kuvaukset

Sanomakuvaukset on julkaistu Vero API -hiekkalaatikossa sekä Vero API-portaalissa. Rajapintojen testiversiot hiekkalaatikossa eivät sisällä rajapinnassa sanomasisältöön liittyvien tarkistussääntöjen validointia. Validoinnit sisältävät testiversiot ovat käytettävissä API-portaalissa julkaistuissa testiosoitteissa.

Notifikaatiopalvelu

Yritys voi ottaa ohjelmistoonsa käyttöön notifikaatiopalvelun (Notification Service API). Notifikaatiopalvelun avulla yritys saa tiedon saapuneista EMCS-sanomista. Notifikaatio sisältää avaintiedot, jonka perusteella ohjelmisto voi hakea varsinaiset EMCS:ään liittyvät tietosisällöt.

Notifikaatiot haetaan kyselyrajapinnasta

Ohjelmiston pitää kysellä notifikaatiopalvelussa notifikaatioita Verohallinnon rajapinnasta, sillä notifikaatiopalvelu ei ensimmäisessä vaiheessa lähetä tiedotteita ilman saapuvaa kyselyä. Helmikuussa 2024 palveluun on tulossa push notifikaatio -toiminto, jonka avulla ohjelmisto saa automaattisesti uusimmat notifikaatiot EMCS:stä.

Notifikaatiopalvelun kuvaukset on julkaistu Vero API -hiekkalaatikossa.

API-koodistot

EMCS-API -rajapinnoissa käytettävät koodistot voi hakea API-koodistot -rajapinnan kautta. Koodistorajapintaan voi tutustua Vero API -hiekkalaatikossa. API-koodistot löytyvät kategoriasta: General > Codes. Koodistot on julkaistu Vero API-hiekkalaatikossa ja API-portaalissa: Koodistot - API-portaali (vero.fi)

API-avain

Ohjelmistotalon tai ohjelmiston kehittäjän on rekisteröitävä rajapintoja käyttävä ohjelmisto Vero API -portaalissa. Ohjelmistokohtaista API-avainta edellytetään myös EMCS-rajapinnoissa käyttäjäkohtaisen varmenteen lisäksi. API-avain asetetaan rajapintakutsuissa vero-softwarekey-headeriin. 

Lisätietoa:

• EMCS-järjestelmä
• Mikä on Valmisteveron alaisten tuotteiden siirtojärjestelmä (EMCS)?
• Lisätietoa EMCS-järjestelmästä ja määrityksistä EU-komission sivuilla
• Lisätietoa EU-komission tekemistä EMCS-järjestelmän määrityksistä: Download the latest version of FESS