Gå til hovedindhold
Webservice / Serviceplatformen
DUPLALogbog

Formål

Formålet med servicen at oprette, opdatere, slette og hente data for en arbejdstager i den digitale logbog.

Beskrivelse

Følgende dataområder understøttes af servicen:

- Arbejdstagere:
Paths, der gør det muligt for virksomheder at oprette, opdatere, slette og hente data for en arbejdstager i den digitale logbog. Arbejdsgiveren skal dagligt foretage registreringer over beskæftigede, både lønnet og ulønnet, i virksomheden med oplysninger om navn, CPR.nr., arbejdstider og løn.

- Arbejdstidsangivelse:
Paths, der gør det muligt for virksomheder at oprette, rette, slette og hente data for en arbejdsdagsangivelse i den digitale logbog. Arbejdsgiveren skal dagligt foretage registreringer over beskæftigede, både lønnet og ulønnet, i virksomheden med oplysninger om navn, CPR.nr., arbejdstider og løn.

- Dagsoversigt:
Path, der gør det muligt for virksomheder at hente dagsoversigt over arbejdstidsangivelser (grupperet på arbejdstager) og/eller nuldagsangivelse(r).

- GDPRAdministration:
Paths, der gør det muligt at fremsøge, skjule og slette data vedrørende en arbejdstager, som er oprettet i en virksomheds digitale medarbejderlogbøger. En myndighed kan pålægge en virksomhed en logbogspligt, som indebærer, at arbejdsgiveren dagligt skal foretage registreringer over beskæftigede, både lønnet og ulønnet, i virksomheden med oplysninger om navn, CPR.nr., arbejdstider og løn. Servicen muliggør, at myndigheden kan pålægge denne logbogspligt og ydermere opdatere slette og hente logbogspligter.

- Logbogskontrol:
Paths, der gør det muligt for en myndighed at oprette og hente data for kontrolbesøg af de virksomheder, som er pålagt logbogspligten. Arbejdsgiveren skal dagligt foretage registreringer over beskæftigede, både lønnet og ulønnet, i virksomheden med oplysninger om navn, CPR.nr., arbejdstider og løn.

- Logbogspligter:
Paths, der gør det muligt for en myndighed at oprette, opdatere, slette og hente data for en logbogspligt. En myndighed kan pålægge en virksomhed en logbogspligt, som indebærer at arbejdsgiveren dagligt skal foretage registreringer over beskæftigede, både lønnet og ulønnet, i virksomheden med oplysninger om navn, CPR.nr., arbejdstider og løn. Servicen muliggør, at myndigheden kan pålægge denne logbogspligt og ydermere opdatere slette og hente logbogspligter.

- Nuldagsangivelser:
Paths, der gør det muligt for en virksomhed at oprette og slette en nuldagsangivelse i den digtale logbog.

- ValiderCPRNummer:
Path, der gør det muligt at validere CPRnummer i CPR-registret, når en arbejdstager bliver oprettet i Digital Logbog.

Webservice / Serviceplatformen
eSkattekortService

Formål

Servicen er en synkron webservice, hvormed et anvendersystem kan hente oplysninger om skattekort fra SKATs løsning eIndkomst.

Beskrivelse

Et anvendersystem forespørger på oplysninger om skattekort ved kald af service på Serviceplatformen, som gennemstiller kaldet fra fagsystemet til SKATs løsning eIndkomst. eIndkomst svarer synkront på kaldet til Serviceplatformen, som gennemstiller kaldet fra eIndkomst til fagsystemet.

Anvendersystemet identificerer sig med det SE-nr. som ansættelsesforholdet er oprettet under. Herudover medgives personnummer for borgeren, samt periode man ønsker at hente et skattekort for. Det er også muligt at hente en liste med skattekort fra en dato og frem til det aktuelle gyldige skattekort.

Output er:
- Skattekort eller liste af skattekort. Skattekort kan være hoved- eller bi-kort.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/SKAT/eSkattekort/2

UUID: 47d79e13-02cf-42f3-ad7e-2654b2a70427

