Teknisk information – EMCS

Automatisering av inlämningen av EMCS-uppgifter

Halvautomatisk inlämning med hjälp av filuppladdning

I e-tjänsten EMCS finns det möjlighet att skapa ett nytt administrativt dokument genom att ladda upp en fil från den egna datorn. Filen ska vara i xml-format och följa ett av EU fastställt xml-schema. En sådan xml-fil kan lämpligen produceras av företagets affärs- eller transportadministrationssystem eftersom uppgifterna som ska anges i det administrativa dokumentet borde vara tillgängliga där. Hur filens innehåll ska se ut beskrivs under rubriken "Automatisk inlämning med hjälp av Web Services", eftersom formatet och reglerna är desamma.

Automatisk inlämning med hjälp av "Web Services"

Skatteverket tillhandahåller en "Web Service", EmCbEcopWS, med nio metoder för registrering av EMCS-uppgifter:

• Inlämning av elektroniskt administrativt dokument (e-AD)
• Inlämning av mottagningsrapport
• Hämtning av e-AD
• Hämtning av lista över ARC-nummer för öppna inkommande e-AD:er
• Annullering av e-AD
• Omdestinering av e-AD
• Kontroll av e-AD ·
• Kontroll av mottagningsrapport
• Kontroll av uppdelning av e-AD
• Uppdelning av e-AD                 

För samtliga metoder finns svenska specifikationer, men den huvudsakliga dokumentationen är specifikationer som har tagits fram centralt inom EU, funktionsspecifikation (FESS) och designspecifikation (DDNEA). Där finns dels användningsfall som beskriver hur indata fylls i och vilka kontroller som sker av datan, dels detaljerade beskrivningar av alla meddelanden som skickas till och från systemet (DDNEA, Appendix D). Observera att där specifikationerna anger "does not apply", innebär det att det svenska systemet betraktar det som "får inte förekomma". Värt att notera är även att de elektroniska administrativa dokumenten först benämndes "e-AAD" (electronic accompanying administrative document) och senare "e-AD" (electronic administrative document) och att båda dessa benämningar förekommer om vartannat i specifikationerna.

• DDNEA version 3.14 (giltig till och med 2026-02-11) zip, 10 MB.
• DDNEA version 3.23 (giltig från och med 2026-02-12) zip, 6 MB.
• FESS version 4.12 (giltig till och med 2026-02-11) zip, 21 MB.
• FESS-version 4.22 (giltig från och med 2026-02-12) zip, 16 MB.

Svenska specifikationer

• Automatisering version 3.1.1 - svenska (giltig till och med 2026-02-11) zip, 168 kB.
• Automatisering version 3.2 – svenska (giltig från och med 2026-02-12) zip, 3 MB.

I automatiseringsspecifikationerna refereras till två olika typer av kodlistor, "technical code lists" och "business code lists". De tekniska koderna finns i xml-schemana (DDNEA appendix H), och kan alltså inte ändras med mindre än att nya versioner av schemana börjar användas. Verksamhetskoderna däremot, kan ändras av EU när som helst och distribueras ut till medlemsstaterna.

Skatteverket tillhandahåller aktuella listor över gällande verksamhetskoder här:

• Lista över KN-nummer
• Lista över produktkoder
• Lista över övriga verksamhetskoder

Testmiljö

Testmiljön är från och med den 15 september 2025 anpassad för den version av meddelandena som börjar användas den 12 februari 2026.

Organisationslegitimation i EMCS

I e-tjänsten EMCS legitimerar man sig med en elektronisk legitimation. Det kan antingen vara en personlig e-legitimation eller en organisationslegitimation. En organisationslegitimation, som kan användas i EMCS, kan även kallas organisationscertifikat utan personangivelse eller serverlegitimation. För närvarande är det bara Expisoft som ger ut dessa.

• Till Expisoft

Fördelarna med att använda organisationslegitimationen är att man slipper att ansöka om behörighet för varje anställd och att samma behörigheter går att återanvända när man vill titta på uppgifter eller registrera mottagningsrapport i e-tjänsten EMCS, om man använder "Web Services" för att skicka in uppgifter.

För användning av organisationslegitimation i e-tjänsten måste företaget ha en proxy-server som sköter identifieringen mot Skatteverket.

Företaget som har organisationslegitimationen, som ska användas i EMCS, ska ansöka om tillstånd att använda legitimationen i EMCS  på blankett Anmälan organisationslegitimation i EMCS (SKV 5382).

