855.9 Visning af udvalgte dagpengetællere, dagpengeretsdato m.v. på Borger.dk

Beskrivelse af epic af it-understøttelse af Styrelsen for Arbejdsmarked og Rekrutterings forretning


STAR Projektleder (PL)Forretningsanalytiker (FA)STAR ReleaseEpic statusEksterne snitflader
Knud de Place (STAR)Jesper Brunholm2019-41.0

A-kasse (t.o.)

Borger.dk




key po fa ux sme eksterne snitflader interne snitflader status labels
Loading...
Refresh

DS-1012 - Getting issue details... STATUS



Indholdsfortegnelse




Afgrænsning af epic

Afgræsning

Som STAR 

vil jeg gerne at udvalgte dagpengetællere og en række andre oplysninger vises for borgerne i Mit overblik på Borger.dk

for - i forbindelse med Sammenhængsreformen - at bidrage til initiativet Viden, overblik og transparens 

Acceptkriterier

Nr.BeskrivelseRelevant for
855.9.1 

STAR stiller data til rådighed for Borger.dk (som databehandler for STAR) til brug for visning af

  • om personen har dagpengeret (ej tæller-data, men fra MT-registreringen)
  • udvalgte dagpengetællere
    • Dagpengesats
    • Dagpenge tilbage (i timer)
    • Forventet udløbsdato for dp.ret (forventet tidspunkt for udløb af referenceperiode)
  • a-kassemedlemskab (hvilken a-kasse en person (eventuelt) aktuelt er medlem af)
  • efterlønssats (hvis personen ikke er udgået af efterlønsordning)
  • feriedagpenge (afventer evt. ændringer som følge af nye ferielov)
    • sats i kr.
    • Start- og slutdato på afholdt ferie med feriedagpenge
  • Aftaler (fremtidige møder) i a-kassen og i jobcentret
    • Dato
    • Klokkeslet
    • Adresse på mødested
    • Navn på sagsbehandler
    • Samtaletype
DFDG, SF
855.9.2Borger.dk får som databehandler for STAR adgang til metoden UnemploymentBenefitsAccountService.GetUnemploymentBenefitsAccountInfoSF
855.9.3Borger.dk får som databehandler for STAR adgang til metoden UnemploymentFundMembershipService GetCurrentMembershipSF
855.9.4 udgået
855.9.5Borger.dk får som databehandler for STAR adgang til metoden UnemploymentFundPaymentService.GetHolidayBenefitsPaymentData

Udgår i denne omgang

(evt. i den senere fase)

855.9.6Udgået
855.9.7Borger.dk får som databehandler for STAR adgang til metoden BooklingService.GetBookingInfoSF
855.9.8Borger.dk får som databehandler for STAR adgang til metoden UnemploymentFundPaymentService.GetEarlyRetirementPaymentDataSF
855.9.9Borger.dk får som databehandler for STAR adgang til metoden PersonHistoryService.GetPersonHistorySF









Kriterier for tilsagn til serviceaftager i forhold til STARs snitfladerBerørte acceptkriterierBemærkninger

855.9.1855.9.2855.9.3855.9.4855.9.5855.9.6855.9.7855.9.8855.8.9


Borger.dk læser oplysninger om dagpengetællere i eksisterende webservicexx








UnemploymentBenefitsAccountService.GetUnemploymentBenefitsAccountInfo
Borger.dk læser oplysninger om a-kassemedlemskab i eksisterende webservicex
x







UnemploymentFundMembershipService GetCurrentMembership
Borger.dk læser oplysninger om efterlønssats og om satsen skal vises i eksisterende webservicesx





x


UnemploymentFundPaymentService.GetEarlyRetirementPaymentData 

EarlyRetirementDataService (version 2).GetLatestEarlyRetirementData

Borger.dk læser oplysninger om feriedagpenge i eksisterende webservice










UnemploymentFundPaymentService.GetHolidayBenefitsPaymentData

