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