Formål med service

KontaktinformationVerifikationsService giver STAR mulighed for at få borger til at verificere borgerens email adresse.

Forretningsregler 

Når en 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

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.