(udgår i denne fase)

Borger.dk læser oplysninger om fremtidige aftaler i eksisterende webservicex




x



BooklingService.GetBookingInfo

OBS ny metode, der måske etableres til 2020-1 (i prod. marts 2020).

Alternativt læse oplysningerne i PersonStatusService (v20), der dog er udfasningstruet.

(udgår i denne fase)

Borger.dk læser oplysninger om dagpengeretsdato i eksisterende webservicex






x

PersonHistoryService.GetPersonHistory
Borger.dk læser kodelister i eksisterende webservicex









CodeListService.GetAllUnemploymentFundList


Oversigt over berørte webservices 

Automatisk dannet oversigt

Oversigten er ikke synlig for eksterne.

summary varslingstype varslingsnote eksterne snitflader interne snitflader project
Loading...
Refresh


Manuel dannet dannet oversigt

Oversigt er synlig for eksterne, men links i tabellen er ikke brugbare for andre end STAR-brugere.

SummaryVarslingstypeVarslingsnoteEksterne SnitfladerInterne SnitfladerProject
CodeListService (version5).GetAllUnemploymentFundListAndetBorger.dk læser oplysninger om a-kasse kodernes relation til a-kassenavn med denne service/metodeA-kasse(t.o.)Borger.dk SFD+S
EarlyRetirementDataService (version 2).GetLatestEarlyRetirementData.AndetBorger.dk læser oplysninger om personen er udgået af efterlønsordningen med denne service / metodeA-kasse(t.o.)Borger.dk SFD+S
PersonHistoryService (version 4).GetPersonHistoryAndetDagpengeretsdato aflæses i PHS.A-kasse(t.o.)Borger.dkD+S
UnemploymentBenefitsAccountService (Version 2).GetUnemploymentBenefitsAccountInfoAndetBorger.dk læser oplysninger om dagpengetællere med denne service / metodeA-kasse(t.o.)Borger.dk SFD+S
UnemploymentFundMembershipService (version 3).GetCurrentMembershipAndetBorger.dk læser oplysninger om aktuel a-kassemedlemskab med denne service / metodeA-kasse(t.o.)Borger.dk SFD+S
UnemploymentFundPaymentService (version 2).GetEarlyRetirementPaymentDataAndetBorger.dk læser oplysninger om efterlønssats med denne service / metodeA-kasse(t.o.)Borger.dk SFD+S
UnemploymentFundPaymentService (version 2).GetHolidayBenefitsPaymentDataAndetBorger.dk læser oplysninger om feriedagpenge med denne service / metodeA-kasse(t.o.)Borger.dk SFD+S






Beskrivelse af epic

Det forventes, at DIGST ønsker at udstille følgende oplysninger på Mit Overblik på Borger.dk


  • dagpengeretsdato (datoen hvor der det nødvendige medlemskab er opnået - fra MT-registreringen)
  • udvalgte dagpengetællere
    • Dagpengesats
    • Dagpenge tilbage (i timer)
    • Forventet udløbsdato for dp.ret
  • a-kassemedlemskab (hvilken a-kasse en person (eventuelt) aktuelt er medlem af)
  • feriedagpenge (ej i denne fase - måske senere)
    • sats i kr.
    • Start- og slutdato på afholdt ferie med feriedagpenge
  • efterlønssats
  • Aftaler (fremtidige møder) i a-kassen og i jobcentret (ej i denne fase - måske senere)
    • Dato
    • Klokkeslet
    • Adresse på mødested
    • Navn på sagsbehandler
    • Samtaletype


Borger.dk læser ovenstående oplysningstyper via eksisterende DFDG webservices - og udstiller de pågældende oplysninger for borgerne på Borger.dk, når borgeren har logget sig på Borger.dk med NemLog-in.

DFDG udstiller oplysningerne til Borger.dk

Generelt om DFDGs udstilling af services