EntityId: http://skat.serviceplatformen.dk/service/eskattekort/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/SKAT/eSkattekort/2

UUID: 47d79e13-02cf-42f3-ad7e-2654b2a70427

EntityId: http://skat.serviceplatformen.dk/service/eskattekort/2

Webservice / Fælleskommunalt Klassifikationssystem
FacetService

Formål

Servicen anvendes til at arbejde med enkeltobjekter af typen "Facet".
Servicen udstiller otte OIO-operationer.

Beskrivelse

Med servicesystemrollen ”Udstil” kan operationerne List, Læs og Soeg benyttes:

- List tager flere objekt-UUID’er som input og returnerer objekternes egenskaber. Objekters ændringer kan tilvælges.
- Læs tager et objekt-UUID som input og returnerer objektets egenskaber. Objekters ændringer kan tilvælges.
- Soeg tager et eller flere søgekriterier som input og returnerer de objekt-UUID’er, der matcher kriterierne.

Med servicesystemrollen ”Rediger” kan operationerne Importer, Opret, Passiver, Ret og Slet benyttes:

- Importer tager et objekts egenskaber inkl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Importeret” og returnerer en status.
- Opret tager et objekts egenskaber ekskl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Oprettet” og returnerer en status og et objekt-UUID.
- Passiver tager et objekt-UUID som input, ændrer objekts livscyklustilstand til ”Passiveret” og returnerer en status.
- Ret tager et objekts egenskaber inkl. objekt-UUID som input, opdaterer objektets egenskaber og returnerer en status.
- Slet tager et objekt-UUID som input, ændrer objektets livscyklustilstand til ”Slettet” og returnerer en status.

Servicen anvender følgende sikkerhedsmodel:
SAML Token

Eksternt testmiljø

Endpoint: https://klassifikation.eksterntest-stoettesystemerne.dk/facet/7

Produktionsmiljø

Endpoint: https://klassifikation.stoettesystemerne.dk/facet/7

Formål

Servicen anvendes til at arbejde med enkeltobjekter af typen "Facet".
Servicen udstiller otte OIO-operationer.

Beskrivelse

Med servicesystemrollen ”Udstil” kan operationerne List, Læs og Soeg benyttes:

- List tager flere objekt-UUID’er som input og returnerer objekternes egenskaber. Objekters ændringer kan tilvælges.
- Læs tager et objekt-UUID som input og returnerer objektets egenskaber. Objekters ændringer kan tilvælges.
- Soeg tager et eller flere søgekriterier som input og returnerer de objekt-UUID’er, der matcher kriterierne.

Med servicesystemrollen ”Rediger” kan operationerne Opret, Importer, Passiver, Ret og Slet benyttes:

- Opret tager et objekts egenskaber ekskl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Oprettet” og returnerer en status og et objekt-UUID.
- Importer tager et objekts egenskaber inkl. objekt-UUID som input, skaber objektet med livscyklustilstand ”Importeret” og returnerer en status.
- Passiver tager et objekt-UUID som input, ændrer objekts livscyklustilstand til ”Passiveret” og returnerer en status.
- Ret tager et objekts egenskaber inkl. objekt-UUID som input, opdaterer objektets egenskaber og returnerer en status.
- Slet tager et objekt-UUID som input, ændrer objektets livscyklustilstand til ”Slettet” og returnerer en status.

Servicen anvender følgende sikkerhedsmodel:
SAML Token

Eksternt testmiljø

Endpoint: https://klassifikation.eksterntest-stoettesystemerne.dk/facet_6

Produktionsmiljø

Endpoint: https://klassifikation.stoettesystemerne.dk/facet_6

Webservice / Serviceplatformen
FakturaInformationAfsend

Formål

Formålet med servicen er at give et faktureringssystem mulighed for at oversende en elektronisk faktura til et fagsystem til behandling og eventuel godkendelse eller afvisning.

Servicen indgår i et asynkront integrationsmønster med FakturaInformationSvarAfsend, hvor fagsystemet kan sende et svar på fakturabehandlingen.

