930.6 WSRMer vedr NUPH og svar på NUPH
uuBeskrivelse 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) | @Jesper Brunholm @Carsten Olsen | 2023-3 | 2023-4 | 2023-4 | 1.0 | KSS, a-kasse |
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? |
---|---|---|---|
09.03.2023 | 0.1 | @Knud de Place (STAR) | Nyoprettet efter drøftelse med DAK og KL |
13.06.2023 | 0.3 | @Jesper Brunholm | Beskrevet indhold i tynde WSRM’er svarende til indhold i kommende (tynde) webhook beskeder. Klargjort til tilsagn. |
27.06.2023 | 0.3 | Jesper | GetForespoergselPaaYderligereOplysning og GetSvarPaaYderligereOplysning omdøbt til respektive GetNuphUddybendeSpoergsmaal og GetNuphUddybendeSvar |
29.06.2023 | 0.3 | @Knud de Place (STAR) | Sendes i tilsagn med bølge 1 / 2023-4, selvom koden vil blive en del af 2023-3 leverancen ift. brug i 2023-3 testmiljøer. Men da afklaringen om at aftagerne både ønsker WSRM’er og webhook beskeder ift. NUPH er ret ny, vil udviklingen ikke kunne færdiggøres til normal frist for ekstern aflevering til 2023-3, men forventelig i løbet af august 2023. |
04.07.2023 | 0.3 | @Knud de Place (STAR) | Tilføjet AC-5 om rettelser/ændringer i UnderretningService på baggrund af indmeldinger fra aftagere på og efter NUPH-projektmødet 28. juni 2023 |
05.07.2023 | 0.3 | Knud | Opdatering af AC-5 |
05.07.2023 | 0.3 | @Carsten Olsen | Tilføjet AC-6 på baggrund af meldinger fra DAK og a-kasser i udkant af NUPH-projektmødet 28. juni 2023 og jf. tidligere projektmøder om behov for at kunne dele dokumenter sammen med NUPH kommunikationen → indgå i tilsagn på ny i bølge 2 / 2023-4 |
01.08.2023 | 0.3 | Knud | På baggrund af FB 379588 (under tilsagnsbølge 1) er tilføjet at WSRM’erne indeholder cpr.nr → indgå i tilsagn på ny i bølge 2 / 2023-4 |
01.08.2023 | 0.3 | Knud | Opdateret beskrivelse af AC-6 med baggrund for behovet for at kunne dele dokumenter sammen med NUPH-kommunikationen. |
02.08.2023 | 0.5 | Knud | v0.5. Ikke andre ændringer |
04.08.2023 | 0.5 | Knud | Opdatering af AC-5 forud for gentilsagn i bølge 2 / 2023-4 |
16.08.2023 | 0.5 | Knud | Opdateret afgrænsning efter ønske fra Netcompany “med henblik på ibrugtagning i prod. i 2023-4 (med mindre aftager vælger i stedet at anvende webservicebeskeder)“ |
21.08.2023 | 0.5 | Knud | På baggrund af forslag fra KMD opdateres (redaktionelt) beskrivelsen i visse kodelisteværdier i kodelisten NUPHTypeCodeList |
29.09.2023 | 0.5 | Knud | Opdateret “berørte services” med de 3 metoder vedr. dokumenter, der er beskrevet under AC-6 |
11.09.2023 | 1.0 | Knud | V1.0. Ikke andre ændringer. |
12.09.2023 | 1.0 | Knud | Opdateret berørte services, da der er særskilte dokumentmetoder til KSS og a-kasse + tilhørende konsekvensændringer for AC-6. |
14.09.2023 | 1.0 | Knud | Beskrivelse af AC-6 opdateret på baggrund af spørgetime / møde d.d.: Opdateret med kommentarer om sletning af dokumenter, senere GDPR-sletning af dokumenter og om at der er to kollektioner i Get-metoden til at hente dokumenter. |
20.09.2023 | 0.5 | Knud | Genåbner epic på baggrund af mødet/spørgetime 14.09.2023 og efterfølgende forslag om de 2 Get-metoder vedr. dokumenter kan slås sammen til én metode. Dette er under udvikling. Epic endnu ikke opdateret hermed. |
22.09.2023 | 0.5 | Knud | Berørte services opdateret (2 Get-metoder vedr. dokumenter er slået sammen til én metode GetDokument). AC-6 tilsvarende opdateret. |
25.09.2023 | 0.5 | Knud | Efter ønske fra FOA (FB 392886) er under berørte services tilføjet nogle af WSRM’er der udgår (GetAvailabilityAssessmentVersion6, GetRecallAvailabilityAssessmentVersion6, GetJobReferralNotificationEventVersion6, GetRecallJobReferralNotificationEventVersion6). Øvrige (GetCompulsoryNotificationEventVersion7, GetRecallCompulsoryNotificationEventVersion6 og GetRecallActivityNuphVersion1) er beskrevet som udgående i E 930.4. |
26.09.2023 | 0.5 | Knud | Opdateret AC-6 med hvilke WSRM’er og WSB’er, der dannes, når et dokument vedlægges eller slettes en underretning eller svar på underretning |
03.10.2023 | 0.5 | Knud | På baggrund af spg fra FOA (394844) er navngivning på dokumentmetoder opdateret i afsnittet om berørte services og i beskrivelsen af AC-6. |
11.10.2023 | 1.0 | Knud | v1.0 - ikke andre ændringer |
Interne links (indhold i links ikke relevant for eksterne)
https://starwiki.atlassian.net/browse/DS-13324
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 930.6.1 - Som a-kasse og jobcenter vil jeg gerne modtage en WSRM-besked, når jobcentret eller DFDG danner en NUPH
- 5.5 930.6.2 - Som jobcenter vil jeg gerne modtage en WSRM-besked, når a-kassen svarer på en NUPH og når DFDG besvarer en NUPH
- 5.6 930.6.3 - Som a-kasse og jobcenter vil jeg gerne modtage en WSRM-besked, når den anden part beder om flere oplysninger eller besvarer ønsket om flere oplysninger
- 5.7 930.6.4 - Som jobcenter vil jeg gerne have validering på, at Hændelsesslutdato ved registrering af underretninger kun kan anvendes, når der rapporteres enkeltdages-udeblivelser
- 5.8 930.6.5 - Rettelser til UnderretningService
- 5.9 930.6.6 - Vedhæftning af dokument(er) til underretning
- 5.9.1 Baggrund for dette behov
- 5.9.2 Løsning
- 5.9.2.1 Metoder til jobcentre vedrørende dokumenter
- 5.9.2.1.1 CreateUnderretningDokument (POST /v1/Underretning/{underretningIdentifier}/dokument)
- 5.9.2.1.2 DeleteUnderretningDokument (DELETE /v1/Underretning/{underretningIdentifier}/dokument/{dokumentIdentifier}/{berigtigelseskommentar})
- 5.9.2.1.3 GetDokument (GET /v1/Underretning/dokument/{dokumentIdentifier})
- 5.9.2.2 Metoder til a-kasser vedrørende dokumenter
- 5.9.2.2.1 CreateUnderretningSvarBilag (POST /v1/Underretning/{underretningIdentifier}/svar/{underretningSvarIdentifier}/dokument)
- 5.9.2.2.2 DeleteUnderretningSvarDokument (DELETE /v1/Underretning/{underretningIdentifier}/svar/{underretningSvarIdentifier}/dokument/{dokumentIdentifier}/{berigtigelseskommentar})
- 5.9.2.2.3 GetDokument (GET /v1/Underretning/dokument/{dokumentIdentifier})
- 5.9.2.3 Metoden GetUnderretninger
- 5.9.2.4 GDPR-sletning af dokumenter
- 5.9.2.5 WSRM’er og WSB’er ved opload eller sletning af dokumenter
- 5.9.2.1 Metoder til jobcentre vedrørende dokumenter
- 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 STAR, a-kasse og kommune vil jeg gerne have de nye WSRM vedr. NUPH og svar tilgængeligt tidligt i et testmiljø for at jeg kan indgå i en grund integrationstest og en end-2-end test, hvor indgår registrering og læsning af data fra sagsbehandler brugergrænsefladerne i jobcentrenes og a-kassernes fagsystemer med henblik på ibrugtagning i prod. i 2023-4 (med mindre aftager vælger i stedet at anvende webservicebeskeder) | ||
Acceptkriterier | ||
Nr. | Beskrivelse | Relevant for (interne links) |
930.6.1 | Som a-kasse og jobcenter vil jeg gerne modtage en WSRM-besked, når jobcentret eller DFDG danner en NUPH | DFDG https://starwiki.atlassian.net/browse/DS-13328 |
930.6.2 | Som jobcenter vil jeg gerne modtage en WSRM-besked, når a-kassen svarer på en NUPH og når DFDG besvarer en NUPH [dvs. a-kasse får ikke WSRM på svaret, da de selv danner de svar, der er interessante for a-kassen] | DFDG https://starwiki.atlassian.net/browse/DS-14864 |
930.6.3 | Som a-kasse og jobcenter vil jeg gerne modtage en WSRM-besked, når den anden part beder om flere oplysninger eller besvarer ønsket om flere oplysninger | DFDG https://starwiki.atlassian.net/browse/DS-14865 https://starwiki.atlassian.net/browse/DS-14866 |
930.6.4 | Som jobcenter vil jeg gerne have validering på, at Hændelsesslutdato ved registrering af underretninger kun kan anvendes, når der rapporteres enkeltdages-udeblivelser | DFDG |
930.6.5 | Rettelser til UnderretningService
| https://starwiki.atlassian.net/browse/DS-15479 https://starwiki.atlassian.net/browse/DS-15457 |
930.6.6 | Vedhæftning af dokument(er) til underretning | https://starwiki.atlassian.net/browse/DS-14942 |
Kriterier for tilsagn til serviceaftager i forhold til STARs snitflader | Berørte acceptkriterier | Bemærkninger | |||
---|---|---|---|---|---|
930.6.1 | 930.6.2 | 930.6.3 |
| ||
A-kasse og KSS aftager WSRM-besked om NUPH | X |
|
|
|
|
KSS aftager WSRM-besked om svar på NUPH |
| X |
|
|
|
KSS og a-kasse aftager WSRM-besked med ønske om yderligere oplysninger og WSRM-besked om svaret |
|
| 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.
(kopiér og indsæt manuelt i tabellen)
Summary | Varslingstype | Varslingsnote | Eksterne Snitflader | Interne Snitflader | Project |
---|---|---|---|---|---|
Ændret | "haendelsesslutdato" må kun angives ved underretningType id 3 "Enkeltdagsudeblivelse på påbegyndte" | A-kasse(t.o.), KSS | N/A | D+S | |
VisiteringOgStatus.UnderretningService (Version 1).DeleteUnderretningSvarDokument | Ny | Metoden bruges af a-kasse til at slette et dokument på svar på en NUPH underretning. | A-kasse | N/A | Kontaktforløb |
VisiteringOgStatus.UnderretningService (Version 1).CreateUnderretningSvarDokument | Ny | Metoden bruges af a-kasse til at oprette / vedhæfte et dokument til et underretningssvar. Dokumentet er tilknyttet underretningen men kan også referere til et underretningssvar. Kun PDF-dokumenter. | A-kasse, KSS(t.o.) | N/A | Kontaktforløb |
VisiteringOgStatus.UnderretningService (Version 1).GetDokument | Ny | Metoden bruges til at hente dokumenter uanset om de er vedlagt underretning eller svar på underretning | A-kasse, KSS | N/A | Kontaktforløb |
VisiteringOgStatus.UnderretningService (Version 1).CreateUnderretningDokument | Ny | Metoden bruges af jobcenter til at oprette / vedhæfte et dokument til en underretning. Dokumentet er tilknyttet underretningen men kan også referere til et underretningssvar. Kun PDF-dokumenter. | A-kasse(t.o.), KSS | N/A | Kontaktforløb |
VisiteringOgStatus.UnderretningService (Version 1).DeleteUnderretningDokument | Ny | Metoden bruges af jobcenter til at slette et dokument på en NUPH underretning. | KSS | N/A | Kontaktforløb |
WsrmMessageService (version 10).GetAvailabilityAssessmentVersion6 | Udgået | Udgår | A-kasse, KSS | SF | D+S |
WsrmMessageService (version 10).GetJobReferralNotificationEventVersion6 | Udgået | Udgår | A-kasse, KSS | SF | D+S |
WsrmMessageService (version 10).GetRecallAvailabilityAssessmentVersion6 | Udgået | Udgår | A-kasse, KSS | SF | D+S |
WsrmMessageService (version 10).GetRecallJobReferralNotificationEventVersion6 | Udgået | Udgår | A-kasse, KSS | SF | D+S |
Ny | Ny WSRM-besked om NUPH | A-kasse, KSS | SF | D+S | |
WsrmMessageService (version 11).GetNuphUddybendeSpoergsmaalVersion1 | Ny | Ny WSRM-besked ved anmodning om flere oplysninger vedr. NUPH eller svar på NUPH | A-kasse, KSS | SF | D+S |
WsrmMessageService (version 11).GetNuphUddybendeSvarVersion1 | Ny | Ny WSRM-besked ved svar på ønske om flere oplysninger vedr. NUPH eller svar på NUPH | A-kasse, KSS | SF | D+S |
Ny | Ny WSRM-besked med svar på NUPH | KSS | SF | D+S |
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.
E 930.3, hvor der er udviklet nye services til kommunikationen mellem jobcentre og a-kasser om NUPH, svar på NUPH og a-kassernes indberetninger af sanktioner til nyt, særskilt sanktionsregister.
Nærværende epic beskriver nye WSRM’er i tilknytning hertil.
Senere vil en særskilt epic bekrive de nye webhook / webservicebeskeder, der på sigt skal erstatte WSRM-beskederne.
Regler
Her udfylder PO oplysninger om eksisterende eller forventede regler om registrering og indberetning.
Se E 930.3
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-kasse og KSS skal ibrugtage nye WSRM’er samtidig med brugen af nye services fra E 930.3.
930.6.1 - Som a-kasse og jobcenter vil jeg gerne modtage en WSRM-besked, når jobcentret eller DFDG danner en NUPH
A-kasse og jobcenter vil modtage en WSRM-besked når jobcentret indberetter en NUPH eller når DFDG danner en NUPH som afledte handling ved opdateret status på en aktivitet, hvor borger ikke er fritaget for rådighed. (Hvis borger er fritaget for rådighed, modtages en GetSvarPaaNuphVersion1).
Dvs. både JC og a-kasse får WSRM-besked om dannelse af NUPH.
JC modtager derudover WSRM hvis der skiftes ansvarlig a-kasse.
Ny WSRM besked på WsrmMessageService (version 11) - GetNuphVersion1
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang |
---|---|---|---|---|---|---|
A-kasse | X |
|
|
|
|
|
JobCenter | X |
|
|
|
| X |
STAR | X |
|
|
|
|
|
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetNuphVersion1Request | WsrmRequestType |
| 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetNuphVersion1Response | GetNuphTypeCollection |
| 1 |
|
| GetNuphType |
| 0 - * |
|
| WSRMMetadataBaseType |
| 1 |
|
| WSRMMetadataType |
| 0 - 1 |
|
| guid | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 0 - 1 |
|
|
| 0 - 1 |
| |
| ActiveOrganisationHeaderType |
| 0 - 1 |
|
| OrganisationTypeIdentifierType | MinInclusive: 1 | 1 |
Kodeliste med organisationstype / myndighedstype |
| OrganisationCodeType | Length: 1-20 | 1 |
Identifikation af organisation / myndighed |
| RequestUserMetadataType |
| 0 - 1 |
|
| RequestUserStructureType |
| 1 | Information om den kaldende bruger. |
| UserFullNameType | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
|
| 1 | Brugertype | |
| UserIdentifierType | Length: 1-255 | 1 | Unik identifikation af brugeren, f.eks. en GUID, et medarbejder ID, system ID, bruger ID, certifikat ID, cpr-nummer, email (hvis den er unik) o.l. |
| EmailAddressIdentifierType | Pattern: ([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}) | 0 - 1 | Brugers e-mail. |
| RequestOrganisationStructureType |
| 1 | Den organisation som registrerende bruger tilhører. |
|
| 1 | Kodeliste med organisationstype / myndighedstype for registrerende bruger. | |
| OrganisationCodeType | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode for den registrerende bruger. |
| dateTime |
| 1 | Kaldende systems registreringstidspunkt. |
| dateTime |
| 0 - 1 |
|
| unsignedLong |
| 0 - 1 |
|
| RegistrationTypeType | Enumeration:
| 1 | Handlingen dvs oprettelse, opdatering eller sletning. |
- - UnderretningIdentifier | GUID Base: string uuid |
| 1 | Unik Id på underretningen |
- - PersonCivilRegistrationIdentifier | PersonCivilRegistrationIdentifierType | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Borgers CPR-nr. |
930.6.2 - Som jobcenter vil jeg gerne modtage en WSRM-besked, når a-kassen svarer på en NUPH og når DFDG besvarer en NUPH
Som jobcenter vil jeg gerne modtage en WSRM-besked, når a-kassen svarer på en NUPH og når DFDG autoautobesvarer en NUPH. AA-kasse får ikke WSRM på svaret, da a-kassen selv danner svaret.
Ny WSRM besked på WsrmMessageService (version 11) - GetSvarPaaNuphVersion1
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang |
---|---|---|---|---|---|---|
A-kasse |
|
|
|
|
|
|
JobCenter | X |
|
|
|
| X |
STAR | X |
|
|
|
|
|
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetSvarPaaNuphVersion1Request | WsrmRequestType |
| 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetSvarPaaNuphVersion1Response | GetSvarPaaNuphTypeCollection |
| 1 |
|
| GetSvarPaaNuphType |
| 0 - * |
|
| WSRMMetadataBaseType |
| 1 |
|
| WSRMMetadataType |
| 0 - 1 |
|
| guid | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 0 - 1 |
|
|
| 0 - 1 |
| |
| ActiveOrganisationHeaderType |
| 0 - 1 |
|
| OrganisationTypeIdentifierType | MinInclusive: 1 | 1 |
Kodeliste med organisationstype / myndighedstype |
| OrganisationCodeType | Length: 1-20 | 1 |
Identifikation af organisation / myndighed |
| RequestUserMetadataType |
| 0 - 1 |
|
| RequestUserStructureType |
| 1 | Information om den kaldende bruger. |
| UserFullNameType | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
|
| 1 | Brugertype | |
| UserIdentifierType | Length: 1-255 | 1 | Unik identifikation af brugeren, f.eks. en GUID, et medarbejder ID, system ID, bruger ID, certifikat ID, cpr-nummer, email (hvis den er unik) o.l. |
| EmailAddressIdentifierType | Pattern: ([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}) | 0 - 1 | Brugers e-mail. |
| RequestOrganisationStructureType |
| 1 | Den organisation som registrerende bruger tilhører. |
|
| 1 | Kodeliste med organisationstype / myndighedstype for registrerende bruger. | |
| OrganisationCodeType | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode for den registrerende bruger. |
| dateTime |
| 1 | Kaldende systems registreringstidspunkt. |
| dateTime |
| 0 - 1 |
|
| unsignedLong |
| 0 - 1 |
|
| RegistrationTypeType | Enumeration:
| 1 | Handlingen dvs oprettelse, opdatering eller sletning. |
| uuid |
| 0 - 1 | Unik Id på underretningsvaret. Kan sættes af a-kassen. Sættes af DFDG, hvis ikke sat af a-kassen. |
| PersonCivilRegistrationIdentifierType | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Borgers CPR-nr. |
930.6.3 - Som a-kasse og jobcenter vil jeg gerne modtage en WSRM-besked, når den anden part beder om flere oplysninger eller besvarer ønsket om flere oplysninger
Som a-kasse og jobcenter vil jeg gerne modtage en WSRM-besked, når den anden part beder om flere oplysninger eller besvarer ønsket om flere oplysninger
Ny WSRM besked på WsrmMessageService (version 11) - GetNuphUddybendeSpoergsmaalVersion1
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang |
---|---|---|---|---|---|---|
A-kasse | X |
|
|
|
|
|
JobCenter | X |
|
|
|
| X |
STAR | X |
|
|
|
|
|
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetNuphUddybendeSpoergsmaalRequest | WsrmRequestType |
| 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetNuphUddybendeSpoergsmaalVersion1Response | GetNuphUddybendeSpoergsmaalCollection |
| 1 |
|
| GetNuphUddybendeSpoergsmaalType |
| 0 - * |
|
| WSRMMetadataBaseType |
| 1 |
|
| WSRMMetadataType |
| 0 - 1 |
|
| guid | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 0 - 1 |
|
|
| 0 - 1 |
| |
| ActiveOrganisationHeaderType |
| 0 - 1 |
|
| OrganisationTypeIdentifierType | MinInclusive: 1 | 1 |
Kodeliste med organisationstype / myndighedstype |
| OrganisationCodeType | Length: 1-20 | 1 |
Identifikation af organisation / myndighed |
| RequestUserMetadataType |
| 0 - 1 |
|
| RequestUserStructureType |
| 1 | Information om den kaldende bruger. |
| UserFullNameType | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
|
| 1 | Brugertype | |
| UserIdentifierType | Length: 1-255 | 1 | Unik identifikation af brugeren, f.eks. en GUID, et medarbejder ID, system ID, bruger ID, certifikat ID, cpr-nummer, email (hvis den er unik) o.l. |
| EmailAddressIdentifierType | Pattern: ([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}) | 0 - 1 | Brugers e-mail. |
| RequestOrganisationStructureType |
| 1 | Den organisation som registrerende bruger tilhører. |
|
| 1 | Kodeliste med organisationstype / myndighedstype for registrerende bruger. | |
| OrganisationCodeType | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode for den registrerende bruger. |
| dateTime |
| 1 | Kaldende systems registreringstidspunkt. |
| dateTime |
| 0 - 1 |
|
| unsignedLong |
| 0 - 1 |
|
| uuid |
| 0 - 1 | Unik id på jobcenterets underretning, forespørgsel er knyttet til |
| PersonCivilRegistrationIdentifierType | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Borgers CPR-nr. |
Ny WSRM besked på WsrmMessageService (version 11) - GetNuphUddybendeSvarVersion1
Tilladte organisationer
| Alle borgere | Egne borgere | Tidligere egne borgere | Gæsteadgang | Anden Aktør - egne borgere | Anden Aktør - gæsteadgang |
---|---|---|---|---|---|---|
A-kasse | X |
|
|
|
|
|
JobCenter | X |
|
|
|
| X |
STAR | X |
|
|
|
|
|
Input
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetNuphUddybendeSvarRequest | WsrmRequestType |
| 1 |
|
Output
Element | Type | Detaljer | Forekomst | Beskrivelse |
---|---|---|---|---|
GetNuphUddybendeSvar | GetNuphUddybendeSvar |
| 1 |
|
| GetNuphUddybendeSvarType |
| 0 - * |
|
| WSRMMetadataBaseType |
| 1 |
|
| WSRMMetadataType |
| 0 - 1 |
|
| guid | Pattern: [\da-fA-F]{8}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{4}-[\da-fA-F]{12} | 0 - 1 |
|
|
| 0 - 1 |
| |
| ActiveOrganisationHeaderType |
| 0 - 1 |
|
| OrganisationTypeIdentifierType | MinInclusive: 1 | 1 |
Kodeliste med organisationstype / myndighedstype |
| OrganisationCodeType | Length: 1-20 | 1 |
Identifikation af organisation / myndighed |
| RequestUserMetadataType |
| 0 - 1 |
|
| RequestUserStructureType |
| 1 | Information om den kaldende bruger. |
| UserFullNameType | Length: 1-140 | 1 | Sagsbehandlers fulde navn, ved systemkald angives systemets og jobbets navn her. |
|
| 1 | Brugertype | |
| UserIdentifierType | Length: 1-255 | 1 | Unik identifikation af brugeren, f.eks. en GUID, et medarbejder ID, system ID, bruger ID, certifikat ID, cpr-nummer, email (hvis den er unik) o.l. |
| EmailAddressIdentifierType | Pattern: ([^>\(\)\[\]\\,;:@\s]{0,191}@[^>\(\)\[\]\\,;:@\s]{1,64}) | 0 - 1 | Brugers e-mail. |
| RequestOrganisationStructureType |
| 1 | Den organisation som registrerende bruger tilhører. |
|
| 1 | Kodeliste med organisationstype / myndighedstype for registrerende bruger. | |
| OrganisationCodeType | Pattern: [-][1]|[0-9]{1,8} | 1 | Organisationskode for den registrerende bruger. |
| dateTime |
| 1 | Kaldende systems registreringstidspunkt. |
| dateTime |
| 0 - 1 |
|
| unsignedLong |
| 0 - 1 |
|
| uuid |
| 0 - 1 | Unik id på jobcenterets underretning, forespørgsel er knyttet til |
| PersonCivilRegistrationIdentifierType | Pattern: ((((0[1-9]|1[0-9]|2[0-9]|3[0-1])(01|03|05|07|08|10|12))|((0[1-9]|1[0-9]|2[0-9]|30)(04|06|09|11))|((0[1-9]|1[0-9]|2[0-9])(02)))[0-9]{6})|0000000000 | 1 | Borgers CPR-nr. |
930.6.4 - Som jobcenter vil jeg gerne have validering på, at Hændelsesslutdato ved registrering af underretninger kun kan anvendes, når der rapporteres enkeltdages-udeblivelser
Som jobcenter vil jeg gerne have validering på, at Hændelsesslutdato ved registrering af underretninger kun kan anvendes, når der rapporteres enkeltdages-udeblivelser. Dette for at undgå problemer med data, når borgere flytter mellem jobcentre.
Ny fejlkode 100023 - Hændelsesslutdato må kun påføres ifm. rapportering af enkeltdagsudeblivelser
930.6.5 - Rettelser til UnderretningService
Rettelser til UnderretningService på baggrund af spørgsmål / bemærkninger fra KSS og a-kasser:
underrettedeJobcenter skal udgå i input
UnderretningService.GetUnderretninger skal have forekomst 0-1 i Input mht uuid på underretningIdentifier og uuid på underretningSvarIdentifier
UnderretningService.GetUnderretninger skal have forekomst 0-1 i Input mht startdato og slutdato
UnderretningService.GetUnderretninger: Tilføjelse af sagsbehandler / registrant oplysninger
VisiteringOgStatus.NUPHKobletTilTypeCodeList udvided id 3 for at kunne referere til afholdte samtaler
VisiteringOgStatus. UPHTypeCodeList skal have visse id’er opdateret redaktionelt i navn eller beskrivelsen
VisiteringOgStatus.NUPHKobletTilTypeCodeLis
Identifikator | Navn | Beskrivelse | Startdato | Slutdato |
---|---|---|---|---|
1 | Indkaldelse til samtale | NUPH koblet til indkaldelse til samtale eller selvbooket samtale | 01-11-2022 | 01-07-2100 |
2 | Aktivitet | NUPH koblet til LAB-tilbud eller anden aktivitet | 01-11-2022 | 01-07-2100 |
3 | Afholdt samtale | NUPH koblet til afholdt samtale | 01-08-2023 | 01-07-2100 |
VisiteringOgStatus. UPHTypeCodeList
Identifikator | Navn | Beskrivelse | Startdato | Slutdato |
---|---|---|---|---|
1 | Udeblivelse fra samtale eller aktivitet | Udeblivelse fra samtale eller beskæftigelsesfremmende aktivitet, der ikke er givet som LAB-tilbud, men med mødepligt (fx informationsmøder, jobmesser etc.) | 01-11-2022 | 01-07-2100 |
2 | Afslag på eller ophør i tilbud | Afslag på eller ophør i LAB-tilbud. Underretning dannes af DFDG via sagsbehandlers opdatering af status- og statusårsagskode på LAB-tilbuddet | 01-11-2022 | 01-07-2100 |
3 | Enkeltdagsudeblivelse på påbegyndte tilbud | Enkeltdagsudeblivelse på påbegyndte LAB-tilbud | 01-11-2022 | 01-07-2100 |
4 | Afslag eller ophør på henvist job | Afslag eller ophør på henvist job | 01-11-2022 | 01-07-2100 |
5 | Ikke overholdt uddannelsespålæg | Ikke overholdt uddannelsespålæg | 01-11-2022 | 01-07-2100 |
6 | Tvivl om rådighed | Tvivl om rådighed | 01-11-2022 | 01-07-2100 |
930.6.6 - Vedhæftning af dokument(er) til underretning
Muliggøre vedhæftning af dokument til underretninger.
Baggrund for dette behov
Der skal i forbindelse med behandlingen af NUPH kunne udveksles / deles dokumenter mellem jobcenter og a-kasse i følgende situationer:
Alle situationer, hvor a-kassen har behov for at se den underretning som jobcentret har sendt til medlemmets postkasse i Offentlig Digital Post (“eboks”)
Her var a-kassernes oprindelig udgangspunkt, at a-kasserne altid skulle have den og at den altid skulle være vedhæftet.
Det kunne a-kasserne ikke få. Dermed er minimums-løsningen, at den kan vedhæftes, når a-kassen beder om den i en høring af jobcentret.
Forventes at blive efterspurgt af a-kasser i alle situationer, hvor medlemmer siger et eller andet om, hvad jobcentret har skrevet til borger/medlem.
Jobcenterets indkaldelser til samtaler (som sendt til Offentlig Digital Post (“eBoks”) i det omfang samtalen ikke er selvbooket.
Forventes at blive efterspurgt af a-kasser i alle situationer, hvor medlemmet siger et eller andet om hvad jobcenter har skrevet eller ikke skrevet til borger/medlem i indkaldelsesbrev.
Alle situationer med afslag på tilbud/udeblivelse fra tilbud/aktivitet på 1. dag, hvor a-kassen SKAL have kopi af det afgivne tilbud (= det brev med afgørelse om tilbuddet, der er landet i medlemmets postkasse i Offentlig Digital Post (“eboks”) for at kunne træffe en afgørelse.
Løsning
Der etableres yderligere 6 metoder på UnderretningService til at oprette, hente og slette dokumenter (bilag) - i form af pdf-dokumenter:
CreateBilag - https://starwiki.atlassian.net/wiki/spaces/GI/pages/4091445249#CreateBilag-(POST-/v1/Underretning/dokument)
Metoden anvendes til at oploade et dokument med reference til en underretningIdentifier eller en underretningSvarIdentifier.
Metoden anvendes til at hente / læse et dokument med reference til en underretningIdentifier.
Metoden anvendes til at slettemarkere et dokument med reference til en underretningIdentifier eller en underretningSvarIdentifier.
CreateUnderretningBilag (POST /v1/Underretning/{underretningIdentifier}/dokument)
GetUnderretningBilag (GET /v1/Underretning/{underretningIdentifier}/dokument/{dokumentIdentifier})
CreateUnderretningDokument (POST /v1/Underretning/{underretningIdentifier}/dokument)
GetDokument (GET /v1/Underretning/dokument/{dokumentIdentifier})
Metoder til jobcentre vedrørende dokumenter
Se teknisk snitflade under den udviklede version https://starwiki.atlassian.net/wiki/spaces/GI/pages/4119625845 - (og ikke under udviklingsversionen https://starwiki.atlassian.net/wiki/spaces/GI/pages/4091445249 )
CreateUnderretningDokument (POST /v1/Underretning/{underretningIdentifier}/dokument)
Metoden bruges til at oprette / vedhæfte et dokument til en underretning. I regi af kommunikation om NUPH kun PDF lovlig.
DFDG validerer kun på om filtypen er PDF - ikke på indholdet.
DeleteUnderretningDokument (DELETE /v1/Underretning/{underretningIdentifier}/dokument/{dokumentIdentifier}/{berigtigelseskommentar})
Metoden bruges til at slette et dokument på en NUPH underretning. Metoden slettemarkerer et dokument.
Det slettede dokument ligger som slettemarkeret i historiktabeller i DFDG, indtil det fysisk GDPR-slettes.
GetDokument (GET /v1/Underretning/dokument/{dokumentIdentifier})
Metoden bruges til at hente et dokument knyttet til en underretning eller et underretningssvar. Dokumentindholdet returneres i binær form. Metoden returnerer ikke dokumenter, der er slettemarkeret.
Metoder til a-kasser vedrørende dokumenter
Se teknisk snitflade under den udviklede version https://starwiki.atlassian.net/wiki/spaces/GI/pages/4119625845 - (og ikke under udviklingsversionen https://starwiki.atlassian.net/wiki/spaces/GI/pages/4091445249 )
CreateUnderretningSvarBilag (POST /v1/Underretning/{underretningIdentifier}/svar/{underretningSvarIdentifier}/dokument)
Metoden bruges til at oprette / vedhæfte et dokument til svar på en underretning. I regi af kommunikation om NUPH kun PDF lovlig.
DFDG validerer kun på om filtypen er PDF - ikke på indholdet.
DeleteUnderretningSvarDokument (DELETE /v1/Underretning/{underretningIdentifier}/svar/{underretningSvarIdentifier}/dokument/{dokumentIdentifier}/{berigtigelseskommentar})
Metoden bruges til at slette et dokument på et NUPH underretningssvar. Dokumentindholdet returneres i binær form.
Metoden bruges til at slette et dokument på et svar på en NUPH underretning. Metoden slettemarkerer et dokument. Det slettede dokument ligger som slettemarkeret i historiktabeller i DFDG, indtil det fysisk GDPR-slettes.
GetDokument (GET /v1/Underretning/dokument/{dokumentIdentifier})
Metoden bruges til at hente et dokument knyttet til en underretning eller et underretningssvar. Dokumentindholdet returneres i binær form. Metoden returnerer ikke dokumenter, der er slettemarkeret.
Metoden GetUnderretninger
Metoden GetUnderretninger udbygges med kollektioner til
dokumenter tilknyttet underretningen
dokumenter tilknyttet til svaret på underretningen
Metoden returnerer ikke dokumenter, der er slettemarkeret.
GDPR-sletning af dokumenter
I senere release implementeres GDPR-sletning af dokumenter - både slettemarkerede og dokumenter, der ikke er slettemarkerede. Umiddelbart forventes GDPR-sletning 12 måneder efter dokumentet er oploadet eller slettemarkeret. Særskilt epic herom vil komme i tilsagn til senere release.
WSRM’er og WSB’er ved opload eller sletning af dokumenter
Når et dokument på en underretning oprettes eller slettes dannes:
WSRM: GetNuphVersion1 - dannes med Aendringstype Updated
WSB: Nuph - dannes med - dannes med Aendringstype id 2 (opdatering)
Når et dokument på et underetningssvar oprettes eller slettes
WSRM: GetSvarPaaNuphVersion1 - dannes med Aendringstype Updated
WSB: SvarPaaNuph - dannes med Aendringstype id 2 (opdatering)
Særlige krav til test
Test scenarie | Berørte systemområder (herunder nye batchjobs*) | Identificeret af |
---|---|---|
Der dannes webservicebesked til jobcentre / KSS ved Der dannes webservicebesked til jobcentre / KSS ved
|
| Knud de Place |
Der dannes webservicebesked til a-kasser ved
Der dannes webservicebesked til a-kasser ved
|
| Knud de PlaceKnud de Place |
* 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:
Efter idriftsættelse:
Arkitektur- og implementeringsnoter
Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:
Nye dataområder:
Nye snitflader:
Nye komponenter:
Nye miljøer:
Nye teknologier:
Nye aftagertyper:
Eller afvigelser fra principperne:
Eventuelle behov for reduktion af teknisk gæld skal afdækkes:
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.
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 | X | |||||
JobCenter | X | X | ||||
Kommune | X | |||||
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
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