DFDGs webservices udstilles via SOAP-XML grænseflade og via HTTPS forbindelse. Alle webservices publiceres via WSDL filer. Aftagere skal anvende funktionscertifikater (FOCES). I metadata i SOAP headeren skal det angives hvilken myndighed kaldet foretages på vegne af, alternativt hvem aftager virker som databehandler for.

Derudover skal angives hvilken bruger / medarbejder / applikationsproces (ved batch-processeringer) der foretager handlingen, uanset om det er en læse eller skriveoperation, for at dette kan logges.


WSDL-filer

WSDK-filer til de pågældende webservices er tilgængelig på siden WSDL filer til DFDG services.

WSDL-filerne er pakket i en Zip-fil for for DFDG-release. 


Release 2019-4 zip-filen indeholder 2 undermapper. Zip-filerne for DFDG-services ligger i undermappen "1028_PJAK_TASS" → PjakTassWCFServices → undermapper inddelt efter versionnummer på services

 






Når Borger.dk kalder på vegne af STAR

DFDGs sikkerhedsmodel er beskrevet på siden STARs sikkerhedsmodel.

Når Borger.dk kalder DFDG er det som databehandler for STAR.

Borger.dk bruger uafhængigt af borgers kommunetilknytning ét FOCES certifikat, og kalder med følgende (er her alene angivet et udsnit af de nødvendige oplysninger fra RequestUserMetadataHeader):

Feltnavn
Indhold
Betyder
ActiveOrganisationHeader
  • OrganisationTypeIdentifier = 5
  • OrganisationCode = 13
  • 5 = STAR
  • 13 = Borger.dk
RequestUserMetadataHeader

Hvis borger:

  • OrganisationTypeIdentifier = 5 
  • OrganisationCode = 13
  • RequestUserTypeIdentifier = 1 
  • UserIdentifier = CPR 


  • 5 = STAR
  • 13 = Borger.dk
  • 1 = Citizen
  • Borgers cpr.nr.


Certifikater og testmiljøer

Er beskrevet på siden STARs sikkerhedsmodel#Certifikaterogtestmilj%C3%B8er. Der anvendes funktionscertifikater.

STARs systemforvalter opretter certifikat til brug for kald af DFDG webservices i testmiljøer.

STAR bestiller certifikat til produktionsmiljø.


Dagpengeretsdato udstilles i PersonHistoryService

Datoen for dagpengeret udstilles i PersonHistoryService (version 4) i metoden GetPersonHistory.

Servicen er dokumenteret på siden: PersonHistoryService (overordnet indgang til servicen).

Den aktuelle produktionsversion (2019-1) er beskrevet på siden /wiki/spaces/GI/pages/865600753 med tilhørende teknisk snitfladebeskrivelse på siden /wiki/spaces/GI/pages/1385463809.

Dagpengeretsdatoen udstilles udstilles i metoden GetPersonHistory og indgår i elementet UnemploymentFundCollection, hvor datoen skal aflæses på den seneste a-kassemedlemsskabsregistreriing, hvor UnemploymentBenefitRightsStartDate er udfyldt og hvor registreringen ikke er recall'ed.



Dagpengetællere udstilles i UnemploymentBenefitsAccountService

Dagpengetællere udstilles i UnemploymentBenefitsAccountService (version 2) i metoden GetUnemploymentBenefitsAccountInfo.

Servicen er dokumenteret på siden: UnemploymentBenefitsAccountService (overordnet indgang til servicen).

Den aktuelle produktionsversion (2018-3) er beskrevet på siden /wiki/spaces/GI/pages/366641634 med tilhørende teknisk snitfladebeskrivelse på siden /wiki/spaces/GI/pages/1348829700.

True eller False for visning

Tællere skal ikke vises, hvis DisplayCounters = False (da dette er en indikation af, at a-kassen aktuelt har markeret personens dagpengetællere som værende fejlbehæftede). Hvis feltet ikke er udfyldt eller sat til True kan tællerne vises.


