Formål med service

BorgerKontaktinformationService (tidl. PeronNotificationReminderService) giver sagsbehandler KontaktinformationVerifikationsService giver STAR mulighed for at redigere borgerens kontaktinfofå borger til at verificere borgerens email adresse.

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 SavePersonContactData sættes status til  PersonContactDataStatusIdentifierType til Id 4 ”Oprettet af sagsbehandler. Dette medfører at /wiki/spaces/FYS/pages/4394090607 kan benyttes uden at borger skal verificere kontaktoplysningerne. For regler vedr. verifikation af kontaktoplysninger se /wiki/spaces/GI/pages/75540587 XXXXX

Det er muligt for sagbehandler at indberette en e-mailadresse i forbindelse med tilmelding, se nærmere i /wiki/spaces/GI/pages/5308597. XXXXXX   

For regler vedr. udsendelse af huskeservicebeskeder, se XXXXXX /wiki/spaces/GI/pages/77892328 herunder beskrivelse af mapning mellem notifikationer, og de forskellige abonnementer. 

Gamle kontaktinformation bevares som historik af hensyn til at kunne dokumenterer tidligere foretaget kommunikation og hvor dette er sendt borger f.eks. i forbindelse med sine almindelig kontaktinformationer eller jobagenter ønsker at anvende en email skal denne verificeres af borger selv itte nden den kan anvendes af STAR. Dette sker for at sikre at det er den korrekte modtager der sendes til.

Metoder

Rettigheder til at kalde metoderne

Jobcentre, kommuner og anden aktør

A-kasser

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 valideres om borger er pligtig til har et søgbart CV (jobparate borgere), i givet fald fås en fejl.
  Valideringen sikre at borger eller andre ikke kan slette kontaktinformation der er en forudsætning for at have et søgbart CV
• Hivis 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.KontaktdataStatusCodelList) til Id 4 ”Oprettet af sagsbehandler". 
• Hvis der er abonnement på e-mail, fåes en fejl, hvis den pågældende type af kontaktinformation sættes til NULL.
  Valideringen sikre at borger eller andre ikke kan slette email hvor der er knyttet et huskeservice abonnement
  Der er ikke validering mod telefon, da borger modtager SMS via NemSMS og der en fall back i forhold til huskeservice abonnement
• 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 modiltelefon valideres kun om de er valide i forhold til danske, svenske og tyske mobiltelefonnummere, for andre nationaliteter validere ikke om der et tale om et validt mobiltelefonnummer
• Der udsendes WSB GetPersonContactInfo - WSRM  ved opdatering af en borges kontaktinformationer. 

UpdateKontaktinformation (POST /v1/kontaktinformation/verifisering)

Metoden sætter kontaktinfo status til ”Verificeret af Borger” (Borgerkommunikation.KontaktdataCodelList = 3), hvis verifikationskoden, der angives, er korrekt. 

Forretningsregler:

• Der kan kun valideres kontaktoplysninger af typen MailAdresse (KontaktdataCodelList = 3), øvrige vil fejle.
  
• Koder der er mere end 2 dage gamle er udløbet, dvs. koder for dagsdato og de foregående 2 dage er valide.  Antallet af dage er konfigurerbart. 
• Der sendes ikke WSB, når der status på kontaktinformationer ændres i forbindelse med verifikation af kontaktoplysninger.

GetKontaktinformation (GET /v1/kontaktinformation/mobiltelefon/{mobiltelefon})

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. 

GetKontaktinformation (GET /v1/kontaktinformation/emailaddress/{email })

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. 

UpdateKontaktinformation (POST /v1/kontaktinformation/status)

Denne metode giver mulighed for at ændre status (kontaktdatastatus) på en borgers mailadresse eller mobiltelefonnummer.

Forretningsregler: 

• Sættes status til 2 "Ikke verificeret til huskeservice" på borgerens mailadresse, sendes en mail indeholdende en verifikationskode, som borgeren kan bruge til at verificere sin mailadresse.
• Sættes status til 2 "Ikke verificeret til huskeservice" på borgerens mobiltelefonnummer, sendes en SMS indeholdende en verifikationskode, som borgeren kan bruge til at verificere sit mobiltelefonnummer.
• Der udsendes ikke WSRM når status opdateres.