1005.17.35 eIndkomst og årsopgørelser fra DUPLA
Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning
STAR Projektleder (PL) | Forretningsanalytiker (FA) | STAR Release | STAR Release | STAR Release | Epic status | Eksterne snitflader |
---|---|---|---|---|---|---|
@Knud de Place (STAR) @Jens Andersen | @Carsten Olsen (@Rolf Marcher Arndt ) | 2025-3 | 2025-3 | 2025-3 | 0.3 | Ingen eksterne snitflade berørt |
Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)
Anvendes ved ændringer, der har betydning for eksterne.
Dato | Version | Hvem | Hvad er ændret? |
---|---|---|---|
14-10-2022 | 0.1 | Carsten Olsen | Oprettelse |
10-04-2024 | 0.3 | Carsten Olsen | Indeholde tilpasse, service og forretningsside opdateret (0.3 version dog ikke godkendt af STAR / @Knud de Place (STAR) |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/KON-771
https://starwiki.atlassian.net/browse/BI-5232
Indholdsfortegnelse
- 1 Versionshistorik af betydning for eksterne (v0.1, v0.3, v0.5 og v1.0)
- 2 Indholdsfortegnelse
- 3 Afgrænsning af epic
- 4 Oversigt over berørte webservices
- 5 Beskrivelse af epic
- 5.1 Baggrund
- 5.2 Regler
- 5.3 Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer
- 5.4 1005.17.35.1 - Som STAR vil jeg have flytte forretningsområde DUPLA (tidligere Generel UdstillingsLøsning (GUL)) og eIndkomst til forretningsdomænet (silo) EksterneData inkl. at det lever op til de principper der er fastsat
- 5.5 1005.17.35.2 - Som serviceaftager og STAR vil jeg have udstillet data fra DUPLA og eIndkoms via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service
- 5.5.2
- 5.5.3 GetBorgersAarsopgoerelse (GET /v1/borgersAarsopgoerelse/{indkomstAar})
- 5.5.4 GetBorgersIndkomst (GET /v1/borgersIndkomst/{indkomstAar})
- 5.5.5 GetBorgersIndkomstDetaljeret (GET /v1/borgersIndkomst/{indkomstAar}/detaljeret)
- 5.5.6 GetBorgersIndkomst (GET /v1/borgersIndkomst/{indkomstAar}/summeret)
- 5.5.7 GetVirksomhedIndkomst (GET /v1/virksomhedIndkomst/{indkomstAar}/summeret)
- 5.5.8 GetMedarbejderIndkomst (GET /v1/medarbejderIndkomst)
- 5.6 1005.17.35.3 - Som serviceaftager vil jeg gerne beholde de eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade
- 5.6.2
- 5.6.2.1 GetPersonAnnualTaxStatements
- 5.6.2.2 GetPersonIncomeTypeInformation
- 5.6.2.3 GetPersonIncomeTypeInformationDetail
- 5.6.2.4 GetPersonIncomeSummary
- 5.6.2.5 GetCompanyIncomeSummary
- 5.6.2.6 GetPersonEmploymentInformation
- 5.7 1005.17.35.4 - Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til nye forretningsdomæne (silo)
- 5.8 1005.17.35.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet
- 5.9 1005.17.1.10 Død kode i DFDG classic, i forbindelse med DUPLA (tidligere Generel UdstillingsLøsning (GUL)) og eIndkomst, fjernes
- 5.10 1005.17.1.11 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i EksterneData, i stedet for TaxService
- 5.11 1005.17.X.6 - Som STAR vil jeg have data er omfattet af dataløft og pseudonymisering mod testmiljøer
- 6 Særlige krav til test
- 7 Konsekvenser for drift/idriftsættelse
- 8 Arkitektur- og implementeringsnoter
- 9 Husk GDPR stillingtagen
- 10
Afgrænsning af epic
Afgrænsning | |||
---|---|---|---|
Som serviceaftager og STAR vil jeg have løftet servicesnifladerne for DUPLA (GUL) og eIndkomst fra SKAT til REST som en del af STAR's moderniseringsprogram for at sikre at DFDG lever op til STARs principper omkring en moderne og vedligeholdelsesvenlig IT-portefølje samt udfaser end of life teknologi. | |||
Acceptkriterier | |||
Nr. | Beskrivelse | Relevant for | US |
1005.17.35.1 | Som STAR vil jeg have flyttet forretningsområderne DUPLA (tidligere Generel UdstillingsLøsning (GUL)) og eIndkomst til forretningsdomænet (silo) Eksterndata inkl. at det lever op til de principper, der er fastsat | BI (Plan på vegne af BI) | |
1005.17.35.2 | Som serviceaftager og STAR vil jeg have udstillet data fra DUPLA og eIndkomst via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service | BI (Plan på vegne af BI) | |
1005.17.35.3 | Som serviceaftager vil jeg gerne beholde de eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksibel overgang til nye snitflader | BI (Plan på vegne af BI), Jobsearch | |
1005.17.35.4 | Som STAR vil jeg have DUPLA dataleverancer i forhold til DOA tilpasset til det nye forretningsdomæne (silo) | BI, Plan | |
1005.17.35.5 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | BI (Plan på vegne af BI) | |
1005.17.35.6 | Død kode i DFDG, i forbindelse med DUPLA (GUL) og eIndkomst fra SKAT, fjernes | BI (Plan på vegne af BI) | |
1005.17.35.7 | Landssupport/LSS er skiftet over til at brug den nye REST-servicen i https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4357128193 , i stedet for TaxService fra DFDG classic | BI (Plan på vegne af BI) | |
1005.17.35.8 | Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer | BI (Plan på vegne af BI) |
|
Pakke SKAT-1 i DFDG roadmap
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
N/A intern epic |
|
|
|
Oversigt over berørte webservices
Manuel oversigt som er synlig for eksterne
Links i listen virker kun med STAR Jira konto og kan derfor ikke tilgås af eksterne. Links under Summary indeholder ikke andre oplysninger relevant for eksterne end hvad der fremgår i tabellen.
N/A intern epic
Automatisk oversigt
Ikke synlig for eksterne, men indeholder ikke andre oplysninger end kopieret til den manuelle oversigt ovenfor.
Beskrivelse af epic
Baggrund
Her udfylder PO oplysninger om baggrund for epic'en, herunder fx om der ligger politisk aftale eller lovgivning bag. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.
Som en del af DFDG's udfasning af end of life teknologier og STAR's moderniseringsprogram sker der i forhold til DUPLA og eIndkomst følgende:
I DFDG et skift til REST snitflade - og i denne epic uden samtidige forretningsmæssige ændringer
I Jobnet en overgang til ny REST snitflade samt ny frontend arkitektur (denne opgave er ikke en del af denne epic, men vil blive specificeret i en efterfølgende epic)
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
Det er ingen indberetningsregler i denne epic, da der alene er tale om GET metoder.
Forventet påvirkning af jobcenter-, a-kasse- eller ydelsessystemer
Her beskriver PO overordnet, hvordan epic'en forventes at påvirke aftagerne. Særligt vigtigt, at dette fremgår, hvis det ikke fremgår i en overliggende ISB, hvortil der evt. kan henvises.
N/A intern epic
1005.17.35.1 - Som STAR vil jeg have flytte forretningsområde DUPLA (tidligere Generel UdstillingsLøsning (GUL)) og eIndkomst til forretningsdomænet (silo) EksterneData inkl. at det lever op til de principper der er fastsat
Løsningsmodel (internt STAR acc.kr.)
Etablering af gateway til SKATs DUPLA og eIndkomst fra EksterneData
Der er ingen data eller database i DFDG på disse data, da det er kald til SKAT
1005.17.35.2 - Som serviceaftager og STAR vil jeg have udstillet data fra DUPLA og eIndkoms via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service
Løsningsmodel (internt STAR acc.kr.)
Ny REST service og getmetode i EksterneData
Fejlkoder bevares
Der ændres ikke i adgangsforhold til service/metoder
https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4357193729
Ny REST service til udstillings af DUPLA (tidligere Generel UdstillingsLøsning (GUL)) og eIndkomst.
GetBorgersAarsopgoerelse (GET /v1/borgersAarsopgoerelse/{indkomstAar})
Erstatter GetPersonAnnualTaxStatements
Metoden henter informationer fra en borgers årsopgørelser for et indkomstår
GetBorgersIndkomst (GET /v1/borgersIndkomst/{indkomstAar})
Erstatter GetPersonIncomeTypeInformation
Metoden henter informationer fra eIndkomst for en given borger og indkomstår
GetBorgersIndkomstDetaljeret (GET /v1/borgersIndkomst/{indkomstAar}/detaljeret)
Erstatter GetPersonIncomeTypeInformationDetail
Metoden henter detaljerede informationer fra en borgers indkomstoplysning (oplysningsseddel) fra eIndkomst udstilling
GetBorgersIndkomst (GET /v1/borgersIndkomst/{indkomstAar}/summeret)
Erstatter GetPersonIncomeSummary
Metoden henter borgers summerede indkomstoplysninger grupperet på virksomheder fra eIndkomst udstilling
GetVirksomhedIndkomst (GET /v1/virksomhedIndkomst/{indkomstAar}/summeret)
Erstatter GetCompanyIncomeSummary
Metoden henter virksomhedens summerede oplysninger fra eIndkomst udstilling
GetMedarbejderIndkomst (GET /v1/medarbejderIndkomst)
Erstatter GetPersonEmploymentInformation
Bemærk: Denne servicemetode indtil videre afkoblet ift. den bagvedliggende eIndkomst service. Dvs. den kan kaldes, men returnerer ingen data. Dette skyldes at der kan returneres oplysninger af uhensigtsmæssig karakter. Se 961.15 Bedre datadeling i ungeindsatsen - ibrugtagning af ny eIndkomstservice så man kan se den unges tidligere arbejdsgiver for udbedring af disse uhensigtsmæssighedder. Udbedringen er ikke en del af moderniseringen i epic 1005.17.35 eIndkomst
Metoden henter informationer om beskæftigelse fra eIndkomst for en given borger og indkomstår
Forretningsregler (ingen ændringer)
Det er kun borgere i alderen 15 til 30 år der kan hentes data på.
Der hentes ansættelser 10 år tilbage, dog hentes ikke data fra før borgeres 15 års fødselsesdato
1005.17.35.3 - Som serviceaftager vil jeg gerne beholde de eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade
Løsningsmodel (internt STAR acc.kr.)
Eksisterende SOAP bevares uændret og kalder fortsat direkte mode DUPLA (tidligere Generel UdstilllingsLøsning (GUL)) og eIndkomst.
Der er ingen grund til at lave SOAP-REST konverter, da der bare kaldes videre til SKAT (vi gemmer ikke de hentede data i DFDG).
TaxService (2023-1)
Udgår til fordel for https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4357193729 . Servicen bevares som SOAP snitflade i en overgangsperiode til og med 2025-2, da der ikke forventes ændringer i den periode.
GetPersonAnnualTaxStatements
Erstattes af GetBorgersAarsopgoerelse (GET /v1/borgersAarsopgoerelse/{indkomstAar})
GetPersonIncomeTypeInformation
Erstattes af GetBorgersIndkomst (GET /v1/borgersIndkomst/{indkomstAar})´
GetPersonIncomeTypeInformationDetail
Erstattes af GetBorgersIndkomstDetaljeret (GET /v1/borgersIndkomst/{indkomstAar}/detaljeret)
GetPersonIncomeSummary
Erstattes af GetBorgersIndkomst (GET /v1/borgersIndkomst/{indkomstAar}/summeret)
GetCompanyIncomeSummary
Erstattes af GetVirksomhedIndkomst (GET /v1/virksomhedIndkomst/{indkomstAar}/summeret)
GetPersonEmploymentInformation
Erstattes af GetMedarbejderIndkomst (GET /v1/medarbejderIndkomst)
Bemærk: Denne servicemetode indtil videre afkoblet ift. den bagvedliggende eIndkomst service. Dvs. den kan kaldes, men returnerer ingen data. Dette skyldes at der kan returneres oplysninger af uhensigtsmæssig karakter. Se 961.15 Bedre datadeling i ungeindsatsen - ibrugtagning af ny eIndkomstservice så man kan se den unges tidligere arbejdsgiver for udbedring af disse uhensigtsmæssighedder. Udbedringen er ikke en del af moderniseringen i epic 1005.17.35 eIndkomst
1005.17.35.4 - Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til nye forretningsdomæne (silo)
Løsningsmodel (internt STAR acc.kr.)
Der er ingen Initial load af data / Tilpasning af BI load til EksterneData domænet (silo)
Masseopdateringsbatchjob BI anvender ift. at hente årsopgørelser i DUPLA flyttes af Plan
BI afhenter DUPLA leverance til DOA, dvs. i via nyt masseopdateringsbatchjob
OBS: Da de gamle service, logik og batchjob ikke fjernes fra DFDG classic behøver BI ikke at gå over til 2024-4
1005.17.35.5 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet
Løsningsmodel (internt STAR acc.kr.)
QA af regler fra kode mod dokumenteret regler og fejlkode
Ajourfører dokumentation
Sider der skal rettes og QA er (liste er ikke udtømmende)
Servicesnitflade https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4357193729
https://starwiki.atlassian.net/wiki/spaces/CITY/pages/1431667357
https://starwiki.atlassian.net/wiki/spaces/ISB/pages/1359217832
https://starwiki.atlassian.net/wiki/spaces/CITY/pages/695074827
https://starwiki.atlassian.net/wiki/spaces/ISB/pages/1324941323
1005.17.1.10 Død kode i DFDG classic, i forbindelse med DUPLA (tidligere Generel UdstillingsLøsning (GUL)) og eIndkomst, fjernes
Løsningsmodel (internt STAR acc.kr.)
Fjernelse af gammel og død kode i DFDG classic, Dette laves i senere release, når Jobnet classic og LSS ikke meres anvender SOAP service se Acc.kr. 1005.17.35.3 - Som serviceaftager vil jeg gerne beholde de eksisterende SOAP service uændret i en overgangsperiode for at sikre en fleksible overgang til nye snitflade.
1005.17.1.11 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen i EksterneData, i stedet for TaxService
Løsningsmodel (internt STAR acc.kr.)
Landssupport/LSS er skiftet til at bruge EksterneData.SkatOplysningservice
Kode brugt i forbindelse med TaxService (2023-1)er fjernet fra LSS
1005.17.X.6 - Som STAR vil jeg have data er omfattet af dataløft og pseudonymisering mod testmiljøer
Løsningsmodel (internt STAR acc.kr.)
Ikke relevant i denne epic, da de hentede data ikke gemmes i DFDH, men blot viderestilles til flygtig visning i brugergrænseflade (Jobnet og LSS)
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
* Batchjobs
bør testes både med delta og fuldt load,
bør hvis der er afhængigheder køres med normalt load fra BI i ét testmiljø i hele testperioden
bør testes i samarbejde med teams som har afhængigheder
kørselstid, særligt hvis det er en del af NightlyBatch
Konsekvenser for drift/idriftsættelse
I forbindelse med idriftsættelse:
Skal der køres et fuldt dataload ved første kørsel af et batchjob - aftal med SF hvornår load skal køres:
Skal der køres konvertering:
Skal der køres databasescripts for opdatering af tabeller i databasen:
BI foretager initial load af forsørgelseshistorik i ydelsesudstilling silo. Der er ikke tale om konvertering i denne forbindelse da det er samme loadmodel som i den gamle forsørgelseshistorik på DFDG classic.
Efter idriftsættelse:
N/A
Arkitektur- og implementeringsnoter
Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:
Nye dataområder: Nej, flytning til domæne Ydelsesudstilling
Nye snitflader: Nej, flytning til domæne Ydelsesudstilling
Nye komponenter: Nej
Nye miljøer: Nej
Nye teknologier: Modernisering
Nye aftagertyper: Nej
Eller afvigelser fra principperne: Nej
Eventuelle behov for reduktion af teknisk gæld skal afdækkes: N/A
Der gives en beskrivelse af hvorledes disse tænkes håndteret/implementeret i løsningen og om dette har været vendt med STAR arkitekten.
Husk GDPR stillingtagen
Ingen personfølsomme data i epics
Illustrationer, skærmdumps m.v. må ikke indeholde cpr.nr., CV. nr., rigtige personnavne på borgere eller deres kontaktoplysninger i form af e-mail, telefonnr., adresse m.v.
Angiv hvem der har foretaget dette tjek:
Angiv dato for tjek:
Opbevaring af oplysninger i STARs it-systemer
Ved oprettelse af nye dataområder skal der tages stilling til, hvornår formålet med data ophører og dermed fastlægges en slettepolitik.
Ved indførelse af nye data på eksisterende dataområder skal GDPR slettejobs opdateres.
Dette er ikke et nyt dataområde blot en flytning fra DFDG classic og til XXXXX.
Hvem må tilgå oplysningerne?
Afsnittet må ikke blot slettes, hvis det vurderes ikke relevant. Det skal dokumenteres at man har forhold sig til nedenstående.
Husk det er hensynet til borgeren der tæller højst. Der skal være hjemmel til at sagsbehandler må tilgå oplysninger. Formålet skal være som led i administrationen af beskæftigelsesreglerne eller ydelsesadministration.
Korrekte sikkerhedsattributter på services
PO skal for hver enkelt servicemetode angive hvilke myndighedstyper, der må kalde de forskellige servicemetoder.
Tilladte organisationer (eksempel - se den fulde liste over myndighedstyper på siden DFDGs sikkerhedsmodel )
Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang | |
---|---|---|---|---|---|---|
A-kasse |
| |||||
JobCenter |
| X | ||||
Kommune |
| |||||
STAR | X | |||||
AUB | ||||||
UDK | ||||||
STIL |
A-kasse filtrering
Hvis a-kassen må anvende metoden, må a-kassen så se / hente alle data? Eller skal der foretages filtrering ift. at a-kassen fx kun må se nogle udfaldsrum / kodelisteværdier? Husk at filtreringen skal ramme eventuel visning på Jobnet aht. sagsbehandlerlogin
N/A ingen ekstern adgang til denne service
Sagsbehandlerlogin på Jobnet - tag stilling til adgang!
En sagsbehandler i et jobcenter kan tilgå en borger tilknyttet det konkrete jobcenter.
En sagsbehandler i en a-kasse kan tilgå en borger, som er medlem af a-kassen og KG 1 (tilmeldt og ikke-tilmeldt) eller KG 8 og tilmeldekategori 5 - dimittend.
Begrænsninger kan foretages via (a-kasse-) filtrering, eller ved at afgrænse på action niveau på konkrete sider på Jobnet.
Stillingtagen: Beskriv kort, at der er taget stilling til sagsbehandlerlogin
Ikke relevant her, Se epic om data på Jobnet om ungeindsats (komposit service)