Dagpengetællere skal endvidere kun vises, hvis dato for forventet udløb af referenceperioden er dags dato eller senere:


Dagpengesats

Dagpengesats (bruttobeløb som oplyst i dagpengetælleren) kan aflæses i BenefitsRate - RatePerMonth, hvor dagpengesatsen pr. måned oplyses.

I RateValidFrom fremgår fra hvilken dato dagpengesatsen er gældende,

Antal resterende dagpengetimer

Antal resterende dagpengetimer kan aflæses under Consumption - HoursRemaining:


Dato for forventet ophør af dagpengeret

Dato for forventet ophør af dagpengeret (ved uafbrudt forbrug fra opgørelsestidspunktet) kan aflæses i BenefitsExpiry under BenefitsExpiryDate, når BenefitsExpiryActualOrExpectedTypeIdentifierType = 2 (forventet udløb):


Hvis BenefitsExpiryActualOrExpectedTypeIdentifierType = 1 er retten til dagpenge (faktisk) udløbet.


Aktuelt medlemskab af a-kasse

Oplysninger om a-kasssmedlemskab hentes via UnemploymentFundMembershipService (version 3).GetCurrentMembership.

Der skal ved hvert kald af metoden GetCurrentMembership angives en begrundelse for kaldet.

Borger.dk kan fx bruge begrundelsen "Til brug for visning på Borger.dk".


Servicen er dokumenteret på siden: UnemploymentFundMembershipService (overordnet indgang til servicen).

Den aktuelle produktionsversion (2018-4) er beskrevet på siden /wiki/spaces/GI/pages/845087023 med tilhørende teknisk snitfladebeskrivelse på siden /wiki/spaces/GI/pages/845119825.


Kode for hvilken a-kasse personen er medlem af kan aflæses i Output fra GetCurrentMembership. Koden for hvilken a-kasse personen er medlem af i UnemploymentFundCode:

Hvis personen ikke er medlem

Hvis en person ikke er medlem af en a-kasse returnerer DFDG fejlkoden 4385 (The client does not have an unemploymentfund registration).


Oversættelse af kode for a-kassemedlemskab til a-kasse navn

For at oversætte den 2 cifrede kode for a-kasse kaldes CodeListService.GetAllUnemploymentFundList (kan med fordel kaldes én gang i døgnet, hvorefter output caches på Borger.dk).

Servicen er dokumenteret på siden: CodeListService (overordnet indgang til servicen).

Den aktuelle produktionsversion (2019-1) er beskrevet på siden/wiki/spaces/GI/pages/861503646/wiki/spaces/GI/pages/845087023 med tilhørende teknisk snitfladebeskrivelse på siden /wiki/spaces/GI/pages/1359839233.


Værdisættet er aktuelt:


Efterlønssats

Oplysninger om personens efterlønssats anvendt ved en enkelte måneds udbetaling af efterløn hentes i UnemploymentFundPaymentService.GetEarlyRetirementPaymentData.

Servicen er dokumenteret på siden UnemploymentFundPaymentService (overordnet indgang til servicen).

Den aktuelle produktionsversion (2018-3) er beskrevet på siden /wiki/spaces/GI/pages/345276527 med tilhørende teknisk snitfladebeskrivelse på siden /wiki/spaces/GI/pages/1348502064.

Efterlønssats (Efterlønssatsen pr. time efter fradrag for pension) fremgår i EarlyRetirementRateAfterDeductionForPension.


Efterlønssatsen vises alene, hvis personen ikke er udgået af efterlønsordningen. 


Udgået af efterlønsordningen?

Om personen er Dette aflæses i EarlyRetirementDataService,GetLatestEarlyRetirementData.

Servicen er dokumenteret på siden EarlyRetirementDataService (overordnet indgang til servicen). Version 2 af servicen lægges i produktion 6. december 2019. Version 2 er dokumenteret på siden /wiki/spaces/GI/pages/1406435412 med tilhørende teknisk snitfladebeskrivelse på siden /wiki/spaces/GI/pages/1406435634.

