1005.17.21 Ydelser fra KY
STAR Projektleder (PL) | Forretningsanalytiker (FA) | STAR Release | STAR Release | STAR Release | Epic status | Eksterne snitflader |
|---|---|---|---|---|---|---|
@Knud de Place (STAR) @Jens Andersen | @Carsten Olsen @Jesper Brunholm | 2025-1 | 2025-2 | 2025-2 | 1.0 | KY, KSS Bemærk Ingen Converter, der sker et rent skift fra SOAP til REST samtidig med satsniveauer og §-henvisninger indføres |
I tilsagn med:
2025-1, bølge 3
2025-2, bølge 1 og 3
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 |
12.04.2024 | 0.1 | Carsten Olsen | Indhold udfyldt afventer evt. kontanthjælpsreform 2025 ændringer |
05.09.2024 | 0.1 | Knud de Place | Indhold udfyldt ud fra lovudkast, der har været i ekstern høring og dialog med 'Ydelser' i STAR |
15.09.2024 | 0.1 | Knud de Place og Carsten | Indhold præciseret ud fra dialog med KY |
12.11.2024 | 0.1 | Knud de Place og Carsten Olsen | Opdateret efter tilbagemeldinger fra KOMBIT 30.10.2024 og 06.11.2024. |
12.11.2024 | 0.3 | Knud | v0.3 |
19.01.2025 | 0.5 | Knud | v.0.5. Udfyldt særlige krav til test |
11.02.2025 og 17.01.2025 | 0.5 | Carsten Olsen / Knud de Place | v.0.5. Opdateret i forhold til det nu er afklaret, at KY fortsat kan sende Selvforsørgelses- og hjemrejseydelsesmodtager efter INL (KG 27) (ændringer markeret med lilla. Dette gælder også selve servicebeskrivelsen på https://starwiki.atlassian.net/wiki/spaces/FYS/pages/5024514049) |
13.04.2025 | 1.0 | Knud de Place | v1.0. KY kan kan sende Selvforsørgelses- og hjemrejseydelsesmodtager efter INL (KG 27) - fra 1.7.2025 betegnet “Kontanthjælpsmodtager (INL)” |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/DS-12131
https://starwiki.atlassian.net/browse/BI-5606
https://starwiki.atlassian.net/browse/BI-2470
https://starwiki.atlassian.net/browse/BI-5740
https://starwiki.atlassian.net/browse/PLAN-6900
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.21.1 - Som STAR vil jeg have flyttet forretningsområdet afgørelse om ydelse fra KY til forretningsdomænet VisiteringOgStatus inkl. at det lever op til de principper, der er fastsat
- 5.5 1005.17.21.2 - Som serviceaftager og STAR vil jeg have udstillet afgørelse om ydelse fra KY via ny REST snitflade med samme forretningslogik og operationer som den eksisterende service, men dog klargjort til de forventede kontanthjælpsændringer pr. 1. juli 2025
- 5.5.1.1 Løsningsmodel
- 5.5.2 VisiteringOgStatus.YdelsesVisiteringService -
- 5.5.2.1 GetYdelse - GetYdelse (GET /v1/ydelse)
- 5.5.2.2 GetYdelse (historik) - GetYdelse (GET /v1/ydelse/historik)
- 5.5.2.3 UpdateYdelse - CreateYdelse (PUT /v1/ydelse)
- 5.5.2.3.1 UpdateYdelse - Valideringer og lovlige kombinationer for afgørelser om kontanthjælp
- 5.5.2.3.2 Kodelister
- 5.5.2.3.2.1 YdelsesafgoerelsesType -
- 5.5.2.3.2.2 SatsniveauType -
- 5.5.3 VisiteringOgStatusStatusService -
- 5.6 1005.17.21.3 - Som serviceaftager KY vil jeg gerne beholde den eksisterende SOAP service uændret i indtil de nye kontanthjælpsændringer træder i kraft pr. 1. juli 2025
- 5.6.1.1 Løsningsmodel
- 5.6.2 UnemploymentRegistrationService -
- 5.6.3 Codelistes -
- 5.7 1005.17.21.4 - Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til nye forretningsdomæne (silo) - VisiteringOgStatus
- 5.8 1005.17.21.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.21.6 - Som STAR vil jeg have data er omfattet af dataløft og pseudonymisering mod testmiljøer
- 5.10 1005.17.21.7 VisiteringOgStatus udstiller kodelisterne for afgørelse om ydelser fra KY
- 5.10.1.1 Løsningsmodel
- 5.10.2 YdelsesAfgoerelsesType kodeliste -
- 5.10.3 SatsniveauType kodeliste -
- 5.10.4 Lovhenvisning (paragrafhenvisning)
- 5.11 1005.17.1.8 PersonStatusService (version 20) udstiller ikke mere SocialAidCollection. I stedet returneres i PSS en tom liste
- 5.11.1 PersonStatusService (Version 20)
- 5.11.1.1 GetVariablePersonStatus
- 5.11.1 PersonStatusService (Version 20)
- 5.12 1005.21.1.9 Som serviceaftager og STAR vil jeg have WSB
- 5.13 1005.17.1.10 Død kode i DFDG, i forbindelse med oplysninger fra KY om afgørelse om ydelse, fjernes
- 5.14 1005.17.1.11 Landssupport/LSS er skiftet over til at bruge den nye REST-servicen , i stedet for
- 5.15 1005.17.21.12 Som serviceaftager og STAR vil jeg have udfaset warning omkring “Afmeldt grundet stop af bevilling” (Id 50) da denne er overflødig pga. der sendes WSB’er i stedet
- 5.15.1.1 Løsningsmodel
- 5.15.2
- 5.15.2.1 GetWarningVersion4
- 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 afgørelser om afgørelse om ydelse fra KY
for at sikre at DFDG lever op til STARs principper omkring en moderne og vedligeholdelsesvenlig IT-portefølje samt udfaser end of life teknologi - og for at understøtte kontanthjælpsreform, der træder i kraft 1. juli 2025. | |||
Acceptkriterier | |||
Nr. | Beskrivelse | Relevant for | US |
1005.17.21.1 | Som STAR vil jeg have flyttet forretningsområdet afgørelse om ydelse fra KY til forretningsdomænet (silo) VisiteringOgStatus inkl. at det lever op til de principper, der er fastsat | Kontaktforløb, BI | |
1005.17.21.2 | Som KY og STAR vil jeg have udstillet afgørelse om ydelse fra KY via ny REST snitflade med samme forretningslogik og operationer som den eksisterende SOAP service, men dog klargjort til kontanthjælpsændringer pr. 1. juli 2025, jf. kontanthjælpsreform | Kontaktforløb | |
1005.17.21.3 Udgår | Som serviceaftager KY vil jeg gerne beholde den eksisterende SOAP service uændret i indtil de nye kontanthjælpsændringer træder i kraft pr. 1. juli 2025 Bemærk der er ikke SOAP-REST converter på denne snitflade - breaking changes. | Kontaktforløb | |
1005.17.21.4 | Som STAR vil jeg have dataleverancer i forhold til DOA tilpasset til det nye forretningsdomæne (silo) | BI | |
1005.17.21.5 | Som STAR vil jeg have at dokumentation for såvel servicelag og frontend lever op til STAR's principper på releasetidspunktet | Kontaktforløb | |
1005.17.21.6 | Som STAR vil jeg have, at data er omfattet af dataløft og pseudonymisering mod testmiljøer | Kontaktforløb, SF | |
1005.17.21.7 | VisiteringOgStatus udstiller kodelisterne for afgørelse om ydelser fra KY | Kontaktforløb | |
1005.17.21.8 | PersonStatusService (version 20) udstiller ikke mere SocialAidCollection. I stedet returneres en tom list | Kontaktforløb | |
1005.17.21.9 | Som serviceaftager og STAR vil jeg have udsendt WSB om afgørelser om ydelser. Bemærk at WSRM bliver udfaset med 2025-2 og der vil derfor ikke længere være WSRM udsendelse i forbindelse med de nyt REST snitflader | Kontaktforløb | |
1005.17.21.10 | Død kode i DFDG, i forbindelse med afgørelse om ydelse fra KY, fjernes | Kontaktforløb | |
1005.17.21.11 | Landssupport/LSS er skiftet over til at brug den nye REST-servicen i VisiteringOgStatus, i stedet for https://starwiki.atlassian.net/wiki/spaces/FYS/pages/75820963 fra DFDG classic | Kontaktforløb | |
1005.17.21.12 | Som serviceaftager og STAR vil jeg have udfaset warning omkring “Afmeldt grundet stop af bevilling” (Id 50) da denne er overflødig pga, der sendes WSB’er i stedet | Kontaktforløb |
|
1005.17.21.13 | Overgangsregler i forbindelse med kontanthjælpsændringer træder i kraft (indtil 1. juli 2025) (specielregel nr. 9) | Kontaktforløb |
|
Pakke KY-1 DFDG roadmap
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
|---|---|---|---|---|---|
1005.17.21.2 | 1005.17.21.8 | 1005.17.21.9 | |||
Som KY skal jeg overgå til ny REST snitflade senest 1. juli 2025 (og tidligst fra release 2025-2) | X |
| KY har oplyst, at forventningen er, at KY kan indberette på nye REST snitflade fra ca. 20. juni 2025. | ||
Som KY skal jeg skifte til ny KY-identifier, hvis der træffes afgørelse om ændring af satsniveau | X |
|
|
| KY/KOMBIT har tidligere oplyst at der skiftes KY-identifier i denne situation (og det er afgørende for indretningen af snitfladen mellem KY og DFDG) |
Som bruger af PersonStatusService (KSS) vil jeg skifte til REST snitflade og kald til https://starwiki.atlassian.net/wiki/spaces/GI/pages/4215701505 for at hente oplysninger fra KY om afgørelser om ydelser. | X |
| |||
Som KSS vil jeg overgå til ny WSB vedr. afgørelser fra KY |
|
| X |
| Det er ikke muligt at modtage WSRM vedr. KY-afgørelser efter kontanthjælpsændringer pr. 1. juli 2025 |
KSS kan håndtere, at pegepinden til data om borger vedr. afgørelser fra KY flyttes fra borgers gamle til borgers nye cpr nr. ved cpr.skift (KY kommunikerer i forvejen til DFDG på borgers aktuelle cpr nr, dvs. hvis oprindelig afgørelser er på gl. cpr.nr. på en KY-identifier, sendes opdateringer til afgørelsen fra KY til DFDG på aktuelle CPR-nr.) | X | A-kasser og jobcentre kan abonnere på Cprskift.wsb, hvis der er behov for, at vide, hvornår DFDG flytter pegepinden til data om borger fra gammelt til nyt cpr nr. | |||
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.
(kopiér og indsæt manuelt i tabellen)
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
|---|---|---|---|---|---|
VisiteringOgStatus.YdelsesVisiteringService (version 1).UpdateYdelse | Ny | Ny service til KY’s indberetning af afgørelser om ydelse. Anvendes fra release 2025-2. Erstatter SOAP-servicen UnemploymentRegistrationService (version 4).SaveSocialAid | KY | BI | Plan |
VisiteringOgStatus.YdelsesVisiteringService (version 1).GetYdelse | Ny | Ny service der udstiller KY’s indberetning af afgørelser om ydelse. Anvendes fra release 2025-2. Erstatter SOAP-servicen UnemploymentRegistrationService (version 4).GetSocialAid | KSS | N/A | Plan |
VisiteringOgStatus.YdelsesVisiteringService (version 1).GetYdelseHistorik | Ny | Ny service der udstiller KY’s indberetning af afgørelser om ydelse. Anvendes fra release 2025-2. Erstatter SOAP-servicen UnemploymentRegistrationService (version 4).GetSocialAidHistory | KSS | N/A | Plan |
UnemploymentRegistrationService (version 4).SaveSocialAid | Udgået | Udgår 2025-2. Brug i stedet VisiteringOgStatus.YdelsesVisiteringService (version 1).UpdateYdelse | KY | BI | Plan |
UnemploymentRegistrationService (version 4).GetSocialAid | Udgået | Udgår 2025-2. Brug i stedet VisiteringOgStatus.YdelsesVisiteringService (version 1).GetYdelse | KSS | N/A | Plan |
UnemploymentRegistrationService (version 4).GetSocialAidHistory | Udgået | Udgår 2025-2. Brug i stedet VisiteringOgStatus.YdelsesVisiteringService (version 1).GetYdelseHistorik | KSS | N/A | Plan |
PersonStatusService (version 20).GetVariablePersonStatus - SocialAidCollection | Udgået | Kollektionen udstiller fra 2025-2 en tom liste. Brug i stedet Get-metoderne i VisiteringOgStatus.YdelsesVisiteringService eller KY-kollektionen i VisiteringOgStatus.VisiteringOgStatusStatusService | KSS | N/A | Plan |
WsrmMessageService (version 10).GetWarningVersion4 - Afmeldt grundet stop af bevilling” (Id 50) | Udgået | Udgår i 2025-2. Erstattes forretningsmæssigt af AfgoerelseOmYdelse.wsb (ny i 2025-2) og Tilmelding.WSB (er prod.lagt) | KSS | N/A | Plan |
AfgoerelseOmYdelse.wsb | Ny | Ny WSB. Erstatter GetAppropriationNotificationVersion5 | KSS | N/A | Plan |
WsrmMessageService (version 11).GetAppropriationNotificationVersion5 | Udgået | Udgår i 2025-2. Erstattes af AfgoerelseOmYdelse.wsb | KSS | N/A | Plan |
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 oplysninger fra KY om afgørelser om ydelser følgende:
I DFDG et skift til REST snitflade - og i denne epic med samtidige forretningsmæssige ændringer foranlediget af forventede ændringer i kontanthjælpssystemet pr. 1.7.2025:
Udvidelse af snitfladen med yderligere oplysninger vedrørende afgørelser om afgørelser vedrørende kontanthjælp
Satsniveautype
Lovhenvisning (§-henvisning til lov om aktiv socialpolitik)
Disse oplysninger skal ikke indberettes for afgørelser om andre typer af ydelser (fx jobafklaringsydelse eller revalideringsydelse). HVIS KY ønsker også at indberette satsniveautype og lovhenvisning (§-henvisning) for øvrige ydelser skal de påtænkte nye kodelister udvides med flere udfaldsrum (et sådant ønske er ikke modtaget fra KY)
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
KY indberetter afgørelser om ydelser, jf. databekendtgørelsen. Bestemmelserne vil blive opdateret således, at de også kan rumme de nye oplysninger om satsniveau og lovhenvisning (§-henvisning) for de enkelte afgørelser.
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.
KY skal overgå til ny REST snitflade efter den idriftsættes med STAR release 2025-2 og senest 1. juli 2025. KY kan anvende den eksisterende SOAP service indtil idriftsættelsen af release 2025-2. Når kontanthjælpsændringer træder i kraft skal KY overgå til de nye REST-service. Der er således ingen overgangsperiode.
KSS skal ift. læsning af oplysninger i DFDG om afgørelser om bl.a. kontanthjælp og de de nye oplysninger om satsniveau og §-henvisning ift. kontanthjælp for den enkelte afgørelse overgå til REST snitfladen, når kontanthjælpsændringer træder i kraft 1. juli 2025. Indtil 2025-2 skal KSS forsat benytte SOAP servicen. Der er således ingen overgangsperiode.
Da skiftet vedrørende kontanthjælpsændringer træder i kraft samtidig med omlægning til REST service skal alle tre parter (KY, KSS, DFDG) ibrugtage løsningen samtidigt og dermed de nye REST snitflader. DFDG etablerer de nye REST snitflader på testmiljørene så tidligt som muligt for at give KY og KSS den størst mulig fleksibilitet i forholds til KY og KSS udviklingsarbejde og dette kan foregå uafhængig af hinanden.
DFDG planlægger derfor at påbegynde deres udviklingsopgave i release 2025-1.
Jobcentret skal anvende oplysningerne om satsniveau og lovhenvisning til at udsøge borgere omfattet af reglerne om arbejdspligt, der træder i kraft 1. januar 2025 (for SHO-modtagere) og som 1.7.2025 også får virkning for modtagere af kontanthjælp.
1005.17.21.1 - Som STAR vil jeg have flyttet forretningsområdet afgørelse om ydelse fra KY til forretningsdomænet VisiteringOgStatus inkl. at det lever op til de principper, der er fastsat
Løsningsmodel (internt STAR acc.kr.)
Etablering af database i VisiteringOgStatus
Udvidelse med oplysninger om Satsniveau og lovhenvisning (§-henvisning) vedrørende afgørelser om kontanthjælp
Forretningsbeskrivelse vedrørende indberetning af data
Mapningark BI
1005.17.21.2 - Som serviceaftager og STAR vil jeg have udstillet afgørelse om ydelse fra KY via ny REST snitflade med samme forretningslogik og operationer som den eksisterende service, men dog klargjort til de forventede kontanthjælpsændringer pr. 1. juli 2025
Løsningsmodel
Ny REST service med tilhørende Get-metode i VisiteringOgStatus - udvidet med oplysningstyper om satsniveau type og lovhenvisning (§-henvisning)
Fejlkoder bevares
Nye fejlkoder efter behov ift. nye valideringer
Skal være afklaret senest 10.11.2024
Dette har betydning for DFDGs afledte handlinger (KG-skift foranlediget af afgørelse af ydelse fra KY), om alle afgørelser fx komme som fx afgørelser om KG2 (kontanthjælp - uden for program) og 27 (kontanthjælp - omfattet af program efter INL) eller vi fortsat kan skelne i ovennævnte 3 grupper.
Dette fordi, jf. https://starwiki.atlassian.net/wiki/spaces/ISB/pages/4168909218, vi aktuelt forventer (det er senere afklaret at dette sker), at der i DFDG kan ske en række KG sammenlægninger pr. 1.7.2025
KG 2 og 26 kan slås sammen i KG 2
KG 12 og 28 kan slås sammen i KG 12 (KOMBIT har på møde oplyst, at unge med uddannelsespålæg fra 1.7.2025 ikke kan udsondres fra kontanthjælpsmodtagere i afgørelserne fra KY)
KG 27 og 29 kan slås sammen i KG 27 (KOMBIT har i mail 6.11.2024 oplyst, at KG 27 fra 1.7.2025 ikke umiddelbart kan udsondres fra kontanthjælpsmodtagere (KG2) i afgørelserne fra KY. For at sondre skal der også ses på “Noegle”- KOMBIT har dog i i efterfølgende mail 4.02.2025 oplyst, at KG 27 fortsat bliver udskilt i en kontaktgruppe for sig selv, når KY sender afgørelser om ydelse)
KY vil for (kontanthjælpsområdet) for
De eksisterende kontaktgrupper (der er i live efter 1.7.2025)
Kontaktgruppe: Kontanthjælpsmodtager (KG 2)
Kontaktgruppe: Modtager af uddannelseshjælp (KG 12)
Kontaktgruppe: Overgangsydelsesmodtager efter LAB (KG 26)
Kontaktgruppe: Selvforsørgelses- og hjemrejseydelsesmodtager efter INL (KG 27)