Falska meddelanden har skickats ut i Skatteförvaltningens namn. Läs mer om falska meddelanden.

Gränssnitten för EMCS är i gränssnittstjänsten Vero API

EMCS (Excise Movement and Control System) är ett elektroniskt system för utbyte av information mellan EU-länder. EMCS används för att anmäla och övervaka flyttningar av produkter som omfattas av den i EU harmoniserade punktskatten, det vill säga alkohol, alkoholdrycker, tobak och flytande energiprodukter. Företaget anmäler flyttningar av produkterna i MinSkatt eller via gränssnittet API. Det är inte obligatoriskt att använda EMCS när det gäller flyttningar inom Finland.

Direkt meddelandedeklarering är i Json-format

Gränssnittet för EMCS är i Skatteförvaltningens gränssnittstjänst API.
API-gränssnitten är Rest API-gränssnitt i realtid med meddelandeformatet Json.

EMCS-meddelandetrafiken och datainnehållskraven baserar sig på de specifikationer för EMCS som EU-kommissionen gjort. Gränssnitten Vero API har Json-format.

Mer information om EMCS och specifikationerna finns på EU-kommissionens webbplats (på engelska).

Att observera vid ibruktagandet

Innan gränssnitten börjar användas ska användaren skaffa sig ett produktionscertifikat. Programmet som använder gränssnitten för EMCS ska registreras i API-portalen och behandlingen av API-nyckeln ska byggas upp i programmet. Om nya gränssnitt för EMCS tas i bruk i programmet ska de väljas i API-portalen och testas där före ibruktagandet.

Läs mer information om att börja använda gränssnitten Vero API i produktionsmiljön.

Beskrivning av gränssnitten

Meddelandebeskrivningarna har publicerats i sandlådan Vero API och i portalen Vero API. Testversionerna av gränssnitten i sandlådan innehåller inte valideringar av de kontrollregler i gränssnittet som hänför sig till meddelandeinnehållet. Testversionerna som innehåller valideringar kan användas på testadresserna som publicerats i portalen API.

Meddelandetjänsten

De som använder gränssnitten kan ta i bruk meddelandetjänsten (Notification Service API). Med hjälp av meddelandetjänsten får de som använder gränssnittet uppgifter om EMCS meddelanden som kommit till företaget. Ett meddelande innehåller nyckeluppgifterna utifrån vilka gränssnittsanvändaren kan hämta det egentliga informationsinnehållet som hänför sig till EMCS.

Meddelandena hämtas från gränssnittet för förfrågan

Det går att begära meddelanden från Skatteförvaltningens gränssnitt i meddelandetjänsten, eftersom meddelandetjänsten inte i första fasen skickar meddelanden utan en inkommande begäran. I februari 2024 får tjänsten den så kallade push notifikation-funktionen med vars hjälp meddelandena från EMCS fås automatiskt.

De första meddelandebeskrivningarna har publicerats i sandlådan Vero API.

API-koduppsättningarna

De koduppsättningar som används i gränssnitten EMCS-API kan hämtas via gränssnittet API-koduppsättningar. Du kan bekanta dig med gränssnittet för koduppsättningar i Vero API-sandlådan. API-koduppsättningarna finns i kategorin: General > Codes. Koduppsättningarna har publicerats i sandlådan Vero API och i portalen API: Koduppsättningar - portalen API

API-nyckeln

Programvaruhuset eller programutvecklaren ska i portalen Vero API registrera det program som använder gränssnitten. En programspecifik API-nyckel förutsätts också i gränssnitten för EMCS utöver det användarspecifika certifikatet. API-nyckeln placeras i vero-softwarekey-headern i gränssnittsanropet.

Ytterligare information:


Sidan har senast uppdaterats 10.4.2025