Hvis EarlyRetirementEndDate er før d.d. skal efterlønssatsen ikke vises.


Feriedagpenge (ikke relevant i denne fase)

Oplysninger om personen har afholdt ferie med feriedagpenge og feriedagpengesats hentes i UnemploymentFundPaymentService.GetHolidayBenefitsPaymentData.

Servicen er dokumenteret på siden UnemploymentFundPaymentService (overordnet indgang til servicen).

Den aktuelle produktionsversion (2018-3) er beskrevet på siden /wiki/spaces/GI/pages/345276527 med tilhørende teknisk snitfladebeskrivelse på siden /wiki/spaces/GI/pages/1348502064


Start- og slutdato på perioden med feriedagpenge fremgår i Startdate og EndDate.

Feriedagpengesats fremgår i HolidayBenefitsPaymentRate.



Aftaler i jobcenter og a-kasse (ikke relevant i denne fase)

Oplysninger om aftaler (fremtidige møder) i a-kassen og i jobcentret fremgår i BookingService.GetBookingInfo.

Metoden udvikles måske til release 2020-1 (i prod. i marts 2020).

Oplysninger om

  • Dato
  • Klokkeslet
  • Adresse på mødestedNavn på sagsbehandler
  • Samtaletype

aflæses i følgende felter:

  • x
  • x
  • x
  • x


(UDESTÅR)


Fejlkoder

De enkelte webservices kan kaste de fejlkoder, der er dokumenteret på https://starwiki.atlassian.net/wiki/ under de enkelte metoder.

Der er herudover en række generelle fejlkoder som en webservice kan returnere uanset at de ikke fremgår under den enkelte metode beskrivelse. Disse fejlkoder fremgår på siden Fejlhåndtering#Generellefejlkoder.


Testpersoner

Testpersoner der har data om fx dagpengetællere eller ikke har data kan i vidt omfang udsøges via https://landssupporttx.startest.dk, når der er oprettet adgang til testmiljø(er). X'et angivet nummer på testmiljø - fx https://landssupportt4.startest.dk for T4-testmiljøet.


Der kan endvidere bestilles testpersoner via STARs Systemforvalter ved i Manuscript at oprette en bestilling i Testgruppen.


Særlige krav til test

Test scenarieBerørte systemområder (herunder nye batchjobs*) Identificeret af
Log på borger.dk og tjek at tællerværdier svarer til værdier, der kan aflæses via LSSUnemploymentBenefitsAccountService.GetUnemploymentBenefitsAccoutInfoKnud



* Batchjobs

  • bør testes både med delta og fuldt load: Ikke relevant
  • bør hvis der er afhængigheder køres med normalt load fra BI i ét testmiljø i hele testperioden Ikke relevant
  • bør testes i samarbejde med teams som har afhængigheder Ikke relevant
  • kørselstid, særligt hvis det er en del af NightlyBatch Ikke relevant

Ingen batchjob berørt af denne ændring.


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: Nej
  • Skal der køres konvertering: Nej
  • Skal der køres databasescripts for opdatering af tabeller i databasen: Nej

Efter idriftsættelse:

Ingen ændringer,

Arkitektur- og implementeringsnoter 

Her beskriver PO/FA om arkitekturen og teknikken bag løsningen, om der f.eks. anvendes:

  • Nye dataområder: Nej
  • Nye snitflader: Nej
  • Nye komponenter: Nej
  • Nye miljøer: Nej
  • Nye teknologier: Nej
  • Nye aftagertyper: Ja, Borger.dk som databehandler for STAR
  • Eller afvigelser fra principperne: Nej
  • Eventuelle behov for reduktion af teknisk gæld skal afdækkes: Nej


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.

Har ikke været drøftet med STAR arkitekten, da der er tale om brug af eksisterende snitflader.