1005.17.41(D) A-kasser - a-kasse stamdata kan opdateres via servicesnitflade
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 | 2025-2 | 2025-2 | 2025-2 | 1.0 | A-kasse, KSS |
I tilsagn
2025-1, bølge 2 (tidlig tilsagn til 2025-2)
2025-2, bølge 1
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 |
11.04.2024 | 0.1 | Knud | Bagkant for ibrugtagning ændret fra 2025-1 til 2025-2 |
16.08.2024 | 0.1 | Carsten Olsen | På vej mod version 0.3 |
24.10.2024 | 0.1 | Knud | Udskilt fra oprindeligt oplæg til E 1005.17.41, der indeholdt både medlemskabsregistrering, a-kasse stamdata og bestandskørsler |
31.10.2024 | 0.3 | Carsten Olsen | Udbygget med varsling, QA af epic og snitflader, klar til STAR QA |
04.11.2024 | 0.3 | Knud de Place | v0.3 |
18.01.2025 | 0.3 | Knud | Udfyldt særlige krav til test |
18.03.2025 | 0.5 | Carsten Olsen | Løftete til V 0.5 |
25.03.2025 | 0.5 | Carsten Olsen | På ønske fra KSS deles WSB i to separate. https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4769972256 der nu alene sendes, når a-kassen stamoplysninger ændres, og en ny WSB https://starwiki.atlassian.net/wiki/spaces/FYS/pages/5140545545 der sendes på afdelingskontor inkl. disses tilknytning til a-kasse 31 |
31.03.2025 | 0.5 | Carsten Olsen | Da denne epic giver a-kasserne mulighed for selv at oprette og lukke afdelingskontorer, vil den statiske kodeliste https://starwiki.atlassian.net/wiki/pages/createpage.action?spaceKey=FYS&title=EksterneData.AkasseAfdelingskontorTypeCodeList udgå. I stedet skal afdelingskontorer hentes på GetAkasseAfdelingskontorRelation (GET /v1/Akasse/AkasseAfdelingskontorRelation). Afledte ændringer under AC-2, AC-8 |
23.04.2025 | 1.0 | Carsten Olsen | Løftet til version 1.0 efter snitflader er færdige |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/KON-5587
https://starwiki.atlassian.net/browse/BI-6233
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.41(D).1 - Som STAR vil jeg have flyttet forretningsområde a-kasse stamoplysninger til forretningsdomænet (silo) EksternData inkl. at det lever op til de principper der er fastsat
- 5.5 1005.17.41(D).2 - Som serviceaftager og STAR vil jeg have udstillet service til administrere a-kasse stamoplysninger inkl. afdelingskontorer og relation mellem a-kasse og a-kassekontor via nye REST snitflader med samme forretningslogik og operationer som den eksisterende SOAP service
- 5.5.1 Løsningsmodel
- 5.5.2 EksterneData.AkasseService -
- 5.5.2.1 GetAkasseListe (GET /v1/Akasse)
- 5.5.2.2 GetAkasseOplysninger (GET /v1/Akasse/{akasseKode})
- 5.5.2.3 GetAkasseAfdelingskontorRelation (GET /v1/Akasse/AkasseAfdelingskontorRelation)
- 5.5.2.4 GetAfdelingskontor (GET /v1/Akasse/Afdelingskontor)
- 5.5.2.5 CreateAfdelingskontor (POST /v1/Akasse/Afdelingskontor/{})
- 5.5.2.6 UpdateAfdelingskontor (PUT /v1/Akasse/Afdelingskontor/{AfdelingskontorKode})
- 5.5.2.7 UpdateAkasseOplysninger (PUT /v1/Akasse/Afkasse/{akassekode})
- 5.5.3 Kodelister
- 5.5.3.1
- 5.5.3.2 UDGÅR!
- 5.5.3.3
- 5.6 1005.17.41(D).3 - Som serviceaftager skal jeg gerne udfase de eksisterende SOAP service til fordel for de nye REST service
- 5.6.1 Løsningsmodel
- 5.6.2 UnemploymentFundBranchService -
- 5.6.2.1 GetUnemploymentFundBranch
- 5.6.2.2 CreateUnemploymentFundBranch
- 5.6.2.3 UpdateUnemploymentFundBranch
- 5.7 1005.17.41(D).4 - Som serviceaftager og STAR vil jeg modtage WSB på ændringer til akasse stamoplysninger samt til afdelingskontorer og tilknytning til a-kasse
- 5.7.1 Løsningsmodel
- 5.8 1005.17.41(D).5 - Som STAR vil jeg have dataleverancer i forhold til VOA tilpasset til nye forretningsdomæne (silo)
- 5.9 1005.17.41(D).6 - Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet
- 5.10 1005.17.41(D).7 - Som STAR vil jeg have data er omfattet af dataløft (og ingen pseudonymisering mod testmiljøer)
- 5.11 1005.17.41(D).8 EksterneData udstiller kodelisterne for a-kasse (hovedafdelinger) - Afdelingskontor udstilles alene ved getmetode
- 5.11.1 Løsningsmodel
- 5.12 1005.17.41(D).9 PersonStatusService (version 20) - ikke relevant ift. a-kasse stamdata
- 5.12.1 PersonStatusService (Version 20)
- 5.12.1.1 GetVariablePersonStatus
- 5.12.1 PersonStatusService (Version 20)
- 5.13 1005.17.41.10 Død kode i DFDG, i forbindelse med vedligeholdelse af a-kasseafdelinger, fjernes
- 5.14 1005.17.1.11 Landssupport/LSS er skiftet over til at brug den nye REST-service i EksterneData ift. vedligeholdelse af oplysninger om a-kasser og a-kassekontorer
- 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 A-kasse og STAR vil jeg have løftet servicesnifladerne for vedligeholdelse af a-kasseunderafdelinger 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.
Som A-kasse og STAR vil jeg have etableret servicesnifladerne for vedligeholdelse af a-kasse stamoplysninger og afdelingskontorer til REST som en del af STAR's moderniseringsprogram for at sikre at
| |||
Acceptkriterier | |||
Nr. | Beskrivelse | Relevant for | US |
1005.17.41(D).1 | Som STAR vil jeg have flyttet forretningsområdet a-kasse oplysninger (a-kasse stamdata) til forretningsdomænet EksterneData inkl. at det lever op til de principper, der er fastsat | PLAN, BI | |
1005.17.41(D).2 | Som serviceaftager og STAR vil jeg have udstillet service til at administrere a-kasse stamoplysninger inkl. afdelingskontorer og relation mellem a-kasse og a-kassekontor via nye REST snitflader med samme forretningslogik og operationer som den eksisterende SOAP service | PLAN | |
1005.17.41(D).3 | SOAP-REST converter - etableres ikke |
|
|
1005.17.41(D).4 | 1005.17.41(D).4 - Som serviceaftager og STAR vil jeg modtage WSB på ændringer til akasse stamoplysninger samt til afdelingskontorer og deres tilknytning til a-kasse | PLAN |
|
1005.17.41(D).5 | Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til det nye forretningsdomæne | BI |
|
1005.17.41(D).6 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | DFDG, Jobnet |
|
1005.17.41(D).7 | EJ relevant i denne epic - Som STAR vil jeg have, at data er omfattet af dataløft (og ingen pseudonymisering mod testmiljøer), | DFDG, SF |
|
1005.17.41(D).8 | EksterneData udstiller kodelisterne for a-kasse (hovedafdelinger) Afdelingskontor udstilles alene ved getmetode. Bemærk: Kodliste EksterneData.AkasseAfdelingskontorTypeCodeList udgår dermed! | DFDG |
|
1005.17.41(D).9 | Ej relevant i denne peic - PersonStatusService (version 20) og PersonHistoryService udstiller ikke mere oplysninger om xxxx | DFDG |
|
1005.17.41(D).X UN om der er et behov | EksternData udstiller event på nyt a-kasse afdeling Borgerkommunikation modtage event så borger kan tilknyttes ny a-kasse afdelinmgskontor | DFDG |
|
1005.17.41(D).10 | Død kode i DFDG, i forbindelse med vedligeholdelse af a-kasseafdelinger, fjernes Død kode i Jobnetc classic, i forbindelse med vedligeholdelse af a-kasse stamoplysninger, fjernes | DFDG, Jobsøgning |
|
1005.17.41(D).11 | Landssupport/LSS er skiftet over til at brug den nye REST-service i EksterneData ift. vedligeholdelse af oplysninger om a-kasser og a-kassekontorer. | DFDG |
|
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | ||||
|---|---|---|---|---|---|---|
1005.17.41(D).1 | 1005.17.41(D).2 |
| 1005.17.(D).8 | |||
Som a-kasse skal jeg ibrugtage ny REST-service, hvis jeg selv ønsker at kunne vedligeholde (oprette og nedlægge) a-kasse kontorer (underafdelinger) via servicekald |
| X |
| X |
| Alternativt bestilles oprettelse og lukning fortsat via Topdesk sag eller mail til STAR |
Som a-kasse skal jeg ibrugtage ny REST-service, hvis jeg selv ønsker at kunne vedligeholde (opdaterer) stamoplysninger (Adresse, åbningstider, telefontider, logo m.v.) om min a-kasse via servicekald |
| X | X |
|
| Alternativt bestilles opdateringer via Topdesk sag eller mail til STAR |
A-kasser og KSS kan abonnere på WSB om ændringer til a-kasse kontorer (underafdelinger) og stamoplysninger |
| X |
|
|
|
|
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.
|
|
|
|
|
|
Summary | Varslingstype | Varslingsnote | Eksterne snitflader | Interne Snitflader | Project |
|---|---|---|---|---|---|
Ny | WSB op opdateringer på a-kasse adfelingskontor og tilknytning til a-kasse | A-kasse, KSS | N/A | Kontaktforløb | |
Udgået | Udgår 2025-2. Brug i stedet EksterneData.AkasseAfdelingskontorTypeCodeList og EksterneData.AkasseTypeCodeList | A-kasse, KSS, Plannersystemer, UDK | BI | Kontaktforløb | |
Udgået | Udgår 2025-2. Brug i stedet EksterneData.AkasseAfdelingskontorTypeCodeList og EksterneData.AkasseTypeCodeList | A-kasse, KSS, Plannersystemer, UDK | BI | Kontaktforløb | |
Udgået | Kodeliste udgår, da data kan oprettes dynamisk. Anvend i stedet GetAkasseAfdelingskontorRelation (GET /v1/Akasse/AkasseAfdelingskontorRelation), hvis detaljer om afdelingskontor kan GetAfdelingskontor (GET /v1/Akasse/Afdelingskontor) benyttes | N/A | BI | Kontaktforløb | |
EksterneData.AkasseService.CreateAfdelingskontor (POST /v1/Akasse/Afdelingskontor/{}) | Ny | Ny metode, der henter a-kassens adresse, kontaktoplysninger, åbningstider, telefontider, logo og dybe links. | A-kasse(f) | N/A | Kontaktforløb |
EksterneData.AkasseService.GetAfdelingskontor (GET /v1/Akasse/Afdelingskontor) | Ny | Ny metode, der henter a-kassens adresse, kontaktoplysninger, åbningstider, telefontider, logo og dybe links. | A-kasse, KSS | N/A | Kontaktforløb |
Ny | Ny metode, der henter a-kassens adresse, kontaktoplysninger, åbningstider, telefontider, logo og dybe links. | A-kasse, KSS(f) | N/A | Kontaktforløb | |
Ny | Ny metoder, der returnerer en liste indeholdende alle a-kasse, med oplysninger om den enkelte a-kasse. | A-kasse, KSS(f) | N/A | Kontaktforløb | |
EksterneData.AkasseService.GetAkasseOplysninger (GET /v1/Akasse/{akasseKode}) | Ny | Ny metoder der returnerer (hoved) a-kasse og deres relation til afdelingskontorer. | A-kasse, KSS(f) | N/A | Kontaktforløb |
Ny | Ny metode til at opdatere oplysninger omkring et afdelingskontor i en a-kasse. | A-kasse | N/A | Kontaktforløb | |
EksterneData.AkasseService.UpdateAkasseOplysninger (PUT /v1/Akasse/Afkasse/{akassekode}) | Ny | Metode til at opdatere oplysninger om et afdelingskontor. A-kasser får mulighed for a kalde denne metode. Erstatter https://starwiki.atlassian.net/wiki/spaces/FYS/pages/4593320095/UnemploymentFundBranchService+Version+1+2017-3#UpdateUnemploymentFundBranch | A-kasse(f) | N/A | Kontaktforløb |
UnemploymentFundBranchService (version 1).CreateUnemploymentFundBranch | Udgået | Hidtil intern service i DFDG. Udgår 2025-2. Brug i stedet AkassestamdataService | N/A | N/A | Kontaktforløb |
UnemploymentFundBranchService (version 1).GetUnemploymentFundBranch | Udgået | Hidtil intern service i DFDG. Udgår 2025-2. Brug i stedet AkassestamdataService | N/A | N/A | Kontaktforløb |
UnemploymentFundBranchService (version 1).UpdateUnemploymentFundBranch | Udgået | Da afdelingskontorer er dynamiske skal | N/A | BI | Kontaktforløb |
Ny | WSB op opdateringer på a-kasse stamoplysninger | A-kasse, KSS | N/A | Kontaktforløb |
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 stamdata om a-kasser følgende:
I DFDG et skift til REST snitflade
For a-kasse stamoplysninger en forretningsmæssig opgradering med tilpasninger i forhold det nuværende forretningsflow
I denne epis sker der også en opgradering af den funktionalitet, der understøtter registrering og opdatering af a-kasse stamoplysninger. Baggrunden for at foretage denne opgradering skal ses ud fra:
De eksisterende løsninger er forretningsmæssigt etableret for længe siden, så der er dele der ikke up to date teknologisk og forretningsmæssigt
Intern service i DFDG til oprettelse og opdatering af underafdelinger har ikke hidtil kunnet kaldes af a-kasser
Der kan ske en ensretning og simplificering i forhold til de eksisterende arbejdsgange
Der er større samspil mellem a-kasser og jobcenter i forretningen
Der et øget behov for simplificering og fleksibilitet omkring udvalgte flows
Oversigt over forbedringstiltag
En bedre datakvalitet og indberetningsmuligheder omkring stamdata om a-kasse og afdelingskontor
I forbindelse med at a-kasser indgår i flere og flere forretningsflows er der et større og større behov, at stamdata om a-kasser dels er korrekte, men også at a-kassen selv kan (får mulighed for at) vedligeholde disse oplysninger. Et eksempel på dette er a-kassernes større rolle i forbindelse med jobordrer og formidling af borgere på disse. Her vises stamoplysninger for virksomheder. Der etableres derfor en parallel løsning til den, der er for jobcentre. på at indberette stamdata om a-kassen selv og oprette og vedligeholde oplysninger om afdelingskontorer. A-kasserne får således mulighed for selv at vedligeholde data disse data således, at a-kassen ikke behøver at få Systemforvalter til det.
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
Der er ikke indberetningsregler i databekendtgørelsen om indberetning af stamdata om a-kasser.
A-kassen får mulighed for via servicesnitfalde at indberette stamdata om a-kassen og afdelingskontorer. Oplysningerne vises bl.a. på Jobnet og JobAG.
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.
A-kasser kan ibrugtage ny REST snitflade for a-kasse stamoplysninger (nye metode) og vedligeholdelse af afdelingskontorer (flyttede metoder). A-kasser har ikke hidtil haft serviceunderstøttelse for dette.
For arbejdsgange sehttps://starwiki.atlassian.net/wiki/spaces/LOG/pages/4589944862
A-kasser og jobcentre kan via ny get-metode udlæse stamdata om a-kasser og underafdelinger.
1005.17.41(D).1 - Som STAR vil jeg have flyttet forretningsområde a-kasse stamoplysninger til forretningsdomænet (silo) EksternData inkl. at det lever op til de principper der er fastsat
Løsningsmodel (internt STAR acc.kr.)
Etablering af database i EksterneData for a-kasser, a-kasse kontorer og deres relation.
Lav BI mapningark til disse