Borgerkommunikation.BorgerKontaktinformationService (2025-2)

Borgerkommunikation.BorgerKontaktinformationService (2025-2)

Formål med service

BorgerKontaktinformationService giver borger selv og sagsbehandler mulighed for at redigere borgerens kontaktinfo.

Forretningsregler 

Sagsbehandler skal selv sikre at borgeren har givet samtykke, før at denne service må benyttes til at oprette kontaktinformation for borgeren. 

Mailadresse og mobiltelefonnummer har status. Når en sagsbehandler opdaterer kontaktinfomation via metoden CreateKontaktinformation sættes status (KontaktdataStatusCodeList, tidl. PersonContactDataStatusIdentifierType) til Id 4 ”Oprettet af sagsbehandler. Dette medfører at Borgerkommunikation.HuskeService kan benyttes uden at borger skal verificere kontaktoplysningerne. For regler om verifikation af kontaktoplysninger se Eksternkommunikation.KontaktinformationVerifikationService (Version 1 [UDV], 2025-2) (tidl. JobnetPersonNotificationReminderService)

Det er muligt for sagbehandler at indberette en e-mailadresse i forbindelse med tilmelding, se nærmere i UnemploymentEnrollmentService (2016-4). XXXXXX   

For regler vedr. udsendelse af huskeservicebeskeder, se Borgerkommunikation.HuskeserviceService (Version 1 [UDV], 2025-2) (tidl. NotificationStatusService (2017-3)) herunder beskrivelse af mapning mellem notifikationer, og de forskellige abonnementer. 

Gamle kontaktinformation bevares som historik af hensyn til at kunne dokumentere tidligere foretaget kommunikation og hvor dette er sendt til.

Metoder

CreateKontaktinformation (POST /v1/kontaktinformation)

Denne metode opdaterer borgeres kontaktinformation. Disse omfatter pt. mobiltelefon, fastnet telefon og mailadresse.

Forretningsregler:

  • De kontaktdatatype (Borgerkommunikation.KontaktdataCodelList ), der angives i kaldet oprettes og hvis kontaktdatatype allerede findes, overskrives den gamle værdi.

  • Angives en kontaktdatatype med NULL i kontaktinformation, anses dette som en sletning af kontaktinformationen.

  • Hvis kontaktdatatype angives med NULL i kontaktinformation (sletteindikation) valideres der på om borger har pligt til at have et søgbart CV (jobparate borgere), i givet fald fås en fejl.
    Valideringen sikrer at borger eller andre ikke kan slette kontaktinformation der er en forudsætning for at have et søgbart CV

  • Hvis der oprettes eller ændres i e-mailadresse og/eller mobiltelefonnummer fra en sagsbehandler og ikke borger selv via Jobnet sættes kodelisteværdien kontaktdatastatus (Borgerkommunikation.KontaktdataStatusCodelListtil Id 4 ”Oprettet af sagsbehandler". 

  • Hvis der er abonnement på e-mail, kastes en fejl, hvis den pågældende type af kontaktinformation sættes til NULL.
    Valideringen sikrer at borger eller andre ikke kan slette en emailadresse hvor der er knyttet et huskeserviceabonnement
    Der er ikke validering mod telefon, da borger modtager SMS via NemSMS og der en fall back i forhold til huskeserviceabonnement

  • Der valideres på værdien i kontaktdata, således at der kun kan registreres valide mobiltelefonnumre, valide fastnet telefonnumre samt valide mailadresser. Valideringen udføres på baggrund af kontaktdatatype.
    For mobiltelefonnummer valideres der kun på om nummeret er validt i forhold til danske, svenske og tyske mobiltelefonnummere, for andre nationaliteter valideres det ikke om der et tale om et validt mobiltelefonnummer. Øvrige nationaliteter mobilnumre bliver først indført ifm. overgangen til moderniseret Jobnet.
    Mobiltelefonnumret anvendes IKKE til udsending af huskeservice (da NemSMS har eget mobilnummer på borger), men er blot tilstede for at sagsbehandler har kontaktinformation

  • Der udsendes WSB BorgerKontaktinformation og GetPersonContactInfo - WSRM  ved opdatering af en borges kontaktinformationer. 

  • WSB udsendelseslogik er således:

    • Hvis borger ingen kontaktinformationer har og man kommer ind med helt ny kontaktinformation = Create

    • Hvis borgeren allerede har data, og man tilføjer, opdaterer eller sletter noget af det, men der stadig er data tilbage efter ændringen, betragtes det som en opdatering = Update

    • Sletter man ALLE kontaktinformationer på borger = Delete

  • Oprettes email af borger selv, skal denne først verficeres før den oprettes via denne metode, det skal ske via Eksternkommunikation.KontaktinformationVerifikationService

GetKontaktinformationEmail

Denne metode udsøger borgere, der er tilmeldt huskeservice med en given e-mailadresse og den periode personen har været tilmeldt med den pågældende e-mailadresse.  Metoden er rettet mod Landssupportens behandling af supporthenvendelser fra en borger. 

GetKontaktinformationMobilNr

Denne metode udsøger borgere, der er tilmeldt huskeservice med et givet mobilnummer og den periode personen har været tilmeldt med det pågældende mobilnummer. Metoden er rettet mod Landssupportens behandling af supporthenvendelser fra en borger.

GetKontaktinformationer

Denne metode henter borgers kontaktinformation. Disse omfatter pt. mobiltelefon, fastnet telefon og mailadresse.