PersonHistoryService (2025-1)
Denne service indeholder operationer til at hente personhistorik for en given borger.
(Alment forkortet som: PHS)
Personhistorikken omfatter udelukkende registrerbare forhold, dvs. dataentiteter som der opbygges ændringshistorik på under et sagsbehandlingsforløb. Ikke-registrerbare forhold såsom CPR-oplysninger, uddannelsesoplysninger eller beregnet data omkring rettidighed etc., som der heller ikke opbevares ændringshistorik på skal fortsat hentes igennem PersonStatusService, som udstiller et aktualitetsbillede for den givne borger for så vidt angår både registrerbare og ikke-registrere forhold.
Forretningsbeskrivelse
Borgere er et centralt omdrejningspunkt for beskæftigelsesindsatsen i Danmark og det fælles datagrundlag indsamler og udstiller store mængder af data vedr. borgere og deres sagsbehandling, når de er i kontakt med beskæftigelsesindsatsen – dette være sig i form af kontakt via Jobnet, Jobcentre, A-kasser osv. Disse oplysninger udstilles fra det fælles datagrundlag via det servicekatalog, som Arbejdsmarkedsstyrelsen tilbyder til eksterne aftagere. Statusoplysninger er selvsagt en central del og indeholder i dag også mange historiske oplysninger. Dette kræver alene stor kapacitet af det tekniske apparat at håndtere så mange forespørgsler, som der sker hver måned med gennemsnitlig 30 mio. kald om måneden. Tilmed ønskes der i højere grad flere oplysninger udstillet – foruden flere typer af registrerbare forhold også f.eks. hvem der foretager hvad i form af registrantoplysninger. For at sikre en bedre kapacitetsfordeling, så ønskes der på sigt etableret en mere klar deling mellem historiske oplysninger på borgere og deres aktuelle status. Denne aktuelle opgave vedrører alene at etablere en ny snitflade, som kan udstilles de historiske oplysninger med tilhørende registrantoplysninger. En reduktion i historiske oplysninger i den eksisterende status snitflade er ikke inde for scope af denne opgave.
Teknisk beskrivelse
PesonStatusService udstiller i dag mere eller mindre alle aktuelle forhold vedrørende en borgers beskæftigelsesindsats og deraf sagsbehandlingsforløb. Gennem tiden er den også vokset til at udstille en del historiske oplysninger omkring dette og med et stort antal kald hver måned og for hvert kald den deraf efterhånden større data-høst, så bliver det ganske kapacitetskrævende. Det er tanken ved at skille aktuel status og historik mere ad at opnå en mere balanceret kapacitetsfordeling på servicen foruden at det giver forretningsmæssig god mening.
Til udstilling af historiske oplysninger introducereres PersonHistoryService. Denne vil udstilles alle registrerbare og dermed foranderlige forhold for en borger. Oplysninger om navn og aktuel adresse etc. vil stadig skulle hentes via PersonStatusService.
Det efterfølgende afsnit giver en teknisk specifikation af de enkelte serviceoperationer med specifikation af alle enkelt elementer i deres input (request), output (response) og fejlkoder.
IsCurrent ved udtræk
Hovedreglen er at nyeste række for hver objekt-id (fx fraværs-id, normalt en GUID) har IsCurrent = TRUE. Dette vil også gælde hvis rækken er IsDeleted = TRUE. På collections hvor der ikke opdateres (men i stedet nyoprettes), som fx JobcenterHistory, vil alle rækker være Current.
Adgang til servicen
Jobcentre, Kommuner, A-kasser og Anden Aktør kan tilgå servicen på egne borgere. STAR kan tilgå servicen på alle borgere.
Gæsteadgang til servicen - OBS!! PersonStatusCommentService og CreatePersonGuestAccess UDGÅR PER 2024-3 Brug i stedet for de nye services som Borgerkommunikation udstiller
Der kan gives gæsteadgang til servicen med PersonStatusCommentService metoden CreatePersonGuestAccess med henblik på at kunne tilgå historik for borger som har fået nyt personnummer, og for a-kasser for at kunne tilgå hændelser som ligger tilbage i tid:
- Når registreringerne ligger mere end 120 dage før MT og borger stadig er medlem, eller MA er under 120 dage siden,
- Når registreringerne ligger mere end 120 dage tilbage i tid, og borger ikke har været medlem i seneste 120 dage
Fejlkoder
Hvis borger ikke har en nuværende a-kasse får a-kasser fejl 4385 - The client does not have an unemploymentfund registration.
Hvis borgers nuværende a-kasse er en anden end kaldende fås 4857 - Citizen belongs to different unemployment fund
Hvis jobcenter kalder ind på en borger som ikke er jobcentrets egen fås 6005 - The person with specified cpr does not belong to the jobcenter specified in ActiveOrganisationHeader
A-kassers adgang til oplysninger
Der er adgang til historiske oplysninger i 4 måneder (120 dage) før medlemstilgang i den kaldende a-kasse, i hele medlemsperioden, til og med medlemsafgang.
En registrering er med hvis registreringens startdato, en hændelsesdato eller slutdato ligger indenfor vinduet på 120 dage før medlemsperiodens startdato, hen over medlemskabet til og med medlemsperiodens slutdato. En registrering er også med hvis den overlapper med medlemsperioden se nedenstående:
Filtreringen laves ud fra registreringstidspunktet (RegistrationDateTime) for den enkelte registrering.
Der gives adgang til historiske oplysninger efter medlemsafgang for at man kan se efterregistreringer som hører til medlemsperioden.
Der er enkelte collections hvor alt filtreres fra: SocialAidCollection og PersonCategory. Her returneres der en tom collection (modsvarende håndteringen i PSS).
Der er særregler for filtreringen af AbsenceCollection og ContactGroupCollection:
Fravær a-kasse har adgang til at se
Der filtreres på AbsenceTypeIdentifier:
- 1 - Uddannelse
- 2 - Midlertidigt arbejde
- 3 - Borgerligt ombud
- 4 - Barsel (max 14 dage)
- 8 - Barsel
- 10 - Ferie
- 11 - Sygdom - sygemelding
- 15 - Deltidsbeskæftigelse (over 20 timer/uge)
- 18 - Fritagelse for rådighed under deltagelse i tilbud
- 21 - Værnepligt
- 23 - Jobrettet uddannelse (deltid)
- 24 - Jobrettet uddannelse (fuldtid)
- 25 - Seniorjob
- 30 - Aktivering - Løntilskud
- 33 - Aktivering - Jobrotation
- 42 - Arbejdsfordeling, vejrlig eller materialemangel
- 43 - På vej på efterløn/fleksydelse (inden for 6 uger)
- 44 - På vej på pension (folkepension) (inden for 6 uger)
- 45 - På vej i job (inden for 6 uger)
- 46 - Barsel inden for 6 uger
- 47 - Ferie med ydelse
- 48 - Uddannelsespålæg
- 49 - Omfattet af særlig uddannelsesydelse
- 54 - Omfattet af kontantydelse
- 56 - Fritaget for pligt til selvbook
- 57 - Frataget ret til selvbook
- 63 - Krav om CV
- 64 - Tjek af jobforslag og joblog
- 65 - Uden for institutionens åbningstid - manglende pasningsmulighed
- 66 - Inden for institutionens åbningstid – manglende pasningsmulighed
- 67 - A-dagpengemodtager modtager hjælp fra kommunen (fx supplerende kontanthjælp)
- 70 - Tilladelse efter repatrieringslovens § 6
- 71 - Arbejdsfordeling op til 6 uger
- 72 - Arbejdsfordeling over 6 uger
- 73 - Vejrlig eller materialemangel
- 74 - Uddannelse under pulje til uddannelsesløft
- 75 - Kontaktforløb er hos a-kassen
77 - På vej på erhvervsuddannelse (inden for 6 uger)
78 - Arbejdsfordeling - ny midlertidig ordning. COVID-19
Ekstra fravær som a-kassen har adgang til at se for borgere med fravær id 75 - Kontaktforløb er hos a-kassen
- 1 - Uddannelse
Fravær som a-kassen har udvidet historisk adgang til at se
Id 25 - "Seniorjob" medtager data op til 8 år tilbage i tiden uanset om borgeren var medlem af kaldende a-kasse på hændelsestidspunktet.
Id 71 - "Arbejdsfordeling op til 6 uger" og id 78 - "Arbejdsfordeling - ny midlertidig ordning. COVID-19". Begge disse medtager op til 5 år gamle data uanset om borgeren var medlem af kaldende a-kasse på hændelsestidspunktet.
Kontaktgrupper a-kasse har adgang til at se
Der filtreres på ContactGroupTypeIdentifier
- 1 - Dagpengemodtager
- 8 - Uden ydelse
- 10 - Fleksjobansat
- 13 - Jobafklaring
- 21 - Voksenelever
- 22 - Jobrotation
- 23 - Seniorjob
- 25 - Sygedagpengemodtager fra ledighed
Gennemgang af collections, herunder collections med særlige forhold, fx hvor data først er retvisende fra en given dato
JobcenterCollection - OBS!! PersonJobcenterHistory UDGÅET PER 2024-2
EventTime
Når historiske Jobcentre filtreres fra, fordi den kaldende a-kasse ikke må se dem, kan tilknytning til et jobcenter som ikke har en EventTime i databasen blive vist med 01-01-1900 som EventTime. Dette er ikke en fejl, men udtryk for at DFDG ikke kender EventTime.
Aktuelt jobcenter og subjobcenter
Pr. release 2019-1 er der lavet en rettelse som gør at aktuelle jobcenter (og subjobcenter) for fremtidige registreringer skrives korrekt i historik. Registreringer inden 2019-1 kan have forkert aktuelt jobcenter, da den i 2020-2 foretagne datagenopretning i vid udstrækning er lavet på niveau af det forretningsmæssige hovedjobcenter (xxx01) på baggrund af oplysninger fra andre registreringer af, hvilket jobcenter, der på givne tidspunkter har registreret
- kontaktgruppe
- personkategori (visitation)
- fravær
- afholdte samtaler
fordi nogle af disse registreringer er udført med jobcenternr, xxx00 (og i datagenopretningen ændret til jobcenter xxx01 i historikken).
I det omfang der ikke efter 2019-1 er foretaget opdateringer af aktuelt (sub)center kan oplysninger om aktuelt (sub)jobcenter i PHS og PSS derfor være forskellig på 4. og 5. ciffer.
UnemploymentFundCollection
UnemploymentBenefitRightsStartDate
Indplaceringsdato, også kaldet Dato for opnået dagpengeret. Datoen kommer fra a-kassens registrering i UnemploymentFundMembershipService (UnemploymentBenefitRightsStartDate)
A-kassemedlemskab i ophørte a-kasser
Kollektionen returnerer ikke oplysninger (bl.a. UnemploymentFundCode og UnemploymentFundName) om medlemskab i a-kasser, der er ophørt, herunder ophørt i forbindelse med sammenlægning af a-kasser.
Ved fusioner foretager den fortsættende a-kasse (alene) medlemsoverflytning fra den ophørende a-kasse af medlemmer af a-kasser, der har et aktuelt , dvs. uafsluttet medlemskab i den ophørende a-kasse.
Medlemmer i den ophørende a-kasse, der er udmeldt med en MA (medlemsafgangsregistrering) inden fusionsdatoen er 26.04.2021 datagenoprettet således, at deres medlemsperiode historik flyttes fra den ophørende til den fortsættende a-kasse, da det er den fortsættende a-kasse, der har dokumentationsforpligtelsen ift. de ophørte medlemmer. I den forbindelse er der foretaget datagenopretning af følgende a-kasser:
- D37 (Elfaget) --> D40 (Byggefagene, der skifter navn til Din faglige A-kasse )
Fusionsdato 01.01.2021 - D82 (Business Danmark) --> D57 (Min a-kasse)
Fusionsdato 01.01.2015 - D95 (DANA) --> D83 (Frie)
fusionsdato 01.01.2020 - D62 (Serviceforbundet) --> D57 (Min a-kasse)
Fusionsdato 01.01.2017 - D91 (Akamikernes a-kasse) --> D86 (Akademikerne, der blev navnet efter fusion med D86 Ingeniørerne)
Fusionsdato 01.07.2013 - D96 (It-fagets a-kasse) → D57 (Min a-kasse)
Fusionsdato 01.07.2010
AbsenceHistory Kollektionen udfases principielt set i 2025-1 men bevares til internt brug. Den vil blive fjernet uden yderligere varsel
Fraværshistorik
ConfirmActiveJobSeekingHistory
Hent bekræft aktiv jobsøgningshistorik.
ConfirmActiveJobSeekingWarningHistory
Hent påmindelseshistorik.
ContactGroupHistory Kollektionen udfases principielt set i 2025-1 men bevares til internt brug. Den vil blive fjernet uden yderligere varsel
Hent kontaktgruppehistorik.
PersonGroupMarkingHistory
Hent historik på tilknytninger af borgere til persongruppemarkeringer.
UnemploymentFundHistory
Hent a-kasse historik.
PersonCategoryHistory - Personkategori Kollektionen udfases principielt set i 2025-1 men bevares til internt brug. Den vil blive fjernet uden yderligere varsel
Hent historik på personkategori (visitation).
EnrollmentHistory - Tilmelding Kollektionen udfases principielt set i 2025-1 men bevares til internt brug. Den vil blive fjernet uden yderligere varsel
Hent historik på tilmeldeperioder.
SocialAidHistory - Kontanthjælpsudbetalinger
Hent historik på kontanthjælp
Metadata for registreringer - RegistrationMetaData i database
Metadata i PersonHistoryService lider under 2 forhold:
Borger kan fremstå som Jobcenter Kbh eller som foretaget af sagsbehandler. For ældre registreringer gælder, at de kan se ud som om, at de er foretaget af JC Kbh (10100), fordi JC Kbh for år tilbage blev anvendt som myndighedskode ved borgers registreringer fra Jobnet - uanset borgers JC tilhørsforhold. Det kan også forekomme, at det fremgår, at registreringen er foretaget af sagsbehandler (CaseWorker).
Sådanne registreringer genkendes som være foretaget af borger ved, at borgers 8-cifrede CV-nr. fremgår som registrant-opysning.
For registreringer foretaget af borgere fra Jobnet gælder også, at der ikke er angivet borgers navn eller e-mailadresse, men fiktive data som fx Notsupplied, Unknown eller Ukendt - eller en kombination heraf.
Manglende metadata om sagsbehandler Brugen af RegistrationMetaData er ikke komplet i alle services, for en del services bruges sagsbehandleridentifikationen blot til adgangssikring, uden at blive ført hele vejen ned i databasen.
Følgende services og metoder er løftet til at fulde RegistrationMetaData lagres:
Alle nye services lavet efter 2016-2 (helt nye services, ikke versionsløft)
UnemploymentEnrollmentService Version 6 og version 7 fra 2018-1
- UnemploymentEnrollmentCv
- UnemploymentEnrollment
- UnemploymentEnrollmentAndBookCv
- CancelUnemploymentEnrollment
- CancelUnemploymentEnrollmentCv
CPR-skiftere
Ved kald af GetPersonHistory med en borgers ikke-aktuelle cpr.nr kalder PHS ikke videre til de nye DFDG-forretningsdomæner.PSS vil i denne situation returnere en tom kollektion for hver af de områder, hvor der ikke kaldes videre til de nye DFDG-domæner.
Dette for at forhindre, at det samlede PHS-kald fejler. Dermed vil det kun være DFDG (Classic), der returnerer oplysninger ved kald af PHS på borgers eventuelle tidligere cpr-nr.
Link til snitfladebeskrivelser
Link til forretningsbeskrivelser
Found 6 search result(s) for PersonHistoryService.
Metoder
Rettigheder til at kalde metoderne
Sikkerhedsattributter
Servicen kaster fejlkode 4575 "You are not authorized", hvis servicen kaldes af en aftagertype, der ikke har rettighed til at kalde den pågældende servicemetode. Der kan evt. tidligere være kastet en mere aftagertype-specifik fejlkode i denne situation.
Jobcentre, kommuner og anden aktør
Metode | Alle borgere | Egne borgere | Mulighed for gæsteadgang | Beskrivelse |
---|---|---|---|---|
GetPersonHistory | JC, AA(JC), K, AA | AA(JC) | Denne metode bruges til at hente historiske data på en borger | |
GetPersonAddressHistory | JC, AA(JC), K | Denne metode bruges til at hente historiske adresse data på en borger |
A-kasser
Metode | Alle personer | Egne medlemmer | Tidligere medlemmer | Mulighed for gæsteadgang | Beskrivelse |
---|---|---|---|---|---|
GetPersonHistory | X | X | X | Denne metode bruges til at hente historiske data på en borger | |
GetPersonAddressHistory | X | Denne metode bruges til at hente historiske adresse data på en borger |
GetPersonHistory
Denne operation henter personhistorik for en given borger.
De fleste registrerbare forhold i personhistorikken har samme struktur som kendt fra PersonStatusService, men visse er udvidet med flere oplysninger og visse andre er kommet til for at sikre en mere granuleret udstilling af data. I andre tilfælde er navngivning i højere grad strømlinet for lettere overblik og forståelse.
Forretningsregler
- Alle registrerbare forhold er realtidsopdateret i forhold til registrering i det fælles datagrundlag.
- Der laves af hensyn til brugsperformance en begrænsning, så man som ekstern aftager kun kan hente 1 collection ad gangen
GetPersonAddressHistory
Metoden returnerer borgers adressehistorik for de seneste 10 år således som adresserne har været registreret i CPR-registeret.
Serviceaftagere af denne metode, bør benytte sig af felterne ProtectedAddressStartDate og ProtectedAddressEndDate til at implementere funktionalitet til beskyttelse af adresser givet ved denne metode.
Kun aktive adressebeskyttelser vil blive sat. Hvis en person i CPR har en aktiv adressebeskyttelse, der påbegyndes ført start på aktuel adresse, vil hele perioden med den aktuelle adresse være markeret som beskyttet i DFDGs udstilling.
Datakvalitet
De oplysninger som via DFDG kan udstille som udenlandske adresser er ikke bedre end det input, som STAR/DFDG modtages fra CPR.
Der er størst sikkerhed for, hvor længe en person har været i udlandet, men det er ikke sikkert, at en person har opholdt sig (alene) i det land som en person måtte have oplyst til CPR-registeret ifm. udrejse.
Oplysningerne fra CPR kan på både indenlandske og udenlandske adresser være mere eller mindre mangelfulde – og overholder derfor ikke nødvendigvis OIO-standard(er). Og samme datatyper optræder i leverancen fra CPR ikke altid i de samme felter. Dette vil derfor også heller ikke være tilfældet, når DFDG udstiller oplysningerne. Uventet mange af felterne i serviceoutput er derfor også null’able.
Grønlandske adresser kan have både et husnummer og et bygningsnummer. Hvis husnummer ikke er udfyldt angives i husnummer feltet i stedet bygningsnummer. Hvis både husnummer og bygningsnummer er udfyldt i data fra CPR findes DFDGs udstilling alene husnummer.
Postnummer 9999 og Boligplacering 998
Hvis der i adresseelementerne fremgår 9999 og Boligplacering 998 er der ikke tale om fejlkoder. 9999 er det postnummer, der angives i CPR-registeret, når den adresse borgeren er registreret med i CPR, ikke findes.
Dette kan skyldes at den vejkode der er anvendt ikke eksisterer, eller at feltet for vejnavn er udfyldt med anden information.
Hvis man ser 'Boligplacering 998' er postnummer også altid 9999, af samme grund som ovenfor, men her har en myndighed skrevet dette i vejnavn og husnummer, Der kan også stå 'kildeskattepligtig', 'administrativ vej' eller lignende.
Det vil typisk være et tegn på at registrerende myndighed blot skal have registreret cpr nummer af en eller anden grund, men ikke ellers kender borgeren.
Det er ikke noget DFDG kan gøre noged ved, for adresserne indlæses fra CPR med den kvalitet som de nu en gang har. Og udstilles uændret.
Kollektioner og metoder med forældet indhold eller uden indhold
ActivitySupplement
Kollektionen er bevaret, men vil altid være tom fra og med release 2024-1
BookingHistory
Kollectionen er udfaset og returnerer forældede data eller blank fra og med 2022-3
CVInfoHistory
Denne kollektion vil fra 2020-4 returnere forældet indhold (fra det gamle CV).
For historik på det fra 2020-4 nye CV henvises til JobSearch.CvService
- GetHistoricalCv
- GetHistoricalCvAsPdf
CivicConsentHistory - Samtykke - UDFASET
Kollektionen er udfaset og returnerer blankt fra og med 2021-3
ExternalOperatorHistory - AndenAktør henvisninger - UDFASET
Collection er udfaset og returnerer blankt
GetPersonMigrationHistory
Metoden er udgået.
Helbredsbegrænsninger - HealthLimitationHistory- UDGÅET PER 2023-3
Kollectionen er udfaset og returnerer blank fra og med 2023-3
InterviewDeadlineHistory - UDGÅET PER 2024-2
Kollektionen er udfaset per 2024-2 og returnerer dermed blank. Brug i stedet FristService
Jobcentertilknytning historik - PersonJobcenterHistory UDGÅET PER 2024-2
Kollektion udfases per 2024-2 og returnerer dermed blank.
MeetingParticipationHistory
Kollectionen er udfaset og returnerer forældede data eller blank fra og med 2022-3
Kommentar historik- CommentHistoryCollection - UDGÅR PER 2024-3
Kollektion udfases per 2024-3 og returnerer dermed blank.