Beskrivelse

For uddybning af integrationen se den vedhæftede dokumentation.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/OIR/FakturaInformationAfsend/1

UUID: 68b85457-8219-4677-a213-79f4253158c7

EntityId: http://oir.serviceplatformen.dk/service/fakturainformationafsend/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/OIR/FakturaInformationAfsend/1

UUID: 68b85457-8219-4677-a213-79f4253158c7

EntityId: http://oir.serviceplatformen.dk/service/fakturainformationafsend/1

Webservice / Serviceplatformen
FakturaInformationSvarAfsend

Formål

Formålet med servicen er at give et fagsystem mulighed for at godkende eller afvise en tidligere oversendt faktura. Fagsystemet har i forbindelse med godkendelse mulighed for at lave en posteringsanvisning af fakturaens elementer.

Servicen indgår i et asynkront integrationsmønster med FakturaInformationAfsend, hvori faktureringssystem har sendt den oprindelige faktura til fagsystemet.

Beskrivelse

For uddybning af integrationen se den vedhæftede dokumentation.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/OIR/FakturaInformationSvarAfsend/1

UUID: e26289f7-1c9f-439c-ae27-aee05313da55

EntityId: http://oir.serviceplatformen.dk/service/fakturainformationsvarafsend/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/OIR/FakturaInformationSvarAfsend/1

UUID: e26289f7-1c9f-439c-ae27-aee05313da55

EntityId: http://oir.serviceplatformen.dk/service/fakturainformationsvarafsend/1

Webservice / Serviceplatformen
FeriekontoOplysningerService

Formål

Servicen giver mulighed for at lave et opslag på en persons feriekontooplysninger.

Beskrivelse

Servicens input omfatter:
- Personnummer
- En periode (angivet med to datoer, begge datoer indgår i perioden)

Servicen returnerer følgende information for den angivne periode per udbetaling:
- Dato (for ferieanmodning)
- Personnummer
- Første feriedag (i den ønskede ferieperiode)
- Antal feriedage (i den ønskede ferieperiode)
- Beløb pr. udbetalingsdato (til udbetaling)
- Aktuelt ferieår på udbetalingen
- Saldo feriepenge (i aktuelt ferieår på udbetalingen)
- Saldo feriedage (i aktuelt ferieår på udbetalingen)
- Dispositionsdato/udbetalingsdato/Dato for anmodningstidspunkt/Dato for modtagelse af data
- Udbetalingsårsag
- Status (fejlmeddelelser)
- Før skat indikator (optionelt felt)

Personnummer, Ferieår, Saldo feriepenge og Saldo feriedage oplyses, selv når der ikke er fundet nogen udbetalingsdato på personen i FerieKonto i den forespurgte periode.

Perioden må ikke stække sig længere tilbage end 20 måneder fra den dato, der forespørges på. Tidligst mulige dato er dog den 1. maj 2011.

Servicen er udstillet med SAML-token (Liberty Basic SOAP Binding) og gennemstiller til ATP Feriekonto via Serviceplatformen.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/ATP/FeriekontoOplysninger/2

UUID: bc8cb034-94b5-4814-ae0a-c74db223c986

EntityId: http://atp.serviceplatformen.dk/service/feriekontooplysninger/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/ATP/FeriekontoOplysninger/2

UUID: bc8cb034-94b5-4814-ae0a-c74db223c986

EntityId: http://atp.serviceplatformen.dk/service/feriekontooplysninger/2

Webservice / Serviceplatformen
IndbetalingTilbageførOrdreAfsend

Formål

Denne service benyttes af debitorsystemer til at beordre et fagsystem til at tilbageføre en tidligere foretagen indbetaling på en fordring, der er blevet nedreguleret (krediteret).

Beskrivelse

For uddybning af servicen se den vedhæftede dokumentation.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/OIR/IndbetalingTilbagefoerOrdreAfsend/1

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/OIR/IndbetalingTilbagefoerOrdreAfsend/1

