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.
Eksternt testmiljø
Endpoint: https://exttest.serviceplatformen.dk/service/DUPLALogbog_1
UUID: bd8f51f3-2c67-4220-9511-7967f9c94e5a
EntityId: http://entityid.kombit.dk/service/duplalogbog/1
Produktionsmiljø
Endpoint: https://prod.serviceplatformen.dk/service/DUPLALogbog_1
UUID: bd8f51f3-2c67-4220-9511-7967f9c94e5a
EntityId: http://entityid.kombit.dk/service/duplalogbog/1
Formål
Formålet med API'et er at udstille oplysninger vedrørende pensionsrettigheder fra Integrationsplatformen DUPLA.
Beskrivelse
Anvender kan ved hjælp af en aftale i DUPLA Aftalemodul specificere de nødvendige felter i forhold til det konkrete anvendelsesformål. API'et returnerer udelukkende de felter til serviceanvender, som er specificeret i aftalen.
Der udstilles det komplette datasæt fra kildesystemet. Dette omfatter dog kun forretningsdata og ikke tekniske data. Servicen tilbyder også adgang til historiske data, men hvis dette ikke specifikt tilvælges, leveres kun nyeste angivelse.
Korrekthed:
- Servicen udstiller kun validerede data.
Aktualitet:
- Data hentes direkte i kildesystemet, hvilket betyder, at der er direkte adgang til de nyeste data.
Strukturen af data ændres hvert år i takt med at skattelovgivningen ændrer sig. Der vil derfor hvert år være ændringer i servicens indhold, der som regel vil bestå af tilføjelse af data.
Som anvender af servicen skal man derfor være indstillet på, at servicen er genstand for et ”årsrul”, hvor der kan blive tilføjet flere felter til servicesvaret. Alle data er dog valgfri i den forstand, at de til- og fravælges i den profil, der opsættes for en anvender i samarbejde med Udviklings- og forenklingsstyrelsen (UFST), og man vil derfor kun modtage felter, der er i overensstemmelse med den opsatte profil, og altså nye uventede felter. I den forstand er servicen bagudkompatibel.
Eksternt testmiljø
Endpoint: https://exttest.serviceplatformen.dk/service/DUPLAPensionsrettigheder_1
UUID: 393f36da-9b8e-4557-8fad-e5febaa74858
EntityId: http://entityid.kombit.dk/service/sp/duplapensionsrettigheder/1
Produktionsmiljø
Endpoint: https://prod.serviceplatformen.dk/service/DUPLAPensionsrettigheder_1
UUID: 393f36da-9b8e-4557-8fad-e5febaa74858
EntityId: http://entityid.kombit.dk/service/sp/duplapensionsrettigheder/1
Formål
Formålet med API'et er at udstille oplysninger vedrørende selvstændige virksomheder fra Integrationsplatformen DUPLA.
Beskrivelse
Anvender kan ved hjælp af en aftale i DUPLA Aftalemodul specificere de nødvendige felter i forhold til det konkrete anvendelsesformål. API'et returnerer udelukkende de felter til serviceanvender, som er specificeret i aftalen.
Strukturen af data ændres hvert år i takt med at skattelovgivningen ændrer sig. Der vil derfor hvert år være ændringer i servicens indhold, der som regel vil bestå af tilføjelse af data.
Som anvender af servicen skal man skal derfor være indstillet på, at servicen er genstand for et ”årsrul”, hvor der kan blive tilføjet flere felter til servicesvaret. Alle data er dog valgfri i den forstand, at de til- og fravælges i den profil, der opsættes for en anvender i samarbejde med Udviklings- og forenklingsstyrelsen (UFST), og man vil derfor kun modtage felter, der er i overensstemmelse med den opsatte profil, og ikke nye uventede felter. I den forstand er servicen bagudkompatibel.
Eksternt testmiljø
Endpoint: https://exttest.serviceplatformen.dk/service/DUPLASelvstændigVirksomhedOplysninger_1
UUID: 4c4c598c-b7a9-47c7-b87d-f28adb74db6b
EntityId: http://entityid.kombit.dk/service/sp/duplaselvstaendigvirksomhedoplysninger/1
Produktionsmiljø
Endpoint: https://prod.serviceplatformen.dk/service/DUPLASelvstændigVirksomhedOplysninger_1
UUID: 4c4c598c-b7a9-47c7-b87d-f28adb74db6b
EntityId: http://entityid.kombit.dk/service/sp/duplaselvstaendigvirksomhedoplysninger/1
Formål
Med beskedservicen kan gyldige skattekort for en borger hentes af myndighedens fagsystem via Beskedfordeleren. I perioden nær et årsskifte modtages skattekort for både indeværende og kommende år i separate beskeder.
Ønsker myndigheden at modtage skattekort som push-beskeder, kan servicen eSkattekortBeskedModtag anvendes.
Beskrivelse
Servicen videresender beskeder til myndigheders fagsystemer med skattekort i XML-format fra SKATs eIndkomst. Endpoint benyttes af fagsystemerne i forbindelse med modtagelse af skattekort.
Beskeden indeholder:
- CPR-nummer for borgeren
- SE-nummer for indkomstforholdet (udbetalende virksomhed/myndighed)
- Type af skattekort
- Trækprocent uden lønindeholdelse
- Trækprocent med lønindeholdelse (ved gældsinddrivelse via SKAT)
- Fradrag (dag/uge/14 dage/måned)
Formål
Med beskedservicen pushes gyldige skattekort for en borger til myndighedens fagsystem via Beskedfordeleren. I perioden nær et årsskifte modtages skattekort for både indeværende og kommende år i separate beskeder.
Ønsker myndigheden at modtage skattekort som pull-beskeder, kan servicen eSkattekortBeskedHent anvendes.
Nyt i denne version
Første majorversion
Beskrivelse
Servicen videresender beskeder til myndigheders fagsystemer med skattekort i XML-format fra SKATs løsning eIndkomst. Endpoint benyttes af fagsystemerne i forbindelse med modtagelse af skattekort.
Beskeden indeholder:
- CPR-nummer for borgeren
- SE-nummer for indkomstforholdet (udbetalende virksomhed/myndighed)
- Type af skattekort
- Trækprocent uden lønindeholdelse
- Trækprocent med lønindeholdelse (ved gældsinddrivelse via SKAT)
- Fradrag (dag/uge/14 dage/måned)
Eksternt testmiljø
Endpoint: amqp://beskedfordeler.eksterntest-stoettesystemerne.dk:5671
Produktionsmiljø
Endpoint: amqp://beskedfordeler.stoettesystemerne.dk:5671
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
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
Formål
Filservicen gør det muligt at overføre logningsinformation til Serviceplatformen.
Beskrivelse
For uddybning af servicen se den vedhæftede dokumentation.
Formål
Formålet med filservicen er, at fagløsninger kan levere et ikke-standardiseret dataudtræk med ledelsesinformation til en kommune eller andre af kommunens fagløsninger via Serviceplatformens SFTP-komponent.
Beskrivelse
Dataudtrækket er individuelt aftalt, men fagløsninger kan have valgt at offentliggøre specifikationer, som i så fald vil være tilgængelige i bilagspakken i dokumentationen.
Formål
Formålet med filservicen er, at en kommune eller andre af kommunens fagløsninger kan afhente et ikke-standardiseret dataudtræk med ledelsesinformation fra en af kommunens fagløsninger via Serviceplatformens SFTP-komponent.
Beskrivelse
Dataudtrækket er individuelt aftalt, men fagløsninger kan have valgt at offentliggøre specifikationer, som i så fald vil være tilgængelige i bilagspakken i dokumentationen.