• Ladda ner blankett Anmälan organisationslegitimation i EMCS (SKV 5382)

På blanketten förbinder företaget sig att:

• Inte någon användare av organisationslegitimationen har direkt åtkomst till dess privata nyckel
• Inte använda organisationslegitimationen i fel sammanhang
• Spärra organisationslegitimationen i enlighet med utfärdarens regelverk
• Logga vilken användare som använder organisationslegitimationen vid varje tillfälle
• Spara loggar över organisationslegitimationens användning i minst 10 år

Organisationslegitimationen får man inte lagra på en PC eller importera i PC:ns certifikatregister. Den måste ligga skyddad på en proxy-server och det är bara systemadministratören som får känna till dess PIN-kod.

Så går ett anrop till i e-tjänsten EMCS

• När den anställde anropar e-tjänsten EMCS hos Skatteverket, ska anropet gå till så här:

Den anställdes PC

• Anropar emcsproxy.foretagA.se

Företag A:s proxy-server

• Tar reda på att emcsproxy.foretagA.se betyder Skatteverkets e-tjänst EMCS: https://www7.skatteverket.se/portal/emcs/?proxy=<URL till företagets EMCS-proxy-server>
• Loggar vilken person det är som sitter vid PC:n
• Anropar e-tjänsten EMCS och identifierar sig med organisationslegitimationen.

Skatteverkets e-tjänst EMCS

• Kontrollerar att organisationslegitimationen är giltig.
• Kontrollerar att företaget har tillstånd att använda organisationslegitimation i EMCS.
• Tar reda på vilket eller vilka punktskattenummer som organisationsnumret i legitimationen får agera för.

Så går ett anrop till i e-tjänsten EMCS mottagningsrapport

Företaget ser till så att den anställde förses med en länk till EMCS nya e-tjänst hos Skatteverket, där adressen till företagets EMCS-proxy-server finns med enligt https://www7.skatteverket.se/portal/emcs/mottagningsrapport/?proxy=<URL till företagets EMCS-proxy-server>, till exempel

https://www7.skatteverket.se/portal/emcs/mottagningsrapport/?proxy=https:// emcsproxy.foretagA.se/some/path

URL-koda EMCS-proxy-URL:en vid behov.

Den anställdes klientenhet - till exempel PC

• Anropar länken ovan. Då hämtas e-tjänstens frontend och därefter anropar den (från den anställdes klientenhet) automatiskt den URL som angivits i query-parametern ”proxy” för att påbörja en inloggning.

Företagets proxy-server

• Ser till att endast företagets behöriga användare tillåts anropa proxy-servern
• Loggar vilken person det är som sitter vid klientenheten
• Skickar vidare klientenhetens anrop till Skatteverkets inloggningstjänst med URL https://sysorgoauth2.skatteverket.se/oauth2/v1/sysorg/token och identifierar sig med företagets organisationslegitimation i TLS-förhandlingen.
• Skickar svaret från inloggningstjänsten tillbaka till anropande klientenhet

Skatteverkets inloggningstjänst

• Begär att den anropande proxyservern legitimerar sig med organisationslegitimation
• Kontrollerar att organisationslegitimationen är giltig
• Returnerar identifieringsuppgifter som behövs i den fortsatta bearbetningen

Den anställdes klientenhet

• Tar emot svaret från företagets EMCS-proxy-server
• Anropar Skatteverkets e-tjänst EMCS och skickar med identifieringsuppgifterna

Skatteverkets e-tjänst EMCS

• Kontrollerar att företaget har tillstånd att använda organisationslegitimation i EMCS.
• Tar reda på vilket/vilka punktskattenummer som organisationsnumret i legitimationen får agera för.

Möjlighet att dela server

Under förutsättning att man väljer en teknisk lösning som klarar de krav som ställs på ansökningsblankett SKV 5382, har Skatteverket inga ytterligare synpunkter på vilken proxy-server man ska införskaffa eller hur den ska konfigureras. Skatteverket tillhandahåller inget tekniskt stöd för val eller framtagande av densamma.

Under förutsättning att man klarar de krav som ställs på ansökningsblankett SKV 5382, finns inte heller något hinder mot att dela server. Personal som får företräda företag A får förstås endast kunna nyttja organisationslegitimationen för företag A, och personal som får företräda företag B endast organisationslegitimationen för företag B.

Kontaktformulär för support

Har du frågor som rör "web services"-gränssnittet eller uppladdningsfilen? Fyll i vårt kontaktformulär så återkommer vi till dig.