Webservice / Serviceplatformen
IndkomstAbonnementVedligehold

Formål

Synkron webservice, der giver mulighed for at vedligeholde abonnement på CPR-nr. for borgere, der ønskes indkomstoplysninger på.

Beskrivelse

Denne version vil på Serviceplatformen blive omstillet/mappet til ny version af service hos eIndkomst. Anvendere skal ikke foretage sig noget i forbindelse med omstillingen.

Servicen (SOAP) bruges af et anvendersystem til at vedligeholde abonnement ved at opdatere en liste over borgere, der ønskes at modtages Indkomstoplysninger for. Liste vedligeholdes ved at oprette eller nedlægge et CPR-nr.

For at kunne tilgå listen, skal anvenderen identificere sig med SE-nr. og abonnementskode. Abonnementskode er givet ved den abonnementsaftale, der er indgået med SKAT, og reflekterer den lovhjemmel, hvormed kontroloplysninger hentes.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/SKAT/IndkomstAbonnementVedligehold/2

UUID: f0b8072c-b1f7-49f0-b2da-3e243578394d

EntityId: http://skat.serviceplatformen.dk/service/indkomstabonnementvedligehold/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/SKAT/IndkomstAbonnementVedligehold/2

UUID: f0b8072c-b1f7-49f0-b2da-3e243578394d

EntityId: http://skat.serviceplatformen.dk/service/indkomstabonnementvedligehold/2

Webservice / Serviceplatformen
IndkomstOplysningIndberetService

Formål

Webservicen giver mulighed for at levere enkeltindberetninger af ansættelses-/indkomstforhold og indkomst fra en myndigheds fagsystem til SKATs eIndkomst.

Nyt i denne version

Servicen opdateret til at være udstillet med sikkerhedsmodellen Liberty Basic SOAP Binding (LBSB).

Beskrivelse

En anvender af servicen kan levere en indberetning for én borger via en SOAP-serviceoperation. Indberetningerne transformeres til en dataforsendelse, der kan afsendes via MQ til SKAT.

Servicen er udstillet med følgende sikkerhedsmodel:
- SAML-Token med Liberty Basic SOAP binding

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/SKAT/IndkomstOplysningIndberet/2

UUID: 17beeccc-6b60-4a55-b37d-d3f6aaea2fa0

EntityId: http://skat.serviceplatformen.dk/service/indkomstoplysningindberet/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/SKAT/IndkomstOplysningIndberet/2

UUID: 17beeccc-6b60-4a55-b37d-d3f6aaea2fa0

EntityId: http://skat.serviceplatformen.dk/service/indkomstoplysningindberet/2

Webservice / Serviceplatformen
IndkomstOplysningVirksomhedAbonnentBestil

Formål

Servicen giver mulighed for at bestille indkomstoplysninger indberettet af en eller flere indberetningspligtige (lønudbetalere, fx A-kasser) for en eller flere juridiske personer for en given periode.

Nyt i denne version

- æ-, ø-, å-tegn i strukturer- og elementnavne, erstattes med ae, oe, aa
- Æ-, Ø-, Å-tegn i strukturer- og elementnavne, erstattes med AE,OE, AA
- SEnummerIdentifikator ændrer navn til VirksomhedSENummerIdentifikator

Beskrivelse

Servicen bruges af et anvendersystem til at fremsøge indkomstoplysninger indberettet af et eller flere SE-nr. i en given periode.

For at kunne anvende servicen, skal anvenderen identificere sig med et SE-nr. og abonnementskoder.

Abonnementskoder udstedes af Skatteforvaltningen efter indgåelse af en skriftlig aftale med kommunen, baseret på et legitimt behov og tilstrækkelig lovhjemmel.

Eksternt testmiljø

Endpoint: https://exttest.serviceplatformen.dk/service/SKAT/IndkomstOplysningVirksomhedAbonnentBestil/2

Produktionsmiljø

Endpoint: https://prod.serviceplatformen.dk/service/SKAT/IndkomstOplysningVirksomhedAbonnentBestil/2