Implementeringsvejledningen forklarer, hvordan virksomheder kan integrere egne systemer med EMCS via business-to-business (B2B) webservices. Integrationen til Skattestyrelsen gennem B2B webservices er rettet mod de virksomheder, som medvirker i mange forsendelser enten som vareafsender eller varemodtager eller i begge roller.

Vejledningen beskriver, hvordan de B2B webservices, som EMCS stiller til rådighed, skal anvendes. Implementeringsvejledningen beskriver hvilke B2B webservices der findes, i hvilke scenarier disse skal anvendes og hvordan de kaldes rent teknisk.

Målgruppe

Implementeringsvejledningens indhold henvender sig primært til en læser med en IT baggrund, og som minimum har et overordnet kendskab til, hvordan webservices fungerer. Viden omkring de lovmæssige krav og procedurer, der findes omkring afsendelse og modtagelse af punktafgiftspligtige varer, er også en fordel.

Introduktion til vejledningen

EMCS kan tilgås via den tilgængelige web portal, men også via såkaldte business-to-business (B2B) webservices. Disse B2B webservices giver en virksomhed muligheden for at integrere deres nuværende it-systemer direkte til EMCS. Denne integration kan være en fordel for en virksomhed, som eksporterer og/eller importerer en betydelig mængde punktafgiftspligtige varer inden for EU, da data kan sendes direkte mellem virksomhedens IT-system og EMCS. Dette åbner muligheden for at kunne se information fra EMCS i virksomhedens IT-system og at tilføje funktionalitet til virksomhedens IT-system til at kunne sende information omkring en forsendelse direkte til EMCS.

Nuværende version 3.17 er gældende fra 13. februar 2020. Se ændringsloggen her.

EU har defineret et antal funktionelle beskeder kaldt "Information Exchange" (IE) som beskriver de data som udveksles med EMCS. Hver IE-besked har fået tildelt et nummer. Fx når en virksomhed ønsker at sende data for et udkast til et ledsagedokument, skal den indsende den information som svarer til den funktionelle besked med navnet IE815. Hver IE-beskeds struktur og indhold er defineret i en XSD fil. Dataindholdet som er specificeret i de forskellige XSD filer er de data som bliver udvekslet i de forskellige B2B webservices. Fx når en virksomhed ønsker at oprette et udkast til et ledsagedokument, så skal den kalde B2B webservicen med navnet OIOLedsageDokumentOpret, og de data OIOLedsageDokumentOpret forventer at modtage, skal overholde det den funktionelle besked IE815 specificerer. Indholdet af SOAP-beskeden som sendes til B2B webservicen er illustreret i følgende figur:

 

SOAP besked som sendes til B2B webservicen


Scenariebeskrivelser (PDF) Dokumentet beskriver i hvilke scenarier de forskellige B2B webservices skal kaldes samt hvilke IE beskeder de forventer at modtage eller de anvender som svar. Felter som ligger ud over IE beskederne er også forklaret i dette dokument.

Indholdet af de forskellige funktionelle beskeder og hvordan disse er bygget op er beskrevet i de følgende tre dokumenter:

  • Beskrivelse af struktur og design (engelsk) Dette dokument indeholder generel information omkring hvordan de funktionelle beskeder er bygget op samt hvilke krav der er til indholdet af beskederne. Indholdet er på engelsk, da det stammer fra EU's dokumentation.
  • Oversigt over beskedstruktur Dette regneark indeholder alle de funktionelle beskeder og giver en oversigt over alle de felter som hvert enkel besked indeholder. For hvert felt er der også en tilhørende dansk oversættelse samt en beskrivelse af feltets indhold.
  • Tekniske kodeliste og Forretningskodeliste Kodelisterne kan slås op i disse to dokumenter. I oversigten over beskedstruktur er der en kolonne med navnet CODELIST. De felter, som har et nummer stående i den kolonne, kan kun indeholde et prædefineret sæt af værdier. Nummeret refererer til en såkaldt kodeliste, som indeholder listen af de prædefinerede værdier. Nummeret kan enten starte med TC eller BC. Hvis nummeret starter med TC, kan værdien findes i dokumentet med de tekniske kodelister. Hvis nummeret starter med BC skal nummeret først slås op i en tabel i den tekniske kodeliste, hvor navnet på kodelisten kan findes. Navnet på kodelisten kan så slås op i dokumentet med forretnings kodelister. Fx hvis der står "BC66", så kan der ved at slå op i tabellen på side fem i dokumentet med de tekniske kodelister ses, at "BC66" svarer til "Excise Product Categories". Derefter kan man slå "Excise Product Categories" op i dokumentet med forrentningskodelisterne.

