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.

Ändringar i gränssnitten för EMCS

Obs! På grund av lagändringar i Nederländerna 1.1–13.2.2024 kan DegreePlato inte ges en ölprodukt (B000) när destinationslandet är Nederländerna (NL).

Följande ändringar kommer i gränssnitten för EMCS från och med den 13 februari 2024:

  • IE801 Hämta ett bekräftat e-AD/e-SAD och
  • IE815 Skicka ett utkast till e-AD/e-SAD
    • Mottagarens namn- och adressuppgifter (ConsigneeTrader) krävs när den medlemsstat som hänfört produkterna till exportförfarandet är Finland (DestinationType = 6).
    • DegreePlato kan ges som en valfri uppgift om en ölprodukt (B000) även om destinationslandet inte kräver det.
    • Ett nytt fält för att lämna uppgiften om småproducent (IndependentSmallProducersDeclaration)
      Detta påverkar kraven i de befintliga fälten Ursprungsutredning (DesignationOfOrigin) och Storleken av producenten (SizeOfProducer). Se beskrivningarna av parametrarna.

  • IE813 Skicka en ändring av destination
    • Mottagarens namn- och adressuppgifter (ConsigneeTrader) krävs när den medlemsstat som hänfört produkterna till exportförfarandet är Finland (DestinationType = 6).
  • IE801 Hämta e-AD/e-SAD
    • Ett nytt fält för att lämna uppgiften om småproducent (IndependentSmallProducersDeclaration).

Nya meddelanden som hänför sig till export:

  • IE829–v2 Hämta uppgifter om ett godkännande till exportförfarande:
    • IE829 En ny API-version (version 2) publiceras 13.2.2024.
    • IE829 API-versionen 1 kan inte längre användas från och med 13.2.2024.

När uppgifterna om e-AD har hämtats via APIn IE829–v2 ska meddelandet Har godkänts till exportförfarande bytas till status för e-AD
(när ExportDeclarationAcceptanceOrGoodsReleasedForExport = 0).

När uppgifterna om samma e-AD har hämtats en gång till via APIn IE829–v2 ska statuset för e-AD bytas till Exporting (när ExportDeclarationAcceptanceOrGoodsReleasedForExport = 1). 

  • IE836 Hämta makulering av exportdeklaration för sändningens MSA
    • En ny typ av meddelande har lagts till. Detta meddelande innehåller uppgifter om makulering av exportdeklaration.
    • När uppgifterna om e-Ad har hämtats via APIn IE836 ska statuset för e-AD ändras till Har godkänts och antingen en ny exportdeklaration i tullsystemet, annullering (IE810) eller Ändring av destination (IE813) ska skickas.
  • IE839 Hämta avslag av e-AD för export
    • En ny typ av meddelande har lagts till. Detta meddelande innehåller uppgifter om publikation av exportdeklaration.
    • När uppgifterna om e-Ad har hämtats via APIn IE839 ska statuset för e-AD ändras till Har godkänts och antingen en ny exportdeklaration i tullsystemet, annullering (IE810) eller Ändring av destination (IE813) ska skickas.

Obs! När du får en s.k. notifikation om ett meddelande av typen IE829–v2-, IE836- eller IE839 rekommenderas att du anropa dessa IE829–v2-, IE836- och IE839 Get API-gränssnitt med URI-värdet i meddelandet. Ordna därefter de meddelanden du mottagit från dessa gränssnitt enligt datum och klockslag och uppdatera statuset för e-AD enligt anvisningarna ovan för att fastställa historien och det nuvarande statuset för e-ADn. Använd följande parametrar för att klassificera meddelandena:

  • 9–v2: DateAndTimeOfIssuance
  • IE836: ReturnReceivedDate
  • IE839: DateAndTimeOfIssuance

Beskrivningarna av meddelandena finns i sandlådan: APIn: Details - Vero API Sandbox - developer portal

De nya gränssnitten EMCS-API och ändringarna i de gamla gränssnitten API publiceras på portalen Vero API och i sandlådan Vero API. Där kan du kontrollera bland annat fält och scheman som ändrats.

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 7.2.2024