BorgerkommunikationStatusService (2025-1)
- Jesper Brunholm
Formål med service
Servicen giver adgang til de aktuelle stam-, kontakt-, kontaktpersons- og kommunikationsdata, der er registreret for en borger.
I STARs målarkitektur er det besluttet at splitte PSS op i mindre services, der er logisk tilknyttet et forretningsområde. Borgerkommunikation.PersonStatusService (tidligere PersonCommunicationStatusService) dækker over området Borgerkommunikation.
Forretningsbeskrivelse
Selve statusmetoden (GetPersonCommunicationStatus) indeholde borgers generelle stamdata bl.a. fra CPR, derudover også en række basisoplysninger såsom, kontaktpersoner, jobcenter a-kasse tilknytning.
Bemærk at servicen pt. ikke er fuldt udbygget. Dette vil ske løbende efterhånden som de sidste forretningsområder bliver flyttede til Borgerkommunikation. Pt. udestår:
- Borgerkontaktdata
- Dialogmodul
- Huskeservice
- A-kasse medlemsskab
- Persongrupper
se roadmap for modernisering for forventet release
Ud over selve status er det også muligt at få information om borger er tilmeldt NemSMS eller ej.
CPR-skiftere
Nye DFDG forretningsdomæner
For de nye DFDG forretningsdomæner gælder:
- I nye DFDG forretningsdomæner flyttes data (pegepinden til data) til at være borgers aktuelle cpr,nr, når borger skifter cpr.nr
- I nye DFDG forretningsdomæner kan der alene registreres og opdateres data ved kald med borgers aktuelle cpr.nr
- Fra 2023-3:
- Ved opstart af nye DFDG forretningsdomæner indlæser STAR data fra den ældre del af DFDG i det nye forretningsdomæer uanset borgers CPR-status (bl.a. af hensyn til aflevering af data til Rigsarkivet) og af hensyn til bl.a. jobcentres og a-kassers behov for at kunne læse historiske data om en borger eller et medlem)
- Serviceaftagere kan hente/læse data i de nye forretningsdomæner uanset om der kaldes med borgers aktuelle eller historisk cpr nr - også hvis borger er død.
- For de allerede opstartede DFDG forretningsdomæner foretages efterkonvertering / indlæsning af data for de CPR-statusser som i første indlæsning blev udeladt, således at databestanden er komplet.
- Ved registreringskald til nye DFDG forretningsdomæner med ikke-aktuelt CPR nummer kaster DFDG (ny) fejlkode med oplysning om at borgers aktuelle cpr nr skal anvendes (frem for nuværende brug af fejlkode om at cpr nr ikke findes) - fejlkode 9460 - "Det er ikke tilladt at registrere oplysninger på borgers ikke-aktuelle personnummer"
- Fra 2023-4
- I servicen Virksomhedsindsats.PersonStatusService (version 1). GetPersonStatus er der fra 2023-4 releasen foretaget ændring i ansvarligJobcenterKode - Feltet vil fremover bestå af myndighedskode og organisationstype.
DFDG (classic)
For den ældre del af DFDG, der ikke er omlagt til nye DFDG forretningsdomæner, gælder:
- I DFDG (classic) forbliver data (som hidtil) på det cpr.nr., hvor registreringen oprindeligt er sket
- Fra DFDG (classic) kan data udlæses på det cpr.nr hvor registreringen oprindeligt er sket
- Det er muligt for aftagerne at opdatere allerede registrerede data i DFDG (classic) ved kald med ikke aktuelt cpr nr fsva data registreret på det pågældende cpr.nr, det gælder fx afslutning af allerede registreret fravær og lukning af borgers kontaktgruppe
- Ved registrering / opdatering af data med brug af ikke aktuelt cpr nr., dannes afledte WSRM'er / webservicebeskeder på dette ikke-aktuelle cpr.nr
- For SOAP services, som stiller igennem til REST services i en overgangsperiode (såkaldte converters), vil det ikke være muligt at opdatere på gammelt personnummer, da data bor i de nye forretningsdomæner, hvor alene aktuelt cpr nr kan anvendes ved registrering / opdatering
Link til snitfladebeskrivelsen
- Borgerkommunikation.BorgerkommunikationStatusService (Version 1, 2025-1)
- Borgerkommunikation.BorgerkommunikationStatusService (Version 2, 2025-1)
- Borgerkommunikation.BorgerkommunikationStatusService (Version 3, 2025-1)
- Borgerkommunikation.BorgerkommunikationStatusService [UDV](Version 3, 2025-1)
Swagger
Link til forretningsbeskrivelser
Found 10 search result(s) for Borgerkommunikation.
Metoder
GetPersonKommunicationStatus
Henter generelle stamdata om en borger, herunder navn, adresse, kontaktinformationer, jobcenter og a-kasse tilknytning.
Bemærk: Mht. mentor inkl. udslusningskoordinator, angives (vedligeholdes) disse i forbindelse med ActivityService og vil derfor også fremgå som en del af Min plan. Mentor og udslusningskoordinator kan dog også snævert ses som en kontaktperson, derfor vil mentor også blive medtaget på GetPersonCommunicationStatus. Mentor kan dog kun vedligeholdes via ActivityService
V2/GetPersonKommunicationStatus:
Servicen henter data for jobcentertilknytning, borgerstamdata (personstatusstruktur, adresse, personnummerHistorik), personkommentar, gæsteadgang, børnUnder18, andenaktoerhenvisning og personFagprofessionelKontakt.
Herunder ses hvordan data hentes:
Jobcentertilknytning: GetJobcentertilknytning
Personkommentar: GetPersonkommentarer
Gæsteadgang: GetGaesteadgange
Andenaktoerhenvisning: GetAndenAktoerHenvisninger
PersonFagprofessionelKontakt: GetFagprofessionelKontaktForBorger
Data for personstatus-struktur, adresse, personnummer-historik og børn under 18 hentes på baggrund af borgerstamdata.
MidlertidigAdresse: Viser altid den seneste adresse også hvis den er udløbet.
A-kasse filtrering
Følgende kontaktpersontyper (PersonContactTypeIdentifier) vil være tilgængelig for A-kassen:
- Personlig jobformidler (Id 3)
- Min sagsbehandler i jobcentret (Id 5)
- Beskæftigelsessagsbehandler (Id 16)
- Kontaktperson i a-kassen (Id 25)
- Primær sagsbehandler (Id 28)
GetAdressehistorik
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.
GetPersonNemSMSSubscription
Henter information om hvorvidt en borger er tilmeldt NemSMS eller ej.
Forretningsregler
PersonSubscribed returneres, hvis det kaldende system er STAR.
Filtrering: Elementet MaritalStatusCode filtreres fra ved a-kasse kald.