B2B-webservicen er tilgængelig i to miljøer. Det ene er et testmiljø hvor kald af B2B webservices kan foretages uden at dette resulterer i, at reelle ledsagedokumenter bliver oprettet. Det andet er produktionsmiljøet, der indeholder de B2B webservices som virksomhedens endelig system skal anvende.  

Den tekniske vejleding består af følgende referencer, der alle henviser til dokumentation og kildekode, der udstilles på Skattestyrelsens GitHub-konto:

 emcs-b2b-ws som indeholder:

  • WSDL-filer - Dette afsnit indeholder WSDL filer for de 22 web services
  • XSD-filer - Alle de nødvendige XSD filer for at kunne forme korrekte IE beskeder. Der findes én XSD fil per IE besked
  • Fejlkoder - De fejl som man kan modtage i HovedOplysningSvar
  • Beskrivelse af sikkerhedsregler for anvendelse af services, herunder gyldigt SOAP request og response
  • Server-certifikater for test- og produktionssystemet
  • Information om test- og produktionscertifikater.

emcs-b2b-ws-test-data som indeholder information om det testdata, som er tilgængeligt og kan anvendes til test.

Derudover har Skattestyrelsen udviklet følgende to sample klienter, som viser hvorledes det kan gøres i Java og i .NET vha. WSE 3.0 frameworket (disse klienter vises kun som eksempler, og der ydes ikke support på dem):

Java

.NET klient

For at kunne køre disse to klienter er det nødvendigt med en "Systems Integrator"-pakke, som udleveres af Toldstyrelsen Servicedesk.

Som udgangspunkt bør al nødvendig information for at kunne forstå anvendelsen af B2B webservices kunne findes i implementeringsvejledningens andre dokumenter. Derfor er DDNEA'en og FESS'en kun tilgængelig i tilfældet af, at der ønskes en større forståelse af systemets design. Det kan dog forekomme, at enkelte særregler skal slås op i disse to dokumenter.

DDNEA

Dette er EU's designdokument for EMCS kaldet "Design Document for National Excise Applications" (DDNEA). Dokumentet beskriver de designretningslinjer, som de enkelte medlemslandes punktafgiftssystemer skal overholde.

DDNEA (Word filer)
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_A1_202-EN
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_A2_202-EN
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_B_202-EN
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_C_202-EN
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_D_202-EN
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_E_202-EN
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_F_202-EN
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_G_202-EN
APPENDIX H DIRECTORY WITH XML SCHEMAS (XSDS) – se teknisk vejledning ovenfor
APPENDIX I DIRECTORY WITH WEB SERVICE INTERFACE DEFINITIONS (WSDLS) – se teknisk vejledning ovenfor
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_J_202-EN
ECP3-FITSDEV3-SC05-DDNEA_P3_APP_K_202-EN
ECP3-FITSDEV3-SC05-DDNEA_P3-v2.02-EN FESS


Dette er EU's dokument, som beskriver de funktionelle specifikationer for EMCS kaldet "Functional Excise System Specification" (FESS).

FESS (Word filer)
ECP1-ESS-FESSv3.91-0-CoverPage
ECP1-ESS-FESSv3.91-1-SECTION I GENERAL INTRODUCTION
ECP1-ESS-FESSv3.91-2-SECTION II CORE BUSINESS
ECP1-ESS-FESSv3.91-3-SECTION III SEED
ECP1-ESS-FESSv3.91-4-SECTION IV FOLLOW-UP AND COLLABORATION
ECP1-ESS-FESSv3.91-5-SECTION V SYSTEM ADMINISTRATION
ECP1-ESS-FESSv3.91-6-EXECUTIVE SUMMARY
ECP1-ESS-FESSv3.91-Appendix A-AVAILABILITY AND PERFORMANCE REQUIREMENTS
ECP1-ESS-FESSv3.91-Appendix B-LIST OF CODES
ECP1-ESS-FESSv3.91-Appendix D-FUNCTIONAL MESSAGES
ECP1-ESS-FESSv3.91-Appendix E-USER PROFILES
ECP1-ESS-FESSv3.91-Appendix H
ECP1-ESS-FESSv3.91-Appendix J-BUSINESS RULES CATALOGUE