SF1180 Formålet med integrationen er at anvendersystemerne kan abonnere på ændringer i årsopgørelser for en given personkreds fra SKAT via KMD Indkomst. Adviseringerne benyttes i fagsystemet til at generere ændringshændelser for personens skatterelaterede indkomst- og omkostningsgrundlag.

Læs mere i version 2.6.0 af integrationsbeskrivelsen.

For at få adgang til denne service, skal dit it-system være tilknyttet visningsgruppen SKAT i STS Administration. Hvis du ikke kan se servicen i STS Administration, skal du kontakte helpdesk@serviceplatformen.

3.0

Brug af denne service i test- og produktionsmiljøet er indeholdt i buffetprisen, som består af en fast pris for brug af de fleste services på Serviceplatformen.

Læs mere om afregningsmodellen for Serviceplatformen på:

http://www.kombit.dk/indhold/afregning-brug-af-serviceplatformen

Servicens funktion

Fagsystemet vedligeholder en samlet liste (personkreds) over de CPR-numre, der skal indgå i personabonnementer for de kommende forsendelser med adviseringer om ændringer i årsopgørelser fra KMD Indkomst.

Adviseringen om ændringer i årsopgørelsesdata gøres løbende tilgængelig via Beskedfordeleren, når KMD Indkomst modtager ændringerne fra SKAT. Kørslerne udføres periodisk. Planen for dette kan ses på KMD’s kundenet (kræver login).

Servicen dækker ændringer i årsopgørelsen for de tre seneste skatteår.

Servicens datagrundlag

Vedligeholdelse af abonnement:

Input:

Fagsystemet sender en forespørgsel med en personkreds for hver kombination af fagsystem, kommune, sagsområde og funktion. Forespørgslen sendes via et synkront kald til en service udstillet af Serviceplatformen.

Output:

Teknisk accept eller fejl.

Kvitteringer:

KMD Indkomst validerer indberetningen af personabonnementer (personkredsen) ved modtagelsen og svarer tilbage med kvittering eller fejlmeddelelse. Kvitteringerne sendes til fagsystemet via Beskedfordeler. Hændelser i årsopgørelsen:

Adviseringen om ændringer i årsopgørelsesdata og eventuelle fejl ifm. validering af personnumre for det angivne personabonnement gøres løbende tilgængelig via Beskedfordeleren.

Adviseringen om ændringer indeholder den fulde årsopgørelse. Dvs. det er op til fagsystemet at identificere ændringerne ift. forrige version af årsopgørelsen.

Servicens forretningsmæssige kobling til øvrige services

Øvrige services på Serviceplatformen:

Servicen kan benyttes sammen med nedenstående service, hvis man ønsker at hente og gemme gældende version af årsopgørelsen og herefter abonnere på eventuelle ændringer til denne. Servicen giver mulighed for at lave opslag på en persons årsopgørelser for de tre seneste skatteår.

• SF0780 – Årsopgørelse er en opslagsservice.

Beskedfordeleren:

• Beskedfordeleren udstiller hændelser vedr. årsopgørelsen fra KMD Indkomst

• Læs mere om forudsætninger, opkobling og anvendelse af Beskedfordeleren her:

• Integrationsbeskrivelsen afsnit 3.1.4

• Beskedfordeler version 3.1

Servicen er udstillet med følgende sikkerhedmodeller

• SAML – Token

Læs mere om sikkerhedsmodellerne i Serviceplatformen opsætningsguide leverandoerer.

Servicens endpoint er følgende:

• Produktionsmiljøet: https://prod.serviceplatformen.dk/service/KMD/Indkomst/3
• Testmiljøet: https://exttest.serviceplatformen.dk/service/KMD/Indkomst/3

Anvendelse af servicen på testmiljøet

Indledningsvis skal man indgå en serviceaftale via STS Administration.

Læs mere om hvordan der anmodes om serviceaftaler i Brugervejledning til administrationsmodulet.

Åbning og opsætning på testmiljø samt testdata skal bestilles hos KMD.

Anvendelse af servicen på produktionsmiljøet

Følgende forudsætninger skal opfyldes for at kunne anvende servicen i produktion.

• Serviceaftaler og abonnement er konfigureret for modtagelse af oplysninger om årsopgørelser fra Beskedfordeler

Læs mere om Serviceplatformens generelle vilkår for leverandører her.

Læs mere om Serviceplatformens generelle vilkår for kommuner her

Integrationsbeskrivelse | Teknisk Dokumentation | Fejlkoder

a1e8324e-cc5b-4f7a-adc3-9447b8d1c1b8