Gå til hovedindhold
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

Beskedservice / Fælleskommunal Beskedfordeler
IndkomstindberetningBeskedHent

Formål

Med beskedservicen kan et anvendersystem modtage indkomsthændelser via Beskedfordeler (push) for enkelte borgere fra SKAT.

Beskrivelse

Servicen leverer de indkomstoplysninger, der er indgået abonnementsaftale med SKAT om. Indkomstoplysninger modtages i beskeder via pull/AMQP fra Beskedfordeler, og er opdelt pr. indberetning, hvilket bl.a. betyder, at der kan modtages flere indberetninger på et CPR-nr./SE-nr. i løbet af et døgn.

Indkomstoplysninger leveres i Beskeddata (Base64) som fastlængde format records i tekst. Den indgåede abonnementsaftale afgør hvilke indkomstoplysninger, der kan modtages.

Beskedservice / Fælleskommunal Beskedfordeler
IndkomstindberetningBeskedModtag

Formål

Med beskedservicen kan et anvendersystem modtage indkomsthændelser via Beskedfordeler (pull) for enkelte borgere fra SKAT.

Beskrivelse

Servicen leverer de indkomstoplysninger, der er indgået abonnementsaftale med SKAT om. Indkomstoplysninger modtages i beskeder via push/Rest fra Beskedfordeler, og er opdelt pr. indberetning, hvilket bl.a. betyder, at der kan modtages flere indberetninger på CPR-nr./SE-nr. i løbet af et døgn.

Indkomstoplysninger leveres i Beskeddata (Base64) som fastlængde format records i tekst. Den indgåede abonnementsaftale afgør hvilke indkomstoplysninger, der kan modtages.

Eksternt testmiljø

Endpoint: amqp://beskedfordeler.eksterntest-stoettesystemerne.dk:5671

Produktionsmiljø

Endpoint: amqp://beskedfordeler.stoettesystemerne.dk:5671

Filservice / Serviceplatformen
IndkomstoplysningerModtag

Formål

Med filservicen modtages et samlet udtræk over borgere, der indgår i abonnement og har haft indkomstændringer siden seneste udtræk.

Beskrivelse

Servicen leverer de indkomstoplysninger, der er indgået abonnementsaftale med SKAT om. Indkomstoplysninger modtages i en fil via SFTP. Filen leveres én gang i døgnet og indeholder de indkomstoplysninger, som eIndkomst har modtaget siden seneste fil blev afsendt.

Filen leveres mellem kl. 00.00 og 05.00 afhængig af belastningen hos eIndkomst, og indeholder typisk mange registreringer af indkomstoplysninger, og kan også indeholder forskellige indkomstindberetninger for samme borger.

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

Webservice / Fælleskommunalt Organisationssystem
InteressefaellesskabService

Formål

Servicen giver et kommunalt fagsystem mulighed for at hente eller opdatere organisationsdata vedrørende domæneområdet ”Interessefaellesskab” i Organisation.

Beskrivelse

Servicen indeholder i alt 8 operationer, der kan deles op i to kategorier:
- 5 operationer, der ændrer i objekter (importer, opret, passiver, ret og slet)
- 3 operationer, der ikke ændrer i objekter (list, laes og soeg)

Yderligere beskrivelse af input- og outputparametre for de 8 operationer af forretningsobjektet Organisation, finder du i dokumentationen.

Servicen er udstillet med følgende sikkerhedsmodel:
- SAML-Token

Eksternt testmiljø

Endpoint: https://organisation.eksterntest-stoettesystemerne.dk/organisation/interessefaellesskab/6/

Produktionsmiljø

Endpoint: https://organisation.stoettesystemerne.dk/organisation/interessefaellesskab/6/

Webservice / Fælleskommunalt Organisationssystem
ItSystemService

Formål

Servicen giver et kommunalt fagsystem mulighed for at hente eller opdatere organisationsdata vedrørende domæneområdet ”ItSystem” i Organisation.

Beskrivelse

Servicen indeholder i alt 8 operationer, der kan deles op i to kategorier:
- 5 operationer, der ændrer i objekter (importer, opret, passiver, ret og slet)
- 3 operationer, der ikke ændrer i objekter (list, laes og soeg)

Yderligere beskrivelse af input- og outputparametre for de 8 operationer af forretningsobjektet Organisation, finder du i dokumentationen.

Servicen er udstillet med følgende sikkerhedsmodel:
- SAML-Token

Eksternt testmiljø

Endpoint: https://organisation.eksterntest-stoettesystemerne.dk/organisation/itsystem/6/

Produktionsmiljø

Endpoint: https://organisation.stoettesystemerne.dk/organisation/itsystem/6/

Webservice / Fælleskommunalt Klassifikationssystem
KlasseService

Formål

Servicen anvendes til at arbejde med enkeltobjekter af typen "Klasse".
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/klasse/7

Produktionsmiljø

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

Formål

Servicen anvendes til at arbejde med enkeltobjekter af typen "Klasse".
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/klasse_6

Produktionsmiljø

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